# 更新日志

简体中文 · [English](CHANGELOG.md)

本文件记录 Cockpit Tools 的所有重要变更。

格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)。

---
## [0.20.19] - 2026-04-07

### 变更
- **所有平台现已支持“当前账号刷新间隔”独立配置，并同步提供快捷设置入口（默认 1 分钟）**：可在各平台设置与对应快捷设置分别调整，仅影响当前账号刷新频率，不改变该平台的全量配额自动刷新间隔。
- **Antigravity 与 Codex 唤醒任务现已支持“启动后”触发并可配置延时**：应用启动后会自动下发已启用的启动后任务，常规定时调度循环会跳过仅启动后触发的任务。
- **Codex 唤醒运行时配置现已支持显式指定 `codex` / `node` 路径并返回必填路径提示**：自动检测失败时，可在运行时引导中填写可执行文件或目录路径并立即重新检测生效。
- **自动切号范围现已支持按指定账号筛选（不再仅限模型分组）**：Antigravity 与 Codex 现在可在设置页与快捷设置中将监控与候选切号范围限制到指定账号 ID。
- **系统设置现已支持应用开机自启动并与原生自启动状态同步**：桌面端通过 autostart 插件读取并应用系统真实自启动状态，不再只依赖前端状态。

### 修复
- **Codex 账号导入现已在磁盘空间不足时快速失败并返回明确进度提示**：导入前会执行可写性预检，磁盘不足时返回显式错误，避免静默部分失败。
- **实例目录删除现已在各平台统一走回收站/废纸篓语义**：目录删除改为统一使用 trash 语义，避免平台间删除行为不一致。

---
## [0.20.18] - 2026-04-04

### 变更
- **Codex CLI 检测现已补充家目录下的常见用户级安装路径扫描**：运行时查找会覆盖 `~/.npm-global/bin`、`~/.local/bin`、`~/.cargo/bin`、`~/.volta/bin`、`~/.yarn/bin` 与 `~/bin`，提升非系统安装场景下的检测命中率。
- **唤醒调度现已让 crontab/间隔预览与实际运行规则保持一致**：桌面端与前端均支持完整 5 段 crontab 校验（含范围、步长、列表与星期归一化），间隔时间窗支持跨午夜区间，配额重置任务在时间窗外也可按 fallback 时间点触发。
- **Gemini 凭据同步现已优先使用 keychain，并强制按项目维度刷新配额**：本地凭据读取会合并 macOS keychain 与文件凭据，切号时会回写 keychain 并清理旧 file-keychain 文件，配额请求会稳定要求并传递已解析的 project id。
- **Antigravity 配额刷新现已区分手动批量与自动触发来源**：自动刷新会继续跳过禁用/forbidden 账号，手动批量刷新保持全量账号处理行为。

---
## [0.20.17] - 2026-04-01

### 变更
- **Antigravity 自动切号现已支持模型分组触发范围（`any_group` / `selected_groups`）与分组阈值判定**：快捷设置可指定分组，配置会持久化所选分组 ID，候选账号筛选也会按监控分组阈值执行。
- **Codex 共享资源链接同步现已在实例链接不一致时自动强制重建**：当实例目录/文件与全局默认共享资源不一致时，会自动清理旧目标并重新创建符号链接，不再卡在“需手工合并”错误。

### 修复
- **Antigravity 切号失败后现会先回读并修正当前账号状态再返回错误**：账号 store 会重新拉取账号列表与当前账号，仅在当前账号实际变化时再派发变更事件，避免失败后界面残留旧状态。

---
## [0.20.16] - 2026-03-31

### 新增
- **Gemini 账号现已支持按账号配置 GCP 项目（从云端项目列表选择）**：账号卡片/表格新增项目设置弹框，可拉取可访问项目、可切回自动项目识别，并持久化保存所选 project id。
- **Codex 实例现已在创建/启动时自动接入共享 Skills/Rules/AGENTS 资源**：`skills`、`rules`、`vendor_imports/skills` 与 `AGENTS.md` 会与默认 Codex Home 同步，并带迁移与冲突保护。

### 变更
- **Gemini 配额刷新与 CLI 启动现已优先使用已配置项目**：保存项目后会触发刷新，账号列表会显示当前项目，启动命令会注入 `GOOGLE_CLOUD_PROJECT`。
- **当前账号优先排序现已在账号页与实例选择器统一生效**：在 Antigravity、Codex、Gemini、Cursor、Windsurf、Kiro、Qoder、Trae、Zed、GitHub Copilot、CodeBuddy CN、WorkBuddy 等视图中，当前账号会在其它排序规则前优先置顶。
- **OpenCode 切号相关默认值现已改为默认关闭**：`sync_on_switch` 与 `auth_overwrite_on_switch` 在配置默认、设置页初始化与唤醒任务上下文中均改为默认关闭。
- **Codex 代码评审配额显示默认值现已改为隐藏**：仅在用户显式开启后才显示该指标。
- **Updater 依赖链路现已补齐 reqwest 的 socks 能力**：全局代理为 `socks5://` 时更新链路兼容性更好。

---
## [0.20.15] - 2026-03-30

### 新增
- **经典侧边栏现已新增独立的 2FA 管理页入口**：可在同一工作区完成 Base32 秘钥查询、动态验证码查看、收藏保存、近期查询记录查看，以及已保存记录的 JSON 导入/导出。

### 变更
- **Codex 多账号本地存储路径现已统一到 `~/.antigravity_cockpit`，并支持从旧路径一次性迁移**：旧目录中的 `codex_accounts.json` 与账号详情文件会迁移到新目录，且不会覆盖新目录中已存在的同名新文件。
- **账号页网格视图批量选择交互现已统一**：各平台账号页与共享账号视图在网格模式（含按标签分组）下均提供 `全选` 入口。
- **2FA 页面文案与操作入口现已全面接入多语言键**：导航标题、确认提示、表头与操作按钮文本均改为从 locale 资源读取，不再依赖硬编码字符串。
- **日志查看弹框底部现已增加显式关闭按钮**：可直接在弹框底部完成关闭，无需依赖顶部关闭控件。

---
## [0.20.14] - 2026-03-28

### 新增
- **CodeBuddy CN 与 WorkBuddy 现已统一为同一套账号工作区与签到流程，并保持能力同步**：两端账号列表/表格渲染、签到弹框交互与数据解析归一化链路已共用，实现账号操作与配额展示行为一致。
- **CodeBuddy CN 现已支持每日签到完整闭环**：账号页与桌面命令层已接入签到 API、状态展示与就地签到弹框交互。

### 变更
- **CodeBuddy CN 配额展示现已改为四类模型并统一聚合逻辑**：配额数据按 `base`、`activity`、`extra`、`other` 四类组织，账号页与仪表盘统计改为复用共享 suite 模型，结果一致。
- **设置页现已补齐 CodeBuddy CN / WorkBuddy 刷新配置闭环**：快捷设置与设置页对两端提供一致的刷新项，并复用统一自动刷新链路。
- **Cloud Code 配额请求现已按检测到的官方 Antigravity 安装信息动态构建 metadata 与 User-Agent**：本地配额拉取与 onboard 流程会动态带上 IDE 版本、平台与客户端请求头（含 `x-goog-api-client`），不再依赖硬编码版本/请求头。

### 修复
- **CodeBuddy 实例页与仪表盘卡片现已更准确地识别账号类型并聚合配额**：实例列表按共享账号类型映射展示，仪表盘卡片不再跨平台错误混合聚合结果。
- **签到相关多语言键现已在各语言中对齐（含 ar 与 zh-tw）**：补齐缺失键并移除英文值复用，确保签到 UI 文案完整。

---
## [0.20.13] - 2026-03-28

### 变更
- **Antigravity 唤醒现已可按官方客户端版本模式对齐 Language Server 启动参数**：唤醒任务与账户检测均新增 `>=1.21.6 / <1.21.6` 版本模式选择，所选模式会本地持久化并同步到桌面运行态；唤醒网关仅在 `<1.21.6` 模式下附加 `--random_port` 参数，以匹配旧版官方客户端行为。
- **唤醒账号选择器现已支持“搜索 + 类型/标签/分组”组合筛选，并按可见结果批量选择**：任务编辑、立即测试与账户检测都可按账号类型、标签、分组（含未分组）筛选，“全选”只作用于当前筛选结果。
- **Codex API Key 凭据输入现已在导入/保存前做字段意图校验**：当 API Key 看起来像 URL 时会直接拦截，Base URL 必须是合法 HTTP(S) 地址，同时禁止 API Key 与 Base URL 相同，避免字段填反。
- **Codex 缺失启动路径弹框现已支持在弹框内直接关闭“切号时自动启动”**：关闭后仍保留切号与登录覆盖能力，但不再自动拉起 Codex App，且该缺失路径提示不会再反复弹出。

---
## [0.20.12] - 2026-03-27

### 变更
- **macOS 托盘交互现已按原生习惯对齐左/右键行为，并在菜单关闭时清理残留高亮状态**：左键抬起会直接恢复并聚焦主窗口，右键按下会打开托盘上下文菜单，原生菜单收起时会显式清理状态栏图标高亮，避免图标长期停留在高亮态。
- **Antigravity 账号持久化现已只保存最小快照，并在 localStorage 超限时自动恢复**：持久化 token 会做脱敏处理，quota 快照不再落盘大体积模型数据，存储配额超限时会自动清理新旧账号缓存键，避免写入持续失败。

---
## [0.20.11] - 2026-03-27

### 新增
- **Codex 现已新增“会话管理”能力，用于多实例会话线程同步与废纸篓清理（感谢 @GiZGY，PR #324）**：可在同一入口把缺失会话线程同步到各实例，并按会话维度在分组视图中将选中会话移入废纸篓。
- **Codex 唤醒手动测试现已支持“运行中取消”**：测试执行会携带取消作用域，桌面端唤醒链路可中断仍在运行的 Codex CLI 进程，执行结果弹窗也支持在运行中直接取消测试。

### 变更
- **Homebrew Cask 元数据已刷新，发布分发配置与最新产物保持一致**：Cask 配方已同步到当前发布的二进制与校验信息。

---
## [0.20.10] - 2026-03-27

### 新增
- **Antigravity 唤醒手动测试现已支持在测试弹框内直接取消**：每次测试都会带上独立的取消作用域并贯穿桌面端唤醒链路，用户取消后会立即停止仍在进行中的请求，并显示单独的“测试已取消”提示，而不必继续等待全部请求跑完。

### 变更
- **经典侧边栏现已改为更扁平的导航结构，并在升级时自动迁移已有布局偏好**：经典模式不再依赖可展开的分组区块，未放入主侧栏的入口会直接出现在“更多平台”中，折叠手柄改为基于 transform 的动画移动，旧版侧边栏偏好键会在升级后自动迁移到新的持久化 store。
- **Antigravity 账号缓存持久化现已收敛到统一 store，并自动迁移旧版本地键**：缓存的账号列表与当前账号快照会从新的持久化 store 统一恢复，旧版本地键会在迁移完成后自动清理。

---
## [0.20.9] - 2026-03-25

### 新增
- **新增经典侧边栏布局模式，支持完整平台导航、侧边栏折叠、分组子项展开与侧边栏内日志入口**：用户可从紧凑原始导航切换为全高经典导航形态，在窗口高度受限时也会按自适应缩放保持可用。

### 变更
- **侧边栏布局配置现已支持按模式生效的管理行为**：设置页新增 `原始布局 / 经典布局` 切换；首次进入经典布局会按仪表盘可见项同步侧边栏入口；平台布局弹窗在经典布局下允许选择任意数量侧边栏入口，原始布局仍保持数量上限。
- **Antigravity 账号额度展示分组现已固定为内置模型族（Claude / Gemini Pro / Gemini Flash）**：账号页展示分组改为直接使用预置分组，不再依赖手动分组配置。
- **文档现已补充 Arch Linux 的 AUR 安装路径**：`README.md` 与 `README.en.md` 新增源码包（`cockpit-tools`）与预编译包（`cockpit-tools-bin`）两种安装方式说明。

---
## [0.20.8] - 2026-03-24

### 修复
- **当用户没有在应用内显式开启全局代理时，macOS 下通过 shell 启动时继承的代理环境现已继续生效**：应用启动和保存配置时不再直接清空启动时继承的代理变量，而是恢复这份继承环境，因此 `export http_proxy=... && open -a 'Cockpit Tools'` 这类用法会继续可用；只有用户在应用内主动配置全局代理时才会覆盖它。

---
## [0.20.7] - 2026-03-24

### 变更
- **悬浮账号卡片现已在多窗口之间实时同步导入、删除、OAuth 完成和当前账号切换结果**：各平台账号页与账号 store 现在会统一发出账号同步事件，悬浮卡片在账号管理动作完成后会立即刷新，不再需要手动重载或等窗口重新聚焦；实例绑定的悬浮卡片仍会保持绑定账号视图。
- **Windsurf 账号页里的官方配额面板现已补上每日/每周进度条，并区分 low 与 critical 两档告警颜色**：来自 Windsurf 官方 plan snapshot 的 quota 项现在会复用统一的配额进度条样式，不再只显示百分比文字，剩余额度风险一眼就能看出来。

### 修复
- **当前账户判定现已更严格地跟随真实本地状态，覆盖同步、删除、切换和“账号列表已空”场景**：当平台账号列表为空时，各平台 store 会清理陈旧的当前账号 ID；同步/删除/切换后会立刻向其它窗口传播新的当前账号；实例绑定的悬浮卡片也不会再因为平台暂时解析不到独立 current account 而显示空白。
- **Windsurf 的 quota 计费账号现已在账号页、托盘、macOS 原生菜单和诊断报表中稳定保持 quota 模式，并把官方剩余额度百分比正确换算为已用百分比**：额度视图现在会把 `dailyQuotaRemainingPercent` / `weeklyQuotaRemainingPercent` 视为“剩余配额”，在 quota 计费但缺少该字段时回退为“已耗尽”，避免 quota 账号误切到 credit 视图或把已用百分比显示反了。

---
## [0.20.6] - 2026-03-24

### 变更
- **Codex 唤醒账号选择器现已内联显示主/副配额徽标**：唤醒账号卡片会在掩码后的账号上下文旁展示两枚紧凑的标准配额指示，让用户在勾选账号前就能直接比较主配额与副配额状态，而不必先切回完整账号视图。

### 修复
- **跨平台桌面端 Rust 构建现已与目标平台编译规则保持一致**：Codex CLI 安装提示在 macOS 与非 macOS 目标下都可正常编译，Qoder OAuth 的路径处理工具也不再被错误地限制在 Unix-only import 上。

---
## [0.20.5] - 2026-03-24

### 修复
- **Windsurf 按 quota 计费的账号现已在账号页、托盘、macOS 原生菜单和诊断报表中一致展示官方“已用百分比”**：每日和每周额度用量现在会直接读取上游返回的 usage 百分比字段，不再把它误当成剩余百分比再反向换算，避免配额进度显示颠倒或被错误钉死为已耗尽。

---
## [0.20.4] - 2026-03-24

### 新增
- **Codex 唤醒现已端到端支持模型预设与任务级推理强度选择**：唤醒任务和手动测试都可选择受管模型预设及推理强度；执行记录会保存模型信息；执行时会把 `model` / `model_reasoning_effort` 直接传给 Codex CLI。
- **Codex 唤醒调度现已支持“配额重置后触发”并可选择触发窗口**：任务可按 `primary_window`、`secondary_window` 或二者任一重置后触发；调度器会基于账号真实配额重置时间计算当前可执行与下一次执行时间。

