前言¶
DeepSeek Harness (DSH) 是一個以插件爲核心架構的智能體開發環境。dsh-qoder-connect 插件旨在解決 Qoder CN(阿里 Qoder 國內版桌面 App)的訂閱模型無法直接在 DSH 中調用的問題。該方案通過讀取 PAT 憑據,繞過桌面 App 的加密憑據,以 OpenAI 兼容接口的形式將 Qoder 模型接入 DSH,屬於個人自用方案。
核心功能¶
插件實現了以下功能,以適配 Qoder CN 的私有協議:
- OpenAI 兼容接口:在 DSH 中以標準 OpenAI 格式暴露 Qoder CN 模型。
- Provider 註冊:註冊
llm-qoderprovider id,渠道名爲qoder1。 - 憑據流轉:讀取 PAT 並交換爲短期
jobToken。 - 協議適配:實現 Qoder 自研的 COSY 簽名、請求體自定義編碼以及雙層 SSE 解析。
安裝與啓用¶
在使用前,需在 Qoder CN 官網生成 PAT 並完成配置。
- 生成 PAT:登錄 https://qoder.com.cn/account/integrations 生成 PAT。
- 配置憑據:將 PAT 寫入
$DSH_HOME/qoder/pat文件(權限 0600),或設置環境變量(優先級:QODERCN_PAT>QODERCN_PERSONAL_ACCESS_TOKEN>QODERCN_API_KEY)。 - 執行安裝:使用以下命令安裝插件(根據你的 DSH 版本選擇 profile)。
dsh plugin --profile web add github:yembors64632/dsh-qoder-connect
安裝完成後,插件會註冊 llm-qoder provider,不改動 profile 當前的默認模型。
使用方法¶
安裝並配置完成後,即可在 DSH 中使用 Qoder 模型。
- 在 DSH 的模型選擇器中選擇渠道名
qoder1。 - 插件會自動讀取 PAT 並獲取 jobToken 進行對話。
注意:該插件讀取的是原作者生成的 PAT,只對原作者賬號有效。若要在自己環境運行,需根據 README 指示修改硬編碼的路徑、端點和身份字段。
適用場景與注意¶
- 版本兼容性:DSH 核心版本需匹配
0.1.5/0.1.6/0.1.7alpha 線,否則啓動失敗。依賴 Node.js^22.19.0 || >=24.0.0。 - 憑據維護:PAT 過期不會自動續期,需手動重新生成。
- 使用範圍:僅供個人學習與研究,需遵守 Qoder 服務條款。上游協議爲私有實現,存在失效風險。
結語¶
該插件爲 DSH 提供了接入 Qoder CN 訂閱模型的可行路徑。相關目錄與源碼可參考下方鏈接。
- 插件目錄:https://www.skillhub.cn/plugins/yembors64632/dsh-qoder-connect
- GitHub 倉庫:https://github.com/yembors64632/dsh-qoder-connect