Skip to content

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

feat: 展示任务推理强度与子 Agent 数量

Bob1dcb58169eb8
diff --git a/CodexBar.xcodeproj/project.pbxproj b/CodexBar.xcodeproj/project.pbxproj
index 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.swift
index 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.swift
index 1a7080d..21250f5 100644
--- a/CodexBar/Models/CodexActivityModels.swift
+++ b/CodexBar/Models/CodexActivityModels.swift
@@ -30,10 +30,13 @@ nonisolated struct CodexActivityTaskSnapshot: Equatable, Identifiable {
let latestEvent: CodexActivityEvent
let projectName: String?
let modelName: String?
+ let effort: String?
let toolName: String?
let startedAt: Date?
let stateChangedAt: Date
let showsPreciseDuration: Bool
+ /// nil 表示 Hook 字段不足,无法可靠统计;0 表示已确认当前没有活跃子 Agent。
+ let activeSubagentCount: Int?
}
/// 最近确认结束的任务。完成只表示一轮任务结束,不代表执行成功。
@@ -41,6 +44,7 @@ nonisolated struct CodexActivityCompletion: Equatable, Identifiable {
let id: UUID
let projectName: String?
let modelName: String?
+ let effort: String?
let completedAt: Date
let duration: TimeInterval?
}
@@ -50,6 +54,7 @@ nonisolated struct CodexActivityTermination: Equatable, Identifiable {
let id: UUID
let projectName: String?
let modelName: String?
+ let effort: String?
let terminatedAt: Date
let 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.swift
index 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 = timestamp
self.name = name
self.directoryPath = directoryPath
self.toolName = toolName
self.modelName = modelName
+ self.effort = effort
self.permissionMode = permissionMode
self.approvalReviewer = approvalReviewer
self.sessionId = sessionId
self.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 cwd
case toolName = "tool"
case modelName = "model"
+ case effort
case 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.swift
index 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: CodexActivityEvent
var projectName: String?
var modelName: String?
+ var effort: String?
var toolName: String?
var startedAt: Date?
var stateChangedAt: Date
var lastActivityAt: Date
var approvalReviewer: CodexApprovalReviewer?
var pendingApprovalRequestedAt: Date?
+ var subagentsByID: [String: CodexSubagentObservation]
+ var isSubagentCountReliable: Bool
init(
displayID: UUID,
@@ -1013,12 +1100,15 @@ private struct CodexActivityTask {
self.latestEvent = latestEvent
projectName = event.projectDisplayName
modelName = event.modelName
+ effort = Self.normalizedEffort(event.effort)
toolName = event.toolName
self.startedAt = startedAt
stateChangedAt = event.timestamp
lastActivityAt = event.timestamp
approvalReviewer = event.approvalReviewer
pendingApprovalRequestedAt = 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 ?? projectName
modelName = event.modelName ?? modelName
+ _ = mergeEffort(event.effort)
toolName = event.toolName ?? toolName
approvalReviewer = 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.swift
index 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] = cursor
for 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 = 10
private static let fileResolutionRetryInterval: TimeInterval = 10
}
@@ -227,6 +347,15 @@ private nonisolated struct SessionFileCursor {
var offset: UInt64
var discardsLeadingPartialLine: Bool
var 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 ?? effort
case let .completed(at, duration):
terminal = .completed(at: at, duration: duration)
case let .aborted(at):
@@ -347,6 +494,7 @@ nonisolated struct CodexSessionTaskLifecycleState {
let turnId: String
let startedAt: Date?
let approvalReviewer: CodexApprovalReviewer?
+ let effort: String?
let terminal: CodexSessionTaskTerminalState?
}
diff --git a/CodexBar/Services/Workflow/WorkflowHookEventRecorder.swift b/CodexBar/Services/Workflow/WorkflowHookEventRecorder.swift
index 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) : data
for 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.swift
index 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.swift
index 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.md
index 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.md
index 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.md
index 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.xml
index 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>