前言¶

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 。