Skip to content

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

fix: 修正自动审批任务等待状态

Bob55bc5a4417be
diff --git a/CodexBar.xcodeproj/project.pbxproj b/CodexBar.xcodeproj/project.pbxproj
index 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.swift
index 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 promptSubmitted
case toolStarted
case toolFinished
@@ -13,13 +13,13 @@ nonisolated enum CodexActivityEvent: Equatable, Sendable {
}
/// bootstrap 后需要向更早日期定向查找 Prompt 起点的精确任务引用。
-nonisolated struct CodexActivityPromptReference: Hashable, Sendable {
+nonisolated struct CodexActivityPromptReference: Hashable {
let sessionId: String
let turnId: String
}
/// 正在运行或等待批准的任务摘要,不对 UI 暴露原始会话 ID。
-nonisolated struct CodexActivityTaskSnapshot: Equatable, Identifiable, Sendable {
+nonisolated struct CodexActivityTaskSnapshot: Equatable, Identifiable {
let id: UUID
let latestEvent: CodexActivityEvent
let 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: UUID
let 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: UUID
let 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.swift
index 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.swift
index 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: Date
let name: String
let 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 = toolName
self.modelName = modelName
self.permissionMode = permissionMode
+ self.approvalReviewer = approvalReviewer
self.sessionId = sessionId
self.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.swift
index 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 = false
if 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 = .running
task.stateChangedAt = event.timestamp
}
+ task.pendingApprovalRequestedAt = nil
task.latestEvent = latestEvent
task.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 = .approvalRequested
task.mergeMetadata(from: event)
// 权限事件描述当前请求;缺失工具名时不能沿用上一条工具事件。
task.toolName = event.toolName
task.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: Date
var lastActivityAt: Date
+ var approvalReviewer: CodexApprovalReviewer?
+ var pendingApprovalRequestedAt: Date?
init(
displayID: UUID,
@@ -975,6 +1017,8 @@ private struct CodexActivityTask {
self.startedAt = startedAt
stateChangedAt = event.timestamp
lastActivityAt = event.timestamp
+ approvalReviewer = event.approvalReviewer
+ pendingApprovalRequestedAt = nil
}
var showsPreciseDuration: Bool {
@@ -1025,5 +1069,30 @@ private struct CodexActivityTask {
projectName = event.projectDisplayName ?? projectName
modelName = event.modelName ?? modelName
toolName = 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.swift
index 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: String
let turnId: String
let 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 = value
case 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: String
let turnId: String
let 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.swift
index 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 bootstrapStart
case bootstrapEvents([WorkflowHookEvent])
case bootstrapEnd
diff --git a/CodexBar/Services/Workflow/WorkflowHookEventRecorder.swift b/CodexBar/Services/Workflow/WorkflowHookEventRecorder.swift
index 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.md
index 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.md
index 38045f9..df4fc5f 100644
--- a/Docs/DevelopmentGuide.md
+++ b/Docs/DevelopmentGuide.md
@@ -777,6 +777,9 @@ sequenceDiagram
Codex->>App: 执行 Hook 命令并传入事件内容
App->>Recorder: 进入快速记录分支
Recorder->>Recorder: 解析事件名和顶层字段
+ opt Prompt 或权限请求
+ Recorder->>Recorder: 从 transcript 尾部提取当前 turn reviewer
+ end
Recorder->>Lock: 获取独占锁
Recorder->>Events: 追加一行事件 JSONL
Recorder->>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.md
index 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.md
index 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.xml
index 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>