CodexBar 是一个 macOS 菜单栏应用,用于查看本机 Codex 账号状态、额度、Token 用量、详细统计信息
Swift appkitcodexcodex-clideveloper-toolsmacosmacos-appmenu-bar-appopenai-codexproductivityswiftswiftuiusage-tracker
feat: 展示任务推理强度与子 Agent 数量
Bob1dcb58169eb8
diff --git a/CodexBar.xcodeproj/project.pbxproj b/CodexBar.xcodeproj/project.pbxprojindex 9903a6a..e7743d4 100644--- a/CodexBar.xcodeproj/project.pbxproj+++ b/CodexBar.xcodeproj/project.pbxproj@@ -3,7 +3,7 @@archiveVersion = 1;classes = {};- objectVersion = 77;+ objectVersion = 100;objects = {/* Begin PBXBuildFile section */@@ -38,11 +38,9 @@/* Begin PBXFrameworksBuildPhase section */C4A0FD922FD9302E000263A7 /* Frameworks */ = {isa = PBXFrameworksBuildPhase;- buildActionMask = 2147483647;files = (C42A52F12FDACDEC004A2B53 /* Sparkle in Frameworks */,);- runOnlyForDeploymentPostprocessing = 0;};/* End PBXFrameworksBuildPhase section */@@ -76,8 +74,6 @@);buildRules = ();- dependencies = (- );fileSystemSynchronizedGroups = (9E664A4C2FDD47530016B96E /* CodexBar */,);@@ -116,7 +112,7 @@packageReferences = (C42A52EF2FDACDEC004A2B53 /* XCRemoteSwiftPackageReference "Sparkle" */,);- preferredProjectObjectVersion = 77;+ preferredProjectObjectVersion = 100;productRefGroup = C4A0FD962FD9302E000263A7 /* Products */;projectDirPath = "";projectRoot = "";@@ -129,25 +125,21 @@/* Begin PBXResourcesBuildPhase section */C4A0FD932FD9302E000263A7 /* Resources */ = {isa = PBXResourcesBuildPhase;- buildActionMask = 2147483647;files = ();- runOnlyForDeploymentPostprocessing = 0;};/* End PBXResourcesBuildPhase section *//* Begin PBXSourcesBuildPhase section */C4A0FD912FD9302E000263A7 /* Sources */ = {isa = PBXSourcesBuildPhase;- buildActionMask = 2147483647;files = ();- runOnlyForDeploymentPostprocessing = 0;};/* End PBXSourcesBuildPhase section *//* Begin XCBuildConfiguration section */- C4A0FD9E2FD9302E000263A7 /* Debug */ = {+ C4A0FD9E2FD9302E000263A7 /* Debug configuration for PBXProject "CodexBar" */ = {isa = XCBuildConfiguration;buildSettings = {ALWAYS_SEARCH_USER_PATHS = NO;@@ -214,7 +206,7 @@};name = Debug;};- C4A0FD9F2FD9302E000263A7 /* Release */ = {+ C4A0FD9F2FD9302E000263A7 /* Release configuration for PBXProject "CodexBar" */ = {isa = XCBuildConfiguration;buildSettings = {ALWAYS_SEARCH_USER_PATHS = NO;@@ -273,7 +265,7 @@};name = Release;};- C4A0FDA12FD9302E000263A7 /* Debug */ = {+ C4A0FDA12FD9302E000263A7 /* Debug configuration for PBXNativeTarget "CodexBar" */ = {isa = XCBuildConfiguration;buildSettings = {ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;@@ -282,7 +274,7 @@"CODE_SIGN_IDENTITY[sdk=macosx*]" = "Apple Development";CODE_SIGN_STYLE = Automatic;COMBINE_HIDPI_IMAGES = YES;- CURRENT_PROJECT_VERSION = 45;+ CURRENT_PROJECT_VERSION = 46;DEAD_CODE_STRIPPING = YES;DEVELOPMENT_TEAM = 4KJ362VJW5;ENABLE_APP_INTENTS_METADATA_GENERATION = NO;@@ -298,7 +290,7 @@"$(inherited)","@executable_path/../Frameworks",);- MARKETING_VERSION = 3.3.7;+ MARKETING_VERSION = 3.3.8;PRODUCT_BUNDLE_IDENTIFIER = app.zabrian.codexbar;PRODUCT_NAME = "$(TARGET_NAME)";REGISTER_APP_GROUPS = YES;@@ -311,7 +303,7 @@};name = Debug;};- C4A0FDA22FD9302E000263A7 /* Release */ = {+ C4A0FDA22FD9302E000263A7 /* Release configuration for PBXNativeTarget "CodexBar" */ = {isa = XCBuildConfiguration;buildSettings = {ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;@@ -321,7 +313,7 @@"CODE_SIGN_IDENTITY[sdk=macosx*]" = "Apple Development";CODE_SIGN_STYLE = Automatic;COMBINE_HIDPI_IMAGES = YES;- CURRENT_PROJECT_VERSION = 45;+ CURRENT_PROJECT_VERSION = 46;DEAD_CODE_STRIPPING = YES;DEVELOPMENT_TEAM = 4KJ362VJW5;ENABLE_APP_INTENTS_METADATA_GENERATION = NO;@@ -337,7 +329,7 @@"$(inherited)","@executable_path/../Frameworks",);- MARKETING_VERSION = 3.3.7;+ MARKETING_VERSION = 3.3.8;PRODUCT_BUNDLE_IDENTIFIER = app.zabrian.codexbar;PRODUCT_NAME = "$(TARGET_NAME)";PROVISIONING_PROFILE_SPECIFIER = "";@@ -357,19 +349,17 @@C4A0FD902FD9302E000263A7 /* Build configuration list for PBXProject "CodexBar" */ = {isa = XCConfigurationList;buildConfigurations = (- C4A0FD9E2FD9302E000263A7 /* Debug */,- C4A0FD9F2FD9302E000263A7 /* Release */,+ C4A0FD9E2FD9302E000263A7 /* Debug configuration for PBXProject "CodexBar" */,+ C4A0FD9F2FD9302E000263A7 /* Release configuration for PBXProject "CodexBar" */,);- defaultConfigurationIsVisible = 0;defaultConfigurationName = Release;};C4A0FDA02FD9302E000263A7 /* Build configuration list for PBXNativeTarget "CodexBar" */ = {isa = XCConfigurationList;buildConfigurations = (- C4A0FDA12FD9302E000263A7 /* Debug */,- C4A0FDA22FD9302E000263A7 /* Release */,+ C4A0FDA12FD9302E000263A7 /* Debug configuration for PBXNativeTarget "CodexBar" */,+ C4A0FDA22FD9302E000263A7 /* Release configuration for PBXNativeTarget "CodexBar" */,);- defaultConfigurationIsVisible = 0;defaultConfigurationName = Release;};/* End XCConfigurationList section */diff --git a/CodexBar/Controllers/SidePanelSupport.swift b/CodexBar/Controllers/SidePanelSupport.swiftindex 8e6ceb6..c02f4d7 100644--- a/CodexBar/Controllers/SidePanelSupport.swift+++ b/CodexBar/Controllers/SidePanelSupport.swift@@ -272,6 +272,10 @@ final class SidePanelContentHost<Root: View> {self.cornerRadius = cornerRadius}+ // Swift 6.3.3 的 EarlyPerfInliner 会在优化该泛型类型的合成析构函数时崩溃。+ @_optimize(none)+ deinit {}+var contentView: NSView? {hostingController?.view}diff --git a/CodexBar/Models/CodexActivityModels.swift b/CodexBar/Models/CodexActivityModels.swiftindex 1a7080d..21250f5 100644--- a/CodexBar/Models/CodexActivityModels.swift+++ b/CodexBar/Models/CodexActivityModels.swift@@ -30,10 +30,13 @@ nonisolated struct CodexActivityTaskSnapshot: Equatable, Identifiable {let latestEvent: CodexActivityEventlet projectName: String?let modelName: String?+ let effort: String?let toolName: String?let startedAt: Date?let stateChangedAt: Datelet showsPreciseDuration: Bool+ /// nil 表示 Hook 字段不足,无法可靠统计;0 表示已确认当前没有活跃子 Agent。+ let activeSubagentCount: Int?}/// 最近确认结束的任务。完成只表示一轮任务结束,不代表执行成功。@@ -41,6 +44,7 @@ nonisolated struct CodexActivityCompletion: Equatable, Identifiable {let id: UUIDlet projectName: String?let modelName: String?+ let effort: String?let completedAt: Datelet duration: TimeInterval?}@@ -50,6 +54,7 @@ nonisolated struct CodexActivityTermination: Equatable, Identifiable {let id: UUIDlet projectName: String?let modelName: String?+ let effort: String?let terminatedAt: Datelet duration: TimeInterval?}@@ -155,6 +160,11 @@ nonisolated enum CodexActivityDurationFormat {}nonisolated enum CodexActivityDisplayFormat {+ static func modelMetadata(modelName: String?, effort: String?) -> String? {+ let components = [modelName, effort].compactMap(normalizedText)+ return components.isEmpty ? nil : components.joined(separator: " • ")+ }+static func eventText(for task: CodexActivityTaskSnapshot) -> String {switch task.latestEvent {case .promptSubmitted:@@ -197,7 +207,7 @@ nonisolated enum CodexActivityDisplayFormat {"耗时 \(CodexActivityDurationFormat.text(for: duration))"}- /// 活动卡片和任务中心共用同一份文案片段,各自决定连接符。+ /// 活动卡片和任务中心共用同一份文案片段。static func waitingDetailComponents(for task: CodexActivityTaskSnapshot,now: Date@@ -242,4 +252,12 @@ nonisolated enum CodexActivityDisplayFormat {}return "\(seconds / 60) 分钟前\(action)"}++ private static func normalizedText(_ value: String?) -> String? {+ guard let value else {+ return nil+ }+ let trimmedValue = value.trimmingCharacters(in: .whitespacesAndNewlines)+ return trimmedValue.isEmpty ? nil : trimmedValue+ }}diff --git a/CodexBar/Models/CodexWorkflowModels.swift b/CodexBar/Models/CodexWorkflowModels.swiftindex 1cee031..06c6dd3 100644--- a/CodexBar/Models/CodexWorkflowModels.swift+++ b/CodexBar/Models/CodexWorkflowModels.swift@@ -63,10 +63,12 @@ nonisolated struct WorkflowHookEvent: Decodable, Equatable {let directoryPath: String?let toolName: String?let modelName: String?+ let effort: String?let permissionMode: String?let approvalReviewer: CodexApprovalReviewer?let sessionId: String?let turnId: String?+ let agentId: String?init(timestamp: Date,@@ -74,20 +76,24 @@ nonisolated struct WorkflowHookEvent: Decodable, Equatable {directoryPath: String?,toolName: String?,modelName: String?,+ effort: String?,permissionMode: String?,approvalReviewer: CodexApprovalReviewer?,sessionId: String?,- turnId: String?+ turnId: String?,+ agentId: String?) {self.timestamp = timestampself.name = nameself.directoryPath = directoryPathself.toolName = toolNameself.modelName = modelName+ self.effort = effortself.permissionMode = permissionModeself.approvalReviewer = approvalReviewerself.sessionId = sessionIdself.turnId = turnId+ self.agentId = agentId}init(from decoder: Decoder) throws {@@ -109,6 +115,7 @@ nonisolated struct WorkflowHookEvent: Decodable, Equatable {directoryPath = Self.string(from: container, key: .cwd)toolName = Self.string(from: container, key: .toolName)modelName = Self.string(from: container, key: .modelName)+ effort = Self.string(from: container, key: .effort)permissionMode = Self.string(from: container, key: .permissionMode)approvalReviewer = try? container.decode(CodexApprovalReviewer.self,@@ -116,6 +123,7 @@ nonisolated struct WorkflowHookEvent: Decodable, Equatable {)sessionId = Self.string(from: container, key: .sessionId)turnId = Self.string(from: container, key: .turnId)+ agentId = Self.string(from: container, key: .agentId)}var hookEvent: CodexHookEvent? {@@ -153,10 +161,12 @@ nonisolated struct WorkflowHookEvent: Decodable, Equatable {WorkflowJSON.field("timestamp", CodexDateFormat.localTimestampString(from: timestamp)),WorkflowJSON.field("event", name),WorkflowJSON.field("model", modelName),+ WorkflowJSON.field("effort", effort),WorkflowJSON.field("permission", permissionMode),WorkflowJSON.field("approval", approvalReviewer),WorkflowJSON.field("session", sessionId),WorkflowJSON.field("turn", turnId),+ WorkflowJSON.field("agent", agentId),WorkflowJSON.field("tool", toolName),WorkflowJSON.field("cwd", directoryPath)]@@ -170,10 +180,12 @@ nonisolated struct WorkflowHookEvent: Decodable, Equatable {case cwdcase toolName = "tool"case modelName = "model"+ case effortcase permissionMode = "permission"case approvalReviewer = "approval"case sessionId = "session"case turnId = "turn"+ case agentId = "agent"}}diff --git a/CodexBar/Services/Workflow/CodexActivityMonitor.swift b/CodexBar/Services/Workflow/CodexActivityMonitor.swiftindex baa3f31..a4a3649 100644--- a/CodexBar/Services/Workflow/CodexActivityMonitor.swift+++ b/CodexBar/Services/Workflow/CodexActivityMonitor.swift@@ -191,12 +191,16 @@ final class CodexActivityMonitor: ObservableObject {for state in states {let key = CodexActivityTaskKey.turn(session: state.sessionId, turn: state.turnId)if var pending = pendingTerminalTasks[key] {- if let startedAt = Self.backfilledStartedAt(for: pending.task, state: state) {- pending.task.startedAt = startedAt- pendingTerminalTasks[key] = pending- }+ let pendingDidChange = Self.mergeLifecycleBackfill(+ from: state,+ into: &pending.task+ )guard let terminal = state.terminal else {+ if pendingDidChange {+ pendingTerminalTasks[key] = pending+ didChange = true+ }continue}pendingTerminalTasks.removeValue(forKey: key)@@ -215,11 +219,7 @@ final class CodexActivityMonitor: ObservableObject {continue}- var taskDidChange = false- if let startedAt = Self.backfilledStartedAt(for: task, state: state) {- task.startedAt = startedAt- taskDidChange = true- }+ var taskDidChange = Self.mergeLifecycleBackfill(from: state, into: &task)if let terminal = state.terminal {tasks.removeValue(forKey: key)@@ -354,9 +354,9 @@ final class CodexActivityMonitor: ObservableObject {resumeTask(from: event, latestEvent: .compactionFinished, allowsRecovery: true)case .subagentStart:// 子智能体只更新所属顶层任务,不自行创建一条并发任务。- resumeTask(from: event, latestEvent: .subagentStarted, allowsRecovery: false)+ updateSubagentActivity(from: event, isStarting: true)case .subagentStop:- resumeTask(from: event, latestEvent: .subagentFinished, allowsRecovery: false)+ updateSubagentActivity(from: event, isStarting: false)case .permissionRequest:return waitForApproval(from: event)case .stop:@@ -466,6 +466,68 @@ final class CodexActivityMonitor: ObservableObject {)}+ private func updateSubagentActivity(+ from event: WorkflowHookEvent,+ isStarting: Bool+ ) {+ let eventKey = CodexActivityTaskKey(event: event)+ guard recentCompletionDate(for: eventKey) == nil,+ recentTerminationDate(for: eventKey) == nil,+ pendingTerminalTasks[eventKey] == nil,+ let key = matchingTaskKey(for: event),+ var task = tasks[key] else {+ return+ }++ // 子 Agent 只能按 session 关联父任务,忽略上一 turn 延迟到达的事件。+ if let startedAt = task.startedAt, event.timestamp < startedAt {+ return+ }++ task.recordSubagentActivity(+ agentId: event.agentId,+ isStarting: isStarting,+ at: event.timestamp,+ hasReliableTaskAssociation: hasReliableSubagentAssociation(+ eventSessionId: event.sessionId,+ matchedKey: key+ )+ )++ if event.timestamp >= task.lastActivityAt {+ if task.state != .running {+ task.state = .running+ task.stateChangedAt = event.timestamp+ }+ task.pendingApprovalRequestedAt = nil+ task.latestEvent = isStarting ? .subagentStarted : .subagentFinished+ task.mergeMetadata(from: event)+ task.lastActivityAt = event.timestamp+ }+ tasks[key] = task+ }++ /// Subagent Hook 的 turn 属于子 Agent 自己;父任务只能通过共享 session 关联。+ private func hasReliableSubagentAssociation(+ eventSessionId: String?,+ matchedKey: CodexActivityTaskKey+ ) -> Bool {+ guard let eventSessionId,+ matchedKey.sessionId == eventSessionId else {+ return false+ }++ let activeTaskCount = tasks.values.reduce(into: 0) { count, task in+ if task.key.sessionId == eventSessionId {+ count += 1+ }+ }+ let hasPendingTask = pendingTerminalTasks.values.contains {+ $0.task.key.sessionId == eventSessionId+ }+ return activeTaskCount == 1 && !hasPendingTask+ }+private func waitForApproval(from event: WorkflowHookEvent) -> CodexActivityLiveTransition? {let eventKey = CodexActivityTaskKey(event: event)guard recentCompletionDate(for: eventKey) == nil,@@ -523,7 +585,8 @@ final class CodexActivityMonitor: ObservableObject {completedAt: event.timestamp,reportedDuration: nil,projectName: event.projectDisplayName,- modelName: event.modelName+ modelName: event.modelName,+ effort: event.effort)return .completed(completion)}@@ -551,6 +614,7 @@ final class CodexActivityMonitor: ObservableObject {let completion = storeCompletion(projectName: event.projectDisplayName ?? task?.projectName,modelName: event.modelName ?? task?.modelName,+ effort: event.effort ?? task?.effort,completedAt: event.timestamp,duration: duration)@@ -767,19 +831,36 @@ private extension CodexActivityMonitor {return startedAt}+ static func mergeLifecycleBackfill(+ from state: CodexSessionTaskLifecycleState,+ into task: inout CodexActivityTask+ ) -> Bool {+ var didChange = false+ if let startedAt = backfilledStartedAt(for: task, state: state) {+ task.startedAt = startedAt+ didChange = true+ }+ if task.mergeEffort(state.effort) {+ didChange = true+ }+ return didChange+ }+func storeResolvedCompletion(_ task: CodexActivityTask,key: CodexActivityTaskKey,completedAt: Date,reportedDuration: TimeInterval?,projectName: String? = nil,- modelName: String? = nil+ modelName: String? = nil,+ effort: String? = nil) -> CodexActivityCompletion {// rollout 时间戳是整秒,避免因为同一秒内的 Hook 毫秒时间戳而把完成时间记在最后活动之前。let recordedCompletedAt = max(completedAt, task.lastActivityAt)let completion = storeCompletion(projectName: projectName ?? task.projectName,modelName: modelName ?? task.modelName,+ effort: effort ?? task.effort,completedAt: recordedCompletedAt,duration: reportedDuration ?? task.preciseDuration(until: recordedCompletedAt))@@ -790,6 +871,7 @@ private extension CodexActivityMonitor {func storeCompletion(projectName: String?,modelName: String?,+ effort: String?,completedAt: Date,duration: TimeInterval?) -> CodexActivityCompletion {@@ -797,6 +879,7 @@ private extension CodexActivityMonitor {id: UUID(),projectName: projectName,modelName: modelName,+ effort: effort,completedAt: completedAt,duration: duration)@@ -813,6 +896,7 @@ private extension CodexActivityMonitor {id: UUID(),projectName: task.projectName,modelName: task.modelName,+ effort: task.effort,terminatedAt: terminatedAt,duration: includesDuration ? task.preciseDuration(until: terminatedAt) : nil)@@ -992,12 +1076,15 @@ private struct CodexActivityTask {var latestEvent: CodexActivityEventvar projectName: String?var modelName: String?+ var effort: String?var toolName: String?var startedAt: Date?var stateChangedAt: Datevar lastActivityAt: Datevar approvalReviewer: CodexApprovalReviewer?var pendingApprovalRequestedAt: Date?+ var subagentsByID: [String: CodexSubagentObservation]+ var isSubagentCountReliable: Boolinit(displayID: UUID,@@ -1013,12 +1100,15 @@ private struct CodexActivityTask {self.latestEvent = latestEventprojectName = event.projectDisplayNamemodelName = event.modelName+ effort = Self.normalizedEffort(event.effort)toolName = event.toolNameself.startedAt = startedAtstateChangedAt = event.timestamplastActivityAt = event.timestampapprovalReviewer = event.approvalReviewerpendingApprovalRequestedAt = nil+ subagentsByID = [:]+ isSubagentCountReliable = startedAt != nil}var showsPreciseDuration: Bool {@@ -1039,10 +1129,12 @@ private struct CodexActivityTask {latestEvent: latestEvent,projectName: projectName,modelName: modelName,+ effort: effort,toolName: toolName,startedAt: startedAt,stateChangedAt: stateChangedAt,- showsPreciseDuration: showsPreciseDuration+ showsPreciseDuration: showsPreciseDuration,+ activeSubagentCount: activeSubagentCount)}@@ -1068,10 +1160,70 @@ private struct CodexActivityTask {mutating func mergeMetadata(from event: WorkflowHookEvent) {projectName = event.projectDisplayName ?? projectNamemodelName = event.modelName ?? modelName+ _ = mergeEffort(event.effort)toolName = event.toolName ?? toolNameapprovalReviewer = event.approvalReviewer ?? approvalReviewer}+ @discardableResult+ mutating func mergeEffort(_ incomingEffort: String?) -> Bool {+ guard let incomingEffort = Self.normalizedEffort(incomingEffort) else {+ return false+ }+ guard let effort else {+ effort = incomingEffort+ return true+ }+ guard effort != incomingEffort, effort != "mixed" else {+ return false+ }+ self.effort = "mixed"+ return true+ }++ mutating func recordSubagentActivity(+ agentId: String?,+ isStarting: Bool,+ at timestamp: Date,+ hasReliableTaskAssociation: Bool+ ) {+ guard hasReliableTaskAssociation, let agentId else {+ isSubagentCountReliable = false+ return+ }++ let previous = subagentsByID[agentId]+ if let previous, timestamp < previous.timestamp {+ return+ }+ if !isStarting, previous == nil {+ isSubagentCountReliable = false+ }+ subagentsByID[agentId] = CodexSubagentObservation(+ isRunning: isStarting,+ timestamp: timestamp+ )+ }++ private var activeSubagentCount: Int? {+ guard isSubagentCountReliable else {+ return nil+ }+ return subagentsByID.values.reduce(into: 0) { count, observation in+ if observation.isRunning {+ count += 1+ }+ }+ }++ private static func normalizedEffort(_ effort: String?) -> String? {+ guard let effort else {+ return nil+ }+ let value = effort.trimmingCharacters(in: .whitespacesAndNewlines)+ return value.isEmpty ? nil : value+ }+/// 记录审批候选;返回值只表示任务是否刚刚进入用户等待状态。mutating func recordApprovalRequest(at requestedAt: Date) -> Bool {pendingApprovalRequestedAt = requestedAt@@ -1096,3 +1248,8 @@ private struct CodexActivityTask {latestEvent = .approvalRequested}}++private struct CodexSubagentObservation {+ let isRunning: Bool+ let timestamp: Date+}diff --git a/CodexBar/Services/Workflow/CodexSessionLifecycleReader.swift b/CodexBar/Services/Workflow/CodexSessionLifecycleReader.swiftindex ecc7131..6a71f96 100644--- a/CodexBar/Services/Workflow/CodexSessionLifecycleReader.swift+++ b/CodexBar/Services/Workflow/CodexSessionLifecycleReader.swift@@ -41,6 +41,8 @@ actor CodexSessionLifecycleReader {recursiveFallbackSessionIds.formIntersection(activeSessionIds)var states: [CodexSessionTaskLifecycleState] = []+ var performedEffortBackfill = false+ let now = Date()for (sessionId, sessionReferences) in referencesBySession {guard let reference = sessionReferences.max(by: { $0.startedAt < $1.startedAt }),var cursor = cursor(for: reference) else {@@ -48,6 +50,42 @@ actor CodexSessionLifecycleReader {}scanNewLifecycleEvents(into: &cursor)+ pruneEffortBackfillState(+ in: &cursor,+ activeTurnIds: Set(sessionReferences.map(\.turnId))+ )+ if !performedEffortBackfill,+ let reference = effortBackfillReference(+ from: sessionReferences,+ cursor: cursor,+ now: now+ ) {+ performedEffortBackfill = true+ cursor.lastEffortBackfillAttemptByTurnId[reference.turnId] = now+ switch backfilledEffort(+ from: cursor.url,+ turnId: reference.turnId+ ) {+ case let .found(effort):+ var lifecycle = cursor.lifecycleByTurnId[reference.turnId]+ ?? SessionTurnLifecycle()+ lifecycle.apply(+ .context(approvalReviewer: nil, effort: effort)+ )+ cursor.lifecycleByTurnId[reference.turnId] = lifecycle+ cursor.completedEffortBackfillTurnIds.insert(reference.turnId)+ cursor.lastEffortBackfillAttemptByTurnId.removeValue(+ forKey: reference.turnId+ )+ case .notFound:+ cursor.completedEffortBackfillTurnIds.insert(reference.turnId)+ cursor.lastEffortBackfillAttemptByTurnId.removeValue(+ forKey: reference.turnId+ )+ case .unavailable:+ break+ }+ }cursorsBySession[sessionId] = cursorfor reference in sessionReferences {guard let lifecycle = cursor.lifecycleByTurnId[reference.turnId] else {@@ -59,6 +97,7 @@ actor CodexSessionLifecycleReader {turnId: reference.turnId,startedAt: lifecycle.startedAt,approvalReviewer: lifecycle.approvalReviewer,+ effort: lifecycle.effort,terminal: lifecycle.terminal))@@ -67,6 +106,44 @@ actor CodexSessionLifecycleReader {return states}+ private func pruneEffortBackfillState(+ in cursor: inout SessionFileCursor,+ activeTurnIds: Set<String>+ ) {+ cursor.completedEffortBackfillTurnIds.formIntersection(activeTurnIds)+ cursor.lastEffortBackfillAttemptByTurnId = cursor+ .lastEffortBackfillAttemptByTurnId+ .filter { activeTurnIds.contains($0.key) }+ }++ private func effortBackfillReference(+ from references: [CodexActivityTurnReference],+ cursor: SessionFileCursor,+ now: Date+ ) -> CodexActivityTurnReference? {+ guard cursor.hasUnscannedHistoricalPrefix else {+ return nil+ }++ return references+ .filter { reference in+ guard now.timeIntervalSince(reference.startedAt)+ >= Self.effortBackfillMinimumTaskAge,+ cursor.lifecycleByTurnId[reference.turnId]?.effort == nil,+ cursor.lifecycleByTurnId[reference.turnId]?.terminal == nil,+ !cursor.completedEffortBackfillTurnIds.contains(reference.turnId) else {+ return false+ }+ guard let lastAttempt = cursor+ .lastEffortBackfillAttemptByTurnId[reference.turnId] else {+ return true+ }+ return now.timeIntervalSince(lastAttempt)+ >= Self.effortBackfillRetryInterval+ }+ .max(by: { $0.startedAt < $1.startedAt })+ }+/// 唤醒后允许仍未定位到文件的活跃 session 重新执行一次递归兜底。func resetResolutionFallbacks() {lastResolutionAttemptBySession.removeAll()@@ -165,10 +242,50 @@ actor CodexSessionLifecycleReader {fileIdentifier: stat?.identifier,offset: offset,discardsLeadingPartialLine: offset > 0,- lifecycleByTurnId: [:]+ lifecycleByTurnId: [:],+ hasUnscannedHistoricalPrefix: offset > 0,+ completedEffortBackfillTurnIds: [],+ lastEffortBackfillAttemptByTurnId: [:])}+ private func backfilledEffort(+ from url: URL,+ turnId: String+ ) -> EffortBackfillResult {+ let size = WorkflowStorage.fileSize(at: url)+ guard size > 0,+ let handle = try? FileHandle(forReadingFrom: url) else {+ return .unavailable+ }+ defer {+ try? handle.close()+ }++ let offset = size > Self.effortBackfillByteLimit+ ? size - Self.effortBackfillByteLimit+ : 0+ guard (try? handle.seek(toOffset: offset)) != nil,+ let data = try? handle.readToEnd(),+ !data.isEmpty else {+ return .unavailable+ }++ let completeData = offset > 0+ ? JSONLines.droppingLeadingPartialLine(data)+ : data+ for envelope in JSONLines.decode(+ CodexRolloutLineEnvelope.self,+ from: completeData+ ).reversed() where envelope.type == "turn_context"+ && envelope.payload?.turnId == turnId {+ if let effort = envelope.payload?.normalizedEffort {+ return .found(effort)+ }+ }+ return .notFound+ }+private func scanNewLifecycleEvents(into cursor: inout SessionFileCursor) {let stat = WorkflowStorage.fileStat(at: cursor.url)let size = stat?.size ?? 0@@ -218,6 +335,9 @@ actor CodexSessionLifecycleReader {}private static let bootstrapByteLimit: UInt64 = 512 * 1024+ private static let effortBackfillByteLimit: UInt64 = 8 * 1024 * 1024+ private static let effortBackfillMinimumTaskAge: TimeInterval = 2+ private static let effortBackfillRetryInterval: TimeInterval = 10private static let fileResolutionRetryInterval: TimeInterval = 10}@@ -227,6 +347,15 @@ private nonisolated struct SessionFileCursor {var offset: UInt64var discardsLeadingPartialLine: Boolvar lifecycleByTurnId: [String: SessionTurnLifecycle]+ let hasUnscannedHistoricalPrefix: Bool+ var completedEffortBackfillTurnIds: Set<String>+ var lastEffortBackfillAttemptByTurnId: [String: Date]+}++private nonisolated enum EffortBackfillResult {+ case found(String)+ case notFound+ case unavailable}/// Codex rollout JSONL 单行的共享解码模型@@ -244,6 +373,15 @@ nonisolated struct CodexRolloutLinePayload: Decodable {let completedAt: Double?let durationMilliseconds: Double?let approvalReviewer: CodexApprovalReviewer?+ let effort: String?++ var normalizedEffort: String? {+ guard let effort else {+ return nil+ }+ let value = effort.trimmingCharacters(in: .whitespacesAndNewlines)+ return value.isEmpty ? nil : value+ }private enum CodingKeys: String, CodingKey {case type@@ -252,6 +390,7 @@ nonisolated struct CodexRolloutLinePayload: Decodable {case completedAt = "completed_at"case durationMilliseconds = "duration_ms"case approvalReviewer = "approvals_reviewer"+ case effort}}@@ -263,11 +402,17 @@ private nonisolated extension CodexRolloutLineEnvelope {return nil}- if type == "turn_context",- let approvalReviewer = payload.approvalReviewer {+ if type == "turn_context" {+ let effort = payload.normalizedEffort+ guard payload.approvalReviewer != nil || effort != nil else {+ return nil+ }return SessionLifecycleEvent(turnId: turnId,- change: .approvalReviewer(approvalReviewer)+ change: .context(+ approvalReviewer: payload.approvalReviewer,+ effort: effort+ ))}@@ -314,7 +459,7 @@ private nonisolated struct SessionLifecycleEvent {private nonisolated enum SessionLifecycleChange {case started(at: Date)- case approvalReviewer(CodexApprovalReviewer)+ case context(approvalReviewer: CodexApprovalReviewer?, effort: String?)case completed(at: Date, duration: TimeInterval?)case aborted(at: Date?)}@@ -322,6 +467,7 @@ private nonisolated enum SessionLifecycleChange {private nonisolated struct SessionTurnLifecycle {var startedAt: Date?var approvalReviewer: CodexApprovalReviewer?+ var effort: String?var terminal: CodexSessionTaskTerminalState?mutating func apply(_ change: SessionLifecycleChange) {@@ -332,8 +478,9 @@ private nonisolated struct SessionTurnLifecycle {} else {startedAt = at}- case let .approvalReviewer(value):- approvalReviewer = value+ case let .context(reviewer, reasoningEffort):+ approvalReviewer = reviewer ?? approvalReviewer+ effort = reasoningEffort ?? effortcase let .completed(at, duration):terminal = .completed(at: at, duration: duration)case let .aborted(at):@@ -347,6 +494,7 @@ nonisolated struct CodexSessionTaskLifecycleState {let turnId: Stringlet startedAt: Date?let approvalReviewer: CodexApprovalReviewer?+ let effort: String?let terminal: CodexSessionTaskTerminalState?}diff --git a/CodexBar/Services/Workflow/WorkflowHookEventRecorder.swift b/CodexBar/Services/Workflow/WorkflowHookEventRecorder.swiftindex 5d2002b..c55b0e6 100644--- a/CodexBar/Services/Workflow/WorkflowHookEventRecorder.swift+++ b/CodexBar/Services/Workflow/WorkflowHookEventRecorder.swift@@ -31,7 +31,8 @@ nonisolated enum WorkflowHookEventRecorder {let permission = payload.string(for: "permission_mode")let sessionId = payload.string(for: "session_id")let turnId = payload.string(for: "turn_id")- let approvalReviewer = readApprovalReviewer(+ let agentId = payload.string(for: "agent_id")+ let turnContext = readTurnContext(from: payload,eventName: eventName,turnId: turnId@@ -42,27 +43,29 @@ nonisolated enum WorkflowHookEventRecorder {directoryPath: cwd,toolName: tool,modelName: model,+ effort: turnContext?.effort,permissionMode: permission,- approvalReviewer: approvalReviewer,+ approvalReviewer: turnContext?.approvalReviewer,sessionId: sessionId,- turnId: turnId+ turnId: turnId,+ agentId: agentId)try recordWorkflowTransaction(event: event)}- private static func readApprovalReviewer(+ private static func readTurnContext(from payload: WorkflowHookPayload,eventName: String,turnId: String?- ) -> CodexApprovalReviewer? {+ ) -> WorkflowTurnContext? {guard let hookEvent = CodexHookEvent(eventName: eventName),hookEvent == .userPromptSubmit || hookEvent == .permissionRequest,let turnId,let transcriptPath = payload.string(for: "transcript_path") else {return nil}- return WorkflowTurnContextReader.approvalReviewer(+ return WorkflowTurnContextReader.context(transcriptPath: transcriptPath,turnId: turnId)@@ -121,12 +124,12 @@ nonisolated enum WorkflowHookEventRecorder {}}-/// Hook payload 不直接提供 reviewer;从当前 rollout 尾部只提取匹配 turn 的审批路由。+/// Hook payload 不直接提供 reviewer 和 effort;从当前 rollout 尾部只提取匹配 turn 的上下文。private nonisolated enum WorkflowTurnContextReader {- static func approvalReviewer(+ static func context(transcriptPath: String,turnId: String- ) -> CodexApprovalReviewer? {+ ) -> WorkflowTurnContext? {let url = URL(fileURLWithPath: transcriptPath)let size = WorkflowStorage.fileSize(at: url)guard size > 0,@@ -147,10 +150,16 @@ private nonisolated enum WorkflowTurnContextReader {let completeData = offset > 0 ? JSONLines.droppingLeadingPartialLine(data) : datafor envelope in JSONLines.decode(CodexRolloutLineEnvelope.self, from: completeData)- .reversed()- where envelope.type == "turn_context"- && envelope.payload?.turnId == turnId {- return envelope.payload?.approvalReviewer+ .reversed() {+ guard envelope.type == "turn_context",+ let payload = envelope.payload,+ payload.turnId == turnId else {+ continue+ }+ return WorkflowTurnContext(+ approvalReviewer: payload.approvalReviewer,+ effort: payload.normalizedEffort+ )}return nil}@@ -158,6 +167,11 @@ private nonisolated enum WorkflowTurnContextReader {private static let searchByteLimit: UInt64 = 512 * 1024}+private nonisolated struct WorkflowTurnContext {+ let approvalReviewer: CodexApprovalReviewer?+ let effort: String?+}+/// Codex Hook payload 字段存在版本差异, 这里集中做宽松类型归一化private nonisolated struct WorkflowHookPayload {let values: [String: Any]diff --git a/CodexBar/Views/Menu/CodexActivityCard.swift b/CodexBar/Views/Menu/CodexActivityCard.swiftindex 7280810..fbd3af8 100644--- a/CodexBar/Views/Menu/CodexActivityCard.swift+++ b/CodexBar/Views/Menu/CodexActivityCard.swift@@ -97,26 +97,36 @@ struct CodexActivityCard: View {private func content(at now: Date) -> ActivityCardContent {switch snapshot.primaryActivity {case let .waiting(task):- let details = CodexActivityDisplayFormat.waitingDetailComponents(for: task, now: now)+ let details = activeDetailComponents(+ CodexActivityDisplayFormat.waitingDetailComponents(for: task, now: now),+ task: task+ )return ActivityCardContent(symbolName: "hand.raised.fill",tint: .orange,- title: task.projectName ?? "Codex 等待批准",+ title: activityTitle(+ modelName: task.modelName,+ effort: task.effort,+ projectName: task.projectName,+ fallback: "Codex 等待批准"+ ),detail: details.joined(separator: " • "),otherTaskCount: otherTaskCount)case let .running(task):- var titles: [String] = []- if let modelName = task.modelName {- titles.append(modelName)- }- titles.append(task.projectName ?? "Codex")-- let details = CodexActivityDisplayFormat.runningDetailComponents(for: task, now: now)+ let details = activeDetailComponents(+ CodexActivityDisplayFormat.runningDetailComponents(for: task, now: now),+ task: task+ )return ActivityCardContent(symbolName: "bolt.fill",tint: .blue,- title: titles.joined(separator: " • "),+ title: activityTitle(+ modelName: task.modelName,+ effort: task.effort,+ projectName: task.projectName,+ fallback: "Codex"+ ),detail: details.joined(separator: " • "),otherTaskCount: otherTaskCount)@@ -128,7 +138,12 @@ struct CodexActivityCard: View {return ActivityCardContent(symbolName: "checkmark.circle.fill",tint: .green,- title: completion.projectName ?? "Codex 任务已完成",+ title: activityTitle(+ modelName: completion.modelName,+ effort: completion.effort,+ projectName: completion.projectName,+ fallback: "Codex 任务已完成"+ ),detail: details.joined(separator: " • "),otherTaskCount: 0)@@ -140,7 +155,12 @@ struct CodexActivityCard: View {return ActivityCardContent(symbolName: "xmark.circle.fill",tint: .secondary,- title: termination.projectName ?? "Codex 任务已终止",+ title: activityTitle(+ modelName: termination.modelName,+ effort: termination.effort,+ projectName: termination.projectName,+ fallback: "Codex 任务已终止"+ ),detail: details.joined(separator: " • "),otherTaskCount: 0)@@ -155,6 +175,35 @@ struct CodexActivityCard: View {}}+ private func activityTitle(+ modelName: String?,+ effort: String?,+ projectName: String?,+ fallback: String+ ) -> String {+ [+ CodexActivityDisplayFormat.modelMetadata(+ modelName: modelName,+ effort: effort+ ),+ projectName ?? fallback+ ]+ .compactMap(\.self)+ .joined(separator: " • ")+ }++ private func activeDetailComponents(+ _ components: [String],+ task: CodexActivityTaskSnapshot+ ) -> [String] {+ guard let count = task.activeSubagentCount, count > 0 else {+ return components+ }+ var result = components+ result.insert("\(count) 个子 Agent", at: min(1, result.count))+ return result+ }+private var otherTaskCount: Int {max(0, snapshot.activeCount - 1)}diff --git a/CodexBar/Views/Menu/CodexActivityCenterView.swift b/CodexBar/Views/Menu/CodexActivityCenterView.swiftindex 155236c..5f586ad 100644--- a/CodexBar/Views/Menu/CodexActivityCenterView.swift+++ b/CodexBar/Views/Menu/CodexActivityCenterView.swift@@ -167,7 +167,7 @@ struct CodexActivityCenterView: View {components.append("最近终止 \(snapshot.recentTerminations.count)")}}- return components.joined(separator: " · ")+ return components.joined(separator: " • ")}private func taskSection(@@ -240,6 +240,7 @@ struct CodexActivityCenterView: View {tint: tint,projectName: task.projectName,modelName: task.modelName,+ effort: task.effort,detail: taskDetail(task, now: now, isWaiting: isWaiting))}@@ -250,6 +251,7 @@ struct CodexActivityCenterView: View {tint: .green,projectName: completion.projectName,modelName: completion.modelName,+ effort: completion.effort,detail: historyDetail(duration: completion.duration,relativeText: CodexActivityDisplayFormat.completionRelativeText(@@ -266,6 +268,7 @@ struct CodexActivityCenterView: View {tint: .secondary,projectName: termination.projectName,modelName: termination.modelName,+ effort: termination.effort,detail: historyDetail(duration: termination.duration,relativeText: CodexActivityDisplayFormat.terminationRelativeText(@@ -281,6 +284,7 @@ struct CodexActivityCenterView: View {tint: Color,projectName: String?,modelName: String?,+ effort: String?,detail: String) -> some View {HStack(alignment: .top, spacing: 9) {@@ -290,7 +294,11 @@ struct CodexActivityCenterView: View {.frame(width: Metrics.symbolWidth, height: Metrics.titleLineHeight)VStack(alignment: .leading, spacing: 3) {- titleLine(projectName: projectName, modelName: modelName)+ titleLine(+ projectName: projectName,+ modelName: modelName,+ effort: effort+ )Text(detail).font(.caption2)@@ -304,7 +312,11 @@ struct CodexActivityCenterView: View {.transition(Metrics.contentTransition)}- private func titleLine(projectName: String?, modelName: String?) -> some View {+ private func titleLine(+ projectName: String?,+ modelName: String?,+ effort: String?+ ) -> some View {HStack(alignment: .firstTextBaseline, spacing: 8) {Text(projectName ?? "Codex").font(.caption.weight(.semibold))@@ -313,8 +325,11 @@ struct CodexActivityCenterView: View {Spacer(minLength: 4)- if let modelName {- Text(modelName)+ if let metadata = CodexActivityDisplayFormat.modelMetadata(+ modelName: modelName,+ effort: effort+ ) {+ Text(metadata).font(.caption2).foregroundStyle(.secondary).lineLimit(1)@@ -332,14 +347,14 @@ struct CodexActivityCenterView: View {let components = isWaiting? CodexActivityDisplayFormat.waitingDetailComponents(for: task, now: now): CodexActivityDisplayFormat.runningDetailComponents(for: task, now: now)- return components.joined(separator: " · ")+ return components.joined(separator: " • ")}private func historyDetail(duration: TimeInterval?, relativeText: String) -> String {CodexActivityDisplayFormat.historyDetailComponents(duration: duration,relativeText: relativeText- ).joined(separator: " · ")+ ).joined(separator: " • ")}private enum Metrics {diff --git a/Docs/CodexHook.md b/Docs/CodexHook.mdindex e37097b..3da01d7 100644--- a/Docs/CodexHook.md+++ b/Docs/CodexHook.md@@ -81,12 +81,14 @@ Hook stdin 会尝试解析为 Codex 官方 JSON 对象,只读取顶层字段- 目录: `cwd`- 工具: `tool_name`- 模型: `model`+- 推理强度来源: `transcript_path`;只在 `UserPromptSubmit` / `PermissionRequest` 时从对应 rollout 尾部最多 512 KB 查找同 turn 的 `turn_context.effort`,写为 `effort`- 权限模式: `permission_mode`,写入 `events/YYYY-MM-DD.jsonl` 时保存为 `permission`- 审批路由来源: `transcript_path`;只在 `UserPromptSubmit` / `PermissionRequest` 时从对应 rollout 尾部最多 512 KB 查找同 turn 的 `turn_context.approvals_reviewer`,写为 `approval`- 会话: `session_id`- 轮次: `turn_id`+- 子 Agent 标识: `agent_id`,字段存在时写为 `agent`,用于本机实时配对 `SubagentStart` / `SubagentStop`-事件名来自 payload 顶层 `hook_event_name`。没有 `--hook-event` 参数时按普通 App 启动;有 `--hook-event` 参数但 stdin 为空、不是 JSON 或事件名缺失时吞掉本次 Hook,避免 Hook 子进程继续启动完整菜单栏 App。事件时间优先读取 payload 顶层 `timestamp`,解析后按本机时区写成 `yyyy-MM-dd HH:mm:ss.SSS`;如果 `timestamp` 缺失或无法解析,记录当前时间作为兜底。同一个事件时间也会按本机时区格式化为 `yyyy-MM-dd` 的 date key,用于选择 `events/YYYY-MM-DD.jsonl` 文件。日期和时间解析统一走 `CodexDateFormat`,其中高频的 `yyyy-MM-dd` key 由本机 Gregorian 日历组件生成和校验,不暴露可变 `DateFormatter` 实例。每行按固定顺序写入 `timestamp`、`event`、`model`、`permission`、`approval`、`session`、`turn`、`tool`、`cwd`;缺少 reviewer 或当前 rollout 无法读取时写为 `null`。+事件名来自 payload 顶层 `hook_event_name`。没有 `--hook-event` 参数时按普通 App 启动;有 `--hook-event` 参数但 stdin 为空、不是 JSON 或事件名缺失时吞掉本次 Hook,避免 Hook 子进程继续启动完整菜单栏 App。事件时间优先读取 payload 顶层 `timestamp`,解析后按本机时区写成 `yyyy-MM-dd HH:mm:ss.SSS`;如果 `timestamp` 缺失或无法解析,记录当前时间作为兜底。同一个事件时间也会按本机时区格式化为 `yyyy-MM-dd` 的 date key,用于选择 `events/YYYY-MM-DD.jsonl` 文件。日期和时间解析统一走 `CodexDateFormat`,其中高频的 `yyyy-MM-dd` key 由本机 Gregorian 日历组件生成和校验,不暴露可变 `DateFormatter` 实例。每行按固定顺序写入 `timestamp`、`event`、`model`、`effort`、`permission`、`approval`、`session`、`turn`、`agent`、`tool`、`cwd`;缺少对应 Hook 字段或当前 rollout 无法读取时写为 `null`。旧版事件行缺少新增字段时仍可正常解码。事件名统计时会去掉 `_` 和 `-` 并转小写,因此 `PreToolUse`、`pre_tool_use`、`pre-tool-use` 会归为同一个事件。@@ -144,20 +146,22 @@ 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,之后每 1 秒按 byte offset 增量读取,保留半行并检测截断或替换。只解出顶层 `type`、`payload.type`、`payload.turn_id`、`started_at`、`completed_at`、`duration_ms` 和 `turn_context.approvals_reviewer`;不提取、保存或展示提示词、回复、推理、工具内容或审批内容。+- 初次从文件末尾最多读取 512 KB,之后每 1 秒按 byte offset 增量读取,保留半行并检测截断或替换。初始窗口未覆盖完整历史且活跃 turn 的 effort 仍缺失时,会在任务开始至少 2 秒后按精确 turn 从文件尾部最多 8 MB 一次性回查 `turn_context.effort`;每轮 lifecycle 查询最多回查一个 turn,读取失败至少间隔 10 秒重试,成功读取但未找到则不再回查。只解出顶层 `type`、`payload.type`、`payload.turn_id`、`started_at`、`completed_at`、`duration_ms`、`turn_context.approvals_reviewer` 和 `turn_context.effort`;不提取、保存或展示提示词、回复、推理内容、工具内容、审批内容或 token 数据。- `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 结果不会写入新状态。- `PermissionRequest` 只表示操作进入审批流程,不等同于 UI 正在等待用户。monitor 先把它保存为当前 turn 的等待候选;只有同一 turn 的 `turn_context.approvals_reviewer` 明确为 `user` 时才切换到等待批准。`auto_review`、兼容值 `guardian_subagent` 或 reviewer 缺失时保持运行状态,不发布等待 transition、通知或触觉反馈。- 单次 lifecycle 查询同时包含 reviewer 和 `task_complete` / `turn_aborted` 时,monitor 先保留 `task_started` 的起点回填,再优先处理终态并跳过审批候选确认,不为已经结束的任务发布等待 transition。+- lifecycle 查询读到 `turn_context.effort` 时会回填当前 turn 的推理强度;Hook 与 rollout 值一致时保持原值,缺失时沿用已有值,若同一 turn 出现冲突则标记为 `mixed`,不会静默覆盖。推理强度会随任务进入完成或终止记录。- `event_msg / turn_aborted` 移除对应任务,并在任务中心生成保留 10 分钟的灰色最近终止记录;优先使用 rollout 行时间,缺失时活跃任务使用检测时间、等待终态确认任务使用被新 Prompt 替代的时间,且都不猜测耗时。不生成完成记录、绿色状态、通知或触觉反馈。文件不存在、无法读取、格式变化或缺少精确 ID 时保留原 Hook 状态,最终仍由后续 prompt、Stop、Hook 关闭或 24 小时过期兜底。任务状态机规则:- 任务键优先使用 `session + turn`,缺少 turn 时使用 session;两者都缺少时按项目名归入匿名任务。匿名任务以及缺少起点的恢复任务不展示精确总耗时。- `UserPromptSubmit` 创建运行任务;同一 session 收到新 prompt 时,旧 turn 即使缺少 Stop 也视为已中断并从运行状态移除,但不生成完成记录、通知或触觉反馈。工具、上下文压缩和子智能体事件更新已有任务并解除等待,同时记录最近事件供活动卡片实时展示。工具和权限事件缺少起点时可以恢复顶层状态,子智能体事件不会单独创建顶层任务。+- `SubagentStart` / `SubagentStop` 的 `turn_id` 属于子 Agent 自己,不等于父任务 turn;子 Agent 活跃数通过共享 `session_id` 归属到该 session 下唯一的当前顶层任务。关联成功后,早于顶层任务可信开始时间的事件会被视为上一 turn 的迟到事件并忽略。monitor 以 `agent_id` 保存每个子 Agent 最新的开始/结束状态,重复事件幂等,旧时间戳不会覆盖新状态;遇到缺失 `agent_id`、同 session 存在多个活动或等待终态确认的顶层任务、无法关联任务,或没有已知开始状态的结束事件后,将当前任务标记为不可可靠统计并隐藏数量。数量可靠且大于 0 时才显示在主面板当前活动卡片,任务中心不显示;任务结束或新 turn 替换旧 turn 时随内存任务状态一并清除。Hook 整体缺失结束事件无法被主动识别,因此该值仍是基于完整 Hook 序列的最佳努力实时状态。- `PermissionRequest` 先成为审批候选;只有 rollout 已确认该 turn 的 `approvals_reviewer == user` 才进入等待批准,自动 reviewer 产生的同名 Hook 不改变运行状态。重复的用户等待事件不重复发布等待 transition。live 读取一次可能包含多个事件,monitor 会在整批应用后按任务键合并等待候选:最终仍在等待时使用最终快照发布一次,已经恢复运行、完成或移除时不发布过期等待 transition;完成候选保持事件顺序,并按 completion ID 防止同批重复发布。- Hook `Stop` 或 rollout `task_complete` 结束任务并产生最近完成记录,两者在进程内按精确任务键和 session 回退键去重,保留第一次确认的完成及精确耗时且不重复发布 transition。后到的重复完成不会覆盖首次确认结果,也不会缩短 24 小时去重窗口。期间迟到的工具、压缩或权限事件不会恢复已完成任务,只有时间晚于完成记录的新 `UserPromptSubmit` 可以开始下一段生命周期。rollout `turn_aborted` 会直接进入最近终止列表;同 session 新 prompt 淘汰的旧 turn 则立即退出活动列表并进入 5 秒终态确认窗口,期间继续参与 rollout 查询并优先接受 `task_complete`、`turn_aborted` 或迟到 Hook `Stop`,到期仍无终态才进入最近终止列表。“完成”只表示该 turn 已结束,不表示任务成功。- 精确 turn 匹配失败时,回退同 session 最近活动任务,再回退同项目匿名任务。-- UI 优先展示最近等待任务,其次最近运行任务、最近完成任务和最近终止任务,同时保留运行与等待数量。只有终止历史时,活动卡片使用灰色终止状态展示最近一项。运行卡片第一行组合项目与模型,第二行展示运行时间及最近的请求/工具/压缩/子智能体事件,其他任务数量以右侧 `+N` 徽标展示。菜单栏完成绿色保留 30 秒,任务中心的最近完成和最近终止记录保留 10 分钟,24 小时没有新事件的活动自动过期。+- UI 优先展示最近等待任务,其次最近运行任务、最近完成任务和最近终止任务,同时保留运行与等待数量。只有终止历史时,活动卡片使用灰色终止状态展示最近一项。活动卡片第一行按“模型 ` • ` 推理强度 ` • ` 项目”组合可用字段,第二行展示运行时间、可靠时的“`N 个子 Agent`”及最近的请求/工具/压缩/子智能体事件;其他任务数量以右侧 `+N` 徽标展示。任务中心在模型后使用 ` • ` 展示推理强度,但不展示子 Agent 数量。菜单栏完成绿色保留 30 秒,任务中心的最近完成和最近终止记录保留 10 分钟,24 小时没有新事件的活动自动过期。跨日时仍在内存中的运行任务会继续保留;重启 App 后由滚动 24 小时 bootstrap 恢复近期活动,并为更早开始的精确 turn 定向回填起点。任务会一直保留到收到 Hook `Stop` 或 rollout `task_complete`、检测到 `turn_aborted`、同 session 新 prompt 将其淘汰、Hook 被关闭或连续 24 小时没有新事件。完成高亮、最近完成、最近终止、完成去重键和活动过期共用按最近到期时刻创建的单次清理任务,不运行常驻清理计时器;读取完成键时还会惰性淘汰已经超过 24 小时的记录,避免系统休眠或计时任务稍晚唤醒时误拦第一条新事件。@@ -277,6 +281,8 @@ subagentStopCount, sessionCount, turnCount, projectCounts, modelCounts, sessionI不满足这两个条件的坏行在重建时会被跳过。其他字段缺失不会阻断统计,只会影响依赖该字段的去重或项目统计。+`effort` 用于本机实时任务展示,`agent` 用于子 Agent 关联;两者都不参与每日计数或 `daily.jsonl` schema,也不会进入 CloudKit 同步副本。`agent` 不直接展示给用户;原始值只随对应 Hook 行保存在本机事件文件中。+从 `events/YYYY-MM-DD.jsonl` 到页面指标的判定规则如下:| 页面展示名 | 会被计入的 `events/YYYY-MM-DD.jsonl` 行 | 不会计入的典型情况 | 计数方式 |diff --git a/Docs/DevelopmentGuide.md b/Docs/DevelopmentGuide.mdindex ad1a82e..bcd11d7 100644--- a/Docs/DevelopmentGuide.md+++ b/Docs/DevelopmentGuide.md@@ -36,7 +36,7 @@ App 通过本机 Codex app-server 读取账号, 额度和 token 用量, 通过 C两条主数据链路:- Codex app-server 链路: `CodexStatusService` 启动或复用本机 app-server, 生成 `CodexQuotaSnapshot`, 由 `CodexStatusViewModel` 发布给菜单栏 UI-- Codex Hook 链路: Codex 进程触发带 `--hook-event` 参数的 Hook 命令, CodexBar 从 stdin payload 读取 `hook_event_name` 并快速写入 JSONL; 主 App 一路维护聚合并生成 `WorkflowSnapshot`, 另一路通过 `CodexActivityMonitor` 只读 tail 原始事件并发布实时活动快照;活跃 turn 再由 `CodexSessionLifecycleReader` 从本机 rollout 补充起点、结束和中断信号+- Codex Hook 链路: Codex 进程触发带 `--hook-event` 参数的 Hook 命令, CodexBar 从 stdin payload 读取 `hook_event_name` 并快速写入 JSONL; 主 App 一路维护聚合并生成 `WorkflowSnapshot`, 另一路通过 `CodexActivityMonitor` 只读 tail 原始事件并发布实时活动快照;活跃 turn 再由 `CodexSessionLifecycleReader` 从本机 rollout 补充起点、终态、审批路由和推理强度## 3. 启动流程@@ -428,16 +428,16 @@ app-server 与状态刷新错误:日志错误处理:-| 场景 | 行为 |-| ------------------------ | ------------------------------------------------------------- |-| 请求发送后等待响应 | 日志先显示"进行" |-| 收到正常响应 | 回填同一条日志为"完成" |-| 请求失败或响应解析失败 | 回填同一条日志为"错误" |-| `initialized` 无 id 通知 | 记录为"请求", 不等待响应 |-| 进程级错误没有 method | 日志行直接预览错误文本 |-| 响应或 JSON 错误详情 | 重新序列化为稳定顺序并保留未转义斜杠 |-| 请求 payload | 直接保存已稳定序列化的完整内容, UI 行内只渲染单行短预览 |-| 响应或错误详情 | 存完整内容, 通过预览视图查看或复制 |+| 场景 | 行为 |+| ------------------------ | ------------------------------------------------------- |+| 请求发送后等待响应 | 日志先显示"进行" |+| 收到正常响应 | 回填同一条日志为"完成" |+| 请求失败或响应解析失败 | 回填同一条日志为"错误" |+| `initialized` 无 id 通知 | 记录为"请求", 不等待响应 |+| 进程级错误没有 method | 日志行直接预览错误文本 |+| 响应或 JSON 错误详情 | 重新序列化为稳定顺序并保留未转义斜杠 |+| 请求 payload | 直接保存已稳定序列化的完整内容, UI 行内只渲染单行短预览 |+| 响应或错误详情 | 存完整内容, 通过预览视图查看或复制 |设置, Hook 和更新错误:@@ -798,9 +798,10 @@ sequenceDiagram| `tool_name` | `tool` || `model` | `model` || `permission_mode` | `permission` |-| `transcript_path` | `approval`;仅提取匹配 turn 的 reviewer |+| `transcript_path` | `approval`、`effort`;仅提取匹配 turn 的上下文 || `session_id` | `session` || `turn_id` | `turn` |+| `agent_id` | `agent` |`hook_event_name` 是 Hook 事件来源。如果 stdin 有输入但缺失事件名, 记录器会吞掉本次 Hook, 避免 Hook 子进程启动完整菜单栏 App。@@ -808,7 +809,7 @@ sequenceDiagram- `timestamp` 缺失或无法解析时使用当前时间- `cwd` 缺失时使用当前工作目录-- `transcript_path` 缺失、无法读取、512 KB 内找不到匹配 `turn_context` 或 reviewer 未知时,`approval` 写为 `null`;主 App 仍会通过增量 rollout reader 尝试补齐,未补齐前不判定为用户等待+- `transcript_path` 缺失、无法读取或 512 KB 内找不到匹配 `turn_context` 时,`approval` 和 `effort` 写为 `null`;reviewer 未知时 `approval` 写为 `null`。主 App 仍会通过 rollout reader 尝试补齐,未补齐 reviewer 前不判定为用户等待- 其他字段缺失写为 `null`Hook 数据目录:@@ -1097,7 +1098,7 @@ App 再次成为 active 时, 也会刷新 Codex 版本区、同步可用性, 并- 不把原始敏感 RPC 响应写入文档或测试夹具- 日志完整保存 request/detail, UI 默认只渲染单行预览; 完整内容通过标题行预览或复制查看- Hook 统计默认只保存在用户 Application Support 的 CodexBar 目录;开启「跨设备同步」后, CloudKit 只保存去掉 `sessionIds` / `turnIds` 的 daily 聚合副本, 不保存原始 Hook events-- 实时任务状态只保存在 `CodexActivityMonitor` 内存中,UI 只展示项目最后一级名称、模型、工具名与最近 Hook 事件类型;运行卡片第一行组合项目和模型,第二行组合运行时间与请求/工具/压缩/子智能体状态,其他任务数使用右侧 `+N` 徽标。并发任务中心消费同一快照中的完整等待、运行、最近完成和最近终止列表,列表身份使用进程内 UUID,不展示或持久化 session/turn ID。不写历史文件、不上传 CloudKit,也不新增网络请求。`CodexSessionLifecycleReader` 只对活跃 session + turn 增量读取本机 rollout,提取事件类型、turn ID、起止时间、耗时和审批 reviewer,不提取、保存或展示提示词、回复、推理、工具内容或审批内容+- 实时任务状态只保存在 `CodexActivityMonitor` 内存中,UI 只展示项目最后一级名称、模型、推理强度、工具名与最近 Hook 事件类型;活动卡片第一行以 `•` 组合模型、推理强度和项目,第二行组合运行时间、可靠且大于 0 的活跃子 Agent 数量与请求/工具/压缩/子智能体状态,其他任务数使用右侧 `+N` 徽标。并发任务中心消费同一快照中的完整等待、运行、最近完成和最近终止列表,在模型后以 `•` 展示推理强度,但不展示子 Agent 数量;列表身份使用进程内 UUID,不展示或持久化 session/turn/agent ID。不写历史文件、不上传 CloudKit,也不新增网络请求。`CodexSessionLifecycleReader` 只对活跃 session + turn 读取本机 rollout,提取事件类型、turn ID、起止时间、耗时、审批 reviewer 和推理强度;不提取、保存或展示提示词、回复、推理内容、工具内容、审批内容或 token 数据## 19. 通知与触觉提醒链路@@ -1107,9 +1108,9 @@ App 再次成为 active 时, 也会刷新 Codex 版本区、同步可用性, 并- `CodexNotificationService`: 集中判定、去重、调度与发送; 由 `CodexBarAppDelegate` 创建, 订阅 `CodexStatusViewModel.$snapshot`、`CodexActivityMonitor` live transition 与 `NSWorkspace.didWakeNotification`; 五类正式通知共用 `CodexNotificationContent` 文案工厂,系统提交失败时重试一次,等待与完成 transition 还会按偏好请求 AppKit `.levelChange` 触觉反馈- `CodexActivityMonitor`: Hook 开启期间始终运行并维护并发任务;向 UI 发布快照,向提醒服务发布 live transition。`PermissionRequest` 先作为审批候选,只有同 turn 的 rollout reviewer 为 `user` 才确认等待;自动 reviewer 或未知 reviewer 保持运行。单个 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,之后每 1 秒按 offset 增量读取;`task_started` 回填缺失起点,`task_complete` 补齐结束和精确耗时,`turn_aborted` 由 monitor 移除任务并生成灰色最近终止记录,`turn_context.approvals_reviewer` 用于确认 `PermissionRequest` 是否真的路由给用户,读取失败时不把候选误判为等待。同次查询同时包含 reviewer 和终态时,monitor 保留起点回填后优先处理终态并跳过审批候选确认。轮询和即时 lifecycle 查询都绑定 reader generation,跨 actor 返回后仍会复核,旧查询不能落入新 reader 状态+- `CodexSessionLifecycleReader`: 后台 actor,只为 monitor 当前活动或等待终态确认的精确 session + turn 定位对应 rollout;便宜目录每 10 秒重试,每个活跃生命周期最多递归 `sessions` 一次并保留负缓存,缓存文件移动、session 重新活跃或 Mac 唤醒时重置。rollout 初次最多读取末尾 512 KB,之后每 1 秒按 offset 增量读取;活跃 turn 的 effort 仍缺失且初始窗口未覆盖完整历史时,在任务开始至少 2 秒后从文件尾部最多 8 MB 定向回查,每轮查询最多处理一个 turn,失败至少间隔 10 秒重试。`task_started` 回填缺失起点,`task_complete` 补齐结束和精确耗时,`turn_aborted` 由 monitor 移除任务并生成灰色最近终止记录,`turn_context.approvals_reviewer` 用于确认 `PermissionRequest` 是否真的路由给用户,`turn_context.effort` 用于回填推理强度。读取失败时不把审批候选误判为等待,也不猜测 effort。同次查询同时包含 reviewer 和终态时,monitor 保留起点回填后优先处理终态并跳过审批候选确认。轮询和即时 lifecycle 查询都绑定 reader generation,跨 actor 返回后仍会复核,旧查询不能落入新 reader 状态-活动并发以 session 为边界:不同 session 可以同时运行;同一 session 的 turn 按顺序执行。收到新的 `UserPromptSubmit` 时,monitor 会让该 session 中更早且缺少结束信号的 turn 立即退出活动列表,但保留为等待终态确认任务并触发一次即时 rollout 查询;5 秒内收到 Hook `Stop`、rollout `task_complete` 或 `turn_aborted` 时按真实终态归类,到期仍无终态才生成灰色最近终止记录。已完成和已终止任务键分别保留 24 小时 tombstone,避免迟到事件恢复旧任务或误操作同 session 的新 turn。终止不会触发绿色完成状态、长任务通知或完成触觉反馈。Hook `Stop` 与 rollout `task_complete` 均视为完成信号,先到者生效,后到者按任务键和 session 回退键去重;重复完成不会覆盖首次确认结果,也不会缩短去重窗口或再次触发反馈。+活动并发以 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 回退键去重;重复完成不会覆盖首次确认结果,也不会缩短去重窗口或再次触发反馈。设置页交互: 「系统通知」主开关行保留在设置窗口内, 子选项 (五类通知子开关、任务触觉开关与两个阈值 Picker) 在主选项右侧的子面板中展开 (`NotificationOptionsPanelController`, 复用 SidePanelSupport 抽屉机制挂在设置窗口上, 内容用常驻 hosting controller + ObservableObject 驱动, 面板尺寸在 Hook 开/关两种状态下保持不变)。「任务等待通知」和「任务触觉反馈」依次排列在「任务完成通知」下方。主开关开启后仅在系统授权允许时展开, 首次授权场景会等待授权结果; 点击行内滑杆按钮可手动展开; 设置窗口 resign key/关闭、主开关关闭或授权变为被拒时自动收起。任务完成、任务等待与任务触觉子项在 Hook 未开启时显示为关闭并置灰, 不修改各自持久化偏好, Hook 重新开启后恢复用户原选择。授权被拒的引导文案与"打开系统设置"按钮仍内联显示在主开关行下方, 插入提示时不触发设置项纵向动画。diff --git a/README.md b/README.mdindex 6713435..114eb95 100644--- a/README.md+++ b/README.md@@ -18,7 +18,7 @@ Codex 的额度、Token 用量和使用情况通常分散在终端、App 或 Ses- 跟踪不同时间窗口的额度剩余比例和下一次重置时间- 用 30 周热力图回顾每日 Token 用量- 在开启 Codex Hook 后在 30 周热力图中可查看当天最热模型,以及会话、对话轮次、调用工具、权限请求、上下文压缩和子智能体统计 (仅在开启后可记录查看,无法查看到历史数据)-- 通过菜单栏状态点、活动卡片和并发任务中心实时查看 Codex 正在运行、等待批准及刚完成的任务+- 通过菜单栏状态点、活动卡片和并发任务中心实时查看 Codex 正在运行、等待批准及刚完成的任务,并展示当前推理强度;可可靠统计且存在活跃子 Agent 时,活动卡片还会显示其数量- 通过可选 iCloud 私有数据库同步实现跨设备数据合并- 额度告急、额度恢复、任务等待批准、长任务完成时收到系统通知(可选开启)- 任务等待批准或结束时通过支持的触控板获得触觉反馈(可选开启)@@ -41,7 +41,7 @@ CodexBar 是一个无 Dock 图标的 macOS 菜单栏应用。开启 Codex Hook 后,菜单栏小人右下角的状态点会反映实时任务状态:运行中为蓝色、等待批准为橙色、刚完成为绿色,暂无活动时不显示。主面板额度快照不可用时也不显示状态点,与活动卡片的「暂无数据」状态保持一致。状态优先级依次为等待批准、运行中、刚完成和暂无活动;小人保持系统前景色,账号异常仍使用带叉图标表示,额度竖条也保持自己的颜色。-菜单面板账号卡片下方会固定显示活动卡片,汇总当前项目、模型、工具、耗时和其他并发任务数量。主面板快照不可用时,活动卡片显示「暂无数据」且不开放任务中心;快照可用并存在活动任务、最近完成或最近终止记录时,点击卡片会打开并发任务中心,按等待确认、运行中、最近完成和最近终止分组展示全部任务。只有终止历史时,卡片显示最近一项灰色终止状态。面板优先在菜单右侧展开,空间不足时自动切换到左侧,并优先与活动卡片顶边对齐;暂时无法取得有效位置时会等待布局更新后重试,仍然失败才在主面板旁垂直居中。绿色完成状态保留 30 秒,最近完成和最近终止记录保留 10 分钟;终止记录不触发完成提醒。+菜单面板账号卡片下方会固定显示活动卡片,汇总当前项目、模型、推理强度、工具、耗时和其他并发任务数量;可可靠统计且存在活跃子 Agent 时还会显示其数量。模型、推理强度与项目等同一行信息统一使用 ` • ` 连接。主面板快照不可用时,活动卡片显示「暂无数据」且不开放任务中心;快照可用并存在活动任务、最近完成或最近终止记录时,点击卡片会打开并发任务中心,按等待确认、运行中、最近完成和最近终止分组展示全部任务,其中模型后的推理强度同样使用 ` • ` 连接。只有终止历史时,卡片显示最近一项灰色终止状态。面板优先在菜单右侧展开,空间不足时自动切换到左侧,并优先与活动卡片顶边对齐;暂时无法取得有效位置时会等待布局更新后重试,仍然失败才在主面板旁垂直居中。绿色完成状态保留 30 秒,最近完成和最近终止记录保留 10 分钟;终止记录不触发完成提醒。### 额度与重置时间一眼可见@@ -61,7 +61,7 @@ CodexBar 是一个无 Dock 图标的 macOS 菜单栏应用。统计结果会汇总到热力图详情面板中,不打断正常的 Codex 使用流程。-主 App 还会在后台只读 Hook JSONL:启动时按块恢复最近 24 小时的活动,之后 tail 当天新增事件,并在内存中维护并发任务状态。跨日任务缺少起点时会按精确 session + turn 定向查找更早的 Prompt;对于仍处于运行、等待终态确认或等待批准状态的精确 turn,CodexBar 会每秒增量读取对应本机 Codex session rollout,用 `task_started` 回填缺失起点、用 `task_complete` 补齐缺失的结束、用 `turn_aborted` 清理中断任务并生成最近终止记录,并用 `turn_context.approvals_reviewer` 区分用户审批和自动审批。只有 reviewer 明确为 `user` 且同时收到 `PermissionRequest` 时才显示等待批准;`auto_review` 不会触发等待状态或提醒。同 session 新 Prompt 会让旧 turn 立即退出活动列表,但先保留 5 秒终态确认窗口,优先接受 rollout 或迟到 Hook 的完成/终止信号,仍无终态才记为终止。不读取提示词、回复、推理、工具内容或审批内容。该实时状态用于菜单栏状态点、活动卡片、并发任务中心、可选任务通知和触觉反馈,不新增历史状态文件,也不参与跨设备同步。+主 App 还会在后台只读 Hook JSONL:启动时按块恢复最近 24 小时的活动,之后 tail 当天新增事件,并在内存中维护并发任务状态。跨日任务缺少起点时会按精确 session + turn 定向查找更早的 Prompt;对于仍处于运行、等待终态确认或等待批准状态的精确 turn,CodexBar 会每秒增量读取对应本机 Codex session rollout,用 `task_started` 回填缺失起点、用 `task_complete` 补齐缺失的结束、用 `turn_aborted` 清理中断任务并生成最近终止记录,用 `turn_context.approvals_reviewer` 区分用户审批和自动审批,并用 `turn_context.effort` 补齐当前 turn 的推理强度;初始 512 KB 未找到 effort 时,主 App 会按精确 turn 从文件尾部最多 8 MB 执行一次受限回查。只有 reviewer 明确为 `user` 且同时收到 `PermissionRequest` 时才显示等待批准;`auto_review` 不会触发等待状态或提醒。Subagent Hook 带有稳定 `agent_id` 时,CodexBar 会通过共享 session 将子 Agent 归属到唯一的当前顶层任务,并在内存中幂等配对开始和结束事件,统计当前活跃数量;早于当前顶层任务可信开始时间的事件会被视为上一 turn 的迟到事件并忽略,字段缺失、同 session 无法唯一关联顶层任务或事件序列不完整时则隐藏数量,避免展示不可靠结果。同 session 新 Prompt 会让旧 turn 立即退出活动列表,但先保留 5 秒终态确认窗口,优先接受 rollout 或迟到 Hook 的完成/终止信号,仍无终态才记为终止。不读取提示词、回复、推理内容、工具内容、审批内容或 token 数据。该实时状态用于菜单栏状态点、活动卡片、并发任务中心、可选任务通知和触觉反馈,不新增历史状态文件,也不参与跨设备同步。CodexBar 只会追加或移除属于当前 CodexBar 可执行文件的 Hook,不会删除用户已有的其他 Codex Hook。@@ -135,7 +135,7 @@ Codex Hook 工作流数据默认只保存在本机:~/Library/Application Support/CodexBar/HookEvents/```-菜单栏实时任务状态只存在于当前 App 进程内。活动卡片和并发任务中心只展示工作目录最后一级项目名、模型、工具、阶段与耗时,不展示完整路径、会话 ID 或轮次 ID;这份状态不会上传到 CloudKit,也不会产生新的网络请求。为补齐 Hook 缺失的起点、结束或中断信号,CodexBar 只对当前活跃 turn 增量读取 `~/.codex/sessions/` 或 `~/.codex/archived_sessions/` 下对应 rollout JSONL,解析生命周期事件、turn ID 和起止耗时;不会提取、保存或展示其中的提示词、回复、推理和工具内容。+菜单栏实时任务状态只存在于当前 App 进程内。活动卡片和并发任务中心只展示工作目录最后一级项目名、模型、推理强度、工具、阶段与耗时;可可靠统计且存在活跃子 Agent 时,活动卡片还会显示其数量。不展示完整路径、会话 ID、轮次 ID 或 agent ID。这份状态不会上传到 CloudKit,也不会产生新的网络请求。为补齐 Hook 缺失的起点、结束、中断、审批路由或推理强度,CodexBar 只对当前活跃 turn 读取 `~/.codex/sessions/` 或 `~/.codex/archived_sessions/` 下对应 rollout JSONL:正常情况下只增量解析生命周期事件、turn ID、起止耗时、`turn_context.approvals_reviewer` 和 `turn_context.effort`,effort 缺失时最多额外读取文件尾部 8 MB;不会提取、保存或展示其中的提示词、回复、推理内容、工具内容或 token 数据。只有在用户开启「跨设备同步」后,CodexBar 才会通过 `CloudKit private database` 同步每日使用详情数据; 同步的数据副本只包含各个事件数量、项目聚合和模型名使用次数,不包含事件具体的数据。diff --git a/appcast.xml b/appcast.xmlindex 5f37196..0c893fb 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.8</title>+ <sparkle:version>46</sparkle:version>+ <sparkle:shortVersionString>3.3.8</sparkle:shortVersionString>+ <sparkle:minimumSystemVersion>15.0</sparkle:minimumSystemVersion>+ <sparkle:releaseNotesLink>https://codexbar.zabrian.app/notes#3.3.8</sparkle:releaseNotesLink>+ <pubDate>Fri, 17 Jul 2026 11:31:35 +0800</pubDate>+ <enclosure url="https://codexbar.zabrian.app/download/CodexBar-v3.3.8.dmg" sparkle:edSignature="UiA7DCQmrW4eBptwdwLnWkaurM65YtzJQrn075sw4KvwwZWWmS+3N9ylXiKMdwAQJjvSzAFktjRVFFjDpsLkAQ==" length="4033885" type="application/octet-stream"/>+ </item><item><title>CodexBar.app 3.3.7</title><sparkle:version>45</sparkle:version>