在 DeepSeek Harness (DSH) 的使用場景中，模型上下文佔用隨着工具列表的增多而增加。當工具過多時，模型可能忽略低頻但重要的功能，或消耗不必要的 Token。DSH 工具管理插件通過開關和分組機制，按需加載工具，解決這一問題。
插件概覽¶
該插件由 pan17 維護，採用 MIT 許可證。核心功能是按 Agent Preset 開關和分組工具，像 Skill 一樣按需加載工具，減少模型上下文佔用。插件管理的是模型能否看到和調用工具，不會停止 Cordis 插件或 MCP 服務進程。
安裝與啓用¶
要求 DeepSeek Harness 0.2.0-rc.2 或更新。本插件按該版本的 Agent Preset 與工具 registry 行爲適配並測試；更早的 DSH 請使用 1.2.8。
方式一：設置頁內直接安裝（推薦）¶
打開 設置 → 插件 → 添加插件，在輸入框填包名：
dsh-tool-manager
點「安裝」即可。安裝完成後進入 WebUI：
http://127.0.0.1:3080
進入 設置 → 工具管理。
方式二：命令行¶
桌面版用戶：
dsh plugin --profile desktop add dsh-tool-manager
非桌面版（web / tui / headless）：
npx @deepseek-ai/dsh plugin --profile web add dsh-tool-manager
安裝完成後重啓對應的 DSH Profile。
核心功能與用法¶
1. 選擇 Agent Preset¶
在 WebUI 的「工具管理」頁面頂部選擇需要配置的 Agent Preset。不同 Preset 的工具策略相互獨立。
2. 開啓或關閉工具¶
在工具目錄中勾選或取消勾選工具：
* 勾選：工具保持可用，出現在模型工具列表中。
* 取消勾選：工具被關閉，不顯示給模型，也不能調用。
可以通過搜索和狀態篩選快速查找工具。
3. 工具分組¶
支持手動選擇或自動生成分組。相關工具可以整理在同一組，例如「GitHub 工具」、「文件處理」等。
手動分組¶
點擊「手動分組」，填寫分組名稱、描述，搜索並勾選工具，點擊「確定」。
自動分組¶
點擊「自動分組」，先搜索、勾選需要整理的工具。插件會將選中的未分組且未關閉工具交給當前默認模型生成名稱和描述。執行前可以預覽並編輯提示詞，默認超時 120s。確認後結果顯示預覽，不會立即寫入配置。
4. 按需加載¶
放進按需組的工具默認不會全部出現在模型上下文中。模型平時只會看到分組目錄；當任務需要某組能力時，模型可以調用 tool_list 工具打開分組。
調用示例：
{
"group": "GitHub 工具"
}
該組中的原始工具隨後會在當前會話中開放。按需加載具有以下特點：
* 工具按組開放，不需要逐個啓用。
* 每個按需組必須至少包含一個當前可用且未關閉的工具。
* 一個工具只能屬於一個按需組。
* 開放後在當前會話中持續可用；重啓 DSH 並恢復同一會話時，會根據該會話中成功的 tool_list 調用恢復開放狀態。
* 明確關閉的工具不會被按需組重新啓用。
注意事項¶
- 版本要求：要求 DSH >= 0.2.0-rc.2，舊版本請繼續使用 1.2.8。
- 進程控制：插件僅管理模型對工具的可見性，不會停止工具所屬的 Cordis 插件或 MCP 服務進程。
- 配置文件：修改配置不會改寫 DSH 自帶的 Agent Preset 文件。
- 會話作用域：按需開放只對當前 Agent 會話生效；新建會話或從當前會話 fork 出來的子會話仍從默認隱藏狀態開始。
- 自動生成消耗：自動命名和自動分組會調用當前默認模型，產生一次請求；默認超時分別爲 60 秒和 120 秒。