### 变更
- **启用配额重置任务时会自动收紧 Codex 配额刷新频率**：当存在至少一个启用中的配额重置任务时，Codex 自动刷新会调整为每 2 分钟一次，以确保及时捕捉重置触发。
- **桌面更新流程现已支持“关闭提醒”与“跳过当前版本”**：设置页新增更新提醒开关；更新弹窗可跳过当前检测到的版本；后续自动检查会忽略该版本；侧边栏快捷更新入口会跟随提醒开关，同时保留下载中和可重启状态的可见性。
- **账号页视图模式持久化已在各平台统一，且 Codex 新增紧凑视图**：Codex 总览新增紧凑布局；各平台账号页的列表/卡片模式会按平台维度持久化存储。
- **Codex 唤醒任务摘要与执行详情现已对账号邮箱做掩码展示**：任务卡片和执行结果列表不再直接显示完整邮箱，同时保留账号上下文信息和所选模型元数据。
- **悬浮账号卡片窗口现已关闭系统原生窗口阴影**：透明的桌面悬浮卡片窗口现在会以无原生阴影的方式创建。

---
## [0.20.3] - 2026-03-24

### 修复
- **桌面端更新提示现已统一收口到同一条应用级检查链路，不会再因为弹框内二次检查而把已发现的新版本吞掉**：启动检查和手动检查现在都会复用同一份 updater 结果；检测到新版本后不会再因为弹框再次执行 `check()` 而丢失提示；静默下载完成后会复用同一个更新弹框显示“立即重启”；应用保持运行时也会在首次启动检查后继续按小时轮询更新。

### 变更
- **Codex 唤醒现已改为为每个账号复用固定受管的 `CODEX_HOME`，而不再每次执行都创建临时 profile**：每个账号现在都会复用稳定的本地唤醒目录，`auth.json` 会在执行前以原子方式重写，唤醒任务触发时也不再每次新建并删除一套临时 profile 目录。
- **Windows 进程探测现已收敛为单一路径的内联 PowerShell 执行，不再保留临时脚本兜底**：Windows 下的探测与拉起辅助逻辑在内联 PowerShell 失败时不再写入临时 `.ps1` 文件，也不再通过 `ExecutionPolicy Bypass` 作为回退执行路径。

---
## [0.20.2] - 2026-03-23

### 修复
- **正式打包的 macOS Codex 唤醒版本现已能检测 Homebrew 安装的 Codex CLI 及其 Node 运行时，而不再依赖终端 PATH**：桌面应用现在会在打包 GUI 环境下额外补充 macOS 标准 CLI 安装目录，并用同一套运行时搜索路径解析 `codex` 启动器和所需的 `node` 解释器，避免发布后的 `.app` 在 `/opt/homebrew` 或 `/usr/local` 已安装 CLI 时仍误报“未安装 Codex CLI”。
- **Windows 下的 Codex 唤醒 CLI 检查现已不再在运行时探测时闪出黑色控制台窗口**：Codex CLI 的版本探测和唤醒命令启动现在都会统一应用隐藏窗口的进程标记，因此正式打包的桌面版本在检查 CLI 可用性或执行唤醒命令时，不会再短暂弹出黑色控制台窗口。

### 变更
- **Codex 唤醒 CLI 探测现已补充面向正式包排障的定向桌面日志**：CLI 重检、版本探测、运行时解析与唤醒执行现在都会输出带有 `[CodexWakeup][CLI]` 前缀的日志，记录搜索目录、启动器路径、Node 路径以及进程失败输出，方便直接从 `app.log` 诊断正式包环境问题。

---
## [0.20.1] - 2026-03-23

### 新增
- **Codex 唤醒任务现已新增“随时可看”的执行详情入口**：每张任务卡片都会提供独立详情图标，点击后可打开与手动测试共用的“执行结果”弹窗，在任务开始前先查看待执行账号，定时任务真正启动后也会继续在同一个弹窗里展示进度。

### 修复
- **Codex 唤醒任务卡片现已为手动执行补上确认步骤，并按任务批次统计触发历史数量**：点击手动执行按钮时会先弹出确认框，避免误触后立即唤醒账号；触发历史角标也改为按任务/测试批次分组统计，不再按账号执行条数放大数量。
- **发版资产上传现已改为先锁定单一 GitHub Release 再重建聚合元数据**：发布工作流现在会先创建唯一 draft release，再按 `releaseId` 上传矩阵构建产物，避免同一版本被拆成多个 draft release，进而导致 macOS、Windows、Linux 的合并 `latest.json` 与 `SHA256SUMS.txt` 生成失败。

---
## [0.20.0] - 2026-03-23

### 新增
- **Codex 现已新增面向 OAuth 账号的“唤醒任务”工作区**：Codex 页面新增“唤醒任务”页签，可创建按日、按周、按间隔执行的任务，检查 Codex CLI 可用性与安装指引，执行手动唤醒测试，预览接下来执行时间，并按账号查看实时进度与执行历史。

### 变更
- **Codex 唤醒执行链路现已从页面临时状态升级为桌面端持久化调度**：任务配置与执行历史会本地保存，桌面应用启动后会自动开启后台调度器，手动执行任务后会刷新 Codex 账号数据，且 Windows 下执行唤醒时不会再弹出黑色控制台窗口。

### 修复
- **账号、唤醒、验证、指纹与实例相关弹框的失败提示现已统一保留在当前弹框内**：删除、保存、绑定等操作失败时，弹框会保持打开，并在弹框内固定错误区显示错误、自动滚动到出错位置，同时在再次提交或关闭弹框前清理旧错误。

---
## [0.19.2] - 2026-03-23

### 修复
- **Windows 下悬浮卡片操作按钮不再被窗口拖拽命中逻辑吞掉点击**：点击悬浮卡片的关闭、置顶与账号翻页控件时，现在会稳定触发对应操作，不再因为命中 SVG 图标节点而被误判为开始拖动窗口。

---
## [0.19.1] - 2026-03-23

### 修复
- **正式打包的 macOS 菜单栏版本在打开原生 Swift 托盘菜单时不再崩溃**：原生菜单所需的平台图标现已随主应用资源一起打包，并从发布后的 app bundle 中读取；点击菜单栏入口时不再因 `Bundle.module` 缺失资源而触发断言崩溃。

---
## [0.19.0] - 2026-03-23

### 新增
- **新增独立悬浮账号卡片窗口，支持当前/推荐账号预览、快捷切换、置顶与实例绑定悬浮框**：应用现在可在启动后自动显示悬浮卡片，也可从“设置/托盘”手动重新打开；支持为受管实例打开绑定账号的独立悬浮卡片，记住窗口位置，并提供关闭确认与回到主页面的快捷入口。
- **macOS 托盘交互现已接入原生 Swift Popover 菜单用于账号总览与切换**：菜单栏入口现在会打开基于平台快照同步的原生平台切换器与账号卡片面板，可直接执行切换账号、打开详情页和重新唤起主窗口等操作。

### 变更
- **多个平台的当前账号判定现已统一改为读取真实本地绑定与运行态，而不再依赖前端本地存储猜测**：Cursor、Gemini、Kiro、Windsurf、CodeBuddy、CodeBuddy CN、Qoder、Trae、WorkBuddy 与 Zed 现在会通过后端 store 链路解析当前账号，仪表盘、账号页、托盘与悬浮卡片也统一复用同一份当前账号状态，不再各自依赖 `localStorage` 回退。
- **平台账号导出现已严格跟随页面当前筛选后的可见账号范围**：各平台账号页的批量导出现会按当前视图中筛选后仍可见的账号列表执行；若当前可见账号里存在选中项，则只导出这些可见选中账号，不再把筛选范围外的隐藏选中项一起导出。
- **当前账号刷新结果现会在同步或切换后立即传播到运行态入口**：Antigravity 在读取本地客户端状态后会立即刷新托盘；各平台 store 会在拉取账号列表或切换账号后同步刷新当前账号状态；共享账号页里的 `Available AI Credits` 文案也已改为走多语言键，不再硬编码。

---
## [0.18.3] - 2026-03-22

### 新增
- **当本地账号索引缺失、为空或损坏时，现已支持按账号详情文件自动修复各平台索引**：Codex、Cursor、GitHub Copilot、Gemini、Kiro、Qoder、Trae、Windsurf、CodeBuddy、CodeBuddy CN、WorkBuddy 与 Zed 现在会先备份异常索引，再重新扫描各账号详情 JSON 文件，按最近使用顺序重建账号列表，并在页面继续加载前把恢复后的索引重新写回磁盘。

### 变更
- **账号页现会更直接提示无法自动修复的本地文件损坏问题**：共享账号页已统一复用损坏文件解析逻辑，当自动修复仍无法恢复索引时，界面会直接展示损坏文件名，而不再只给出泛化错误信息。

---
## [0.18.2] - 2026-03-22

### 变更
- **账号分组现已改为遵循真实本地落盘路径，而不是只存在浏览器存储中**：分组定义现在会保存到 `~/.antigravity_cockpit/account_groups.json`，首次加载时会自动迁移旧版 `localStorage` 数据，分组间移动账号也会直接更新落盘分组文件，而不再只是改前端状态。
- **账号页里的分组管理现已更紧凑且更易操作**：列表视图与紧凑视图都会内联展示分组行；在分组内选中账号后可直接从面包屑操作区移到其他分组或移出当前分组；分组成员选择器也复用了主页同一套套餐/标签筛选能力。

### 新增
- **标签编辑现已支持写入随账号持久化保存的备注字段**：标签弹窗可同时编辑最多 200 个字符的备注，新备注会通过账号持久化链路写入账号记录，重启后仍会保留。

---
## [0.18.1] - 2026-03-22

### 变更
- **Zed 的账号展示现已在账号页、仪表盘与菜单栏之间统一对齐**：Zed 套餐标签现在会去掉 `zed_` 前缀并以上游原始后缀的大写形式展示；仪表盘订阅 badge 复用主页同款视觉样式；紧凑卡片中的 `Edit Predictions` 摘要会保持单行 `used / total` 展示。
- **Zed 的菜单栏显示现已严格跟随已保存的平台布局和桌面端真实状态字段**：在平台布局里关闭 Zed 菜单栏显示后不会再被旧版迁移逻辑自动加回；侧边菜单与平台布局入口重新可见；菜单栏摘要也改为与主页一致，只显示 `Edit Predictions` 与欠费状态，不再保留旧的 token 消耗行。

---
## [0.18.0] - 2026-03-22

### 新增
- **新增 Zed 账号管理全链路能力，支持官方 native-app OAuth、JSON 导入、本机当前登录状态导入，以及按官方客户端真实凭据位点应用账号**：新增独立的 Zed 账号页、本地账号索引与存储、当前会话运行态控制，以及与官方桌面端一致的账号应用与重启链路。
- **Zed 已接入仪表盘摘要、全局账号迁移包与平台设置**：仪表盘卡片、账号迁移导入导出、启动路径配置、自动刷新频率与配额提醒设置现已覆盖 Zed。

### 变更
- **Zed 配额展示已改为遵循桌面端真实账号接口，而不再依赖浏览器 Billing 页面**：页面现在聚焦 `/client/users/me` 中可直接读取的 `Edit Predictions` 与欠费状态，支持导入本机当前已登录账号，并在刷新时记录原始返回值用于排障。
- **Zed 平台展示已按当前发版形态收紧**：应用现已使用官方 Zed 应用图标；添加账号弹窗对齐共享的 `OAuth / Token / 导入` 结构；在暂停继续维护菜单栏入口期间，左侧侧边菜单中暂时隐藏 Zed 入口。

---
## [0.17.8] - 2026-03-21

### 修复
- **Codex API Key 账号在配置自定义 Base URL 时，现已向 `~/.codex/config.toml` 写入官方要求的 `openai_base_url` 键**：切换账号与本地注入流程不再落盘错误的 `base_url` 键，Codex 可以正确读取已配置的上游 API 地址。

---
## [0.17.7] - 2026-03-21

### 变更
- **仪表盘与托盘中的 Windsurf 用量摘要现已按官方 quota / credits 计费模型一致展示**：按 quota 计费的账号现在展示每日额度用量、每周额度用量与额外用量余额；按 credits 计费的账号继续展示剩余积分拆分，同时避免因枚举式 billing strategy 原值被误判。
- **多个平台的仪表盘账号卡片现更准确展示各自原生配额结构**：Kiro、Gemini、CodeBuddy、CodeBuddy CN、Qoder、Trae 与 WorkBuddy 卡片现在会通过共享 presentation 层展示正确的剩余/已用摘要、重置或到期时间，以及相关状态信息。

---
## [0.17.6] - 2026-03-20

### 变更
- **Windsurf 用量模式判定现已按官方 billing strategy 枚举值全链路对齐**：账号页会先归一化原始 `BILLING_STRATEGY_*` 值，再决定走 quota 还是 credits 展示，避免官方 quota 账号因枚举式原值而被误判。
- **Windsurf 的 quota 面板现保持官方三字段摘要完整可见**：按 quota 计费的账号现在始终展示每日额度用量、每周额度用量和额外用量余额；当本地快照缺少余额字段时，额外用量余额默认显示为 `$0.00`。

---
## [0.17.5] - 2026-03-20

### 变更
- **Windsurf 账号用量展示现已按官方计费模式对齐**：按 quota 计费的账号现在展示每日/每周额度用量、重置时间与额外用量余额；按 credits 计费的账号则展示合并后的剩余积分以及 prompt/add-on 明细。
- **手册帮助入口已在仪表盘与概览页头统一复用**：仪表盘和平台概览页头现在共用同一套帮助图标按钮，尺寸、悬停反馈与跳转行为保持一致。

---
## [0.17.4] - 2026-03-20

### 变更
- **主要账号页的套餐筛选现已支持多选**：Accounts、Codex、Cursor、Gemini、GitHub Copilot、Kiro、Qoder、Trae、Windsurf、CodeBuddy、CodeBuddy CN、WorkBuddy 页面现可一次选择多个套餐/状态类型进行筛选。
- **套餐筛选交互已统一为复用下拉组件**：新增通用多选筛选下拉，统一支持已选数量提示、一键清空与跨页面一致的筛选行为。

---
## [0.17.3] - 2026-03-20

### 新增
- **桌面端新增内置实时日志查看器用于运行态排障**：主窗口新增浮动日志入口，支持查看最新日志尾部、自动刷新、行数限制、清空/复制日志内容、复制日志路径与一键打开日志目录。
- **后端日志命令新增“最新文件快照 + 有界尾部读取”能力**：新增最新 `app.log*` 发现、尾部行数限制与跨平台日志目录打开命令，支撑前端诊断查看链路。

### 变更
- **CodeBuddy 与 WorkBuddy 的用量状态展示已统一并补齐异常详情**：账号卡片/表格统一展示异常状态与详情弹窗（含脱敏账号上下文），CodeBuddy/WorkBuddy 实例页配额预览统一复用 dosage-notify 渲染逻辑，展示口径保持一致。

---
## [0.17.2] - 2026-03-20

### 变更
- **Windows 下 Codex 启动默认改为对齐 Microsoft Store 系统注册入口**：启动优先使用 Store AppUserModelId（`shell:AppsFolder`），不再默认直启 `WindowsApps/.../Codex.exe`；仅在系统入口不可用时回退到 exe 路径启动。
- **Windows 下 Codex 启动前置校验改为优先检查商店安装可用性**：检测到 Store 注册入口即可通过启动可用性校验，只有必要时才回退到可执行路径校验。

### 新增
- **Windows 下 Codex 启动日志新增策略可观测性**：日志会明确打印本次走的是 `system-store-entry` 还是 `exe-path`，并附带命中的 app id/路径与解析到的 pid，便于排障确认。

---
## [0.17.1] - 2026-03-20

### 新增
- **网络设置新增“全局代理”能力并支持注入到受管启动进程**：新增 `global_proxy_enabled`/`global_proxy_url`/`global_proxy_no_proxy`，并在 Cockpit 启动的平台应用与实例启动链路中按 macOS/Linux/Windows 注入代理环境变量。
- **GitHub Copilot 切号新增 OpenCode 联动与启动开关配置**：通用设置与快捷设置新增 GitHub Copilot 自动启动、OpenCode 登录覆盖、切号后自动重启 OpenCode 三项控制。

