DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

DSH43 /

DSH43/dsh-tool-gate

Verified

把可选工具挡在请求外,模型调 load_tools 再按需放进来,减少每步的工具 schema 开销

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
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、重复启用不重发限制、未知名字、后到工具补挡、工具移除后自动摘名字、作用域本地工具豁免、注册失败回滚、索引超预算退化、无目标工具时等待再装、空配置不监听。

—/ 5

No ratings yet

Verified DSH bundle

Commit 59008e290ad2

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout