Versions
May 14, 2026 · View on GitHub
版本路线图 + 每个版本的 spec 清单 / 验收 / release notes 草稿。每个 vX.Y.Z 一个文件。
模板：
_TEMPLATE.md
Frontmatter schema：见母法2026-05-11-docs-governance.md§3.3
版本号约定：见母法 §7.1
状态机
placeholder ─首个 spec 落地─► planned ─开发开始─► in-progress ─tag 推送─► shipped
│
└─严重缺陷─► yanked
当前路线
列说明：
- Status：每个版本文件 frontmatter
status实际值（单源真相）- Main 已含：✅ 代码已 merge 到 main；⏸ 尚未实施；— placeholder（无代码）
- Tag：✅ git tag 已推送；空 = 未单独打 tag（详见路线下方注解）
| 版本 | Codename | Status | Main 已含 | Tag | Target | 主题 |
|---|---|---|---|---|---|---|
| v0.0.7 | docs-governance | in-progress | ✅ | 2026-05-11 | 📚 文档治理 + 路线骨架 | |
| v0.0.8 | hero-popover | in-progress | ✅ | 2026-05-12 | 🎨 hero popover 重做 | |
| v0.0.9 | trend-arrows | in-progress | ✅ | 2026-05-12 | 🎨 趋势箭头 | |
| v0.0.10 | menubar-display-modes | in-progress | ✅ | 2026-05-12 | 🎨 菜单栏多显示模式 | |
| v0.0.11 | pace-tracking | in-progress | ✅ | 2026-05-12 | 🎨 Pace tracking | |
| v0.1.0 | phase1-milestone | shipped | ✅ | 2026-05-11 | 🏁 Phase 1 里程碑（逻辑标记） | |
| v0.1.1 | claude-cli-credentials | in-progress | ✅ | 2026-05-12 | 🔌 Claude CLI 凭证复用 | |
| v0.1.2 | local-cost-scan | in-progress | ✅ | 2026-05-12 | 🔌 本地 JSONL cost 扫描 | |
| v0.1.3 | multi-account | in-progress | ✅ | 2026-05-12 | 🔌 多账号 | |
| v0.2.0 | phase2-milestone | shipped | ✅ | 2026-05-11 | 🏁 Phase 2 里程碑（逻辑标记） | |
| v0.2.1 | apple-notarization | placeholder | — | — | 🔧 Apple 公证 | |
| v0.2.2 | sparkle-beta-channel | in-progress | ✅ | 2026-05-12 | 🔧 Sparkle beta 通道 | |
| v0.2.3 | usage-store-redesign | in-progress | ✅ | 2026-05-12 | 🔌 用量统计与存储重设计（持久化 + 消费热力图） | |
| v0.2.4 | popover-redesign | in-progress | ✅ | 2026-05-12 | 🎨 Popover 重做（provider tab 外壳 + 卡片化 + 折线图 pace 面积） | |
| v0.2.5 | multi-provider-refactor | in-progress | ✅ | 2026-05-12 | 🏗️ 多供应商架构重构（UsageProvider 协议 + per-provider 运行时；Claude 行为不变） | |
| v0.2.6 | codex-provider | in-progress | ✅ | 2026-05-12 | 🔌 Codex provider（第一条数据源：~/.codex/auth.json → wham/usage） | |
| v0.2.7 | claude-keychain-reimport | in-progress | ✅ | 2026-05-12 | 🔧 Claude refresh 失败 → 回退读 Claude CLI Keychain（修「Session expired」误报） | |
| v0.2.8 | codex-history-trend | in-progress | ✅ | 2026-05-13 | 🔌 Codex 历史采样 + 趋势箭头 + 折线图（泛化 UsageHistoryService / UsageChartSectionView） | |
| v0.2.9 | codex-cost-heatmap | in-progress | ✅ | 2026-05-14 | 🔌 Codex 本地 session JSONL 扫描 → 估算成本/token → 消费热力图 + 去 Plan 卡（Codex tab 全面对齐 Claude） | |
| v0.2.10 | settings-provider-list | in-progress | ✅ | 2026-05-16 | ⚙️ Settings 改 provider 列表（拖动排序 + 启用开关 + 菜单栏单选子开关）+ 去 Account 区 + Codex 统一 polling interval + 刷新纪律 | |
| v0.2.11 | unified-poll-timer | in-progress | ✅ | 2026-05-18 | 🏗️ ProviderCoordinator 统一后台 timer（收编 Claude backoff）+ Codex 菜单栏专属 glyph | |
| v0.2.12 | app-icon-refresh | in-progress | ✅ | 2026-05-12 | 🎨 更换 App 图标（深紫圆角 + 蓝紫渐变进度条意象；菜单栏 glyph 不变；无代码改动） | |
| v0.2.13 | rename-usagebar | in-progress | ✅ | 2026-05-13 | 🔧 重命名 ClaudeUsageBar → UsageBar（app / 模块 / bundle id + 本地数据目录；无功能改动；ADR 0006） | |
| v0.2.14 | litellm-pricing | in-progress | ✅ | 2026-05-14 | 🔌 价格表改走 LiteLLM 快照（打包 + 3h 后台刷新）+ 逐级回退 normalize（修 Codex「未知模型」误报） | |
| v0.3.0 | provider-self-management | shipped | ✅ | 2026-05-13 | ⚙️ 全供应商可禁用（含 Claude）+ 独立菜单栏开关 + 拖拽排序修复 | |
| v0.3.1 | swiftui-hygiene | shipped | ✅ | 2026-05-13 | 🧹 SwiftUI hygiene：3 处 high bug + low 清理 + 死代码下线 | |
| v0.3.2 | code-structure-hygiene | shipped | ✅ | ✅ | 2026-05-13 | 🧹 代码结构治理：目录分 9 子目录（Providers/Claude+Codex）+ demo.png 清理 + UsageService 同文件章节化 + AppResources 改名 |
| v0.4.0 | view-layer-modernization | shipped | ✅ | 2026-05-13 | 🎨 view 层现代化：GCD 清理 + chartXSelection + PopoverView 抽 struct | |
| v0.4.1 | docs-cleanup | shipped | ✅ | 2026-05-13 | 📚 文档治理整理：AGENTS.md 3 层 + docs/agents/ 子目录 + drift 修复（纯文档，无代码改动） | |
| v0.5.3 | observable-migration-release | shipped | ✅ | ✅ | 2026-05-14 | 🏗️ ObservableObject → @Observable 迁移（内部重构，用户无感知） |
| v0.5.0 | observable-migration | implemented | ✅ | 2026-05-14 | 🏗️ ObservableObject → @Observable 迁移 + UsageService 887 行拆分 | |
| v0.5.1 | claude-credentials-in-memory | in-progress | ⏸ | 2026-05-14 | 🔧 Claude 凭证改 in-memory only（删持久化 / 多账号 UI / OAuth refresh；纯 CLI Keychain 借读） | |
| v0.6.0 | gemini-provider | in-progress | ✅ | 2026-05-13 | 🔌 Gemini Code Assist for Individuals 接入(对标 Claude/Codex,Pro/Flash 双段配额,本机统计推迟) |
代码层 / 治理层 drift 说明：本仓库采用"积压发版"模式 — 多个功能版本攒在一起、由更高版本（如 v0.3.2）一次性 tag 推送。 因此 v0.0.7~v0.2.14 的 frontmatter 仍标
in-progress，但代码层已落地 main。完整 G6 closeout（回填shipped_date+ 改status: shipped）属于专门动作，将在后续 docs-cleanup 后续工作中处理。当前 git tag：
v0.0.6（fork 上游截止）+v0.3.2（本仓库目前唯一独立 tag）。目标（用户 2026-05-12 定）：把 Codex tab 做到和 Claude tab 界面/功能一致 —— v0.2.6 已上额度窗口卡 + pace；v0.2.8 补趋势 + 折线图；v0.2.9 补成本 + 消费热力图。v0.2.7 是穿插的独立小修（Claude 凭证回退）。新版本立项时按 §7.1 命名规范 append 即可。
注：母法 spec
2026-05-11-docs-governance.md§7.2 / §7.3 中的 v0.2.3~v1.0.0 路线是 v0.0.7 立项历史快照（implemented spec 不可变），不代表当前路线。
命名规范
- 文件名：
vX.Y.Z-<kebab-case-codename>.md - 版本号严格递增；不跳号；patch 含 feature 在 0.x 阶段是合法的
- placeholder 升级到 planned 时：清空
includes_specs示例、填target_date