### 变更
- **OpenCode 自动重启开关现在与登录覆盖开关保持依赖一致**：在设置页和快捷设置中，关闭登录覆盖时会自动关闭对应的自动重启开关，覆盖 Codex 与 GitHub Copilot 两条切号链路。

---
## [0.17.0] - 2026-03-19

### 新增
- **Codex 切号新增可选的 OpenClaw 登录覆盖开关**：设置页与快捷设置新增 `openclaw_auth_overwrite_on_switch`；关闭时仅切换 Codex，不改写 OpenClaw 当前登录态。

### 变更
- **Codex 到 OpenClaw 的凭据同步升级为 `openai-codex:default` 全链路写入与校验**：切号时会更新 OpenClaw `auth-profiles.json`、清理旧 `openai-codex:*` 档案、同步候选路径，并校验账号/邮箱/过期时间与 Codex 凭据一致。
- **macOS 上 Codex 切号会同时更新 Keychain 的 `Codex Auth` 记录**：保证 external-cli/OpenClaw 读取到的凭据与当前 Codex 账号一致。
- **OpenClaw 同步后的运行态刷新增加重试机制以加快生效**：同步后会尝试执行 `secrets reload` 与 `gateway restart`，失败时自动再试一次并输出可诊断日志。

---
## [0.16.3] - 2026-03-19

### 新增
- **Kiro Enterprise/IdC 本机导入账号现已支持 AWS IAM Identity Center OIDC 刷新链路**：刷新时会优先走 OIDC token 刷新，并在失败时回退到 Kiro `refreshToken` 接口以保持兼容性。

### 变更
- **Kiro 套餐/订阅标签显示改为优先使用原始订阅值**：账号页与实例页优先展示 `plan_name`/`plan_tier`/usage 原始标签，保持与官方客户端命名一致。
- **Kiro 导入解析器现保留 Enterprise 刷新上下文字段**：JSON 导入会保留 `authMethod`、`login_option`、`startUrl`、`client_secret` 及相关 IdC 字段，保证导入后可持续刷新。
- **Kiro 流程说明多语言文案已按真实 Enterprise 刷新网络范围同步**：文案明确包含 AWS OIDC 调用及所需 OIDC 认证字段。

---
## [0.16.2] - 2026-03-19

### 新增
- **Codex API Key 账号现已支持自定义 Base URL 全链路能力并真实落盘**：API Key 添加/导入/切号链路可读写 `base_url`（含 `config.toml`），并保持账号元数据与本地 auth 文件一致。
- **Codex API Key 账号支持原位编辑凭据**：账号卡片/表格新增 API Key + Base URL 编辑入口，后端会一次性同步账号 ID/索引、当前账号映射与实例绑定。

### 变更
- **Codex 配额异常区域新增 OAuth 快速重授权入口**：当出现 `401`、`token_invalidated` 等令牌失效错误时，可直接从配额异常提示跳转重新 OAuth 授权。

### 修复
- **本机导入后的账号列表刷新稳定性提升**：共享 Provider、Codex、Qoder 与通用账号页在导入后增加短延时二次拉取，减少索引写入延迟导致的短暂不显示问题。
- **Trae 刷新失败诊断信息更完整**：当上游返回非 JSON 响应时，错误信息会附带状态码、关键响应头和安全截断的 body 预览，便于定位问题。

---
## [0.16.1] - 2026-03-18

### 新增
- **Codex 新增 API Key 账号全链路接入与导入能力**：新增 API Key 专用添加流程，支持在 `~/.codex/auth.json` 以 `auth_mode=apikey` 真实落盘，并兼容 JSON/本地导入 API Key 账号数据。

### 变更
- **Codex 账号卡片/表格已按 API Key 账号行为自适配**：API Key 账号支持行内重命名、展示掩码后的密钥信息、隐藏不支持的配额刷新操作，并提供直达 OpenAI Usage 页面的入口。
- **Codex 后端刷新与注入链路已对 API Key 账号跳过 OAuth 专属操作**：资料刷新、配额刷新与批量刷新调度会自动跳过 API Key 账号，同时保持切号与 auth 文件写入遵循本地真实落盘规则。
- **Codex 实例页账号选择器已与账号列表统一展示名逻辑**：API Key 账号重命名后会在实例选择中保持一致展示。

---
## [0.16.0] - 2026-03-18

### 新增
- **设置页新增跨平台账号迁移中心**：新增全平台一键导出/导入能力，采用统一 JSON Bundle 结构，并提供按平台导入进度与弹窗/文件两种导入交互。
- **核心界面新增平台分组与快捷切换体验**：新增可编辑平台分组（分组名、图标、默认子平台、子级元信息），并在页头切换器、仪表盘分组卡片、侧边栏与平台布局弹窗中统一支持分组入口。
- **新增本地持久化的分组自定义图标库**：支持在平台布局中上传、复用、删除分组/子级图标，并自动清理引用状态。

### 变更
- **托盘布局模型升级为“入口顺序 + 平台分组”**：托盘持久化数据新增 `orderedEntryIds` 与 `platformGroups`，托盘菜单渲染支持分组入口，同时保留手动排序与显示控制能力。
- **macOS 启动链路统一为 LaunchServices `open -n -a` 并补齐实例 PID 探测**：Antigravity/Codex/VS Code/CodeBuddy/CodeBuddy CN/WorkBuddy 以及 Qoder/Trae/Cursor/Kiro/Windsurf 的启动路径统一为一致语义，并在启动后按目标实例目录探测真实 PID。
- **多平台账号刷新链路新增延时重试提升稳定性**：Antigravity 配额刷新与多平台 token/资料/配额刷新在首次失败后会统一执行一次延时重试并记录统一日志，再返回失败结果。
- **Codex OAuth 添加账号支持原位重试令牌交换**：当 OAuth 进入令牌交换失败状态时，可直接在当前流程内重试 token exchange，无需重新走完整授权。
- **设置页、仪表盘与侧边导航样式升级以适配分组操作**：新增分组布局弹窗、分组切换器、账号迁移区域相关样式，并补齐全语言键支持。

---
## [0.15.1] - 2026-03-16

### 变更
- **Codex 自动切号与配额预警现已全链路支持 `primary_window`/`secondary_window` 双阈值**：后端配置归一、候选账号筛选、冷却键计算与刷新后检查现统一按双阈值判断；当存在更优账号时会优先自动切号再决定是否预警。
- **Codex 快捷设置新增双窗口阈值控制项**：自动切号与配额预警均可分别设置 `primary_window` 和 `secondary_window` 百分比阈值，并在界面中展示 OR 触发条件与弹窗阈值文本。
- **Codex 刷新调度在启用自动切号或预警时新增 60 秒当前账号刷新**：在不改变原有全量刷新周期的前提下，提高触发判断的及时性。
- **切号触发的默认实例启动现会透传 Antigravity 与 Codex 已保存的启动参数**：切号链路与 Codex 默认实例启动路径都会复用配置中的 `extra_args`，不再静默丢失。
- **Codex 刷新后状态同步补齐当前账号**：手动刷新与批量刷新后都会同步更新账号列表与当前账号，保证界面状态一致。
- **Windows 主窗口默认宽度调整为 1250**：为账号页与快捷设置内容提供更充足横向空间。

---
## [0.15.0] - 2026-03-15

### 新增
- **WorkBuddy 平台已完成全链路接入，并支持与 CodeBuddy CN 账号同步及实例管理**：新增 WorkBuddy 前后端模块、OAuth/Token/JSON/本机导入、基于本地凭证注入的切号、仪表盘/设置/快捷设置/托盘接入，以及与 CodeBuddy CN 的双向账号同步。
- **新增带 Token 保护的 HTTP 用量报表服务，并支持可选网页渲染**：新增可配置 `/report` 接口（`report_enabled` + 端口 + token），聚合多平台配额摘要，支持 Markdown/YAML 原始输出和 `render=true` 的 HTML 渲染视图。

### 变更
- **CodeBuddy、CodeBuddy CN 与 WorkBuddy 三端运行时链路已统一结构**：跨平台同步与注入链路迁移至 WorkBuddy 领域模块，统一命令注册，减少重复维护路径。
- **账号注入与实例启动链路的稳定性和提示信息已增强**：CodeBuddy/CodeBuddy CN/WorkBuddy 注入现增加写后校验，并在 keychain/state.vscdb 异常时提供更明确的“先手动登录”引导。
- **报表渲染可读性与数据新鲜度元信息已增强**：渲染视图分组展示更清晰，时间字段增加本地可读格式，并在元信息中明确展示延迟刷新与历史数据提示。

### 贡献者
- `PR #213` by `@lihongjing-2023`：WorkBuddy 平台接入与账号同步。
- `PR #212` by `@lovitus`：带 Token 的网页报表服务与渲染视图优化。

---
## [0.14.5] - 2026-03-15

### 变更
- **升级后的启动链路已减轻首屏负载并改为分阶段执行**：启动时现在会直接以内置 `en`/`zh-CN` 资源完成首帧渲染，不再阻塞等待异步语言包；自动刷新初始化延后执行；首页各平台预取改为分批触发；前端 vendor/update 相关 chunk 也做了更细分包，以降低较大版本升级后的首次启动卡顿。

### 修复
- **Codex 账号刷新现已支持后端失效 token 的自动恢复**：配额刷新与账号资料检查现在会识别 `401 token_invalidated`，主动执行一次 refresh_token 交换、落盘新 token，并重试官方 ChatGPT usage/account-check 接口，避免同一账号在官方客户端仍可使用时却在 Cockpit 中被误报为“需要重新登录”。
- **macOS 上启动 Codex 默认实例时不再错误复用已运行的隔离实例窗口**：当非默认 Codex 实例已经启动时，默认实例启动现在会强制通过 LaunchServices 新开一个应用实例，避免只激活已有隔离实例而没有真正打开默认配置目录。

---
## [0.14.4] - 2026-03-14

### 修复
- **Cursor 账号列表在索引缺失或损坏时可自动自愈**：列表读取会从 `cursor_accounts/*.json` 回收账号并重写 `cursor_accounts.json`，避免仅索引文件异常时出现“账号和标签都不显示”。
- **Cursor 账号列表读取现与写操作共用同一索引锁**：`list_accounts` 与导入/删除/更新链路串行化，降低并发访问索引时的竞态窗口。

---
## [0.14.3] - 2026-03-14

### 修复
- **多平台 OAuth 添加账号弹窗现已支持稳定重复登录**：Codex 与通用 Provider OAuth 流程在授权成功后、以及弹窗关闭/标签切换时，会立即清理会话与界面残留状态（授权链接、超时/轮询/手动回调状态），修复后续登录停在 `OAuth start` 后不再继续的问题。

---
## [0.14.2] - 2026-03-14

### 修复
- **GitHub Copilot 切号现已自动回退识别 VS Code Insiders 本地存储**：当标准版 VS Code 的 `Code` 用户目录不存在时，默认实例与 Token 注入链路现在会继续探测 `Code - Insiders` 下的 `state.vscdb`、Windows `Local State` 与 VS Code Safe Storage 凭据，恢复仅安装 Insiders 用户的切号能力。

---
## [0.14.1] - 2026-03-14

### 新增
- **CodeBuddy/CodeBuddy CN 资源包配额已支持在应用内直接展示**：账号卡片与表格现可按资源包展示额度数值、进度条和刷新/到期时间（含加量包），不再依赖“仅网页查看”。
- **CodeBuddy CN Token 导入现在会立即补全配额元数据**：Token 导入时会同步拉取 dosage/payment/user-resource 并落盘到配额与用量字段，创建账号后即可展示。

### 变更
- **配额刷新链路改为使用 IDE Access Token，不再依赖 Cookie 绑定**：后端刷新改为调用 `/v2/billing/meter/get-user-resource`（Bearer Token + 身份请求头），并将刷新失败写入账号状态供前端展示。
- **前后端已移除手动配额绑定旧链路**：CodeBuddy 与 CodeBuddy CN 均删除 cURL 重放绑定、清除绑定命令，以及对应的 service/type 入口。
- **多语言文案已按新配额模型统一更新**：移除过时的 Cookie 绑定流程文案，网络范围描述统一为“资源包配额刷新”，并为基础体验包/活动赠送包补齐所有支持语言键。
- **配额接口压缩响应兼容性提升**：`reqwest` 现启用 `brotli`/`deflate`/`zstd`，提升计费接口压缩响应解析稳定性。

### 修复
- **配额摘要与推荐逻辑不再依赖旧绑定状态**：资源摘要在 `quota_binding` 缺失时不再直接返回 `null`，避免 token 刷新后推荐逻辑退化为仅按回退规则排序。

---
## [0.14.0] - 2026-03-13

### 新增
- **CodeBuddy CN 平台前后端全链路接入**：新增 CodeBuddy CN 模型、命令、模块、OAuth 流程、账号页、服务、store、图标、导航、仪表盘/托盘接入与多开实例管理支持。
- **CodeBuddy CN 账号生命周期能力**：新增基于浏览器的 OAuth 登录、Token/JSON 导入、本地客户端导入、本地凭证注入切号、标签管理与账号导出。
- **OAuth 回调地址支持手动输入**：所有基于本地回调端口的 OAuth 流程现已支持手动输入回调地址，在自动回调不可用时可通过手动方式完成授权，提升受限网络环境下的授权成功率。

### 变更
- **CodeBuddy/CodeBuddy CN 配额展示简化**：配额信息改为在网页中查看，移除应用内复杂的不稳定配额查询表单。
- **共享运行时能力现已覆盖十一个平台**：仪表盘、托盘、设置页、快捷设置、自动刷新调度、配额预警偏好、导航与 README/文档现已统一纳入 CodeBuddy CN。

### 修复
- **Qoder 导入现已正确刷新账号列表**：Qoder 平台的 JSON 和 Token 导入在成功后现会正确刷新账号数据，修复导入后账号未即时显示的问题。
- **多个平台本机导入后现会同步刷新托盘摘要**：Antigravity、Codex、Cursor、Kiro、Windsurf、Trae 与 Qoder 在本机导入成功后，会立即同步更新托盘菜单，避免导入后共享运行时摘要仍停留旧状态。

---
## [0.13.0] - 2026-03-12

### 新增
- **Qoder 平台前后端全链路接入**：新增 Qoder 模型、命令、模块、官方 CLI Device Login 授权流程、本机/JSON 导入、账号页、服务、store、图标、导航、仪表盘/托盘接入，以及套餐原始值与配额展示。
- **Qoder 切号与多开实例管理能力**：新增 Qoder 账号注入、默认实例绑定、隔离多开目录、启动/停止/打开窗口/全部关闭控制，并补齐 macOS、Windows、Linux 的启动路径探测。
- **Trae 平台前后端全链路接入**：新增 Trae 模型、命令、模块、OAuth 流程、本机/JSON 导入、账号页、服务、store、图标、导航、仪表盘/托盘接入，以及套餐与用量展示。
- **Trae 切号与多开实例管理能力**：新增按 Trae 客户端真实落盘规则写回本地登录态、默认实例绑定、隔离多开目录、启动/停止/打开窗口/全部关闭控制，并补齐 macOS、Windows、Linux 的启动路径探测。

### 变更
- **共享运行时能力现已覆盖十个平台**：仪表盘、托盘、设置页、快捷设置、自动刷新调度、配额预警偏好、导航与 README/文档现已统一纳入 Qoder 与 Trae。
- **设置页新增 Qoder/Trae 路径与配额控制**：通用设置现可统一配置 Qoder/Trae 自动刷新、启动路径与配额预警。
- **Gemini 平台命名现统一为 Gemini Cli**：共享导航、设置与账号管理文案已统一调整为 `Gemini Cli`。

