v1.5.2

本次发布

1.5.2 包含三部分：主标签页与分栏归属改按本窗实际会话节点身份（v90）、ZCode 3.16.2 渲染端身份桥与自动推导，以及会话级数值恒为 0 的修复（issue #40）。变化范围为 v1.5.1 到本版。

新增

• 主标签页与分栏按本窗实际会话节点归属（v90）：渲染端桥在 SessionPane 节点写入协议版本、工作区路径/身份、远端会话与 paneId，归属不再从共享的 last-session、pane-layout 或工作台分组历史推断。其它窗口切换会话或清除记录不会改变本窗绑定；身份缺失、协议不符或与任务列表矛盾时保持隔离。
• 客户端版本自动推导：客户端版本未登记时，运行时按稳定代码结构推导渲染端桥指纹并就地补丁——唯一 styles 资产与 SessionPane 锚点、注册表/key/topic 绑定、组件参数、store 形状与 topic import 目标全部核验通过才动手。已登记版本仍按 SHA256 精确补丁，构建漂移继续拒绝。新增维护命令 python3 renderer_bridge.py derive <app.asar>，可直接输出可粘贴的指纹条目，已补过桥的安装会先还原原始模块再推导。

修复与改进

• 修复 ZCode 3.16.2 下会话级数值恒为 0（issue #40）：无桥时身份守卫此前会直接判空，导致上下文占比、本轮耗时/首字、会话累计 tokens、轮次/请求数与输出速率全部显示零值。现在本窗没有任何远端证据时按同 SID 的本地记录显示；有远端工作区/任务证据或远端绑定时仍 fail-closed，不借本地快照。
• 状态条心跳与扫描刷新提速（v90），实时性更好；渲染有幂等守卫，不重复写 DOM。
• 卸载与回滚更稳：表外版本的自动桥可按标记逐字节还原；就地写入与剥离的读取/判定全部移入跨进程锁并在发布前复核归档指纹，原子替换保留原 asar 权限。

安装与升级注意

• 本 Release 提供 zcode-token-usage-statusbar-v1.5.2.zip 与 release-manifest.json；更新渠道清单发布在同一仓库的 plugin-releases 分支，已有注册不会自动切换。
• 本版包含主进程与渲染端文件变更。安装后请完全退出 ZCode（所有窗口）再重新打开，让主进程注入与渲染端桥加载；只关窗口、刷新页面或重开会话无效。
• 客户端官方升级会整体重写 app.asar。3.16.2 已登记指纹，其它版本走自动推导；推导校验不过时降级为数据库轮询，状态条其它指标仍可用。
• 发布完成不等于本机已安装；自动更新是否可用取决于渠道清单的同步情况。

验证

• Node 回归 323 项、Python 回归 505 项（1 项按环境跳过）通过；sync_plugin.py --check 无漂移，node --check 通过。
• 真机 ZCode 3.16.2 的 app.asar 副本端到端：自动推导补丁与人工指纹补丁字节一致；二次 ensure 幂等；按标记剥离后字节还原；derive 输出与登记条目一致。
• issue #40 修复由 overlay 单元测试与主进程泵集成测试覆盖：无桥本地窗口显示本地记录，有远端证据时仍返回零值。
• 未执行 Windows 实机与多窗口断线重连验收；这些平台行为仍需实际客户端验证。

提交范围

v1.5.1...v1.5.2

v1.5.1

v1.5.1

修复与改进

• 更新进度可见：点击「立即更新」后，面板此前会一直停在「正在检查更新…」直到安装完成才变化——实际上下载和校验正在后台进行，只是没有把状态推给界面。现在新增「正在下载更新…」文案，并在设置面板加入两条进度条：下载条按实际字节数显示百分比与大小（如 "72% · 410 KB / 568 KB"），安装条按校验→安装→同步三段推进。
• 更新失败提示更友好：极少数情况下（通常是 Release 刚发布、GitHub 内容缓存还没刷新的几分钟窗口），更新会报「市场尚未发布与正式 Release 一致的校验下载源」，这是面向维护者的内部校验信息。现在改为「更新渠道尚未同步到最新 Release（GitHub 缓存可能延迟几分钟）；稍后会自动重试」，自动更新的重试间隔也从 24 小时缩短到 5 分钟，不需要用户手动干预。
• 校验规则本身没有放宽：更新仍然要求下载的包与官方 Release、渠道清单完全一致，只是把不可操作的内部报错换成了用户能理解、会自动恢复的提示。

