CodexBar 是一个 macOS 菜单栏应用,用于查看本机 Codex 账号状态、额度、Token 用量、详细统计信息
Swift appkitcodexcodex-clideveloper-toolsmacosmacos-appmenu-bar-appopenai-codexproductivityswiftswiftuiusage-tracker
fix: 修正自动审批任务等待状态
Bob55bc5a4417be
diff --git a/CodexBar.xcodeproj/project.pbxproj b/CodexBar.xcodeproj/project.pbxprojindex fc769fc..7ff61d0 100644--- a/CodexBar.xcodeproj/project.pbxproj+++ b/CodexBar.xcodeproj/project.pbxproj@@ -282,7 +282,7 @@"CODE_SIGN_IDENTITY[sdk=macosx*]" = "Apple Development";CODE_SIGN_STYLE = Automatic;COMBINE_HIDPI_IMAGES = YES;- CURRENT_PROJECT_VERSION = 43;+ CURRENT_PROJECT_VERSION = 44;DEAD_CODE_STRIPPING = YES;DEVELOPMENT_TEAM = 4KJ362VJW5;ENABLE_APP_INTENTS_METADATA_GENERATION = NO;@@ -298,7 +298,7 @@"$(inherited)","@executable_path/../Frameworks",);- MARKETING_VERSION = 3.3.5;+ MARKETING_VERSION = 3.3.6;PRODUCT_BUNDLE_IDENTIFIER = app.zabrian.codexbar;PRODUCT_NAME = "$(TARGET_NAME)";REGISTER_APP_GROUPS = YES;@@ -321,7 +321,7 @@"CODE_SIGN_IDENTITY[sdk=macosx*]" = "Apple Development";CODE_SIGN_STYLE = Automatic;COMBINE_HIDPI_IMAGES = YES;- CURRENT_PROJECT_VERSION = 43;+ CURRENT_PROJECT_VERSION = 44;DEAD_CODE_STRIPPING = YES;DEVELOPMENT_TEAM = 4KJ362VJW5;ENABLE_APP_INTENTS_METADATA_GENERATION = NO;@@ -337,7 +337,7 @@"$(inherited)","@executable_path/../Frameworks",);- MARKETING_VERSION = 3.3.5;+ MARKETING_VERSION = 3.3.6;PRODUCT_BUNDLE_IDENTIFIER = app.zabrian.codexbar;PRODUCT_NAME = "$(TARGET_NAME)";PROVISIONING_PROFILE_SPECIFIER = "";diff --git a/CodexBar/Models/CodexActivityModels.swift b/CodexBar/Models/CodexActivityModels.swiftindex 4c8b4a8..855e94a 100644--- a/CodexBar/Models/CodexActivityModels.swift+++ b/CodexBar/Models/CodexActivityModels.swift@@ -1,7 +1,7 @@import Foundation/// 活跃任务最近收到的 Hook 事件,供活动卡片展示当前执行阶段。-nonisolated enum CodexActivityEvent: Equatable, Sendable {+nonisolated enum CodexActivityEvent: Equatable {case promptSubmittedcase toolStartedcase toolFinished@@ -13,13 +13,13 @@ nonisolated enum CodexActivityEvent: Equatable, Sendable {}/// bootstrap 后需要向更早日期定向查找 Prompt 起点的精确任务引用。-nonisolated struct CodexActivityPromptReference: Hashable, Sendable {+nonisolated struct CodexActivityPromptReference: Hashable {let sessionId: Stringlet turnId: String}/// 正在运行或等待批准的任务摘要,不对 UI 暴露原始会话 ID。-nonisolated struct CodexActivityTaskSnapshot: Equatable, Identifiable, Sendable {+nonisolated struct CodexActivityTaskSnapshot: Equatable, Identifiable {let id: UUIDlet latestEvent: CodexActivityEventlet projectName: String?@@ -31,7 +31,7 @@ nonisolated struct CodexActivityTaskSnapshot: Equatable, Identifiable, Sendable}/// 最近确认结束的任务。完成只表示一轮任务结束,不代表执行成功。-nonisolated struct CodexActivityCompletion: Equatable, Identifiable, Sendable {+nonisolated struct CodexActivityCompletion: Equatable, Identifiable {let id: UUIDlet projectName: String?let modelName: String?@@ -40,7 +40,7 @@ nonisolated struct CodexActivityCompletion: Equatable, Identifiable, Sendable {}/// 最近确认终止的任务。终止不会被视为完成,也不会触发完成提醒。-nonisolated struct CodexActivityTermination: Equatable, Identifiable, Sendable {+nonisolated struct CodexActivityTermination: Equatable, Identifiable {let id: UUIDlet projectName: String?let modelName: String?@@ -49,7 +49,7 @@ nonisolated struct CodexActivityTermination: Equatable, Identifiable, Sendable {}/// UI 只消费该快照,不直接读取或解释 Hook 事件。-nonisolated struct CodexActivitySnapshot: Equatable, Sendable {+nonisolated struct CodexActivitySnapshot: Equatable {let waitingTasks: [CodexActivityTaskSnapshot]let runningTasks: [CodexActivityTaskSnapshot]let recentCompletions: [CodexActivityCompletion]@@ -119,7 +119,7 @@ nonisolated struct CodexActivitySnapshot: Equatable, Sendable {}/// 快照归一后的主活动状态,highlighted 表示完成仍处于高亮时间窗内。-nonisolated enum CodexPrimaryActivity: Equatable, Sendable {+nonisolated enum CodexPrimaryActivity: Equatable {case waiting(CodexActivityTaskSnapshot)case running(CodexActivityTaskSnapshot)case completed(CodexActivityCompletion, highlighted: Bool)@@ -128,7 +128,7 @@ nonisolated enum CodexPrimaryActivity: Equatable, Sendable {}/// 只有 live Hook 或 session 生命周期会发布 transition,bootstrap 永远不会触发历史通知。-nonisolated enum CodexActivityTransition: Equatable, Sendable {+nonisolated enum CodexActivityTransition: Equatable {case waitingApproval(CodexActivityTaskSnapshot)case completed(CodexActivityCompletion)}diff --git a/CodexBar/Models/CodexHookEvent.swift b/CodexBar/Models/CodexHookEvent.swiftindex 3149edc..0968904 100644--- a/CodexBar/Models/CodexHookEvent.swift+++ b/CodexBar/Models/CodexHookEvent.swift@@ -40,3 +40,10 @@ nonisolated enum CodexHookEvent: String, CaseIterable {.lowercased()}}++/// Codex turn 的审批路由;只有 user 表示 PermissionRequest 会停在用户 UI。+nonisolated enum CodexApprovalReviewer: String, Codable {+ case user+ case autoReview = "auto_review"+ case guardianSubagent = "guardian_subagent"+}diff --git a/CodexBar/Models/CodexWorkflowModels.swift b/CodexBar/Models/CodexWorkflowModels.swiftindex c9e7233..486f418 100644--- a/CodexBar/Models/CodexWorkflowModels.swift+++ b/CodexBar/Models/CodexWorkflowModels.swift@@ -32,13 +32,14 @@ private nonisolated enum WorkflowJSON {}/// hooks 进程落盘的最小事件模型, 对历史字段缺失保持宽容-nonisolated struct WorkflowHookEvent: Decodable, Equatable, Sendable {+nonisolated struct WorkflowHookEvent: Decodable, Equatable {let timestamp: Datelet name: Stringlet directoryPath: String?let toolName: String?let modelName: String?let permissionMode: String?+ let approvalReviewer: CodexApprovalReviewer?let sessionId: String?let turnId: String?@@ -49,6 +50,7 @@ nonisolated struct WorkflowHookEvent: Decodable, Equatable, Sendable {toolName: String?,modelName: String?,permissionMode: String?,+ approvalReviewer: CodexApprovalReviewer?,sessionId: String?,turnId: String?) {@@ -58,6 +60,7 @@ nonisolated struct WorkflowHookEvent: Decodable, Equatable, Sendable {self.toolName = toolNameself.modelName = modelNameself.permissionMode = permissionMode+ self.approvalReviewer = approvalReviewerself.sessionId = sessionIdself.turnId = turnId}@@ -82,6 +85,10 @@ nonisolated struct WorkflowHookEvent: Decodable, Equatable, Sendable {toolName = Self.string(from: container, key: .toolName)modelName = Self.string(from: container, key: .modelName)permissionMode = Self.string(from: container, key: .permissionMode)+ approvalReviewer = try? container.decode(+ CodexApprovalReviewer.self,+ forKey: .approvalReviewer+ )sessionId = Self.string(from: container, key: .sessionId)turnId = Self.string(from: container, key: .turnId)}@@ -122,6 +129,7 @@ nonisolated struct WorkflowHookEvent: Decodable, Equatable, Sendable {WorkflowJSON.field("event", name),WorkflowJSON.field("model", modelName),WorkflowJSON.field("permission", permissionMode),+ WorkflowJSON.field("approval", approvalReviewer),WorkflowJSON.field("session", sessionId),WorkflowJSON.field("turn", turnId),WorkflowJSON.field("tool", toolName),@@ -138,6 +146,7 @@ nonisolated struct WorkflowHookEvent: Decodable, Equatable, Sendable {case toolName = "tool"case modelName = "model"case permissionMode = "permission"+ case approvalReviewer = "approval"case sessionId = "session"case turnId = "turn"}diff --git a/CodexBar/Services/Workflow/CodexActivityMonitor.swift b/CodexBar/Services/Workflow/CodexActivityMonitor.swiftindex 2b8c500..c81a227 100644--- a/CodexBar/Services/Workflow/CodexActivityMonitor.swift+++ b/CodexBar/Services/Workflow/CodexActivityMonitor.swift@@ -215,28 +215,46 @@ final class CodexActivityMonitor: ObservableObject {continue}+ var taskDidChange = falseif let startedAt = Self.backfilledStartedAt(for: task, state: state) {task.startedAt = startedAt- tasks[key] = task- didChange = true+ taskDidChange = true}- guard let terminal = state.terminal else {+ if let terminal = state.terminal {+ tasks.removeValue(forKey: key)+ didChange = true+ if case .completed = terminal, recentCompletionDate(for: key) != nil {+ // 迟到事件恢复出的任务不能被 rollout 再次完成。+ continue+ }+ resolveTerminal(+ terminal,+ task: task,+ key: key,+ abortFallback: Date(),+ into: &transitions+ )continue}- tasks.removeValue(forKey: key)- didChange = true- if case .completed = terminal, recentCompletionDate(for: key) != nil {- // 迟到事件恢复出的任务不能被 rollout 再次完成。- continue++ if let approvalReviewer = state.approvalReviewer,+ task.approvalReviewer != approvalReviewer {+ task.approvalReviewer = approvalReviewer+ taskDidChange = true}- resolveTerminal(- terminal,- task: task,- key: key,- abortFallback: Date(),++ if resolvePendingApprovalIfPossible(+ for: &task,into: &transitions- )+ ) {+ taskDidChange = true+ }++ if taskDidChange {+ tasks[key] = task+ didChange = true+ }}if didChange {@@ -426,6 +444,7 @@ final class CodexActivityMonitor: ObservableObject {task.state = .runningtask.stateChangedAt = event.timestamp}+ task.pendingApprovalRequestedAt = niltask.latestEvent = latestEventtask.mergeMetadata(from: event)task.lastActivityAt = event.timestamp@@ -460,30 +479,26 @@ final class CodexActivityMonitor: ObservableObject {return nil}- let wasWaiting = task.state == .waitingApproval- if !wasWaiting {- task.state = .waitingApproval- task.stateChangedAt = event.timestamp- }- task.latestEvent = .approvalRequestedtask.mergeMetadata(from: event)// 权限事件描述当前请求;缺失工具名时不能沿用上一条工具事件。task.toolName = event.toolNametask.lastActivityAt = event.timestamp+ let enteredWaiting = task.recordApprovalRequest(at: event.timestamp)tasks[key] = task- return wasWaiting ? nil : .waitingApproval(key)+ return enteredWaiting ? .waitingApproval(key) : nil}- let task = CodexActivityTask(+ var task = CodexActivityTask(displayID: UUID(),key: eventKey,event: event,- state: .waitingApproval,- latestEvent: .approvalRequested,+ state: .running,+ latestEvent: .toolStarted,startedAt: nil)+ let enteredWaiting = task.recordApprovalRequest(at: event.timestamp)tasks[eventKey] = task- return .waitingApproval(eventKey)+ return enteredWaiting ? .waitingApproval(eventKey) : nil}private func completeTask(from event: WorkflowHookEvent) -> CodexActivityLiveTransition? {@@ -687,6 +702,31 @@ final class CodexActivityMonitor: ObservableObject {}private extension CodexActivityMonitor {+ /// PermissionRequest 表示进入审批流程;只有 rollout 明确把审批路由给 user 时才是 UI 等待。+ func resolvePendingApprovalIfPossible(+ for task: inout CodexActivityTask,+ into transitions: inout [CodexActivityTransition]+ ) -> Bool {+ guard let requestedAt = task.pendingApprovalRequestedAt,+ let approvalReviewer = task.approvalReviewer else {+ return false+ }++ switch approvalReviewer {+ case .user:+ let wasWaiting = task.state == .waitingApproval+ task.confirmPendingApproval()+ if !wasWaiting,+ let sessionTransitionNotBefore,+ requestedAt >= sessionTransitionNotBefore {+ transitions.append(.waitingApproval(task.snapshot))+ }+ case .autoReview, .guardianSubagent:+ task.pendingApprovalRequestedAt = nil+ }+ return true+ }+/// rollout 终态归类的唯一入口;活动任务和等待终态确认任务只有 abort 兜底时间不同。/// 终止记录只供任务中心展示,不发布 transition,也不产生绿色状态或通知。func resolveTerminal(@@ -956,6 +996,8 @@ private struct CodexActivityTask {var startedAt: Date?var stateChangedAt: Datevar lastActivityAt: Date+ var approvalReviewer: CodexApprovalReviewer?+ var pendingApprovalRequestedAt: Date?init(displayID: UUID,@@ -975,6 +1017,8 @@ private struct CodexActivityTask {self.startedAt = startedAtstateChangedAt = event.timestamplastActivityAt = event.timestamp+ approvalReviewer = event.approvalReviewer+ pendingApprovalRequestedAt = nil}var showsPreciseDuration: Bool {@@ -1025,5 +1069,30 @@ private struct CodexActivityTask {projectName = event.projectDisplayName ?? projectNamemodelName = event.modelName ?? modelNametoolName = event.toolName ?? toolName+ approvalReviewer = event.approvalReviewer ?? approvalReviewer+ }++ /// 记录审批候选;返回值只表示任务是否刚刚进入用户等待状态。+ mutating func recordApprovalRequest(at requestedAt: Date) -> Bool {+ pendingApprovalRequestedAt = requestedAt+ guard approvalReviewer == .user else {+ return false+ }++ let enteredWaiting = state != .waitingApproval+ confirmPendingApproval()+ return enteredWaiting+ }++ mutating func confirmPendingApproval() {+ guard let requestedAt = pendingApprovalRequestedAt else {+ return+ }+ pendingApprovalRequestedAt = nil+ if state != .waitingApproval {+ state = .waitingApproval+ stateChangedAt = requestedAt+ }+ latestEvent = .approvalRequested}}diff --git a/CodexBar/Services/Workflow/CodexSessionLifecycleReader.swift b/CodexBar/Services/Workflow/CodexSessionLifecycleReader.swiftindex 1870b87..56d028f 100644--- a/CodexBar/Services/Workflow/CodexSessionLifecycleReader.swift+++ b/CodexBar/Services/Workflow/CodexSessionLifecycleReader.swift@@ -1,7 +1,7 @@import Foundation/// 活跃 turn 的最小定位信息,只在进程内用于关联 Codex session 生命周期事件。-nonisolated struct CodexActivityTurnReference: Hashable, Sendable {+nonisolated struct CodexActivityTurnReference: Hashable {let sessionId: Stringlet turnId: Stringlet startedAt: Date@@ -58,6 +58,7 @@ actor CodexSessionLifecycleReader {sessionId: reference.sessionId,turnId: reference.turnId,startedAt: lifecycle.startedAt,+ approvalReviewer: lifecycle.approvalReviewer,terminal: lifecycle.terminal))@@ -236,13 +237,24 @@ private nonisolated struct CodexSessionLifecycleEnvelope: Decodable {let payload: CodexSessionLifecyclePayload?var lifecycleEvent: SessionLifecycleEvent? {- guard type == "event_msg",- let payload,+ guard let payload,let turnId = payload.turnId,!turnId.isEmpty else {return nil}+ if type == "turn_context",+ let approvalReviewer = payload.approvalReviewer {+ return SessionLifecycleEvent(+ turnId: turnId,+ change: .approvalReviewer(approvalReviewer)+ )+ }++ guard type == "event_msg" else {+ return nil+ }+switch payload.type {case "task_started":guard let startedAt = payload.startedAt.flatMap(Self.date) else {@@ -281,6 +293,7 @@ private nonisolated struct CodexSessionLifecyclePayload: Decodable {let startedAt: Double?let completedAt: Double?let durationMilliseconds: Double?+ let approvalReviewer: CodexApprovalReviewer?private enum CodingKeys: String, CodingKey {case type@@ -288,6 +301,7 @@ private nonisolated struct CodexSessionLifecyclePayload: Decodable {case startedAt = "started_at"case completedAt = "completed_at"case durationMilliseconds = "duration_ms"+ case approvalReviewer = "approvals_reviewer"}}@@ -298,12 +312,14 @@ private nonisolated struct SessionLifecycleEvent {private nonisolated enum SessionLifecycleChange {case started(at: Date)+ case approvalReviewer(CodexApprovalReviewer)case completed(at: Date, duration: TimeInterval?)case aborted(at: Date?)}private nonisolated struct SessionTurnLifecycle {var startedAt: Date?+ var approvalReviewer: CodexApprovalReviewer?var terminal: CodexSessionTaskTerminalState?mutating func apply(_ change: SessionLifecycleChange) {@@ -314,6 +330,8 @@ private nonisolated struct SessionTurnLifecycle {} else {startedAt = at}+ case let .approvalReviewer(value):+ approvalReviewer = valuecase let .completed(at, duration):terminal = .completed(at: at, duration: duration)case let .aborted(at):@@ -322,14 +340,15 @@ private nonisolated struct SessionTurnLifecycle {}}-nonisolated struct CodexSessionTaskLifecycleState: Sendable {+nonisolated struct CodexSessionTaskLifecycleState {let sessionId: Stringlet turnId: Stringlet startedAt: Date?+ let approvalReviewer: CodexApprovalReviewer?let terminal: CodexSessionTaskTerminalState?}-nonisolated enum CodexSessionTaskTerminalState: Sendable {+nonisolated enum CodexSessionTaskTerminalState {case completed(at: Date, duration: TimeInterval?)case aborted(at: Date?)}diff --git a/CodexBar/Services/Workflow/HookEventTailReader.swift b/CodexBar/Services/Workflow/HookEventTailReader.swiftindex e1cbc6f..163c788 100644--- a/CodexBar/Services/Workflow/HookEventTailReader.swift+++ b/CodexBar/Services/Workflow/HookEventTailReader.swift@@ -1,6 +1,6 @@import Foundation-nonisolated enum HookEventBatch: Sendable {+nonisolated enum HookEventBatch {case bootstrapStartcase bootstrapEvents([WorkflowHookEvent])case bootstrapEnddiff --git a/CodexBar/Services/Workflow/WorkflowHookEventRecorder.swift b/CodexBar/Services/Workflow/WorkflowHookEventRecorder.swiftindex b6bf68e..ea40510 100644--- a/CodexBar/Services/Workflow/WorkflowHookEventRecorder.swift+++ b/CodexBar/Services/Workflow/WorkflowHookEventRecorder.swift@@ -31,6 +31,11 @@ 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(+ from: payload,+ eventName: eventName,+ turnId: turnId+ )let event = WorkflowHookEvent(timestamp: timestamp,name: eventName,@@ -38,6 +43,7 @@ nonisolated enum WorkflowHookEventRecorder {toolName: tool,modelName: model,permissionMode: permission,+ approvalReviewer: approvalReviewer,sessionId: sessionId,turnId: turnId)@@ -45,6 +51,23 @@ nonisolated enum WorkflowHookEventRecorder {try recordWorkflowTransaction(event: event)}+ private static func readApprovalReviewer(+ from payload: WorkflowHookPayload,+ eventName: String,+ turnId: String?+ ) -> CodexApprovalReviewer? {+ 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(+ transcriptPath: transcriptPath,+ turnId: turnId+ )+ }+private static func recordWorkflowTransaction(event: WorkflowHookEvent) throws {try WorkflowStorage.withExclusiveLock {let dateKey = WorkflowStorage.dateKey(for: event.timestamp)@@ -98,6 +121,67 @@ nonisolated enum WorkflowHookEventRecorder {}}+/// Hook payload 不直接提供 reviewer;从当前 rollout 尾部只提取匹配 turn 的审批路由。+private nonisolated enum WorkflowTurnContextReader {+ static func approvalReviewer(+ transcriptPath: String,+ turnId: String+ ) -> CodexApprovalReviewer? {+ let url = URL(fileURLWithPath: transcriptPath)+ let size = WorkflowStorage.fileSize(at: url)+ guard size > 0,+ let handle = try? FileHandle(forReadingFrom: url) else {+ return nil+ }+ defer {+ try? handle.close()+ }++ let offset = size > searchByteLimit ? size - searchByteLimit : 0+ guard (try? handle.seek(toOffset: offset)) != nil,+ let data = try? handle.readToEnd(),+ !data.isEmpty else {+ return nil+ }++ let completeData: Data+ if offset > 0, let firstNewlineIndex = data.firstIndex(of: newlineByte) {+ let firstCompleteIndex = data.index(after: firstNewlineIndex)+ completeData = firstCompleteIndex < data.endIndex+ ? Data(data[firstCompleteIndex...])+ : Data()+ } else {+ completeData = data+ }++ for envelope in JSONLines.decode(WorkflowTurnContextEnvelope.self, from: completeData)+ .reversed()+ where envelope.type == "turn_context"+ && envelope.payload?.turnId == turnId {+ return envelope.payload?.approvalReviewer+ }+ return nil+ }++ private static let searchByteLimit: UInt64 = 512 * 1024+ private static let newlineByte: UInt8 = 0x0A+}++private nonisolated struct WorkflowTurnContextEnvelope: Decodable {+ let type: String+ let payload: WorkflowTurnContextPayload?+}++private nonisolated struct WorkflowTurnContextPayload: Decodable {+ let turnId: String?+ let approvalReviewer: CodexApprovalReviewer?++ private enum CodingKeys: String, CodingKey {+ case turnId = "turn_id"+ case approvalReviewer = "approvals_reviewer"+ }+}+/// Codex Hook payload 字段存在版本差异, 这里集中做宽松类型归一化private nonisolated struct WorkflowHookPayload {let values: [String: Any]diff --git a/Docs/CodexHook.md b/Docs/CodexHook.mdindex 2741811..fec1c41 100644--- a/Docs/CodexHook.md+++ b/Docs/CodexHook.md@@ -82,10 +82,11 @@ Hook stdin 会尝试解析为 Codex 官方 JSON 对象,只读取顶层字段- 工具: `tool_name`- 模型: `model`- 权限模式: `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`-事件名来自 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`、`session`、`turn`、`tool`、`cwd`;缺失值写为 `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`、`permission`、`approval`、`session`、`turn`、`tool`、`cwd`;缺少 reviewer 或当前 rollout 无法读取时写为 `null`。事件名统计时会去掉 `_` 和 `-` 并转小写,因此 `PreToolUse`、`pre_tool_use`、`pre-tool-use` 会归为同一个事件。@@ -143,15 +144,17 @@ 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`;不提取、保存或展示提示词、回复、推理或工具内容。+- 初次从文件末尾最多读取 512 KB,之后每 1 秒按 byte offset 增量读取,保留半行并检测截断或替换。只解出顶层 `type`、`payload.type`、`payload.turn_id`、`started_at`、`completed_at`、`duration_ms` 和 `turn_context.approvals_reviewer`;不提取、保存或展示提示词、回复、推理、工具内容或审批内容。- `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。- `event_msg / turn_aborted` 移除对应任务,并在任务中心生成保留 10 分钟的灰色最近终止记录;优先使用 rollout 行时间,缺失时活跃任务使用检测时间、等待终态确认任务使用被新 Prompt 替代的时间,且都不猜测耗时。不生成完成记录、绿色状态、通知或触觉反馈。文件不存在、无法读取、格式变化或缺少精确 ID 时保留原 Hook 状态,最终仍由后续 prompt、Stop、Hook 关闭或 24 小时过期兜底。任务状态机规则:- 任务键优先使用 `session + turn`,缺少 turn 时使用 session;两者都缺少时按项目名归入匿名任务。匿名任务以及缺少起点的恢复任务不展示精确总耗时。- `UserPromptSubmit` 创建运行任务;同一 session 收到新 prompt 时,旧 turn 即使缺少 Stop 也视为已中断并从运行状态移除,但不生成完成记录、通知或触觉反馈。工具、上下文压缩和子智能体事件更新已有任务并解除等待,同时记录最近事件供活动卡片实时展示。工具和权限事件缺少起点时可以恢复顶层状态,子智能体事件不会单独创建顶层任务。-- `PermissionRequest` 进入等待批准;重复的等待事件不重复发布等待 transition。live 读取一次可能包含多个事件,monitor 会在整批应用后按任务键合并等待候选:最终仍在等待时使用最终快照发布一次,已经恢复运行、完成或移除时不发布过期等待 transition;完成候选保持事件顺序,并按 completion ID 防止同批重复发布。+- `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 小时没有新事件的活动自动过期。diff --git a/Docs/DevelopmentGuide.md b/Docs/DevelopmentGuide.mdindex 38045f9..df4fc5f 100644--- a/Docs/DevelopmentGuide.md+++ b/Docs/DevelopmentGuide.md@@ -777,6 +777,9 @@ sequenceDiagramCodex->>App: 执行 Hook 命令并传入事件内容App->>Recorder: 进入快速记录分支Recorder->>Recorder: 解析事件名和顶层字段+ opt Prompt 或权限请求+ Recorder->>Recorder: 从 transcript 尾部提取当前 turn reviewer+ endRecorder->>Lock: 获取独占锁Recorder->>Events: 追加一行事件 JSONLRecorder->>State: 标记当天等待维护@@ -794,6 +797,7 @@ sequenceDiagram| `tool_name` | `tool` || `model` | `model` || `permission_mode` | `permission` |+| `transcript_path` | `approval`;仅提取匹配 turn 的 reviewer || `session_id` | `session` || `turn_id` | `turn` |@@ -803,6 +807,7 @@ sequenceDiagram- `timestamp` 缺失或无法解析时使用当前时间- `cwd` 缺失时使用当前工作目录+- `transcript_path` 缺失、无法读取、512 KB 内找不到匹配 `turn_context` 或 reviewer 未知时,`approval` 写为 `null`;主 App 仍会通过增量 rollout reader 尝试补齐,未补齐前不判定为用户等待- 其他字段缺失写为 `null`Hook 数据目录:@@ -1084,7 +1089,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、起止时间和耗时,不提取、保存或展示提示词、回复、推理和工具内容+- 实时任务状态只保存在 `CodexActivityMonitor` 内存中,UI 只展示项目最后一级名称、模型、工具名与最近 Hook 事件类型;运行卡片第一行组合项目和模型,第二行组合运行时间与请求/工具/压缩/子智能体状态,其他任务数使用右侧 `+N` 徽标。并发任务中心消费同一快照中的完整等待、运行、最近完成和最近终止列表,列表身份使用进程内 UUID,不展示或持久化 session/turn ID。不写历史文件、不上传 CloudKit,也不新增网络请求。`CodexSessionLifecycleReader` 只对活跃 session + turn 增量读取本机 rollout,提取事件类型、turn ID、起止时间、耗时和审批 reviewer,不提取、保存或展示提示词、回复、推理、工具内容或审批内容## 19. 通知与触觉提醒链路@@ -1092,9 +1097,9 @@ App 再次成为 active 时, 也会刷新 Codex 版本区、同步可用性, 并- `NotificationSettings` (`Services/Settings/`): 总开关、五类通知子开关、任务触觉开关、低额度阈值 (5%/10%/25%, 默认 10%) 和长任务时长 (30s/1m/2m/5m, 默认 1m), 持久化到 UserDefaults; 负责系统授权请求、被拒状态镜像和设置页选项面板可展示状态- `CodexNotificationService`: 集中判定、去重、调度与发送; 由 `CodexBarAppDelegate` 创建, 订阅 `CodexStatusViewModel.$snapshot`、`CodexActivityMonitor` live transition 与 `NSWorkspace.didWakeNotification`; 五类正式通知共用 `CodexNotificationContent` 文案工厂,系统提交失败时重试一次,等待与完成 transition 还会按偏好请求 AppKit `.levelChange` 触觉反馈-- `CodexActivityMonitor`: Hook 开启期间始终运行并维护并发任务;向 UI 发布快照,向提醒服务发布 live transition。单个 live 批次先完整应用事件,再按任务键合并等待候选;只有批次结束后仍处于等待的任务会使用最终快照发布一次等待 transition,完成候选保持顺序并按 completion ID 做批内去重。通知与触觉开关不会停止活动监测+- `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 移除任务并生成灰色最近终止记录,读取失败时不改变 Hook 状态。轮询和即时 lifecycle 查询都绑定 reader generation,跨 actor 返回后仍会复核,旧查询不能落入新 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 状态活动并发以 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 回退键去重;重复完成不会覆盖首次确认结果,也不会缩短去重窗口或再次触发反馈。@@ -1107,7 +1112,7 @@ App 再次成为 active 时, 也会刷新 Codex 版本区、同步可用性, 并| 额度低阈值 | 非 stale 快照中窗口剩余比例穿越到 ≤ 阈值; 阈值或子开关变化时用当前快照立即重评估 | `low\|账号\|limitId\|windowId\|resetsAt` || 额度已重置 | 同一账号下每个 limit 的 primary/secondary 窗口独立观察;可信快照中消耗从大于 0% 变为 0% 时立即发送以 `limit.title` 和窗口周期命名的通知 | 进程内按 `账号\|limitId\|windowId` 观察状态转换;成功发送后使用 `quotaReset\|账号\|limitId\|windowId\|resetsAt` 持久化去重 || 长任务完成 | monitor 的 live Hook `Stop` 或 rollout `task_complete` transition 具有精确耗时且耗时 ≥ 阈值 | 状态机按精确任务键对两种完成信号去重 |-| 任务等待批准 | monitor 的 live 批次结束后任务处于 `waitingApproval`;当前进程内任务离开等待状态后移除对应的 delivered/pending 通知 | 同批次按任务键合并,通知使用 `taskWaiting\|taskUUID` 任务级 identifier |+| 任务等待批准 | 同一 turn 的 rollout 明确 `approvals_reviewer == user`,且 monitor 的 live 批次结束后任务仍处于 `waitingApproval`;自动审批不触发;任务离开等待状态后移除对应通知 | 同批次按任务键合并,通知使用 `taskWaiting\|taskUUID` 任务级 identifier || 重置机会临期 | 过期时间距今 ≤ 7 天, 并在过期前 7/6/5/4/3/2/1 天各提醒一次; 正文使用本地时间 `yyyy-MM-dd HH:mm:ss` | `credit\|账号\|过期时间\|提醒档位` |额度低阈值、额度重置和重置机会通知只在系统成功接收后把去重键写入 UserDefaults (`Notification.sentKeys`),最多保留 300 条。键包含账号维度;额度重置窗口提供 `resetsAt` 时,去重键还包含该时间,缺失时仍发送通知但不生成周期去重键。额度重置观察状态和等待通知跟踪集合保存在当前进程内;通知不按预测时间调度,也不补发已错过的状态转换。可信额度快照持续推进重置观察状态,stale 快照不参与判定;窗口消失时移除对应观察状态,快照为 `nil` 时清空全部观察状态。Hook bootstrap 只恢复任务状态,不发布 transition,因此不产生历史任务通知或触觉反馈。diff --git a/Docs/UserGuide.md b/Docs/UserGuide.mdindex 919d458..e3545af 100644--- a/Docs/UserGuide.md+++ b/Docs/UserGuide.md@@ -320,7 +320,7 @@ Hook 命令包含 CodexBar 当前可执行文件的完整路径。如果准备| 额度预警通知 | 可信额度从阈值上方跌到阈值或以下 | 5%、10%、25%,默认 10% || 额度重置通知 | 已发生消耗的额度窗口恢复到 100% | 提供重置时间时,同周期提醒一次 || 任务完成通知 | Hook 任务确认完成且耗时达到阈值 | 30 秒、1、2、5 分钟,默认 1 分钟 |-| 任务等待通知 | 任务在一批事件处理结束后仍等待批准 | 无 |+| 任务等待通知 | 用户审批模式下,任务在一批事件处理结束后仍等待批准 | 无 || 任务触觉反馈 | 任务进入等待批准或确认结束 | 需要 Hook;服从通知总开关 || 重置次数临期通知 | 手动重置机会将在 7 天内过期 | 最多每 24 小时提醒一次 |@@ -530,7 +530,7 @@ Hook 保存的是 App 可执行文件的完整路径。将 App 移回原位置#### 为什么短暂出现「等待批准」却没有通知?-Hook 事件可能成批到达。CodexBar 会先处理完整批次;如果任务在同一批内已经恢复运行或完成,就不会发送已经过期的等待提醒。+`PermissionRequest` 也可能由 Codex 自动审批产生。CodexBar 会同时检查当前 turn 的审批 reviewer,只有明确路由给用户并且批次结束后仍在等待时才进入等待状态;自动审批或同一批内已经恢复运行、完成的任务不会发送等待提醒。#### 为什么触觉反馈没有感觉?diff --git a/README.md b/README.mdindex 9a8ae2c..6713435 100644--- a/README.md+++ b/README.md@@ -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` 清理中断任务并生成最近终止记录。同 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` 区分用户审批和自动审批。只有 reviewer 明确为 `user` 且同时收到 `PermissionRequest` 时才显示等待批准;`auto_review` 不会触发等待状态或提醒。同 session 新 Prompt 会让旧 turn 立即退出活动列表,但先保留 5 秒终态确认窗口,优先接受 rollout 或迟到 Hook 的完成/终止信号,仍无终态才记为终止。不读取提示词、回复、推理、工具内容或审批内容。该实时状态用于菜单栏状态点、活动卡片、并发任务中心、可选任务通知和触觉反馈,不新增历史状态文件,也不参与跨设备同步。CodexBar 只会追加或移除属于当前 CodexBar 可执行文件的 Hook,不会删除用户已有的其他 Codex Hook。@@ -91,7 +91,7 @@ CodexBar 会把该设备的使用详情数据同步到当前 iCloud 账号的 Cl通知子面板中的「任务触觉反馈」默认开启;当任务进入等待批准或确认结束时,CodexBar 会每 100 ms 请求一次层级变化触觉反馈,连续 10 次。该功能服从 App 内「系统通知」总开关,但不依赖系统通知授权或长任务时长阈值;是否实际反馈及震感强弱由当前输入设备、辅助功能和系统偏好决定。-Hook 事件可能在一次轮询中成批到达。CodexBar 会先处理完整批次,再按任务合并等待状态:只有批次结束后仍在等待批准的任务才通知一次;已经恢复运行、完成或移除的短暂等待不会产生过期提醒。+Hook 事件可能在一次轮询中成批到达。CodexBar 会先处理完整批次,再按任务合并等待状态:只有 reviewer 为 `user`、批次结束后仍在等待批准的任务才通知一次;自动审批以及已经恢复运行、完成或移除的短暂候选不会产生过期提醒。Hook `Stop` 与本机 rollout 的完成信号会统一去重;迟到的重复完成、工具或权限事件不会让已完成任务重复通知、触发触觉反馈或重新显示为活动状态。diff --git a/appcast.xml b/appcast.xmlindex b6395e9..4d06f55 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.6</title>+ <sparkle:version>44</sparkle:version>+ <sparkle:shortVersionString>3.3.6</sparkle:shortVersionString>+ <sparkle:minimumSystemVersion>15.0</sparkle:minimumSystemVersion>+ <sparkle:releaseNotesLink>https://codexbar.zabrian.app/notes#3.3.6</sparkle:releaseNotesLink>+ <pubDate>Mon, 13 Jul 2026 13:08:37 +0800</pubDate>+ <enclosure url="https://codexbar.zabrian.app/download/CodexBar-v3.3.6.dmg" sparkle:edSignature="11eKrUdEUbpfIR8n6ZWrS72p6RFzbMIwoiImuts4VzMtibrn4qtZt3zrZFmGhFiwEnYKCLZRabqtqtlbEoSuCQ==" length="4003530" type="application/octet-stream"/>+ </item><item><title>CodexBar.app 3.3.5</title><sparkle:version>43</sparkle:version>