在 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 秒。
