前言¶

在長會話或複雜工作流的智能體開發中，工具返回的結果往往容易失控，不僅消耗大量上下文額度，還可能混入惡意指令。dsh-jev-tools 是一個 DeepSeek Harness 插件，它利用 Jev 判定模型（TypeSafe System One）作爲“預診臺”，在內容進入上下文之前進行篩選和判定。

插件介紹¶

該插件由 HorusJiang 維護，分類屬於 admin-security。它並不替代主模型，也不生成文本，而是通過概率排序的方式對輸入內容進行分類和處理。

核心功能¶

插件提供了以下五項核心能力：

1. 精簡工具輸出
   對 read、grep、glob、web_fetch、web_search 的結果進行精簡。如果結果超過 2000 tokens，插件會逐段判定相關性，保留相關的段落。保留是散佈的，而非連續砍斷。

2. 注入篩查
   對 web_fetch / web_search 抓取的正文進行篩查，判定其中是否有針對 AI 的指令。一旦越過閾值，會附上提醒，但內容仍會按原樣進入上下文（不攔截、不改寫）。

3. 技能推薦
   在每輪首次組裝 prompt 且技能目錄 ≥ 15 個時，根據最新一條用戶消息（或最近三條）選出至多一個最匹配的 skill。

4. jev_ask
   模型主動調用。接收任意帶類型的問題，直接拿回帶概率的答案。

5. jev_gate
   模型主動調用。在宣佈“做完”之前，逐條覈對聲明有沒有證據支持。這是插件唯一一處將 Fail-open 策略倒過來的地方，任何含糊路徑都會觸發 escalate。

安裝與啓用¶

安裝前請確認已安裝 DeepSeek Harness。

dsh plugin --profile web add dsh-jev-tools

注意：--profile 參數必填，它會將參數原樣轉發給該 profile 目錄裏的 pnpm。web 對應桌面 / Web 應用，請替換爲你實際使用的 profile。也可以在 DSH 的插件頁面按包名安裝，該路徑會一步完成安裝並啓用。

配置與診斷¶

啓用後，插件默認開啓所有自動能力。若要調整行爲，需配置 TypeSafe API Key。

API Key 配置¶

未配置 key 時插件完全惰性，不生效也不髮網絡請求。配置方式有三種：
1. 使用官方 SDK 的環境變量 TYPESAFE_API_KEY。
2. 在 DSH 設置中粘貼保存（密鑰經憑證域寫入，不回顯）。
3. 通過環境變量或 .env 文件配置（解析順序：進程環境 > project-env > user-env > .env > 託管存儲）。

配置項¶

主要配置項包括總開關、密鑰變量名、判定端點、模型，以及精簡與技能推薦開關。其餘閾值、白名單等可在配置行中修改。

診斷命令¶

使用 /jev-status 命令查看啓用狀態、key 來源、判定端點、判定次數以及每一次跳過的原因（如 task-too-vague、budget-turn 等）。

注意事項¶

1. 輸入限制：僅支持文本輸入，無圖無音頻。
2. 模型定位：不是另一種大模型，不替代主模型進行寫作、推理或工具調用。
3. 概率非標定：輸出概率僅用於排序，不是標定概率，不可作爲正確率指標。
4. Fail-open 策略：除 jev_gate 外，其他能力失敗時原樣放行，判定失敗不影響任務。
5. 數據邊界：部分數據（如工具輸出正文、抓取的頁面正文、當前任務文本）會發送到配置的 System One 端點（默認 api.typesafe.ai）。
6. Key 要求：需要 TypeSafe API Key。

總結¶

該插件爲 DeepSeek Harness 提供了基於 Jev 判定模型的輸出管理能力，適合需要在上下文管理、安全篩查和技能路由上做精細控制的場景。更多細節可參考GitHub 倉庫或社區目錄。