前言¶
DeepSeek Harness (DSH) 的插件機制允許在宿主環境之外擴展功能。dsh-dev-crew 是一個工作流類插件，其核心作用是在同一個會話內，按職責將工作分派給綁定了不同模型的子代理。常見的應用場景是：將需求整理與評審交給強模型，將批量實現交給低成本模型，從而在同一對話流中完成複雜的開發任務。
核心功能¶
該插件主要解決多角色協作與模型路由配置問題：
* 多角色子代理：支持定義多個角色，每個角色可綁定一個或多個模型。
* 內置角色與 Skill：提供 implementer（實現者）、reviewer（評審者）、researcher（研究者）三個內置角色，並內嵌 crew、crew-brainstorm、crew-plan、crew-converge 四個方法論 skill。
* 配置方式：支持通過 Web 界面或 YAML 文件進行配置，並支持熱更新（部分配置項需重載）。
* 產物管理：自動創建並管理 specs、plans、reviews、reports 等產物目錄。
安裝¶
安裝前請確保宿主 DSH 版本爲 0.1.0-rc.7 或更新。插件不依賴 DSH 自帶包聲明，安裝命令如下：
dsh plugin --profile <你的 profile> add dsh-dev-crew
若需使用本地路徑安裝：
dsh plugin --profile <你的 profile> add <本倉庫絕對路徑>
配置¶
插件支持 Web 界面與 YAML 兩種配置方式。在 Web 界面的設置頁「Dev Crew」區塊中，可以配置角色、模型、收斂輪數及紀律 gate 開關。
對於 YAML 配置，需在 profile 的 cordis.patch.yml 中定義角色。每個角色可綁定多個模型，每個模型對應一個獨立的委派工具。
- id: dsh-dev-crew
config:
roles:
- id: implementer
enabled: true
models:
- alias: default
provider: kimi-coding
model: k3
- id: reviewer
enabled: true
models:
- alias: ds
provider: deepseek-official
model: deepseek-v4-flash
工具命名遵循以下規則：
* 單模型角色：subagent_<角色名>
* 多模型角色：subagent_<角色名>_<alias>
內嵌方法論與產物目錄¶
插件隨包分發內嵌 skill，無需用戶側配置。主要包括：
* crew：端到端開發流水線。
* crew-brainstorm：需求討論與規格定稿。
* crew-plan：規格拆解爲實施計劃。
* crew-converge：評審收斂協議（僅對模型可見）。
使用 /crew-init 命令或 crew_init 工具可以創建產物目錄（默認爲 docs/specs、plans、reviews、reports）。該命令具有冪等性，不會覆蓋已有文件。
子代理結果返回機制¶
子代理的結果返回通過兩條通道：
1. 結算通知：子代理完成後，宿主會返回一條以 Background subagent <id> finished 開頭的消息，其中包含子代理的最後一條消息。這是判斷子代理是否完成工作的主要依據。
2. Report 工具：子代理可主動調用 report 工具發送內容，不受「只有最後一條」限制，適合中途報告或結論較長的情況。
注意：job_output、job_list、job_kill 工具用於管理後臺 shell 作業，與子代理無關。
注意事項¶
使用時需注意以下限制與規則：
* 日期準確性：產物文件名中的日期依賴模型的訓練數據，可能不準確。
* 文件修改限制：reviewer 角色只能使用 edit 或 cp+edit 修改文件，不能使用 write（除落盤評審報告外）。
* Gate 熱更新：gate.enabled 只在插件掛載時生效，熱更新需重載。
* Goal 循環衝突：子代理完成後需暫停 goal 循環，否則流水線會因 goal_round 消息不斷重置而卡死。
* 結果隔離：子代理看不到其他委派工具，插件會自動將其加入 deny 列表。
