dsh-director

DeepSeek Harness 的「总监模式」Agent 预设：双层委派架构 —— 高价值模型掌舵、低成本模型执行。

English

这是什么

dsh-director 是 DeepSeek Harness (DSH) 的一个 Agent 预设，实现「总监模式」：把一次 Agent 会话拆成严格的两层——

• 总监层（高价值模型）：主 Agent 运行在你会话中选择的强推理模型上，只负责判断、计划、需求澄清、任务分解、契约锁定与验收把关，全程不代写代码。
• 执行层（低成本模型）：所有子代理（spawn / fork / workflow worker）通过 agentOptions 固定运行在低成本模型（默认 opencode-go / deepseek-v4-flash，思考深度 MAX）上，执行具体任务：实现、批量修改、调研、审计、测试。

为什么是「双层协议」

两层之间不只是模型分层，而是两套写死的协议：

	总监协议（上层）	执行协议（下层）
模型	会话选择的高价值模型	agentOptions 钉死的低价值模型
职责	判断 / 计划 / 拆解 / 验收	直接执行 / 验证产出 / 报告
禁止	不替子代理写实现代码	不委派、不询问、不打扰用户
工具层	完整工具集 + 委派工具	委派与询问工具全部移除

结构保证（persona 替不了的，由配置层锁死）：

• maxDepth: 1 —— 只有总监（深度 0）可以委派；深度 ≥1 的调用者在 start 时被拒绝。
• toolFilter.deny —— 从子代理工具层移除 subagent / subagent_fork / send_message / list_agents / interrupt_agent / workflow / ralph / ask_user_question，从结构上杜绝「子代理再开子代理」与「子代理直接打扰用户」。
• 子代理 persona —— 给执行者一个「只做任务、验证产出、写报告」的身份。
• 总监 persona —— 完整的双层分工纪律：契约先行、并行委派、提示词自包含、不轮询、亲自验收、不合格返工。

安装

1. 把 preset/ 下的两个文件复制到 ~/.dsh/.agent-presets/director/：

   mkdir -p ~/.dsh/.agent-presets/director
   cp preset/agent.cordis.yml preset/preset.yml ~/.dsh/.agent-presets/director/
   

2. 在 DSH Web UI 新建会话，预设选择总监模式，会话模型选择高价值模型（如 deepseek-v4-pro、qwen3.7-max、GPT-5.x 系列）。

3. 开始委派：把目标告诉总监，总监会先给计划，再并行委派子代理，最后亲自验收。

改执行模型：编辑 preset/agent.cordis.yml 中两处 agentOptions.model（及必要时 provider）。 改总监模型：会话选择器，不动预设。

验证

docs/ 下附带完整的建设与验证记录：

• docs/director-test-task.md —— ducheck 验证任务与 8 项验收清单（计划先行 / 并行委派 / 提示词自包含 / 模型分层 / 工具净化 / 验收返工 / 契约化产物 / 成本分层），实测全部通过。
• docs/director-preset-notes.md —— 架构决策与 DSH 机制映射、经验教训、模型单价速查。

成本分层

执行层全部 token 按 flash 单价计价；总监只在规划、整合、验收上消耗高价值 token。实测：编码工作全部由低价值模型完成，返工循环（打断 + send_message）是设计内机制，用于约束低价值模型的越界行为。

许可

MIT