前言¶
DeepSeek Harness (DSH) 是一個插件化的模型推理框架。對於同時使用 Qoder 國內版與國際版訂閱的用戶，手動管理兩條產品線的模型列表、額度與上下文窗口較爲繁瑣。masknull/dsh-qoder-connect 插件提供了統一的接入方式，支持雙變體獨立配置、PAT 實時校驗與即時保存，將 Qoder 的模型直接集成進 DSH。
核心功能¶
雙變體獨立配置¶
插件同時服務兩條 Qoder 產品線，各自一張設置卡片、一個 provider、一套憑證與模型目錄，互不混用。
- 國內版：provider id 爲 qoder，生成 PAT 需在 qoder.com.cn。
- 國際版：provider id 爲 qoder-global，生成 PAT 需在 qoder.com。
未保存 PAT 的變體不顯示模型分組，另一版完全不受影響。
PAT 實時校驗與即時保存¶
在插件設置卡片中粘貼 PAT 點“保存”，插件會先對該變體的區域實時校驗，通過後才落盤，模型分組立即出現，無需重啓 DSH。支持“更換 PAT”（新令牌校驗通過才覆蓋）與“清除 PAT”。
模型目錄三級降級¶
模型列表來源具有優先級：
1. live：實時拉取。
2. saved：本賬號上次成功目錄（重啓或斷網後頂上來）。
3. fallback：編譯進插件的兜底名單。
最近一次拉取失敗時附帶原因，並支持手動“刷新模型列表”。
上下文窗口一鍵切換¶
卡片列出每個模型的容量（默認值與最大值），並各自提供“使用上游聲明的最大上下文窗口”開關（默認勾選）。
- 勾選：按最大窗口（如 Qwen3.8-Max 的 1M）發請求。
- 不勾選：按默認窗口（200K）。
兩版開關狀態獨立保存。
模型自由開關與批量管理¶
提供“模型開關”頁，可自由開啓或關閉指定模型。關閉的模型將自動從 DeepSeek Harness 的模型選擇器中隱藏，避免誤選與列表冗長。支持按名稱/ID 搜索，以及全選與一鍵“批量開啓”/“批量關閉”。
每日自動簽到與日誌明細¶
支持每天自動簽到領取 100 Credits 算力額度，簽到時刻可在卡片上自定義（默認 10:00 UTC+8）。配備雙端開關與開機防漏補籤機制。卡片常駐“簽到日誌”面板，提供執行流水記錄與快捷操作。
側欄額度展示與倍率顯示¶
- 側欄額度：開啓後側欄底部出現該變體的額度小卡，點擊可在中間面板打開“Qoder 額度”明細，查看各資源包的剩餘/總量與進度條。
- 倍率顯示：模型名後直接拼上游報價的價格倍率（如
某模型 · x0.79），來自目錄接口的price_factor字段。
安裝與前置條件¶
需 DSH 核心 0.1.7-rc.1 及以上，以及 Node.js ^22.19.0 或 >=24.0.0。
使用官方 CLI 安裝：
dsh plugin --profile web add github:masknull/dsh-qoder-connect
指定 profile（如 desktop 或 tui）需替換 --profile web。
配置與使用¶
- 生成 PAT：登錄 qoder.com.cn（國內版）或 qoder.com（國際版），在賬號設置中生成 Personal Access Token。
- 保存 PAT：在 DSH 的插件設置卡片中，將 PAT 粘貼到對應變體的輸入框，點擊“保存”。
- 管理模型：在“模型開關”頁批量管理模型，或在“上下文窗口”頁調整最大上下文窗口開關。
- 自定義簽到：在設置卡片中自定義每日簽到時間。
注意事項¶
- 使用即表示自行承擔賬號被限制的風險，插件僅供個人學習研究。
- 雙變體配置獨立，互不混用。
結尾¶
通過該插件，DSH 用戶可以直接使用 Qoder 的算力資源進行模型推理。更多細節與源碼請參考 GitHub 倉庫。