### 修复
- **待完成的 OAuth 授权会话现在会在弹窗或页面关闭时自动取消**：Provider OAuth 流程在弹窗关闭、标签切换或页面卸载时会主动取消进行中的授权会话，避免残留待处理状态。
- **Windows 更新流程现已保持安装器类型一致，避免重复桌面图标**：Windows 更新检查会按当前安装形态显式传入 updater target（`windows-*-nsis` / `windows-*-msi`），并将合并 `latest.json` 的 `windows-x86_64` 回退项对齐为 NSIS，避免安装器类型漂移导致更新时重复创建桌面快捷方式。

---
## [0.12.3] - 2026-03-11

### 修复
- **macOS 权限弹窗不再归因到 Cockpit Tools**：macOS 上所有 IDE 启动（Codex、VS Code、CodeBuddy）统一改为通过 `open -a`（LaunchServices）方式启动，不再直接执行二进制文件，使 macOS TCC 权限弹窗（如"访问下载文件夹"）正确归因到被启动的 IDE 而非 Cockpit Tools。多开实例的 PID 跟踪通过启动后进程轮询实现，不受影响。

---
## [0.12.2] - 2026-03-11

### 新增
- **Linux 包安装现已支持应用内托管更新**：新增 `.deb`/`.rpm` 运行时识别、签名包下载、进度回传与提权安装链路，使 Linux 包管理器安装场景可直接在 Cockpit 内完成更新。
- **Antigravity 账号页现已支持本地账号分组**：在 Antigravity 账号页新增本地文件夹式账号分组，支持创建/重命名/删除、批量移入移出、分组浏览与按分组刷新配额。

### 变更
- **Windsurf 套餐展示现已识别更多官方层级**：Windsurf 账号卡片、徽标与筛选现可根据远端套餐信息和 teams-tier 元数据解析 Trial、Teams、Teams Ultimate 与 Pro Ultimate。
- **Linux 更新流程现已与包管理安装语义对齐**：对受包管理器接管的 `.deb`/`.rpm` 安装跳过后台静默下载，并在侧边栏和更新弹窗中展示授权与安装进度状态。
- **配额预警原生通知现已跟随界面语言**：后端通知文案改为从语言键解析，并统一覆盖 Codex、GitHub Copilot、Windsurf、Kiro、Cursor、Gemini 与 CodeBuddy。

### 修复
- **唤醒任务新建/测试前会先校验运行时可用性**：当唤醒运行时未配置时，“新建任务”和“测试任务”会先中断并复用现有缺路径引导。
- **设置与恢复类弹窗现在会直接展示操作失败原因**：快捷设置中的配置/路径操作失败、文件损坏弹窗的“打开文件夹”失败，以及全局弹窗动作失败，都会在界面内直接显示错误。
- **macOS 配额预警通知不再维持点击等待循环**：原生通知改为发出即返回，避免通知发送后额外维持后台能耗。

---
## [0.12.1] - 2026-03-10

### 新增
- **Codex 账号资料支持官方 account-check 接口回填**：新增 `refresh_codex_account_profile` 前后端链路，用于拉取并持久化 `account_name` 与 `account_structure`。
- **Codex 团队类账号自动资料补全机制**：针对缺少结构/名称信息的账号，新增 store 侧后台资料补全，并带并发去重与 5 分钟重试间隔。

### 变更
- **Codex 账号卡片与表格新增“账号上下文”展示**：账号行会基于结构、套餐类型与 workspace 元数据展示“个人账户”或团队/工作区名称。
- **Codex 实例页配额预览遵循 Code Review 可见性偏好**：当偏好设置隐藏 Code Review 配额后，实例页徽标、搜索文本与配额预览会一致隐藏该项。

---
## [0.12.0] - 2026-03-10

### 新增
- **CodeBuddy 平台前后端全链路接入**：新增 CodeBuddy 模型、命令、模块、OAuth 流程，以及前端账号页、服务、store、图标、导航、仪表盘接入和共享平台元信息。
- **CodeBuddy 账号生命周期能力**：新增基于浏览器的 OAuth 登录、Token/JSON 导入、配额查询与绑定、周期/资源包/加量包展示、标签编辑、批量操作、账号导出与本地凭证注入切号。
- **CodeBuddy 多开实例管理能力**：新增 CodeBuddy 实例 store 与命令，支持独立用户目录、账号绑定、实例创建/编辑/删除、启动/停止、打开窗口与全部关闭。
- **CodeBuddy 配额绑定支持完整 cURL 重放**：新增 `get-user-resource` 的 `Copy as cURL (bash)` 流程，按原始请求（方法/请求头/请求体）重放查询，提升绑定准确性并持久化归一后的配额绑定参数。

### 变更
- **CodeBuddy 已接入共享运行时配置面**：新增 CodeBuddy 启动路径探测、自动刷新间隔、配额预警设置、快捷设置、托盘摘要与全局刷新调度接入。
- **Cursor 切号后会尝试自动拉起默认实例**：切换 Cursor 账号时会同步更新默认实例绑定账号，并立即尝试启动 Cursor；若缺少启动路径，仍沿用统一的缺路径引导流程。
- **Codex 配额展示改为单列聚合布局**：账号页表格会在同一列中展示全部配额窗口，并支持通过偏好设置控制是否显示 Code Review 配额。

### 修复
- **Codex 切号已支持 `CODEX_HOME` 环境变量**：Codex 登录文件读写现在会遵循自定义 `CODEX_HOME`（含带引号的环境变量值），并在写入失败时输出包含目标路径的错误信息，便于定位问题。
- **非主窗口不再继承主窗口的关闭拦截逻辑**：非主窗口现在会直接关闭，不再被错误套用托盘最小化/关闭确认流程。
- **Windsurf Safe Storage 密钥查找改为平台专用**：macOS 与 Linux 下的凭证处理不再回退到通用 VS Code Safe Storage 条目，减少注入时读取错误密钥的概率。

---
## [0.11.3] - 2026-03-10

### 修复
- **Gemini OAuth 应用身份已对齐官方 Gemini CLI**：Gemini 授权流程改用官方 Gemini CLI OAuth 客户端凭据，授权页展示与 `Gemini Code Assist and Gemini CLI` 保持一致，不再显示旧应用身份。
- **Gemini 网页 OAuth 回调流程已对齐官方行为**：浏览器授权 URL 使用官方参数集合（移除额外 `prompt=consent`），回调结果改为跳转到官方 Gemini 授权成功/失败页面。

---
## [0.11.2] - 2026-03-08

### 修复
- **Antigravity 默认实例的自定义启动参数恢复生效**：默认实例启动时会解析并传递已保存的 `extra_args` 到实际启动命令。
- **可从 Cockpit 设置正确下发远程调试参数**：`--remote-debugging-port=9333` 这类参数在默认实例启动链路中不再被静默丢弃。

---
## [0.11.1] - 2026-03-08

### 变更
- **Gemini 导入后立即校验 token 状态**：JSON 导入和本地 `~/.gemini` 导入会在导入完成后立即触发一次 token 刷新，确保账号元数据导入后即同步到最新状态。
- **Gemini 刷新结果统一落盘状态字段**：刷新失败会写入账号 `status=error` 与 `status_reason`，刷新成功会清空错误状态，保证状态展示与真实刷新结果一致。

### 修复
- **Gemini 刷新失败不再只记录日志**：手动刷新或批量刷新失败时，失败结果会持久化到账号状态字段，界面可稳定感知错误状态。

---
## [0.11.0] - 2026-03-08

### 新增
- **Gemini 平台前后端全链路接入**：Tauri 侧新增 Gemini 模型/命令/模块/OAuth，前端新增账号页、服务、store、图标、导航与平台元信息接入。
- **Gemini 账号生命周期能力**：新增 OAuth 登录、Access Token/JSON 导入、本地 `~/.gemini` 导入、配额刷新、标签管理、账号导出与本地凭证注入切号。
- **Gemini 多开实例管理能力**：新增 Gemini 实例 store/命令，支持默认与自定义目录配置、账号绑定注入、启动命令生成、终端一键执行。
- **Gemini 设置与运行时接入**：新增 `gemini_auto_refresh_minutes`、Gemini 配额预警开关/阈值配置，并接入设置页、快捷设置、自动刷新调度、仪表盘与托盘/运行时链路。
- **Gemini 文档与多语言覆盖**：更新中英文 README，并补齐 Gemini 账号总览、实例流程、切号、导入与说明文案相关语言键。

### 变更
- **切号成功后支持平台扩展动作**：`useProviderAccountsPage` 新增注入成功回调，Gemini 账号总览接入后可在切号成功后立即弹出启动命令弹窗。
- **Gemini 启动语义与默认实例对齐**：默认实例启动命令改为直接 `gemini`；自定义实例保持 `GEMINI_CLI_HOME=... gemini`。
- **Gemini 启动弹窗标题改为通用语义**：启动弹窗标题由“多开实例”调整为“启动实例”。
- **Gemini 实例页按实际能力简化**：移除 Gemini 实例列表中的运行状态/PID/关闭能力预期，并将默认实例编辑行为与真实启动语义对齐。
- **共享平台与展示链路扩展 Gemini**：Gemini 已接入共享平台类型/导航/元信息，并在通用账号展示层统一 Gemini 套餐/配额展示口径。

---
## [0.10.1] - 2026-03-07

### 新增
- **Cursor 平台全链路接入**：新增 Cursor 账号管理与多开实例完整能力，覆盖后端命令/模块、前端页面/store/service、侧边导航、平台页签、仪表盘卡片与托盘集成。
- **Cursor 账号管理能力集**：新增 OAuth（PKCE）、Token/JSON 导入、本地 `state.vscdb` 导入、账号导出，以及向 Cursor profile 数据回写注入实现切号。
- **Cursor 配额与订阅数据链路**：新增官方接口刷新流程（`usage-summary`、`GetUserMeta`、Stripe profile），支持 Total/Auto/API/On-Demand 指标与团队额度解析。
- **Cursor 设置与自动化调度接入**：在设置页与快捷设置新增 Cursor 路径、自动刷新间隔、配额预警开关/阈值，并纳入全局自动刷新调度。
- **跨平台实例“使用已有目录”模式**：Antigravity/Codex/GitHub Copilot/Windsurf/Kiro/Cursor 全部新增 `existingDir` 初始化模式，可直接登记本地已存在目录为实例。
- **设备指纹预览自动补齐支持**：新增“预览当前指纹缺失字段自动生成并回写”能力，前端支持字段级自动生成标识。

### 变更
- **应用主框架全局接入 Cursor**：新增 Cursor 路由/页面挂载、仪表盘“当前账号/推荐账号”卡片动作、平台类型与导航类型扩展，以及平台元信息接入。
- **系统托盘启动与渲染链路升级**：托盘改为先秒开骨架菜单，再异步加载完整账号菜单；同时接入 Cursor 托盘摘要与平台排序。
- **启动阻塞路径进一步收敛**：设置合并与日志清理改为后台线程执行；i18n 启动改为预置 `en` 资源并通过加载壳层完成初始化。
- **设置页/快捷设置/配置结构扩展**：新增 `cursor_auto_refresh_minutes`、`cursor_app_path`、`cursor_quota_alert_enabled`、`cursor_quota_alert_threshold`，并补齐兼容性归一逻辑。
- **实例流程跨平台增强**：Antigravity/Codex/GitHub Copilot/Windsurf/Kiro/Cursor 在前后端统一支持并校验 `existingDir` 创建模式。
- **Codex 账号展示增强**：新增身份元数据解析（`Signed in with <provider>` + ID），并在卡片/表格新增 Code Review 配额指标。
- **套餐徽标样式统一**：引入共享 `--plan-*` 设计变量，账号页与实例页统一复用同一套套餐颜色映射。
- **本地化覆盖范围扩展到 Cursor 新增流程**：已补齐多语言下 Cursor 页面、OAuth/导入、实例 `existingDir` 模式、快捷设置与配额展示相关文案键。

### 修复
- **平台账号去重准确性提升**：GitHub Copilot 与 Windsurf 改为按 `github_id` 去重；Kiro 在 `user_id` 存在性冲突场景不再按邮箱误合并。
- **修复 Kiro 账号去重问题**：修复 Kiro 账号合并链路（`b045e1e2`）中“不同用户身份因同邮箱被错误合并并导致账号覆盖”的问题。
- **设备指纹预览数据一致性提升**：读取当前 profile 时会自动补齐缺失指纹字段，返回自动生成字段标记，并尝试回写本地存储。
- **Cursor 缺路径引导链路补齐**：`APP_PATH_NOT_FOUND:cursor` 已完整纳入统一路径设置/重置/探测/重试流程。

---
## [0.10.0] - 2026-03-07

### 新增
- **Cursor 平台全链路接入**：新增 Cursor 账号管理与多开实例完整能力，覆盖后端命令/模块、前端页面/store/service、侧边导航、平台页签、仪表盘卡片与托盘集成。
- **Cursor 账号管理能力集**：新增 OAuth（PKCE）、Token/JSON 导入、本地 `state.vscdb` 导入、账号导出，以及向 Cursor profile 数据回写注入实现切号。
- **Cursor 配额与订阅数据链路**：新增官方接口刷新流程（`usage-summary`、`GetUserMeta`、Stripe profile），支持 Total/Auto/API/On-Demand 指标与团队额度解析。
- **Cursor 设置与自动化调度接入**：在设置页与快捷设置新增 Cursor 路径、自动刷新间隔、配额预警开关/阈值，并纳入全局自动刷新调度。
- **跨平台实例“使用已有目录”模式**：Antigravity/Codex/GitHub Copilot/Windsurf/Kiro/Cursor 全部新增 `existingDir` 初始化模式，可直接登记本地已存在目录为实例。
- **设备指纹预览自动补齐支持**：新增“预览当前指纹缺失字段自动生成并回写”能力，前端支持字段级自动生成标识。

### 变更
- **应用主框架全局接入 Cursor**：新增 Cursor 路由/页面挂载、仪表盘“当前账号/推荐账号”卡片动作、平台类型与导航类型扩展，以及平台元信息接入。
- **系统托盘启动与渲染链路升级**：托盘改为先秒开骨架菜单，再异步加载完整账号菜单；同时接入 Cursor 托盘摘要与平台排序。
- **启动阻塞路径进一步收敛**：设置合并与日志清理改为后台线程执行；i18n 启动改为预置 `en` 资源并通过加载壳层完成初始化。
- **设置页/快捷设置/配置结构扩展**：新增 `cursor_auto_refresh_minutes`、`cursor_app_path`、`cursor_quota_alert_enabled`、`cursor_quota_alert_threshold`，并补齐兼容性归一逻辑。
- **实例流程跨平台增强**：Antigravity/Codex/GitHub Copilot/Windsurf/Kiro/Cursor 在前后端统一支持并校验 `existingDir` 创建模式。
- **Codex 账号展示增强**：新增身份元数据解析（`Signed in with <provider>` + ID），并在卡片/表格新增 Code Review 配额指标。
- **套餐徽标样式统一**：引入共享 `--plan-*` 设计变量，账号页与实例页统一复用同一套套餐颜色映射。
- **本地化覆盖范围扩展到 Cursor 新增流程**：已补齐多语言下 Cursor 页面、OAuth/导入、实例 `existingDir` 模式、快捷设置与配额展示相关文案键。

### 修复
- **平台账号去重准确性提升**：GitHub Copilot 与 Windsurf 改为按 `github_id` 去重；Kiro 在 `user_id` 存在性冲突场景不再按邮箱误合并。
- **设备指纹预览数据一致性提升**：读取当前 profile 时会自动补齐缺失指纹字段，返回自动生成字段标记，并尝试回写本地存储。
- **Cursor 缺路径引导链路补齐**：`APP_PATH_NOT_FOUND:cursor` 已完整纳入统一路径设置/重置/探测/重试流程。