升级注意

• 本版包含主进程文件变更，更新到 1.5.1 后请完全重启一次 ZCode 以生效。
• 进度条从下一次检测到新版本开始显示；安装本次 1.5.1 这一次更新时，旧版本的更新器还不认识新状态，不会显示进度条，属正常现象。

验证

• 新增 12 项自动化回归（下载进度推送与节流、渠道滞后重试与自动恢复时钟、中途取消更新后的状态复位、本地目录市场渠道的同类问题、下载/安装进度条渲染与多语言文案），随附随本版修复一并提交。
• 完整回归：Node 318 项、Python 487 项通过。
• 发布包经 v1.4.0、v1.4.1、v1.4.2、v1.4.3、v1.4.4、v1.4.5 及当前 v1.5.0 对应校验器解包测试全部通过。

提交范围

v1.5.0...v1.5.1

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）。

v1.4.5

本次发布

v1.4.5 汇总 v1.4.4 之后已合并的中文数字格式、主标签页远端归属路由，以及历史统计行修复。统计仍来自本地或已配置远端的 usage 数据库，不是供应商账单，也不是逐字流式 token 计数。

新增与显示改进

• 中文界面默认使用万/亿显示 token 数量：582,500 → 58.25万、1,420,000 → 142万、100,000,000 → 1亿。⚙ 的「通用」中可关闭「中文单位（万/亿）」；该开关仅中文界面显示，英文保持 K/M/B。
• K/M 格式增加 B 档，十亿及以上显示为 1.00B 等。回答末尾统计也支持万/亿，tok 改为 token，峰值速度补充 token/s 单位；数字与万/亿之间不再插入空格。
• 桌面主标签页可依据宿主工作台分组的唯一远端主绑定查询正确 SSH 服务器。同一会话有多个归属、身份不可信或与任务信息矛盾时，不猜测远端目标；迟到的错误归属载荷会被丢弃。

修复

• 完全重启后，宿主将历史轮恢复为零输出或缺少统计字段时，不再整页误报「本轮统计不可用」。tracker 窗口滑出或换代后保留已有统计文本，同时清除旧版本误插的不可用行。
• 已发出的数据库完整统计在 tracker 记录滑出或 epoch 恢复后仍能替换简化占位；同一历史轮容器重挂前后到达的正确文本缓存都可恢复，不额外查询。

安装与升级注意

• 完整升级至本版后，请完全退出并重开 ZCode，以加载本版主进程路由和统计单位参数；仅关闭窗口或刷新页面不能保证主进程更新。浮层本身可热更新。
• 没有有效统计、保留文本或当前浮层缓存的历史轮仍不会补造数据；本版没有持久化历史统计或按时间窗口回填。消息正文中原有的旧统计行不受影响。
• 远端查询脚本仍需手工部署，通道须免交互；本版不会自动登录、解密凭据、部署脚本或替宿主重连 SSH。远端支持限桌面 JSON 状态条链，MCP、/usage 和回答末尾速率不自动跨机。
• Release 提供 ZIP 与 release-manifest.json 两个资产。维护流程会单独发布同仓库 plugin-releases 的一致 ZIP/hash 渠道清单；已有市场来源不会自动迁移。发布完成不代表您的本机插件已安装或更新。

验证与边界

• Node 全量回归 299/299 通过；Python 共 473 项，472 通过、1 项 Windows 过滤驱动 ctime 专用测试在 macOS 跳过。
• 新增回归先复现失败再验证修复，覆盖迟到完整统计、历史显式零值及容器重挂的两种响应顺序；独立 review 找到的问题均已修复，最后复审未发现新增问题。
• JavaScript/Web 语法、插件副本一致性、发布包安全解包与文件集校验均纳入发布检查。隔离测试不等于新增 Windows 或 Web 端到端实机验收；本次不覆盖个人安装缓存，也不自动重启客户端。

提交范围

v1.4.4…v1.4.5。主要功能与修复来自 PR #31 和 #32。

v1.4.4

本次发布

v1.4.4：基于 v1.4.3 之后的已合并变更（PR #12–#24、#26–#28），核心是状态条接入 renderer 实时会话事件流的事件驱动统计架构，以及远程工作区路由与一批平台兼容修复。

新增

