READMESource: main@59008e29
dsh-tool-gate
把可选工具挡在每个 Agent 的请求清单外,模型调用 load_tools 再按需放进来。
解决什么
工具 schema 每一步请求都要重发。默认组装有 60 多个工具(系统工具加浏览器 MCP),小任务也要在几十个 schema 里挑。这个插件在 Agent 创建时用 ctx.tools.restrict() 把可选工具挡住,只留一个控制工具:
- 控制工具的描述带一份“名字 + 一句话”的索引,模型看得到有什么可选;
- 模型调用
load_tools给出名字,对应工具解除屏蔽,下一次请求出现; - 注册表变化走
tool-addition,前缀缓存不受影响; - 传
{"reset": true}可以把放出来的工具重新挡回去。
实测:挡住 55 个工具后,首步的前缀从 17.4k token 降到 7.8k。这是每步都要重发的固定开销。
配置
cordis.patch.yml 里有两种写法。
keep:白名单(推荐)
列常驻工具,其余全挡。新装的插件、新接的 MCP 自动进屏蔽清单,配置不用跟着维护。
- insert:
- id: dsh-tool-gate
name: dsh-tool-gate
config:
keep:
- bash
- read
- write
- edit
- grep
- glob
- web_search
- web_fetch
- skill
- ask_user_question
# 可选,默认 load_tools
toolName: load_tools
hide:黑名单
只挡列出来的名字,其余不动。需要精确控制时用。
hide:
- subagent
- workflow
- mcp__browser__xhs_search
两种同时配时只按 keep 处理,并打一条 warning。组装里没有的名字自动跳过,所以同一份配置能给多套 preset 用;跳过的名字会 warning 一次,配置写错时能看到。
行为细节
- 组装里没有的工具跳过,不报错。
- 当前组装里没有、后来又注册上来的工具,
keep模式会自动补挡并进索引;hide模式只补挡hide里点名的。 - 未知名字调用
load_tools会报错并列出可用索引里的名字。 - 屏蔽失败(例如控制工具注册不上)会把已经生效的限制撤掉,本次会话不裁剪,不影响启动。
restrict只认全局和祖先作用域注册的名字。Agent 自己注册的工具(子 agent 的汇报工具、控制工具本身)挡不住也不用挡,被发现后会从清单里摘掉并 warning 一次。- 索引超过 4000 字符时先砍掉一句话描述、只留名字,保证模型仍然知道有哪些工具可以要。
- 子 agent 继承父 agent 的屏蔽(核心的限制是逐层相交的),而且子 agent 收不回来,所以它没有自己的有效索引。父 agent 先
load_tools再派子 agent,子 agent 才看得见那些工具。
安装
cd ~/.dsh/profiles/web
pnpm add github:DSH43/dsh-tool-gate # 本地开发用 pnpm add file:/path/to/dsh-tool-gate
再在 profile 的 package.json 里把 dsh-tool-gate 加进 dsh.profile.bundles,重启 dsh 生效。
测试
node test.mjs
覆盖:两种模式、启用与 reset、重复启用不重发限制、未知名字、后到工具补挡、工具移除后自动摘名字、作用域本地工具豁免、注册失败回滚、索引超预算退化、无目标工具时等待再装、空配置不监听。
No comments yet. Be the first to write one.