前言¶
DeepSeek Harness (DSH) 的設計理念是「一切皆插件」。在使用 DSH 接入 Qoder CN 的模型服務時，開發者需要處理 COSY 簽名和 WAF 編碼等協議細節。minglu6/dsh-provider-qoder 插件旨在封裝這些連接層面的配置問題，使開發者能直接通過 DSH 訪問 Qoder CN 的模型。
插件介紹¶
該插件由用戶 minglu6 維護，是 DeepSeek Harness 的一個適配器插件。它主要負責以下工作：
- 安裝路由：在 DSH 中註冊
qoder-cn提供者路由。 - 流式傳輸：處理與
gateway.qoder.com.cn之間的 COSY 簽名和 WAF 編碼流式傳輸。 - 模型目錄：從 Qoder 的
/algo/api/v2/model/list接口獲取簽名的實時模型目錄。 - 認證管理：將 PAT 存儲在模型頁面，並在進程間交換爲短期作業令牌。
安裝與啓用¶
安裝過程依賴已安裝 dsh 的環境。
- 執行安裝命令：
dsh plugin --profile web add github:minglu6/dsh-provider-qoder
- 啓動 Web 服務：
dsh web
啓動後，在設置界面添加提供者 qoder-cn，並粘貼 PAT 即可完成基礎配置。
配置與使用¶
插件註冊了 llm-qoder 設置命名空間。
公共雲使用：
僅需在設置 -> 模型中添加 qoder-cn 提供者，並粘貼 PAT。連接端點無需配置。
企業 VPC 使用：
在 settings.yaml 中設置 llm-qoder.vpcInstance。
模型目錄與覆蓋：
除非配置了 models 字段，否則插件會從 Qoder 拉取實時目錄。models 是一個可選的靜態覆蓋配置，用於完全替換實時發現功能，而非擴展它。新發布的模型（如 gmodel）無需更新插件即可通過實時目錄出現。
認證機制：
PAT 存儲在 DSH 的模型頁面，插件會在進程運行時將其交換爲短期作業令牌。若當前 DSH 構建版本不支持將未知適配器家族視爲 API 密鑰卡，可導出環境變量 QODERCN_PERSONAL_ACCESS_TOKEN 作爲臨時方案。
注意事項¶
- 該插件以當前 DSH 進程的權限運行，安裝前建議檢查源碼與許可證。
- 模型列表默認爲動態獲取，靜態配置
models會覆蓋此行爲。 - 若遇到認證或目錄加載問題，需確認 DSH 版本是否支持未知適配器家族的處理邏輯。
結語¶
該插件通過處理底層的簽名與編碼邏輯，簡化了在 DeepSeek Harness 中接入 Qoder CN 的流程。相關源碼與文檔可訪問其 GitHub 倉庫。
