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