DSH Workflow
把 DeepSeek Harness 的一次性多 Agent 调度，升级为可生成、可保存、可治理、可观察、可恢复的 Workflow 层。
中文 · English · 快速开始 · DSH 价值 · 能力 · 对标矩阵
`@dsh-external/workflow` 是一个官方 bundle 形态、零核心 patch 的 DSH 插件。它完整参考 KodaX 的 workflow 设计能力，并针对 DSH 的 Cordis、`ctx.subagents`、Session、后台 jobs、审批、命令和工具机制做独立实现。 它不替换 DSH 已有的前台 `workflow` 工具。原生工具适合“这一次把若干工作并行跑完”；本插件负责更高一层的流程产品能力：命名、发现、生成、复用、暂停/恢复、重跑/续跑、持久证据、成本记录和治理。 ## 它为 DSH 带来什么 DSH 已经有很强的 Harness 基础设施：模型路由、子 Agent provider、工具权限、审批、Session 日志、后台 jobs 与 UI 事件。但仅有这些“执行原语”，团队仍需在每次会话里重新描述如何拆解、并发、验证和汇总。 | 只有一次性调度时 | 安装 DSH Workflow 后 | | --- | --- | | 每轮重新提示如何拆任务，策略难复用 | 保存为项目或个人 workflow，按名字运行 | | 并行结果散落在会话里 | run graph、事件、artifact、结果摘要和成本永久落盘 | | 中断后通常从头重来 | 按 run snapshot 重跑，或用 effect cache 续跑未完成部分 | | provider/模型/并发/预算靠提示词约束 | manifest + preflight + 运行时硬限制 | | 生成的脚本容易越权或不可复现 | capability-only VM、JSON 边界、确定性 guard、审批分级 | | 复杂流程只有作者自己知道怎么用 | capsule 自带 intent、inputs、requirements、provenance | | 多 Agent 是一次性技巧 | 多 Agent 变成可审计、可分享、可演进的工程资产 | 对 DSH 项目本身，这个插件的价值是把已有 Harness 能力串成完整闭环： ```mermaid flowchart LR A["DSH providers / models"] --> W["DSH Workflow"] B["tool filters / approval"] --> W C["Session / jobs / commands"] --> W W --> D["reusable capsules"] W --> E["durable run graph"] W --> F["resume / governance / evidence"] ``` 因此，DSH 不只会“调用 Agent”，还可以承载长期维护的 Agent 工作流库。 ## 快速开始 要求：Node.js `>=22.19`，以及与 [`compatibility.json`](compatibility.json) 一致的 DSH 快照。 ```sh # 构建产物已提交，git 源安装不需要在用户侧编译 dsh plugin --profile web add "github:dsh-external/dsh_workflow#main" # 验证 bundle 已进入 profile 合成树 dsh --profile web --dump-config ``` 预期配置中出现： ```yaml - id: dsh-external-workflow name: '@dsh-external/workflow' ``` 重启对应 DSH profile 后，在会话中输入： ```text /workflow list /workflow parallel-investigation {"question":"为什么这个测试会间歇失败？"} /workflow create 为这个仓库设计一个并行安全评审流程 /workflow review --risk high --requirement "不得破坏公开 API" --test-evidence "pnpm test 通过" --wait /workflow runs ``` `/workflow create