前言¶
在 DeepSeek Harness（DSH）裏用子智能體委派任務時，模型往往由宿主授權範圍決定，主 Agent 在一次會話裏也很難統一約束「這次委派必須用哪條模型路由」。原生 subagent、subagent_fork 等入口在固定策略或自選策略下，若不滿足校驗還可能直接被拒，排查時又缺少「當時策略是什麼、響應實際走了哪條路由」的可對照記錄。
dsh-subagent-model-policy（發佈包名 @lienze/dsh-subagent-model-policy）針對的是當前會話：管理子智能體的模型選擇策略、會話內候選模型池、併發與遞歸上限，並在委派發生後記錄創建時的策略與實際響應證據。插件默認關閉；安裝本身不會改動主模型、其他會話的模型選擇或宿主側授權。
這是什麼¶
- 定位：DSH 插件，分類爲模型推理；維護倉庫 ChenMuDX/dsh-subagent-model-policy，當前文檔版本
0.3.1（MIT）。 - 宿主要求：DeepSeek Harness
>=0.2.2-rc.1，Node>=24.12.0。 - 範圍：僅覆蓋當前會話內的策略庫、模型池、默認內容與會話限制；不做跨會話共享或項目級默認，也不修改宿主授權、主模型或官方 profile。
社區目錄頁：skillhub.cn 上的插件條目。目錄站爲社區站點，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
下面按面板與語義歸納已文檔化的能力。
三頁面板¶
入口在會話標題欄的「子智能體模型選擇策略」按鈕，或右側欄同名頁籤：
- 選擇策略：策略開關、新會話默認、策略池與頁內編輯。
- 模型池：勾選候選形成會話池、刷新候選、能力卡展示、會話級併發子智能體數量與最大遞歸深度。
- 執行洞察：本插件記錄的真實創建與響應證據。
策略語義¶
- 固定模型：委派只使用選中的模型；不匹配時報錯，不靜默替換。
- Agent 自選：從會話池候選子集中選擇，委派時需顯式填寫精確
provider/model與選擇依據。 - 舊版「跟隨父模型」策略只讀保留；另存爲固定或 Agent 自選時需顯式轉換。
- 保存已啓用策略後，新內容在下一次主 Agent 發起模型調用時生效；僅保存未開啓的策略只更新策略庫。關閉策略不刪庫、不改主模型，也不追溯終止已建子智能體。
模型池與限制¶
模型池只列出宿主當前允許的候選；勾選不會擴大授權，插件不管理 API Key。當前啓用策略引用的候選受保護，移除會被拒絕。「刷新候選」會按當時宿主授權清理失效引用，啓用中的內容仍受保護。併發與遞歸爲會話公共配置，實際委派同時受宿主上限和本會話限制約束。
Agent 工具¶
| 工具 | 作用 |
|---|---|
subagent_policy |
讀取策略、模型說明、注入預覽與運行回讀 |
delegate_with_policy |
創建本地 fresh/fork 子智能體並返回子會話 id；自選模式必須提供精確 provider/model 與一句選擇依據 |
策略保存不會自動創建子任務；是否委派仍由任務與 Agent 決定。
原生入口邊界¶
原生 subagent、subagent_fork、workflow、spawn_teammate 的本地創建只做准入校驗，不代填或改寫模型參數。固定/自選模式下，原生入口不能指定目標模型時可能被拒絕，此時應改用 delegate_with_policy。插件不 monkey-patch 官方工具，也不保證外部後端或非本地創建。
證據語義（執行洞察）¶
assistant/message：從子會話後綴的模型消息讀取實際響應路由。request/header：僅表示擬請求路由，不能當作實際響應。pending：尚無證據。
執行洞察保留創建時的策略名，不隨之後重命名或刪除而改寫。
安裝與啓用¶
在 DeepSeek Harness 的插件管理器中安裝下列包說明符（勿憑倉庫名自行拼接其他安裝命令）：
@lienze/dsh-subagent-model-policy@0.3.1
安裝後按當前 Harness 方式重載插件與頁面；若使用 CLI 管理 profile，按該版本文檔把同一說明符加入對應 profile。包 scope 爲 @lienze，插件內存儲域與命令前綴沿用歷史 lez- 前綴，不影響安裝與已保存數據。
卸載：在插件管理器中禁用或移除 bundle；會話策略與執行記錄保留在宿主 storageDomain，重新啓用後可繼續讀取。不要手改 profile 生成的 package.json、cordis.patch.yml 或 cordis.yml。
典型用法¶
按 README 推薦的順序即可完成一次完整設置。
-
安裝並啓用：在左側「插件」面板安裝並啓用
@lienze/dsh-subagent-model-policy@0.3.1，重載插件與頁面。 -
確認宿主子智能體授權：在宿主「子智能體」配置中確認最大遞歸深度、並行上限，以及 Agent 可爲子智能體選擇的模型範圍。本插件只在該範圍內選擇，不會擴大授權。
-
配置模型池與策略：打開「子智能體模型選擇策略」面板（面板內策略開關默認關閉）。在「模型池」頁勾選候選並保存；在「選擇策略」頁新建策略——固定模型從會話池單選，Agent 自選從池內勾選子集並填寫選擇說明——打開開關後保存。需要新會話自動攜帶同一策略時，設爲「新會話默認」。
-
委派與查看證據：委派仍由任務決定。委派後在「執行洞察」查看創建時的策略與實際響應路由。
自選委派且原生入口被拒時，由 Agent 調用 delegate_with_policy，並顯式傳入 provider/model 與選擇依據。
首次常見問題（摘自文檔）¶
- 只保存未開啓的策略不生效；啓用中策略的新內容等到下一次主 Agent 模型調用才生效。
- 模型池缺模型時，先在宿主側啓用該模型。
- 固定模式下模型不匹配會報錯；原生入口不能指定模型時用
delegate_with_policy。 - 刪除策略前需先關閉當前啓用策略或更改「新會話默認」來源。
適用場景與注意¶
適合：在同一 DSH 會話內需要可重複的子智能體模型路由（固定或池內自選）、需要會話級併發/遞歸上限與執行證據對照的開發者。
注意：
- 插件在當前 DSH 進程權限下運行；安裝前應自行查看 源碼與 LICENSE。
- 宿主撤銷授權後，已綁定子 Agent 的後續請求由宿主拒絕，插件不靜默回退。
- README 註明 AC-12 已在真實
desktop完成交互驗收（2026-11-09）；深度/存活超限、完整舊數據遷移等場景仍暫緩，勿將當前版本表述爲這些邊界的全面實測版。
結尾¶
dsh-subagent-model-policy 把子智能體模型選擇收斂到會話作用域：策略庫、模型池、限制與執行洞察在同一面板完成，並通過 delegate_with_policy 與原生入口邊界說明，減少「委派被拒卻看不清路由」的排查成本。
