工具库检索 JKL-agents/toollery-dsh

面向 DeepSeek Harness 的 Toollery

一个 DSH 插件，实现 Toollery，同时覆盖已注册工具和 DSH 原生技能目录。对工具，它为每个工具生成并缓存三条代理查询，然后用本地 BM25 检索为每轮用户输入挑选工具。对技能，它可以从 DSH 作用域原生加载器获取的技能正文生成并缓存意图查询，再检索 spec、manual 或 spec_manual 三种表示。DSH 原生 skill 加载器仍然负责完整正文的加载与执行；正文和手册不会进入模型可见的历史。

由 Jikun Liu 独立开发。与 DeepSeek 或 Toollery 原作者无隶属关系，也未获其背书。基于 XiangxiTian/toollery；见致谢。

安装并试用

在你现有的 DSH Desktop 中

打开 Plugins → Add plugin → Install a third-party plugin，输入：

@jkl-agents/dsh-toollery

1. 安装并启用插件；如果 DSH 要求重启，就重启。它复用你现有的聊天模型和工具——无需再装一个 DSH。
2. 启动时，只要 DSH 自带的 Python 或已有的 Python 3.12+ 可用，Toollery 会自动检查并安装配置档本地的 worker。这一步不调用模型，也不下载 Python。如果没有可用的 Python，打开 Toollery 的插件详情，选择 Set up local worker；Windows x64 用户可以显式允许下载私有 Python。技能 spec 模式不需要生成器；基于手册的技能模式只在缓存条目缺失、且你批准生成时，才使用配置好的生成器。
3. 任何使用手册的工具或技能表示（manual 或 spec_manual）：保存手册生成模型、兼容 OpenAI Chat Completions 的 API base URL 和 key。这些可以和你的 DSH 聊天凭据不同，保存在本地。spec 模式不需要生成凭据。
4. 工具检索或 both： 新建一个原生会话（Standard 预设），查看工具数量和可能的 API 费用，然后选择 Generate missing manuals (uses API)。技能则把 Target 设为 skills，再选技能表示。在基于手册的技能模式下，Toollery 提交前会检查本地缓存，只在需要时通过 DSH 原生加载器获取符合条件的正文。如果条目缺失，输入框会提供 Generate missing skill manuals (uses API)；草稿留在输入框里，准备完成后即可发送。有效的缓存手册会复用。
5. 请求某个已注册工具或相关原生技能。查看选中/调用的卡片，调整 k，或切换到 OFF。

不需要终端，也不用编辑 .env。插件不附带演示工具。工具池很大时，首次准备可能耗时；界面会显示进度和大致剩余时间。
如果 DSH 在安装或重装插件时报 npm 元数据/缓存 blob 缺失，即使已发布的包本身有效，这也可能是本地包管理器缓存不一致。如果报错信息里出现 npm，先关闭 DSH，在 PowerShell 里运行 npm cache clean --force，重启 DSH 后重试。这一步清的是 npm 的缓存，不会动 Toollery 的配置档数据或 API 设置。如果 DSH 仍报缓存错误，就从 latest GitHub release 下载 .tgz 安装，并在反馈时附上完整报错；参见 troubleshooting。

维护者和另一位同事已在另一台电脑上成功完成桌面端安装。本地兼容目标是 DSH Desktop 0.12.1 / DSH runtime 0.2.1-rc.2；适用范围见 verification summary。

命令行安装、固定版本的 .tgz 发布包、升级与卸载，参见 plugin guide。npm 会解析当前已发布的包；可下载的打包文件在 latest GitHub release。

没有现成 DSH？试试 Windows 演示

从 latest release 下载 Source code (zip)，解压后双击 Start-Toollery.cmd。私有依赖安装期间，请保持终端窗口打开。

在设置页选择 12 utility tools 和 Scripted preview，然后点 Start demo。不需要 API key，也不会产生付费请求。试试 Use add_numbers to add 19 and 23.，结果应为 42。Scripted preview 只支持示例提示词，不支持任意聊天。

这是独立的演示环境，不是插件安装。真实模型、文件系统工具、启动进度和停止演示，参见 launcher guide；终端/Web 命令参见 manual setup guide。

日常使用

