0.3.1 当前行为以 [接入说明](deepseek-onboarding.md) 为准：默认免费池，不限制手动或桥接选模。以下旧版接口说明用于兼容参考。

# 先用免费公开池，再按需要添加自己的账号

0.3.0默认只选择 DeepSeek，主入口为 `/bfy-ofm onboard`，指定本人账号为 `/bfy-ofm onboard qodercn` 等；旧 setup/独立 smoke 不替代新流程。免费池没有账号轮换；同一渠道至少两个可选择的有效账号只是就绪条件，实际切换还需调用回执。思考档位保持原值，低档位更快只是建议。

首次接入运行 setup 即可：从当前 OFM 目录选择公开免费模型作为主备，不要求先注册账号。默认只使用 our-free-model 下的直接公开模型，不把 EAC 前缀、账号渠道或用户编辑的聚合链自动加入。目录没有可确认的公开候选时会解释原因，停止等待，不静默切到付费账号。

## 免费公开池的限制

- 这是上游共享服务：并发、速率和使用量可能受限，繁忙时可能排队、429、超时或暂时不可用。
- 可用模型会增减、下线或改变能力；清单存在不保证本次请求成功，不能承诺永久免费或无限量。
- 可用性取决于你这台机器的网络出口、地区和上游策略；换网络后应在 OFM 中刷新或重新探测。
- 不适合作为重要业务的唯一保障。需要更可控的额度时，添加自己的账号并明确配置备用；不会自动替你购买或借用他人账号。
- 公开池请求仍会发送给对应上游。不要因为免费就提交敏感资料；查看 OFM 当前说明，确认实际服务来源和规则。

共享限制没有统一固定数值，本项目不编造每分钟次数或每日额度。失败时以实际错误和 OFM 面板为准。

## 添加自己的账号渠道

1. 打开 DSH 的“设置 → Our Free Model”，进入账号/渠道页面（当前上游称“白嫖模型接入”，名称可能随版本变化）。
2. 选择自己有权使用的服务，例如 TRAE 或 Qoder 中国版，按插件提供的官方流程登录或添加账号。登录及授权由本人完成，不把密码、Cookie 或 token 发给 Agent，也不导入别人提供的账号池。
3. 核对该服务的套餐、剩余额度、是否会消耗积分或付费余额；在 OFM 中启用所需模型并刷新目录。添加账号不等于所有模型免费。
4. 运行 doctor 查看实际 provider/model，再显式选择：

```sh
npm run doctor -- --use-local-session
npm run setup -- --config ./my-account-config.json --lanes trae/deepseek-v4.1-flash --use-local-session
npm run smoke -- --config ./my-account-config.json --allow-model-call --use-local-session
```

账号示例必须与本机目录一致。使用新配置路径可保留原公开池配置；如果要正式替换共享配置，先检查并人工合并，setup 不会悄悄覆盖。

也可把公开池放前面、自己的账号放后面，用 --lanes 明确排列完整链。但上游生成失败后不会自动重放未知结果；提交前选模失败和下一次新任务会按冷却选择备用。

原生插件同样支持 `/bfy-ofm setup` 默认公开池；指定账号渠道时使用 `/bfy-ofm setup provider/model`，已有不同配置需先合并。Qoder CN 的 dfmodel 需提供已核实的有效期限，见 integration.md。

OFM [上游使用和渠道说明](https://github.com/Ebony-Vinyl/dsh-our-free-model#使用说明)是账号流程与权益核对的来源，本项目不提供账号或替代官方授权。