dsh-tool-activator

DSH Tool Activator

[![npm version][npm-version-src]][npm-version-href]

[![npm downloads][npm-downloads-src]][npm-downloads-href]

[![bundle][bundle-src]][bundle-href]

[![JSDocs][jsdocs-src]][jsdocs-href]

[![License][license-src]][license-href]

为 DeepSeek Harness (DSH) 减少初始工具上下文：默认仅展示基础工具，其余工具通过 activate_tools 按需加载。

• 系统要求：DSH $\ge$ 0.2.0-rc.2；Node.js $\ge$ 22.19.0。

---

核心行为

默认基础工具为 read、glob、grep、write、edit、skill、ask_user_question、todo_write，均可取消默认加载；只有 activate_tools 始终加载且不可关闭。

模型每次都看到：配置为默认加载的工具、已激活工具、activate_tools，以及其余工具的 `` 简述目录。

默认启用的工具

read、glob、grep、write、edit、skill、ask_user_question、todo_write

可通过 activate_tools 加载的工具

其余已安装且在当前 agent 作用域可见的工具默认隐藏，由模型按标识激活。常见内置工具：

| 分类 | 工具标识 |

| --- | --- |

| 文件写入 | write、edit |

| 命令执行 | bash、pwsh |

| 联网 | web_search、web_fetch |

| 后台任务 | job_output、job_list、job_kill |

| 终端 | terminal_open、terminal_send、terminal_read、terminal_signal、terminal_close、terminal_list |

| 目标 | get_goal、create_goal、update_goal |

| 会话检索 | session_search、session_event_search、session_trace、session_event_trace、session_event_read |

| 代码智能 | lsp |

| 编排 | subagent、subagent_fork、workflow、ralph、structured_output |

此外，任意已安装插件的工具都可作为标识请求；开启 autoGroupMcp 时，mcp__server__tool 还会按 server 聚合为 mcp.server。

实际可用集合将以 `` 目录呈现。该目录作为本插件自己的消息注入给模型，不占用宿主的运行时上下文快照，只有标识、名称和一句简述：

  Search the public web for current information.
  send: Send a message through the mailbox.

已激活的条目只保留标识符与可调用的成员名：工具描述已经在请求头的声明里，不必再重复一遍。

模型可按需请求加载工具或组：

{
  "identifiers": ["web_search", "web_fetch"],
  "reason": "需要检索并核对用户要求的公开资料"
}

激活不重写请求头

路由声明支持对话中途变更工具时（deepseek-flash 等，见模型目录的 toolUpdate），插件把全部工具一次性声明出去：基础工具正常声明，其余标 defer_loading（不占上下文 token）。激活因此不改动声明列表，只在会话尾部追加一条 tool_addition，提供方此前缓存的前缀保持有效。

不支持该能力的路由退回"按激活状态过滤声明列表"，功能不变，但每次新激活会重算一次请求头。

模型按需整理分组（group_tools）

用户明确要求整理分组时，模型可调用 group_tools：

• action: "list"：读当前作用域的分组与成员、尚未被任何分组认领的工具、基础工具与锁定工具。
• action: "apply"：按 ops 增（add）、改（update 名称、说明、整组成员，或用 rename 换标识符）、删（remove）分组；一次调用里可以先把工具从旧组删掉、再加进新组。
• basic 是默认存在的基础工具分组：只能 update 它的成员，add / remove 会被拒绝。

写入落在插件配置的 groups 字段，与配置页「工具分组」区是同一份文档。一次调用要么全成、要么全不成：被拒的批次一次列出全部问题，配置一个字节不变。收据只回新增 / 改写 / 删除的标识符与改名映射，模型拿到新标识符即可直接激活。

分组是用户的决定：只在用户明确要求整理分组时调用该工具，不要自作主张重组目录。

---

配置

进入官方插件管理页，打开 dsh-tool-activator 卡片，配置表单直接显示在该插件的页面上。

表单显示工具列表：