前言¶
在使用 DeepSeek Harness (DSH) 开发智能体时,为每条 Prompt 设定合适的思考深度(reasoningEffort)是一项重复且容易出错的工作。手动调整不仅效率低,还难以保证一致性。dsh-jev-thinking 插件通过接入 TypeSafe 的 Jev 模型,自动分析每条消息所需的推理强度,并将结果写入请求,从而简化了这一流程。
它是什么¶
dsh-jev-thinking 是由 kyan001 维护的模型推理类插件,遵循 MIT 许可证。它通过询问 Jev 模型“当前这条消息需要多少内部推理”,来动态决定模型请求的 reasoningEffort 参数。
核心功能¶
该插件主要实现以下逻辑:
1. 读取路由选项:插件会读取当前路由提供的思考层级(如 off、low、high),并将其作为选项发送给 Jev。Jev 无法选择不支持的层级,插件也不会在判断后调整层级。
2. 单轮提问:无论一条消息包含多少次工具调用,插件只向 Jev 提问一次。
3. 上下文补全:为了防止模型对简短回复(如仅一个“好”字)误判为无需推理,插件会将上一轮的助手回复也发送给 Jev。
安装¶
在终端中安装插件,需指定 Profile 名称(示例中使用 web):
dsh plugin --profile web add dsh-jev-thinking
或在 DSH 内部通过 Agent 执行:
plugin_manager { action: install_bundle, target: "dsh-jev-thinking" }
配置与使用¶
安装后需配置 API Key。可以在 DSH 插件页面手动配置,或直接在 ~/.dsh/.credentials.yaml 中设置。
插件默认配置项如下:
| 字段 | 默认值 | 说明 |
|---|---|---|
apiKeyRef |
TYPESAFE_API_KEY |
凭证存储中的名称 |
endpoint |
https://api.typesafe.ai/v1/systemone |
System One 端点 |
model |
jev-latest |
回答问题的模型 |
timeoutMs |
2500 |
超时时间,超时后触发降级 |
level |
空 | 失败时的降级层级,需路由支持 |
verbose |
false |
是否记录每次决策的日志 |
注意事项¶
使用该插件时需注意以下限制:
* 上下文依赖:插件只使用最后一条消息,引用旧消息(如“照你说的做”)可能被误判。
* Token 消耗:前一条助手回合会被发送给 TypeSafe,消耗约 750-9600 个 token。
* 路由支持:提供 xhigh 或 max 路由会将其添加到选项中,模型可能选择最高档位,导致成本增加。
* 降级策略:额度不足时不降级,每个 Prompt 都会尝试付费。
* 无限制选项:没有设置可排除或限制级别的选项。
结尾¶
该插件通过自动化决策减少了手动调优的工作量,适合需要精细控制模型推理深度的 DSH 用户。相关代码与目录可参考 GitHub。