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 的完整差异。范围包含正式渠道/中英文文档整理以及本次安装提醒、确认和发布工具修复；重复合并与纯格式调整未逐条列入。