dsh-codearts：在 DeepSeek Harness 中接入華爲雲 CodeArts 模型

前言¶

DeepSeek Harness（DSH）採用插件化架構，允許用戶通過擴展來豐富功能。華爲雲 CodeArts 提供了包括 GLM-5.2、盤古、Qwen、DeepSeek 等在內的多種模型。要直接在 DSH 的對話窗口中使用這些模型，通常需要手動配置 API 密鑰或切換外部界面。dsh-codearts 插件旨在解決這一割裂問題，將 CodeArts 的模型資源直接接入 DSH 的對話流中。

這是什麼¶

dsh-codearts 是一個由 elegant01 維護的聯網工具類插件。它的核心功能是將華爲雲 CodeArts 的模型服務通過插件形式掛載到 DSH 上，使用戶無需離開 DSH 界面即可調用 CodeArts 的模型能力。

核心功能¶

插件實現了以下能力：
- 賬號登錄：使用 OAuth2 + DPoP 協議進行身份驗證，在 DSH 設置卡片中點擊即可完成登錄，無需手動填寫密鑰。
- 自動續期：憑證有效期約 2 小時，過期前會自動續期；續期失敗時會在界面上提示重新登錄。
- 多賬號輪轉：支持添加多個賬號。當某個賬號的會話槽位被佔滿時，請求會自動切換至下一個可用賬號，解決因併發限制導致的等待問題。
- 模型管理：通過配置項 enabledModels 控制模型選擇器中出現的模型；支持自動發現模型清單（內置 / 限時福利 / agent-center）。
- 用量統計：統計本機的請求次數、Token 消耗及會話槽位佔用情況。
- 視覺支持：支持圖片輸入。
- 降級方案：支持手動粘貼令牌，適用於腳本或排查場景。
- 命令行工具：提供 status、models、usage、identity、doctor、logout 等子命令。

安裝與啓用¶

插件需要從源碼構建並部署到 DSH 的 profile 目錄中。在項目根目錄執行以下命令：

pnpm install && pnpm run build
node scripts/deploy.mjs [profileDir]

其中 profileDir 默認爲 <用戶目錄>/.dsh/profiles/desktop。部署時需確保將構建產物（package.json、lib/、cordis.patch.yml）放入對應目錄，並更新 profile 的 package.json、node_modules/.package-map.json、node_modules/.modules.yaml。

典型用法¶

打開 DSH 設置，找到 CodeArts 卡片，點擊「使用華爲雲賬號登錄」。
瀏覽器會打開授權頁，登錄華爲雲賬號。完成後會自動跳回本機，憑證寫入 $DSH_HOME/.codearts-auth。
新建對話，在 provider 中選擇 codearts，然後選擇一個模型即可開始對話。

命令行工具¶

插件提供了命令行接口用於檢查狀態和查看詳情：

dsh plugin --profile <profile> exec dsh-codearts status
dsh plugin --profile <profile> exec dsh-codearts models
dsh plugin --profile <profile> exec dsh-codearts usage
dsh plugin --profile <profile> exec dsh-codearts identity [--fix]
dsh plugin --profile <profile> exec dsh-codearts doctor
dsh plugin --profile <profile> exec dsh-codearts logout

status：查看登錄狀態與模型清單。
models：查看上游真實返回的模型列表（包含內置、限時福利、agent-center）。
usage：查看本機用量賬本（非賬號總額度）。
identity：查看賬號穩定身份，--fix 可合併重複條目。
doctor：診斷環境，不涉及密鑰內容。
logout：清除本地保存的憑證。

注意事項與限制¶

憑證有效期：憑證有效期約 2 小時，過期前會自動續期。
併發限制：上游對每個賬號的併發會話數限制爲 3 個。中途停止生成並不釋放槽位，需等待約 1 分鐘。建議添加第二個賬號以實現自動輪轉。
身份識別：上游登錄響應不返回用戶標識，插件會再請求 /snap-manager/v1/current/user 獲取穩定的 user_id。
模型參數：模型參數（如 max_tokens）有實測上限，未實測模型使用保守值（65536）。
用量統計：用量賬本僅統計本機發出的請求，不等於賬號總額度。
合規性：僅供個人學習和研究使用，需遵守華爲雲及 CodeArts 的服務條款。

結尾¶

dsh-codearts 插件通過提供 OAuth2 登錄、自動續期和多賬號輪轉機制，有效地解決了在 DSH 中調用 CodeArts 模型的集成問題。該項目採用 MIT 許可證，維護者 elegant01。

目錄頁：https://www.skillhub.cn/plugins/elegant01/dsh-codearts
源碼：https://github.com/elegant01/dsh-codearts