Release v1.4.0 · ByteRax/zcode-token-usage-statusbar

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；重复合并与纯格式清理未逐条列入。