Skip to content

v1.4.2

Choose a tag to compare

View all tags
@ByteRax ByteRax released this 14 Oct 15:53
v1.4.2
5c48b46

本次发布

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 与字节数核对通过。

提交范围

Assets 4
Loading