前言¶
在构建智能体时，Agent 往往会接收到超出任务所需的能力。过多的工具和技能描述会消耗不必要的 token，而过度的调用则会增加延迟和成本。
dsh-just-enough-tools 是 DeepSeek Harness 的一个插件，旨在解决这一问题。它将工具和技能放入一个候选池，根据任务需求动态启用特定的能力，目标是在保持准确性的同时，将 Agent 的成本降低近一半。
工作原理¶
该插件由 Jev 驱动，支持可选的 OpenAI 兼容评分器。其核心逻辑是让 Agent 拥有独立的启用集。
Agent 的响应可以触发三种独立的操作：
1. 执行：调用已启用的工具。
2. 验证与启用：调用隐藏的工具，验证通过后将其加入启用集并执行。
3. 请求能力：通过 [REQUEST_CAPABILITIES] 标记，请求 Jev 对剩余候选池进行评分。
安装与启用¶
安装此插件需要满足以下环境要求：
* Node.js 22.19+
* DeepSeek Harness 0.1.7-alpha.1
* Cordis 4.0.3
步骤 1：构建并打包
在项目根目录下执行：
npm ci
npm pack
步骤 2：安装插件
使用提供的安装命令添加插件：
npx @deepseek-ai/dsh@0.1.7-alpha.1 plugin --profile web add /absolute/path/to/dsh-just-enough-tools-0.5.8.tgz
步骤 3：启动 Harness
npx @deepseek-ai/dsh@0.1.7-alpha.1 web
步骤 4：配置
1. 打开 Plugins -> dsh-just-enough-tools。
2. 选择提供商协议（如 System One / TypeSafe 或 OpenAI-compatible），配置凭证和模型。
3. 保存配置后，在 Just enough tools 模式下开始新对话。
配置与设置¶
插件提供以下可配置项：
| 设置项 | 默认值 |
|---|---|
| Tool / skill threshold | 0.5 |
| Maximum steps per user turn | 12 |
| Routing operation timeout | 60000 ms |
| Terminal routing diagnostics | Enabled |
Provider 选项：
* System One / TypeSafe
* Vercel AI Gateway (Evaluation)
* OpenAI-compatible / LM Studio
典型用法¶
假设任务为“修复登录错误并运行测试”。
- 思考阶段：Agent 输出
[REQUEST_CAPABILITIES]并表示需要检查登录流程。插件评分后，启用read和login-debug，隐藏edit和bash。 - 检查阶段：Agent 使用
read检查代码，再次请求能力。插件评分剩余候选，启用edit和bash。 - 执行阶段：Agent 执行编辑和测试，任务完成。
添加自定义 Skill：
创建 .dsh/skills/login-debug/SKILL.md 文件：
---
name: login-debug
description: Diagnose login and session failures before changing authentication code.
---
Reproduce the failure, inspect the relevant code, make a focused fix, and run the affected tests.
注意事项¶
- 独立项目：dsh-just-enough-tools 是一个独立的社区项目，采用 MIT 许可证。
- 权限运行：插件以当前 DeepSeek Harness 进程的权限运行。
- 错误处理：评分或注册失败会立即停止执行并报错。
- 环境要求：请确保使用 Node.js 22.19 及以上版本。
总结¶
dsh-just-enough-tools 通过 Jev 驱动的渐进式选择机制，帮助开发者更精细地控制 Agent 的工具访问。通过只暴露必要的技能，可以在不牺牲准确性的前提下有效降低 Agent 的运行成本。