• 事件驱动统计架构：状态条接入 renderer 实时会话事件流（turn-stats.js 只读投影随主进程注入），统计随会话实时更新，不再只依赖数据库落库轮询；逐问统计行的历史行锚点适配新版客户端的嵌套会话结构。
• 远程工作区支持：按工作区身份的 scoped routing 与弹性轮询，多服务器会话的路由与恢复更稳（配置与排查见用户指南「远程会话」）。
• ⚙ 设置面板新增「反馈问题」按钮，用系统默认浏览器打开项目 issues。

修复与改进

• Claude 系列模型不上报思考 token 时按含思考的时间段计时，修正生成速度虚高。
• 逐问速率统计指令携带会话 id，防止并行会话间歇串台。
• 状态条速度样本缺首字时间时向前查找最近有效请求，不再用总耗时硬算出偏低的假速度。
• Release 渠道安装误报「用户插件未注册」：官方 CLI list 的两种真实输出形状已归一化。
• Linux /opt 安装兼容 sudo 重置的 HOME/PATH；未注入时 remove 不再要求 root。
• standalone 安装在自定义安装路径下 finalize 指向错误目标的问题。
• Windows 默认区域编码、无符号链接特权与粗时间戳卷下的健壮性与测试确定性。
• 插件 hooks、命令与元数据对齐 ZCode 宿主契约；市场条目恢复 description_i18n 本地化。
• 运行时同步在稳态下跳过 node 验收以减少开销；库结构漂移时给出可行动的提示。

安装与升级注意

• 资产：zcode-token-usage-statusbar-v1.4.4.zip 与 release-manifest.json；manifest 内 SHA256 用于下载完整性校验（非独立签名）。
• 事件流统计由主进程向窗口注入实现，更新插件并完全退出重开 ZCode 后生效；修改 app.asar 的 renderer 桥接属于仓库内验收工具，不在正式安装链上。
• 插件显示名已更名「速度状态栏」，slug 与安装命令不变；新用户市场来源 ByteRax/zcode-token-usage-statusbar#plugin-releases，已注册其它 ref 的用户不会自动迁移。
• Release 发布不等于客户端已安装，安装状态以本机为准。

验证

• 本地全量测试通过：Python 470 项（unittest，其中 1 项 Windows 过滤驱动回归在 macOS 按设计跳过）与全部 Node 测试组。
• renderer 桥实机回归 9 项通过（含真实宿主归档 roundtrip 与 VM 契约）；本次附带修复其实机用例以兼容已注入过补丁的宿主归档。
• 发布包经 release_tool.py build 白名单构建并通过 verify：双 manifest 与市场条目版本一致（1.4.4）、ZIP 白名单文件集、SHA256 与字节数核对通过。

提交范围

• 比较：v1.4.3...v1.4.4（v1.4.3...v1.4.4）

v1.4.3

本次发布

v1.4.3 是修复版本，包含 v1.4.2 之后合入的 PR #9 和 #10，主要修复 Windows 上安装、收尾和统计的问题，并加固运行时同步验收。状态条界面和注入入口（overlay.js、inject-main.cjs）没有改动。

修复与改进

• Windows 上安装失败：在部分 Windows 环境（NTFS 加杀毒软件过滤驱动）下，按路径和按文件句柄读到的同一文件的创建时间（ctime）不一致，安装流程会报 file changed before hashing 并失败。现在 Windows 的文件指纹不再比较 ctime，macOS 和 Linux 不变。从 1.4.2 升级时，还没收尾的待替换包仍能继续收尾或重新安装。
• 自定义安装位置探测：ZCode 装在 D:\Program Files\ZCode、<盘符>:\ZCode 这类位置时，现在能自动找到。只扫描本地固定盘，网络盘和可移动盘不扫描，装在那里请设置 ZCODE_ASAR。每个候选都会先确认确实是 ZCode，结构异常的 app.asar 直接跳过，不再报错退出。
• Windows 安装收尾更及时：客户端运行时安装，收尾监控现在等待 ZCode 进程退出事件，ZCode 一退出就完成 app.asar 替换，不会再因为“退出后马上重开”而错过替换时机。从 agent 或工具会话里安装时，监控进程会尽量脱离会话的作业对象（Job），不再随会话结束被一起关掉。
• 逐问速率行（⚡）间歇丢失：--current 守卫对提问时刻加了 3 秒容差，修复部分环境下速率行时有时无的问题。Windows 上状态文件被其它进程短暂占用时会重试写入，避免丢失提问时刻。
• 运行时同步验收：
  • app.asar 旁边的可执行文件无法启动或卡住不退出时，改用 PATH 中的 node 完成验收；同一次同步里，失败的候选只尝试一次。
  • 超时后会结束整个进程树，不会再一直等待。
  • 验收输出和语法检查报错改按 UTF-8 读取。修复了中文 Windows 上插件路径含中文（例如中文用户名）时验收失败或报错的问题。
