前言¶
在 DeepSeek Harness(DSH)里跑智能体时,主模型往往要在大量已注册工具里做发现与选择。工具越多,首轮请求前的上下文与决策成本越高;若再配合联网搜索,还要在候选链接里挑哪些值得先读。社区插件 dsh-decisiontools(维护者 M4rkzzz,GitHub:M4rkzzz/dsh-decisiontools)提供一种可选方案:用有界答案的 Decision 服务在新会话首轮真实用户输入前做工具推荐,并可对搜索候选做预选与正文预读。主模型仍保留控制权,所有工具仍可通过常规发现与既有权限使用;插件描述为 advisory acceleration,不是 autonomous planner,也不替代主模型。
这是什么¶
dsh-decisiontools 是 DSH 社区独立插件(MIT,当前发布版本 0.1.8),分类为模型推理。它连接你自选的 Decision API(含 Jev/SystemOne 风格协议及常见自托管端点),在启用时对工具名与短描述打分并本地拉取至多六个高置信推荐的完整定义,供主模型直接使用或继续自行发现;可选功能会对已有搜索候选排序,并通过既有 reader 预读至多三个相关页面。无默认服务、密钥、选中模型或自动激活;关闭功能无需重启 DSH。
运行要求(来自仓库说明):DSH >=0.2.1-rc.2,Node >=22.19.0。设置界面标签目前为中文;无构建步骤,运行时无 npm 依赖。
核心功能¶
工具发现与 DecisionBoost¶
在新 genuine user input 的第一次请求时,Decision 服务对工具名称与短描述评分;随后在本地获取最多六个 confident 推荐的精确定义,交给主模型。任务进入执行后不会反复注入建议;Agent 中继、工具结果、待认领消息、纯图片消息等不会触发 decision 任务。出错、不兼容响应、弃权或超时时,普通发现路径保持不变。工具选择默认 6 秒截止;连续失败会打开短断路器。
会话悬停工具栏上的闪电图标可切换该会话的 DecisionBoost;全局也可在设置中启用已保存的模型。
搜索候选预选与正文预读¶
可选开关 搜索候选预选与正文预读(默认关闭)。启用后会对现有候选排序,调用现有 reader 预读至多三个相关页面;完整搜索结果与全部候选保持不变。摘录每页最多 6000 字符,标记为不可信且可能被截断;完整阅读仍可按原流程进行。当前适配包括原生 web_search(sources)配合 web_fetch,以及 mcp__web__search 配合 mcp__web__fetch_content;未知格式原样回退。
边界与隐私要点¶
不会注销工具、不会新增执行权限、不会改动主模型配置、精度或对话历史。启用时,Decision 服务会收到当前用户任务以及工具名与短描述;搜索辅助还会发送实际查询与候选标题、URL、短摘要。刻意不发送完整 schema、工具执行结果、完整抓取页、文件内容或完整对话历史(任务文本本身仍可能含敏感信息)。凭证经 DSH credentials 服务存储;本地状态位于 $DSH_HOME/decisiontools 或 ~/.dsh/decisiontools。
安装与启用¶
Desktop¶
在 DSH Desktop 的插件安装流程中使用仓库 URL,安装后按提示 reload/restart。不要装到与 Desktop 不同的 CLI profile 却期望在 Desktop 里出现。
https://github.com/M4rkzzz/dsh-decisiontools
CLI 管理的 web profile¶
将 web 换成你实际使用的 profile:
dsh plugin --profile web add 'git+https://github.com/M4rkzzz/dsh-decisiontools.git#v0.1.8'
各 GitHub Release 另附预构建 npm 格式 .tgz 及 SHA-256 校验和;包通过 GitHub 分发,不依赖 npm registry 发布。
自定义插件索引¶
开启 DSH 实验性 Custom plugin indexes,在 Plugins → Discover → Add index source 添加:
https://raw.githubusercontent.com/M4rkzzz/dsh-decisiontools/main/marketplace/index.json
format-1 索引将可安装 release 固定到精确 Git commit;为作者维护索引,非 DSH 官方背书。
配置步骤¶
下面按 README 中的 Configure 顺序说明。
- 打开 Settings → DecisionTools,填写 Decision API URL、凭证及认证模式(
bearer、api-key或none)。 - 选择 探测服务与模型;探测不会替你选定模型。
- 自行选择探测到的模型,再 测试所选模型并保存;也可留空模型并关闭 assistance 仅保存连接信息。
- 需要时启用已保存模型;会话工具栏闪电图标控制该会话 DecisionBoost。
- 按需开启 搜索候选预选与正文预读。
若探测到 D3 ultra,会显示推荐标签,但不会自动选中。禁用功能立即生效,无需重启。
典型用法¶
- 完成安装与 Decision API 配置,测试模型并保存。
- 在需要加速工具选择的会话上打开 DecisionBoost(闪电图标)。
- 若任务常涉及联网搜索,可在设置中单独打开搜索预选与预读,观察主模型是否更少重复发现、是否在仍保留全量候选的前提下获得短摘录。
README 明确:应对自身工作负载测量端到端耗时、额外 provider 成本与结果质量;在普通发现已经很便宜时,辅助也可能增加延迟,不承诺 universal speedup。
适用场景与注意¶
适合谁: 已部署或可访问兼容 Decision API(含 SystemOne/Jev 风格)的开发者;希望在首轮请求前缩小工具关注范围、或希望在搜索流程中先读少量高相关页面摘录,同时保留 DSH 原有工具注册与权限模型的人。
务必知晓:
- 插件以当前 DSH 进程权限运行;安装前应阅读源码与 MIT LICENSE、SECURITY.md,仅对可对外共享的数据启用外部 Decision 服务。
- 社区目录页 skillhub.cn 插件条目 与 GitHub 仓库为独立社区信息源,与 DeepSeek、幻方及 Decision API 提供商无官方从属关系。
- 非兼容 Decision API 不保证可用;任意 MCP 搜索服务器不会自动支持。
- 卸载:在插件管理器中卸载
dsh-decisiontools并按宿主说明 reload;若需清除保存的凭证,先重置插件设置。
结尾¶
dsh-decisiontools 在 DSH「一切皆插件」生态里,把 Decision API 收成可选、有界的前置建议层:工具仍全部可用,搜索候选与 reader 策略不被替换,只在首轮与可选搜索环节做加速。目录与详情见 SkillHub 插件页,源码与完整说明见 GitHub:M4rkzzz/dsh-decisiontools。