v0.13.0

✨ 新增

• 新增 ZCode 3.14 模型信息自动迁移：ZCode 升级到 3.14 时自带的迁移只搬运了模型的上下文窗口（limit.context → properties.contextWindow），模型原有的输出上限、模态、推理档位全部没跟着搬，表现为「升级后原来导入的模型信息都不见了」（旧 config.json 里这些数据仍在，只是新配置里为空）。现从旧 config.json 自动回填缺失字段，只补缺不覆盖、幂等可重复执行：应用启动时后台自动跑一次，模型管理页进入时再核对一次，有回填时页面顶部给出横幅汇总（供应商 / 模型 / 字段数），也可点「重新检查」手动重跑。

迁移安全性

• 只在该字段确实为空时才写入，ZCode 自己写入的字段（optionSpecs.reasoningLevel.map 等请求体映射）原样保留。
• 纯文本模型不写 inputFormat，避免覆盖 ZCode 内置更准确的模态声明。
• 手动配置的模型规则原地补齐，不会被挪进智能规则表（两表在 ZCode 侧互斥）。
• 内置 / 账号订阅 provider、已删除的供应商、不存在的模型一律不碰。
• 重复执行是干净的 no-op（第二次运行文件字节不变）。

v0.12.2

🐛 修复

• 修复 ZCode 升级后「模型管理」失效：ZCode 3.14 起用户自定义供应商与模型配置从 ~/.zcode/v2/config.json 迁到 ~/.zcode/v2/provider_config.json（schemaVersion: 1 全新结构），旧文件不再被 ZCode 读取。此前改上下文 / 输出上限、启用禁用模型、增删供应商与模型、拖拽排序等操作全部写进了这个废弃文件，界面上显示成功但实际无效。现已落到真正生效的 provider_config.json，并保留 ZCode 自己写入的字段（optionSpecs.reasoningLevel 等请求体映射、套餐模型顺序）。
• 修复账号切换（快照 / 切换 / 回滚）仍读写旧 config.json 的问题：现按 ZCode 版本落到当前生效的配置文件，新格式下只覆盖账号作用域（builtin: / account:）的订阅规则，用户自定义供应商不受影响。
• 修复「导入配置」来源 zcode 默认路径与解析：默认指向当前生效的配置文件，并支持解析新版 provider_config.json。

🛠️ 变更

• 适配 ZCode 3.14 新版 provider 配置：新增 src-tauri/src/zcode/provider_config.rs 适配层做双向投影——读取时把新结构还原为既有的 {"provider": {...}} 形状（前端与上层调用点无需改动），写回时把改动合并进新结构，只动用户自定义 provider，builtin: / account: 归 ZCode 内置配置所有、原样保留；旧版 ZCode 仍自动回退 config.json。订阅套餐 provider 的新 id（account:bigmodel-individual-coding-plan 等）在投影时还原为旧 builtin:* id，使既有的订阅识别与配额逻辑继续生效。

v0.12.0

zcode-assistant v0.12.0（2026-09-19）

✨ 新增

• 主界面接入命令面板（Ctrl/Cmd+K 唤起）：可按关键词搜索并跳转全部 10 个功能页。

🛠️ 变更

