v1.5.0

v1.5.0

本 Release 为重新发布（2026-10-19）：首发的 v1.5.0 资产存在升级链缺陷——1.4.0–1.4.5 的已安装用户自动更新时报 release_unpack: ZIP is missing required release files，无法升级。本次替换的资产已修复该问题并并入随后合入的几项状态条修复；资产 SHA256 与首发不同，更新渠道清单已同步。

新增

• renderer 桥随插件安装/更新自动恢复：ZCode 官方客户端升级会整体重写 app.asar，把实时统计（悬浮条思考/生成/工具速度、逐问实时行）依赖的只读桥一并抹掉，此前每次升级都需要手工重新补丁。本版起，桥补丁并入插件自身的安装与更新链——客户端升级后的首轮 SessionStart 会自动重装注入并按指纹重打桥，实时统计自动恢复，无需任何手工操作。
• 多版本指纹表：桥按客户端版本逐版本钉死（资产名 / SHA256 / 混淆标识符），当前登记 3.15.3 与 3.16.1。未登记的新版本会安全跳过（悬浮条自动降级为数据库轮询路径，不报错），在新版本指纹随插件更新登记后自动恢复。

修复与改进

• 升级失败修复（本次重发的原因）：v1.4.4 起发布包新增了运行文件但未在插件清单声明 packageLayout，而旧版本自带的升级校验在无声明时要求包内文件集与本机旧清单精确相等，导致 1.4.0–1.4.5 升级 1.5.0 全部失败（1.4.3 → 1.4.4 当时同样受影响）。现发布包已声明完整文件清单，历史版本校验器可直接放行；发布工具同时新增一致性校验，今后包内文件增删而未同步清单会在构建时直接报错。已用 v1.4.0–v1.5.0 全部七个历史版本的校验器对本包逐一实测通过。
• tooltip 口径：状态条 tooltip 中「本轮输出速度」按本轮各有效段加权（Σ输出/Σ生成耗时），速度样本与其起止时间绑定；会话累计、今日合计、本轮、最近一段四格的时间范围统一为「首个请求开始 − 最后请求完成」口径。
• 主标签页远端路由回退（issue #30 复测）：单会话主标签页不是工作台分组，此前拿不到归属证据只能维持本地。现在分组零证据时回退宿主 last-session 记录，主会话恰好只被一个远端工作区记录时自动路由；出现第二个不同归属仍按歧义处理，维持本地查询。
• 状态条刷新 2s → 0.5s：运行态计时与扫描刷新间隔缩短到 0.5 秒，速度/耗时读数更跟手；富文本重试次数等价放大保持原有等待上限。
• 实时状态补强：子智能体运行期间悬浮条显示「正在运行子智能体」；新会话绑定后、轮次数据到达前的空窗口显示「思考中…」；历史统计行在虚拟列表重挂/热更新后从缓存重建完整富文本，不再退化为占位文案。
• 卸载对称清理：卸载插件时同步剥离注入的只读桥，只移除本项目内容，不动第三方注入。

升级注意

• 卡在 1.4.x 的用户：插件自动更新重试即可直接升到本版，无需卸载重装。
• 已安装用户：更新到 1.5.0 后，如客户端在 3.15.x/3.16.1 且 asar 中桥缺失，下次会话启动（SessionStart）即自动补齐；悬浮条实时功能恢复需要客户端完全重启一次。
• 客户端升级到未登记版本时，实时统计自动降级为数据库路径（功能不报错），等待插件后续版本登记指纹后恢复。
• Windows 实机验收未执行，安装/恢复链在 macOS 实测通过；Windows 行为由共享代码路径与隔离测试覆盖。
• release-manifest.json 用于下载完整性（SHA256）校验，与 ZIP 一同发布，不需要单独安装。

验证

• 自动回归全绿：Node 306 项、Python 487 项（含桥生命周期 / 未知版本拒绝 / 指纹漂移拒绝，以及本次新增的清单漂移拒绝与历史校验器兼容两组回归）。
• 升级链：v1.4.0、v1.4.1、v1.4.2、v1.4.3、v1.4.4、v1.4.5 及首发 v1.5.0 各版本校验器对本包实测解包校验全部通过。
• 真实客户端实测：ensure_deployed 对 3.16.1 线上 asar 正确识别 present；隔离副本客户端中桥 API 加载与注册表枚举验证通过；重启后渲染进程桥绑定 bound=true、事件流推进正常。
• 远端路由、tooltip 口径与刷新间隔为夹具回归覆盖；实机多窗口/SSH 场景以既有验收为准。

提交范围

v1.4.5..v1.5.0（源码 PR #34 桥自动恢复、#35 tooltip 口径、#36 刷新 0.5s、#37 升级链修复；主标签页回退 555b48e；合并提交 1bb2a45）。