Repository navigation
iRouter v0.4.0
iRouter v0.4.0 发版说明 (Release Notes)
English Version | GitHub Release 页面
iRouter 是基于 decolua/9router 深度定制的跨平台大模型路由网关桌面客户端。
v0.4.0 是桌面壳层的换代版本:把笨重的 Electron 壳换成 Tauri v2(Rust)+ Bun sidecar,
macOS 安装包从 139.65 MiB 降到 46.5 MiB(−66.6%),功能全数保留,含应用内更新。
网关源码零改动,仍与上游保持 merge 血缘。
🎯 本版本的核心变化:换壳
1. 壳层:Electron → Tauri v2(Rust)
原来的壳是 Electron——它自带一整套 Chromium(仅 Electron Framework 二进制就 192 MiB)。
新壳用 Tauri v2:渲染交给系统 webview(macOS 的 WKWebView、Windows 的 WebView2、Linux 的 WebKitGTK),
壳本体变成一个几 MiB 的 Rust 二进制。
2. 网关运行时:Electron 内置 Node → 随包分发的 Bun
原方案复用 Electron 自带的 Node 跑网关。新方案把 Bun 作为 sidecar 随包分发,哈希锁定在仓库内
(tools/bun-pin.json,五平台)。这是体积账的关键一步:选 Node SEA 的话,同样的换壳只能到约 79 MB——
会越过我们给自己定的 70 MB 线。
3. 体积对比(实测,非估算)
| Electron(v0.3.7) | Tauri + Bun(v0.4.0) | |
|---|---|---|
| macOS (Apple Silicon) dmg | 139.65 MiB | 46.5 MiB |
| 安装后体积 | ~324 MiB | ~150–180 MiB 量级 |
✅ 功能对齐(一个不落)
换壳不等于砍功能。以下全部在新壳上重新实现并通过验证:
- 窗口与面板:启动后等待网关就绪再显示,避免白屏;面板守卫令牌防浏览器直连
- 系统托盘:左键唤出、右键菜单、双击、tooltip、模板图随菜单栏深浅色自动反色
- 原生菜单:macOS 应用菜单(含 Edit,Cmd+C/V/X/A 依赖它)、帮助菜单
- 关闭行为:
closeAction三档(quit / dock / tray)与设置面板联动 - 开机自启:与系统实际状态双向同步
- 单实例:第二次启动唤出已有窗口,不重复起网关
- 应用内更新:检查 / 下载(带进度与取消)/ 校验 / 调起安装器,与 0.3.x 完全同一套行为
- 原生对话框:「检查更新」的结果与失败提示
- 多语言:菜单与对话框的 en / zh-CN / zh-TW
关于孤儿进程(换壳时最容易出事的地方)
网关是 shell 的子进程,壳死了网关不能活着——否则它会一直占着 127.0.0.1:20128。
新壳管理三条死亡路径,均有真机实测记录:
| 路径 | 行为 |
|---|---|
| 正常退出(托盘「退出」/ 菜单退出) | 按进程树回收网关,清理 PID 文件 |
收到 SIGTERM / SIGINT |
走同一条回收路径(对齐 Electron 版的信号处理) |
| 关窗到托盘(dock 档) | 网关继续服务,符合预期 |
| 上次异常退出留下的孤儿 | 下次启动时按 PID 文件回收,不会永久占用端口 |
📦 升级方式
如果你是 0.3.x 用户:直接在应用内检查更新即可,无需手动下载。
新版本的资产命名与 0.3.x 逐字保持一致(iRouter-<版本>-<平台>-<架构>.<扩展名>),
这是刻意保证的——老版本的自动更新靠字符串全等匹配资产名,改名会切断所有老用户的更新通道。
仓库里有三层断言守着这条规则。
升级后你会换成一个全新的应用(壳换了),首次打开时 macOS 可能要求你确认一次(因签名方式)。
⚠️ 已知限制
- 首次打开的系统提示:安装包使用 ad-hoc 签名(未购买开发者证书)。macOS 上首次打开需
右键「打开」或到「系统设置 → 隐私与安全性」放行一次。 - Windows / Linux 未做真机验收:CI 每轮四平台构建并做包内冒烟(验证 sidecar 在包里、
网关负载在包里、最低系统版本正确),但没有"装上去跑一遍"。macOS 的真机验收抓到了一个
CI 永远抓不到的缺陷(托盘图标显示为白板),因此其他平台若有类似问题,欢迎反馈。 - macOS 最低版本 13.0:这是随包分发的 Bun 二进制本身的要求,非本项目的选择。
- Linux 的
.deb会声明webkit2gtk依赖(系统 webview,Tauri 的必需依赖)。
📥 安装包下载与校验 (Downloads & Verification)
完整 SHA-256 列表见本 Release 的附件
checksums.txt,
与本说明表格中的校验和同源(均由打包流水线在改名/归档之后对最终产物计算)。
本表数字取自 v0.4.0 的真实发布产物(2026-10-09 构建),与上面的checksums.txt同源。
| OS / Arch | File | Size | SHA-256 |
|---|---|---|---|
| macOS (Apple Silicon) | iRouter-0.4.0-macos-arm64.dmg |
46.55 MiB | 9ba79090953109c0c73dcf3575da8df10c6000c530ad508b46c222a54e629ec9 |
| macOS (Intel) | iRouter-0.4.0-macos-amd64.dmg |
49.67 MiB | 500998674a74a8491b38c1d84abf6287b2bd657602ac84e8b128bd860b4db1db |
| Windows (x64) 安装版 | iRouter-0.4.0-windows-amd64-installer.exe |
41.22 MiB | d7b593e84c0d314ef486038808ca54c52e0f589eb3685625fb5af10ca2804f5d |
| Windows (x64) 便携版 | iRouter-0.4.0-windows-amd64-portable.zip |
67.80 MiB | 4c5e0751c41f260ed5fae7ea4533cb9e8c8468476285007434dfa7b46760ad4d |
| Linux (x64) deb | iRouter-0.4.0-linux-amd64.deb |
58.08 MiB | dd7e2e771bc77ef3321fbe3bc36e95c5b6297facd9f78d5eb39154ff8bb32f82 |
| Linux (x64) tar.gz | iRouter-0.4.0-linux-amd64.tar.gz |
57.35 MiB | 25a39d3acf4b914fdacce248a31fcfdff18c89091e0a74cf62dc20eaa9c85165 |
🔧 技术细节(给想深挖的人)
- 决策记录:ADR-0007
(换壳决策)、ADR-0001(已标 superseded,附事实更正)、ADR-0004(版本号解耦,真源随本次迁移挪到desktop-tauri/package.json) - 迁移全过程:docs/plans/2026-10-07-tauri-bun-migration.md
—— 含体积预算表、Phase 0–6 的每步验证方式、真实死亡路径表、风险与回退 - 仓库结构:
desktop-tauri/(壳)、tools/(承重构建输入:网关负载构建、Bun pin/校验、产物命名真源)、
build/(负载产出)。原desktop/(Electron 壳)已删除 - 自动化接缝:
npm run verify:guard/verify:shell/verify:updater-shim三条可复跑门禁,
均做过负向验证(故意改坏断言确认真的会红)