• 前端整体迁移到统一界面方案：React 18 → Vue 3 + myui 组件库（Gitee argustang/my-ui v0.7.0 起，git 依赖），壳层布局对齐 unified-ui 模板（顶栏 + 可折叠侧栏 + 内容区 + Overlay 层），全部页面/弹窗/表单改用 myui 组件与统一设计令牌（OKLCH + 毛玻璃、html.dark/html.light 双主题）；新增《统一界面重构评估报告》《myui 缺口反馈清单》工程文档。
• 主题系统升级为三态（深色 / 浅色 / 跟随系统），侧边栏与顶栏均提供快捷切换；旧主题偏好（za-theme）自动迁移。
• 「设置 → 外观定制」换肤（强调色色相 / 表面透明度 / 背景图）在统一令牌体系上重写，存量偏好（za-appearance）无缝沿用。
• 巨石拆解：模型管理页由 3838 行单文件拆为主视图 + 编辑弹窗 + 5 个弹窗子组件 + 配额行组件，行为不变。
• 确认交互统一为 confirmDialog()（Promise 式）：项目批量删除 / 清理缓存、账号切换、Beautify 还原与模板删除不再使用原生 confirm()。
• 依赖变更：移除 react / react-dom / react-markdown / remark-gfm，新增 vue / element-plus / vue-i18n / myui / markdown-it；npm run test:ts 由 tsc 改为 vue-tsc。
• myui 升级至 v0.10.0 并回落框架能力：删除本地图标运行时注册（应用图标集已收编进 myui 内置白名单）与 5 个本地兜底组件（配额进度条 / 双环 / 滑杆单位后缀 / 颜色字段 / 行内编辑），改用框架 MyProgress（阈值分档）、MyDualRing、MySlider :unit、MyColorField、MyInlineEdit；分组下拉改 MySelect :groups，表头半选改 MyCheckbox :indeterminate，弹窗错误横幅改 MyDialog :error，清理缓存确认按钮启用 confirmDisabled。
• myui 升级至 v0.12.0（补丁跟进）：修复命令面板打开后面板不可见（0×0）与 MyDualRing 内环分档失效 / 误继承外环分档色两个阻塞级缺陷，两者均为本项目在用组件；新增能力（MyVideoPlayer / MyDanmaku / MySettingsPanel / MyCombobox / promptDialog / toast action）暂无对应场景，未接入。
• myui 升级至 v0.18.0（跨 v0.13~v0.18 六个版本，官方声明全部向后兼容）：顺带修复侧栏自绘线性图标（Dashboard/Chart/Swap/Globe/Sliders 等）被宿主 CSS fill:currentColor 规则灌成实心块的潜在观感问题（v0.17.1，v0.9 起即存在）。新增可用能力本轮未接入、留作后续演进：下拉/右键菜单 MyDropdown、校验表单 MyForm/MyFormItem、上传队列 MyUpload、媒体组件（myui/media 子入口）、MySettingsPanel fill 填充模式、AI/模型品牌图标（Ai/Zhipu/Gpt/Claude 等 12 个）、MyButton ghost 语义色变体、输入件 focus()/blur() 契约、MyDataTable 编程接口转发、--success/--warning/--danger/--info-subtle 状态色令牌。

🐛 修复

• 修复项目 / 模型 / 自动切换 / 账号 / 美化等页状态标签与文本重叠：MyBadge 是 el-badge 角标（内容绝对定位于宿主右上角，无插槽内容时悬浮在旁边元素上），迁移时被误用作内联状态药丸；全部改用 MyTag（el-tag 内联标签）。该问题自 Vue 3 迁移即存在，与 myui 版本无关。
• 修复主窗口只显示背景图、整个界面不渲染的问题：「外观定制」背景图层为 fixed + z-index:0 且追加在 body 末尾，绘制顺序上会盖住无显式层叠上下文的界面内容（Vue 3 迁移引入的层叠缺陷，桌面 WebView2 实测暴露；浏览器预览不加载持久化壁纸故未发现）；背景图层改为 z-index:-1 固定置于最底层。
• 设置页「外观」主题按钮选中态样式笔误；Beautify 状态徽标引用了不存在的 za-badge-success 类（现改用 myui MyTag 的 success 变体）。

v0.11.0

v0.11.0 - 2026-09-11

✨ 新增

• 模型管理新增 Oh My Pi（OMP）模型双向同步：可从 ~/.pi/agent/models.json 预览并导入供应商、模型名称及上下文/输出限制，也可将 ZCode 自定义供应商同步回 OMP；两端均需在预览中勾选确认，按 baseUrl + apiKey 覆盖或新增，不删除既有条目。导出自动生成 models.json.bak，且不会修改 OMP settings.json 的默认供应商/模型。

v0.10.0

v0.10.0 - 2026-09-08

✨ 新增

• 模型管理支持同步和展示模型输入/输出类型：供应商 /models、OpenRouter 目录与
  opencode/ZCode 导入的 modalities 可贯通写入 ZCode 配置，覆盖文本、图片、音频、
  视频、文件及未来未知类型；“拉取可用模型”候选与已配置模型均展示支持类型。对已有
  模型仅在用户主动同步且获取到明确值时更新，未知数据不会清空手工配置；新模型无数据
  时保持兼容默认 text → text。导入开关升级为“重新获取模型信息”，同时刷新上下文、
  输出上限和缺失的支持类型。
• 模型管理新增上下文比例与最小上下文规则（默认 100% / 200K）：比例仅影响上下文长度，
  不影响最大输出长度；可按当前规则全量刷新已配置模型，目录/内置规格未命中的模型统一
  按最小值写入，完成后提示重启 ZCode。
• 所有页面的“重启 ZCode”操作统一到左侧菜单栏底部，移除模型管理、账号、项目管理和
  ZCode 设置页的重复重启按钮。

🛠️ 变更

（无）

v0.9.0

v0.9.0 - 2026-09-07

✨ 新增

