dsh-ofm-updater

给 DSH Desktop 的 Our Free Model 插件做一键更新 —— 双击就行，不用命令行。

中文 | English

---

下载

最新版：Releases → latest

下载 dsh-ofm-updater-vX.Y.Z.zip，解压，双击 Update-OurFreeModel.bat 即可。 压缩包内只有 4 个文件，不需要 git，不需要安装 Node。

也可以直接克隆仓库：git clone https://github.com/ZelotsNullzwei/dsh-ofm-updater

---

为什么需要它

先说清楚：Our Free Model 本身是个很好的项目，作者和贡献者一直在快速迭代。 本仓库不是它的替代品，也不替代它的任何功能 —— 只是在「应用内升级」这条路走不通时， 提供一个能用的备用通道。

OFM 自带「应用内升级」，但它长期不可靠，国内用户实际上只能手动更新。 上游仓库里相关 issue 一直开着：

Issue	问题
#237	升级检查失败：三个清单源全部被墙（raw.githubusercontent / jsdelivr）
#85	client.js 改了没重签清单 → 1.4.4 用户全升不上去
#120	升 2.0.0 必然失败（4 个文件与签名清单不符）
#232	升级检查响应超 256KB 上限 → 所有版本失效

本脚本把「手动更新」这件事固化成双击一个 .bat，并处理掉实操中的四个坑。

这些坑都是实际踩出来的，Issue 编号只是引用公开记录，不是为了指责任何人。 如果上游之后修好了应用内升级，本仓库就可以退休了。

另外还解决一个不算 bug 但更容易卡住人的问题：OFM 内置的「立即升级」是热重载 实现的，在 Node 上无法跨版本生效，几乎必然报 activation version mismatch。详见 关于 OFM 内置的「立即升级」。

---

致谢

这个工具是站在 Our Free Model 的肩膀上的。

没有上游那个项目，就没有这个脚本存在的理由 —— 它做的事（把十三个账号渠道、 免费车道、EAC 垫资、聚合路由、省 token、原生 Anthropic 网关都收进一个插件里， 且无需注册或填 API Key）本身就很了不起，而且迭代速度很快。

感谢作者 @Ebony-Vinyl 以及贡献者们 （按上游发布说明整理）：

• @look-back-lysj — 桌面版 PR 整合、EAC 服务迁移与离线密封工具
• @zixin947 — 桌面启动与生命周期修复、发布签名、升级回退验证
• 流影似景 — 前端夜/昼主题与 Tauri 桌面版初始实现

本仓库与上游没有任何隶属关系，也没有得到官方背书。它只是一个用户侧的运维小工具： 上游负责把插件做好，这里只负责在「应用内升级走不通」时，让更新这件事还能完成。

如果上游哪天把升级通道修稳了，这个仓库就该退休了 —— 那才是更好的结局。

---

相关工具

如果你的需求更广（不只是 OFM 一个插件，还包括主程序或其它插件）， 下面这些项目可能更适合：

• dsh-launcher — 一键安装 / 更新 / 维护 dsh 与插件
• dsh-update-checker — npm / GitHub 双源更新检查
• dsh-our-free-model-installer — OFM 桌面端一键安装器

本工具只专注一件事：OFM 在国内网络下的一键更新（含 PATH 修复与慢网络处理）。

---

用法

1. 完全退出 DSH Desktop 不只是关窗口 —— 托盘图标也要退出。确认任务管理器里没有 DSH Desktop。

2. 双击 Update-OurFreeModel.bat

3. 重新启动 DSH Desktop

升级完成后，OFM 里确认版本号即可。

首次打开 OFM 若提示需要 GitHub 授权，属正常现象 —— 部分版本迁移了服务端， 旧授权需要重新确认。

---

它解决的四个坑

1. dsh 和 pnpm 不在系统 PATH 里

DSH Desktop 把自己的 dsh / pnpm / node 放在

%APPDATA%\DSH Desktop\host-commands\<profile>\generations\<hash>\bin
%APPDATA%\DSH Desktop\runtime-commands\generations\<hash>\bin

并且只注入给它自己派生的进程。双击打开的干净 cmd 窗口两个都看不到，于是 dsh plugin 报：

'pnpm' 不是内部或外部命令

因为 dsh plugin 内部是 execa("pnpm", ...) —— 它靠 PATH 找 pnpm。

本脚本会主动定位这几个目录并前置到 PATH，然后再动手。

2. GitHub（codeload）在国内很慢

