dsh-tool-manager

使用方法

1. 选择 Agent Preset

在页面顶部选择需要配置的 Agent Preset。

每个 Preset 的工具策略相互独立。

2. 开启或关闭工具

在工具目录中勾选或取消勾选工具：

• 勾选：工具保持可用；
• 取消勾选：工具被关闭。

可以通过搜索和状态筛选快速查找工具。

3. 创建按需分组

点击“分组”，然后：

1. 填写分组名称；
2. 填写可选的分组描述；
3. 搜索并勾选要加入的工具；
4. 点击“确定”。

确认分组后，页面会保留当前筛选位置，不会自动跳转到“按需”页面。

你也可以点击“自动生成名称和描述”，让当前默认模型根据所选工具生成建议。执行前可以展开并编辑本次请求的提示词，也可以一键重置为根据当前选中工具生成的默认提示词。

4. 自动分组

点击“自动分组”后，可以先搜索、勾选本次需要整理的工具；插件只会把选中的尚未分组且未关闭工具交给当前默认模型。

执行前可以预览并编辑提示词；默认提示词会随工具勾选实时更新，自定义后也可以一键重置。自动生成的结果会先显示预览。确认后只会加入页面草稿，不会立即写入配置。

5. 保存修改

工具开关或分组发生变化后，页面会显示“有未保存的修改”。

点击“保存”后配置才会生效。运行中的 Agent 会从下一个模型步骤开始使用新策略。

如果在未保存时刷新页面或离开站点，插件会进行提醒，避免误丢草稿。

配置文件

配置默认保存在：

$DSH_HOME/tool-manager.json

如果没有设置 DSH_HOME，默认位置为：

~/.dsh/tool-manager.json

也可以通过环境变量指定其他路径：

DSH_TOOL_MANAGER_CONFIG

示例配置：

{
  "presets": {
    "standard": {
      "disabled": [
        "codex_image_generate"
      ],
      "groups": [
        {
          "name": "GitHub 工具",
          "description": "处理 GitHub Issue 和仓库内容",
          "patterns": [
            "mcp__github__create_issue",
            "mcp__github__list_issues"
          ]
        }
      ]
    }
  }
}

通常不需要手动编辑这个文件，直接在 WebUI 中操作即可。