大多数编码智能体在处理“机械性决策”时，会消耗昂贵的推理 Token，例如判断 Bug 属于哪个模块、是否阻塞核心流程或修改风险等级。这会让主模型（如 DeepSeek）无法专注于深度的代码生成和调试。
dsh-jev 是 DeepSeek Harness (DSH) 的一个插件，它通过 TypeSafe Jev 提供语义化工具路由和类型化决策。它能将判断工作分流到轻量级模型，返回概率分布和打分，从而让主模型从简单的分类任务中解放出来。
核心功能¶
该插件提供了以下能力：
- 类型化判断：提供
typesafe_evaluate和jev_evaluate工具，支持choice（类别选择）、noul（0-1 真值概率）和score（打分）三种类型。 - 技能与工具发现：提供
jev_find_skill和jev_find_tools工具，根据语义匹配推荐相关的技能（SKILL.md）或工具。 - 管理命令：集成
/typesafe和/jev斜杠命令，用于状态查看、登录鉴权、测试、校准和管理。 - 成本与限额追踪：支持按日追踪请求次数、Token 数量和 USD 成本，并支持设置每日限额。
- 校准工具包：提供阈值校准工具，支持通过 AUC、精确率、召回率等指标进行历史样本的阈值优化。
- CI/CD 验证：提供
dsh-jev-gate（或jev-gate）CLI 工具，用于 CI/CD 流程中的验收检查。 - 优雅降级：当 Jev 未配置或离线时，会自动降级到本地关键词启发式搜索。
安装与启用¶
在 DSH 的配置目录（例如 ~/.dsh/profiles/web）下，执行以下命令安装：
pnpm add file:C:/Users/lldois/workspace/dsh-jev
安装完成后，需要在 package.json 中将插件加入 dsh.profile.bundles 配置中：
{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-jev"
]
}
}
}
配置与使用¶
-
配置 API Key：
你可以通过斜杠命令配置，或者直接设置环境变量。- 斜杠命令：
/typesafe login your_api_key_here
Key 会保存到 `~/.pi/agent/pi-typesafe/auth.json`。
* **环境变量**：
export TYPESAFE_API_KEY=your_key_here
export PI_TYPESAFE_ENABLED=1
- 运行校准：
如果需要调整决策阈值，可以使用校准工具：
/typesafe calibrate
- 调用工具示例：
模型或代码可以通过传入 JSON 状态和问题来调用类型化判断。例如判断 Bug 的归属和严重程度：
{
"state": {
"title": "升级后无法登录",
"body": "输入密码后一直回到登录页"
},
"questions": {
"area": {
"type": "choice",
"instructions": "这个问题属于哪个模块？",
"criteria": {
"auth": "登录与身份验证",
"ui": "界面与布局",
"other": "都不符合"
}
},
"blocking": {
"type": "noul",
"instructions": "这个问题是否阻止用户继续使用产品？"
},
"severity": {
"type": "score",
"instructions": "评估这个问题的严重程度：",
"criteria": [
"仅影响外观",
"存在可用绕过方案",
"阻止核心流程"
]
}
}
}
注意事项¶
- 版本要求：DSH 版本需大于等于
0.1.5-rc.1。 - 成本：API 调用需要付费，输入 Token 价格约为 $0.042 / 百万。
- 依赖：插件依赖的 Peer dependencies（如 cordis, schemastery, dsh-tools 等）被标记为可选，通常由 DSH 环境提供。
- 许可证：MIT 许可证。
总结¶
dsh-jev 为 DeepSeek Harness 提供了结构化决策能力。通过将机械性的分类、评分和路由任务从主模型剥离，你可以利用 Jev 快速、低成本地获取概率分布，进而编写确定性的代码逻辑（如 if probability > 0.85）。
