CodexBar 是一个 macOS 菜单栏应用,用于查看本机 Codex 账号状态、额度、Token 用量、详细统计信息
Swift appkitcodexcodex-clideveloper-toolsmacosmacos-appmenu-bar-appopenai-codexproductivityswiftswiftuiusage-tracker
fix: 优化额度行布局
Bob5601168b2ea4
diff --git a/AGENTS.md b/AGENTS.mdindex 34d00ff..15b68b2 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -64,7 +64,7 @@ git status --short- 平台: SwiftUI + AppKit + MVVM, 最低 macOS 15.0。- 应用形态: `LSUIElement` 菜单栏应用, 无 Dock 图标、无主窗口。- 外部依赖: Sparkle(SwiftPM)。-- 当前 build settings: `MACOSX_DEPLOYMENT_TARGET = 15.0`, `MARKETING_VERSION = 2.4.4`, `CURRENT_PROJECT_VERSION = 20`, `SWIFT_DEFAULT_ACTOR_ISOLATION = MainActor`。+- 当前 build settings: `MACOSX_DEPLOYMENT_TARGET = 15.0`, `MARKETING_VERSION = 2.4.5`, `CURRENT_PROJECT_VERSION = 21`, `SWIFT_DEFAULT_ACTOR_ISOLATION = MainActor`。- App Sandbox 必须保持关闭(`ENABLE_APP_SANDBOX = NO`), 因为应用要启动本机 Codex CLI/APP 内置 CLI, 并读取真实 macOS 用户的 Codex 登录状态。- 工程使用 `PBXFileSystemSynchronizedRootGroup`; 新增或删除 `CodexBar/` 下 Swift 文件通常无需改 `project.pbxproj`。只有依赖、target/build settings 或资源归属变更才改 Xcode 工程文件。- Swift 源码按目录组织: `App/`、`Controllers/`、`Models/`、`Services/`、`Views/`。不要把新 Swift 文件直接放回 `CodexBar/` 根层。@@ -132,7 +132,7 @@ Hook 统计的配置、存储、保留策略和统计口径见 [Docs/CodexHook.m- 其余 limit 按 `limitName ?? limitId` 做 localized standard 排序, 再按 `limitId` 稳定排序。- `primary` / `secondary` 合成 `[QuotaWindow]`; 没有窗口的 limit 被过滤。- `QuotaWindow.remainingPercent = clamp(100 - usedPercent, 0...100)`; 无 `usedPercent` 视为无数据。-- `windowDurationMins` 标签: 整天「N 天」, 整小时「N 小时」, 否则「N 分钟」, 缺失或非正数为「额度」。+- `windowDurationMins` 标签: 整天 `ND`, 整小时 `NH`, 否则 `NM`, 缺失或非正数为「额度」。`CodexUsageSnapshot`:@@ -173,10 +173,11 @@ Popover:- `LiquidGlassStyle.swift` 是自绘玻璃效果, 不是 macOS 原生 `.glassEffect`; 没有明确设计要求时不要切换。- 账号图标双击触发刷新。邮箱文本双击切换模糊。- 计划名是右侧加粗纯文字; `planBadgeTint(for:)` 优先级: enterprise -> team/business -> pro -> plus -> edu -> free -> 默认 cyan。-- 额度条展示剩余百分比, 固定为 50 个胶囊, 每个胶囊宽 `3.5`, 间距 `1.5`, 高 `12`; 颜色按 20% 一档: 红、橙、黄、薄荷、绿。+- 额度条展示剩余百分比, 固定为 50 个胶囊, 每个胶囊宽 `3.5`, 间距 `2`, 高 `12`; 颜色按 20% 一档: 红、橙、黄、薄荷、绿。+- 额度行标签列宽 `34`, 居中显示, 标签允许最小缩放到 `0.75`, 标签到额度条间距 `12`, 额度条到百分比间距 `8`, 百分比列宽 `37`, 百分比到重置时间最小间距 `6`, 重置时间列宽 `75`; 不通过加宽 popover 解决额度行溢出。- 无 quota 数据时显示 `--` / `暂无数据`, 并使用占位色。- `rateLimits` 或 `usage` 使用旧缓存时, 对应区域通过 `.markStale(true)` 降低透明度到 0.55, 不降低饱和度; 下一轮对应接口成功后恢复正常透明度。-- 重置时间格式是 `MM-dd HH:mm`, 在额度行最右侧对齐。+- 重置时间格式是 `MM-dd HH:mm`, 使用等宽数字, 在额度行最右侧对齐。- 更新时间行显示倒计时圆环、「数据更新时间」和 `HH:mm:ss`。- 倒计时只在 popover 可见时用 `TimelineView` 每秒 tick; 普通 tick 不做连续动画, 仅刷新起点变化时播放恢复动画。- token 区域显示「单日峰值」和「全时累计」; `TokenCountText` 对 1K 以下显示完整整数, 1K 起显示 K/M/B。@@ -185,6 +186,7 @@ Popover:- 热力图 hover 使用 `HeatmapDetailPanelController` 展示侧边详情面板, 不是 popover 内 tooltip; 面板作为 popover child window, 不接收鼠标事件, 左右贴边展示并在屏幕可见区域内夹紧。- Hook 关闭时详情面板显示日期、token 数和「用量强度」分段条, 尺寸 `212 x 84`。- Hook 开启时详情面板首行左侧显示日期、右侧显示 token 数, 当天 token 数显示 `--`; 后续显示「用量强度」、「会话总数」、「对话轮次」、「子智能体」、「工具调用」、「权限请求」、「上下文压缩」, 尺寸 `212 x 189`。+- 「用量强度」前置圆点固定为蓝色, 不随用量强度变化。- 工作流统计只展示在用量热力图详情面板中, 不再有单独的工作流统计区。设置窗口:@@ -258,8 +260,8 @@ fix: 修复 Codex 状态刷新Tag:-- tag 名格式 `v{MARKETING_VERSION}`, 例如 `v2.4.4`。-- 使用附注 tag: `git tag -a v2.4.4 -m "Release v2.4.4"`。+- tag 名格式 `v{MARKETING_VERSION}`, 例如 `v2.4.5`。+- 使用附注 tag: `git tag -a v2.4.5 -m "Release v2.4.5"`。## 最终检查diff --git a/CodexBar.xcodeproj/project.pbxproj b/CodexBar.xcodeproj/project.pbxprojindex 2fe24e7..01d9719 100644--- a/CodexBar.xcodeproj/project.pbxproj+++ b/CodexBar.xcodeproj/project.pbxproj@@ -275,7 +275,7 @@"CODE_SIGN_IDENTITY[sdk=macosx*]" = "Apple Development";CODE_SIGN_STYLE = Automatic;COMBINE_HIDPI_IMAGES = YES;- CURRENT_PROJECT_VERSION = 20;+ CURRENT_PROJECT_VERSION = 21;DEVELOPMENT_TEAM = 4KJ362VJW5;ENABLE_APP_INTENTS_METADATA_GENERATION = NO;ENABLE_APP_SANDBOX = NO;@@ -290,7 +290,7 @@"$(inherited)","@executable_path/../Frameworks",);- MARKETING_VERSION = 2.4.4;+ MARKETING_VERSION = 2.4.5;PRODUCT_BUNDLE_IDENTIFIER = app.zabrian.codexbar;PRODUCT_NAME = "$(TARGET_NAME)";REGISTER_APP_GROUPS = YES;@@ -312,7 +312,7 @@"CODE_SIGN_IDENTITY[sdk=macosx*]" = "Apple Development";CODE_SIGN_STYLE = Automatic;COMBINE_HIDPI_IMAGES = YES;- CURRENT_PROJECT_VERSION = 20;+ CURRENT_PROJECT_VERSION = 21;DEVELOPMENT_TEAM = 4KJ362VJW5;ENABLE_APP_INTENTS_METADATA_GENERATION = NO;ENABLE_APP_SANDBOX = NO;@@ -327,7 +327,7 @@"$(inherited)","@executable_path/../Frameworks",);- MARKETING_VERSION = 2.4.4;+ MARKETING_VERSION = 2.4.5;PRODUCT_BUNDLE_IDENTIFIER = app.zabrian.codexbar;PRODUCT_NAME = "$(TARGET_NAME)";PROVISIONING_PROFILE_SPECIFIER = "";diff --git a/CodexBar/Models/CodexQuotaModels.swift b/CodexBar/Models/CodexQuotaModels.swiftindex 20ad8ea..eb3b14c 100644--- a/CodexBar/Models/CodexQuotaModels.swift+++ b/CodexBar/Models/CodexQuotaModels.swift@@ -84,14 +84,14 @@ nonisolated struct QuotaWindow: Equatable, Identifiable {}if minutes.isMultiple(of: 1_440) {- return "\(minutes / 1_440) 天"+ return "\(minutes / 1_440)D"}if minutes.isMultiple(of: 60) {- return "\(minutes / 60) 小时"+ return "\(minutes / 60)H"}- return "\(minutes) 分钟"+ return "\(minutes)M"}}diff --git a/CodexBar/Views/Menu/QuotaRow.swift b/CodexBar/Views/Menu/QuotaRow.swiftindex 3e014a1..23a1539 100644--- a/CodexBar/Views/Menu/QuotaRow.swift+++ b/CodexBar/Views/Menu/QuotaRow.swift@@ -4,21 +4,25 @@ struct QuotaRow: View {let window: QuotaWindowvar body: some View {- HStack(alignment: .center, spacing: Metrics.spacing) {+ HStack(alignment: .center, spacing: 0) {Text(window.label).font(.caption.weight(.semibold)).lineLimit(1)- .frame(width: Metrics.labelWidth, alignment: .leading)+ .minimumScaleFactor(Metrics.labelMinimumScaleFactor)+ .allowsTightening(true)+ .frame(width: Metrics.labelWidth, alignment: .center)SegmentedQuotaBar(percent: displayPercent)+ .padding(.leading, Metrics.labelBarSpacing)Text(percentText).font(.caption.monospacedDigit().weight(.semibold)).foregroundStyle(percentColor).lineLimit(1).frame(width: Metrics.percentWidth, alignment: .leading)+ .padding(.leading, Metrics.barPercentSpacing)- Spacer(minLength: 0)+ Spacer(minLength: Metrics.percentResetSpacing)Text(resetText).font(.caption2.monospacedDigit())@@ -32,10 +36,13 @@ struct QuotaRow: View {private extension QuotaRow {enum Metrics {- static let spacing: CGFloat = 8- static let labelWidth: CGFloat = 52- static let percentWidth: CGFloat = 32- static let resetWidth: CGFloat = 76+ static let labelWidth: CGFloat = 34+ static let labelMinimumScaleFactor: CGFloat = 0.75+ static let labelBarSpacing: CGFloat = 12+ static let barPercentSpacing: CGFloat = 8+ static let percentWidth: CGFloat = 37+ static let percentResetSpacing: CGFloat = 6+ static let resetWidth: CGFloat = 75}var resetText: String {@@ -123,7 +130,7 @@ private extension SegmentedQuotaBar {enum Metrics {static let segmentCount = 50static let segmentWidth: CGFloat = 3.5- static let segmentSpacing: CGFloat = 1.5+ static let segmentSpacing: CGFloat = 2static let segmentHeight: CGFloat = 12static var totalWidth: CGFloat {diff --git a/CodexBar/Views/Menu/UsageHeatmap.swift b/CodexBar/Views/Menu/UsageHeatmap.swiftindex 46543b5..1bf639a 100644--- a/CodexBar/Views/Menu/UsageHeatmap.swift+++ b/CodexBar/Views/Menu/UsageHeatmap.swift@@ -657,7 +657,7 @@ struct UsageHeatmapDayDetailView: View {}private var tokenIntensityDot: some View {- metricDot(tint: tokenIntensityAccent, darkOpacity: 0.88, lightOpacity: 0.76)+ metricDot(tint: .blue, darkOpacity: 0.88, lightOpacity: 0.76)}private func metricRowLayout<Content: View>(@ViewBuilder content: () -> Content) -> some View {@@ -748,10 +748,6 @@ struct UsageHeatmapDayDetailView: View {return min(max(Double(context.day.tokensForHeatmap) / Double(context.peakTokens), 0), 1)}- private var tokenIntensityAccent: Color {- tokenIntensityLevel >= Metrics.tokenIntensitySegmentCount ? .blue : .cyan- }-private func tokenIntensityFill(for index: Int) -> Color {guard index < tokenIntensityLevel else {return Color.blue.opacity(colorScheme == .dark ? 0.14 : 0.10)diff --git a/Docs/DevelopmentGuide.md b/Docs/DevelopmentGuide.mdindex 22c752b..c9fd3ab 100644--- a/Docs/DevelopmentGuide.md+++ b/Docs/DevelopmentGuide.md@@ -450,7 +450,7 @@ Codex 版本探测错误:- 每个 limit 的 `primary` 和 `secondary` 合成 `[QuotaWindow]`- 没有窗口的 limit 被过滤- `remainingPercent = clamp(100 - usedPercent, 0...100)`-- `windowDurationMins` 标签按天, 小时, 分钟格式化, 缺失或非正数显示"额度"+- `windowDurationMins` 标签按 `ND`, `NH`, `NM` 格式化, 缺失或非正数显示"额度"- 本轮 rate limits 请求失败但同账号有旧缓存时复用旧值, 并把 `isRateLimitsStale` 设为 `true`用量规则:@@ -506,8 +506,9 @@ flowchart TD- 多个 limit 间用 `LiquidGlassDivider` 分隔- 每个 quota window 展示标签, 50 个固定胶囊组成的电量条, 剩余百分比和重置时间-- 胶囊宽度为 `3.5`, 间距为 `1.5`, 高度为 `12`-- 重置时间格式为 `MM-dd HH:mm`, 在额度行最右侧对齐+- 胶囊宽度为 `3.5`, 间距为 `2`, 高度为 `12`+- 额度行标签列宽 `34`, 居中显示, 标签允许最小缩放到 `0.75`, 标签到电量条间距 `12`, 电量条到百分比间距 `8`, 百分比列宽 `37`, 百分比到重置时间最小间距 `6`, 重置时间列宽 `75`+- 重置时间格式为 `MM-dd HH:mm`, 使用等宽数字, 在额度行最右侧对齐- 无数据时百分比和重置时间显示 `--`, 电量条用占位色- stale 数据通过 `.markStale(true)` 降低透明度到 0.55@@ -529,6 +530,7 @@ flowchart TD| 开启 | 日期, token 数, "用量强度"分段条, 会话总数, 对话轮次, 子智能体, 工具调用, 权限请求, 上下文压缩 | `212 x 189` |Hook 开启且当天没有 token bucket 时, 今天的 token 数显示 `--`。日期使用 `AnimatedDateText` 做数字滚动, token 数使用 `TokenCountText` 并保留数字和单位宽度。+「用量强度」前置圆点固定为蓝色, 不随用量强度变化。更新时间行:diff --git a/appcast.xml b/appcast.xmlindex f24b40c..323b9ba 100644--- a/appcast.xml+++ b/appcast.xml@@ -7,6 +7,15 @@<link>https://codexbar.zabrian.app/appcast.xml</link><description>CodexBar appcast feed</description><language>zh-CN</language>+ <item>+ <title>CodexBar.app 2.4.5</title>+ <sparkle:version>21</sparkle:version>+ <sparkle:shortVersionString>2.4.5</sparkle:shortVersionString>+ <sparkle:minimumSystemVersion>15.0</sparkle:minimumSystemVersion>+ <sparkle:releaseNotesLink>https://codexbar.zabrian.app/notes#2.4.5</sparkle:releaseNotesLink>+ <pubDate>Tue, 23 Jun 2026 12:04:18 +0800</pubDate>+ <enclosure url="https://codexbar.zabrian.app/download/CodexBar-v2.4.5.dmg" sparkle:edSignature="GPNqVI92o8IBzzNR1mgs2B4xRql6SQy2SSu58FiIRsFYo3z/Ir8DRzvlPLbeYNHYXaGOnw42SyrqAieJPhyHDQ==" length="3023597" type="application/octet-stream"/>+ </item><item><title>CodexBar.app 2.4.4</title><sparkle:version>20</sparkle:version>