# 接入行为（0.3.1）

主要场景为 SnowLuma + qq-bridge + DSH Web。安装在桥接实际连接的 web profile 中，核对该实例的端口和 DSH_HOME。

## 默认选择

调用 bfy_ofm_onboard 或 /bfy-ofm onboard 时，未指定来源就先选择可确认的直接 DeepSeek 免费池；显式指定 qoder、qodercn、trae 等时选择该账号渠道。支持 trea 拼写别名。保持原思考档位；无法保持时说明原因并保留原选择。

这次显式操作通过宿主选模接口应用到当前会话，并由宿主保存为默认值。安装、创建或恢复聊天本身不会触发本插件改选。用户手动选模和 qq-bridge 的选模始终正常生效；不限制其他 OFM 模型、聚合模型、自定义模型或官方模型。

## OFM 安装

bundle 依赖官方 scoped OFM 2.8.0。缺少 OFM entry 时自动装载；已有实例则复用。接入时仅通过 OFM 的设置接口启用其总开关，不改隐藏模型、凭据、账号排序、限流锁或其他网关设置。账号登录、积分领取及权益核对由本人完成。

## 默认不自动转到官方

免费池失败时返回原因与下一步，不自动用官方余额兜底。用户可以自行在 DSH 中切换模型；插件另提供 fallback --confirm-official-billing 便捷命令，其近期故障与确认条件只适用于这个命令，不限制宿主的手动选模。便捷命令只更改当前会话，不重放结果未知的旧任务。

## 只观察调用

llm/stream 中间件只观察已发生的路由及完成状态，不拒绝、替换或重放请求。记录读取、写入失败时继续正常模型调用。已确认接入路由按会话保存用于比较证据，不是允许列表。

账号备用检查使用 OFM 原有 getAvailableAccount 排除首账号后检查备用；实际模型调用中记录不同选号的数量及切换布尔值，不保存账号标识或凭据，不改变 OFM 的选号结果。预检不算实际切换。

公开池没有账号，账号轮换不适用。两个可用账号只证明有备用，真实额度故障切换需另有实际回执。宿主提交可能对应多次上游恢复，物理请求数和实际扣费不从回执推断。

## 升级

0.3.1 移除 0.3.0 的全局模型封锁与 agent/created 自动改选。旧 onboarding-policy.json 保留作接入和回执记录，不再控制模型权限；不可读时接入命令报告问题，普通模型调用继续。旧 config.local.json 保留。桌面端曾手工停用插件条目时，升级后通过应用插件管理器重新启用。