动态工作流
LoongCode 支持 Claude Code 动态工作流（Workflow）：你把一段工作流脚本放到约定目录，它就会出现在 / 命令面板里；在对话中触发后，LoongCode 把工作流的运行过程渲染成一张富进度卡片——按阶段、子智能体展示实时进度、用量与最终结果，还能逐个下钻查看子智能体的完整对话（v0.7.2 起）。工作流以非阻塞方式在后台运行（v0.9.2 起）：触发后输入框随即解锁，你可以继续正常对话。
支持范围
- Claude CLI：完整支持动态工作流（v0.7.2 起）。
- Qoder CLI（v0.10.4 起）：Qoder 与 Claude 同源方言，动态工作流同样可用——脚本放
~/.qoder/workflows（或项目级.qoder/workflows），触发后同样渲染富进度卡片并纳入后台任务活动跟踪。 - Codex、OpenCode 与 Kimi：不提供动态工作流功能。
工作流从哪里来
工作流是放在约定目录下的 .js 脚本文件，LoongCode 会自动扫描并把它们收进 / 命令面板：
| 来源 | 存放位置 | 命令面板中的来源徽标 |
|---|---|---|
| 用户级 | ~/.claude/workflows/*.js | user（蓝色） |
| 项目级 | 当前工作区下 .claude/workflows/*.js | project（绿色） |
| Qoder 用户级（v0.10.4 起） | ~/.qoder/workflows/*.js | user（蓝色） |
| Qoder 项目级（v0.10.4 起） | 当前工作区下 .qoder/workflows/*.js | project（绿色） |
- 同名时项目级覆盖用户级。
- 工作流条目在命令面板中带玫红色 workflow 类型徽标，与普通命令、技能区分（见斜杠命令的来源/类型徽标）。
- 新增或修改工作流脚本后，命令面板会自动感知变更并更新列表，无需重启应用。
工作流脚本由谁编写
工作流脚本本身遵循 Claude Code 的工作流约定（脚本里声明名称、描述与各阶段逻辑）。LoongCode 只负责发现、触发与可视化，不限制脚本内容。脚本的 name / description 会作为命令面板里的标题与说明展示。
触发工作流
与调用普通斜杠命令完全一致：
- 在输入框输入
/打开命令面板。 - 输入关键词筛选到目标工作流（带玫红 workflow 徽标）。
- 按 Enter 或点击选中，像发普通消息一样发送。
发送后，对话区会出现一张工作流进度卡片，开始实时跟踪运行过程。触发工作流的那一轮对话会很快正常收尾，输入框随即解锁（v0.9.2 起）——工作流转入后台继续执行，你可以继续发送新消息，进度卡片不受影响、持续实时更新。
进度卡片
工作流运行时渲染为一张可折叠的富卡片，自上而下包含：
- 标题行：工作流名称 + 玫红 workflow 徽标 + 右侧整体状态（
⟳ 运行中/✓ 已完成/✗ 失败）。点击标题行可整卡折叠 / 展开。 - 阶段列表：工作流的各个阶段（Phase）按顺序排列，每个阶段前有一枚状态圆点，点击阶段行可折叠 / 展开该阶段下的子智能体。
- 子智能体行：某阶段派生的子智能体（Agent）并列其下，显示标签、所用模型徽标，以及该子智能体的运行状态（
运行中/已完成/失败/排队中）。 - 底部用量条：本次运行的耗时、子智能体数量、消耗 tokens（千分位）。
- 最终结果：运行结束后（非运行态）在卡片底部展示工作流返回的最终结果文本。
状态圆点颜色
| 圆点 | 含义 |
|---|---|
| 灰 | 排队中 / 已派发待执行 |
| 黄（转动） | 运行中 |
| 绿 | 已完成 |
| 红 | 失败 / 被取消 |
阶段圆点按其下子智能体的整体进度推导；当整个工作流运行完成时，所有圆点统一显示为绿色。
阶段自动折叠
为了减少干扰，阶段默认遵循自动折叠规则：有子智能体正在运行的阶段自动展开，其余阶段自动收缩。你随时可以手动点击某个阶段行覆盖这一规则（手动选择优先于自动规则）。
下钻查看子智能体对话
工作流派生的每个子智能体都有自己的完整对话记录。在进度卡片上点击某个子智能体行，即可在其下方展开该子智能体的完整 transcript（用户消息、思考内容、助手回复、工具调用卡片等），与主对话的渲染一致。再次点击同一行收起。
- transcript 为懒加载：点开时才去读取，读到后缓存，避免一次性加载全部子智能体。
- 排队中、尚未启动的子智能体没有对话记录，点击不会展开（无可下钻内容）。
- 子智能体运行完成后，其 transcript 会自动刷新为完整版本——避免出现「子智能体已显示完成，但下钻里最后一条工具仍停在运行中」的情况。
关闭后重开：从磁盘还原
工作流的运行记录会被持久化。关闭任务后重新打开，LoongCode 会从磁盘重建工作流卡片，还原：
- 工作流名称、最终状态（已完成 / 失败）与最终结果；
- 各阶段与各子智能体的列表及其状态；
- 顶部用量（总 tokens、子智能体数量等）。
还原出的卡片同样支持整卡折叠与子智能体下钻。还原态卡片不会再显示「运行中」——历史记录只呈现终态。
后台运行：不锁输入框
工作流通常会跨越多轮模型调用、并派生多个子智能体，整个过程可能比一次普通对话回合长得多。从 v0.9.2 起，工作流并入后台任务活动体系，以非阻塞方式在后台运行：
- 输入框不再被占住：触发工作流的回合正常收尾后即可继续输入、发送新消息，不必等工作流跑完；进度卡片在此期间持续实时更新，后续阶段进度、子智能体状态与最终完成都会实时反映到卡片上。
- 侧栏任务行保持「运行中」：只要工作流还在跑，任务行就显示橙色圆环并继续累计「已工作」计时，右侧出现 ⚡N 后台徽标（N 计入运行中的工作流）。
- 纳入后台活动浮层：点击该任务所在分栏输入框旁的 ⚡N 指示灯，浮层的「任务」组会列出工作流条目（🧩 图标，悬浮提示「工作流」）；条目仅作速览，详细进度请回到对话里的进度卡片查看。
- 完成时的提醒与自动总结：工作流完成后 ⚡ 徽标以未读态（亮金加粗）提示；主 AI 通常会被自动唤醒，在主对话里对结果给出一段总结并实时流出。
若过程中 CLI 进程异常退出，运行中的工作流会被兜底标记为失败，卡片状态翻为 ✗ 失败，不会一直停在「运行中」。
会连带终止工作流的操作
工作流运行在当前任务的 CLI 进程上。运行期间切换模型 / 思考深度 / 授权模式后发送新消息（会以新参数重启 CLI 进程）、编辑历史消息重新发送等重启进程的操作，都会连带终止正在运行的工作流——卡片将标记为 ✗ 失败。若希望工作流跑完，请避免上述操作。
下一步
了解动态工作流之后，可以继续了解 AI 把命令与子智能体放到后台执行时的实时呈现，前往后台任务活动继续学习。