• 美化「外置主题 + 实时热更新」架构重构（借鉴 zai-floating-monitor 的 agent_theme 方案）：app.asar 内只注入三个 file:// 外链（变量 / 主题 / 运行时脚本），主题资产全部外置到本应用数据目录——已注入状态下所有参数改动约 1 秒实时生效（运行时脚本每秒热重载变量文件），无需重打 asar、无需重启 ZCode；「应用美化」只在首次注入、ZCode 升级后或修复注入时使用，仍是秒级原地补丁。
• 美化新增视频壁纸：支持 mp4 / webm / mov 作为窗口背景（与图片同一图层机制，按扩展名自动切换 <video> / <img>），壁纸副本存于主题目录、不依赖源文件路径。
• 美化新增壁纸滤镜与可读性参数：亮度 / 饱和度 / 模糊 / 压暗遮罩（壁纸过亮时保证前景可读）/ 视频播放速率，以及三区域独立透明度（左栏 / 对话区 / 右栏，未单独调整时跟随「桌面不透明度」）与文字描边强度（0–1，深浅主题自动黑/白描边）。
• 美化新增分区透明元素规则与 Windows 全视口应用壳透明规则（实机选择器沿用 ZCode 桌面端 #sidebar / [data-pane-id] 面板组），并统一由「透出模式」开关门控——未开启毛玻璃 / 壁纸时对界面零影响。
• 项目管理新增「清理缓存」：按时间范围（3 天前 / 5 天前 / 7 天前 / 半个月前 / 1 个月前）批量删除久未活跃的会话及其全部数据——会话记录与消息（含子代理）、任务索引、子代理执行记录（agents）、工具结果缓存（artifacts）、执行日志（exec）与 rollout 用量文件，并尝试 VACUUM 压缩会话库回收磁盘空间。弹窗内实时预览将删除的会话数与可释放空间，执行前需两次确认（数据不可恢复）。
• 项目管理批量归档扩展到项目：勾选项目后批量操作条新增「归档所选项目」，逐个归档其全部活跃会话——只归档不删除，可在「查看历史」随时恢复；原「关闭所选」更名为「归档所选会话」，与删除明确区分。

🛠️ 变更

• 归档 / 恢复按钮名称具体化以消除歧义：项目行「归档 / 恢复」→「归档项目 / 恢复项目」，会话行「归档 / 恢复」→「归档会话 / 恢复会话」，相关确认与提示文案同步更新。
• 项目 / 会话删除改为双重确认：第一次确认删除范围，第二次确认「数据不可恢复」，防止单次误点导致无法找回；删除结果提示新增实际释放的磁盘空间。
• 美化配置新增字段：sidebar_opacity / panel_opacity / sidebar_right_opacity / text_shadow / wallpaper / wp_brightness / wp_saturate / wp_blur / mask_strength / playback_rate；旧 bg_image 字段与既有 config.json / 模板完全兼容（wallpaper 优先）。旧版注入（asar 内打包 css/js）的应用会在下次「应用美化」时自动升级为外链方案并清理旧资产。

v0.8.0

v0.8.0 (2026-09-02)

✨ 新增

• 项目管理会话列表支持全选 + 批量关闭：展开项目后，会话表头新增全选框（支持半选态），勾选会话后批量操作条出现「关闭所选」——批量归档所选会话（已归档自动跳过），在 zcode 会话列表隐藏、可随时在「查看历史会话」恢复，清理积压会话不必再逐个点击。
• 自动切换「应用启动」规则支持限定生效时间范围：编辑规则选类型「应用启动」时，可选择「全天生效」（默认）或「指定时间范围」（起止 HH:MM，默认 09:00–18:00，分钟为 00），仅当应用启动时刻落在范围内才触发；结束时间小于开始时间视为跨零点范围（如 22:00–06:00）。规则列表同步展示生效范围。

🐛 修复

• 修复「应用启动」自动切换被误判「已是目标」而静默跳过的问题：此前「是否已在目标模型」依据最近一次自动切换写入的内部标记判断，用户手动把模型切走（供应商不变）后该标记不更新，下次启动时被误判为已在目标、不执行切换；现改为读取最近活跃会话的实际模型选择，手动切换可被感知，启动触发恢复可靠。

v0.7.0

v0.7.0 - 2026-08-28

✨ 新增

• 新增侧边栏「ZCode 设置」页（调参 ZCode 本体行为），首个能力「模型调用重试」：
  通过 ZCode 官方 ZCODE_MODEL_RETRY_* 用户环境变量调整接口失败重试策略——
  最大重试次数（默认 10）/ 起步延迟（2s）/ 退避倍数（×2）/ 延迟上限（60s）
  四项均可覆盖，留空跟随 ZCode 默认、支持一键恢复，编辑时实时预览重试延迟
  序列。写入后广播环境变量变更，ZCode 运行中会弹全局重启确认。注意：全局对
  所有模型统一生效（ZCode 官方暂不支持按模型 / 按错误类型区分次数）。
