前言¶
DeepSeek Harness (DSH) 是一個以插件爲單位的模型推理平臺。將 System One 決策模型（Jev）接入 DSH 時，開發者面臨一個結構性難題：Jev 本身不生成文本，它接收 state 和類型化問題，返回類型化答案與置信度，接口並非 Chat Completions 或 Anthropic Messages。這意味着它不能作爲主模型，只能作爲工具掛載。
kaijia323/dsh-plugin-jev 解決了這個問題。它將 TypeSafe Jev 註冊爲 DSH 的原生工具 jev_decide，通過零依賴的方式接入 DSH 強制 JSON Schema 子集，並自動聲明觸發策略。
核心功能¶
原生工具註冊¶
插件通過 ctx.tools.register 註冊一個名爲 jev_decide 的原生工具。該工具符合 DSH 強制 JSON Schema 子集（JsonSchemaNode），不走 MCP 的註冊路徑，而是直接註冊到工具目錄中。
零依賴實現¶
插件不依賴任何 @deepseek-ai 包，僅使用 DSH 提供的上下文 API 進行註冊。這保證了插件的輕量級和獨立性。
觸發策略聲明¶
爲了解決“插件已裝、工具可調用，但沒人告訴模型什麼時候該用它”的歷史問題，插件在兩個層面聲明觸發政策：
- A 面（工具描述）：
jev_decide.description以政策開頭，包含用途、默認開判據、四條豁免、七個決策時刻、預算限制及返回形狀。 - B 面（常駐政策段）：通過
ctx.inject(['systemPrompt'], cb)註冊一個名爲jev-decision-policy的 prompt section。該段在 web profile 的每個會話全局生效，無需模型主動“發現”工具。兩者都由同一組 POLICY 常量拼裝，確保一致性。
TypeSafe API 傳輸¶
插件僅支持官方 TypeSafe API 作爲傳輸層。配置項 transport 必須設爲 typesafe。插件負責將請求參數（state, questions）歸一化爲 noul 類型，並調用官方端點 POST {baseURL}/v1/systemone。
安裝與啓用¶
插件採用 bundle 層安裝模式。包聲明瞭 dsh.bundle.patch，安裝後自動激活。
- 安裝插件：
dsh plugin --profile web add /path/to/dsh-plugin-jev
- 配置參數：
插件支持配置傳輸類型、密鑰、超時等參數。配置項包括transport、baseURL、model、apiKeyEnv、keyFile、timeoutMs、toolTimeoutMs、retries、maxStateBytes、maxQuestions和policySection。
注意事項：
* 配置衝突：安裝前必須刪除配置層中已存在的同 id（tool-jev）行，避免出現配置層出現同 id 兩行。
* 重啓服務：使用 CLI 安裝（dsh plugin --profile web add）後，需要重啓 dsh web 進程才能生效，因爲安裝操作不會實時更新運行中的會話。
適用場景與說明¶
該插件適用於需要將 System One 決策邏輯嵌入 DSH 工作流的場景。由於 Jev 不生成文本，它主要用於需要類型化答案和置信度校準的決策任務。
- 返回類型：插件不生成文本，返回類型化答案與校準置信度。
- 政策生效：B 面政策段在 web profile 的每個會話全局生效。
- 靜態策略：政策是靜態文本，不發起網絡請求。
結語¶
kaijia323/dsh-plugin-jev 提供了將 TypeSafe Jev 接入 DeepSeek Harness 的標準路徑，通過原生工具註冊和自動策略聲明，解決了決策模型在 LLM Seam 中的集成難題。
