Skip to content

动态工作流

LoongCode 支持 Claude Code 动态工作流(Workflow):你把一段工作流脚本放到约定目录,它就会出现在 / 命令面板里;在对话中触发后,LoongCode 把工作流的运行过程渲染成一张富进度卡片——按阶段、子智能体展示实时进度、用量与最终结果,还能逐个下钻查看子智能体的完整对话(v0.7.2 起)。

相关基础:斜杠命令与文件面板子智能体

仅 Claude

动态工作流是 Claude Code 的能力,仅在使用 Claude CLI 的任务中可用;Codex 任务不提供此功能。


工作流从哪里来

工作流是放在约定目录下的 .js 脚本文件,LoongCode 会自动扫描并把它们收进 / 命令面板:

来源存放位置命令面板中的来源徽标
用户级~/.claude/workflows/*.jsuser(蓝色)
项目级当前工作区下 .claude/workflows/*.jsproject(绿色)
  • 同名时项目级覆盖用户级
  • 工作流条目在命令面板中带玫红色 workflow 类型徽标,与普通命令、技能区分(见斜杠命令的来源/类型徽标)。
  • 新增或修改工作流脚本后,命令面板会自动感知变更并更新列表,无需重启应用。

工作流脚本由谁编写

工作流脚本本身遵循 Claude Code 的工作流约定(脚本里声明名称、描述与各阶段逻辑)。LoongCode 只负责发现、触发与可视化,不限制脚本内容。脚本的 name / description 会作为命令面板里的标题与说明展示。


触发工作流

与调用普通斜杠命令完全一致:

  1. 在输入框输入 / 打开命令面板。
  2. 输入关键词筛选到目标工作流(带玫红 workflow 徽标)。
  3. Enter 或点击选中,像发普通消息一样发送。

发送后,对话区会出现一张工作流进度卡片,开始实时跟踪运行过程。


进度卡片

工作流运行时渲染为一张可折叠的富卡片,自上而下包含:

  • 标题行:工作流名称 + 玫红 workflow 徽标 + 右侧整体状态⟳ 运行中 / ✓ 已完成 / ✗ 失败)。点击标题行可整卡折叠 / 展开
  • 阶段列表:工作流的各个阶段(Phase)按顺序排列,每个阶段前有一枚状态圆点,点击阶段行可折叠 / 展开该阶段下的子智能体
  • 子智能体行:某阶段派生的子智能体(Agent)并列其下,显示标签、所用模型徽标,以及该子智能体的运行状态(运行中 / 已完成 / 失败 / 排队中)。
  • 底部用量条:本次运行的耗时、子智能体数量、消耗 tokens(千分位)。
  • 最终结果:运行结束后(非运行态)在卡片底部展示工作流返回的最终结果文本。

状态圆点颜色

圆点含义
排队中 / 已派发待执行
黄(转动)运行中
绿已完成
失败 / 被取消

阶段圆点按其下子智能体的整体进度推导;当整个工作流运行完成时,所有圆点统一显示为绿色。

阶段自动折叠

为了减少干扰,阶段默认遵循自动折叠规则有子智能体正在运行的阶段自动展开,其余阶段自动收缩。你随时可以手动点击某个阶段行覆盖这一规则(手动选择优先于自动规则)。


下钻查看子智能体对话

工作流派生的每个子智能体都有自己的完整对话记录。在进度卡片上点击某个子智能体行,即可在其下方展开该子智能体的完整 transcript(用户消息、思考内容、助手回复、工具调用卡片等),与主对话的渲染一致。再次点击同一行收起。

  • transcript 为懒加载:点开时才去读取,读到后缓存,避免一次性加载全部子智能体。
  • 排队中、尚未启动的子智能体没有对话记录,点击不会展开(无可下钻内容)。
  • 子智能体运行完成后,其 transcript 会自动刷新为完整版本——避免出现「子智能体已显示完成,但下钻里最后一条工具仍停在运行中」的情况。

关闭后重开:从磁盘还原

工作流的运行记录会被持久化。关闭任务后重新打开,LoongCode 会从磁盘重建工作流卡片,还原:

  • 工作流名称、最终状态(已完成 / 失败)与最终结果;
  • 各阶段与各子智能体的列表及其状态;
  • 顶部用量(总 tokens、子智能体数量等)。

还原出的卡片同样支持整卡折叠子智能体下钻。还原态卡片不会再显示「运行中」——历史记录只呈现终态。


运行期间的保活

工作流通常会跨越多轮模型调用、并派生多个子智能体,整个过程可能比一次普通对话回合长。LoongCode 会在工作流仍在运行时保持事件订阅,确保后续阶段进度、子智能体状态与最终完成都能实时反映到卡片上,不会因为「触发那一轮已结束」而中断更新。

若过程中进程异常退出,未完成的工作流会被兜底标记为失败,卡片状态翻为 ✗ 失败,不会一直停在「运行中」。


下一步

了解动态工作流之后,可以继续探索如何让消息到点自动发送,前往定时执行消息继续学习。