DSH Workflow

这是什么？适合谁？

@dsh-external/workflow（DSH Workflow）是一个官方 bundle 形态、零核心 patch 的 DeepSeek Harness（DSH）插件。它参考 KodaX 的 workflow 设计能力，针对 DSH 的 Cordis、ctx.subagents、Session、后台 jobs、审批、命令和工具机制做独立实现。它不替换 DSH 已有的前台 workflow 工具——原生工具适合”这一次把若干工作并行跑完”；本插件负责更高一层的流程产品能力：命名、发现、生成、复用、暂停/恢复、重跑/续跑、持久证据、成本记录和治理。

一句话：把 Claude Code 的 UltraCode 式一次性多 Agent 调度，升级为可生成、可保存、可治理、可观察、可恢复的 Workflow 层。

适合人群：重度 DSH 用户、反复重用多 Agent 流程的团队、需要 Agent 流程审计与成本管控的场景。 使用前提：DeepSeek Harness 环境、对 DSH 的 session/子代理机制有基本了解。

准备工作

• 工具账号：DSH 运行环境 + 模型 API 配置
• 时间预算：安装 10 分钟；第一个 capsule 化工作流半天；治理体系落地 1 天
• 前置知识：DSH 插件机制（dsh plugin）、多 Agent 调度概念
• 替代方案：DSH 原生前台 workflow 工具（一次性调度够用就不用装）；KodaX（设计参考源）

5 步核心流程

第 1 步：安装插件

以官方 bundle 形态安装（具体命令见仓库快速开始章节），零核心 patch——升级 DSH 不会破坏插件。

第 2 步：生成与保存工作流

把一次成功的多 Agent 调度固化为命名 workflow：capsule 自带 intent、inputs、requirements、provenance——“复杂流程只有作者自己知道怎么用”的问题就此终结。之后按名字即可发现与复用。

第 3 步：运行与观察

运行时产出持久化证据：run graph、事件、artifact、结果摘要与成本记录永久落盘——并行结果不再散落在会话记录里。

第 4 步：中断恢复

两种恢复路径：按 run snapshot 整体重跑，或用 effect cache 只续跑未完成的部分——中断后不必从头再来。

第 5 步：治理与审计

用 manifest + preflight + 运行时硬限制（provider/模型/并发/预算）约束流程；生成的脚本跑在 capability-only VM、JSON 边界、确定性 guard、分级审批之下——“生成的脚本越权或不可复现”的风险被结构化封堵。

常见踩坑（5 条）

踩坑 1：与原生前台 workflow 工具混淆

• 现象：不知道该用哪个
• 原因：两者共存，定位不同
• 解决：一次性并行调度用原生工具；要保存/复用/治理就用本插件

踩坑 2：期待它改变 DSH 核心

• 现象：担心升级冲突
• 原因：误以为是 patch 型插件
• 解决：它是官方 bundle 形态、零核心 patch，随 DSH 升级安全

踩坑 3：effect cache 当万能回滚

• 现象：续跑结果不对
• 原因：cache 只对”可确定重放”的 effect 有效
• 解决：外部副作用环节（发邮件/写库）设计为可重入或加幂等键

踩坑 4：预算硬限制设太松

• 现象：多 Agent 跑飞，成本失控
• 原因：manifest 的运行时限制没配或过宽
• 解决：首跑就配 provider/模型/并发/预算四重限制

踩坑 5：跳过 provenance 直接分发 capsule

• 现象：他人无法信任与复现你的 workflow
• 原因：capsule 的 intent/inputs/requirements/provenance 没填全
• 解决：按模板填全再分享——这是可审计、可演进工程资产的前提

FAQ（5 个常见问题）

Q1：DSH Workflow 免费吗？ A：MIT 开源免费；成本来自模型 API 用量（插件自带成本记录）。

Q2：必须懂 KodaX 吗？ A：不——它只参考了 KodaX 的设计，独立实现于 DSH 机制之上。

Q3：和 dsh-agent-teams 什么关系？ A：agent-teams 给 DSH 提供多 Agent 组队执行能力；本插件在其上提供流程产品层（保存/复用/恢复/治理），互补使用。

Q4：非 DSH 能用吗？ A：不能——深度绑定 DSH 的 Cordis/session/审批机制。

Q5：成本记录到什么粒度？ A：run 级成本记录持久落盘；粒度细节以仓库文档为准（未实测）。

小技巧（5 条）

1. 首次成功调度立即 capsule 化：趁热保存，下次直接按名复用。
2. preflight 当 CI 用：每次运行前的预检挡住配置漂移。
3. 长流程先设 checkpoint：为高成本节点预置断点，失败不全局重来。
4. 审批分级按风险：只读操作免审、写操作人审、删操作双人审。
5. run graph 当复盘材料：每周看一次 run graph 与成本记录，优化流程结构。

参考链接

• DSH Workflow GitHub 仓库

---

本文基于公开资料于 2026-08-17 整理，社区指标反映 GitHub 公开数据。独立实测未进行，功能和配置项可能随版本更新而变化，请以官方文档为准。