前言¶

在 DeepSeek Harness（DSH）里做智能体或日常对话，常见做法是自备各家 API Key，或在多个客户端之间切换模型来源。社区插件 dsh-our-free-model-fish 走另一条路径：安装后把匿名免费通道、Kilo 免费池，以及 CodeArts、CodeBuddy、TRAE 等十三个账号渠道一并挂进 DSH 官方模型选择器，并附带 OpenAI / Anthropic 兼容的本地转发端口，供 Claude Code、curl 或其它 harness 反代调用。

本仓库是上游 Ebony-Vinyl/dsh-our-free-model 的社区改版（fork），以 npm 包名 dsh-our-free-model-fish 独立发布；能力主体来自上游，Fish-under-sea 在此基础上做了少量增量。下文安装与升级步骤以 GitHub README 为准。

这是什么¶

dsh-our-free-model-fish 是 DSH 的「模型推理」类插件（当前版本 2.2.0，许可证 MIT，README 标注适配 DSH 0.1.5–0.1.7–rc.2，状态 beta）。维护者为 Fish-under-sea；上游作者为 Ebony-Vinyl。

插件行 id 与数据目录名仍为 our-free-model，设置与用量数据落在 $DSH_HOME/our-free-model/。从上游 npm 包切换过来时，目录不变，设置可保留。

相对上游（截至 2.2.0）的本改版增量包括：

• 渠道目录可见性总开关（src/channel-visibility.js）：十三个 provider 的分组可一次性收起，不必逐个关模型。
• 免费通道按面积计价（src/image-pricing.js）：缺少厂商视觉计价协议时，按图片真实像素估算视觉 token，替代上游固定 1024 的兜底；已从请求中移除的图片只计描述文本。
• 独立 npm 包名与发布；去掉上游 package.json 的 private，便于 npm 安装。

核心功能¶

下面只列 README 与 package 描述中已写明的、且与本 fork 使用直接相关的能力。

模型选择器与探测¶

• 安装后，在输入框模型选择器中出现 Our Free Model 等分组；清单随上游刷新，可用性由本机网络出口探测决定。
• 网关明确拒绝路由的模型会从下拉框移除，在设置页「不在选择器中」保留拒因；5xx、429、超时等不当作「模型不可用」。
• Effort 三档 Light / Balanced / Deep 对应真实输出 token 预算（非仅提示词）；思考不可关闭的模型档位整体上移，模型卡上会标注实际上限。

十三个白嫖渠道与免费池¶

• 十一个账号渠道（CodeArts、CodeBuddy / WorkBuddy、LobsterAI、Qoder、TRAE、Cline、Loomy、Raccoon、MiniMax Code、ZCode、Gemini 等）外加 Kilo 免费车道与原匿名免费通道；各渠道支持登录、账号池、积分领取、模型开关，凭据写入宿主凭据库。
• 渠道本地 OpenAI 网关默认监听 127.0.0.1:8326（Chat Completions + Responses）。
• 桌面端另有 EAC 协付通道（需 DeepSeek Harness 桌面端或 DSHEAC AIO）；命令行与其它宿主中该通道不存在。

本地网关与反代¶

• 设置 → Our Free Model → 本地转发：启用后提供 base URL 与 Key，支持 GET /v1/models、POST /v1/chat/completions、POST /v1/responses、POST /v1/messages 等；可选 局域网访问（独立局域网 Key，默认关闭）。
• 聚合渠道页可接入注册表内多家提供商（README 称 76 家），写入 Key 后模型以 provider/model 出现在选择器，并可经同一本地网关调用。

设置界面与其它¶

• 九页设置（免费模型、EAC、白嫖模型接入、数据看板、运行日志、网关设置等）；用量统计留在本机。
• 公告中心轮询仓库 feed；urgent 级别可全屏弹窗。
• 省 Token：工具输出压缩（RTK）、可选提示词瘦身、若干本地应答（默认行为见 README「聚合渠道、省 Token、路由与本地网关」一节）。

安装与启用¶

插件以 纯插件挂载 方式运行：不改 DSH 内核、无构建步骤、零 npm 依赖（插件包自身）。安装前建议浏览 仓库源码 与 MIT 许可证；插件以当前 DSH 进程权限运行，会发起外网请求并可能写入本机凭据与 Key。

命令行（纯 dsh web profile）¶