实测 9 MB 的包只有 30~40 KB/s，需要 4~5 分钟。pnpm 默认超时扛不住， 而且它的日志只有一句

Command failed with exit code 1

不说明原因 —— 这是最难排查的地方。

本脚本会在 profile 的 pnpm-workspace.yaml 里写入放宽的超时：

fetchTimeout: 900000        # 15 分钟
fetchRetries: 5
fetchRetryFactor: 2
fetchRetryMintimeout: 10000
fetchRetryMaxtimeout: 120000
networkConcurrency: 4

开代理会快很多。脚本本身不配置代理，但会沿用系统代理设置。

3. GitHub 的 archive/refs/heads/main.tar.gz 不能用

它内容可变，pnpm 无法记录 integrity，会报：

ERR_PNPM_MISSING_TARBALL_INTEGRITY

必须用 codeload.github.com + 固定 commit sha：

https://codeload.github.com/Ebony-Vinyl/dsh-our-free-model/tar.gz/<sha>

本脚本就是这么做的。

4. 装 main 最新提交 ≠ 装发布版

2026-10-18 更新

官方发布流程是 tag + Ed25519 签名 + manifest 钉死 sha256。而 main 上随时可能有 未发布的中间提交 —— 实测当天：

	commit	说明
release v2.5.3	e465d73	官方签名发布版
main 最新	f0b979f	多一个 docs 提交（未发布）

跟 main 装的话，feed/manifest.json 里的摘要和磁盘文件对不上，之后 OFM 自己的 更新检查会报：

the committed digests do not describe the files on disk:
  vendor/channel-pack/pack.js: size 2882871 in the manifest, 2883308 on disk

所以本脚本默认只装最新 release tag。要试 main 请显式传 -TargetBranch main。

---

⚠️ 关于 OFM 内置的「立即升级」

这是本仓库存在的另一个原因，也是很多人卡住的地方。

如果你在 OFM 设置页点过「立即升级」，大概率见过这个：

升级失败: upgrade failed, previous files restored
(re-import failed, old code still running
 (activation version mismatch: expected 2.5.3, got 2.5.1))

这不是网络问题，也不是你操作错了 —— 是热重载在 Node 上做不到跨版本升级。

OFM 的升级流程（src/reload.js）：

1. 下载新文件并落盘
2. 清掉 Node 的 ESM loadCache 与 CJS require.cache
3. 重新 import() 入口
4. 校验新模块报的 version 是否等于期望值
5. 对不上 → 判定失败 → 回滚文件

问题在第 2 步：Node 的模块缓存不可能被彻底清干净。已经求值过的 ESM 模块 即使从 cache 里删掉，也可能还有别处持有旧引用，于是第 3 步 import() 拿到的 仍然是旧版本，第 4 步必然 mismatch。

结论：跨版本升级必须重启进程。 OFM 那个「文件变化自动热重载」开关 只适合同版本内的开发迭代，不适合升级。

所以：

• 本脚本要求你先退出 DSH 再运行，装完必须重新打开
• 装完看到 OFM 里的版本号还是旧的？重启后就对了
• 不用管 OFM 那个升级失败提示，它不是你的问题

为什么脚本不帮你重启

因为 DSH 重启会打断你自己正在做的事，而且托盘退出、进程残留这些状态 脚本没法可靠判断。明确让你自己重启，比脚本猜着杀进程安全。

---

命令行参数

参数	说明
-English	用英文输出（默认中文）
-DryRun	只检查，不改动任何东西
-Rollback	回滚到上一次备份
-TargetSha <sha>	安装指定的 commit
-TargetBranch <branch>	跟踪某分支最新提交（默认不跟分支，只装 release）
-Profile <name>	DSH profile 名（默认 desktop）

例子：

Update-OurFreeModel.bat -DryRun
Update-OurFreeModel.bat -Rollback
Update-OurFreeModel.bat -English

---

备份

每次更新前会自动备份到 backups\<时间戳>\：

package.json
pnpm-lock.yaml
pnpm-workspace.yaml
node_modules-plugin\     （当前插件完整目录）
user-data\               （设置 / 授权 / catalog）
update.log               （本次安装日志）

回滚：Update-OurFreeModel.bat -Rollback

注意：如果上游做了服务端迁移，回滚到旧版本不保证旧服务仍可用 —— 这一点上游发布说明里也提示过。

---

直接改配置也能用

如果你不想用脚本，手动流程等价于：

# 1. 退出 DSH Desktop

# 2. 给 pnpm 放宽超时（写进 profile 的 pnpm-workspace.yaml）
#    fetchTimeout: 900000

