v0.5.2

新功能

• 外观中心新增 Canvas 总开关：面板右上角的「关 / 开」，等同于 zcode-canvas set enabled false / true。关掉后所有窗口立即恢复 ZCode 原样，主题、壁纸、桌宠等设置全部保留，点「开」即原样恢复。

说明

• npm 上的 0.5.1 tarball 已提前包含本功能（发布时该提交已合入 main）。0.5.2 与 npm 0.5.1 代码一致，本次发布用于对齐版本号与 git tag。

升级

npm install -g zcode-canvas@latest
zcode-canvas apply

v0.5.1

修复

• 毛玻璃主题下，打开设置时不再透出侧栏里的插件页面：从 ZCode 3.15 起，侧栏里打开的插件页面挂在页面最外层，打开设置时 ZCode 只隐藏了工作区，没隐藏这一层，半透明的设置页后面就能看到插件页面。现在设置打开期间它会被一并隐藏。

兼容性

• 已在 ZCode 3.15.3（Electron 41）上验证。

升级

npm install -g zcode-canvas@latest
zcode-canvas apply

v0.5.0

新功能

• 桌宠桌面模式支持 macOS：外观中心「桌宠」里的「桌面模式」在 macOS 上也能打开了（或运行 zcode-canvas set pet.desktop true）。她住在一个不抢焦点的浮动面板里，在每个桌面空间（Space）都在，也浮在全屏 app 上面；ZCode 最小化、隐藏或被挡住时照样看得到她，「等你回应」照常提醒，关掉最后一个 ZCode 窗口时她跟着消失。截图和录屏里同样看不到她。Linux 上仍不提供（Wayland 下应用不能自己摆放和置顶窗口）。

修复

• macOS 上在 ZCode 自带的终端里（或由 ZCode 里的 agent）运行 zcode-canvas status，不再误报「ZCode 运行中：否」；zcode-canvas open 也因此能正确打开外观中心，而不是打开访达。
• 从源码 npm link 安装时，重新构建后 zcode-canvas 命令不再报 permission denied。

开发

• 新增 scripts/sandbox-mac.mjs：在 macOS 上启动一份与正在用的 ZCode 完全隔离的副本（配置、数据和单实例锁都分开），用来测试 Canvas。
• 测试在 macOS 上全部能跑通。

升级

npm install -g zcode-canvas@latest
zcode-canvas apply

运行时是在 apply 时装进用户目录的，升级后需要重新 apply 一次，并彻底退出（Windows 从托盘退出、macOS 用 Cmd+Q）再打开 ZCode 才会生效。已在 ZCode 3.14.4 上验证。

v0.4.0

新功能

• 桌宠桌面模式（Windows）：打开外观中心「桌宠」里的「桌面模式」，或运行 zcode-canvas set pet.desktop true，窗口里的狐娘会收起，换成全局一只，住在 Canvas 自己的透明小窗里，始终在最上层——ZCode 最小化、缩到托盘、被别的窗口挡住时都看得到她，「等你回应」也照常提醒。可以拖到屏幕任意位置，靠近屏幕边缘会吸附，靠左时转身；位置按离屏幕边缘的距离保存，换分辨率、拔掉显示器后她会回到同一个角落。只有她身上不透明的地方能点，周围透明的地方点击直接落到下面的窗口。默认关闭。
  • 她不会出现在截图、录屏和屏幕共享里：ZCode 让 AI 操作电脑时会先截屏再按坐标点击，她不能挡住目标、截走点击。代价是你也截不到她。
  • 多一个页面进程（约 26 MB 内存，动画时约 1% CPU），随最后一个 ZCode 窗口关闭而销毁，不影响 ZCode 退出和官方更新。
  • 目前只在 Windows 上提供：Linux 在 Wayland 下应用不能自己摆放窗口，也做不到「透明处穿透、不透明处可点」；macOS 尚未验证。这两个平台上开关不可用，并就近说明原因。

文档

• README 桌宠章节新增「桌面模式」；设计文档补上桌面模式窗口的边界，以及它依赖的 ZCode 内部实现（按 BrowserWindow 挑窗口、靠 window-all-closed 退出、遥测脚本注入所有页面）。

升级

npm install -g zcode-canvas@latest
zcode-canvas apply

运行时是在 apply 时装进用户目录的，升级后需要重新 apply 一次，并从托盘彻底退出、重新打开 ZCode 才会生效。已在 ZCode 3.14.4 上验证。

v0.3.0

新功能

• 桌宠：一只住在 ZCode 窗口角落的狐娘，看一眼就知道 AI 在干什么——思考、干活、等你回应、完成、出错各有各的表情和动作。点她会 Q 弹一下、发出声音、说一句台词；拖到窗口边缘附近会吸附，靠左时自动转身；图片透明的地方不挡鼠标。默认关闭，在外观中心的「桌宠」里打开，或运行 zcode-canvas pet on；大小、音效、音量和「说话」开关都能调。状态来自 ZCode 自己的事件日志和卡片通知，Canvas 在主进程里只读旁听，不开端口、不起进程。形象、气泡、台词和音效来自 zcode-fox-widget（MIT），详见 NOTICE.md。
• 分区玻璃控件高亮：调节侧栏、主区域、卡片、输入框的透明度或模糊时，ZCode 里对应的区域会描一圈强调色内描边，松手约 1 秒后消失——正在调哪个区域一目了然。

修复

• Windows 上 ZCode 正在运行时升级，运行时目录的重命名如果被占用，改为短暂重试后直接复制，任何情况下不会再出现运行时目录缺失。
• 玻璃主题下，编程套餐购买页保持不透明，不再透出底下的界面。

文档

• README 新增桌宠章节；升级步骤补上 Canvas 本身的重新 apply；标注已在 ZCode 3.14.4 上验证。

升级

npm install -g zcode-canvas@latest
zcode-canvas apply

运行时是在 apply 时装进用户目录的，升级后需要重新 apply 一次才会生效；桌宠素材（pets/）也随这次 apply 一并部署。

v0.2.0

新功能

• 保存为主题：外观中心有个人修改时，底部会出现保存条，可以「另存为」新主题、「保存」写回当前用户主题，或「丢弃」回到主题原样。zcode-canvas new <id> 走同一套保存逻辑，图片会一并复制进主题文件夹。
• 新主题 尼尔 · 寄叶 yorha：仿 NieR:Automata 的系统设置界面，亮暗两套，带游戏开机画面。非官方同人作品，寄叶徽标不属于 MIT 许可，见 NOTICE.md。
• macOS：apply 重签名后会自检签名，并清掉残留的 quarantine 标记。

修复

• macOS 上 status 不再把其他位置的 ZCode 副本误报为「正在运行」。
• 面板写入配置和文件监视不再各触发一次刷新。
• 启动画面 animation: none 不再被拖到 1 秒兜底；fade 在系统开启「减少动画」时让位。
• 命令行导入壁纸改走面板同一套存储校验；滑杆位置读取、对比度计算与面板保持一致。

文档

• README 改版：新首图、演示前置、外观中心按「挑 · 调 · 留」分组、新增「做一个自己的主题」。

升级

npm install -g zcode-canvas@latest
zcode-canvas apply

运行时是在 apply 时装进用户目录的，升级后需要重新 apply 一次才会生效。

v0.1.0 mac test build

macOS 真机测试用临时构建，非正式发布。测试步骤见 docs/mac-test-plan.md。