dsh-standard-toolkit：DeepSeek Harness 工具管家

DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在构建智能体时，如果全量暴露工具集，会占用大量 Token 且容易导致模型选错；如果只暴露极简工具集，又缺乏扩展能力。dsh-standard-toolkit 是一个装进 DSH 的「工具管家」，通过暂存区管理工具，按需加载，用完自动收走。

定位与维护者¶

dsh-standard-toolkit 是一个 DeepSeek Harness 插件，由开发者 suanniniu 维护。它解决了智能体开发中工具管理混乱的问题，核心价值在于：节省 Token、按需自动扩展、支持现场造工具。

插件采用 MIT 许可证开源。

核心功能¶

该插件通过一系列机制实现工具的自动化管理：

工具暂存区：工具默认收在仓库，不加载不占 schema；被取用才「摆上桌面」。
按需自动扩展：通过触发词匹配，自动加载对应工具。
会话隔离：动态工具注册在 agent 层，随会话销毁自动卸载，避免不同会话间的工具污染。
能力自我进化：模型可通过 register_new_tool 现场创造工具，自动完成规范审查、冒烟测试、分类、入库及立即可用。
两级触发词匹配：支持强触发（1 词即匹配）和普通触发（≥2 词组合匹配），避免误触发。
安全机制：工具纳入前必过规范审查（vetTool），访问未注入服务会被拒绝，入库前会进行冒烟测试。

安装与启用¶

安装前请确保已安装 Node.js (>=18)。

npm i dsh-standard-toolkit@1.1.1

发布策略说明（v1.1.1 起）：npm 包仅包含插件核（index.js + skills/ + vendor/ + docs/），工具集不随包发布。toolbox/ 目录是本地资产，需自行克隆仓库或通过 register_new_tool 生成。

手动挂载插件通常涉及复制文件到 DSH 运行时目录并注入配置。安装脚本 install.sh 或 install.bat 可以完成复制、挂载和校验工作：

# Linux/macOS/git-bash
./install.sh /path/to/dsh/runtime

# Windows
install.bat D:\path\to\dsh\runtime

安装后重启 DSH，日志应出现类似 mode=auto 暂存区=N 雷达=M 的信息。

使用方式¶

用户侧¶

用户侧使用无感。正常对话即可，插件会根据触发词自动加载工具。

示例：

你：算一下2026-08-01到2026-08-16隔多少天
dsh：→（命中触发词，自动加载 days_between）→ 返回 15 天

模型侧¶

插件会将可用工具名录注入系统提示。模型可以使用以下两个「钥匙」工具：

load_tool(name)：按名加载工具到当前会话。
register_new_tool(def)：现场创造新工具。

register_new_tool 支持参数包括 name、execute（源码字符串）、parameters、smoke、triggerKeywords 等。注册新工具需提供 smoke 参数进行冒烟测试。

自定义工具¶

自定义工具定义文件放在 toolbox/<分类>/ 目录下，文件名即工具名。文件需默认导出对象，包含 name、execute、parameters、metadata（含 triggerKeywords 和 smoke）等字段。

export default {
  name: 'days_between',
  description: '计算两个日期（YYYY-MM-DD）之间相隔的自然日天数',
  parameters: { 
    type: 'object', 
    properties: { date1: {type:'string'}, date2: {type:'string'} }, 
    required: ['date1','date2'] 
  },
  execute: async function (args, exec) { /* 纯逻辑 */ },
  metadata: { 
    triggerKeywords: ['算','隔','天'], 
    smoke: { date1:'2026-08-01', date2:'2026-08-16' } 
  },
}

安全与验证¶

插件内置了安全审查机制：
* 规范审查：vetTool 检查字段、JSON Schema、命名和服务访问白名单。
* 异常捕获：全链路异常捕获，归一化返回，绝不阻塞请求流。
* 冒烟测试：入库前仅运行作者显式声明的 smoke 参数，避免误触真实副作用。

可以通过以下命令验证插件逻辑：

cd dsh-standard-toolkit && npm test

适用场景与注意¶

适用人群：DSH 智能体开发者，需要精细控制工具暴露范围和会话环境的场景。
权限注意：插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
生态背景：DSH 生态目录（如 skillhub.cn）是社区站点，与 DeepSeek 或幻方无官方从属关系。

总结¶

dsh-standard-toolkit 提供了一套从工具定义、暂存、自动加载到销毁的全生命周期管理方案。它通过暂存区和会话隔离，解决了 Token 占用和工具污染问题，并通过 register_new_tool 降低了造工具的门槛。

更多细节可查阅：
* GitHub 仓库
* 插件目录页