• 发布包可复现：发布包与源码提交逐字节一致，仓库统一使用 LF 行尾，同一版本在不同平台上构建出的包完全相同。

安装与升级注意

• 资产：zcode-token-usage-statusbar-v1.4.3.zip 和 release-manifest.json。manifest 里的 SHA256 只用于校验下载完整性，不是独立的数字签名。
• 本版没有改动状态条界面和注入入口，升级后不需要重新注入 app.asar。安装和统计脚本会在插件更新后的下一次会话启动时同步到运行时目录。
• 更新渠道是 ByteRax/zcode-token-usage-statusbar#plugin-releases，本 Release 验收后会更新到 1.4.3。在其它 ref 注册市场的用户不会自动迁移。Release 发布不代表客户端已安装新版本，以本机实际安装状态为准。

验证

• 在本地（macOS）跑了全量测试：Python 349 项通过（1 项因平台跳过），Node 185 项通过。其中包括本版新增的回归用例：旧版待替换包的收尾和重装、CRLF 检出拦截、句柄等待、固定盘过滤、验收器卡住时的回退和进程树结束、UTF-8 解码等。
• Windows 专有逻辑（句柄等待、固定盘判断、taskkill、ctime 指纹）只在 macOS 上用模拟和跨平台用例覆盖。ec170ac 中的指纹、盘符探测和事件驱动等待曾在 Windows 实机测过，之后的复审修复还没有在 Windows 实机上验收。
• 发布包用 release_tool.py build 按白名单构建，并通过了 verify：两份 manifest 和市场条目的版本一致（都是 1.4.3），SHA256 和字节数核对一致。

提交范围

• 比较：v1.4.2...v1.4.3（v1.4.2...v1.4.3）

v1.4.2

本次发布

v1.4.2：基于 v1.4.1 之后的已合并变更（PR #6、#7 与文档更名 PR #4、#5），聚焦状态条设置面板与上下文圆环的界面重做，以及悬浮状态条默认自动安装。

新增

• 状态条 ⚙ 设置面板卡片化重构：选项按分区组织为独立卡片，面板内容区独立滚动，并新增关闭按钮；悬停 ⚙ 可查看面板与内部版本号（v68）。
• 上下文占用显示由微进度条改为 SVG 圆环，随提交渲染进度更准确。
• 悬浮状态条默认自动安装：缺配置文件或缺 plugin_auto_install_overlay 字段时视为开启，插件会话启动时自动安装/修复状态条（会修改客户端 app.asar，成功后需完全退出并重开 ZCode）。

修复与改进

• 自动安装开关的安全边界：显式写 "plugin_auto_install_overlay": false 的用户保持关闭不受影响；环境变量 ZUSAGE_PLUGIN_AUTO_INSTALL=1/0 优先于配置文件；配置损坏或字段不是布尔值时不自动安装。
• 未安装时的启动提示与 /zcode-token-usage-statusbar:install-overlay 兜底路径文案更新；/zcode-token-usage-statusbar:uninstall-overlay 的卸载豁免仍阻止重新注入。
• 文档统一安装/卸载命令为 install-overlay / uninstall-overlay 短名。

安装与升级注意

• 资产：zcode-token-usage-statusbar-v1.4.2.zip 与 release-manifest.json；manifest 内 SHA256 用于下载完整性校验（非独立签名）。
• 自动安装/修复与手动 install-overlay 都会修改客户端 app.asar，安装或升级成功后需完全退出 ZCode（所有窗口）并重新打开。
• 从旧版升级且配置中从未写过 plugin_auto_install_overlay 的用户，升级后自动安装默认变为开启；不需要时显式写 false 即可。
• 更新渠道清单发布于 ByteRax/zcode-token-usage-statusbar#plugin-releases；已在其它 ref 注册市场的用户不会自动迁移。Release 发布不等于客户端已安装，安装状态以本机为准。

