# baifanyu-ofm 中文文档

规范地址：https://npmcn.com/package/baifanyu-ofm/

版本：0\.3\.1
npm 元数据更新时间：2026-11-03T04:11:36.962Z
中文译文更新时间：2026-11-03T04:57:56.023Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/baifanyu-ofm
原文对照：https://npmcn.com/package/baifanyu-ofm/?lang=original
项目主页：https://github.com/tasuma-qwq/baifanyu-ofm-bridge#readme
源码仓库：https://github.com/tasuma-qwq/baifanyu-ofm-bridge

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：130 kB，30 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：^22\.19\.0 \|\| \>=24\.0\.0
- 运行依赖：3 个
- 首次发布：2026-11-01T05:28:07.220Z
- 最新版本发布：2026-11-03T04:11:36.817Z
- 已发布版本数：3（近 12 个月 3 个）

## 中文简介

白饭鱼 OFM：DeepSeek 一句话接入、原思考档位保持与账号轮换回执，不限制手动选模

## 安装

```sh
npm install baifanyu-ofm
```

也可以使用：`pnpm add baifanyu-ofm`、`yarn add baifanyu-ofm`、`bun add baifanyu-ofm`

## README

# 白饭鱼 OFM · Web 接入

默认先选 DeepSeek 免费池，也可以显式选择本人已有的 OFM 账号。插件负责接入和查看调用、账号轮换回执；你在 DSH 中手动选择的模型，以及 qq-bridge 自己的选模继续正常生效。

**0.3.1 修复 0.3.0 的全局拦截问题。** 已移除模型拒绝逻辑及聊天创建/恢复时的自动改选。免费池是默认入口，不是只能使用的模型。

## 主要面向 Web + SnowLuma + qq-bridge

```text
QQ ↔ SnowLuma ↔ qq-bridge ↔ DSH Web ↔ OFM
```

把本插件安装到 **qq-bridge 实际连接的 DSH Web profile**，并使用该实例的 DSH\_HOME 和端口。SnowLuma 负责 QQ 接线，qq-bridge 负责把消息交给 DSH；本插件不接管它们的消息、账号登录、人格或记忆。

```sh
dsh plugin --profile web add baifanyu-ofm@0.3.1
```

遵守宿主正常安装、加载与供应链等待期。安装后在对应 DSH Web 会话说：

> 帮大肥鱼接入 OFM，默认先走 DeepSeek 免费池，保持当前思考档位，并检查账号轮换。

模型可调用 `bfy_ofm_onboard`。也可直接运行无需模型推理的命令：

```text
/bfy-ofm onboard
/bfy-ofm onboard qodercn
/bfy-ofm onboard trae
/bfy-ofm status
```

onboard 不指定来源时选免费池；指定渠道时选该渠道的 DeepSeek。目标不支持原思考档位时给出原因，不擅自调低。DSH 保存这次显式选模作为默认值；之后的手动选模和桥接选模不受限制，不会被本插件改回免费池。

免费池无账号门槛，但可能限流、拥堵或不可用。需要账号池时，在 OFM 中添加并授权本人已有的 qoder、qodercn、trae 等账号，再显式指定渠道；同一渠道至少两个可用账号才能检查备用。公开池没有可轮换的账号。

## 默认接入与手动选择

接入流程默认使用 OFM，不会在免费池失败后自动选择官方计费渠道。用户仍可在 DSH 中手动选择官方、其他 OFM 模型、自定义模型或聚合模型；本插件不拦截这些调用。

需要插件协助切回官方时，先了解其余额、套餐或 API 费用，再显式确认：

```text
/bfy-ofm fallback --confirm-official-billing
```

这只是插件提供的便捷切换流程，不是对宿主选模的权限限制。

## 证据与轮换

status 分别报告当前模型、OFM 实际调用、账号池备用预检和真实切换观察。预检不等于发生过切换；一次成功也不保证长期可用。账号调度、冷却与恢复仍由 OFM 管理。本插件只保存路由与回执，不保存提示词、回复正文、账号标识或凭据；观察记录出错也不会阻止模型调用。

缺少 OFM 时，bundle 带入官方 `@ebony-vinyl/dsh-our-free-model@2.8.0`；已有 OFM 则复用。桌面端使用应用插件管理器安装，作为补充支持场景。其他机器人框架尚未单独验收。

[接入说明](https://npmcn.com/package/baifanyu-ofm/docs/deepseek-onboarding.md) · [验证记录](https://npmcn.com/package/baifanyu-ofm/docs/validation.md) · [账号配置](https://npmcn.com/package/baifanyu-ofm/docs/public-pool-and-accounts.md)

## 来源与许可

OFM 属于 [Ebony-Vinyl/dsh-our-free-model](https://github.com/Ebony-Vinyl/dsh-our-free-model)。[qq-bridge](https://github.com/Derpyu520/qq-bridge) 与 [SnowLuma](https://github.com/SnowLuma/SnowLuma) 各自维护。本项目提供模型接入，不提供账号或完整 QQ bot。MIT；来源与保留声明见 LICENSE、NOTICE.md 和 third\_party/qq-bridge-LICENSE。

## 常见问题

### baifanyu-ofm 是什么？

白饭鱼 OFM：DeepSeek 一句话接入、原思考档位保持与账号轮换回执，不限制手动选模

### 如何安装 baifanyu-ofm？

在项目目录运行 npm install baifanyu-ofm，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 bfy-ofm，可以用 npx bfy-ofm 直接运行。

### baifanyu-ofm 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/baifanyu-ofm 是否存在。

### baifanyu-ofm 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### baifanyu-ofm 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js ^22\.19\.0 \|\| \>=24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### baifanyu-ofm 可以商用吗？

baifanyu-ofm 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### baifanyu-ofm 还在维护吗？

最新版本 0\.3\.1 发布于 2026/11/03（今天）；至今共发布 3 个版本，其中过去 12 个月发布了 3 个；首次发布于 2026/11/01。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。