- 准备完成后的默认值： ON / spec_manual / top-k / 工具 k=3、技能 k=3。可选 spec、manual 或 spec_manual；用 all 保留宿主允许的全部工具。
- ON/OFF： OFF 会让下一轮跳过 Toollery 检索，同时保留 DSH 中宿主允许的工具和原生技能目录；宿主限制仍然生效。设置对下一轮用户消息生效；一轮对话的选取在其各模型步骤中保持不变。
- 缓存更新： 已注册工具发生变化时，会在后续某一轮自动对齐，无需重启。默认自动生成最多 15 个缺失的工具手册；工具批次更大时需审批并重新发送消息。缺失的技能手册走单独的本地预检，并在发送提示词前由你在输入框显式批准。参见 generation policy。
- 紧凑面板： 收起控件和回合卡片，变成一个小号 ON/OFF 按钮，之后还能恢复，检索设置不变，草稿输入也不会丢。
- 技能适配： 把 Target 设为 skills，即可对当前原生技能目录排序，同时保留所有宿主可用的工具。选 spec 只按元数据路由；选 manual / spec_manual 则用正文推导出的意图查询来路由。工具检索用 tools，两条路径都要就用 both。技能正文通过 DSH 的受限原生加载器加载，调用和执行仍归 DSH 所有。
- 独立的 top-k： tools 显示 Tool rep 和工具 k；skills 显示 Skill rep 和技能 k；both 显示两个 rep，各自保留独立的 k 值，共用一个 Update k 操作。

在 DSH 中体验 Toollery

第一个演示展示如何在 DSH Desktop 中安装并启用 Toollery。第二个演示聊天窗口里 tools、skills、both 三种模式的控制项，包括各自的表示方式和 top-k 设置。

在 DSH Desktop 中安装并启用 Toollery

在聊天窗口里切换 Toollery 的 tools、skills、both 模式

结果与边界

在 ToolRet 开发子集（10,656 个工具 / 5,679 条查询）上，与只用 spec 检索相比，spec+manual 把 Recall@3 从 32.52% 提升到 37.23%，Recall@10 从 42.00% 提升到 48.48%。这些是实现层面的实验，不是对论文的复现。

检索只用最新的用户文本，不做历史改写，也不做恢复式搜索。top-k 设得太紧，可能漏掉后续追问或依赖类工具：ToolTalk 补充让 token 变少了，但严格适配后的回合成功率也从 67/79 OFF 降到 51/79 ON。需要更宽的访问范围时，调大 k 或切到 OFF。省 token 不代表延迟或质量一定变好。

支持原生根会话；PTC 和子代理检索不在本版本范围内。Toollery 只观察 DSH 提供的工具，不会自主发现或安装工具。可选的候选批量发现示例演示了由服务商负责的发现与排序，不注册也不执行候选。

宿主发布原生技能目录时，Toollery 可以用元数据（spec）或缓存的正文推导意图查询（manual / spec_manual）来路由。手动模式下，Toollery 只通过 DSH 的受限原生加载器读取正文，生成本地检索证据；它不会把正文投射进模型历史，也不改动技能服务商的权限。加载和执行选中的正文仍由 DSH 原生 skill 工具负责。没有原生目录的宿主保持原有行为。
插件包自带 95 个 sample-* 提示词技能，用来试用技能路由和 DSH 原生的按需加载器。这些技能不引入任何运行时包，但部分指令会引用项目文件或可选的外部服务。比如，让 DSH 用 sample-meeting-minutes 把一段简短转录整理成决策和行动项。源码和许可细节见 plugin/sample-skills/README.md。

只测技能时，把 Toollery 的检索目标设为 skills（界面上的 Target 控件，或 /toollery target skills）。这样会保留完整的宿主可用工具池，只收窄技能目录。常规工具检索用 tools，想同时评估两条路径就用 both。

文档

| 指南 | 内容 |
| 插件指南 | 桌面端/命令行安装、生成策略、兼容性、升级与卸载 |
| 配置 | 模型、凭据和缓存标识 |
| 独立演示 · 手动安装 | Windows 启动器、真实模型和终端/Web 演示 |
| 工具来源 · 故障排查 | MCP/Cordis 来源与诊断 |
| 验证 · 实验 | 安装检查、检索质量、token、延迟和限制 |
| 开发 · 发布 | 仓库结构、构建/测试命令和发布工作流 |
| 更新日志 | 已发布和未发布的变更 |

许可

原始代码采用 MIT 许可，版权归 Jikun Liu 所有，2026 年。第三方材料沿用各自条款；见 LICENSE 和 ACKNOWLEDGEMENTS.md。