前言¶
DSH 的理念是「一切皆插件」，模型側也不例外：如果你已經在用 Qoder 的國內版或國際版賬號，想在 DSH 的模型選擇器裏直接挑到同一批模型，你就得自己寫一個 provider 去適配 Qoder 的網關。Qoder 並不提供 OpenAI 兼容端點，官方 SDK 只是 agent 啓動器，協議上的三樣東西（COSY 簽名頭、置換 base64 請求體、雙層 SSE）都得自己實現。
下面介紹的 dsh-connect-qoder 就是把這件事做成一個現成插件。在閱讀前有一點必須先說清楚：這個倉庫已停更，README 首頁明確寫着最高只支持 dsh-0.21.5，且相關能力已合併到 dingminhua 的同名倉庫。所以本文介紹的對象是「插件線索給的這個倉庫」，同時把它的實際狀態和可用替代寫在前面的位置。
倉庫現狀與來源歸屬¶
插件線索給的倉庫是 hdhgsysh/dsh-connect-qoder，GitHub 上的 README 直接說明了兩件事：
- 此項目已停更，最高支持 dsh-0.21.5；
- 相關功能已合併到 dingminhua 版。
同一個 README 裏還有一段 fork 說明：該倉庫是 eghrhegpe 的同名倉庫的 fork，自帶的 scoped npm 包是 @eghrhegpe/dsh-connect-qoder（不帶 scope 的 dsh-connect-qoder 由上游發佈，裝到的是上游那份），當前版本 0.7.6，更新時間 2026-11-03，README 上標註 MIT license。插件包的 keywords 是 dsh-plugin / deepseek-harness / qoder / model-provider，engines 要求 Node ^22.19.0 || >=24.0.0。
也就是說，現在能裝上、並且在維護的那份，是 scoped 包這一支。社區插件目錄把它歸到「模型推理」一類（dshfind 插件頁顯示 11 stars，近 7 天 +2）。
核心功能¶
插件做的事情是把 Qoder 桌面端或插件自有登錄的賬號額度搬進 DSH，不需要用戶自己管簽名和編碼。以下能力都來自 README。
1、雙 provider 並行：國內版 qoder-cn（https://gateway.qoder.com.cn/）和國際版 qoder（https://api3.qoder.sh/）是兩個獨立 provider。裝哪個出現哪組模型，兩個都裝就兩組並存，各自用自己的賬號與額度。
2、三種憑據來源，桌面端優先：
- Qoder 桌面應用自己的登錄狀態（Windows 上通過 PowerShell + DPAPI 解密 Chromium OSCrypt 格式的憑據，新版讀 auth.v1.dat，舊版讀 state.vscdb）；
- 插件自己的設備登錄：瀏覽器裏批准一個碼，可刷新令牌存入 $DSH_HOME/.qoder-auth.<region>.json，按 region 分文件；
- 環境變量 PAT：國內版 QODERCN_PAT，國際版 QODER_PAT。
三條都拿不出可用憑據時，插件纔會報「沒登錄」；過期的桌面端憑據不再壓住後兩條。
3、用量膠囊：輸入框旁顯示區域前綴加主額度剩餘 Credits（例如 Qoder CN · 2,222），點開是用量面板，包含套餐內額度與剩餘、今日經本客戶端的請求數與 token 消耗（含緩存命中）、7 天趨勢、今日簽到狀態。名冊裏出現本機此前沒記過的模型時，膠囊會多出第三段 · 3 新模型，只列最近 7 天內首見的。
4、協議適配：每個網關請求都帶 Cosy-* 簽名頭和 Authorization: Bearer COSY.<payload>.<sig>；Encode=1 的請求體先 base64、再按置換字母表逐字符替換、最後按三分之一旋轉；每個 data: 幀是信封對象，body 字段本身又是 JSON 字符串，裏面纔是 OpenAI 風格的 chunk。這三樣是 Qoder 不是 OpenAI 兼容端點的原因，也是這個插件的主要工作量所在。
5、上游錯誤可見：上游失敗時返回的是普通 200 幀裏的錯誤對象而不是 chunk，插件把它翻譯成可讀錯誤。部分模型（README 例子是 GLM-5.3-Flash、Kimi-K3）聲明瞭推理檔位但不允許關閉思考，插件識別後完全省略 enable_thinking 字段，讓模型用自己的默認檔位，而不是發一個會被 provider_error 1210 拒絕的請求。
安裝¶
安裝命令來自 README，不要憑名稱拼接 dsh plugin add github:owner/repo。
從 npm 安裝（README 標註推薦）：
dsh plugin --profile web add @eghrhegpe/dsh-connect-qoder
--profile 後面是你自己起的 profile 名。改完記得重啓 DSH 進程，bundle 的 patch 在啓動時讀取。
DSH 桌面用戶也可以在「插件市場」裏粘貼這個源：
github:eghrhegpe/dsh-connect-qoder
github: 源是零配置的：宿主產物 lib/（host + client bundle）隨倉庫提交，克隆即可加載，安裝過程不需要批准構建腳本，也不需要拉 devDependencies。若 DSH 反而提示該包有待批准的構建腳本，說明拿到的是一份缺 lib/ 的舊克隆，刪掉重裝即可（lib/ 自 docs/issues/19 起必須入庫，CI 有新鮮度門禁）。
本地開發模式：
dsh plugin --profile web add <本倉庫路徑>
本地開發時 lib/ 對應提交時刻的源碼，改過 src/ 後要先 npm install && npm run build，再讓 DSH 指向本目錄，否則跑的還是舊產物。
追新的話走 npm：npm 每次發佈都會現場重建產物（prepack），同版本號下 npm 的產物比倉庫提交裏更新的可能性更大；github: 源裝的是對應提交時刻的產物。
典型用法¶
1、裝入插件後重啓 DSH。若 Qoder 桌面應用正在本機運行且登錄未過期，插件直接複用它，模型出現在 DSH 的模型選擇器裏，無需額外配置。
2、沒有桌面端時，走插件自有的設備登錄：在瀏覽器裏批准一個碼，返回的可刷新令牌落在 $DSH_HOME/.qoder-auth.<region>.json。這一路徑不讀桌面端任何東西，平臺無關。README 也誠實註明：這條路徑只在 Windows 上真機跑過兩區各一次授權閉環，在 macOS / Linux 上「確實能用」仍屬待驗證。
3、連設備登錄也不想走時，設環境變量兜底：
# 國內版
export QODERCN_PAT=<你的長期令牌>
# 國際版
export QODER_PAT=<你的長期令牌>
插件用 PAT 換取 job token 再發請求。
4、查用量時點輸入框旁的用量膠囊，展開的面板與 Plugins 頁卡片同一套讀數和閾值。退出插件登錄只刪 $DSH_HOME/.qoder-auth.<region>.json，不影響桌面端登錄，也不影響環境變量裏的 PAT。
適用場景與注意¶
適合的是這類人：本機已經登錄了 Qoder（國內版或國際版），想在 DSH 裏直接調用那批模型、順便看到額度和簽到狀態，不想自己寫網關適配。
需要知道的幾點：
1、只支持 Windows 的桌面端憑據解密。README 明確寫了 src/host/ 裏沒有 macOS / Linux 的解包分支：非 Windows 平臺上應用目錄能按平臺正確解析出來（Windows %APPDATA、macOS ~/Library/Application Support、Linux $XDG_CONFIG_HOME/~/.config），但憑據讀不出來，loadCredential 返回 undefined，賬號面板會如實提示改用設備登錄或 PAT。CI 的 Ubuntu 綠燈只說明測試能跑，不等於零配置在 Linux 上存在。
2、插件以當前 DSH 進程的權限運行，會讀取本地憑據文件、讀寫 $DSH_HOME 下的 JSON，並在 %TEMP% 短暫明文落盤解密主密鑰。安裝前應打開倉庫看一遍源碼與許可證（README 標註 MIT）。
3、本倉庫已停更，最高支持 dsh-0.21.5。需要登錄態複用、雙 provider 接入這類能力的，可以試試合併後的後續版本；後續版本還提供了賬號池、每日簽到和模型管理能力，社區目錄上另有 eghrhegpe 的 scoped 包在更新。
結尾¶
這個插件的價值在於把 Qoder 的私有協議細節收掉了：簽名、置換 base64、雙層 SSE 都由插件完成，用戶只負責選擇賬號和看額度。需要留意的是它停在了 dsh-0.21.5，並且只有 Windows 上能複用桌面端登錄態；其餘平臺可以走設備登錄或 PAT。
插件線索給的倉庫頁：https://github.com/hdhgsysh/dsh-connect-qoder
目錄頁：https://www.skillhub.cn/plugins/hdhgsysh/dsh-connect-qoder
可直接安裝的 scoped 包：https://www.npmjs.com/package/@eghrhegpe/dsh-connect-qoder
合併後的後續倉庫：https://github.com/dingminhua/dsh-connect-qoder
社區插件頁：https://dshfind.com/plugins/eghrhegpe/dsh-connect-qoder