---
## [0.9.17] - 2026-03-06

### 变更
- **Windows 下 Codex 路径重置探测改为“商店包优先 + 全盘符扫描”**：重置时优先扫描 `C:\Program Files\WindowsApps\OpenAI.Codex_*\app\Codex.exe` 与 `<盘符>:\WindowsApps\OpenAI.Codex_*\app\Codex.exe`，按最高版本包优先命中；若未命中再回退到 Appx `InstallLocation\app\Codex.exe`。
- **移除应用启动时自动路径探测**：应用不再在启动阶段自动执行路径探测；路径探测改为仅在用户主动重置或启动链路触发缺路径时执行。
- **公告触达继续保持非打扰模式**：新公告仍仅通过未读红点提示，不再强制弹出详情弹窗。

### 修复
- **修复 Windows 下 Codex 默认启动不可用问题**：补齐 Windows 默认实例启动链路，配置 `codex_app_path` 后可正常执行启动与切号后拉起。
- **修复实例停止后操作按钮仍灰置的问题**：实例关闭后，行内操作按钮会在当前页即时恢复可用，无需切页再返回。
- **修复 0.9.16 引入的 macOS Codex 多开回归**：回退 0.9.16 对 Codex 单实例限制在 macOS 上带来的影响，恢复到 v0.9.15 的多开启动与控制语义。
- **修复 macOS 下 Codex 实例 PID 识别缺失**：恢复基于实例目录的进程匹配链路，使运行中的 Codex 实例可正确识别并展示 PID。

---
## [0.9.16] - 2026-03-05

### 新增
- **新增 Windows Codex 桌面端控制管理能力**：首次支持在 Windows 下对 Codex 桌面进程执行启动、关闭、聚焦和重启（先关闭再打开）控制。
- **新增 Windows 商店版 Codex 路径自动探测**：通过 `OpenAI.Codex` 的 Appx `InstallLocation\\app\\Codex.exe` 自动解析可执行路径，提升微软商店安装场景下的识别成功率。

### 变更
- **公告触达改为非打扰模式**：新公告不再强制弹出详情弹窗，仅通过公告入口红点提示未读，用户可按需手动打开查看。
- **Codex 账号身份信息改为紧凑单行展示**：Codex 账号卡片/表格统一展示 `{{provider}} 登录 | 账号ID: <id>`，并移除默认空间名称显示以减少界面占用。
- **Codex 代码审查配额标签固定英文**：代码审查配额指标显示统一为 `Code Review`，不再随语言切换翻译。
- **Windows Codex 控制模型与官方单实例锁对齐**：在 Codex 实例管理中明确标注多开暂不支持，并提供原因说明文案；相关操作收敛为单实例控制语义。

---
## [0.9.15] - 2026-03-04

### 变更
- **发版“对外可见”时机改为等待整条流水线完成**：发布工作流现在先创建 Draft Release，只有在矩阵构建、合并版 updater `latest.json`、`SHA256SUMS` 上传、Homebrew Cask 更新全部成功后，才会将该版本发布为 `latest`。这样可避免产物尚未齐全时应用内提前弹出新版本提示。

---
## [0.9.14] - 2026-03-04

### 新增
- **侧边栏悬浮快捷更新入口**：在侧边栏上方新增紧凑更新按钮，状态随更新流程实时切换（`更新` / `下载中 %` / `重启`），无需反复回到设置页也可完成更新操作。

### 变更
- **更新检查/下载重试与失败处理加强**：为更新检查与下载加入指数退避重试和可重试错误分类，界面与日志同步展示重试状态，并对错误详情做脱敏展示。
- **更新检查基准周期改为 1 小时**：默认检查周期改为 1 小时；读取历史设置时会将旧的 6 小时/24 小时周期自动迁移为 1 小时。
- **macOS 桌面客户端进程探测改为 `ps` 优先**：Antigravity/VS Code/Codex/Kiro/Windsurf 的进程发现改为优先使用命令行探测，并保留 `.app` 根路径匹配，减少触发受保护目录访问，同时提升多开实例场景下的进程匹配稳定性。
- **Antigravity 在 macOS 的多开启动语义收紧**：非默认实例改为使用 `open -n` 启动且不再附加 `--reuse-window`，并在启动后增加目标 `user-data-dir` 的短轮询（最多 6 秒）以确认实例 PID。
- **Codex 配额刷新会回写订阅标识到账号索引**：`plan_type` 现在会从刷新后的 `id_token` 与配额接口响应同步回写到账号摘要索引，无需重新导入即可刷新订阅徽标。

### 修复
- **更新弹窗重复打开时可保持“已下载待重启”状态**：同一版本已下载后再次打开更新弹窗，将继续保持“可重启生效”而非回退为“立即更新”。
- **手动弹窗“立即重启”改为复用统一更新应用链路**：更新弹窗中的“立即重启”与静默更新走同一安装/重启流程，避免不同入口状态不一致。
- **修复 macOS 下 GitHub Copilot 实例注入因 Safe Storage 优先级错误导致的解密失败**：VS Code/Copilot 注入链路改为优先使用 Code 系列 Keychain 项，再回退 Antigravity 项，避免解密现有 `github.auth` 时出现 `AES-CBC decryption failed: Unpad Error`。

---
## [0.9.13] - 2026-03-03

### 新增
- **升级后更新说明本地缓存**：新增 `pending_update_notes.json` 持久化缓存，已下载更新的说明可在重启后离线展示，不再依赖在线 changelog 拉取。

### 变更
- **更新检查来源完全统一到 Tauri Updater 元数据**：移除后端 GitHub Releases API 轮询版本判断，更新可用性仅基于 updater 端点（`latest.json`）返回结果。
- **手动/静默更新说明统一读取 updater 发布内容**：更新弹窗与静默下载前缓存改为直接解析 updater `notes` 中的双语分段；仅在 updater 流程失败时保留浏览器下载兜底。

---
## [0.9.12] - 2026-03-03

### 新增
- **后台自动更新模式（零干预）**：在 `设置 > 通用` 新增“后台自动更新”选项。开启后应用按常规检测新版本，在后台静默下载更新包，准备完成后提示重启生效。
- **版本跳跃后的更新日志弹窗**：新增启动时版本跳跃检测（基于本地记录的 `last_run_version`）。升级后首次启动会自动弹出“新版本特性”窗口。
- **静默更新就绪提示 Toast**：后台下载完成后会在右下角显示更新就绪提示，提供“稍后”和“立即重启”操作。

### 变更
- **桌面端更新链路迁移到 Tauri Updater**：接入 updater/process 插件并启用 updater 产物与发布端点配置，应用内更新改为基于签名元数据执行。
- **手动更新弹窗支持应用内下载/安装进度**：更新弹窗新增下载进度、状态和错误展示；当 updater 流程失败时自动回退到 GitHub Release 页面下载。
- **更新设置持久化时序加强**：自动更新开关的读取/保存流程避免首帧渲染覆盖旧值，仅在确认状态变化后写回配置。
- **更新相关多语言文案覆盖补齐**：在全部已支持语言中补充更新开关、下载进度、重启提示、版本跳跃提示等键值。

---
## [0.9.11] - 2026-03-03

### 修复
- **修复 Windows 在中文路径下切号/启动链路崩溃**：Windows 扩展路径归一逻辑改为 Unicode 安全前缀处理，避免在非 ASCII 路径上触发 `byte index is not a char boundary` panic。

### 变更
- **账号验证“立即检测”默认模型优先选择 Flash**：模型默认选择改为优先匹配显示名称中包含 `flash`（不区分大小写）的第一项；未命中时回退到列表第一项。

---
## [0.9.10] - 2026-03-02

### 变更
- **唤醒链路稳定性进一步对齐官方客户端**：官方 LS 启动等待窗口提升到 60 秒，client-gateway 轨迹轮询窗口同步提升到 60 秒，并将 `app_data_dir` 调整为官方风格的 IDE 级目录（默认 `antigravity`，可通过 `AG_WAKEUP_OFFICIAL_LS_APP_DATA_DIR` 覆盖）。
- **唤醒网关的错误处理语义对齐长任务执行场景**：当轨迹状态仍为 `RUNNING` 时，中间出现的 `errorMessage` 不再立即判失败，而是继续轮询等待最终结果。
- **Antigravity 套餐徽标展示在多入口统一**：通过 `getAntigravityTierBadge` 统一档位徽标映射，并在账号页与验证详情页复用同一展示口径。
- **多开实例账号下拉顺序与账号页排序逻辑全平台对齐**：Antigravity / Codex / GitHub Copilot / Windsurf / Kiro 的实例账号下拉统一复用各自账号页排序规则，避免页面间顺序漂移。
- **全平台账号页排序偏好支持重启恢复**：所有账号页的排序字段与排序方向已持久化到本地，应用重启后自动恢复。
- **实例列表排序偏好按平台持久化**：实例列表排序字段（`createdAt` / `lastLaunchedAt`）与排序方向按平台类型分别持久化，重启后不再重置实例排序。

### 修复
- **唤醒链路对上游临时失败新增一次自动重试**：对于 `AG_WAKEUP_ERROR_JSON` 中 `temporary`/HTTP 5xx 类错误，增加延迟后的一次自动重试，再决定最终失败。
- **账号验证“查看详情”现在可直接看到后端错误文案**：详情列表新增 `lastMessage` 渲染（含截断），可直接看到如 `Agent execution terminated due to error.` 的用户态错误信息。
- **唤醒任务页账号邮箱脱敏覆盖补齐**：任务卡片、测试账号选择、历史记录与调试信息复制文本均统一走隐私脱敏展示。

---
## [0.9.9] - 2026-03-02

### 新增
- **内置功能使用手册页面**：新增独立 `manual` 页面，按场景组织快速开始、仪表盘、平台账号、多开实例、设备指纹、唤醒/验证、设置、导入导出与排障等章节，并支持关键词搜索与章节展开/收起。
- **关键页面增加一键查阅手册入口**：在仪表盘/页头及各平台账号空状态（Antigravity、Codex、GitHub Copilot、Windsurf、Kiro）新增手册跳转入口，降低首次上手成本。

### 变更
- **手册页面支持“就地跳转操作”快捷动作**：各章节可直接跳转到对应功能页（仪表盘、Antigravity、Codex、GitHub Copilot、Windsurf、Kiro、多开实例、设备指纹、唤醒任务、验证、设置），并可在手册内直接打开平台布局。
- **手册多语言覆盖扩展到全部语言包**：在所有已支持语言中补齐 `manual.*` 与 `nav.manual` 键，确保手册与导航文案在多语言环境下保持一致。

### 修复
- **修复 macOS 下启动第三方应用时权限弹窗归因到 Cockpit 的问题**：从 Cockpit 启动 Antigravity/Codex/GitHub Copilot/Windsurf/Kiro 时，受保护目录权限弹窗被归因为 Cockpit 的情况显著减少。

---
## [0.9.8] - 2026-03-01

### 变更
- **四平台账号页（Codex/GitHub Copilot/Windsurf/Kiro）重构为共享 Provider Hook**：引入 `useProviderAccountsPage` 与通用数据抽取工具，统一共享状态/动作并减少页面重复实现。
- **账号导出交互统一**：新增 `ExportJsonModal` + `useExportJsonModal`，统一批量导出与单账号导出流程，并补充导出弹窗“打开下载目录”能力所需权限。
- **OAuth 文案与标签在多语言下统一为“OAuth 授权”语义**：账号添加页的 OAuth 标签和说明文案统一收口。
- **OAuth 登录后增加“尽力刷新”链路**：新增授权完成后的配额/令牌刷新流程（Antigravity 配额、GitHub Copilot/Windsurf/Kiro 令牌快照），降低授权后页面短时旧数据概率。
- **路径缺失引导支持重试上下文**：`app-path-missing` 事件支持 `switchAccount` / `default` / `instance` 重试意图，保存路径后可继续原始动作。
- **唤醒链路改为严格无回退模式**：执行唤醒必须提供 `project_id`；模型拉取失败/为空不再回退硬编码模型；调度不再在时间窗外使用 `fallback_times` 补跑。
- **“打开实例窗口”语义收紧**：窗口聚焦失败时直接返回错误，不再自动拉起新进程。
- **账号身份匹配进一步收紧**：Antigravity/Codex 账号匹配移除“仅 email 合并”回退；Codex -> OpenCode 写入不再从 token 临时推导 `account_id`。
- **Windsurf/Kiro 的 token/刷新策略收紧**：Windsurf token 导入仅接受 API Key 或 Firebase JWT；Kiro 刷新失败或缺少 `refresh_token` 时直接报错，不再回退旧快照。
- **命令追踪链路补齐并改为按需开启**：补充命令 EXEC/RESULT/SPAWN 跟踪点，默认关闭，仅在 `COCKPIT_COMMAND_TRACE=1` 时开启。
- **Quick Settings 配额预警控件抽取复用**：将重复的配额预警开关/阈值 UI 收敛到共享渲染逻辑。

