dsh-jev-plugin：DeepSeek Harness 的類型化決策插件

在 DeepSeek Harness (DSH) 的智能體開發中，通常需要將 LLM 的文本輸出轉化爲結構化的決策。TypeSafe Jev (System One) 提供了結構化的判斷原語，但 DSH 本身不直接支持。dsh-jev-plugin 插件將 Jev 的能力封裝爲 DSH 的工具，使智能體能夠使用類型化決策，並提供可配置的護欄與審查機制。

插件概覽¶

dsh-jev-plugin 是一個獨立包，通過 dsh.bundle 安裝，無需修改 DSH 倉庫。它由 jackie-cqz 維護，當前版本爲 v0.1.1，採用 MIT 許可證。

核心功能¶

Jev 原語工具化：將 Jev 的三個核心原語暴露爲 DSH 工具。
- noul：用於是/否判斷，返回概率值（0-1）。
- choice：用於選擇標籤，返回選中的標籤、概率分佈和置信度。
- score：用於有序評分，返回分數、概率分佈和置信度。
配置化護欄與審查：
- Guardrails：提供風險攔截機制，可在工具執行前進行安全審查。
- Review：提供執行後的審查機制，可對已完成的結果進行修正。
Web UI 結果展示：支持在 Web 界面展示結果卡片。

安裝與啓用¶

安裝前需確認環境兼容性：Node.js 版本要求 >= 22，DSH 目標版本範圍爲 ^0.1.6-alpha.2 至 ^0.2.1-alpha.2。

1. 初始化 Web 配置（如需 Web UI）¶

如果使用 Web 界面，需先初始化配置文件：

dsh --profile jev-dev --from-default-profile web --dump-config

2. 添加插件¶

通過 GitHub 添加插件（指定版本標籤以鎖定版本）：

dsh plugin --profile jev-dev add github:jackie-cqz/dsh-jev-plugin#v0.1.1

安裝完成後，插件會自動註冊 decide 和 evaluate 工具（可通過配置項 enableDecide 和 enableEvaluate 控制是否註冊）。

配置與用法¶

插件依賴 TypeSafe API Key，並通過配置項控制功能開關。

基礎配置¶

必須配置 API 密鑰，支持直接設置或通過環境變量 TYPESAFE_API_KEY。

{
  "apiKey": "YOUR_TYPESAFE_API_KEY",
  "apiKeyEnv": "TYPESAFE_API_KEY",
  "baseURL": "https://api.typesafe.ai/v1",
  "model": "jev-latest"
}

啓用護欄¶

在工具執行前進行風險攔截。需設置 guard.enabled 爲 true，並配置風險等級（如 ["low","medium","high","critical"]）。

{
  "guard": {
    "enabled": true,
    "tools": [],
    "denyAt": 3,
    "askAt": 1,
    "escalateOnLowConfidence": true
  }
}

啓用審查¶

在工具執行後進行結果修正。需設置 review.enabled 爲 true，並配置修正概率閾值。

{
  "review": {
    "enabled": true,
    "blockAt": 0.8,
    "onError": "accept"
  }
}

啓用離線規則¶

在無 API 調用的情況下，通過正則表達式進行同步攔截。

{
  "rules": {
    "enabled": true,
    "tools": [],
    "deny": []
  }
}

適用場景與注意事項¶

該插件適用於需要結構化決策輸出、嚴格風控或強制審查機制的 DSH 項目。由於是獨立包，安裝前建議檢查源碼與許可證（MIT）。

技術棧：Node.js >= 22。
依賴：需要 @deepseek-ai/cordis 和 @deepseek-ai/dsh-tools 的兼容版本。
目錄頁：dsh-jev-plugin - 技能雲目錄
源碼地址：github.com/jackie-cqz/dsh-jev-plugin