将插件目录放到本机后，在 profile 名称处替换为你的实际 profile（例如 web）：

dsh plugin --profile web add /绝对路径/dsh-our-free-model-fish

安装完成后重启应用一次。

若从 Releases 下载发布包并解压，也可绕开 git 解析：

dsh plugin add <解压目录>

DSHEAC AIO / 桌面端¶

桌面端 profile 有符号链接/junction 闸门，不要使用 link: 依赖。推荐在应用内 设置 → 插件 安装；或按 README 将发布文件复制到 profile 下 node_modules/dsh-our-free-model-fish/，在 dependencies 写入 "dsh-our-free-model-fish": "2.2.0"（版本随 package.json 同步），并在 dsh.profile.bundles 末尾追加 "dsh-our-free-model-fish"。

命令行 dsh plugin add 无法写入由 Electron 独占管理的 desktop profile；此类环境请在桌面端插件管理器操作。

本改版的升级方式（重要）¶

应用内「检查更新」读取的是上游签名清单；对本 fork 点「立即升级」可能用上游文件覆盖安装目录，并删除 channel-visibility.js、image-pricing.js 等本改版文件，导致 bundle 名与 dsh.profile.bundles 失配。本改版升级请走 npm，不要点应用内升级按钮：

npm i dsh-our-free-model-fish@latest

（在对应 profile 的依赖管理流程中执行，具体路径以你的 DSH 安装方式为准。）回滚副本位于 $DSH_HOME/our-free-model/rollback/。

典型用法¶

在 DSH 里直接选模型¶

1. 打开对话输入框的模型选择器。
2. 在 Our Free Model（及渠道相关分组）下选择模型；选择按会话持久化。
3. 在同一菜单调整 Effort；若回答被截断，可切到 Deep 或在设置中提高单次输出上限。
4. 若需收起十三个渠道在选择器中的分组，使用本 fork 的渠道目录可见性总开关（设置页，见 channel-visibility 相关 UI）。

给本机其它工具接 OpenAI 兼容 API¶

1. 进入 设置 → Our Free Model → 本地转发，启用转发并生成 Key。
2. 复制面板给出的 base URL（端口被占用时会顺延，以设置页显示的实际端口为准）。
3. 客户端按 OpenAI 习惯配置 base URL 与 api_key；需要 Claude Code / Anthropic SDK 时可使用 POST /v1/messages。

示例（路径与 Key 以设置页为准）：

curl "$BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<选择器中的模型 id>","messages":[{"role":"user","content":"hello"}]}'

核对地区与可用性¶

切换 VPN 或网络出口后，在设置页点击 重新探测可用性；region-limited 分组中的模型会随探测结果迁移。

适用场景与注意¶

适合谁

• 已在用 DSH（含 dsh web 或桌面端），希望在一个选择器里试用多路免费/账号渠道模型，并可选本地网关给其它工具反代。
• 需要从上游 fork 保留「隐藏渠道分组」或更贴近像素面积的视觉计价逻辑的用户。

使用前请知悉

• README 写明：匿名免费车道等来源公开（如 OpenCode Zen、Kilo 公共网关）；Kilo 等池可能记录 prompt 用于改进服务，勿发送敏感内容。
• 插件会登录第三方账号渠道、存储 Key、探测模型；在无 connection 服务的 composition 下，转发 Key 与本机进程同信任级别，局域网中继开启时同网设备可能消耗本机额度。
• 功能与界面绝大部分继承上游；通用 bug 与功能建议应优先提到 上游仓库，仅本 fork 引入的问题提到 Fish-under-sea/dsh-our-free-model-fish。
• 社区目录页 skillhub.cn 插件条目 与 GitHub 无 DeepSeek / 幻方官方从属关系；DSH 生态遵循「一切皆插件」，安装来源需自行甄别。

结尾¶

dsh-our-free-model-fish 把多路免费与账号渠道、模型探测、本地 OpenAI/Anthropic 网关收进一个 DSH 插件；本 fork 在不动数据目录的前提下，增加了渠道分组总开关与按面积视觉计价，并用独立 npm 包名发布。若你使用此改版，请记住升级走 npm i dsh-our-free-model-fish@latest，避免误用应用内上游升级。

• 目录页：https://www.skillhub.cn/plugins/Fish-under-sea/dsh-our-free-model-fish
• 仓库：https://github.com/Fish-under-sea/dsh-our-free-model-fish