前言¶
在 DeepSeek Harness (DSH) 的開發中，代理經常面臨一種姿態不適配的問題：要麼在單行回答的任務上過度規劃，要麼在需要嚴謹計劃的重構任務中即興發揮。常駐系統提示詞的“教條”會隨着對話輪次增加而稀釋，變成模型不再閱讀的“壁紙”。
DSH 插件 dsh-mode 提供了一種機制：通過 switch_mode 工具在切換瞬間注入階段對應的方法論，引導接下來的工作，而不是將其作爲永久規則寫入系統提示詞。
這是什麼¶
dsh-mode 是由 xiyiyiru 維護的 DSH 插件，屬於工作流分類。
它提供了一套無狀態的工作模式切換工具。插件的核心價值在於：在需要改變工作姿態的節點，通過工具調用交付特定的方法論，而不是在系統提示詞層面做全局修改。自 0.1.0-rc.6 起，該工具不再修改系統提示詞，也不寫入會話事件。
核心功能¶
該插件主要包含以下能力：
- 模式切換工具：提供
switch_mode工具，支持在五種預設模式間切換。 - API 導出：提供
MODES、CORE_BEHAVIOR等導出 API，供開發者獲取模式定義和核心行爲原則。 - 無狀態設計：工具本身是無狀態的，不修改系統提示詞，不重新注入，也不攜帶快照。
- 核心行爲原則：在系統提示詞中貢獻一個靜態部分
mycel:core-behavior（順序 10），定義一套模式無關的底層工作原則（如根因優先於行動、誠實對待不確定性等）。 - 冪等性：切換到同一模式會重新讀取對應的方法論，作爲恢復路徑。
安裝與啓用¶
通過 DSH 的插件管理器安裝，依賴項會自動解析。
dsh plugin --profile <name> add @xiyiyiru/dsh-mode
典型用法¶
switch_mode 工具的返回值包含當前模式的方法論文本，模型在收到結果後依據該文本調整後續行爲。常見的切換場景包括：
- planner 模式：當目標需要決策完整的計劃時切換。接收計劃的執行者將不再做進一步決策。
- analyst 模式：當需要判斷、根因分析或影響評估時切換。該模式側重於事實裁判、收集證據和陳述影響，不直接修復問題。
- explorer 模式：在處理不熟悉的代碼或進行只讀偵察時切換。側重於產出結構、職責和關鍵路徑，不觸碰代碼。
- executor 模式：當計劃被批准，只剩下執行步驟時切換。嚴格按計劃執行，並暴露計劃中的漏洞而非默默改進。
- base 模式：默認姿態，用於直接回答，不經過複雜儀式。
適用場景與注意¶
該插件適合需要在對話流程中動態調整代理思維模式的場景。
注意事項：
- 無狀態與日誌：自 0.1.0-rc.6 起，切換操作不會寫入會話事件，依賴日誌系統跟蹤。
- 系統提示詞：插件不會修改系統提示詞，也不會在退回或後續輪次重新注入模式內容。
- 解耦：自 2026-09-03 起，該插件已與狀態插件的任務棧解耦。
- 依賴：依賴 peerDependencies 自動解析，安裝前需確保環境滿足版本要求。
- 許可證：MIT 許可證。
結尾¶
dsh-mode 通過在切換點注入方法論，解決了常駐提示詞稀釋和姿態錯配的問題。它將模式切換變爲一次顯式的工具調用，保持系統提示詞的純淨，同時爲代理在不同階段提供針對性的思維引導。
插件目錄與源碼：
https://www.skillhub.cn/plugins/xiyiyiru/dsh-mode
https://github.com/xiyiyiru/dsh-mode
