Free AI by J.H

把 13 条免费模型渠道接进 DeepSeek Harness（DSH）：浏览器登录、账号池、每日签到领积分、 模型黑名单、本地 OpenAI 兼容网关。

原型来自 dsh-codearts-auth（Gitee iJetLi/deepseek-harness-codearts，MIT， 提交 345f0a07），经由 dsh-our-free-model 的 vendor/channel-pack 取出。

目录

index.js              宿主入口（薄封装：把 pack.js 挂到 credentials/commands/llm 上）
pack.js               由 src/ 打包出的单文件运行时（当前生效的就是它）
src/                  完整 TypeScript 源码（159 个文件），改这里
locale/               zh.json / en.json
qoder-auth-wasm.wasm  Qoder 加密推理必需，必须与 pack.js 同目录
scripts/build-pack.mjs  用 esbuild 把 src/ 重新打包成 pack.js
tsconfig.json         tsc 构建配置
cordis.patch.yml      DSH bundle patch（id: free-ai-by-jh）

13 个渠道

id	渠道	归属	登录
codearts	CodeArts	华为云	浏览器
buddy	WorkBuddy 国内版	腾讯	浏览器
workbuddy	WorkBuddy 国际版	腾讯	浏览器
lobsterai	LobsterAI	有道	浏览器
qoder / qodercn	Qoder / 中国版	阿里系	浏览器
trae	TRAE	字节	手机号
cline	Cline	Cline	浏览器
loomy	Loomy	讯飞	微信扫码 / 短信
raccoon	Raccoon	商汤	手机号
minimax	MiniMax Code	MiniMax	设备码 + PKCE
zcode	ZCode	智谱	浏览器 + 验证码
gemini	Gemini	Google	本地回调 OAuth

实现原理（分层）

DSH llm 请求
   │
   ▼
src/llm-adapter.ts          注册成 DSH 的 provider；选账号、包错误、算 token
   │
   ▼
src/account-pool.ts         账号池：轮换、限流、冷却、余额排序、OAuth 刷新
   │
   ▼
src/<渠道>-adapter.ts       把 DSH 的请求变成该渠道上游的线上格式
   │
   ▼
src/sse.ts                  SSE 流解析（各渠道事件形状归一到 DSH 事件）
   │
   ▼
src/channel-fetch.ts        出口（可选接代理），带 UA / 指纹

旁路：

模块	作用
<渠道>-product.ts	该渠道的模型清单、展示名、能力位
<渠道>-credits.ts + credits.ts	余额/积分查询与领取
auto-checkin.ts	每日自动签到调度（结果写 auto-checkin.json）
account-probe.ts	账号可用性探测
captcha-*.ts	验证码供给（ZCode 那套最容易坏）
dead-model-store.ts	上游下线的模型记下来，不再反复试
model-gate.ts / model-queue.ts	并发闸门与排队
token-ledger.ts	每个账号/模型/天的用量账本
openai-gateway/	本地 OpenAI 兼容端点（给外部客户端用）
channel-pack-rpc.ts	/api/channel-pack，浏览器页面读写账号/模型状态
channel-pack-store.ts	状态落盘：$DSH_HOME/channel-pack/state.json

状态与凭据

• 状态：$DSH_HOME/channel-pack/state.json（可用 DSH_CHANNEL_PACK_STATE_DIR 覆盖）
• 账本：token-ledger.json；签到：auto-checkin.json
• 凭据：DSH 的 credentials store，ref 形如 BUDDY_ACCOUNT_AB12CD34

想沿用原来的 31 个账号：保持目录名与 credentialRef 不变即可；改名就要重新登录。 src/backup.ts 提供导出/导入，迁移前先导一份。

改造入口（按你要改的东西找文件）

想改什么	改哪里
加一个新渠道	复制 <渠道>.ts / -auth / -oauth / -adapter / -product / -credits 六件套，在 index.ts 注册
登录方式	<渠道>-oauth.ts、<渠道>-auth.ts
模型清单/命名	<渠道>-product.ts、models.ts
请求/响应协议	<渠道>-adapter.ts、openai-compat.ts、sse.ts
签到与积分	<渠道>-credits.ts、credits.ts、auto-checkin.ts
限流/并发	account-pool.ts、model-queue.ts、retry-after.ts
网关对外形状	openai-gateway/

构建

# 源码改了以后必须重新打包，index.js 挂的是 pack.js
npm run build:pack      # 需要 esbuild；可用 FREE_AI_ESBUILD_DIR 指向已装 esbuild 的目录

# 想直接跑 lib/（不经单文件打包）
npm run build           # tsc -p tsconfig.json → lib/

打包时 @deepseek-ai/* 与 node:* 保持 external —— 必须用宿主同一份实例， 否则 cordis 上下文与 llm 注册表的 identity 检查会失败。

安装（⚠️ 先读）

dsh plugin --profile desktop add link:<仓库目录>

不要和 dsh-our-free-model 同时启用：两者都会注册 buddy / zcode / lobsterai 等 同名 provider，并共用 $DSH_HOME/channel-pack 状态目录，同时挂载会互相抢占。

正确顺序：先停用 OFM → 装本插件 → 重新登录或用 backup 导入账号。

隔离测试（不影响正在用的 DSH）

隔离环境：独立的 DSH_HOME，profile iso 从 web 模板生成。

# 1. 把改动同步进隔离 profile
powershell -NoProfile -File scripts/sync-to-test-profile.ps1

# 2. 启动隔离实例（独立端口，独立 storages）
$env:DSH_HOME='<隔离 DSH_HOME>'
& '<DSH 安装目录>\resources\runtime\cli\bin\dsh.cmd' --profile iso --no-open

为什么不能 link: 安装：链接安装时 pack.js 按真实路径解析 @deepseek-ai/*， 而宿主提供的这些包在 app.asar 内、不在 profile 依赖里，于是启动报 ERR_MODULE_NOT_FOUND: @deepseek-ai/dsh-credentials。把插件实体拷贝进 profiles/iso/node_modules/ 后，Node 沿目录向上找到 profile 的模块解析路径，渠道包即可挂载。