CodexBar 是一个 macOS 菜单栏应用,用于查看本机 Codex 账号状态、额度、Token 用量、详细统计信息
Swift appkitcodexcodex-clideveloper-toolsmacosmacos-appmenu-bar-appopenai-codexproductivityswiftswiftuiusage-tracker
fix: 修复通知选项面板显示
Bobc93fa8d20a3e
diff --git a/CodexBar.xcodeproj/project.pbxproj b/CodexBar.xcodeproj/project.pbxprojindex 66dd585..adfbccd 100644--- a/CodexBar.xcodeproj/project.pbxproj+++ b/CodexBar.xcodeproj/project.pbxproj@@ -274,7 +274,7 @@"CODE_SIGN_IDENTITY[sdk=macosx*]" = "Apple Development";CODE_SIGN_STYLE = Automatic;COMBINE_HIDPI_IMAGES = YES;- CURRENT_PROJECT_VERSION = 52;+ CURRENT_PROJECT_VERSION = 53;DEAD_CODE_STRIPPING = YES;DEVELOPMENT_TEAM = 4KJ362VJW5;ENABLE_APP_INTENTS_METADATA_GENERATION = NO;@@ -290,7 +290,7 @@"$(inherited)","@executable_path/../Frameworks",);- MARKETING_VERSION = 3.4.2;+ MARKETING_VERSION = 3.4.3;PRODUCT_BUNDLE_IDENTIFIER = app.zabrian.codexbar;PRODUCT_NAME = "$(TARGET_NAME)";REGISTER_APP_GROUPS = YES;@@ -313,7 +313,7 @@"CODE_SIGN_IDENTITY[sdk=macosx*]" = "Apple Development";CODE_SIGN_STYLE = Automatic;COMBINE_HIDPI_IMAGES = YES;- CURRENT_PROJECT_VERSION = 52;+ CURRENT_PROJECT_VERSION = 53;DEAD_CODE_STRIPPING = YES;DEVELOPMENT_TEAM = 4KJ362VJW5;ENABLE_APP_INTENTS_METADATA_GENERATION = NO;@@ -329,7 +329,7 @@"$(inherited)","@executable_path/../Frameworks",);- MARKETING_VERSION = 3.4.2;+ MARKETING_VERSION = 3.4.3;PRODUCT_BUNDLE_IDENTIFIER = app.zabrian.codexbar;PRODUCT_NAME = "$(TARGET_NAME)";PROVISIONING_PROFILE_SPECIFIER = "";diff --git a/CodexBar/Controllers/NotificationOptionsPanelController.swift b/CodexBar/Controllers/NotificationOptionsPanelController.swiftindex 28139f7..712670f 100644--- a/CodexBar/Controllers/NotificationOptionsPanelController.swift+++ b/CodexBar/Controllers/NotificationOptionsPanelController.swift@@ -21,6 +21,7 @@ final class NotificationOptionsPanelController {private lazy var presenter = SidePanelDrawerPresenter(animationKey: Metrics.drawerTransformAnimationKey,makesKey: true,+ usesUntranslatedInitialLayout: true,contentViewProvider: { [weak self] inself?.hostingController?.view}@@ -30,6 +31,7 @@ final class NotificationOptionsPanelController {private var settingsWindowDismissObservers: [NSObjectProtocol] = []private var cancellables = Set<AnyCancellable>()private var panelResizeTask: Task<Void, Never>?+ private var isEntryAnimationRunning = falseinit(notificationSettings: NotificationSettings,@@ -79,6 +81,7 @@ final class NotificationOptionsPanelController {codexCLINotificationSettings.refresh()let panel = ensurePanel()+ panel.contentView?.layoutSubtreeIfNeeded()let windowSurfaceFrame = SidePanelSupport.contentScreenFrame(for: contentView, in: window) ?? window.framelet panelSize = measuredPanelSize()let validatedAlignmentFrame = SidePanelSupport.validatedAlignmentScreenFrame(@@ -99,10 +102,22 @@ final class NotificationOptionsPanelController {panel.level = window.levelinstallSettingsWindowDismissObservers(for: window)- presenter.present(panel, at: position, relativeTo: window)+ panelResizeTask?.cancel()+ isEntryAnimationRunning = true+ presenter.present(panel, at: position, relativeTo: window) { [weak self] in+ guard let self else {+ return+ }++ isEntryAnimationRunning = false+ schedulePanelResize()+ }}func hide(immediate: Bool = false) {+ panelResizeTask?.cancel()+ panelResizeTask = nil+ isEntryAnimationRunning = falsepresenter.hide(immediate: immediate)}@@ -158,7 +173,7 @@ final class NotificationOptionsPanelController {object: window,queue: .main) { [weak self] _ in- Task { @MainActor [weak self] in+ MainActor.assumeIsolated {self?.hide(immediate: true)}}@@ -210,7 +225,7 @@ final class NotificationOptionsPanelController {}private func schedulePanelResize() {- guard panel != nil else {+ guard panel != nil, !isEntryAnimationRunning else {return}diff --git a/CodexBar/Controllers/SidePanelSupport.swift b/CodexBar/Controllers/SidePanelSupport.swiftindex 512c78a..05e4576 100644--- a/CodexBar/Controllers/SidePanelSupport.swift+++ b/CodexBar/Controllers/SidePanelSupport.swift@@ -148,6 +148,7 @@ final class SidePanelDrawerAnimator {@MainActorfinal class SidePanelDrawerPresenter {private let makesKey: Bool+ private let usesUntranslatedInitialLayout: Boolprivate let drawerAnimator: SidePanelDrawerAnimatorprivate weak var panel: NSPanel?private var visibilityGeneration = 0@@ -158,9 +159,11 @@ final class SidePanelDrawerPresenter {init(animationKey: String,makesKey: Bool = false,+ usesUntranslatedInitialLayout: Bool = false,contentViewProvider: @escaping @MainActor () -> NSView?) {self.makesKey = makesKey+ self.usesUntranslatedInitialLayout = usesUntranslatedInitialLayoutdrawerAnimator = SidePanelDrawerAnimator(contentViewProvider: contentViewProvider,animationKey: animationKey,@@ -173,7 +176,12 @@ final class SidePanelDrawerPresenter {}/// 内容更新由调用方在 present 之前完成- func present(_ panel: NSPanel, at position: SidePanelPosition, relativeTo parentWindow: NSWindow) {+ func present(+ _ panel: NSPanel,+ at position: SidePanelPosition,+ relativeTo parentWindow: NSWindow,+ completion: @escaping @MainActor () -> Void = {}+ ) {self.panel = panelvisibilityGeneration += 1isExitAnimationRunning = false@@ -182,7 +190,7 @@ final class SidePanelDrawerPresenter {let generation = visibilityGenerationlet hidden = drawerAnimator.hiddenTranslation(for: currentSide, panelWidth: panel.frame.width)- drawerAnimator.setTranslation(hidden)+ drawerAnimator.setTranslation(usesUntranslatedInitialLayout ? 0 : hidden)panel.alphaValue = 0self.parentWindow = parentWindowSidePanelSupport.attach(panel, to: parentWindow)@@ -198,7 +206,12 @@ final class SidePanelDrawerPresenter {self?.visibilityGeneration == generation},completion: { [weak self] in- self?.drawerAnimator.setTranslation(0)+ guard let self else {+ return+ }++ drawerAnimator.setTranslation(0)+ completion()})}diff --git a/CodexBar/Views/Settings/NotificationOptionsView.swift b/CodexBar/Views/Settings/NotificationOptionsView.swiftindex b998f7b..441754d 100644--- a/CodexBar/Views/Settings/NotificationOptionsView.swift+++ b/CodexBar/Views/Settings/NotificationOptionsView.swift@@ -184,6 +184,8 @@ struct NotificationOptionsView: View {}}+ /// Swift 6.3.3 在 -O 下会让这两个行构建器中的原生 mini Switch 漏绘 thumb+ @_optimize(none)private func optionRow(title: String,isOn: Binding<Bool>,@@ -224,6 +226,7 @@ struct NotificationOptionsView: View {}}+ @_optimize(none)private func notificationOptionRow(title: String,isOn: Binding<Bool>,@@ -232,6 +235,7 @@ struct NotificationOptionsView: View {@ViewBuilder accessory: () -> some View) -> some View {let showsSoundControls = isEnabled && isOn.wrappedValue+ let canPreviewSound = sound.wrappedValue != .silentreturn VStack(spacing: 0) {HStack(spacing: Metrics.notificationControlSpacing) {@@ -263,12 +267,24 @@ struct NotificationOptionsView: View {Spacer(minLength: 8)soundMenu(selection: sound)++ Button {+ playPreview(for: sound.wrappedValue)+ } label: {+ Image(systemName: "play.circle")+ .font(.system(size: Metrics.soundPreviewIconSize))+ .frame(+ width: Metrics.soundPreviewButtonSize,+ height: Metrics.soundPreviewButtonSize+ )+ }+ .buttonStyle(.borderless)+ .foregroundStyle(canPreviewSound ? .secondary : .tertiary)+ .disabled(!canPreviewSound)}.frame(height: Metrics.soundRowHeight)- .transition(.opacity.combined(with: .move(edge: .top)))}}- .animation(Metrics.statusAnimation, value: showsSoundControls)}private func optionPicker(@@ -373,8 +389,9 @@ struct NotificationOptionsView: View {static let notificationControlSpacing: CGFloat = 6static let pickerWidth: CGFloat = 68static let soundMenuWidth: CGFloat = 160+ static let soundPreviewButtonSize: CGFloat = 18+ static let soundPreviewIconSize: CGFloat = 13static let statusIconSize: CGFloat = 16static let cornerRadius: CGFloat = 12- static let statusAnimation = Animation.codexStatus}}diff --git a/Docs/DevelopmentGuide.md b/Docs/DevelopmentGuide.mdindex 3d57ecc..152b6b9 100644--- a/Docs/DevelopmentGuide.md+++ b/Docs/DevelopmentGuide.md@@ -169,6 +169,8 @@ Command-Space 不直接关闭菜单面板, 只短暂抑制 600 ms 内的 active侧边面板的共同行为集中在 `CodexBar/Controllers/SidePanelSupport.swift`。`NonactivatingSidePanel` 不能成为 key/main window;`KeyableBorderlessPanel` 用于需要键盘焦点的通知子选项面板和 fallback 面板;`SidePanelDrawerAnimator` 管理横向抽屉 transform;`SidePanelDrawerPresenter` 管理重置次数、并发任务中心和通知子选项面板的显隐状态、generation、入退场动画及 child window 挂载;`SidePanelContentHost` 统一三个侧边详情面板的内容宿主行为——懒建 panel + hostingController、每次更新替换 rootView、圆角 layer 重配、内容尺寸同步与屏幕点命中检测。`SidePanelSupport` 统一提供 panel 创建、左右侧选择、屏幕边界夹紧、锚点行校验与对齐、菜单面板 key window 恢复、圆角 layer 配置和屏幕坐标换算。侧边面板视图的玻璃底、背板、描边和圆角裁剪共用 `LiquidGlassStyle.swift` 的 `sidePanelChrome(cornerRadius:)`。+通知子选项面板包含 SwiftUI 承载的原生 AppKit 控件,因此通过 `SidePanelDrawerPresenter.usesUntranslatedInitialLayout` 先以 identity transform 完成首次布局和显示提交,再在下一个 MainActor 调度点应用隐藏位移并执行入场动画;重置次数和任务中心仍直接从隐藏位移开始。`present` 的 completion 只在当前 generation 的入场动画完成后调用,供通知面板恢复 fitting-size 更新。设置窗口发出 `willClose` 时,控制器在同一主线程通知中立即隐藏并解除通知面板的 child window 挂载,避免复用设置窗口时残留面板重新出现或补播退出动画。+`HeatmapDetailPanelController` 管理 hover 请求、Y 轴策略、侧边切换队列和 token/workflow 内容更新;`ResetCreditsPanelController` 管理重置次数内容、最大高度和点击切换;`ActivityCenterPanelController` 观察常驻 Monitor 快照并更新列表与窗口布局。任务中心宽度固定,高度由标题、分区、固定行高、间距和底部留白计算,并受屏幕可见高度及活动卡片顶边到主面板底边的范围限制。活动卡片把 `ScreenFrameProvider` 作为锚点交给控制器,控制器每次布局都只读取属于当前菜单窗口的实时 frame;首次读取失败时等待一个 MainActor 调度点重试,仍无有效锚点才回退主面板垂直居中。锚点有效时,面板顶边与卡片顶边对齐,底边最低与主面板底边齐平;达到高度上限后列表内部滚动。任务中心列表使用普通 `VStack` 和单层条目 transition。快照变化后,SwiftUI 提交列表布局,AppKit 在下一个 MainActor 调度点用 0.20 秒 ease-in-ease-out 曲线更新 panel frame;新的快照会取消尚未执行的布局更新。任务中心内容变空时等待 0.20 秒再执行抽屉收起,期间出现新内容会取消收起。@@ -1138,7 +1140,9 @@ App 再次成为 active 时, 也会刷新 Hook、同步、菜单栏额度、主活动并发以 session 为边界:不同 session 可以同时运行;同一 session 的 turn 按顺序执行。收到新的 `UserPromptSubmit` 时,monitor 会让该 session 中更早且缺少结束信号的 turn 立即退出活动列表,但保留为等待终态确认任务并触发一次即时 rollout 查询;5 秒内收到 Hook `Stop`、rollout `task_complete` 或 `turn_aborted` 时按真实终态归类,到期仍无终态才生成灰色最近终止记录。子 Agent 事件只能通过共享 session 关联父任务,早于当前顶层任务可信开始时间的事件会被当作上一 turn 的迟到事件忽略。已完成和已终止任务键分别保留 24 小时 tombstone,避免迟到事件恢复旧任务或误操作同 session 的新 turn。终止不会触发绿色完成状态、长任务通知或完成触觉反馈。Hook `Stop` 与 rollout `task_complete` 均视为完成信号,先到者生效,后到者按任务键和 session 回退键去重;重复完成不会覆盖首次确认结果,也不会缩短去重窗口或再次触发反馈。-设置页交互: 「系统通知」主开关行保留在设置窗口内, 子选项 (五类通知子开关与声音、任务触觉开关、Codex TUI 通知开关及两个阈值 Picker) 在主选项右侧的子面板中展开 (`NotificationOptionsPanelController`, 复用 SidePanelSupport 抽屉机制挂在设置窗口上, 内容用常驻 hosting controller + ObservableObject 驱动)。五类通知按需使用双行布局:第一行展示通知名称、可选阈值和开关,阈值 Picker 位于开关前;通知开启且依赖可用时,第二行展示「通知音效」和加宽的声音菜单,关闭时整行从布局移除。控制器订阅五类通知开关和 Hook 状态,在 SwiftUI 完成布局后按 fitting size 动画调整面板高度并保持面板顶边位置,避免收起后残留空白。菜单顶层提供系统提示音和静音,其他声音按「经典提示音」和「现代提示音」子菜单分组。选择任意声音时立即试听,再次选择当前项可重复试听,新的试听会停止上一段自定义声音;系统提示音使用 `NSSound.beep()`, 静音不播放预览,其余声音优先播放 App 包内与正式通知同源的 WAV。选项依次排列为「任务完成通知」「任务等待通知」「额度预警通知」「额度重置通知」「重置临期通知」「任务触觉反馈」和「Codex TUI 通知」。主开关开启后仅在系统授权允许时展开, 首次授权场景会等待授权结果; 点击行内滑杆按钮可手动展开; 设置窗口 resign key/关闭、主开关关闭或授权变为被拒时自动收起。任务完成、任务等待与任务触觉子项在 Hook 未开启时显示为关闭并置灰, 不修改各自持久化偏好及声音, Hook 重新开启后恢复用户原选择。「Codex TUI 通知」与用户级 `[tui] notifications` 联动,面板打开时刷新,写入后回读验证;已有 CLI 会话需重启后生效。该项不服从 CodexBar 通知发送判定,也不修改顶层 `notify`。「主面板任务中心」沿用相同依赖语义;关闭只隐藏活动卡片和任务中心入口,不停止 Monitor、状态点、通知或触觉反馈。授权被拒的引导文案与"打开系统设置"按钮仍内联显示在主开关行下方, 插入提示时不触发设置项纵向动画。+设置页交互: 「系统通知」主开关行保留在设置窗口内, 子选项 (五类通知子开关与声音、任务触觉开关、Codex TUI 通知开关及两个阈值 Picker) 在主选项右侧的子面板中展开 (`NotificationOptionsPanelController`, 复用 SidePanelSupport 抽屉机制挂在设置窗口上, 内容用常驻 hosting controller + ObservableObject 驱动)。五类通知按需使用双行布局:第一行展示通知名称、可选阈值和开关,阈值 Picker 位于开关前;通知开启且依赖可用时,第二行展示「通知音效」、加宽的声音菜单和独立播放按钮,关闭时整行从布局移除。控制器订阅五类通知开关和 Hook 状态;入场期间暂停 fitting-size 更新,动画完成后重新测量,后续内容变化在 SwiftUI 完成布局后按 fitting size 动画调整面板高度并保持面板顶边位置,避免收起后残留空白。菜单顶层提供系统提示音和静音,其他声音按「经典提示音」和「现代提示音」子菜单分组。选择任意声音时立即试听,播放按钮可重复试听当前非静音选项,新的试听会停止上一段自定义声音;系统提示音使用 `NSSound.beep()`, 静音不播放预览且禁用播放按钮,其余声音优先播放 App 包内与正式通知同源的 WAV。选项依次排列为「任务完成通知」「任务等待通知」「额度预警通知」「额度重置通知」「重置临期通知」「任务触觉反馈」和「Codex TUI 通知」。主开关开启后仅在系统授权允许时展开, 首次授权场景会等待授权结果; 点击行内滑杆按钮可手动展开; 设置窗口 resign key/关闭、主开关关闭或授权变为被拒时自动收起。任务完成、任务等待与任务触觉子项在 Hook 未开启时显示为关闭并置灰, 不修改各自持久化偏好及声音, Hook 重新开启后恢复用户原选择。「Codex TUI 通知」与用户级 `[tui] notifications` 联动,面板打开时刷新,写入后回读验证;已有 CLI 会话需重启后生效。该项不服从 CodexBar 通知发送判定,也不修改顶层 `notify`。「主面板任务中心」沿用相同依赖语义;关闭只隐藏活动卡片和任务中心入口,不停止 Monitor、状态点、通知或触觉反馈。授权被拒的引导文案与"打开系统设置"按钮仍内联显示在主开关行下方, 插入提示时不触发设置项纵向动画。++`NotificationOptionsView` 的两个实际行构建器保留 `@_optimize(none)`:Swift 6.3.3 在 `-O` 下优化这些包含原生 mini Switch 的动态布局时会漏绘开关 thumb。该约束只覆盖 `optionRow` 和带 accessory 的 `notificationOptionRow` 实现,其余通知视图与 Release target 继续使用正常优化;调整这两个构建器的编译属性后需要用 Release 产物人工检查开启状态的 thumb。五类通知的触发与去重:diff --git a/Docs/UserGuide.md b/Docs/UserGuide.mdindex 6e5664b..df244af 100644--- a/Docs/UserGuide.md+++ b/Docs/UserGuide.md@@ -486,7 +486,7 @@ Hook 与当前 App 位置相关。建议先在旧位置关闭 Hook,把 App 移任务完成、任务等待和任务触觉选项依赖 Hook。Hook 关闭时,它们会置灰,但会保留此前选择。-五类 CodexBar 系统通知都可以独立选择声音,默认使用 macOS 系统通知声;选择「静音」时只显示通知。声音菜单将选项分为 14 个经典提示音和 17 个现代提示音,包括 Basso、Glass、Sosumi、Antic、Droplet、Portal、Received Message 等。打开声音菜单并选择任意声音时会立即试听;再次选择当前声音可以重复试听。声音偏好会在通知关闭或 Hook 暂停时保留;Codex TUI 通知由 Codex CLI 自己播放,不使用这里的声音设置。+CodexBar 系统通知都可以独立选择声音,默认使用 macOS 系统通知声;选择「静音」时只显示通知。声音菜单将选项分为 14 个经典提示音和 17 个现代提示音,包括 Basso、Glass、Sosumi、Antic、Droplet、Portal、Received Message 等。打开声音菜单并选择任意声音时会立即试听;也可以点击声音右侧的播放按钮重复试听当前选项,选择「静音」时该按钮不可用。声音偏好会在通知关闭或 Hook 暂停时保留;Codex TUI 通知由 Codex CLI 自己播放,不使用这里的声音设置。### 图标与状态@@ -494,6 +494,7 @@ Hook 与当前 App 位置相关。建议先在旧位置关闭 Hook,把 App 移| ---------------------------- | ------------------------------ || 「系统通知」右侧滑杆 | 打开通知子选项 || 通知声音菜单 | 选择声音并立即试听 |+| 通知声音右侧播放按钮 | 重复试听当前声音;静音时不可用 || Codex TUI 通知旁的小进度圈 | 正在读取或保存设置 || Codex TUI 通知旁的橙色感叹号 | 读取或保存失败;悬停可查看原因 || 「打开系统设置」按钮 | macOS 尚未授权 CodexBar 通知 |diff --git a/README.md b/README.mdindex 0945d61..0a1c42b 100644--- a/README.md+++ b/README.md@@ -14,7 +14,7 @@ CodexBar 是一款无 Dock 图标的 macOS 菜单栏应用。无需打开 Codex- **Token 热力图**:用近 30 周日历热力图回顾每日 Token 用量- **实时任务**:开启 Codex Hook 后,查看运行中、等待批准、最近完成和终止的任务- **工作流统计**:按日期查看会话、对话轮次、工具调用、权限请求、上下文压缩和子 Agent 等数据-- **及时提醒**:可选额度告急、额度恢复、等待批准、长任务完成通知与触觉反馈,各类通知可独立选择声音+- **及时提醒**:可选额度告急、额度恢复、等待批准、长任务完成通知与触觉反馈,各类通知声音可独立选择- **跨设备汇总**:通过可选的 iCloud 私有数据库同步每日聚合数据- **本地优先**:账号、额度、Token 用量和工作流事件均以本机处理为主- **原生体验**:支持全局快捷键、开机启动、系统日志和 Sparkle 自动更新diff --git a/appcast.xml b/appcast.xmlindex f457381..2579d32 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 3.4.3</title>+ <sparkle:version>53</sparkle:version>+ <sparkle:shortVersionString>3.4.3</sparkle:shortVersionString>+ <sparkle:minimumSystemVersion>15.0</sparkle:minimumSystemVersion>+ <sparkle:releaseNotesLink>https://codexbar.zabrian.app/notes#3.4.3</sparkle:releaseNotesLink>+ <pubDate>Thu, 23 Jul 2026 16:29:02 +0800</pubDate>+ <enclosure url="https://codexbar.zabrian.app/download/CodexBar-v3.4.3.dmg" sparkle:edSignature="t2uhg2bwGtLsQu7vq/SmUQXKKCJOQD0CxviTd689rfe0ahGzOrVRDyH8MDED7D4RRDPeyisiObC+rNSYKCf1AA==" length="5676850" type="application/octet-stream"/>+ </item><item><title>CodexBar.app 3.4.2</title><sparkle:version>52</sparkle:version>