• 悬浮球面板支持「固定」：单击悬浮球固定面板——固定后面板常驻，鼠标移开、
  点击面板窗口外都不会再收起；面板标题旁显示「已固定」徽标，球右上角亮点
  提示，点面板右上角 ✕ 或再次单击球收起。悬停球快速查看的自动收起行为不变
  （此前面板只随鼠标 hover 存在，点击窗口外即消失，无法边看配额边干活）。

🛠️ 变更

• 打包提速：release 配置由 fat LTO + codegen-units=1 换为 thin LTO +
  codegen-units=16（并行 LTO / 并行代码生成）。fat LTO 每次构建都要对整个
  依赖图做串行全量重优化，是打包最大瓶颈；调整后重复打包的编译耗时大幅下降，
  二进制大小与运行性能几乎不变（<1%）。
• 依赖例行维护与安全扫描：npm 依赖在版本范围内均为最新（npm audit 0 漏洞）；
  Rust 侧 cargo update 升级 36 个兼容小版本，OSV/RustSec 漏洞扫描命中的
  17 项均为低危 / 信息级（Linux 编译链与停止维护的传递依赖），不影响 Windows
  产物。

v0.6.0

v0.6.0 - 2026-08-25

✨ 新增

• 设置新增「外观定制」（参考 ZCode 美化，仅主窗口，即时生效，可一键还原默认）：
  主题色（6 组预设色板 + 色相滑杆，深/浅主题分别适配）、透明度（面板与表面
  不透明度，调低让光晕 / 背景图透出）、背景图（选择本地图片铺满窗口底层 +
  不透明度调节，复用美化页的选图与预览读取；生效时侧边栏 / 顶栏自动降为
  轻纱玻璃，背景图连续覆盖整窗，漂移光晕同步压低）。
• 自动切换规则新增「同时切换主供应商」开关（默认关闭）：规则触发切换时，把
  「模型管理」的 ⭐ 主供应商标记同步设为目标供应商，总览 / 悬浮球 / 托盘的
  配额展示随之跟随；手动「测试」以及「已是目标供应商」的跳过场景同样生效。

🛠️ 变更

• 构建提速配置：[lib] crate-type 去掉桌面应用用不到的 staticlib / cdylib
  （Tauri 移动端遗留），MSVC 目标改用 Rust 自带 rust-lld 链接器
  （src-tauri/.cargo/config.toml）。对本机实测收益被环境波动（安全软件扫描 /
  系统负载）淹没，但属官方推荐形态，全量重建与磁盘占用更低。

🐛 修复

• 修复升级后「开机自启动」失效：NSIS 升级流程会先静默执行旧版卸载器，其
  非更新模式会顺手删除 HKCU Run 的自启注册项，新装的版本又不会自动补注册，
  设置开关随后被查询同步为关闭。双管齐下：安装模板让升级路径始终以 /UPDATE
  执行旧版卸载器（保留自启项与快捷方式）；应用启动时按偏好自愈——记录为
  开启但系统注册项丢失时重新注册，注册项指向旧安装路径时刷新。

v0.5.1

v0.5.1 - 2026-08-24

🛠️ 变更

• 「应用美化」改为 app.asar 原地补丁，不再整包解包/重打包：原先对 284MB 的
  包要解出几千个小文件再全量重打包 + 双倍 SHA256（数十秒），现在只更新 asar
  JSON 头中被触及的条目、新内容追加到 payload 尾部、原字节顺序照抄，实测
  2.3 秒完成；关闭 ZCode 的停机窗口也随之缩短。

🐛 修复

• 修复 ZCode 升级后美化备份过期的问题：升级会整体替换 app.asar，但备份逻辑
  只看文件是否存在，导致重新应用时不会备份新版本官方包、且「还原」会把旧版本
  asar 覆盖到新版本安装上（主程序与渲染层版本错配，可能直接损坏 ZCode）。
  现在备份感知版本：升级后首次「应用美化」自动用官方包重建备份；备份版本与
  当前安装不一致时还原被拒绝并说明原因；美化状态同步显示备份所属的 ZCode
  版本，不一致时黄字提醒并按情形给出指引（未注入 → 下次应用自动重建备份；
  已注入 → 禁用「还原」按钮，提示重装/修复 ZCode）。