### 修复
- **启动路径校验前置到切换/启动执行前**：路径缺失或无效时先返回 `APP_PATH_NOT_FOUND:*`，避免先执行关闭/注入/重启再失败。
- **Windows 聚焦流程修复 `$PID` 只读变量问题**：聚焦脚本改为独立 PID 变量并加入 `MainWindowHandle` 轮询等待，降低窗口句柄尚未就绪导致的失败。
- **Windows 路径匹配稳定性增强**：补齐 `\\?\` / `\\?\UNC\` 扩展前缀归一、环境变量展开、命令行可执行路径提取兜底，以及 sysinfo 回退诊断日志。
- **路径缺失引导弹窗样式与设置弹窗统一**：复用 quick settings/settings 共享样式，统一标题区、路径区、图标与字体布局表现。
- **修复后端集成链路中的 Rust warnings**：清理 token model 与 wakeup gateway 预留代码路径中的告警点，保持该分支编译告警收敛。

---
## [0.9.7] - 2026-02-28

### 修复
- **修复 macOS 反复弹出隐私权限请求的问题**：将 `sysinfo` 进程扫描由"读取全字段（含 `cwd`/`environ`/`root`）"改为仅按需读取 `exe` 和 `cmd`，避免遍历其他进程的受保护目录，从根源消除 macOS 上反复弹出"访问音乐/照片/文稿"权限提示的问题。

### 变更
- **Kiro/Windsurf 配额周期重置时间改为"相对 + 绝对"格式**：重写 `formatKiroResetTime`，改为输出 `Xd Xh (MM/DD HH:mm)` 风格，与其他平台重置时间展示保持一致；不足一天时改为显示小时/分钟，不再向下取整到天。
- **Kiro/Windsurf 配额周期剩余时间不足 1 天时改为显示小时**：剩余时间不足 24 小时时，展示文案切换为"{{hours}} 小时后重置"，不再出现"剩余 0 天"。
- **Kiro 仪表盘卡片配额展示精简**：移除 Dashboard 中 Kiro mini 卡片内多余的 used/total 与 left 行，改为直接展示 `resetText` 或 `cycleText`，与 Windsurf 卡片风格保持一致。

---
## [0.9.6] - 2026-02-28


### 变更
- **五平台账号展示口径在多入口统一**：新增公共展示层，统一计算显示名、套餐标签（保留原始值）、配额指标、重置文案与用量摘要，并在仪表盘、账号列表、实例列表复用（Antigravity / Codex / GitHub Copilot / Windsurf / Kiro），减少多处改动导致的不一致。
- **Token 导入交互补充明确示例**：全语言更新 token/JSON 输入占位提示，并补充新增/导入弹窗中的格式说明样式，提升可读性。

### 修复
- **Antigravity 托盘配额行改为按分组配置展示**：托盘子菜单按显示分组聚合（含模型别名兼容），与页面分组卡片保持一致，不再按原始模型逐条直出。
- **分组配置变更后托盘可即时刷新**：保存/修改/删除/排序分组后会立即刷新托盘菜单，无需重启或额外手动操作。
- **账号删除后重新添加可复用历史指纹绑定**：新增“已删除账号指纹映射”持久化与查找逻辑，删除再添加时在可用场景下复用原指纹关联。
- **Antigravity 订阅标签显示统一为标准档位**：实例与账号页统一展示 `PRO/ULTRA/FREE/UNKNOWN`，不再出现原始 `subscription_tier` 字符串混用。
- **Antigravity Token 示例说明区改为完整走多语言键**：移除该区域硬编码中文文案，语言切换时展示保持一致。

## [0.9.5] - 2026-02-28

### 修复
- **Windows 唤醒不再弹出黑色终端窗口**：为官方 Language Server 启动及唤醒相关 Windows 命令探测（`netstat`、`where.exe`）补齐隐藏窗口标记。
- **本地唤醒网关的间歇性传输失败可自动恢复一次**：新增本地健康检查预热、传输错误分类，并在可恢复的本地连接/TLS/超时错误下自动清理网关地址缓存后重试一次。
- **本地网关请求强制绕过系统代理并统一回环地址**：本地网关/官方 LS 客户端启用 `no_proxy`，并将本地地址归一为 `127.0.0.1`，降低代理或拦截导致的请求失败。

### 变更
- **账号验证文案与操作统一切换为“检测”语义（全语言）**：新增并使用 `wakeup.verification.actions.runCheckNow`，更新 run-hint 文案，验证页主按钮与弹窗标题同步对齐。
- **GitHub Copilot 多开实例配额展示新增 Premium 维度**：实例账号配额摘要现同时展示 Inline、Chat、Premium 使用百分比。

---
## [0.9.4] - 2026-02-27

### 修复
- **Linux `.deb` 在部分环境下出现白屏/空白窗口**：默认关闭透明窗口（`transparent: false`），并在 Linux 侧补充 WebKitGTK 运行时兜底（未设置时自动注入 `WEBKIT_DISABLE_DMABUF_RENDERER=1`），提升渲染稳定性。
- **Windows 切号流程在探测 Antigravity 进程时可能卡住**：为 PowerShell 进程探测增加 5 秒超时，并在超时/失败后自动回退到 `sysinfo` 扫描，避免阻塞切号链路。
- **“切号成功但启动失败”现在可前端可见**：当账号落盘切换完成但启动 Antigravity 失败时，后端会返回明确错误信息，前端可直接提示失败原因。
- **全平台官方 LS 解析统一改为基于已配置 Antigravity 启动路径**：唤醒/验证在 Windows/macOS/Linux 均从 `antigravity_app_path` 推导 LS（按平台扩展目录与文件名优先级匹配）；若缺失则统一返回 `APP_PATH_NOT_FOUND:antigravity`，在执行前触发现有路径设置引导。

---
## [0.9.3] - 2026-02-27

### 修复
- **Linux（含 Arch）AppImage 因静态资源绝对路径导致空白页**：Vite 构建产物改为相对资源路径（`base: "./"`），确保 AppImage 内可正确加载前端 JS/CSS。

### 变更
- **发布流程文档口径对齐当前完成标准**：更新 `docs/release-process.md`，将“远端分支 + 远端标签”定义为发版完成；GitHub Actions 与发布资产更新改为发版后异步流程。

---
## [0.9.2] - 2026-02-27

### 变更
- **Windows 唤醒/验证改为执行前预检运行时就绪状态**：为“立即测试”和“批量验证”增加前后端预检门禁，先校验官方 LS 是否可用，不再在请求发出后才失败。
- **Windows 官方 LS 路径改为基于已配置的 Antigravity 启动路径推导**：运行时从 `antigravity_app_path` 推导 `resources/app/extensions/antigravity/bin` 下的 LS，按固定文件名优先级匹配，并在同目录内兜底匹配。

### 修复
- **缺失路径引导前置触发**：当 Windows 缺少 Antigravity 路径或 LS 二进制时，会在执行唤醒前直接触发现有 `app-path-missing` 引导，避免网关启动后出现 500 才报错。

---
## [0.9.1] - 2026-02-27

### 新增
- **桌面端公告系统**：新增完整公告能力链路，包含 Tauri 公告命令、前端 store/service/type 与公告中心 UI（列表/详情弹窗、未读角标、已读标记、刷新、弹窗公告、图片预览、tab/url/command 动作处理）。
- **开发调试公告源控制**：新增本地覆盖文件支持（`~/.antigravity_cockpit/announcements.local.json`）与 Debug 工作区公告源（`announcements.json`），用于 `npm run tauri dev` 调试，同时持久化已读记录与缓存文件。
- **仓库级公告种子文件**：新增仓库根目录 `announcements.json`，内置欢迎公告与反馈动作，便于本地调试并与远端公告源结构保持一致。

### 变更
- **普通用户公告策略改为远端优先**：非开发/运行时构建默认不再读取本地覆盖公告文件，统一走远端公告（含缓存与失败回退）。
- **仪表盘页头操作区调整**：将仪表盘右上角日期展示替换为内嵌“公告”按钮；公告入口改为仪表盘上下文显示，不再全局全页悬浮。
- **v0.9.0 公告内容已补齐全语言**：新增/补齐 `announcements.json` 中该公告的 17 种语言标题、摘要、正文与动作文案，确保各语言环境都能看到对应本地化内容。
- **GitHub Copilot 用量展示对齐（仪表盘 + 托盘）**：用量解析切换为结构化快照口径（`completions` / `chat` / `premium_interactions`），补充 `Included` 语义处理，并在仪表盘卡片与托盘摘要中新增 `Premium` 维度展示。
- **公告/托盘文案覆盖补齐**：为全部语言文件新增 `announcement.*` 文案键，并在托盘文案映射中补充 `Included` 与 GitHub Copilot 指标标签（`Inline` / `Chat` / `Premium`）。

---
## [0.9.0] - 2026-02-27

### 新增
- **独立账号验证工作台**：新增 Antigravity「账号验证」页面，支持按模型批量验证账号、实时进度、验证历史落库、批次详情查看，以及 `全部/成功/需要验证/失败` 状态筛选。
- **官方对齐的唤醒/验证链路**：新增 `本地网关 + 官方 Language Server 协议` 通道，按 `StartCascade` / `SendUserCascadeMessage` / `GetCascadeTrajectory` / `DeleteCascadeTrajectory` 执行，用于对话唤醒与账号验证调用。
- **403 验证快捷操作**：在“需要验证”结果中提供验证地址展示与快捷操作（`立即验证`、复制验证地址、复制调试信息），便于用户自助完成验证。

### 变更
- **模型列表规则统一**：唤醒任务模型选择、账号验证模型选择、配额相关模型展示统一按官方 `agentModelSorts[].groups[].modelIds` 生成；官方列表不可用时回退固定 6 个推荐模型。
- **Antigravity 分组展示收敛为 3 组**：默认分组调整为 `Claude / Gemini Pro / Gemini Flash`，移除 `Gemini Image` 分组并兼容清理旧映射，避免重复分组展示。
- **账号验证页交互与隐私展示对齐**：支持批量勾选/删除验证记录、可手动关闭结果提示，并与账号总览隐私开关联动（邮箱脱敏展示一致）。
- **GitHub Copilot（VS Code 口径）展示对齐**：套餐映射中 `individual` 统一归并为 `PRO`；用量展示改为按 `quota_snapshots.completions/chat/premium_interactions` 解析，卡片与表格新增 `Premium requests` 维度并支持 `Included` 展示。
- **唤醒任务自定义时间交互优化**：自定义时间保持“时间选择器 + 快速输入”交互；空值不再展示默认时间；输入但未点击“添加”的自定义时间也会参与“下次触发预览”和任务保存。

---
## [0.8.13] - 2026-02-24

### 新增
- **macOS 独立 Dock 图标显示开关**：在“设置 > 通用”中新增“是否隐藏 Dock 图标（仅 macOS）”选项，可与关闭/最小化行为独立控制。
- **macOS 窗口行为设置多语言文案补齐**：为 `minimizeBehavior`、`hideDockIcon` 相关选项补充多语言键。

### 变更
- **macOS 窗口行为配置模型拆分**：本地配置新增持久化字段 `minimize_behavior`、`hide_dock_icon`，并接入 Tauri 系统命令与 WebSocket 配置写入；应用启动时会按已保存配置应用 Dock 激活策略。
- **标签编辑弹窗样式优化（重点增强暗色主题）**：优化暗色背景、边框、标签样式、删除按钮，以及输入框/占位符/禁用态表现。
- **OAuth 授权 URL 参数精简**：生成授权链接时移除 `include_granted_scopes=true` 参数。

### 修复
- **macOS Dock 图标显示设置保存后立即生效**：修改 Dock 图标显示选项后会立即重新应用 macOS 激活策略，无需重启应用。
- **语言切换写配置不再丢失 macOS 新字段**：WebSocket 语言切换写回配置时会保留 `minimize_behavior`、`hide_dock_icon`，避免被意外重置。

---
## [0.8.12] - 2026-02-22

### 新增
- **GitHub Release + Homebrew Cask 一键发布脚本**：新增 `scripts/release/publish_github_release_and_cask.cjs` 与 `npm run release:github-and-cask`，支持 `universal.dmg` 构建、GitHub Release 上传与 `Casks/cockpit-tools.rb` 更新（含 `--skip-build` / `--skip-gh` / `--skip-cask` / `--dry-run` 等参数）。

### 变更
- **启动路径探测策略优化**：应用启动时改为先读取本地配置，仅探测未配置路径的平台，并使用延迟 + 错峰执行，降低启动阶段集中调用系统探测命令的概率。
- **发布流程文档补充 Homebrew 场景**：更新 `docs/release-process.md`，补充 `universal` 构建推荐方式、`SHA256SUMS` 生成示例、GitHub CLI/Rust target 前置条件及 cask 更新顺序说明。
- **Release 工作流恢复 Homebrew Cask 自动更新**：`release.yml` 恢复 `update-homebrew-cask` 任务，基于已发布的 `*_universal.dmg` 自动计算 `sha256`、更新 `Casks/cockpit-tools.rb` 并创建 cask PR。
- **仅自动合并 cask 自动生成 PR**：Release 工作流现仅对 `automation/update-cask-v*` 分支创建的 Homebrew cask PR 启用自动合并（squash + 删除分支），不影响其他普通 PR。

### 修复
- **Windows 启动黑色命令行窗口闪烁**：修复 VS Code 路径注册表回退探测中 `cmd /c reg query` 未隐藏窗口的问题，后台命令改为隐藏执行，减少部分 Windows 用户启动时出现多个黑色窗口闪现。
- **品牌名与套餐标签误翻译**：修复非英语语言中品牌名/产品名与原始套餐标签被本地化的问题，恢复 `Cockpit Tools`、`Antigravity`、`Codex`、`GitHub Copilot`、`Windsurf` 以及 `accounts.tier.*`、`codex.plan.*`、`kiro.plan.*` 的原始显示值。
- **翻译校验误报品牌名**：为多语言校验脚本补充品牌名英文复用白名单，避免后续再次将品牌名误判为“未本地化”。

---
## [0.8.11] - 2026-02-22

### 变更
- **Antigravity 配额后端获取流程对齐 Antigravity.app**：统一 `loadCodeAssist` / `onboardUser` / `fetchAvailableModels` 的 Cloud Code 域名选择逻辑（按 Antigravity 风格路由），后端请求补充透传 `cloudaicompanionProject`，`onboardUser` 改为“先 `POST` 再按 operation `GET` 轮询”（500ms 轮询间隔）。本地配额 API 缓存仍保留，同时缓存前的后端获取流程已完成对齐。

---
## [0.8.10] - 2026-02-22

### 新增
- **Windsurf 新增邮箱密码导入方式**：在 Windsurf 添加账号弹窗中新增“邮箱密码”页签，并接入 Firebase 登录流程以自动写入本地 Windsurf 账号。

### 变更
- **Windsurf Credits 口径改为月配额语义**：`availablePromptCredits` / `availableFlexCredits` 统一按“月总额度”解释，剩余额度按 `total - used` 计算。
- **密码登录输入处理调整**：邮箱仍会做 `trim` 归一化，密码改为保留原始输入（不再 `trim`），避免改写合法凭据。

### 修复
- **Windsurf 密码登录文案补齐多语言键**：补充 `windsurf.addModal.password` 与 `windsurf.password.*` 语言键，避免界面出现回退文案。
- **密码登录日志隐私修复**：移除 Windsurf 邮箱密码登录日志中的明文邮箱输出，降低 PII 泄露风险。

---
## [0.8.9] - 2026-02-21

### 新增
- **五平台账号卡片支持直接显示标签**：Antigravity、Codex、GitHub Copilot、Windsurf、Kiro 的网格卡片现可直接展示账号标签，便于快速识别账号用途。

### 变更
- **卡片标签展示规则统一**：各平台卡片标签统一为紧凑展示规则（最多显示 2 个标签，超出显示 `+N`）。

### 修复
- **Release 校验和上传流程不再依赖本地 git 仓库**：在校验文件上传任务中补充 `GH_REPO` 上下文，修复 `fatal: not a git repository` 导致的上传失败。

---
## [0.8.8] - 2026-02-21

### 变更
- **Codex 配额窗口改为按窗口存在性展示**：Codex 配额展示不再固定强制两行，改为依据接口 `primary_window` / `secondary_window` 是否存在动态显示。
- **Codex 窗口标签改为官方风格规则**：窗口标签统一按实际窗口分钟动态显示为 `5h`、`Weekly`、`Xd`、`Xh`、`Xm`。
- **Codex 多开实例账号选择新增订阅徽章**：Codex 多开实例中的绑定账号下拉/列表，现同时展示 `FREE/PLUS/PRO/TEAM/ENTERPRISE` 订阅徽章，降低免费账号识别歧义。
- **手动检查更新增加明确反馈**：点击“检查更新”后会显示检查中状态，并在无新版本或检查失败时给出明确提示，避免“点击无反应”。
- **Release 流程自动上传校验文件**：GitHub Release 流程新增自动生成并上传 `SHA256SUMS.txt`，无需手动补传校验文件。

### 重构
- **提取并复用 Codex 配额窗口统一逻辑**：Codex 账号页、仪表盘卡片与 Codex 多开实例共用同一套窗口标签与显示判断逻辑，避免多处规则漂移。

---
## [0.8.7] - 2026-02-21

### 变更
- **新增 UNKNOWN 套餐展示与筛选**：当账号订阅等级缺失时，不再回退为 `FREE`，统一按 `UNKNOWN` 展示；账号筛选下拉新增 `UNKNOWN` 独立筛选项。
- **UNKNOWN 徽章改为红色警示样式**：`UNKNOWN` 与正常 `FREE` 在视觉上明确区分，便于快速识别订阅识别异常账号。
- **配额详情弹窗徽章展示一致性优化**：配额详情弹窗始终显示套餐徽章，订阅缺失时也会显示 `UNKNOWN`。

### 修复
- **刷新后不再保留旧订阅等级**：移除后端“新配额无 tier 时保留旧 `subscription_tier`”逻辑，避免历史 `PRO/ULTRA` 被误保留。
- **订阅识别失败日志可诊断性增强**：订阅识别失败会明确输出 `UNKNOWN` 原因（含状态码/响应片段与 loadCodeAssist 上下文），可区分接口异常与“成功返回但无 tier”两类场景。

---
## [0.8.6] - 2026-02-21

### 变更
- **模型分组自动归类支持忽略版本号**：新增前缀/模式匹配，Claude 与 Gemini 模型按家族归组，不再依赖预置精确 ID。
- **“其他模型”归类优化**：Claude Sonnet/Opus 变体与 Gemini x Pro/Flash/Pro Image 变体会自动归入目标默认分组，不再落入 `其他模型`。
- **Gemini 默认分组名称升级**：默认分组展示名从 `G3-Pro`、`G3-Flash`、`G3-Image` 调整为 `Gemini Pro`、`Gemini Flash`、`Gemini Image`。

### 修复
- **旧分组名称兼容迁移**：读取历史配置时，旧 `G3-*` 分组名会自动迁移为新的 Gemini 命名。

---
## [0.8.5] - 2026-02-19

### 新增
- **Kiro 账号封禁状态识别**：新增对 Kiro 账号暂停/封禁（banned）状态的自动检测。配额刷新时若 API 返回封禁信息（如 403 FORBIDDEN），账号将自动标记为 `banned` 并记录原因。

### 变更
- **封禁账号 UI 展示**：账号卡片与表格新增 🔒 封禁标签（`forbidden` 状态徽章），卡片同时标灰显示，提升视觉区分度。
- **封禁账号操作限制**：封禁账号的切号按钮置灰，仪表盘推荐算法与配额预警建议均自动排除封禁账号。
- **批量刷新跳过封禁账号**：全量刷新时自动跳过已封禁账号，减少无效请求，并在日志中记录跳过数量。
- **配额预警排除封禁账号**：若当前账号处于封禁状态，不触发配额预警弹窗。

### 修复
- **错误状态区分**：配额刷新失败（`error`）与封禁（`banned`）现分别记录，避免所有刷新失败均被标记为错误状态。

---
## [0.8.4] - 2026-02-19

### 变更
- **Kiro JSON 导入支持原始快照格式**：导入链路现已支持 Kiro 风格原始 JSON 对象/数组（如 `accessToken`、`refreshToken`、`expiresAt`、`provider`、`profileArn`、`usageData` 等字段），并自动映射为本地标准账号结构。
- **Kiro 导入解析与 OAuth 快照逻辑对齐**：JSON 导入改为复用 OAuth/本地导入同一套快照解析路径，提升邮箱、用户标识、登录来源、套餐与额度字段的解析一致性。

### 修复
- **导入时间格式兼容增强**：Kiro 导入时可正确解析 `YYYY/MM/DD HH:mm:ss` 格式的过期时间（例如 `2026/02/19 02:01:47`）。
- **加赠额度到期天数回退补齐**：新增 `freeTrialExpiry` 字段回退解析，用于推导 Kiro Add-on 到期天数。

---
## [0.8.3] - 2026-02-18

### 变更
- **托盘平台矩阵补齐 Kiro**：托盘平台排序/显示与账号数量聚合已纳入 Kiro，并新增 Kiro 托盘账号摘要展示（套餐、Prompt/Add-on 剩余额度与重置时间）。
- **Kiro 上线兼容旧托盘布局**：读取旧版四平台托盘配置时，仅在“历史默认布局”场景自动补入 Kiro；若用户已自定义显示或顺序，则保持用户选择不被覆盖。
- **账号页套餐标签统一原始值**：Antigravity/Codex/GitHub Copilot/Windsurf 的账号卡片、表格与筛选项统一直接展示后端/本地原始 plan/tier 值，不再做本地化映射。

### 修复
- **自动切号阈值边界修复**：自动切号触发条件由严格小于阈值改为小于等于阈值（`<=`），避免刚好命中阈值时漏触发。

---
## [0.8.2] - 2026-02-18

### 变更
- **OAuth 回调服务加固**：重写本地 OAuth 回调服务器，改为循环处理请求模式，自动忽略非回调请求（如 favicon），仅对 `/oauth-callback` 路径做处理；新增 CORS 预检（OPTIONS）支持及未匹配路由的 404 响应。
- **OAuth CSRF 防护**：授权 URL 新增每次流程唯一的 `state` 参数，回调服务器在接收时校验 state 一致性，防止跨站请求伪造。
- **OAuth 流程超时与清理**：新增 OAuth 回调等待超时机制；超时或失败后自动清理流程状态并返回用户可读的重试提示。
- **OAuth 回调地址归一化**：OAuth 重定向地址由 `127.0.0.1` 统一为 `localhost`，提升跨浏览器/系统的重定向兼容性。
- **账号身份匹配逻辑重构**：将原先的纯 email 匹配替换为多因子精确匹配（`session_id` → `refresh_token` → `email + project_id`），upsert 场景额外保留单 email 兼容回退。
- **Google 用户 ID 持久化**：OAuth `UserInfo` 新增解析并存储 Google `id` 字段，登录完成时写入账号数据。

---
## [0.8.1] - 2026-02-17

### 变更
- **套餐标签改为原始值展示**：Antigravity/Codex/GitHub Copilot/Windsurf/Kiro 的账号卡片与表格订阅标签改为直接显示后端/本地原始 plan/tier 值，仅保留现有样式映射。
- **平台页签改为固定默认文案**：平台账号页的页签文案（账号总览/多开实例）改为直接使用默认值，避免不同语言环境下被平台分组翻译覆盖导致展示不一致。
- **平台名称统一使用原始标识**：共享平台名称渲染统一为 `Antigravity`、`Codex`、`GitHub Copilot`、`Windsurf`、`Kiro`。
- **Codex 切号启动行为可配置**：新增 `codex_launch_on_switch` 配置并打通后端配置模型、设置页与快速设置，可控制切换 Codex 后是否自动启动/重启 Codex App。

### 修复
- **首页隐私开关一致性**：仪表盘账号邮箱已接入与账号页/实例页同一隐私开关，并补充 focus/visibility/storage 同步，确保脱敏状态一致。
- **OpenCode 切号凭证同步可靠性**：修复 GPT 切号后未有效替换 OpenCode 登录凭证的问题，避免运行中仍停留在旧账号会话。(#51)
- **仪表盘卡片布局平衡性**：修复 Dashboard 中 Antigravity 账号卡片宽度表现，减少右侧明显留白并提升整体视觉平衡。(#49)

---
## [0.8.0] - 2026-02-17

### 新增
- **第五个平台上线**：Kiro 正式加入平台矩阵，支持与 Antigravity、Codex、GitHub Copilot、Windsurf 统一管理。
- **核心能力已完整接入**：Kiro 支持 OAuth/Token/JSON/本地导入、切号、配额刷新、多开实例与启动路径配置。
- **平台层能力重构**：实例服务、账号 Store 与页头 Tabs 已抽象为通用平台组件，后续新平台接入成本更低。
- **重点修复**：修复 Kiro 导入账号 ID 的路径穿越风险，并补齐多语言缺失键，改善阿拉伯语等非默认语言的展示一致性。

---
## [0.7.3] - 2026-02-15

### 新增
- **托盘平台布局持久化**：新增托盘布局配置文件（`tray_layout.json`）与 `save_tray_platform_layout` 命令，可保存托盘显示平台、排序和排序模式。
- **布局弹窗托盘显示开关**：平台布局管理新增 `菜单栏显示` 开关，并同步补齐该能力相关的多语言键。
- **托盘平台覆盖扩展**：托盘新增 GitHub Copilot 与 Windsurf 子菜单，支持账号/配额摘要和直接导航。

### 变更
- **托盘菜单架构重构**：托盘菜单改为动态多平台渲染，支持自动/手动排序与“更多平台”分组展示。
- **托盘刷新触发点补齐**：GitHub Copilot/Windsurf 的刷新、OAuth 完成、Token 导入、切号流程完成后会立即刷新托盘；语言变更也会触发托盘重建。
- **前端托盘事件处理增强**：`tray:refresh_quota` 改为一次触发 Antigravity、Codex、GitHub Copilot、Windsurf 四个平台刷新；托盘导航新增 `github-copilot`、`windsurf` 目标支持。
- **平台布局同步策略**：新增前端到后端的托盘布局防抖同步机制，并在应用初始化时执行一次同步。

### 修复
- **托盘可见性过滤正确性**：修复托盘平台过滤逻辑，已关闭的平台不会被默认补回；当未选择任何托盘平台时会显示空态提示。
- **日志隐私增强**：日志输出会自动脱敏邮箱地址，降低敏感标识暴露风险。

---
## [0.7.2] - 2026-02-14

### 新增
- **分组管理“其他模型”分桶**：新增自动汇总的 `其他模型` 分组，用于展示账号配额中发现的非默认模型。
- **授权模式模型黑名单过滤**：分组管理新增按模型 ID/显示名过滤黑名单，排除受限的 Gemini 2.5/chat 相关模型。
- **Claude Opus 4.6 映射覆盖**：将 `claude-opus-4-6-thinking` 与 `MODEL_PLACEHOLDER_M26` 纳入默认/推荐模型映射及唤醒任务推荐列表。

### 变更
- **分组配置迁移策略**：读取分组配置时改为增量补齐缺失的默认映射/名称/排序，同时保留用户自定义配置。
- **分组弹窗数据来源**：账号页向分组管理弹窗传递实时模型 ID 与显示名，提升模型名展示和“其他模型”归类准确性。
- **模型展示顺序对齐**：账号配额展示顺序已对齐，Claude 分组纳入 Claude Opus 4.6。

### 修复
- **分组管理多语言补齐**：已补齐全部语言的 `group_settings.other_group`，避免缺失键回退。

---
## [0.7.1] - 2026-02-14

### 新增
- **多平台配额预警链路**：新增 Antigravity、Codex、GitHub Copilot、Windsurf 的配额预警计算与事件派发，按平台识别模型/额度指标。
- **配额预警设置项**：在设置页和快速设置中新增配额预警开关与阈值配置，并同步补齐多语言键。
- **全局弹窗基础能力**：新增可复用的全局弹窗状态/Hook/组件（`useGlobalModal` + Zustand + `GlobalModal`），用于跨模块提示和预警操作。
- **通知能力接入**：接入 Tauri 通知能力到运行时与 capability，并补齐 macOS 点击通知回到主窗口的处理。

### 变更
- **配额刷新联动预警**：Codex/GitHub Copilot/Windsurf 的单账号与全量刷新成功后，会自动执行配额预警检查。
- **预警载荷模型**：`quota:alert` 载荷新增 `platform` 字段，前端弹窗“快捷切号”会按平台路由到对应切号流程和页面。
- **设置输入交互升级**：刷新间隔与阈值配置改为“预设 + 行内数字输入”模式，支持 Enter/失焦提交。
- **配置模型贯通**：`quota_alert_enabled` 与 `quota_alert_threshold` 已贯通命令读写和 WebSocket 语言保存链路。
- **日志保留策略**：日志初始化时会自动清理超过 3 天的 `app.log*` 过期文件。

### 修复
- **预警监听重复注册**：修复 React 异步退订时机导致的 `quota:alert` 监听重复注册风险。
- **0% 阈值一致性**：运行时阈值归一化改为支持 `0%`，与前端可选项保持一致。

---
## [0.7.0] - 2026-02-12

### 新增
- **Windsurf 全链路能力**：新增 Windsurf 从账号到实例的完整能力，包含 OAuth/Token/本地导入、账号持久化、配额同步、切换注入启动与多开命令。
- **Windsurf 前端模块**：新增 Windsurf 账号页、实例页、服务层/状态层/类型层，并补齐独立图标与导航资产。
- **仪表盘接入 Windsurf**：仪表盘新增 Windsurf 统计与账号卡片，支持与其它平台一致的快捷刷新/切换操作。
- **平台布局管理能力**：新增平台布局管理弹窗与布局状态存储，用于平台显示与排序管理。

### 变更
- **导航结构扩展**：侧边栏与路由结构扩展为支持 Windsurf 与平台布局入口。
- **设置模型扩展**：通用设置新增 Windsurf 自动刷新与启动路径配置，并同步到快速设置交互。
- **Windows 探测链路升级**：应用路径探测增强为多源探测，并加入 PowerShell `-File` 回退与 VS Code 注册表专项探测。

### 修复
- **Windows 探测稳定性**：改进命令输出为空/异常时的处理，降低 VS Code/Windsurf 路径探测漏判。
- **配额刷新容错**：刷新失败时保留历史有效配额快照，避免界面配额被错误清零。
- **切号/注入稳定性**：增强绑定注入与启动路径不匹配场景的处理和诊断能力。

---
## [0.6.10] - 2026-02-10

### 新增
- **隐私截图模式**：在 Antigravity/Codex/GitHub Copilot 的账号总览与多开实例页新增 Eye/EyeOff 开关，可对邮箱及类似标识做脱敏。
- **GitHub Copilot 一键切号链路**：新增默认 VS Code 配置目录的一键切号流程，支持注入并联动重启。
- **跨实例窗口定位能力**：补齐并多语言化 `openWindow` 操作，增强 Antigravity/Codex/VS Code 的 PID 定位与窗口聚焦能力。
- **配额/切号诊断日志**：增加刷新与切换过程的关键元信息日志，便于排障。
- **Codex 多团队身份支持**：新增基于 `account_id` / `organization_id` 的账号匹配策略，支持多团队账号并存。
- **macOS 分发后置处理**：Cask 增加 postflight 钩子，自动清理隔离属性（quarantine）。
- **发布流程模板与脚本**：新增发布规范文档、预检脚本与校验和生成脚本，便于版本发布标准化。

### 变更
- **账号总览切号统一走默认实例链路**：Antigravity/Codex/GitHub Copilot 账号总览切号统一为“PID 精准关闭 -> 注入 -> 启动”。
- **Copilot 流程对齐**：GitHub Copilot 的账号总览切号与多开实例启动逻辑对齐，统一注入与启动语义。
- **实例生命周期对齐**：Antigravity/Codex/VS Code 多开实例的启动/关闭/重启逻辑进一步统一，按受管目录匹配并跟踪 PID。
- **Windows VS Code 启动策略**：改为 `cmd /C code`，兼容 `.cmd` 启动器场景。
- **PID 解析语义对齐**：VS Code 的 PID 解析/聚焦改为 `Option<&str>` 语义（`None` 表示默认实例），与 Antigravity 保持一致，减少默认实例识别偏差。
- **文档与设置说明更新**：补充 README 与安全/设置相关说明，覆盖新切号与路径行为。
- **多语言补齐**：全语言同步新增/调整的切号、窗口定位、隐私模式及错误提示文案。

### 修复
- **错误兼容与提示链路**：完善刷新/切号的非成功状态处理与错误透传，提升异常可定位性。
- **PR 反馈修正**：增强异常处理、补齐注入链路的 SQLite 事务保护，并修复品牌文案不一致问题。
- **构建告警治理**：清理 Windows 相关编译告警，并处理/抑制历史遗留 dead code 告警。

### 移除
- **旧 Copilot 注入入口**：移除未使用的旧注入包装函数，统一收敛到实例化切号链路。

---
## [0.6.0] - 2026-02-08

### 新增
- **GitHub Copilot 账号管理**：支持 OAuth/Token/JSON 导入、配额状态、订阅标识、标签与批量操作，并提供账号总览界面。
- **GitHub Copilot 多开实例**：支持 VS Code Copilot 多实例管理，包含独立配置、启动/停止与实例生命周期管理。

### 变更
- **仪表盘与导航**：新增 GitHub Copilot 入口与总览卡片，和 Antigravity/Codex 并列展示。
- **启动路径行为**：回滚最近的路径自动重探测变更，恢复原有检测流程。

### 修复
- **Windows 构建告警**：收敛平台特定的进程处理逻辑，避免环境变量被 move 导致的编译告警。

---
## [0.5.4] - 2026-02-07

### 新增
- **Codex OAuth 登录会话命令集**：新增 `codex_oauth_login_start` / `codex_oauth_login_completed` / `codex_oauth_login_cancel`，统一以 `loginId + authUrl` 作为启动返回模型。
- **OAuth 超时事件协议**：后端新增超时事件载荷（`loginId`、`callbackUrl`、`timeoutSeconds`），用于前端做可控重试。

### 变更
- **Codex OAuth 流程对齐**：从“直接用 code 完成”调整为“会话化完成”（后端按会话缓存回调 code，前端按 `loginId` 完成登录）。
- **授权交互顺序**：先在弹窗内展示授权链接，再由用户手动点击打开浏览器。
- **超时重试交互**：超时后主按钮由 `在浏览器中打开` 切换为 `刷新授权链接`；刷新成功后自动切回 `在浏览器中打开`。
- **超时策略**：超时后不再自动循环重建授权，会话重试改为用户手动触发。
- **OAuth 日志收敛**：日志调整为会话创建/启动/超时/取消/完成等关键节点，移除冗长明细输出。

### 移除
- **旧版 Codex OAuth 命令**：移除 `prepare_codex_oauth_url`、`complete_codex_oauth`、`cancel_codex_oauth` 及前端/服务层回退链路。

### 修复
- **回调重复完成风险**：前端增加会话与并发保护，降低回调重复触发导致的二次完成竞态。
- **超时样式重复问题**：合并弹窗超时态展示，修复重复红色错误区样式。

---
## [0.5.3] - 2026-02-06

### 新增
- **空白实例初始化方式**：新建实例新增初始化方式单选（复制来源实例 / 空白实例），支持只创建空目录。
- **未初始化引导弹窗**：空白实例在未初始化时点击绑定账号会弹出引导弹窗，支持“立即启动”完成初始化。
- **实例排序控件**：多开实例工具栏新增排序字段（创建时间 / 启动时间）与正序/倒序切换。
- **应用内删除确认弹窗**：实例删除确认改为应用内弹窗（含右上角关闭），不再依赖系统确认框。

### 变更
- **实例状态模型扩展**：Antigravity/Codex 实例返回数据新增 `initialized` 状态，前后端统一使用。
- **绑定流程约束**：未初始化实例禁止绑定账号（前端置灰 + 后端校验），并返回明确错误提示。
- **实例列表布局优化**：状态独立成列并紧挨实例列；操作列改为 sticky 覆盖层，小窗口下始终可见且不透底。
- **下拉交互分离**：列表中的账号下拉改为 portal（容器外）渲染，弹框内下拉保持容器内渲染，避免裁切和样式串扰。
- **PID 展示逻辑**：实例未运行时不再显示 PID。
- **启动后自动刷新**：实例启动后增加约 2 秒延迟刷新，减少“已初始化但列表仍显示待初始化”的滞后。
- **国际化补齐**：补齐并对齐 17 种语言的相关新键（初始化方式、待初始化提示、排序等）。

### 修复
- **删除确认卡住问题**：修复在特定交互状态下删除确认框点击无响应的问题。

---
## [0.5.2] - 2026-02-06

### 变更
- **账号切换绑定同步**：切换 Antigravity 账号后，默认实例绑定账号会自动同步为当前所选账号。
- **Codex 账号切换绑定同步**：切换 Codex 账号后，默认 Codex 实例绑定账号会自动同步为当前所选账号。
- **实例账号下拉交互**：实例列表内联账号下拉改为统一开关状态控制，同一时间仅展开一个下拉菜单。
- **实例页面 UI 优化**：优化列表/表格布局、内联账号选择器可读性，以及深色模式和移动端展示效果。

## [0.5.1] - 2026-02-05

### 新增
- **唤醒调度后端同步**：新增调度同步命令，并提供后端历史记录加载/清理接口。
- **下载目录辅助**：新增获取下载目录的系统接口。
- **启动路径管理**：通用设置新增 Codex 启动路径，并提供启动路径探测/设置命令。

### 变更
- **唤醒历史存储**：历史记录改为后端持久化，保留数量提升至 100 条。
- **macOS 启动策略**：优先直接执行可执行文件（可拿 PID），失败后 `.app` 走 `open -a` 兜底。
- **重置默认路径**：改为自动探测并回填，而非清空。
- **账号切换**：启动后更新默认实例 PID；路径缺失时触发应用路径弹框事件。
- **文档**：补充 Antigravity/Codex 多开实例说明与图片占位。
- **国际化**：新增启动路径相关翻译键并保持一致性。

### 修复
- **macOS 应用选择**：优化 `.app` 选择/启动流程，减少权限错误。

## [0.5.0] - 2026-02-04

### 新增
- **Antigravity 最新版本兼容性**: 增强对 Antigravity 1.16.5+ 版本的账号切换支持。
  - 支持新的统一状态同步格式（`antigravityUnifiedStateSync.oauthToken`）。
  - 向下兼容旧版本的数据格式。
- **Antigravity 多实例支持**: 支持同时运行多个 Antigravity IDE 实例。
  - 每个实例使用独立的用户配置文件和数据目录运行。
  - 支持不同账号同时登录不同实例。
  - 通过专用管理界面创建、启动、重启和删除实例。
  - 自动检测正在运行的实例并实时显示状态。
- **Codex Mac 桌面端多实例支持**: 支持在 macOS 上同时运行多个 Codex 桌面实例。
  - 每个实例使用独立的用户配置文件和应用数据目录运行。
  - 支持不同账号同时登录不同实例。
  - 通过专用管理界面创建、启动、重启和删除实例。
  - 自动检测正在运行的实例并实时显示状态。
  - 智能重启策略：在切换账号时可选择"始终重启"、"从不重启"或"询问我"。

### 变更
- **实例管理界面**: 新增专用的实例管理页面，采用现代化列表界面。
- **导航菜单**: 在侧边栏中新增"实例管理"菜单项，可快速访问实例管理功能。

---
## [0.4.10] - 2026-01-31

### 变更
- **单账号配额刷新**：单个卡片刷新现在总是请求实时 API，不再受 60 秒缓存限制。
- **缓存目录隔离**：桌面端配额缓存目录改为 `quota_api_v1_desktop`，避免与插件端共享/覆盖。

## [0.4.9] - 2026-01-31

### 新增
- **配额错误详情**：记录账号最近一次配额错误，并在独立错误详情弹窗中展示（支持链接渲染）。
- **403 禁止状态展示**：账号被拒绝访问时显示锁定状态，并在配额区域提示。

### 变更
- **配额查询结果**：返回结构化错误信息（code/message）并写入账号状态。
- **账号状态提示**：合并禁用/刷新异常/无权限提示文案。
- **账号操作区**：收紧卡片操作按钮间距与尺寸。

### 修复
- **国际化**：补齐账号错误操作与错误详情字段的缺失翻译。

## [0.4.8] - 2026-01-30

### 新增
- **OpenCode 同步开关**：在 Codex 账号管理中加入开关，用于控制 OpenCode 同步/重启。

### 变更
- **OpenCode 认证同步**：切换账号时同步 auth.json，补齐 OAuth 字段并使用跨平台路径。
- **OpenCode 启动逻辑**：未运行则直接启动，运行中则重启。
- **AccountId 对齐**：账号 ID 提取逻辑对齐官方扩展（仅 access_token）。
- **界面文案**：OpenCode 启动路径提示去掉固定默认路径文案。

### 修复
- **i18n**：补齐缺失翻译并确保各语言键一致。

## [0.4.7] - 2026-01-30

### 新增
- **授权接口缓存**：缓存授权接口原始响应，落盘到 `cache/quota_api_v1`。
- **缓存来源标记**：接口缓存新增 `customSource` 字段，用于标记写入来源。
- **缓存命中日志**：配额刷新新增缓存命中/过期日志。

### 变更
- **旧缓存桥接**：旧缓存读取逻辑改为读取新的接口缓存，保持启动期快速回显。

## [0.4.6] - 2026-01-29

### 新增
- **更新通知**：更新弹窗现在会显示更新内容，支持中英文本地化。

### 修复
- **国际化**：修复 Codex 添加账号弹窗中缺失的翻译（OAuth、Token、导入选项卡）。
- **可访问性**：改进 FREE 订阅标签的对比度，提升浅色模式下的可读性。
- **国际化**：修复删除标签确认对话框中硬编码的中文字符串。

---
## [0.4.3] - 2026-01-29

### 新增
- **Codex 标签管理**：新增 Codex 账号全局标签删除功能。
- **账号过滤与标签**：
  - 支持账号标签管理，可为账号添加/删除标签。
  - 支持按标签过滤账号列表。
- **紧凑视图**：
  - 新增账户列表紧凑视图模式，显示更紧凑的信息。
  - 支持在紧凑视图中查看账号禁用及警告状态图标。
  - 支持在紧凑视图中自定义模型分组显示。

### 优化
- **智能推荐**：优化仪表盘推荐算法，自动排除已禁用、受限或无模型的无效账号。
- **界面优化**：
  - 优化紧凑视图的交互体验。
  - 移除列表视图中冗余的标签渲染，提升界面整洁度。

## [0.4.2] - 2026-01-29

### 新增
- **更新弹框**：检查更新统一为弹框提示，支持从“关于”页直接触发。
- **刷新频率**：新增 Codex 账号自动刷新频率设置（默认 10 分钟）。
- **账号警告**：账号刷新失败时在列表中标记警告，支持凭证无效提示。

### 变更
- **更新体验**：更新提示样式统一为非透明弹窗，风格与现有弹框一致。

## [0.4.1] - 2026-01-29

### 新增
- **关闭确认弹窗**：新增关闭窗口确认弹窗，支持最小化/退出并可记住选择。
- **关闭行为设置**：在 设置 → 通用 中支持配置默认关闭行为。
- **托盘菜单**：新增系统托盘菜单，提供导航快捷入口与配额刷新操作。
- **排序增强**：支持按分组配额重置时间排序，以及 Codex 周配额/5 小时配额重置时间排序。

### 变更
- **国际化**：补齐关闭弹窗、关闭行为与重置时间排序的 17 种语言翻译。
- **界面优化**：为新关闭弹窗及相关布局做了样式优化。


## [0.4.0] - 2026-01-28

### 新增
- **可视化仪表盘**: 全新的仪表盘界面，提供 Antigravity 和 Codex 账号状态的一站式总览。
- **Codex 支持**: 全面支持 Codex 账号管理。
  - 查看 5小时 (Hourly) 和周 (Weekly) 配额。
  - 自动识别账号订阅计划 (Basic, Plus, Team, Enterprise)。
  - 独立的账号列表和卡片视图。
- **品牌重塑**: 项目正式更名为 **Cockpit Tools**。
- **赞助与反馈**: 在 设置 -> 关于 页面新增 "赞助支持" 和 "意见反馈" 入口，加强社区互动。

### 变更
- **字体优化**: 默认字体切换为 **Inter**，提升阅读体验。
- **文档更新**: 全面更新 README 文档，增加最新截图和结构化的功能概览。
- **国际化**: 更新所有 17 种语言的翻译，覆盖新的仪表盘和 Codex 功能。


## [0.3.3] - 2026-01-24

### Added
- **账号管理**: 新增按创建时间排序功能。账号现在默认按创建时间倒序排列（新创建的在前）。
- **数据库**: 为 `accounts` 表新增了 `created_at` 字段，支持精确的账号追踪。
- **国际化**: 为全部 17 种语言完善了"创建时间"相关的翻译支持。

## [0.3.2] - 2026-01-23

### Added
- **工程化**: 新增版本号自动同步脚本。`package.json` 版本号现在会自动同步到 `tauri.conf.json` 和 `Cargo.toml`。
- **工程化**: 新增 Git pre-commit 钩子，强制要求在版本变更时更新 Changelog。

## [0.3.1] - 2026-01-23

### Changed
- **维护**: 常规版本更新与依赖维护。

## [0.3.0] - 2026-01-22

### 新增
- **模型分组管理**: 新增分组管理弹窗，支持自定义模型分组显示名称。
  - 四个固定分组：Claude 4.5、G3-Pro、G3-Flash、G3-Image。
  - 自定义分组名称会应用到账号卡片和排序下拉菜单。
  - 分组配置本地持久化，首次启动时自动初始化。
- **账号排序**: 为账号列表新增排序功能。
  - 默认按综合配额排序。
  - 支持按特定分组配额排序（如按 Claude 4.5 配额）。
  - 分组配额相等时，按总配额进行二次排序。
- **国际化**: 为全部 17 种支持语言添加了排序和分组管理相关翻译。

### 变更
- 账号卡片上的模型名称现在动态反映自定义分组名称。
- 移除"其他"分组显示，简化分组模型。
- 解耦桌面应用与 VS Code 插件之间的分组配置。

---

## [0.2.0] - 2026-01-21

### 新增
- **更新检查**: 实现通过 GitHub Releases API 自动检查更新。
  - 应用启动时自动检查新版本（默认每 24 小时检查一次）。
  - 发现新版本时，右上角弹出精美的毛玻璃风格通知卡片。
  - 在 **设置 → 关于** 页面新增手动"检查更新"按钮，支持实时状态反馈。
  - 点击通知或下载按钮可直接跳转到 GitHub Release 页面下载。
- **国际化**: 为全部 17 种支持语言添加了更新通知相关翻译。

---

## [0.1.0] - 2025-01-21

### 新增
- **账号管理**: 完整的账号管理功能，支持 OAuth 授权。
  - 通过 Google OAuth 授权流程添加账号。
  - 支持从 Antigravity Tools (`~/.antigravity_tools/`)、本地 Antigravity 客户端或 VS Code 插件导入账号。
  - 导出账号为 JSON 格式，便于备份和迁移。
  - 支持删除单个或多个账号，带确认提示。
  - 支持拖拽排序账号列表。
- **配额监控**: 实时监控所有账号的模型配额。
  - 卡片视图和列表视图两种显示模式。
  - 按订阅类型（PRO/ULTRA/FREE）筛选账号。
  - 自动刷新，可配置刷新间隔（2/5/10/15 分钟或禁用）。
  - 一键快速切换账号。
- **设备指纹**: 全面的设备指纹管理功能。
  - 生成新指纹，支持自定义名称。
  - 捕获当前设备指纹。
  - 将指纹绑定到账号，实现设备模拟。
  - 从 Antigravity Tools 或 JSON 文件导入指纹。
  - 预览指纹配置详情。
- **唤醒任务**: 自动化账号唤醒调度系统。
  - 创建多个唤醒任务，支持独立控制。
  - 支持定时、Crontab 和配额重置三种触发模式。
  - 多模型和多账号选择。
  - 自定义唤醒词和最大 Token 限制。
  - 触发历史记录，包含详细日志。
  - 全局唤醒开关，快速启用/禁用。
- **Antigravity Cockpit 集成**: 与 VS Code 插件深度集成。
  - WebSocket 服务器实现双向通信。
  - 支持从插件端远程切换账号。
  - 账号导入/导出同步。
- **设置**: 完善的应用设置功能。
  - 语言选择（支持 17 种语言）。
  - 主题切换（浅色/深色/跟随系统）。
  - WebSocket 服务配置，支持自定义端口。
  - 数据目录和指纹目录快捷入口。
- **国际化**: 完整的国际化支持，覆盖 17 种语言。
  - 🇨🇳 简体中文, 🇹🇼 繁體中文, 🇺🇸 English
  - 🇯🇵 日本語, 🇰🇷 한국어, 🇻🇳 Tiếng Việt
  - 🇩🇪 Deutsch, 🇫🇷 Français, 🇪🇸 Español, 🇮🇹 Italiano, 🇵🇹 Português
  - 🇷🇺 Русский, 🇹🇷 Türkçe, 🇵🇱 Polski, 🇨🇿 Čeština, 🇸🇦 العربية
- **界面体验**: 现代精致的用户界面。
  - 毛玻璃设计风格，配合流畅动画。
  - 响应式侧边栏导航。
  - 深色模式支持，无缝主题切换。
  - 原生 macOS 窗口控件和拖拽区域。

### 技术栈
- 基于 Tauri 2.0 + React + TypeScript 构建。
- 使用 SQLite 数据库进行本地数据持久化。
- 使用系统钥匙串安全存储凭证。
- 跨平台支持（当前以 macOS 为主，Windows/Linux 计划中）。
