CodexBar 是一个 macOS 菜单栏应用,用于查看本机 Codex 账号状态、额度、Token 用量、详细统计信息
Swift appkitcodexcodex-clideveloper-toolsmacosmacos-appmenu-bar-appopenai-codexproductivityswiftswiftuiusage-tracker
fix: 修复历史工作流计数
Bob2411a34dea05
diff --git a/CodexBar.xcodeproj/project.pbxproj b/CodexBar.xcodeproj/project.pbxprojindex 7ff61d0..9903a6a 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 = 44;+ CURRENT_PROJECT_VERSION = 45;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.6;+ MARKETING_VERSION = 3.3.7;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 = 44;+ CURRENT_PROJECT_VERSION = 45;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.6;+ MARKETING_VERSION = 3.3.7;PRODUCT_BUNDLE_IDENTIFIER = app.zabrian.codexbar;PRODUCT_NAME = "$(TARGET_NAME)";PROVISIONING_PROFILE_SPECIFIER = "";diff --git a/CodexBar/Models/CodexWorkflowModels.swift b/CodexBar/Models/CodexWorkflowModels.swiftindex 486f418..c16e1f4 100644--- a/CodexBar/Models/CodexWorkflowModels.swift+++ b/CodexBar/Models/CodexWorkflowModels.swift@@ -31,6 +31,31 @@ private nonisolated enum WorkflowJSON {}}+private nonisolated enum WorkflowCountResolution {+ static func preferredCount(+ compactedCount: Int?,+ identifiers: [String]? = nil+ ) -> Int? {+ if let compactedCount, compactedCount > 0 {+ return compactedCount+ }++ guard let identifiers, !identifiers.isEmpty else {+ return nil+ }++ return Set(identifiers).count+ }++ static func resolvedCount(+ compactedCount: Int?,+ identifiers: [String]? = nil,+ fallback: Int+ ) -> Int {+ preferredCount(compactedCount: compactedCount, identifiers: identifiers) ?? fallback+ }+}+/// hooks 进程落盘的最小事件模型, 对历史字段缺失保持宽容nonisolated struct WorkflowHookEvent: Decodable, Equatable {let timestamp: Date@@ -441,14 +466,21 @@ nonisolated struct WorkflowDailyAggregate: Codable, Equatable, Identifiable {turnIds = nil}- // 会话/轮次最终值: 优先使用去重/压缩后的数量- // 起止事件计数只作为缺失兜底+ // 只有正数压缩计数或非空 ID 集合是有效去重结果, 否则使用起止事件计数兜底private var resolvedSessionCount: Int {- sessionCount ?? sessionIds?.count ?? sessionStartCount+ WorkflowCountResolution.resolvedCount(+ compactedCount: sessionCount,+ identifiers: sessionIds,+ fallback: sessionStartCount+ )}private var resolvedTurnCount: Int {- turnCount ?? turnIds?.count ?? stopCount+ WorkflowCountResolution.resolvedCount(+ compactedCount: turnCount,+ identifiers: turnIds,+ fallback: stopCount+ )}var metrics: WorkflowDailyMetrics {@@ -542,19 +574,17 @@ nonisolated struct WorkflowDailyAggregate: Codable, Equatable, Identifiable {}private var syncedSessionCount: Int? {- sessionCount ?? Self.nonEmptyIdentifierCount(sessionIds)+ WorkflowCountResolution.preferredCount(+ compactedCount: sessionCount,+ identifiers: sessionIds+ )}private var syncedTurnCount: Int? {- turnCount ?? Self.nonEmptyIdentifierCount(turnIds)- }-- private static func nonEmptyIdentifierCount(_ identifiers: [String]?) -> Int? {- guard let identifiers, !identifiers.isEmpty else {- return nil- }-- return Set(identifiers).count+ WorkflowCountResolution.preferredCount(+ compactedCount: turnCount,+ identifiers: turnIds+ )}private static func append(@@ -572,8 +602,9 @@ nonisolated struct WorkflowDailyAggregate: Codable, Equatable, Identifiable {identifiers?.append(identifier)}- private static func normalizedIdentifiers(_ identifiers: [String]?) -> [String] {- Set(identifiers ?? []).sorted()+ private static func normalizedIdentifiers(_ identifiers: [String]?) -> [String]? {+ let normalized = Set(identifiers ?? []).sorted()+ return normalized.isEmpty ? nil : normalized}private static func date(from string: String) -> Date? {@@ -626,8 +657,14 @@ nonisolated struct WorkflowSyncedDailyAggregate: Codable, Equatable, Identifiablvar metrics: WorkflowDailyMetrics {WorkflowDailyMetrics(startDate: date,- sessionCount: sessionCount ?? sessionStartCount,- turnCount: turnCount ?? stopCount,+ sessionCount: WorkflowCountResolution.resolvedCount(+ compactedCount: sessionCount,+ fallback: sessionStartCount+ ),+ turnCount: WorkflowCountResolution.resolvedCount(+ compactedCount: turnCount,+ fallback: stopCount+ ),preToolUseCount: preToolUseCount,postToolUseCount: postToolUseCount,permissionRequestCount: permissionRequestCount,diff --git a/CodexBar/Services/Workflow/WorkflowSyncService.swift b/CodexBar/Services/Workflow/WorkflowSyncService.swiftindex 80bf5c5..54eb47b 100644--- a/CodexBar/Services/Workflow/WorkflowSyncService.swift+++ b/CodexBar/Services/Workflow/WorkflowSyncService.swift@@ -138,7 +138,7 @@ private extension WorkflowSyncService {typealias UploadedHash = (date: String, hash: String)enum Metrics {- static let syncSchemaVersion = 2+ static let syncSchemaVersion = 3static let syncZoneName = "CodexBarZone"static let saltByteCount = 32static let recordFetchLimit = 200@@ -917,7 +917,7 @@ nonisolated struct WorkflowSyncSnapshot: Equatable {}private nonisolated struct WorkflowSyncState: Codable, Equatable {- static let currentSchema = 2+ static let currentSchema = 3var schema: Intvar deviceId: String?diff --git a/Docs/CodexHook.md b/Docs/CodexHook.mdindex fec1c41..f3828f2 100644--- a/Docs/CodexHook.md+++ b/Docs/CodexHook.md@@ -179,7 +179,7 @@ Hook 写入路径不更新 `daily.jsonl`,也不执行重建或清理旧文件CodexBar 最多保留最近 210 天数据。-最近 3 个本地自然日的每日聚合保留 `sessionIds` 和 `turnIds`,用于继续去重。早于最近 3 天窗口的日期会把 ID 集合压缩成 `sessionCount` 和 `turnCount`,之后不再保存 ID。210 天外的 `events/YYYY-MM-DD.jsonl` 会在主 App 维护流程中删除。+最近 3 个本地自然日的每日聚合只在实际收集到 ID 时保留非空 `sessionIds` 和 `turnIds`,用于继续去重。新建聚合以 `[]` 开始,一轮聚合结束后仍为空的数组会规范化为 `null`。早于最近 3 天窗口的日期会把有效 ID 数量或起止事件兜底值压缩成 `sessionCount` 和 `turnCount`,之后不再保存 ID。210 天外的 `events/YYYY-MM-DD.jsonl` 会在主 App 维护流程中删除。如果 `daily.jsonl` 缺失、为空、解析失败、缺少对应日期摘要,或者某天 events 文件状态和 `maintenance.json` 不一致,主 App 会把对应日期加入 `dirty` 并在刷新维护时按天重建。@@ -195,6 +195,7 @@ CloudKit 中每个 iCloud 账号会保存一条账号级 salt:zoneName = CodexBarZonerecordType = CodexBarSyncMetadatarecordName = accountSalt+schemaVersion = 3salt = 32 bytes```@@ -212,7 +213,7 @@ CodexBar 不上传原始 `IOPlatformUUID`。同一台 Mac 在同一 iCloud 账sessionIds, turnIds```-其余字段保持原值同步,包括 `projectCounts` 和 `modelCounts`。如果本地仍保留 `sessionIds` / `turnIds`,上传副本会把去重后的 `sessionIds.count` / `turnIds.count` 写入 `sessionCount` / `turnCount`,但不会上传 ID 本身;只有既没有压缩后的 count、也没有本地 ID 时,这两个字段才可能为 `null`。脱敏只发生在上传副本上,不会写回本地 `daily.jsonl`,因此最近 3 天本地仍保留 `sessionIds` / `turnIds` 用于本机精确去重。+除 `sessionCount` / `turnCount` 按下述规则生成外,其余字段保持原值同步,包括 `projectCounts` 和 `modelCounts`。上传副本中的这两个 count 只接受已有正数压缩 count,或本地非空 `sessionIds` / `turnIds` 的去重数量;两者都没有时写为 `null`,不会把空数组或真实全零日上传成明确的 count。脱敏只发生在上传副本上,不会写回本地 `daily.jsonl`,因此最近 3 天本地仍保留非空 `sessionIds` / `turnIds` 用于本机精确去重。接收端读取同步记录时不恢复 ID;正数 count 优先,否则分别回退到 `sessionStartCount` / `stopCount`,所以旧版错误的明确 `0` 和缺失字段都不会压过起止事件计数。每台设备每天一条记录:@@ -220,6 +221,7 @@ sessionIds, turnIdszoneName = CodexBarZonerecordType = CodexBarDailyAggregaterecordName = <deviceId>_<yyyy-MM-dd>+schemaVersion = 3```Hook 子进程不访问网络。主 App 在工作流统计维护刷新后对本次可能变化的日期生成脱敏 daily 副本,计算稳定 hash,并和本地同步状态比较。只有 hash 变化的日期才 upsert 到 CloudKit;上传成功后才更新本地 hash,失败则下次刷新继续重试。@@ -277,51 +279,51 @@ subagentStopCount, sessionCount, turnCount, projectCounts, modelCounts, sessionI从 `events/YYYY-MM-DD.jsonl` 到页面指标的判定规则如下:-| 页面展示名 | 会被计入的 `events/YYYY-MM-DD.jsonl` 行 | 不会计入的典型情况 | 计数方式 |-| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------- |-| 会话总数 | 最近 3 个本地自然日内,任意带非空 `session` 的事件行都会把该 `session` 加入当天去重集合;另外 `event` 归一化为 `sessionstart` 的行会增加 `sessionStartCount`。 | `session` 为 `null` 且 `event` 不是 `SessionStart`;坏行。 | 优先 `sessionCount`,其次 `sessionIds.count`,最后 `sessionStartCount` |-| 对话轮次 | 最近 3 个本地自然日内,任意带非空 `turn` 的事件行都会把该 `turn` 加入当天去重集合;另外 `event` 归一化为 `stop` 的行会增加 `stopCount`。 | `turn` 为 `null` 且 `event` 不是 `Stop`;坏行。 | 优先 `turnCount`,其次 `turnIds.count`,最后 `stopCount` |-| 子智能体 | `event` 归一化为 `subagentstart` 或 `subagentstop` 的行。 | 其他事件名;坏行。 | `max(subagentStartCount, subagentStopCount)` |-| 调用工具 | `event` 归一化为 `pretooluse` 的行会增加 `preToolUseCount`;归一化为 `posttooluse` 的行会增加 `postToolUseCount`。`tool` 可以是具体工具名,也可以是 `null`。 | `SessionStart` 这类非工具事件,即使 `tool` 是 `null` 或存在也不会计入;坏行。 | `max(preToolUseCount, postToolUseCount)` |-| 权限请求 | `event` 归一化为 `permissionrequest` 的行。 | `permission` 字段本身不会触发计数;只有事件名是 `PermissionRequest` 才计入。 | `permissionRequestCount` |-| 上下文压缩 | `event` 归一化为 `precompact` 或 `postcompact` 的行。 | 其他事件名;坏行。 | `max(preCompactCount, postCompactCount)` |-| 最热模型 | 任意带非空 `model` 的有效事件行。 | `model` 为 `null` 或空字符串;坏行。 | 按模型名累计事件数,取最高值;并列时按模型名升序取第一个 |+| 页面展示名 | 会被计入的 `events/YYYY-MM-DD.jsonl` 行 | 不会计入的典型情况 | 计数方式 |+| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |+| 会话总数 | 最近 3 个本地自然日内,任意带非空 `session` 的事件行都会把该 `session` 加入当天去重集合;另外 `event` 归一化为 `sessionstart` 的行会增加 `sessionStartCount`。 | `session` 为 `null` 且 `event` 不是 `SessionStart`;坏行。 | 优先正数 `sessionCount`,其次非空 `sessionIds` 的去重数量,最后 `sessionStartCount` |+| 对话轮次 | 最近 3 个本地自然日内,任意带非空 `turn` 的事件行都会把该 `turn` 加入当天去重集合;另外 `event` 归一化为 `stop` 的行会增加 `stopCount`。 | `turn` 为 `null` 且 `event` 不是 `Stop`;坏行。 | 优先正数 `turnCount`,其次非空 `turnIds` 的去重数量,最后 `stopCount` |+| 子智能体 | `event` 归一化为 `subagentstart` 或 `subagentstop` 的行。 | 其他事件名;坏行。 | `max(subagentStartCount, subagentStopCount)` |+| 调用工具 | `event` 归一化为 `pretooluse` 的行会增加 `preToolUseCount`;归一化为 `posttooluse` 的行会增加 `postToolUseCount`。`tool` 可以是具体工具名,也可以是 `null`。 | `SessionStart` 这类非工具事件,即使 `tool` 是 `null` 或存在也不会计入;坏行。 | `max(preToolUseCount, postToolUseCount)` |+| 权限请求 | `event` 归一化为 `permissionrequest` 的行。 | `permission` 字段本身不会触发计数;只有事件名是 `PermissionRequest` 才计入。 | `permissionRequestCount` |+| 上下文压缩 | `event` 归一化为 `precompact` 或 `postcompact` 的行。 | 其他事件名;坏行。 | `max(preCompactCount, postCompactCount)` |+| 最热模型 | 任意带非空 `model` 的有效事件行。 | `model` 为 `null` 或空字符串;坏行。 | 按模型名累计事件数,取最高值;并列时按模型名升序取第一个 |逐字段统计口径如下:-| `daily.jsonl` 字段 | 从 `events/YYYY-MM-DD.jsonl` 读取什么 | 写入 / 更新规则 | 页面关系 |-| ------------------------ | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |-| `date` | `timestamp` | Hook 写入时先把事件时间解析为绝对时间,再按当前本地时区格式化为 `yyyy-MM-dd` 选择日期文件。维护流程按当前处理的文件日期生成同名 `daily.jsonl` 行。早于最近 210 天保留窗口的日期不会进入聚合。 | 热力图日期键;详情面板日期。 |-| `eventCount` | 每条成功解码并保留下来的事件行 | 每处理一条事件就 `+1`,发生在具体事件类型判断之前。因此 `UserPromptSubmit`、未知 `event`、`tool: null`、`session: null` 等行都会计入,只要 `timestamp` 和 `event` 可解析。 | 进入 `WorkflowDailyMetrics.eventCount`,当前页面不展示。 |-| `sessionStartCount` | `event` | `event` 归一化后等于 `sessionstart` 时 `+1`。不要求 `session` 非空。 | 作为「会话总数」兜底来源。 |-| `stopCount` | `event` | `event` 归一化后等于 `stop` 时 `+1`。不要求 `turn` 非空。 | 作为「对话轮次」兜底来源。 |-| `preToolUseCount` | `event` | `event` 归一化后等于 `pretooluse` 时 `+1`。不读取 `tool` 做过滤,`tool` 为 `null` 也计入。 | 参与「调用工具」。 |-| `postToolUseCount` | `event` | `event` 归一化后等于 `posttooluse` 时 `+1`。不读取 `tool` 做过滤,`tool` 为 `null` 也计入。 | 参与「调用工具」。 |-| `permissionRequestCount` | `event` | `event` 归一化后等于 `permissionrequest` 时 `+1`。不读取 `permission` 字段做过滤,`permission` 只是记录当时的权限模式。 | 直接显示为「权限请求」。 |-| `preCompactCount` | `event` | `event` 归一化后等于 `precompact` 时 `+1`。 | 参与「上下文压缩」。 |-| `postCompactCount` | `event` | `event` 归一化后等于 `postcompact` 时 `+1`。 | 参与「上下文压缩」。 |-| `subagentStartCount` | `event` | `event` 归一化后等于 `subagentstart` 时 `+1`。 | 参与「子智能体」。 |-| `subagentStopCount` | `event` | `event` 归一化后等于 `subagentstop` 时 `+1`。 | 参与「子智能体」。 |-| `sessionIds` | `session` | 仅最近 3 个本地自然日保留。任意事件行只要 `session` 是非空字符串,就插入当天集合并去重、排序;不要求事件类型是 `SessionStart`。窗口外日期会被压缩为 `sessionCount` 并写成 `null`。 | 参与「会话总数」去重。 |-| `turnIds` | `turn` | 仅最近 3 个本地自然日保留。任意事件行只要 `turn` 是非空字符串,就插入当天集合并去重、排序;不要求事件类型是 `Stop`。窗口外日期会被压缩为 `turnCount` 并写成 `null`。 | 参与「对话轮次」去重。 |-| `sessionCount` | `sessionIds`、旧 `sessionCount`、`sessionStartCount` | 最近 3 天通常为 `null`;日期进入 3 天外窗口后,归一化时优先沿用已有 `sessionCount`,否则使用 `sessionIds.count`,再否则使用 `sessionStartCount`,然后移除 `sessionIds`。这样旧日期不用继续保存完整 ID,也能保留会话总数。 | 参与「会话总数」。 |-| `turnCount` | `turnIds`、旧 `turnCount`、`stopCount` | 最近 3 天通常为 `null`;日期进入 3 天外窗口后,归一化时优先沿用已有 `turnCount`,否则使用 `turnIds.count`,再否则使用 `stopCount`,然后移除 `turnIds`。这样旧日期不用继续保存完整 ID,也能保留轮次总数。 | 参与「对话轮次」。 |-| `projectCounts` | `cwd` | 任意事件行只要 `cwd` 非空,就取标准化路径的最后一层目录名作为项目名并 `+1`;如果最后一层为空,回退使用完整路径字符串。统计的是事件数,不是会话数或调用工具数。未知事件也会计入。 | 用于计算 `mostActiveProject`,当前页面不展示。 |-| `modelCounts` | `model` | 任意事件行只要 `model` 非空,就按原始模型名 `+1`。统计的是带模型字段的事件数,不是 token 数;未知事件也会计入。 | 合并后用于计算并展示「最热模型」。 |--读取旧 `daily.jsonl` 时,缺失的数字字段按 `0` 处理,缺失的 `projectCounts` / `modelCounts` 按空字典处理,缺失的 `sessionIds` / `turnIds` / `sessionCount` / `turnCount` 保持为 `nil`。维护 schema 升级到 `3` 后会把保留窗口内已有事件日期标记为 dirty,从原始事件重建模型计数;后续归一化仍按当前保留策略补齐或压缩 ID 字段。+| `daily.jsonl` 字段 | 从 `events/YYYY-MM-DD.jsonl` 读取什么 | 写入 / 更新规则 | 页面关系 |+| ------------------------ | ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |+| `date` | `timestamp` | Hook 写入时先把事件时间解析为绝对时间,再按当前本地时区格式化为 `yyyy-MM-dd` 选择日期文件。维护流程按当前处理的文件日期生成同名 `daily.jsonl` 行。早于最近 210 天保留窗口的日期不会进入聚合。 | 热力图日期键;详情面板日期。 |+| `eventCount` | 每条成功解码并保留下来的事件行 | 每处理一条事件就 `+1`,发生在具体事件类型判断之前。因此 `UserPromptSubmit`、未知 `event`、`tool: null`、`session: null` 等行都会计入,只要 `timestamp` 和 `event` 可解析。 | 进入 `WorkflowDailyMetrics.eventCount`,当前页面不展示。 |+| `sessionStartCount` | `event` | `event` 归一化后等于 `sessionstart` 时 `+1`。不要求 `session` 非空。 | 作为「会话总数」兜底来源。 |+| `stopCount` | `event` | `event` 归一化后等于 `stop` 时 `+1`。不要求 `turn` 非空。 | 作为「对话轮次」兜底来源。 |+| `preToolUseCount` | `event` | `event` 归一化后等于 `pretooluse` 时 `+1`。不读取 `tool` 做过滤,`tool` 为 `null` 也计入。 | 参与「调用工具」。 |+| `postToolUseCount` | `event` | `event` 归一化后等于 `posttooluse` 时 `+1`。不读取 `tool` 做过滤,`tool` 为 `null` 也计入。 | 参与「调用工具」。 |+| `permissionRequestCount` | `event` | `event` 归一化后等于 `permissionrequest` 时 `+1`。不读取 `permission` 字段做过滤,`permission` 只是记录当时的权限模式。 | 直接显示为「权限请求」。 |+| `preCompactCount` | `event` | `event` 归一化后等于 `precompact` 时 `+1`。 | 参与「上下文压缩」。 |+| `postCompactCount` | `event` | `event` 归一化后等于 `postcompact` 时 `+1`。 | 参与「上下文压缩」。 |+| `subagentStartCount` | `event` | `event` 归一化后等于 `subagentstart` 时 `+1`。 | 参与「子智能体」。 |+| `subagentStopCount` | `event` | `event` 归一化后等于 `subagentstop` 时 `+1`。 | 参与「子智能体」。 |+| `sessionIds` | `session` | 新建聚合初始化为 `[]`。最近 3 个本地自然日内,任意事件行只要 `session` 是非空字符串,就插入当天集合并去重、排序;不要求事件类型是 `SessionStart`。聚合结束后仍为空或进入窗口外压缩时写成 `null`;只有非空数组会持久化。 | 参与「会话总数」去重。 |+| `turnIds` | `turn` | 新建聚合初始化为 `[]`。最近 3 个本地自然日内,任意事件行只要 `turn` 是非空字符串,就插入当天集合并去重、排序;不要求事件类型是 `Stop`。聚合结束后仍为空或进入窗口外压缩时写成 `null`;只有非空数组会持久化。 | 参与「对话轮次」去重。 |+| `sessionCount` | `sessionIds`、旧 `sessionCount`、`sessionStartCount` | 最近 3 天通常为 `null`;日期进入 3 天外窗口后,归一化时优先沿用已有正数 `sessionCount`,否则使用非空 `sessionIds` 的去重数量,再否则使用 `sessionStartCount`,然后移除 `sessionIds`。空 ID 数组不表示权威的零;历史 `sessionCount == 0` 但 `sessionStartCount > 0` 时也会自动修复。 | 参与「会话总数」。 |+| `turnCount` | `turnIds`、旧 `turnCount`、`stopCount` | 最近 3 天通常为 `null`;日期进入 3 天外窗口后,归一化时优先沿用已有正数 `turnCount`,否则使用非空 `turnIds` 的去重数量,再否则使用 `stopCount`,然后移除 `turnIds`。空 ID 数组不表示权威的零;历史 `turnCount == 0` 但 `stopCount > 0` 时也会自动修复。 | 参与「对话轮次」。 |+| `projectCounts` | `cwd` | 任意事件行只要 `cwd` 非空,就取标准化路径的最后一层目录名作为项目名并 `+1`;如果最后一层为空,回退使用完整路径字符串。统计的是事件数,不是会话数或调用工具数。未知事件也会计入。 | 用于计算 `mostActiveProject`,当前页面不展示。 |+| `modelCounts` | `model` | 任意事件行只要 `model` 非空,就按原始模型名 `+1`。统计的是带模型字段的事件数,不是 token 数;未知事件也会计入。 | 合并后用于计算并展示「最热模型」。 |++读取旧 `daily.jsonl` 时,缺失的数字字段按 `0` 处理,缺失的 `projectCounts` / `modelCounts` 按空字典处理,缺失的 `sessionIds` / `turnIds` / `sessionCount` / `turnCount` 保持为 `nil`。维护 schema 升级到 `3` 后会把保留窗口内已有事件日期标记为 dirty,从原始事件重建模型计数;后续归一化仍按当前保留策略补齐或压缩 ID 字段,并把由空 ID 数组错误压缩出的零计数修复为起止事件兜底值。UI 不直接展示所有原始字段,而是先生成 `WorkflowDailyMetrics`:-| 页面展示名 | 生成规则 |-| ---------- | ------------------------------------------------------- |-| 会话总数 | `sessionCount ?? sessionIds.count ?? sessionStartCount` |-| 对话轮次 | `turnCount ?? turnIds.count ?? stopCount` |-| 子智能体 | `max(subagentStartCount, subagentStopCount)` |-| 调用工具 | `max(preToolUseCount, postToolUseCount)` |-| 权限请求 | `permissionRequestCount` |-| 上下文压缩 | `max(preCompactCount, postCompactCount)` |-| 最热模型 | 合并 `modelCounts` 后取计数最高的模型;并列时按名称升序 |+| 页面展示名 | 生成规则 |+| ---------- | ------------------------------------------------------------------------------- |+| 会话总数 | 正数 `sessionCount`,否则非空 `sessionIds` 的去重数量,否则 `sessionStartCount` |+| 对话轮次 | 正数 `turnCount`,否则非空 `turnIds` 的去重数量,否则 `stopCount` |+| 子智能体 | `max(subagentStartCount, subagentStopCount)` |+| 调用工具 | `max(preToolUseCount, postToolUseCount)` |+| 权限请求 | `permissionRequestCount` |+| 上下文压缩 | `max(preCompactCount, postCompactCount)` |+| 最热模型 | 合并 `modelCounts` 后取计数最高的模型;并列时按名称升序 |`eventCount` 和 `projectCounts` 保留在 daily 聚合中,但当前页面不展示。`UserPromptSubmit` 和未知事件不会增加上述 6 个计数指标,只会进入 `eventCount`;有 `cwd` 时进入 `projectCounts`,有 `model` 时进入 `modelCounts`。diff --git a/Docs/CrossDeviceSync.md b/Docs/CrossDeviceSync.mdindex 6d2a9ae..71476de 100644--- a/Docs/CrossDeviceSync.md+++ b/Docs/CrossDeviceSync.md@@ -65,7 +65,7 @@ Sync/cursor.data```json{- "schema": 2,+ "schema": 3,"deviceId": "<当前设备在当前 iCloud 账号下的匿名设备 ID>","hashByDate": {"2026-06-25": "<脱敏 daily 聚合的 SHA256>"@@ -95,7 +95,7 @@ zoneName = CodexBarZonerecordType = CodexBarSyncMetadatarecordName = accountSaltfields:- schemaVersion: Int+ schemaVersion: 3salt: Data(32 bytes)```@@ -105,7 +105,7 @@ fields:recordType = CodexBarDailyAggregaterecordName = <deviceId>_<yyyy-MM-dd>fields:- schemaVersion: Int+ schemaVersion: 3deviceId: Stringdate: StringeventCount: Int@@ -143,7 +143,7 @@ deviceId = HMAC_SHA256(accountSalt, IOPlatformUUID)- 同一台 Mac 切换 iCloud 账号后会得到不同的 `deviceId`- CloudKit 中不会保存原始 `IOPlatformUUID`-如果本地 `state.json` 的 `schema` 和当前代码不一致,服务会丢弃旧同步状态。下一轮同步会按当前设备重新写入 `state.json`,清空旧 `cache.jsonl` / `cursor.data`,再从 `CodexBarZone` 重建缓存。当前 iCloud sync state schema 为 `2`。+如果本地 `state.json` 的 `schema` 和当前代码不一致,服务会丢弃旧同步状态。下一轮同步会按当前设备重新写入 `state.json`,清空旧 `cache.jsonl` / `cursor.data`,再从 `CodexBarZone` 重建缓存。当前 iCloud sync state schema 为 `3`;从 schema `2` 升级时会重新上传本机 daily,用修复后的会话和轮次计数覆盖历史错误的明确 `0`。如果本地 `state.json` 中的 `deviceId` 和当前解析出的 `deviceId` 不一致,说明 iCloud 账号或账号级 salt 已变化。此时同步服务会重置本地同步状态,清空 `cache.jsonl`,并删除 `cursor.data`,然后按新账号重新同步。@@ -276,10 +276,13 @@ CodexBar.workflowSyncDidFinish- 保留 `modelCounts`- 不包含 `sessionIds`- 不包含 `turnIds`-- 如果本机还有 `sessionIds`,会把去重数量写入 `sessionCount`-- 如果本机还有 `turnIds`,会把去重数量写入 `turnCount`+- 优先把本机已有的正数 `sessionCount` / `turnCount` 写入同步副本+- 如果没有正数压缩 count,但本机还有非空 `sessionIds` / `turnIds`,会把去重数量写入对应 count+- 如果两者都没有,对应同步 count 为 `null`,不会上传空数组得到的 `0`-本机 `daily.jsonl` 不会因为上传而被改写。也就是说,最近 3 个本地自然日的 `sessionIds` / `turnIds` 仍然只保存在本机,用于本机精确去重。+明确的 `sessionCount == 0` / `turnCount == 0` 如果分别与正数 `sessionStartCount` / `stopCount` 冲突,会被视为旧版空数组压缩产生的不一致值;上传源会在本地归一化时修复。接收端不恢复 ID,生成 `WorkflowDailyMetrics` 时使用「正数 `sessionCount`,否则 `sessionStartCount`」和「正数 `turnCount`,否则 `stopCount`」,所以在云端记录被覆盖前也能立即正确展示。真正没有会话或轮次的日期因为起止事件计数同样为 `0`,最终仍显示为 `0`。++本机 `daily.jsonl` 不会因为上传而被改写。也就是说,最近 3 个本地自然日实际收集到的非空 `sessionIds` / `turnIds` 仍然只保存在本机,用于本机精确去重。## 待上传日期选择@@ -368,6 +371,9 @@ UI 展示使用 `WorkflowSnapshot`。合并规则是:同一天多设备数据相加时,会先把每台设备的 daily aggregate 转成 `WorkflowDailyMetrics`,再按日期求和:+- 本机 daily 的会话/轮次按「正数压缩 count → 非空 ID 去重数量 → 起止事件计数」解析+- 同步 daily 不含 ID,按「正数压缩 count → 起止事件计数」解析+```textsessionCount += other.sessionCountturnCount += other.turnCountdiff --git a/Docs/DevelopmentGuide.md b/Docs/DevelopmentGuide.mdindex df4fc5f..4b04621 100644--- a/Docs/DevelopmentGuide.md+++ b/Docs/DevelopmentGuide.md@@ -797,7 +797,7 @@ sequenceDiagram| `tool_name` | `tool` || `model` | `model` || `permission_mode` | `permission` |-| `transcript_path` | `approval`;仅提取匹配 turn 的 reviewer |+| `transcript_path` | `approval`;仅提取匹配 turn 的 reviewer || `session_id` | `session` || `turn_id` | `turn` |@@ -868,26 +868,31 @@ flowchart TD- 事件名先去掉 `_` 和 `-`, 再转小写- `sessionStartCount`, `stopCount`, `preToolUseCount` 等按归一化事件名增加- 任意有效事件中的非空 `model` 按模型名累加到 `modelCounts`-- 最近 3 个本地自然日保留 `sessionIds` 和 `turnIds`, 用于继续去重+- 最近 3 个本地自然日只持久化非空 `sessionIds` 和 `turnIds`, 用于继续去重+- 新建聚合的 ID 数组从 `[]` 开始;聚合结束后仍为空时规范化为 `nil`,只有非空 ID 数组会持久化- 3 天前把 ID 集合压缩为 `sessionCount` 和 `turnCount`, 随后移除 ID 列表+- 压缩和展示时只有正数 count 或非空 ID 集合可以优先于起止事件计数;空 ID 数组以及与正数起止事件冲突的零 count 按缺失处理+- 本机聚合和同步聚合共享 `WorkflowCountResolution`; 同步聚合不含 ID,因此直接按正数 count、起止事件计数的顺序解析- 最多保留最近 210 天数据- 210 天外的 `events/YYYY-MM-DD.jsonl` 在主 App 维护流程中删除- 坏 JSONL 行跳过并计入 `corrupt`, 不阻断整天聚合UI 展示指标来自 `WorkflowDailyAggregate.metrics`:-| UI 字段 | 生成规则 |-| ---------- | ------------------------------------------------------- |-| 会话总数 | `sessionCount ?? sessionIds.count ?? sessionStartCount` |-| 对话轮次 | `turnCount ?? turnIds.count ?? stopCount` |-| 子智能体 | `max(subagentStartCount, subagentStopCount)` |-| 调用工具 | `max(preToolUseCount, postToolUseCount)` |-| 权限请求 | `permissionRequestCount` |-| 上下文压缩 | `max(preCompactCount, postCompactCount)` |-| 最热模型 | 合并 `modelCounts` 后取计数最高的模型, 并列时按名称升序 |+| UI 字段 | 生成规则 |+| ---------- | ------------------------------------------------------------------------------- |+| 会话总数 | 正数 `sessionCount`,否则非空 `sessionIds` 的去重数量,否则 `sessionStartCount` |+| 对话轮次 | 正数 `turnCount`,否则非空 `turnIds` 的去重数量,否则 `stopCount` |+| 子智能体 | `max(subagentStartCount, subagentStopCount)` |+| 调用工具 | `max(preToolUseCount, postToolUseCount)` |+| 权限请求 | `permissionRequestCount` |+| 上下文压缩 | `max(preCompactCount, postCompactCount)` |+| 最热模型 | 合并 `modelCounts` 后取计数最高的模型, 并列时按名称升序 |跨设备同步只在 `performMaintenance: true, synchronize: true` 的刷新中执行。`WorkflowSyncScheduler` 会合并同步开关、Hook 重新开启、同步账号恢复可用和自动刷新产生的同步请求;同步中不取消重启, 冷却窗口内只保留一次待补跑请求, 补跑前重新校验 Hook 开启、跨设备同步偏好为 true 且同步账号可用。`WorkflowSyncService` 先用本机 daily 聚合生成脱敏 `WorkflowSyncedDailyAggregate`, 保留 `projectCounts` 和 `modelCounts`, 再按日期稳定排序候选项, 每批最多上传 25 天, 每轮最多使用 20 秒。zone 存在性确认和 account salt 首次成功后在 actor 内跨轮缓存, 任一轮同步失败时作废, 下一轮重新确认(覆盖 iCloud 账号切换)。每批成功后立即保存 `state.hashByDate` 和 `lastUploadAt`, 未完成的 backfill 留给后续自动刷新继续。没有 `cursor.data` 时先 query 全量 `CodexBarDailyAggregate` 回填 `cache.jsonl`; 有游标时优先拉 CloudKit 增量, 游标失效或增量失败时不写入日志窗口, 直接全量重建缓存。写入 `cache.jsonl` 前会过滤当前设备自己的记录, 只保留其他设备记录。增量路径先写 `cache.jsonl`, 成功后再写 `cursor.data`, 避免游标提前推进导致未落盘记录被跳过。同步失败会通过 `CodexBar.workflowSyncDidFinish` 通知发送 `didSucceed=false` 和归类后的 `failureMessage`, 主面板同步图标进入失败态。+当前代码写入的 CloudKit `schemaVersion` 和本地同步 state schema 都是 `3`。本地 state 从 schema `2` 升级时会丢弃旧 hash 和游标基线,重新上传本机 daily,并从 custom zone 重建其他设备缓存,从而覆盖旧版空数组压缩产生的错误零 count。+## 13. 设置窗口流程设置窗口由 `SettingsWindowController` 打开, 内容是 `AppSettingsView`@@ -1107,13 +1112,13 @@ 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 具有精确耗时且耗时 ≥ 阈值 | 状态机按精确任务键对两种完成信号去重 |+| 通知 | 触发 | 去重键 |+| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |+| 额度低阈值 | 非 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 具有精确耗时且耗时 ≥ 阈值 | 状态机按精确任务键对两种完成信号去重 || 任务等待批准 | 同一 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\|账号\|过期时间\|提醒档位` |+| 重置机会临期 | 过期时间距今 ≤ 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/appcast.xml b/appcast.xmlindex 4d06f55..5f37196 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.7</title>+ <sparkle:version>45</sparkle:version>+ <sparkle:shortVersionString>3.3.7</sparkle:shortVersionString>+ <sparkle:minimumSystemVersion>15.0</sparkle:minimumSystemVersion>+ <sparkle:releaseNotesLink>https://codexbar.zabrian.app/notes#3.3.7</sparkle:releaseNotesLink>+ <pubDate>Wed, 15 Jul 2026 13:19:43 +0800</pubDate>+ <enclosure url="https://codexbar.zabrian.app/download/CodexBar-v3.3.7.dmg" sparkle:edSignature="OENHqBRBwEnuJKsqRm2xFTcF6s5VTFIYEfnseThCLDHuP4iepCRGqfu+/+ZpcjCm/ad97uo9m4XwfC7rxz0QAg==" length="4004319" type="application/octet-stream"/>+ </item><item><title>CodexBar.app 3.3.6</title><sparkle:version>44</sparkle:version>