Skip to content

CodexBar 是一个 macOS 菜单栏应用,用于查看本机 Codex 账号状态、额度、Token 用量、详细统计信息

fix: 优化额度行布局

Bob5601168b2ea4
diff --git a/AGENTS.md b/AGENTS.md
index 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.pbxproj
index 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.swift
index 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.swift
index 3e014a1..23a1539 100644
--- a/CodexBar/Views/Menu/QuotaRow.swift
+++ b/CodexBar/Views/Menu/QuotaRow.swift
@@ -4,21 +4,25 @@ struct QuotaRow: View {
let window: QuotaWindow
var 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 = 50
static let segmentWidth: CGFloat = 3.5
- static let segmentSpacing: CGFloat = 1.5
+ static let segmentSpacing: CGFloat = 2
static let segmentHeight: CGFloat = 12
static var totalWidth: CGFloat {
diff --git a/CodexBar/Views/Menu/UsageHeatmap.swift b/CodexBar/Views/Menu/UsageHeatmap.swift
index 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.md
index 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.xml
index 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>