# 3. 用 codeload + 固定 sha 安装
dsh plugin --profile desktop add "https://codeload.github.com/Ebony-Vinyl/dsh-our-free-model/tar.gz/<sha>"

# 4. 启动 DSH Desktop

脚本只是把这几步自动化了，并多做了一份备份。

---

已知限制

• 只针对 Windows + DSH Desktop。路径布局按 DSH Desktop 的实际实现写 （host-commands / runtime-commands），如果 DSH 改了这套布局，脚本需要跟进。
• 只更新 dsh-our-free-model，不是通用插件更新器。
• 脚本会写入 profile 的 pnpm-workspace.yaml（追加超时配置），会先备份该文件。
• ReadKey 已做成智能暂停：有控制台才等按键，被管道/CI 调用时直接退出。

---

文件

文件	作用
Update-OurFreeModel.bat	双击入口（纯 ASCII —— cmd 按 GBK 解析 .bat，UTF-8 中文会被当命令执行）
Update-OurFreeModel.ps1	实际逻辑（UTF-8 with BOM —— PS 5.1 对无 BOM 的 UTF-8 按 ANSI 读，中文会坏）

---

English

One-click updater for the Our Free Model plugin in DSH Desktop.

OFM's built-in updater has been unreliable for a long time (see issues #237, #85, #120, #232). Users in mainland China effectively have to update by hand. This script freezes that manual flow into a double-clickable .bat.

Usage

1. Fully exit DSH Desktop (including the tray icon).
2. Double-click Update-OurFreeModel.bat.
3. Start DSH Desktop again.

What it handles

1. dsh and pnpm are not on PATH. DSH Desktop injects them only into the processes it spawns, so a plain cmd window fails with 'pnpm' is not recognized. The script locates both and repairs PATH.
2. GitHub (codeload) is slow. Measured 30-40 KB/s for a 9 MB tarball (~5 min). pnpm's default timeout kills it, and its log says only "Command failed with exit code 1" with no reason. The script writes generous fetchTimeout / fetchRetries into the profile's pnpm-workspace.yaml.
3. archive/refs/heads/main.tar.gz cannot be used -- its content is mutable, so pnpm cannot record an integrity hash and fails with ERR_PNPM_MISSING_TARBALL_INTEGRITY. Always use codeload.github.com with a pinned commit sha.
4. Installing main ≠ installing a release. Upstream publishes as tag + Ed25519 signature + manifest-pinned sha256, and main regularly runs ahead of the newest tag (measured 2026-10-18: release v2.5.3 = e465d73, main = f0b979f). Installing main makes feed/manifest.json disagree with the files on disk. The script therefore installs the latest release tag by default; pass -TargetBranch main only if you really want a branch head.

⚠️ About OFM's built-in "Upgrade now"

If you ever clicked it, you probably saw:

upgrade failed, previous files restored
(re-import failed, old code still running
 (activation version mismatch: expected 2.5.3, got 2.5.1))

That is not a network problem or user error. OFM upgrades by hot-reloading: write files → purge Node's ESM loadCache and CJS require.cache → re-import() the entry → verify the new module's version. Step 2 cannot be done reliably in Node: an already-evaluated ESM module may still be referenced elsewhere, so the re-import returns the old code, the version check fails, and the upgrade rolls back.

Cross-version upgrades require a process restart. OFM's "auto hot-reload on file change" toggle only makes sense for same-version development.

Therefore: exit DSH before running this script, and restart DSH afterwards. A stale version number inside OFM after installing is expected until you restart.

Options

-English (English output), -DryRun, -Rollback, -TargetSha <sha>, -TargetBranch <branch>, -Profile <name>.

Backup

Each run backs up package.json, pnpm-lock.yaml, pnpm-workspace.yaml, the installed plugin directory, and OFM user data into backups\<timestamp>\. Roll back with -Rollback.

Credits

This tool stands on the shoulders of Our Free Model — without that project there would be no reason for this script to exist. Thanks to @Ebony-Vinyl and the contributors (@look-back-lysj, @zixin947, and others).

This repository is not affiliated with or endorsed by the upstream project. It is a user-side maintenance helper. If upstream ever makes the built-in updater reliable, this repo should retire — that would be the better outcome.

Related tools

If your needs are broader (not just OFM, but the DSH host or other plugins):

• dsh-launcher — install / update / maintain dsh and plugins
• dsh-update-checker — npm/GitHub dual-source update checks
• dsh-our-free-model-installer — OFM desktop installer

---

许可 / License

MIT