DeepSeek Harness (DSH) 通過插件機制支持豐富的模型接入。通義靈碼（Qoder）官方不提供 OpenAI 兼容的端點，本插件通過直連 Qoder 的 cosy 網關，爲 DSH 提供了模型接入能力，並補充了賬號池、每日簽到、積分讀數與模型管理功能。
核心功能¶
雙供應商並行接入¶
插件支持國內版與國際版兩個供應商，分別註冊爲 qoder 和 qoder-global provider。
* 國內版：使用 gateway.qoder.com.cn。
* 國際版：使用 api1.qoder.sh。
配置了 PAT 的區域，其模型會出現在 DSH 的模型選擇器中。兩個區域的模型可同時存在，不同會話可獨立選擇。
賬號池與 PAT 管理¶
- 多賬號池：支持多個 PAT，插件會自動去重合並設置、環境變量與本地 vault 中的憑據。
- 自動換號：開啓後，插件會根據實測可用性、積分有效期、餘額等規則自動選擇賬號，請求失敗時自動切換重試。
- 導入導出：支持按區域導出和導入賬號池配置。
模型管理與積分¶
- 模型管理：可刷新上游模型目錄，逐項勾選啓用或禁用。模型列表會顯示積分倍率、上下文限制、思考強度等。
- 可用性測試：每個模型行提供測試按鈕，發送真實請求驗證可用性（會消耗少量積分）。
- 積分讀數：只讀顯示各賬號剩餘積分與積分包到期時間，支持一鍵簽到。
- 安全隔離：採用安全 loopback shim，PAT 僅在本地與 pi-ai 交互，不外發到網關之外。
安裝與啓用¶
從發佈包安裝（推薦）：
# Desktop profile
dsh plugin --profile desktop add @dmh2002/dsh-connect-qoder
# Web profile
dsh plugin --profile web add @dmh2002/dsh-connect-qoder
安裝後需重啓對應 profile 的 DSH 進程以加載插件。
配置¶
創建 PAT¶
在 Qoder 賬戶設置中創建 Personal Access Token（pt-… 開頭）。
添加憑據¶
插件設置卡片提供 PAT 添加入口，優先級高於環境變量。
* 國內版：設置項 regions.cn.pat，環境變量 QODERCN_PERSONAL_ACCESS_TOKEN。
* 國際版：設置項 regions.global.pat，環境變量 QODER_PERSONAL_ACCESS_TOKEN。
添加 PAT 後，在模型管理頁點擊“從 Qoder 刷新”即可列出可用模型。
工作原理¶
插件在 DSH 內部通過 PiAiAdapter 接入，架構如下：
DSH PiAiAdapter
-> 安全 loopback shim（本地隨機端口 + 進程內 secret）
-> QoderUpstreamClient（cosy 協議最小客戶端）
-> 國內版 https://gateway.qoder.com.cn/algo/api/v2/...
-> 國際版 https://api1.qoder.sh/algo/api/v2/...
-> Qoder SSE（OpenAI 形狀增量）
-> DSH 本地執行工具並回傳結果
PAT 僅在獲取 jobToken 時使用一次，後續請求攜帶 cosy bearer 與機器指紋。PAT 不進入 pi-ai，不寫入 Qoder 桌面端登錄文件。
注意事項¶
- 安全性：PAT 只保存到本地插件配置，不外發。
- 國際版限制：國際版需要本機 Qoder 客戶端的設備風控組件支持。
- 測試消耗：模型可用性測試會發送真實請求，消耗少量上游額度。
- 錯誤處理：插件對憑據無效、內容審覈拒絕、額度耗盡等錯誤會如實分類。