验证

• 本地全量测试通过：Python 325 项（unittest）与 Node 11 组测试，其中含本次新增的上下文圆环、设置面板、子面板 3 组覆盖（tests/overlay-context-ring.test.cjs、overlay-settings.test.cjs、overlay-subpanel.test.cjs）。
• 发布包经 release_tool.py build 白名单构建并通过 verify：双 manifest 与市场条目版本一致（1.4.2）、ZIP 无绝对路径/符号链接/用户数据、SHA256 与字节数核对通过。

提交范围

• 比较：v1.4.1...v1.4.2（v1.4.1...v1.4.2）

v1.4.1

v1.4.1 · 首次安装引导与重启提醒修复

这是相对 v1.4.0 的兼容性修复版本。发布源码提交为 f9d40ec，重点解决市场安装后用户反复重启仍看不到状态条的问题。

修复与改进

• 不再把“尚未安装”误报成“需要重启”：先检查客户端是否已有状态条。未安装时明确引导 /zcode-token-usage-statusbar:install-overlay；只有安装或更新完成、等待客户端重新加载时才提醒完全退出并重开。同步失败、损坏记录和无法定位客户端也按实际状态处理。
• 首次引导不再永久静默：未安装时，每次新建、清空或恢复会话都会重新提示，同时通过模型可见上下文提高触达率。旧的一次性提示标记不再阻止提醒；运行 /zcode-token-usage-statusbar:uninstall-overlay 后，启动和每轮提醒均停止，包括同步异常时的用户提示。
• 普通用户能看懂的醒目提醒：明确标注“zcode-token-usage-statusbar 插件提醒”，解释窗口底部的用量状态条，并提示从 ZCode 菜单选择“退出”。提示整条加粗并保留红色圆点；状态条已加载时正文显示为红色加粗，不影响普通引用、用户粘贴和 Markdown 预览。
• 修复安装与确认时序：两个提示通道及手动安装输出共用同一状态判断。安装意图和实际替换使用共享锁及发布时间边界，避免提前确认尚未发布的入口，也不复活已经确认的提醒。运行中文件占用、监控延迟收尾及收尾期间冷文件同步均有组合回归；部分文件尚未加载时继续保留提醒。
• 文档与发布可靠性：补充默认安装策略、自动安装开关、正式渠道安装说明及中英文引导；发布工具要求实质更新说明，对说明、ZIP 和 manifest 使用独立快照，上传后下载核对正文与资产字节，避免校验后原文件被替换。

安装与升级注意

• 插件仍默认不自动安装状态条，不会因为更新插件而默认修改客户端文件。需要状态条时运行 /zcode-token-usage-statusbar:install-overlay；如需自动安装/修复，在 ~/.zcode/zcode-token-usage-statusbar/config.json 中合并 "plugin_auto_install_overlay": true，或设置 ZUSAGE_PLUGIN_AUTO_INSTALL=1，保留其它设置。
• 本版涉及安装确认及锁机制。已有用户完成插件升级后请重开会话，并在提示时完全退出再重新打开 ZCode。尚未安装状态条时必须先完成安装，单纯重启无效。插件不会自行退出或重启客户端。
• 首次尚未加载状态条时，ZCode 会过滤 HTML 颜色样式，提示正文只能加粗并显示红色圆点；加载新版状态条后正文可变红。这不是宿主原生通知或渲染器修改。
• 正式资产为 zcode-token-usage-statusbar-v1.4.1.zip 和 release-manifest.json，不包含个人配置、用量数据、缓存或发布技能。SHA256 用于下载完整性校验，不是独立安全签名。市场升级要求 plugin-releases 清单与本 Release 的 ZIP/hash 一致；渠道清单在 Release 验收后单独更新，发布完成不等于本机插件已经安装。已有市场注册不会自动迁移。

验证

• 最终完整回归：321 项 Python 测试、164 项 Node 测试全部通过；另通过 37 个 Python 文件的 Python 3.8 语法检查、21 个 JavaScript 文件语法检查、插件副本一致性及差异格式检查。
• 已执行 macOS 官方 CLI 沙箱安装与升级闭环，不访问真实插件库存或修改真实 app.asar。真实监控子进程夹具覆盖占用延迟收尾、默认参数 install/remove、同步交错和部分/完整加载确认。Windows 分支夹具覆盖不等于 Windows 实机验收。
• 使用当前客户端真实渲染结构的浏览器夹具验收：助手提醒计算颜色为 rgb(239, 68, 68)、字重 700；用户文字、普通引用和 Markdown 预览保持原样。本次没有安装到维护者真实客户端。

