CodexBar 是一个 macOS 菜单栏应用,用于查看本机 Codex 账号状态、额度、Token 用量、详细统计信息
Swift appkitcodexcodex-clideveloper-toolsmacosmacos-appmenu-bar-appopenai-codexproductivityswiftswiftuiusage-tracker
feat: 优化任务状态与提醒反馈
Bobc7823743a2ee
diff --git a/CodexBar.xcodeproj/project.pbxproj b/CodexBar.xcodeproj/project.pbxprojindex 4cbaf84..91a9c92 100644--- a/CodexBar.xcodeproj/project.pbxproj+++ b/CodexBar.xcodeproj/project.pbxproj@@ -282,7 +282,7 @@"CODE_SIGN_IDENTITY[sdk=macosx*]" = "Apple Development";CODE_SIGN_STYLE = Automatic;COMBINE_HIDPI_IMAGES = YES;- CURRENT_PROJECT_VERSION = 39;+ CURRENT_PROJECT_VERSION = 40;DEAD_CODE_STRIPPING = YES;DEVELOPMENT_TEAM = 4KJ362VJW5;ENABLE_APP_INTENTS_METADATA_GENERATION = NO;@@ -298,7 +298,7 @@"$(inherited)","@executable_path/../Frameworks",);- MARKETING_VERSION = 3.3.1;+ MARKETING_VERSION = 3.3.2;PRODUCT_BUNDLE_IDENTIFIER = app.zabrian.codexbar;PRODUCT_NAME = "$(TARGET_NAME)";REGISTER_APP_GROUPS = YES;@@ -321,7 +321,7 @@"CODE_SIGN_IDENTITY[sdk=macosx*]" = "Apple Development";CODE_SIGN_STYLE = Automatic;COMBINE_HIDPI_IMAGES = YES;- CURRENT_PROJECT_VERSION = 39;+ CURRENT_PROJECT_VERSION = 40;DEAD_CODE_STRIPPING = YES;DEVELOPMENT_TEAM = 4KJ362VJW5;ENABLE_APP_INTENTS_METADATA_GENERATION = NO;@@ -337,7 +337,7 @@"$(inherited)","@executable_path/../Frameworks",);- MARKETING_VERSION = 3.3.1;+ MARKETING_VERSION = 3.3.2;PRODUCT_BUNDLE_IDENTIFIER = app.zabrian.codexbar;PRODUCT_NAME = "$(TARGET_NAME)";PROVISIONING_PROFILE_SPECIFIER = "";diff --git a/CodexBar/Controllers/StatusItemController.swift b/CodexBar/Controllers/StatusItemController.swiftindex c111350..6d78e04 100644--- a/CodexBar/Controllers/StatusItemController.swift+++ b/CodexBar/Controllers/StatusItemController.swift@@ -163,10 +163,11 @@ private final class StatusItemController: NSObject, NSMenuDelegate {super.init()}- /// tint 为 nil 时使用模板渲染,由系统按菜单栏外观着色。+ /// 无状态点和额度条时使用模板渲染,由系统按菜单栏外观着色。private static func makeStatusImage(_ symbolName: String,- tint: NSColor?,+ indicatorTint: NSColor? = nil,+ indicatorVisibility: CGFloat = 1,progress: StatusIconProgress? = nil,progressVisibility: CGFloat = 1) -> NSImage? {@@ -174,23 +175,29 @@ private final class StatusItemController: NSObject, NSMenuDelegate {return nil}- let resolvedProgressVisibility = clampedProgressVisibility(progressVisibility)+ let usesTemplateRendering = indicatorTint == nil && progress == nillet statusImage = NSImage(size: Metrics.progressStatusImageSize, flipped: false) { _ inSelf.drawStatusSymbol(symbolImage,in: Metrics.progressStatusSymbolRect,- tint: tint ?? .black,+ tint: usesTemplateRendering ? .black : .labelColor,alpha: progress?.isStale == true ? Metrics.staleIconAlpha : 1)if let progress {Self.drawProgress(progress,- visibility: resolvedProgressVisibility+ visibility: progressVisibility+ )+ }+ if let indicatorTint {+ Self.drawStatusIndicator(+ tint: indicatorTint,+ visibility: indicatorVisibility)}return true}- statusImage.isTemplate = tint == nil+ statusImage.isTemplate = usesTemplateRenderingstatusImage.alignmentRect = Self.statusImageAlignmentRect(for: symbolImage)return statusImage}@@ -223,6 +230,19 @@ private final class StatusItemController: NSObject, NSMenuDelegate {NSGraphicsContext.restoreGraphicsState()}+ private static func drawStatusIndicator(+ tint: NSColor,+ visibility: CGFloat+ ) {+ let visibility = clampedVisibility(visibility)+ guard visibility > 0 else {+ return+ }++ tint.withAlphaComponent(visibility).setFill()+ NSBezierPath(ovalIn: Metrics.statusIndicatorRect).fill()+ }+private static func statusImageAlignmentRect(for symbolImage: NSImage) -> NSRect {NSRect(x: 0,@@ -236,7 +256,7 @@ private final class StatusItemController: NSObject, NSMenuDelegate {_ progress: StatusIconProgress,visibility: CGFloat) {- let visibility = clampedProgressVisibility(visibility)+ let visibility = clampedVisibility(visibility)guard visibility > 0 else {return}@@ -276,12 +296,12 @@ private final class StatusItemController: NSObject, NSMenuDelegate {.fill()}- private static func clampedProgressVisibility(_ value: CGFloat) -> CGFloat {+ private static func clampedVisibility(_ value: CGFloat) -> CGFloat {min(max(value, 0), 1)}- private static func easedProgressVisibility(_ value: CGFloat) -> CGFloat {- let value = clampedProgressVisibility(value)+ private static func easedVisibility(_ value: CGFloat) -> CGFloat {+ let value = clampedVisibility(value)return value * value * (3 - 2 * value)}@@ -294,31 +314,22 @@ private final class StatusItemController: NSObject, NSMenuDelegate {usesErrorImage ? Metrics.errorStatusSymbolName : Metrics.normalStatusSymbolName}- var tint: StatusIconTint {- guard !usesErrorImage else {- return .red- }-+ var indicator: ActivityIndicator? {switch activity.primaryActivity {case .waiting:- return .orange+ .waitingcase .running:- return .blue+ .runningcase .completed(_, highlighted: true):- return .green+ .completedcase .completed, .idle:- return .label+ nil}}- /// nil 表示模板渲染,由系统按菜单栏外观着色。- var renderTint: NSColor? {- tint == .label && progress == nil ? nil : tint.color- }-/// 只包含影响图像像素的字段;tooltip 文本变化不应触发重绘。var renderState: StatusIconRenderState {- StatusIconRenderState(symbolName: symbolName, tint: tint, progress: progress)+ StatusIconRenderState(symbolName: symbolName, indicator: indicator, progress: progress)}var hasLiveDuration: Bool {@@ -382,24 +393,20 @@ private final class StatusItemController: NSObject, NSMenuDelegate {/// 状态图标中影响像素的渲染子状态,用于跳过 tooltip-only 变化引发的重绘。private struct StatusIconRenderState: Equatable {let symbolName: String- let tint: StatusIconTint+ let indicator: ActivityIndicator?let progress: StatusIconProgress?}- private enum StatusIconTint: Equatable {- case label- case blue- case orange- case green- case red+ private enum ActivityIndicator: Equatable {+ case waiting+ case running+ case completedvar color: NSColor {switch self {- case .label: .labelColor- case .blue: .systemBlue- case .orange: .systemOrange- case .green: .systemGreen- case .red: .systemRed+ case .waiting: .systemOrange+ case .running: .systemBlue+ case .completed: .systemGreen}}}@@ -637,7 +644,7 @@ private final class StatusItemController: NSObject, NSMenuDelegate {statusIconAnimationTask?.cancel()let progressVisibilityChanged = (previousState.progress == nil) != (state.progress == nil)- if previousState.tint != state.tint || progressVisibilityChanged {+ if previousState.indicator != state.indicator || progressVisibilityChanged {animateStatusImage(from: previousState, to: state)return}@@ -648,41 +655,47 @@ private final class StatusItemController: NSObject, NSMenuDelegate {private func renderStatusImage(_ state: StatusIconState) {statusItem.button?.image = Self.makeStatusImage(state.symbolName,- tint: state.renderTint,+ indicatorTint: state.indicator?.color,progress: state.progress)}private func animateStatusImage(from previousState: StatusIconState, to finalState: StatusIconState) {let renderedProgress = finalState.progress ?? previousState.progress- let fromVisibility: CGFloat = previousState.progress == nil ? 0 : 1- let toVisibility: CGFloat = finalState.progress == nil ? 0 : 1+ let fromProgressVisibility: CGFloat = previousState.progress == nil ? 0 : 1+ let toProgressVisibility: CGFloat = finalState.progress == nil ? 0 : 1+ let fromIndicatorVisibility: CGFloat = previousState.indicator == nil ? 0 : 1+ let toIndicatorVisibility: CGFloat = finalState.indicator == nil ? 0 : 1statusIconAnimationTask = Task { @MainActor [weak self] in- for frame in 0 ... Metrics.statusIconProgressAnimationFrameCount {+ for frame in 0 ... Metrics.statusIconAnimationFrameCount {guard let self,!Task.isCancelled,statusIconState?.renderState == finalState.renderState else {return}- let rawProgress = CGFloat(frame) / CGFloat(Metrics.statusIconProgressAnimationFrameCount)- let easedProgress = Self.easedProgressVisibility(rawProgress)- let visibility = fromVisibility + (toVisibility - fromVisibility) * easedProgress+ let rawProgress = CGFloat(frame) / CGFloat(Metrics.statusIconAnimationFrameCount)+ let easedProgress = Self.easedVisibility(rawProgress)+ let progressVisibility = fromProgressVisibility+ + (toProgressVisibility - fromProgressVisibility) * easedProgress+ let indicatorVisibility = fromIndicatorVisibility+ + (toIndicatorVisibility - fromIndicatorVisibility) * easedProgressstatusItem.button?.image = Self.makeStatusImage(finalState.symbolName,- tint: Self.interpolatedStatusTint(- from: previousState.tint.color,- to: finalState.tint.color,+ indicatorTint: Self.interpolatedIndicatorTint(+ from: previousState.indicator,+ to: finalState.indicator,progress: easedProgress),+ indicatorVisibility: indicatorVisibility,progress: renderedProgress,- progressVisibility: visibility+ progressVisibility: progressVisibility)- if frame < Metrics.statusIconProgressAnimationFrameCount {+ if frame < Metrics.statusIconAnimationFrameCount {try? await Task.sleep(- nanoseconds: Metrics.statusIconProgressAnimationFrameDelayNanoseconds+ nanoseconds: Metrics.statusIconAnimationFrameDelayNanoseconds)}}@@ -719,14 +732,21 @@ private final class StatusItemController: NSObject, NSMenuDelegate {}}- private static func interpolatedStatusTint(- from source: NSColor,- to destination: NSColor,+ private static func interpolatedIndicatorTint(+ from source: ActivityIndicator?,+ to destination: ActivityIndicator?,progress: CGFloat- ) -> NSColor {- let progress = clampedProgressVisibility(progress)- return source.blended(withFraction: progress, of: destination)- ?? (progress < 0.5 ? source : destination)+ ) -> NSColor? {+ switch (source, destination) {+ case let (source?, destination?):+ let progress = clampedVisibility(progress)+ return source.color.blended(withFraction: progress, of: destination.color)+ ?? (progress < 0.5 ? source.color : destination.color)+ case let (indicator?, nil), let (nil, indicator?):+ return indicator.color+ case (nil, nil):+ return nil+ }}@objc private func statusItemClicked(_ sender: NSStatusBarButton) {@@ -1224,13 +1244,14 @@ private final class StatusItemController: NSObject, NSMenuDelegate {)static let progressTrackCornerRadius: CGFloat = 1static let progressTrackAlpha: CGFloat = 0.34+ static let statusIndicatorRect = NSRect(x: 21.5, y: 1, width: 5, height: 5)static let staleIconAlpha: CGFloat = 0.75static let staleProgressAlpha: CGFloat = 0.55- static let statusIconProgressAnimationDuration: TimeInterval = 0.18- static let statusIconProgressAnimationFrameCount = 10- static let statusIconProgressAnimationFrameDelayNanoseconds = UInt64(- statusIconProgressAnimationDuration- / Double(statusIconProgressAnimationFrameCount)+ static let statusIconAnimationDuration: TimeInterval = 0.18+ static let statusIconAnimationFrameCount = 10+ static let statusIconAnimationFrameDelayNanoseconds = UInt64(+ statusIconAnimationDuration+ / Double(statusIconAnimationFrameCount)* 1000000000)}diff --git a/CodexBar/Services/Notifications/CodexNotificationService.swift b/CodexBar/Services/Notifications/CodexNotificationService.swiftindex 2e81284..a2422fd 100644--- a/CodexBar/Services/Notifications/CodexNotificationService.swift+++ b/CodexBar/Services/Notifications/CodexNotificationService.swift@@ -3,7 +3,7 @@ import Combineimport Foundationimport UserNotifications-/// 集中式通知服务: 订阅额度与实时活动,负责阈值判定、去重、重置调度与本地通知发送。+/// 集中式提醒服务: 订阅额度与实时活动,负责触觉反馈、阈值判定、去重、重置调度与本地通知发送。@MainActorfinal class CodexNotificationService: NSObject {private let settings: NotificationSettings@@ -13,6 +13,7 @@ final class CodexNotificationService: NSObject {private nonisolated let openMenuSurface: @MainActor @Sendable () -> Voidprivate var cancellables = Set<AnyCancellable>()+ private var taskHapticFeedbackTask: Task<Void, Never>?private let resetReminderScheduler = ReminderCheckScheduler()private let creditExpiryReminderScheduler = ReminderCheckScheduler()private var latestQuotaSnapshot: CodexQuotaSnapshot?@@ -78,9 +79,11 @@ final class CodexNotificationService: NSObject {.store(in: &cancellables)}- // MARK: - Hook 任务通知+ // MARK: - Hook 任务提醒private func handleActivityTransition(_ transition: CodexActivityTransition) {+ performTaskHapticFeedbackIfEnabled()+guard settings.canDeliver else {return}@@ -101,6 +104,30 @@ final class CodexNotificationService: NSObject {}}+ private func performTaskHapticFeedbackIfEnabled() {+ guard settings.canPerformTaskHapticFeedback else {+ return+ }++ taskHapticFeedbackTask?.cancel()+ taskHapticFeedbackTask = Task { @MainActor [weak self] in+ for pulse in 0 ..< Self.taskHapticPulseCount {+ guard let self,+ !Task.isCancelled,+ settings.canPerformTaskHapticFeedback else {+ return+ }++ NSHapticFeedbackManager.defaultPerformer.perform(.levelChange, performanceTime: .now)+ if pulse < Self.taskHapticPulseCount - 1 {+ try? await Task.sleep(for: Self.taskHapticPulseInterval)+ }+ }++ self?.taskHapticFeedbackTask = nil+ }+ }+// MARK: - 快照处理private func handleSnapshot(_ snapshot: CodexQuotaSnapshot?) {@@ -178,12 +205,11 @@ final class CodexNotificationService: NSObject {let previous = lastRemainingPercents[stateKey]lastRemainingPercents[stateKey] = window.remainingPercent- guard let resetsAt = window.resetsAt,- window.remainingPercent <= settings.lowQuotaThresholdPercent else {+ guard let resetsAt = window.resetsAt else {return}- // 记录本周期曾跌破阈值, 供重置完成提醒做门槛; 与低阈值子开关无关+ // 每个可信额度窗口都登记本周期重置提醒, 不依赖低额度阈值或子开关rememberPendingResetReminder(accountKey: accountKey,limitId: limit.limitId,@@ -191,7 +217,8 @@ final class CodexNotificationService: NSObject {resetsAt: resetsAt)- guard settings.isLowQuotaEnabled else {+ guard window.remainingPercent <= settings.lowQuotaThresholdPercent,+ settings.isLowQuotaEnabled else {return}@@ -432,6 +459,8 @@ final class CodexNotificationService: NSObject {private nonisolated static let day: TimeInterval = 24 * 3600private nonisolated static let creditExpiryReminderDays = [7, 6, 5, 4, 3, 2, 1]private nonisolated static let creditExpiryLeadTime: TimeInterval = 7 * day+ private static let taskHapticPulseCount = 10+ private static let taskHapticPulseInterval = Duration.milliseconds(150)private static let sentKeysLimit = 300private static let sentKeysKey = "Notification.sentKeys"private static let pendingResetRemindersKey = "Notification.pendingResetReminders"@@ -455,7 +484,7 @@ nonisolated struct CodexNotificationContent: Equatable {static func quotaReset(windowLabel: String) -> CodexNotificationContent {CodexNotificationContent(title: "Codex 额度重置",- body: "\(windowLabel) 窗口额度已重置"+ body: "\(windowLabel) 窗口额度即将重置")}@@ -535,7 +564,7 @@ private final class ReminderCheckScheduler {}}-/// 本周期曾跌破阈值的窗口, 等待 resetsAt 到达后发送恢复提醒+/// 已知下次重置时间的额度窗口, 在 resetsAt 到达时发送提醒private nonisolated struct PendingQuotaResetReminder: Codable, Equatable {let accountKey: Stringlet limitId: Stringdiff --git a/CodexBar/Services/Settings/NotificationSettings.swift b/CodexBar/Services/Settings/NotificationSettings.swiftindex 972c892..2724c23 100644--- a/CodexBar/Services/Settings/NotificationSettings.swift+++ b/CodexBar/Services/Settings/NotificationSettings.swift@@ -3,8 +3,8 @@ import Combineimport Foundationimport UserNotifications-/// 通知偏好: 总开关、五类子开关、两个阈值和系统授权状态镜像-/// 授权请求/查询集中在这里, 判定与发送在 CodexNotificationService+/// 通知偏好: 总开关、五类通知子开关、任务触觉开关、两个阈值和系统授权状态镜像+/// 授权请求/查询集中在这里, 通知与触觉反馈判定在 CodexNotificationService@MainActorfinal class NotificationSettings: ObservableObject {@Published private(set) var isEnabled: Bool@@ -12,6 +12,7 @@ final class NotificationSettings: ObservableObject {@Published private(set) var isQuotaResetEnabled: Bool@Published private(set) var isLongTaskEnabled: Bool@Published private(set) var isTaskWaitingEnabled: Bool+ @Published private(set) var isTaskHapticEnabled: Bool@Published private(set) var isCreditExpiryEnabled: Bool@Published private(set) var lowQuotaThresholdPercent: Int@Published private(set) var longTaskThresholdSeconds: Int@@ -27,6 +28,11 @@ final class NotificationSettings: ObservableObject {isEnabled && !isAuthorizationDenied}+ /// 触觉反馈不依赖系统通知授权,但服从 App 内通知总开关。+ var canPerformTaskHapticFeedback: Bool {+ isEnabled && isTaskHapticEnabled+ }+/// 子选项面板仅在总开关开启且授权已明确通过时可展示var canShowOptions: Bool {isEnabled && authorizationStatus != .notDetermined && authorizationStatus != .denied@@ -45,6 +51,7 @@ final class NotificationSettings: ObservableObject {isQuotaResetEnabled = Self.bool(from: defaults, key: Self.quotaResetEnabledKey, defaultValue: true)isLongTaskEnabled = Self.bool(from: defaults, key: Self.longTaskEnabledKey, defaultValue: true)isTaskWaitingEnabled = Self.bool(from: defaults, key: Self.taskWaitingEnabledKey, defaultValue: true)+ isTaskHapticEnabled = Self.bool(from: defaults, key: Self.taskHapticEnabledKey, defaultValue: true)isCreditExpiryEnabled = Self.bool(from: defaults, key: Self.creditExpiryEnabledKey, defaultValue: true)lowQuotaThresholdPercent = Self.option(defaults.object(forKey: Self.lowQuotaThresholdKey) as? Int,@@ -90,6 +97,10 @@ final class NotificationSettings: ObservableObject {setBool(enabled, current: &isTaskWaitingEnabled, key: Self.taskWaitingEnabledKey)}+ func setTaskHapticEnabled(_ enabled: Bool) {+ setBool(enabled, current: &isTaskHapticEnabled, key: Self.taskHapticEnabledKey)+ }+func setCreditExpiryEnabled(_ enabled: Bool) {setBool(enabled, current: &isCreditExpiryEnabled, key: Self.creditExpiryEnabledKey)}@@ -192,6 +203,7 @@ final class NotificationSettings: ObservableObject {private static let quotaResetEnabledKey = "Notification.quotaResetEnabled"private static let longTaskEnabledKey = "Notification.longTaskEnabled"private static let taskWaitingEnabledKey = "Notification.taskWaitingEnabled"+ private static let taskHapticEnabledKey = "Notification.taskHapticEnabled"private static let creditExpiryEnabledKey = "Notification.creditExpiryEnabled"private static let lowQuotaThresholdKey = "Notification.lowQuotaThresholdPercent"private static let longTaskThresholdKey = "Notification.longTaskThresholdSeconds"diff --git a/CodexBar/Services/Workflow/CodexActivityMonitor.swift b/CodexBar/Services/Workflow/CodexActivityMonitor.swiftindex 27d9780..a691b27 100644--- a/CodexBar/Services/Workflow/CodexActivityMonitor.swift+++ b/CodexBar/Services/Workflow/CodexActivityMonitor.swift@@ -2,7 +2,7 @@ import AppKitimport Combineimport Foundation-/// 从本机 Hook JSONL 维护进程内实时任务状态,是菜单栏、活动卡片和通知的唯一任务状态来源。+/// 从本机 Hook JSONL 维护进程内实时任务状态,是菜单栏、活动卡片、通知和触觉反馈的唯一任务状态来源。@MainActorfinal class CodexActivityMonitor: ObservableObject {@Published private(set) var snapshot = CodexActivitySnapshot.emptydiff --git a/CodexBar/Views/Menu/CodexActivityCard.swift b/CodexBar/Views/Menu/CodexActivityCard.swiftindex f76820c..1924fef 100644--- a/CodexBar/Views/Menu/CodexActivityCard.swift+++ b/CodexBar/Views/Menu/CodexActivityCard.swift@@ -128,7 +128,7 @@ struct CodexActivityCard: View {case .toolStarted:task.toolName.map { "调用工具 \($0)" } ?? "调用工具"case .toolFinished:- task.toolName.map { "工具调用 \($0) 完成" } ?? "工具调用完成"+ task.toolName.map { "调用工具 \($0) 完成" } ?? "调用工具完成"case .compactionStarted:"压缩上下文"case .compactionFinished:diff --git a/CodexBar/Views/Menu/UsageHeatmap.swift b/CodexBar/Views/Menu/UsageHeatmap.swiftindex 553a330..e310d7a 100644--- a/CodexBar/Views/Menu/UsageHeatmap.swift+++ b/CodexBar/Views/Menu/UsageHeatmap.swift@@ -627,7 +627,7 @@ struct UsageHeatmapDayDetailView: View {WorkflowMetricRow(label: "会话总数", value: context.day.workflow.sessionCount, tint: .green),WorkflowMetricRow(label: "对话轮次", value: context.day.workflow.turnCount, tint: .teal),WorkflowMetricRow(label: "子智能体", value: context.day.workflow.subagentCount, tint: .indigo),- WorkflowMetricRow(label: "工具调用", value: context.day.workflow.toolCallCount, tint: .orange),+ WorkflowMetricRow(label: "调用工具", value: context.day.workflow.toolCallCount, tint: .orange),WorkflowMetricRow(label: "权限请求", value: context.day.workflow.permissionRequestCount, tint: .red),WorkflowMetricRow(label: "上下文压缩", value: context.day.workflow.contextCompactionCount, tint: .purple)]diff --git a/CodexBar/Views/Settings/NotificationOptionsView.swift b/CodexBar/Views/Settings/NotificationOptionsView.swiftindex 96d1e21..fe9dcfd 100644--- a/CodexBar/Views/Settings/NotificationOptionsView.swift+++ b/CodexBar/Views/Settings/NotificationOptionsView.swift@@ -12,6 +12,7 @@ struct NotificationOptionsView: View {quotaResetRowlongTaskRowtaskWaitingRow+ taskHapticRowcreditExpiryRow}.padding(.horizontal, Metrics.horizontalPadding)@@ -25,11 +26,12 @@ struct NotificationOptionsView: View {}static var initialPanelSize: CGSize {- CGSize(+ let rowCount = CGFloat(Metrics.optionRowCount)+ return CGSize(width: Metrics.panelWidth,height: Metrics.verticalPadding * 2- + Metrics.rowHeight * 5- + Metrics.rowSpacing * 4+ + Metrics.rowHeight * rowCount+ + Metrics.rowSpacing * (rowCount - 1))}@@ -109,6 +111,20 @@ struct NotificationOptionsView: View {)}+ /// Hook 未开启时显示为关闭并置灰, 不修改持久化的 isTaskHapticEnabled+ private var taskHapticRow: some View {+ let isDisplayedOn = codexHookSettings.isEnabled && notificationSettings.isTaskHapticEnabled++ return optionRow(+ title: "任务触觉反馈",+ isOn: Binding(+ get: { isDisplayedOn },+ set: { notificationSettings.setTaskHapticEnabled($0) }+ ),+ isEnabled: codexHookSettings.isEnabled+ )+ }+private var creditExpiryRow: some View {optionRow(title: "重置次数临期通知",@@ -178,6 +194,7 @@ struct NotificationOptionsView: View {static let panelWidth: CGFloat = 300static let horizontalPadding: CGFloat = 12static let verticalPadding: CGFloat = 10+ static let optionRowCount = 6static let rowSpacing: CGFloat = 7static let rowHeight: CGFloat = 22static let pickerWidth: CGFloat = 72diff --git a/Docs/CodexHook.md b/Docs/CodexHook.mdindex c90b1e2..49909f6 100644--- a/Docs/CodexHook.md+++ b/Docs/CodexHook.md@@ -101,7 +101,7 @@ Hook 数据目录:文件职责:-- `events/YYYY-MM-DD.jsonl`: 按本机日期拆分的原始 Hook 事件日志;Hook 开启期间主 App 会以只读方式 tail 当日文件,为菜单栏、活动卡片和任务通知维护统一的进程内实时状态;该读取不修改文件、不参与统计维护,统计口径不变。+- `events/YYYY-MM-DD.jsonl`: 按本机日期拆分的原始 Hook 事件日志;Hook 开启期间主 App 会以只读方式 tail 当日文件,为菜单栏、活动卡片、任务通知和触觉反馈维护统一的进程内实时状态;该读取不修改文件、不参与统计维护,统计口径不变。- `daily.jsonl`: 每日聚合结果,UI 优先读取它- `stats.lock`: 并发写入锁文件,只用于 `flock`- `maintenance.json`: 记录待整理日期、需要重建日期和每个日期的处理进度@@ -131,11 +131,11 @@ Hook 数据目录:## 实时活动状态-`CodexActivityMonitor` 是 `@MainActor ObservableObject` 长期对象。Hook 开启时它启动 `HookEventTailReader`,关闭时停止读取并清空状态;通知总开关和任务通知子开关只控制是否发送通知,不控制监测器生命周期。实时状态只保存在内存,不写入新的历史文件,也不增加 CloudKit 字段或网络请求。+`CodexActivityMonitor` 是 `@MainActor ObservableObject` 长期对象。Hook 开启时它启动 `HookEventTailReader`,关闭时停止读取并清空状态;通知与触觉开关只控制是否发送对应提醒,不控制监测器生命周期。实时状态只保存在内存,不写入新的历史文件,也不增加 CloudKit 字段或网络请求。`HookEventTailReader` 是独立 actor,文件 I/O 和 JSON 解码不占用 MainActor。读取分为两类批次:-- `bootstrap`:App 启动、当前活动事件文件被截断或替换时,按 512 KB 分块流式读取滚动 24 小时涉及的日期文件,并按事件时间过滤窗口之外的数据。每次尝试开始时清空恢复态,成功后只发布一次最终快照,整个 bootstrap 不发布通知 transition。读取前记录各文件 inode 和 size;当前文件只读到当时最后一个完整换行,后续新增字节由 live 消费。文件边界变化时最多重试三次,连续失败则再次清空恢复态并跳过当前已有字节,避免把历史事件误当 live 通知。+- `bootstrap`:App 启动、当前活动事件文件被截断或替换时,按 512 KB 分块流式读取滚动 24 小时涉及的日期文件,并按事件时间过滤窗口之外的数据。每次尝试开始时清空恢复态,成功后只发布一次最终快照,整个 bootstrap 不发布活动 transition。读取前记录各文件 inode 和 size;当前文件只读到当时最后一个完整换行,后续新增字节由 live 消费。文件边界变化时最多重试三次,连续失败则再次清空恢复态并跳过当前已有字节,避免把历史事件误当 live 通知。- bootstrap 结束后,monitor 对由工具或权限事件恢复、但缺少起点的精确 session + turn,向 reader 发起一次定向查找:在更早日期文件中按 session + turn 查找 `UserPromptSubmit`,最多额外读取 8 MB;找到后只回填 `startedAt`,不改变当前状态、最近事件或活动时间。达到上限仍找不到时保留任务,但不展示精确总耗时。- `live`:之后每 2 秒读取当天新增的完整行。末尾半行留到下次读取;跨零点时先读完旧文件尾部,再从新日期文件头开始。每个成功处理的分块都会推进到最后一个完整换行的 offset;后续分块读取失败时只重试尚未处理的部分。旧文件截断或替换触发 bootstrap 时,由 bootstrap 保留新日期的正确 offset,外层不会再从头按 live 重放;临时读取失败则保留旧日期并在下一轮重试。bootstrap、定时轮询和 Mac 唤醒补读共用串行入口;读取期间到达的请求只合并为一次待补读,并在当前读取结束后执行,避免 actor 在 `await` 处重入而重复消费同一 offset。monitor 为每一代 reader 分配 generation,快速开关 Hook 后迟到的旧批次会被丢弃。@@ -144,13 +144,13 @@ Codex Hook 事件可能缺少起点、结束或中断信号。`CodexSessionLifec- 只检查 monitor 内仍有运行或等待任务、并且同时具有 session ID 和 turn ID 的活跃项,不持续扫描所有历史会话。- 优先在 `~/.codex/sessions/YYYY/MM/DD/` 和 `~/.codex/archived_sessions/` 按 session ID 定位对应 rollout;这些便宜目录允许每 10 秒重试。resume 的旧 session 找不到时,每个活跃生命周期只递归 `sessions` 一次并保留负缓存;session 重新活跃、缓存文件消失或 Mac 唤醒时重置递归资格。- 初次从文件末尾最多读取 512 KB,之后每 2 秒按 byte offset 增量读取,保留半行并检测截断或替换。只解出顶层 `type`、`payload.type`、`payload.turn_id`、`started_at`、`completed_at` 和 `duration_ms`;不提取、保存或展示提示词、回复、推理或工具内容。-- `event_msg / task_started` 只为缺少 Hook Prompt 起点的精确 turn 回填开始时间;`task_complete` 补齐缺失的 Hook `Stop`,使用 `completed_at` 和 `duration_ms` 生成完成状态。初始恢复只更新状态而不回放通知;运行期间新收到的 `task_complete` 可发布一次完成 transition,后到的 Hook `Stop` 会被去重。定时轮询和唤醒/恢复触发的即时查询都绑定启动时的 reader generation,并在跨 actor 等待前后校验,旧 generation 的迟到 rollout 结果不会写入新状态。-- `event_msg / turn_aborted` 静默移除对应任务,不生成完成记录、绿色状态或通知。文件不存在、无法读取、格式变化或缺少精确 ID 时保留原 Hook 状态,最终仍由后续 prompt、Stop、Hook 关闭或 24 小时过期兜底。+- `event_msg / task_started` 只为缺少 Hook Prompt 起点的精确 turn 回填开始时间;`task_complete` 补齐缺失的 Hook `Stop`,使用 `completed_at` 和 `duration_ms` 生成完成状态。初始恢复只更新状态而不回放通知或触觉反馈;运行期间新收到的 `task_complete` 可发布一次完成 transition,后到的 Hook `Stop` 会被去重。定时轮询和唤醒/恢复触发的即时查询都绑定启动时的 reader generation,并在跨 actor 等待前后校验,旧 generation 的迟到 rollout 结果不会写入新状态。+- `event_msg / turn_aborted` 静默移除对应任务,不生成完成记录、绿色状态、通知或触觉反馈。文件不存在、无法读取、格式变化或缺少精确 ID 时保留原 Hook 状态,最终仍由后续 prompt、Stop、Hook 关闭或 24 小时过期兜底。任务状态机规则:- 任务键优先使用 `session + turn`,缺少 turn 时使用 session;两者都缺少时按项目名归入匿名任务。匿名任务以及缺少起点的恢复任务不展示精确总耗时。-- `UserPromptSubmit` 创建运行任务;同一 session 收到新 prompt 时,旧 turn 即使缺少 Stop 也视为已中断并从运行状态移除,但不生成完成记录或通知。工具、上下文压缩和子智能体事件更新已有任务并解除等待,同时记录最近事件供活动卡片实时展示。工具和权限事件缺少起点时可以恢复顶层状态,子智能体事件不会单独创建顶层任务。+- `UserPromptSubmit` 创建运行任务;同一 session 收到新 prompt 时,旧 turn 即使缺少 Stop 也视为已中断并从运行状态移除,但不生成完成记录、通知或触觉反馈。工具、上下文压缩和子智能体事件更新已有任务并解除等待,同时记录最近事件供活动卡片实时展示。工具和权限事件缺少起点时可以恢复顶层状态,子智能体事件不会单独创建顶层任务。- `PermissionRequest` 进入等待批准;重复的等待事件不重复发布等待 transition。live 读取一次可能包含多个事件,monitor 会在整批应用后按任务键合并等待候选:最终仍在等待时使用最终快照发布一次,已经恢复运行、完成或移除时不发布过期等待 transition;完成候选保持事件顺序,并按 completion ID 防止同批重复发布。- Hook `Stop` 或 rollout `task_complete` 结束任务并产生最近完成记录,两者在进程内按精确任务键和 session 回退键去重,保留第一次确认的完成及精确耗时且不重复发布 transition。后到的重复完成不会覆盖首次确认结果,也不会缩短 24 小时去重窗口。期间迟到的工具、压缩或权限事件不会恢复已完成任务,只有时间晚于完成记录的新 `UserPromptSubmit` 可以开始下一段生命周期。rollout `turn_aborted` 只静默移除中断任务。“完成”只表示该 turn 已结束,不表示任务成功。- 精确 turn 匹配失败时,回退同 session 最近活动任务,再回退同项目匿名任务。@@ -279,7 +279,7 @@ subagentStopCount, sessionCount, turnCount, projectCounts, modelCounts, sessionI| 会话总数 | 最近 3 个本地自然日内,任意带非空 `session` 的事件行都会把该 `session` 加入当天去重集合;另外 `event` 归一化为 `sessionstart` 的行会增加 `sessionStartCount`。 | `session` 为 `null` 且 `event` 不是 `SessionStart`;坏行。 | 优先 `sessionCount`,其次 `sessionIds.count`,最后 `sessionStartCount` || 对话轮次 | 最近 3 个本地自然日内,任意带非空 `turn` 的事件行都会把该 `turn` 加入当天去重集合;另外 `event` 归一化为 `stop` 的行会增加 `stopCount`。 | `turn` 为 `null` 且 `event` 不是 `Stop`;坏行。 | 优先 `turnCount`,其次 `turnIds.count`,最后 `stopCount` || 子智能体 | `event` 归一化为 `subagentstart` 或 `subagentstop` 的行。 | 其他事件名;坏行。 | `max(subagentStartCount, subagentStopCount)` |-| 工具调用 | `event` 归一化为 `pretooluse` 的行会增加 `preToolUseCount`;归一化为 `posttooluse` 的行会增加 `postToolUseCount`。`tool` 可以是具体工具名,也可以是 `null`。 | `SessionStart` 这类非工具事件,即使 `tool` 是 `null` 或存在也不会计入;坏行。 | `max(preToolUseCount, postToolUseCount)` |+| 调用工具 | `event` 归一化为 `pretooluse` 的行会增加 `preToolUseCount`;归一化为 `posttooluse` 的行会增加 `postToolUseCount`。`tool` 可以是具体工具名,也可以是 `null`。 | `SessionStart` 这类非工具事件,即使 `tool` 是 `null` 或存在也不会计入;坏行。 | `max(preToolUseCount, postToolUseCount)` || 权限请求 | `event` 归一化为 `permissionrequest` 的行。 | `permission` 字段本身不会触发计数;只有事件名是 `PermissionRequest` 才计入。 | `permissionRequestCount` || 上下文压缩 | `event` 归一化为 `precompact` 或 `postcompact` 的行。 | 其他事件名;坏行。 | `max(preCompactCount, postCompactCount)` || 最热模型 | 任意带非空 `model` 的有效事件行。 | `model` 为 `null` 或空字符串;坏行。 | 按模型名累计事件数,取最高值;并列时按模型名升序取第一个 |@@ -292,8 +292,8 @@ subagentStopCount, sessionCount, turnCount, projectCounts, modelCounts, sessionI| `eventCount` | 每条成功解码并保留下来的事件行 | 每处理一条事件就 `+1`,发生在具体事件类型判断之前。因此 `UserPromptSubmit`、未知 `event`、`tool: null`、`session: null` 等行都会计入,只要 `timestamp` 和 `event` 可解析。 | 进入 `WorkflowDailyMetrics.eventCount`,当前页面不展示。 || `sessionStartCount` | `event` | `event` 归一化后等于 `sessionstart` 时 `+1`。不要求 `session` 非空。 | 作为「会话总数」兜底来源。 || `stopCount` | `event` | `event` 归一化后等于 `stop` 时 `+1`。不要求 `turn` 非空。 | 作为「对话轮次」兜底来源。 |-| `preToolUseCount` | `event` | `event` 归一化后等于 `pretooluse` 时 `+1`。不读取 `tool` 做过滤,`tool` 为 `null` 也计入。 | 参与「工具调用」。 |-| `postToolUseCount` | `event` | `event` 归一化后等于 `posttooluse` 时 `+1`。不读取 `tool` 做过滤,`tool` 为 `null` 也计入。 | 参与「工具调用」。 |+| `preToolUseCount` | `event` | `event` 归一化后等于 `pretooluse` 时 `+1`。不读取 `tool` 做过滤,`tool` 为 `null` 也计入。 | 参与「调用工具」。 |+| `postToolUseCount` | `event` | `event` 归一化后等于 `posttooluse` 时 `+1`。不读取 `tool` 做过滤,`tool` 为 `null` 也计入。 | 参与「调用工具」。 || `permissionRequestCount` | `event` | `event` 归一化后等于 `permissionrequest` 时 `+1`。不读取 `permission` 字段做过滤,`permission` 只是记录当时的权限模式。 | 直接显示为「权限请求」。 || `preCompactCount` | `event` | `event` 归一化后等于 `precompact` 时 `+1`。 | 参与「上下文压缩」。 || `postCompactCount` | `event` | `event` 归一化后等于 `postcompact` 时 `+1`。 | 参与「上下文压缩」。 |@@ -303,7 +303,7 @@ subagentStopCount, sessionCount, turnCount, projectCounts, modelCounts, sessionI| `turnIds` | `turn` | 仅最近 3 个本地自然日保留。任意事件行只要 `turn` 是非空字符串,就插入当天集合并去重、排序;不要求事件类型是 `Stop`。窗口外日期会被压缩为 `turnCount` 并写成 `null`。 | 参与「对话轮次」去重。 || `sessionCount` | `sessionIds`、旧 `sessionCount`、`sessionStartCount` | 最近 3 天通常为 `null`;日期进入 3 天外窗口后,归一化时优先沿用已有 `sessionCount`,否则使用 `sessionIds.count`,再否则使用 `sessionStartCount`,然后移除 `sessionIds`。这样旧日期不用继续保存完整 ID,也能保留会话总数。 | 参与「会话总数」。 || `turnCount` | `turnIds`、旧 `turnCount`、`stopCount` | 最近 3 天通常为 `null`;日期进入 3 天外窗口后,归一化时优先沿用已有 `turnCount`,否则使用 `turnIds.count`,再否则使用 `stopCount`,然后移除 `turnIds`。这样旧日期不用继续保存完整 ID,也能保留轮次总数。 | 参与「对话轮次」。 |-| `projectCounts` | `cwd` | 任意事件行只要 `cwd` 非空,就取标准化路径的最后一层目录名作为项目名并 `+1`;如果最后一层为空,回退使用完整路径字符串。统计的是事件数,不是会话数或工具调用数。未知事件也会计入。 | 用于计算 `mostActiveProject`,当前页面不展示。 |+| `projectCounts` | `cwd` | 任意事件行只要 `cwd` 非空,就取标准化路径的最后一层目录名作为项目名并 `+1`;如果最后一层为空,回退使用完整路径字符串。统计的是事件数,不是会话数或调用工具数。未知事件也会计入。 | 用于计算 `mostActiveProject`,当前页面不展示。 || `modelCounts` | `model` | 任意事件行只要 `model` 非空,就按原始模型名 `+1`。统计的是带模型字段的事件数,不是 token 数;未知事件也会计入。 | 合并后用于计算并展示「最热模型」。 |读取旧 `daily.jsonl` 时,缺失的数字字段按 `0` 处理,缺失的 `projectCounts` / `modelCounts` 按空字典处理,缺失的 `sessionIds` / `turnIds` / `sessionCount` / `turnCount` 保持为 `nil`。维护 schema 升级到 `3` 后会把保留窗口内已有事件日期标记为 dirty,从原始事件重建模型计数;后续归一化仍按当前保留策略补齐或压缩 ID 字段。@@ -315,7 +315,7 @@ UI 不直接展示所有原始字段,而是先生成 `WorkflowDailyMetrics`:| 会话总数 | `sessionCount ?? sessionIds.count ?? sessionStartCount` || 对话轮次 | `turnCount ?? turnIds.count ?? stopCount` || 子智能体 | `max(subagentStartCount, subagentStopCount)` |-| 工具调用 | `max(preToolUseCount, postToolUseCount)` |+| 调用工具 | `max(preToolUseCount, postToolUseCount)` || 权限请求 | `permissionRequestCount` || 上下文压缩 | `max(preCompactCount, postCompactCount)` || 最热模型 | 合并 `modelCounts` 后取计数最高的模型;并列时按名称升序 |@@ -356,7 +356,7 @@ Codex Hook 开启时:- 没有当天 token bucket 时, 今天的 token 数显示为 `--`- 详情面板首行左侧显示日期、右侧显示 token 数- 第二行显示「用量强度」分段条-- 后续逐行显示「最热模型」、「会话总数」、「对话轮次」、「子智能体」、「工具调用」、「权限请求」、「上下文压缩」+- 后续逐行显示「最热模型」、「会话总数」、「对话轮次」、「子智能体」、「调用工具」、「权限请求」、「上下文压缩」- 详情面板固定为 `212 x 208`- 详情面板横向 padding 为 `12`, 纵向 padding 为 `10`, 圆角为 `12`- 日期使用 `.caption2.monospacedDigit()`, token 数使用 `14pt` 等宽数字并加粗diff --git a/Docs/CrossDeviceSync.md b/Docs/CrossDeviceSync.mdindex 02d3400..6d2a9ae 100644--- a/Docs/CrossDeviceSync.md+++ b/Docs/CrossDeviceSync.md@@ -7,7 +7,7 @@会同步:- `daily.jsonl` 中每一天的工作流统计聚合副本-- 会话总数、对话轮次、子智能体、工具调用、权限请求、上下文压缩等计数字段+- 会话总数、对话轮次、子智能体、调用工具、权限请求、上下文压缩等计数字段- `eventCount`、`projectCounts` 和 `modelCounts`不会同步:diff --git a/Docs/DevelopmentGuide.md b/Docs/DevelopmentGuide.mdindex 5637755..3330afb 100644--- a/Docs/DevelopmentGuide.md+++ b/Docs/DevelopmentGuide.md@@ -98,9 +98,9 @@ App 退出时, `applicationWillTerminate` 调用 `StatusItemController.uninstall正常图标是 `person.fill.checkmark`, 错误图标是 `person.fill.xmark`-小人颜色按 `账号异常 > 等待批准 > 运行中 > 刚完成 > 暂无活动` 取最高优先级:账号异常使用系统红色,等待批准使用系统橙色,运行中使用系统蓝色,确认 turn 完成后 20 秒内使用系统绿色,空闲使用 `labelColor`。空闲且没有额度竖条时保持 template 图像;彩色状态、账号异常或显示额度竖条时使用非 template 合成图。小人 tint 与额度竖条分别绘制,颜色互不影响。+小人右下角的状态点只表达 Hook 任务状态,按 `等待批准 > 运行中 > 刚完成 > 暂无活动` 取最高优先级:等待批准使用系统橙色,运行中使用系统蓝色,确认 turn 完成后 20 秒内使用系统绿色,空闲时不显示。小人本体始终使用系统前景色,账号异常继续由 `person.fill.xmark` 表达,不改变状态点颜色;空闲且没有额度竖条时保持 template 图像,有状态点或显示额度竖条时使用非 template 合成图。状态点与额度竖条分别绘制,颜色互不影响。-设置页「菜单栏额度指示」默认开启, 使用独立开关控制启用状态; 缺失持久化选择时默认使用 `.primary`, 关闭时显式持久化 `.off`。开启后在同一行显示额度窗口菜单, 可选择当前账号 Codex limit 返回的额度窗口, 当前保留选择不在返回窗口中时用 fallback 标题追加到菜单。最后一次非关闭的窗口选择由 `MenuBarQuotaSettings` 以 `MenuBarQuota.lastWindowSelection` 键随偏好持久化: 关闭开关时它继续参与菜单淡出避免过渡期间回退, 重新开启时(含重开设置窗口或重启应用后)恢复该选择, 无记录时回退 `.primary`。开启后 `StatusItemController` 会把所选 Codex 窗口的剩余额度进度条绘制在图标左侧, 以竖条形式与 `person.fill.checkmark` / `person.fill.xmark` 合成为单个 `NSImage`, 并随 `CodexStatusViewModel` 自动刷新。合成图尺寸为 `27 x 17`, 图标本体保持原始 `24 x 17`, 左侧竖条轨道为 `2 x 15`。额度显隐或小人颜色变化时, `StatusItemController` 合并为同一个逐帧重绘任务,在 0.18 秒内同时插值竖条透明度和图标颜色,避免两个动画任务竞争;过渡期间合成图宽度和绘制坐标保持固定。活动期间 tooltip 每分钟更新一次耗时并合并并发数量与额度,活动结束后取消刷新任务。+设置页「菜单栏额度指示」默认开启, 使用独立开关控制启用状态; 缺失持久化选择时默认使用 `.primary`, 关闭时显式持久化 `.off`。开启后在同一行显示额度窗口菜单, 可选择当前账号 Codex limit 返回的额度窗口, 当前保留选择不在返回窗口中时用 fallback 标题追加到菜单。最后一次非关闭的窗口选择由 `MenuBarQuotaSettings` 以 `MenuBarQuota.lastWindowSelection` 键随偏好持久化: 关闭开关时它继续参与菜单淡出避免过渡期间回退, 重新开启时(含重开设置窗口或重启应用后)恢复该选择, 无记录时回退 `.primary`。开启后 `StatusItemController` 会把所选 Codex 窗口的剩余额度进度条绘制在图标左侧, 以竖条形式与 `person.fill.checkmark` / `person.fill.xmark` 合成为单个 `NSImage`, 并随 `CodexStatusViewModel` 自动刷新。合成图尺寸为 `27 x 17`, 图标本体保持原始 `24 x 17`, 左侧竖条轨道为 `2 x 15`, 状态点位于小人右下角。额度显隐或状态点变化时, `StatusItemController` 合并为同一个逐帧重绘任务,在 0.18 秒内同时插值竖条与状态点的透明度以及状态点颜色,避免两个动画任务竞争;过渡期间合成图宽度和绘制坐标保持固定。活动期间 tooltip 每分钟更新一次耗时并合并并发数量与额度,活动结束后取消刷新任务。Hook 开启时,账号卡片下方始终显示固定高度 `CodexActivityCard`;即使 app-server 异常进入空数据分支也不会隐藏。卡片按等待、运行、最近完成、空闲的顺序展示项目最后一级名称、模型或工具、耗时及其他任务数量。最近完成保留 5 分钟。耗时 `TimelineView` 只在 popover 或 fallback panel 可见时逐秒 tick。@@ -592,7 +592,7 @@ flowchart TD| Hook 状态 | 内容 | 尺寸 || --------- | -------------------------------------------------------------------------------------------------------- | ----------- || 关闭 | 日期, token 数和"用量强度"分段条 | `212 x 84` |-| 开启 | 日期, token 数, "用量强度"分段条, 最热模型, 会话总数, 对话轮次, 子智能体, 工具调用, 权限请求, 上下文压缩 | `212 x 208` |+| 开启 | 日期, token 数, "用量强度"分段条, 最热模型, 会话总数, 对话轮次, 子智能体, 调用工具, 权限请求, 上下文压缩 | `212 x 208` |Hook 开启且当天没有 token bucket 时, 今天的 token 数显示 `--`。日期使用 `AnimatedDateText` 做数字滚动, token 数使用 `TokenCountText` 并保留数字和单位宽度。「用量强度」前置圆点固定为蓝色, 不随用量强度变化。@@ -869,7 +869,7 @@ UI 展示指标来自 `WorkflowDailyAggregate.metrics`:| 会话总数 | `sessionCount ?? sessionIds.count ?? sessionStartCount` || 对话轮次 | `turnCount ?? turnIds.count ?? stopCount` || 子智能体 | `max(subagentStartCount, subagentStopCount)` |-| 工具调用 | `max(preToolUseCount, postToolUseCount)` |+| 调用工具 | `max(preToolUseCount, postToolUseCount)` || 权限请求 | `permissionRequestCount` || 上下文压缩 | `max(preCompactCount, postCompactCount)` || 最热模型 | 合并 `modelCounts` 后取计数最高的模型, 并列时按名称升序 |@@ -909,7 +909,7 @@ App 再次成为 active 时, 也会刷新 Codex 版本区、同步可用性, 并| 开机自动启动 | `SMAppService.mainApp.status` | `register()` / `unregister()` || 自动检查更新 | Sparkle updater | 设置 `automaticallyChecksForUpdates` || 菜单栏额度指示 | `MenuBarQuotaSettings.selection` / `MenuBarQuota.lastWindowSelection` | 开关写入 `.off` 或恢复持久化的上次窗口选择, 窗口菜单写入所选窗口并同步记住; 标签优先来自当前账号 Codex limit 返回的额度窗口, 缺失时使用 fallback 标题 |-| 系统通知 | `NotificationSettings` + `UNUserNotificationCenter` | 总开关与五类子开关、阈值写入 `UserDefaults`; 首次开启时请求系统通知授权 |+| 系统通知 | `NotificationSettings` + `UNUserNotificationCenter` | 总开关、五类通知子开关、任务触觉开关与阈值写入 `UserDefaults`; 首次开启时请求系统通知授权 || 使用快捷键 | `GlobalHotKeySettings.shortcut` | 写入 `UserDefaults` 并注册 hot key || 启用 Codex Hook | app-server `config/read` / `hooks/list` / `config/batchWrite`, `~/.codex/hooks.json` | 检查全局 Hook 开关后追加或移除当前 CodexBar command hook, 并维护对应 `hooks.state` 信任状态 || 跨设备同步 | `WorkflowSyncSettings` + CloudKit account status + `WorkflowSyncScheduler` | Hook 开启且同步账号可用时写入 `UserDefaults`; 开启时标记 `needsBackfill` 并请求调度同步 |@@ -1079,31 +1079,33 @@ App 再次成为 active 时, 也会刷新 Codex 版本区、同步可用性, 并- Hook 统计默认只保存在用户 Application Support 的 CodexBar 目录;开启「跨设备同步」后, CloudKit 只保存去掉 `sessionIds` / `turnIds` 的 daily 聚合副本, 不保存原始 Hook events- 实时任务状态只保存在 `CodexActivityMonitor` 内存中,UI 只展示项目最后一级名称、模型、工具名与最近 Hook 事件类型;运行卡片第一行组合项目和模型,第二行组合运行时间与请求/工具/压缩/子智能体状态,其他任务数使用右侧 `+N` 徽标。不写历史文件、不上传 CloudKit,也不新增网络请求。`CodexSessionLifecycleReader` 只对活跃 session + turn 增量读取本机 rollout,提取事件类型、turn ID、起止时间和耗时,不提取、保存或展示提示词、回复、推理和工具内容-## 19. 通知提醒链路+## 19. 通知与触觉提醒链路-通知判定与发送在 `CodexBar/Services/Notifications/`, 偏好类随其他设置类放在 `CodexBar/Services/Settings/`:+通知与触觉反馈判定在 `CodexBar/Services/Notifications/`, 偏好类随其他设置类放在 `CodexBar/Services/Settings/`:-- `NotificationSettings` (`Services/Settings/`): 总开关、五类子开关、低额度阈值 (5%/10%/25%, 默认 10%) 和长任务时长 (30s/1m/2m/5m, 默认 1m), 持久化到 UserDefaults; 负责系统授权请求、被拒状态镜像和设置页选项面板可展示状态-- `CodexNotificationService`: 集中判定、去重、调度与发送; 由 `CodexBarAppDelegate` 创建, 订阅 `CodexStatusViewModel.$snapshot`、`CodexActivityMonitor` live transition 与 `NSWorkspace.didWakeNotification`; 五类正式通知共用 `CodexNotificationContent` 文案工厂-- `CodexActivityMonitor`: Hook 开启期间始终运行并维护并发任务;向 UI 发布快照,向通知服务发布 live transition。单个 live 批次先完整应用事件,再按任务键合并等待候选;只有批次结束后仍处于等待的任务会使用最终快照发布一次等待 transition,完成候选保持顺序并按 completion ID 做批内去重。通知开关不会停止活动监测+- `NotificationSettings` (`Services/Settings/`): 总开关、五类通知子开关、任务触觉开关、低额度阈值 (5%/10%/25%, 默认 10%) 和长任务时长 (30s/1m/2m/5m, 默认 1m), 持久化到 UserDefaults; 负责系统授权请求、被拒状态镜像和设置页选项面板可展示状态+- `CodexNotificationService`: 集中判定、去重、调度与发送; 由 `CodexBarAppDelegate` 创建, 订阅 `CodexStatusViewModel.$snapshot`、`CodexActivityMonitor` live transition 与 `NSWorkspace.didWakeNotification`; 五类正式通知共用 `CodexNotificationContent` 文案工厂,等待与完成 transition 还会按偏好请求 AppKit `.levelChange` 触觉反馈+- `CodexActivityMonitor`: Hook 开启期间始终运行并维护并发任务;向 UI 发布快照,向提醒服务发布 live transition。单个 live 批次先完整应用事件,再按任务键合并等待候选;只有批次结束后仍处于等待的任务会使用最终快照发布一次等待 transition,完成候选保持顺序并按 completion ID 做批内去重。通知与触觉开关不会停止活动监测- `HookEventTailReader` (`Services/Workflow/`): 后台 actor;bootstrap 以 512 KB 为单次分块流式读取滚动 24 小时事件,并用 start/events/end 三阶段恢复状态。当前文件用 inode + 完整行 offset 固定 bootstrap/live 边界;bootstrap 结束后 monitor 再发起一次定向回溯,为缺少起点的精确 turn 向旧日期文件最多回读 8 MB。之后每 2 秒 tail 当日增量,保留半行、跨日先读旧文件尾部;live 每成功处理一个分块就推进到最后完整行 offset,后续分块失败只重试未处理部分。旧文件异常触发 bootstrap 时保留 bootstrap 设置的新日期 offset,临时读取失败则保留旧日期等待下轮重试。bootstrap、定时轮询和 Mac 唤醒补读共用串行入口,读取期间到达的请求合并为当前读取结束后的一次补读;monitor generation 会丢弃停用 reader 的迟到批次- `CodexSessionLifecycleReader`: 后台 actor,只为 monitor 当前的精确 session + turn 定位对应 rollout;便宜目录每 10 秒重试,每个活跃生命周期最多递归 `sessions` 一次并保留负缓存,缓存文件移动、session 重新活跃或 Mac 唤醒时重置。rollout 初次最多读取末尾 512 KB,之后按 offset 增量读取;`task_started` 回填缺失起点,`task_complete` 补齐结束和精确耗时,`turn_aborted` 由 monitor 静默移除任务,读取失败时不改变 Hook 状态。轮询和即时 lifecycle 查询都绑定 reader generation,跨 actor 返回后仍会复核,旧查询不能落入新 reader 状态-活动并发以 session 为边界:不同 session 可以同时运行;同一 session 的 turn 按顺序执行。收到新的 `UserPromptSubmit` 时,monitor 会移除该 session 中更早且缺少结束信号的 turn;rollout 收到 `turn_aborted` 时移除对应精确 turn。两种情况都视为中断而不是完成,因此不会触发绿色完成状态或长任务通知。Hook `Stop` 与 rollout `task_complete` 均视为完成信号,先到者生效,后到者按任务键和 session 回退键去重 24 小时;重复完成不会覆盖首次确认结果,也不会缩短去重窗口。去重键独立参与最近 deadline 清理,读取时也会惰性移除过期值;迟到的非 Prompt 事件不会重新恢复已完成任务,时间晚于完成记录的新 Prompt 才能开始下一段生命周期。+活动并发以 session 为边界:不同 session 可以同时运行;同一 session 的 turn 按顺序执行。收到新的 `UserPromptSubmit` 时,monitor 会移除该 session 中更早且缺少结束信号的 turn;rollout 收到 `turn_aborted` 时移除对应精确 turn。两种情况都视为中断而不是完成,因此不会触发绿色完成状态、长任务通知或完成触觉反馈。Hook `Stop` 与 rollout `task_complete` 均视为完成信号,先到者生效,后到者按任务键和 session 回退键去重 24 小时;重复完成不会覆盖首次确认结果,也不会缩短去重窗口或再次触发反馈。去重键独立参与最近 deadline 清理,读取时也会惰性移除过期值;迟到的非 Prompt 事件不会重新恢复已完成任务,时间晚于完成记录的新 Prompt 才能开始下一段生命周期。-设置页交互: 「系统通知」主开关行保留在设置窗口内, 子选项 (五类子开关与两个阈值 Picker) 在主选项右侧的子面板中展开 (`NotificationOptionsPanelController`, 复用 SidePanelSupport 抽屉机制挂在设置窗口上, 内容用常驻 hosting controller + ObservableObject 驱动, 面板尺寸在 Hook 开/关两种状态下保持不变)。「任务等待通知」紧跟在「任务完成通知」下方。主开关开启后仅在系统授权允许时展开, 首次授权场景会等待授权结果; 点击行内滑杆按钮可手动展开; 设置窗口 resign key/关闭、主开关关闭或授权变为被拒时自动收起。任务完成与任务等待子项在 Hook 未开启时显示为关闭并置灰, 不修改各自持久化偏好, Hook 重新开启后恢复用户原选择。授权被拒的引导文案与"打开系统设置"按钮仍内联显示在主开关行下方, 插入提示时不触发设置项纵向动画。+设置页交互: 「系统通知」主开关行保留在设置窗口内, 子选项 (五类通知子开关、任务触觉开关与两个阈值 Picker) 在主选项右侧的子面板中展开 (`NotificationOptionsPanelController`, 复用 SidePanelSupport 抽屉机制挂在设置窗口上, 内容用常驻 hosting controller + ObservableObject 驱动, 面板尺寸在 Hook 开/关两种状态下保持不变)。「任务等待通知」和「任务触觉反馈」依次排列在「任务完成通知」下方。主开关开启后仅在系统授权允许时展开, 首次授权场景会等待授权结果; 点击行内滑杆按钮可手动展开; 设置窗口 resign key/关闭、主开关关闭或授权变为被拒时自动收起。任务完成、任务等待与任务触觉子项在 Hook 未开启时显示为关闭并置灰, 不修改各自持久化偏好, Hook 重新开启后恢复用户原选择。授权被拒的引导文案与"打开系统设置"按钮仍内联显示在主开关行下方, 插入提示时不触发设置项纵向动画。五类通知的触发与去重:| 通知 | 触发 | 去重键 || ------------ | -------------------------------------------------------------------------------------------------- | ------------------------------------------ || 额度低阈值 | 非 stale 快照中窗口剩余比例穿越到 ≤ 阈值; 阈值或子开关变化时用当前快照立即重评估 | `low\|账号\|limitId\|windowId\|resetsAt` |-| 额度重置完成 | 本周期曾跌破阈值 (与低阈值子开关无关) 且到达 resetsAt; 补发时效为一个窗口周期 | `reset\|账号\|limitId\|windowId\|resetsAt` |+| 额度即将重置 | 可信额度窗口具有 `resetsAt`,在该时间发送“即将重置”通知;不要求本周期曾跌破低额度阈值,补发时效为一个窗口周期 | `reset\|账号\|limitId\|windowId\|resetsAt` || 长任务完成 | monitor 的 live Hook `Stop` 或 rollout `task_complete` transition 具有精确耗时且耗时 ≥ 阈值 | 状态机按精确任务键对两种完成信号去重 || 任务等待批准 | monitor 的 live 批次结束后任务最终仍处于 `waitingApproval` | 同批次按任务键合并,最终快照只发布一次 || 重置机会临期 | 过期时间距今 ≤ 7 天, 并在过期前 7/6/5/4/3/2/1 天各提醒一次; 正文使用本地时间 `yyyy-MM-dd HH:mm:ss` | `credit\|账号\|过期时间\|提醒档位` |-额度和重置机会通知的已发送去重键持久化在 UserDefaults (`Notification.sentKeys`, 上限 300 条滚动淘汰), 账号维度包含在键中, 切换账号自动隔离。任务等待去重只保留在当前进程内。bootstrap 会恢复 App 启动前滚动 24 小时内的任务状态,但永远不发布 transition,因此不会补发历史权限或完成通知;重新开启通知也不会回放旧事件。+额度和重置机会通知的已发送去重键持久化在 UserDefaults (`Notification.sentKeys`, 上限 300 条滚动淘汰), 账号维度包含在键中, 切换账号自动隔离。任务等待去重只保留在当前进程内。bootstrap 会恢复 App 启动前滚动 24 小时内的任务状态,但永远不发布 transition,因此不会补发历史权限通知、完成通知或触觉反馈;重新开启通知也不会回放旧事件。++「任务触觉反馈」使用 `Notification.taskHapticEnabled` 持久化,缺失时默认开启。等待批准和任意任务完成 transition 都启动一段触觉反馈任务:每 150 ms 请求一次 `.levelChange`,连续 10 次;新 transition 会取消并重启当前序列,开关关闭后会在下一脉冲前停止。触觉反馈不受长任务阈值与系统通知授权影响;App 内「系统通知」总开关关闭时不触发。`NSHapticFeedbackManager.defaultPerformer` 会按当前输入设备、辅助功能与系统偏好决定是否实际反馈及震感强弱。通知错误处理 (延续"细节不打扰用户"原则, 不写入请求日志窗口):@@ -1116,6 +1118,6 @@ App 再次成为 active 时, 也会刷新 Codex 版本区、同步可用性, 并| rollout 文件不存在或读取失败 | 保留 Hook 推导的任务状态,不猜测任务已经中断 || 休眠错过 resetsAt | 唤醒时补检, 超过一个窗口周期的恢复提醒直接丢弃 || Hook 关闭 | monitor 停止 tail 并清空实时状态 |-| 通知总开关或任务通知关闭 | 仅阻止发送;monitor 与菜单栏活动状态继续更新 |+| 通知总开关或任务通知关闭 | 阻止对应通知;总开关关闭时也阻止触觉反馈,monitor 与菜单栏活动状态继续更新 |通知点击通过 `UNUserNotificationCenterDelegate` 回调 `StatusItemController.openMenuSurfaceFromNotification()`, 复用全局快捷键的打开路径 (含 fallback 面板兜底)。diff --git a/README.md b/README.mdindex 0f48e76..27711ed 100644--- a/README.md+++ b/README.md@@ -15,10 +15,11 @@ Codex 的额度、Token 用量和使用情况通常分散在终端、App 或 Ses- 查看当前账号是否已登录,以及 Codex CLI / Codex.app 的运行版本- 跟踪不同时间窗口的额度剩余比例和下一次重置时间- 用 30 周热力图回顾每日 Token 用量-- 在开启 Codex Hook 后在 30 周热力图中可查看当天最热模型,以及会话、对话轮次、工具调用、权限请求、上下文压缩和子智能体统计 (仅在开启后可记录查看,无法查看到历史数据)-- 通过菜单栏图标颜色和面板活动卡片实时查看 Codex 正在运行、等待批准及刚完成的任务+- 在开启 Codex Hook 后在 30 周热力图中可查看当天最热模型,以及会话、对话轮次、调用工具、权限请求、上下文压缩和子智能体统计 (仅在开启后可记录查看,无法查看到历史数据)+- 通过菜单栏状态点和面板活动卡片实时查看 Codex 正在运行、等待批准及刚完成的任务- 通过可选 iCloud 私有数据库同步实现跨设备数据合并- 额度告急、额度恢复、任务等待批准、长任务完成时收到系统通知(可选开启)+- 任务等待批准或结束时通过支持的触控板获得触觉反馈(可选开启)## 有什么功能@@ -36,7 +37,7 @@ CodexBar 是一个无 Dock 图标的 macOS 菜单栏应用。「菜单栏额度指示」默认开启,菜单栏图标左侧会以一条细竖向进度条显示当前账号 Codex 额度中所选窗口的剩余比例;关闭后菜单栏图标保持纯图标显示。-开启 Codex Hook 后,菜单栏小人会用颜色反映实时任务状态:默认跟随系统颜色,运行中为蓝色、等待批准为橙色、刚完成为绿色,账号异常为红色。优先级依次为账号异常、等待批准、运行中、刚完成和暂无活动;额度竖条保持自己的颜色,不随小人状态改变。+开启 Codex Hook 后,菜单栏小人右下角的状态点会反映实时任务状态:运行中为蓝色、等待批准为橙色、刚完成为绿色,暂无活动时不显示。状态优先级依次为等待批准、运行中、刚完成和暂无活动;小人保持系统前景色,账号异常仍使用带叉图标表示,额度竖条也保持自己的颜色。菜单面板账号卡片下方会固定显示活动卡片,汇总当前项目、模型、工具、耗时和其他并发任务数量。绿色完成状态保留 20 秒,最近完成记录会在活动卡片保留 5 分钟;app-server 异常时活动卡片仍会继续展示本机 Hook 状态。@@ -54,11 +55,11 @@ CodexBar 是一个无 Dock 图标的 macOS 菜单栏应用。### Codex Hook 使用详情-在设置中开启「启用 Codex Hook」后,CodexBar 会把自身注册为本机 Codex Hook 用于记录会话开始、回复结束、工具调用、权限请求、上下文压缩和子智能体事件。+在设置中开启「启用 Codex Hook」后,CodexBar 会把自身注册为本机 Codex Hook 用于记录会话开始、回复结束、调用工具、权限请求、上下文压缩和子智能体事件。统计结果会汇总到热力图详情面板中,不打断正常的 Codex 使用流程。-主 App 还会在后台只读 Hook JSONL:启动时按块恢复最近 24 小时的活动,之后 tail 当天新增事件,并在内存中维护并发任务状态。跨日任务缺少起点时会按精确 session + turn 定向查找更早的 Prompt;对于仍处于运行或等待状态的精确 turn,CodexBar 会增量读取对应本机 Codex session rollout,仅用 `task_started` 回填缺失起点、用 `task_complete` 补齐缺失的结束、用 `turn_aborted` 静默清理中断任务。不读取提示词、回复、推理或工具内容。该实时状态用于菜单栏颜色、活动卡片和可选任务通知,不新增历史状态文件,也不参与跨设备同步。+主 App 还会在后台只读 Hook JSONL:启动时按块恢复最近 24 小时的活动,之后 tail 当天新增事件,并在内存中维护并发任务状态。跨日任务缺少起点时会按精确 session + turn 定向查找更早的 Prompt;对于仍处于运行或等待状态的精确 turn,CodexBar 会增量读取对应本机 Codex session rollout,仅用 `task_started` 回填缺失起点、用 `task_complete` 补齐缺失的结束、用 `turn_aborted` 静默清理中断任务。不读取提示词、回复、推理或工具内容。该实时状态用于菜单栏状态点、活动卡片、可选任务通知和触觉反馈,不新增历史状态文件,也不参与跨设备同步。CodexBar 只会追加或移除属于当前 CodexBar 可执行文件的 Hook,不会删除用户已有的其他 Codex Hook。@@ -74,21 +75,23 @@ CodexBar 会把该设备的使用详情数据同步到当前 iCloud 账号的 Cl完整同步范围见 [跨设备同步文档](Docs/CrossDeviceSync.md)-### 系统通知提醒+### 系统通知与触觉反馈在设置中开启「系统通知」后,CodexBar 会在关键状态变化时发送本地通知:- 额度剩余比例跌破所选阈值 (5% / 10% / 25%)-- 曾跌破阈值的额度窗口完成重置+- 额度窗口到达预计重置时间时提示即将重置- Codex 完成一轮超过所选时长的任务 (需开启 Codex Hook)- Codex 请求批准工具操作并等待用户处理 (需开启 Codex Hook)- 手动重置机会将在 7 天内过期,并按 24 小时间隔提醒五类通知可以单独开关;全部为本地通知,不新增网络请求。+通知子面板中的「任务触觉反馈」默认开启;当任务进入等待批准或确认结束时,CodexBar 会每 150 ms 请求一次层级变化触觉反馈,连续 10 次。该功能服从 App 内「系统通知」总开关,但不依赖系统通知授权或长任务时长阈值;是否实际反馈及震感强弱由当前输入设备、辅助功能和系统偏好决定。+Hook 事件可能在一次轮询中成批到达。CodexBar 会先处理完整批次,再按任务合并等待状态:只有批次结束后仍在等待批准的任务才通知一次;已经恢复运行、完成或移除的短暂等待不会产生过期提醒。-Hook `Stop` 与本机 rollout 的完成信号会统一去重;迟到的重复完成、工具或权限事件不会让已完成任务重复通知或重新显示为活动状态。+Hook `Stop` 与本机 rollout 的完成信号会统一去重;迟到的重复完成、工具或权限事件不会让已完成任务重复通知、触发触觉反馈或重新显示为活动状态。### 日志与版本信息diff --git a/appcast.xml b/appcast.xmlindex ba0800c..219105c 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.3.2</title>+ <sparkle:version>40</sparkle:version>+ <sparkle:shortVersionString>3.3.2</sparkle:shortVersionString>+ <sparkle:minimumSystemVersion>15.0</sparkle:minimumSystemVersion>+ <sparkle:releaseNotesLink>https://codexbar.zabrian.app/notes#3.3.2</sparkle:releaseNotesLink>+ <pubDate>Fri, 10 Jul 2026 19:58:06 +0800</pubDate>+ <enclosure url="https://codexbar.zabrian.app/download/CodexBar-v3.3.2.dmg" sparkle:edSignature="9Ev14FIUNz82Onbbzu0cwKOzvZAMepoktYCBSXrKlEhv8LBWqCJrp7yweV2pUERx+VH1M3UvTo+oR3STwZSkDQ==" length="3858056" type="application/octet-stream"/>+ </item><item><title>CodexBar.app 3.3.1</title><sparkle:version>39</sparkle:version>