前言¶

在 DeepSeek Harness（DSH）裏跑 agent，通常要單獨配置各家模型的 API Key 或 Token。若你已經在 Qoder CN 桌面 App 裏訂閱了 Qwen、DeepSeek、Kimi、GLM、MiniMax 等模型，這些能力默認只能在 Qoder 客戶端內使用，官方並未提供把同一套賬號接到 DSH 的入口。

社區插件 dsh-qoder-connect（維護者 YSwo-fei，GitHub 倉庫 YSwo-fei/dsh-qoder-connect，當前版本 0.5.0，MIT 許可證）做的是：在本機已有 Qoder CN 登錄態的前提下，自動發現憑據、續期，並把網關上的模型註冊爲 DSH 的 qoder provider，對外呈現爲 OpenAI Chat Completions 兼容接口。分類上屬於 模型推理 類插件。

下面介紹它的定位、能力與安裝用法；涉及協議與賬號風險的部分，以倉庫 README 中的免責聲明爲準。

這是什麼¶

DSH Qoder CN Connect 是一條「零配置」橋接：不填 API Key、不單獨登錄、不填 PAT。插件讀取 Qoder CN 桌面客戶端本地的加密憑據文件，配合 WASM 簽名與 WAF 編碼訪問 Qoder 網關，在 DSH 裏提供約 14 個模型、大上下文檔位、聯網搜索與圖片上傳等能力。

項目與 Qoder、DeepSeek、DeepSeek Harness 官方均無從屬關係；實現基於對 Qoder CN 客戶端本地文件與網絡協議的分析，上游改版可能導致失效。插件以你運行 DSH 的進程權限在本機讀寫憑據與配置，安裝與啓用前請自行審閱源碼與許可證。

核心功能¶

以下均來自倉庫 README 與 package.json 說明。

憑據與模型¶

• 憑據自動發現：解密 %APPDATA%\com.qodercn.app.stable\auth.v1.dat（DPAPI + AES-256-GCM），並在 <DSH_HOME>/.qoder-auth.json 維護自留副本；雙源擇一、啓動鏡像、距到期不足 5 分鐘自動調用 deviceToken/refresh 續期。
• 14 個模型：從官方目錄實時拉取，失敗時使用內置兜底；在 DSH 中選 provider qoder 即可使用。
• 上下文檔位：目錄支持 200K / 400K / 1M，默認可給最大檔（配置項 contextTier 可逐模型覆蓋）。

Agent 相關能力¶

• 聯網搜索：可註冊爲 DSH 的 web 搜索 provider（默認 webSearch: true），走 Qoder 搜索端點。
• 圖片上傳：對話中的內聯 base64 可上傳到 Qoder 圖牀換 OSS URL，失敗可回退（默認 imageUpload: true）。
• 回合身份：重建 business.id / stage，便於 Qoder 積分面板按回合聚合。
• 推理檔位探測：實測各模型實際接受的 effort 檔位。

賬號與界面¶

• 額度 / 簽到：查詢剩餘積分、訂閱套餐；支持自動領取每日獎勵（默認 30 分鐘輪詢，autoCheckIn: true）。
• 圖形界面：DSH 插件詳情頁提供賬號、額度、模型、檔位、搜索、圖片等 tab。
• 命令行：status、doctor、models、ask、refresh、logout、credits、checkin、search、upload 等。

環境要求¶

安裝與啓用¶

倉庫 README 提供兩種掛載方式，核心都是在 profile 裏以本地包形式依賴插件。

方式一：作爲 profile bundle（推薦）¶

將插件源碼放到本機目錄後，編輯 <DSH_HOME>/profiles/<profile>/package.json：

{
  "dependencies": {
    "dsh-qoder-connect": "file:/絕對路徑/dsh-qoder-connect"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "dsh-qoder-connect"
      ]
    }
  }
}

在 profile 目錄執行 pnpm install，然後重啓 DSH。

方式二：放入插件目錄¶

將整個插件目錄複製到 <DSH_HOME>/.dsh/plugins/dsh-qoder-connect，再按上表在 profile 的 dependencies 與 bundles 中引用。

重啓後打開 設置 → 插件 → DSH Qoder CN Connect，應能看到賬號與模型列表。

典型用法¶

健康檢查與試跑¶

# 四項全綠纔算健康
dsh plugin --profile desktop exec dsh-qoder-connect doctor

# 查看模型目錄
dsh plugin --profile desktop exec dsh-qoder-connect models

# 直接發起一次推理
dsh plugin --profile desktop exec dsh-qoder-connect ask qfmodel "你好"

在 DSH 對話或 agent 中選 provider qoder，再選具體模型即可。

常用 CLI¶

dsh-qoder-connect status              # 憑據 / 模型 / 額度總覽
dsh-qoder-connect doctor [--json]     # 逐項體檢
dsh-qoder-connect models [--json]     # 模型目錄
dsh-qoder-connect ask <模型> <內容>    # 單次推理
dsh-qoder-connect refresh             # 立即續期
dsh-qoder-connect logout              # 刪除自留憑據副本（不動桌面 App 登錄）
dsh-qoder-connect credits [--json]    # 額度與套餐
dsh-qoder-connect checkin             # 立即簽到
dsh-qoder-connect search "查詢內容"    # 聯網搜索
dsh-qoder-connect upload ./圖片.png    # 上傳圖片

可選配置¶

可在 DSH 插件配置或 profile 的 cordis.patch.yml 中調整，例如：

uid / token 一般留空即可自動發現；手動指定僅在有特殊需求時使用。

適用場景與注意¶

適合誰：已在 Windows 上使用 Qoder CN 桌面訂閱、希望在 DSH 裏用同一賬號跑 agent / 工具調用 / 聯網搜索，且接受非官方橋接方案風險的開發者。

憑據與合規：README 明確說明協議爲逆向分析所得，可能違反 Qoder 服務條款；賬號限制、積分清零等風險自負。憑據僅在本地解密與續期，請求發往 Qoder 官方域名，但代碼公開，需自行審計。lib/wasm_prelude.mjs 來自 Qoder CN 客戶端的 WASM 簽名模塊，版權屬 Qoder，介意者可按文檔從本機安裝目錄自行提取。

刪掉桌面 App 後：自留副本與自動續期可使插件在桌面 App 卸載後仍工作，直至 refresh token 長期過期（約一年量級）需再在桌面 App 登錄一次。

DSH 生態：DSH 採用「一切皆插件」思路；SkillHub 目錄頁 爲社區收錄，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

dsh-qoder-connect 的價值在於：在 Windows + Qoder CN 已登錄的前提下，以最少配置把桌面訂閱模型、搜索與圖牀能力接到 DSH 的 qoder provider。使用前請完整閱讀倉庫免責聲明，並在本機審閱代碼後再啓用。

• 目錄頁：https://www.skillhub.cn/plugins/YSwo-fei/dsh-qoder-connect
• GitHub：https://github.com/YSwo-fei/dsh-qoder-connect