提交范围

查看 v1.4.0...v1.4.1 的完整差异。范围包含正式渠道/中英文文档整理以及本次安装提醒、确认和发布工具修复；重复合并与纯格式调整未逐条列入。

v1.4.0

v1.4.0 · 首个正式 Release

这是 ByteRax 仓库的首个正式 Release；此前的 screenshots-* 标签仅用于截图托管。以下说明最近集成范围 7e35a6f..v1.4.0 的变化，不是相对某个历史正式版本的升级差异。发布提交为 ccab49e。

新增

• 插件市场安装与对话内查询：提供 token_usage MCP 工具、/usage 命令和查询技能，只读本地用量数据库，不上传用量数据。安装插件默认不会自动安装悬浮状态条；需要浮层时，可执行 /zcode-token-usage-statusbar:install-overlay，重启客户端后生效。
• 逐问速率行：默认开启，在回答末尾展示本问 tok/s、首字延迟、输出 token、生成耗时、多段峰值与会话累计；支持设置面板开关，下一问生效，无需重启。未装浮层时可在运行时配置中设置 answer_rate_line: false。仅使用本问已入库的数据，避免把上一问结果当成本问；输出已包含思考 token，不重复累加。浮层 tooltip 可查看统计口径。
• 插件更新入口：设置面板提供检查更新、立即更新和自动更新。自动更新默认开启，按 24 小时限频，并保留已有明确关闭的选择。GitHub 来源只接受正式 Release，排除草稿、预发布和截图标签；下载核对来源、版本、manifest、ZIP、SHA256，并安全解包。安装要求市场清单指向同一 ZIP/hash。本地目录市场只读取本地文件，不执行 git pull。

修复与改进

• 状态条布局与字体：宽度自适应对齐会话卡片，条目均匀分布，设置按钮保持靠右；字体与字号跟随客户端设置。窄屏下分级收缩次要信息，极限宽度采用右缘渐隐，避免撑出卡片。
• 悬浮气泡兼容：修复悬停统计项时，非模态气泡遮挡输入区导致状态条误消失的问题。
• 运行时更新可靠性：使用跨进程锁协调更新和同步，降低并发覆盖与旧会话回滚风险；保护本地手改热修，增强部分同步失败恢复、配置写入安全和相同时间戳的内容变化检测。
• 重启与安装收尾安全：持久保存重启需求，按实际加载的文件指纹确认；待替换 app.asar 核对来源与临时文件身份，占用时重试，避免旧临时包覆盖客户端新版或激活未通过语法检查的包。

安装与升级注意

• 发布资产为 zcode-token-usage-statusbar-v1.4.0.zip 和 release-manifest.json。两份插件清单和市场版本统一为 1.4.0；白名单打包不包含用户配置、用量数据、凭据或缓存。SHA256 用于下载完整性校验，不是独立安全签名。
• 本次涉及主进程及锁机制变化，已有用户完成升级后请完全退出并重新启动 ZCode 一次，并重开会话。插件不会自行重启客户端；自动更新与自动恢复浮层是不同开关，后者默认关闭。
• 截至本说明发布，plugin-releases 渠道尚未推送，自动升级渠道尚未就绪。 渠道清单不一致时安装会安全停止；已有市场注册不会自动迁移。Release 已发布不等于用户客户端已安装。

验证

• 发布前通过 157 项 Node 测试、270 项 Python 测试，以及插件副本同步和 37 个 Python / 22 个 JavaScript 文件语法检查。
• 双资产上传后已下载逐字节核验。Windows 收尾与文件占用分支有临时夹具回归，不等同于 Windows 实机验收。

提交范围

查看本次集成差异：7e35a6f..v1.4.0。主要功能与修复来自 0a83656、037e7fb、4ee6be3、bbfa0af、b44a694 和 8f20c6c；重复合并与纯格式清理未逐条列入。

v67 逐问速率行 PR 配图（截图托管，非代码发布）

PR 配图托管（user-attachments 端点 token 过不了 CSRF，走 release assets）