大多數編碼智能體在處理“機械性決策”時，會消耗昂貴的推理 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）。
