dsh-workflow (l1-presets)

dsh-workflow · 角色链的工作流插件

给 DeepSeek Harness 用的两个 bundle，把 plan → work → code → work → review → work → plan 这条角色协作链从"团队约定"变成"可由机器执行的纪律"。

用户 ↔ plan → work → code → work → review → work → plan → 用户

每轮六步：核对基线 → 收敛方案与授权 → 连续实施（唯一 T0）→ 限定修正（失败/重试/重启累计计数）→ 独立终审（分层证据不得互相扩大）→ 交付并关闭（版本 / 结果 / 未覆盖项 / 费用 / 停自有服务）。

---

两个部分

目录	是什么	状态
plugins/l1-presets/	纯配置：四个 preset（plan / work / code / review）的人设与工具矩阵，外加 protocol/ROUND-PROTOCOL.md 可抄进项目 AGENTS.md。零宿主代码	v1.0 已装
plugins/l2-protocol/	协议插件：9 个 chain_* 工具 + 轮次状态机，把 T0 唯一、计数越限、证据分层、门禁阻塞、收尾校验变成硬约束，并把每轮落盘成审计文件	v0.1（P0）已装，21 条自测通过

分开是有意的：L1 决定"谁有什么工具"，L2 决定"事实必须成立"。L2 依赖 L1（按角色判定），L1 不依赖 L2（不装 L2 也能用，只是纪律靠自觉）。

装

顺序：先 L1，后 L2，然后新开会话（preset 与工具集在会话创建时冻结）。

从本仓库直接装，不需要发布到 npm（#path: 选子包）：

plugin_manager install_bundle target: github:Weihao654/dsh-workflow#path:/plugins/l1-presets
plugin_manager install_bundle target: github:Weihao654/dsh-workflow#path:/plugins/l2-protocol

本地开发时也可以直接指向目录：

plugin_manager install_bundle target: <本仓库>/plugins/l1-presets
plugin_manager install_bundle target: <本仓库>/plugins/l2-protocol

两者都是普通 DSH bundle（dsh.bundle.patch 指向各自的 cordis.patch.yml），安装后可在插件列表确认 fiberPhase: active。详细前置、卸载与验证见各自 README。

角色→模型（plan 用强模型，code 用便宜模型）

子代理默认继承父代理的模型，所以四个角色本来共用一个。要分工，在项目里放一张表：

<项目根>/.dsh/role-chain.json

{
  "roleModels": {
    "plan": { "provider": "deepseek-account", "model": "deepseek-flash", "reasoningEffort": "high" },
    "code": { "provider": "openai", "model": "gpt-6-luna" }
  }
}

改完下一轮请求就生效：L2 用 agent/request 瀑布按 session.header.agentPreset 认出角色，查表换 provider / model。你在输入框手选过模型的会话，它不会再覆盖。表写坏了只是路由停用，chain_status.roleModels.errors 会说明原因。

不想手写 JSON 也行，两个入口：在 plan 会话里调 chain_role_models({ set: { code: { provider: "openai", model: "gpt-6-luna", reasoningEffort: "low" } } })（原子写入，非法输入拒绝且不动原文件）；或者 DSH 设置 → 角色 → 模型 里点选四个角色的 provider / 模型 / 思考深度，保存写的是同一个文件（客户端半身需要重启一次才加载）。

装了 L2 之后，新建会话的预设菜单只保留 DSH 自带的几项 + plan；work / code / review 只由 plan 派发，不再出现在菜单里（Settings → Agent Presets 页里仍可见）。这条靠客户端过滤实现，自检步骤见 plugins/l2-protocol/ACCEPTANCE.md 第 5 步。

角色复用（不必每个任务都新建代理）

同一个项目里，chain_dispatch 会按策略复用已有子代理，而不是每个任务都新开一个：

{ "reuse": { "work": "persistent", "code": "family", "review": "fresh" } }

work 跨轮常驻；code 按任务族（family 参数）一类一个；review 每轮新开——独立审核不该继承上一轮的结论。复用时是把新任务发给同一个子代理（它接着原来的上下文干），返回的 action 会写明 spawn 还是 reuse；chain_status.agents 是当前名册，chain_release 退休并释放。换新的 plan 会话后旧名册自动失效、回退新建，不会报错。

一眼看懂差别

不装 L2 时，"这一轮只有一个 T0"是一句提示词，模型忘了就忘了； 装了 L2，chain_freeze_baseline 第二次调用直接抛 BASELINE_ALREADY_FROZEN，且 T0 是插件自己跑 git rev-parse HEAD 得到的，不听模型自述。

同理：同一个测试失败第 3 次会 exceeded，越限的轮子 chain_close_round 关不掉（除非有用户批准的 force 门禁），关掉的轮会自动产出 .dsh/rounds/<roundId>.json。

诚实声明

• "角色看不见不该有的工具"在 L1 是结构性的（工具没挂），在 L2 的 P0 是代码拒绝（ROLE_DENIED）——迁移计划见 plugins/l2-protocol/DESIGN.md §15。
• work 的只读是软的：它需要 shell 跑验证命令，所以仍能重定向写文件。
• 门禁弹卡这一条只能在你自己的会话里验证，步骤见 plugins/l2-protocol/ACCEPTANCE.md。

关键词

deepseek-harness dsh cordis plugin agent-preset workflow round audit role-chain subagent