dsh-decisions-classifiers：爲 DeepSeek Harness 提供的 OpenAI Decisions API 分類器

前言¶

DeepSeek Harness (DSH) 採用插件化架構，允許通過社區插件擴展功能。智能體在開發過程中常需要對文本內容進行分類或判斷，例如檢測有害內容、識別敏感信息或評估操作意圖。OpenAI Decisions API (gpt-6-luna) 提供了針對文本和圖像的斷言、選擇和評分能力，而非生成自然語言。dsh-decisions-classifiers 插件將 Decisions API 集成到 DSH 的工具鏈和服務中，使智能體能夠直接使用結構化的分類決策。

核心能力¶

該插件在 DSH 生態中提供了四個主要層面的集成：

• Agent 工具：在智能體上下文中直接提供工具調用能力，包括 decisions_classify（調用內置分類器）、decisions_ask（發起任意類型的結構化問答，每請求約 10 個問題）以及 decisions_status。
• Cordis 服務：對外提供 decisionsClassifiers 服務，包含 listPresets、classify、ask 和 status 方法，供其他插件調用。
• 可調用門：提供一個可選的預執行門控機制。默認關閉，開啓後會在 run_code、bash、write、edit 等操作執行前自動進行分類，並根據閾值決定是拒絕執行還是升級處理。
• 建議卡片：在 UI 的 ask_user_question 多選提示旁顯示分類器意見，允許用戶一鍵採納分類結果。

分類器庫¶

插件內置了一套分類器，涵蓋了常見的安全與業務場景：

對於上述列表之外的需求，可以使用 decisions_ask 直接發送任意類型的問題。

安裝¶

插件通過本地路徑安裝。請確保你有該目錄的訪問權限。

dsh plugin --profile <profile> add /absolute/path/to/dsh-decisions-classifiers

配置¶

安裝後，所有字段均可通過 Settings 頁面配置，配置持久化到 ~/.dsh/decisions-classifiers/config.json。Settings 中的設置優先級低於 bundle 行設置，且支持實時覆蓋。

使用流程¶

啓用插件並配置 API Key 後，使用步驟如下：

1. 安裝插件（見上方安裝命令）。
2. 打開 Settings → Decisions Classifiers。
3. 粘貼 OpenAI API Key，點擊 Store key。
   • Key 通過 DSH 憑證縫隙寫入環境變量 OPENAI_API_KEY（或你設置的名稱），頁面不會讀取回 Key。
   • 也可以直接在進程環境變量或 .env 文件中設置 OPENAI_API_KEY。
4. 點擊 Test connection 確認連接正常。
5. 在智能體配置中開啓 gateEnabled（若需使用調用門）。

注意事項¶

• 默認行爲：安裝此插件後，除非在 Settings 中手動開啓調用門，否則不會改變任何智能體的現有行爲。
• 憑證安全：Key 僅寫入環境變量，不會在界面上顯示，請妥善保管配置文件。
• 模型限制：當前 Decisions API 僅提供 gpt-6-luna 模型。