前言¶

DSH 的理念是「一切皆插件」，LLM 供應商本身也是插件。但每接一個外部模型渠道，都要自己處理賬號登錄、Token 刷新、併發限流、SSE 流解析和錯誤重試，重複勞動很重。jianghuai24/dsh-free-ai 把這件事做了：把多個免費模型渠道統一註冊成 DSH 的 provider，瀏覽器登錄、賬號池輪換、每日簽到、模型黑名單和本地 OpenAI 兼容網關都內置。

這個插件維護者是 JiangHuai24，分類是模型推理。原型來自 dsh-codearts-auth（Gitee iJetLi/deepseek-harness-codearts，MIT，提交 345f0a07），經由 dsh-our-free-model 的 vendor/channel-pack 取出。下面介紹它的功能、安裝方式和需要注意的點。

這是什麼¶

一句話定位：一個 DSH 插件，把免費模型渠道接入 DSH 的 LLM 層，讓用戶不用自己寫適配代碼就能用這些渠道的模型。

它解決的問題是：免費渠道的登錄方式各不相同（瀏覽器、手機號、微信掃碼、OAuth 回調），賬號額度和限流策略也不統一，直接接入 DSH 需要維護一套適配層。插件把這層適配打包成 pack.js 單文件運行時，掛在宿主入口的 credentials / commands / llm 上。

核心功能¶

支持渠道：README 標註 13 個，涵蓋 CodeArts（華爲雲）、WorkBuddy 國內版/國際版、LobsterAI、Qoder、TRAE、Cline、Loomy、Raccoon、MiniMax Code、ZCode、Gemini 等。

• 瀏覽器登錄：CodeArts、WorkBuddy 等渠道走瀏覽器登錄，插件內提供登錄流程
• 賬號池：輪換、限流、冷卻、餘額排序、OAuth 刷新，憑據存於 DSH 的 credentials store
• 每日簽到：auto-checkin.ts 負責調度簽到領積分，結果寫 auto-checkin.json
• 模型黑名單：dead-model-store.ts 記錄上游下線的模型，避免反覆重試
• 本地 OpenAI 兼容網關：openai-gateway/ 給外部客戶端提供一個本地 OpenAI 格式端點

App 層（client）配置爲 web 平臺、immediately: true，瀏覽器頁面通過 /api/channel-pack 讀寫賬號和模型狀態。

安裝與啓用¶

官方安裝命令寫在 README 裏，按賬號對應 profile 執行：

dsh plugin --profile desktop add link:<倉庫目錄>

注意：鏈接安裝時 pack.js 按真實路徑解析 @deepseek-ai/*，而宿主提供的這些包在 app.asar 內、不在 profile 依賴裏，啓動可能報 ERR_MODULE_NOT_FOUND: @deepseek-ai/dsh-credentials。若遇到此問題，需把插件實體拷貝進 profiles/iso/node_modules/，讓 Node 沿目錄向上找到 profile 的模塊解析路徑。

不要與 dsh-our-free-model 同時啓用：兩者都會註冊 buddy / zcode / lobsterai 等同名 provider，並共用 $DSH_HOME/channel-pack 狀態目錄，同時掛載會互相搶佔。正確順序是：先停用 OFM → 裝本插件 → 重新登錄或用 backup 導入賬號。

典型用法¶

裝好後在 DSH 裏直接用對應渠道的模型即可，登錄走各渠道的瀏覽器流程。幾個用得上的細節：

• 賬號憑據的 ref 形如 BUDDY_ACCOUNT_AB12CD34；想沿用原來的 31 個賬號，需保持目錄名與 credentialRef 不變，改名就要重新登錄
• src/backup.ts 提供導出/導入，遷移前先導一份
• 狀態文件在 $DSH_HOME/channel-pack/state.json，可用 DSH_CHANNEL_PACK_STATE_DIR 覆蓋
• Gemini 渠道需要自備 OAuth 客戶端：設置環境變量 CMDC_PAK_GOOGLE_CLIENT_ID 與 CMDC_PAK_GOOGLE_CLIENT_SECRET（Google Cloud Console 建「桌面應用」類型客戶端，登記重定向 URI http://localhost:<端口>/oauth-callback）。倉庫不內置任何 Google 憑據

適用場景與注意¶

適合已經在 DSH 上跑多渠道模型、希望省掉適配層、或者想把免費渠道和已有模型池合併管理的人。

需要注意：

1. 這個插件以當前 dsh 進程的權限運行，能讀到宿主進程可訪問的文件和憑據存儲。安裝前請先檢查源碼和許可證（README 標註 MIT），不要直接上生產環境
2. 上游免費渠道的額度和可用性由上游決定，插件內部有賬號池和錯誤重試，但不保證某個渠道永遠可用
3. ZCode 那套驗證碼供給（captcha-*.ts）最容易壞，上游改版後可能需要手動更新
4. 改 src/ 下源碼後必須重新打包，index.js 掛的是 pack.js

收尾¶

dsh-free-ai 的價值在於把免費模型渠道的接入、登錄、限流和簽到這一整套髒活收斂到一個插件裏，DSH 用戶裝完登錄即可用。插件目錄頁在 https://www.skillhub.cn/plugins/JiangHuai24/dsh-free-ai ，源碼在 https://github.com/JiangHuai24/dsh-free-ai 。