前言¶

DSH 插件允許開發者擴展 agent 的能力。dsh-jev-decide 的作用是註冊一個名爲 jev_decide 的 agent 工具，將 TypeSafe Jev（”System One” 決策模型）接入 DSH。它解決的問題是：當 agent 需要做出快速、準確的判斷（例如消息緊急度分級、意圖路由、guardrail 檢查）時，調用 Jev 獲取結構化的概率輸出，而不是依賴對話模型憑感覺猜測。

核心功能¶

該插件主要提供以下能力：

1. 工具註冊：在 DSH 中註冊 jev_decide 工具。
2. 三種類型支持：支持 noul（是/否）、choice（多選一）、score（有序打分）三種類型的判斷。
3. 概率輸出：返回校準過的概率以及置信度。
4. 零配置憑證：複用 DSH 的憑證，無需額外配置 API Key。
5. 內置重試：內置 429 和 529 狀態碼的重試機制。

安裝¶

可以通過官方命令直接安裝：

dsh plugin --profile web add dsh-jev-decide

也可以通過 npm 安裝（需要 npm >=7 或 pnpm auto-install-peers）：

npm install dsh-jev-decide

配置¶

插件的數據目錄配置爲 $DSH_HOME/plugins/dsh-jev-decide/config.json（或通過 cordis patch 的 config:）：

{
  "model": "jev-latest",
  "timeoutMs": 15000,
  "baseUrl": "https://api.typesafe.ai/v1"
}

使用¶

調用 jev_decide 工具時，需傳入以下參數：

jev_decide({
  state: string,            // 必填，要評估的內容（純文本）
  question: string,         // 必填，要做的判斷
  type?: 'noul' | 'choice' | 'score',   // 默認 noul
  options?: string[],       // type=choice 時必填（≥2）
  levels?: string[],        // type=score 時必填（≥2，從低到高）
  yes?: string,             // type=noul 時可選：什麼算 YES（銳化校準）
  no?: string,              // type=noul 時可選：什麼算 NO
  model?: string,           // 默認 jev-latest
})

注意事項¶

1. 適用場景：Jev 不生成文本，僅用於判斷，不適合寫代碼或寫文案等生成文本的任務。
2. Peer 依賴：宿主不會把捆綁的 @deepseek-ai/dsh-tools 注入插件的模塊解析鏈。通過 link: 或本地路徑接入源碼時，需在插件目錄內先跑一次 npm install 把 peer 物化。
3. 手動接線升級：已按方式三手寫 insert 的 profile，不要再對它跑 dsh plugin add，否則會報 duplicate loader entry id 錯誤。