Skip to content

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

fix: 修复历史工作流计数

Bob2411a34dea05
diff --git a/CodexBar.xcodeproj/project.pbxproj b/CodexBar.xcodeproj/project.pbxproj
index 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.swift
index 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, Identifiabl
var 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.swift
index 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 = 3
static let syncZoneName = "CodexBarZone"
static let saltByteCount = 32
static let recordFetchLimit = 200
@@ -917,7 +917,7 @@ nonisolated struct WorkflowSyncSnapshot: Equatable {
}
private nonisolated struct WorkflowSyncState: Codable, Equatable {
- static let currentSchema = 2
+ static let currentSchema = 3
var schema: Int
var deviceId: String?
diff --git a/Docs/CodexHook.md b/Docs/CodexHook.md
index 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 = CodexBarZone
recordType = CodexBarSyncMetadata
recordName = accountSalt
+schemaVersion = 3
salt = 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, turnIds
zoneName = CodexBarZone
recordType = CodexBarDailyAggregate
recordName = <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.md
index 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 = CodexBarZone
recordType = CodexBarSyncMetadata
recordName = accountSalt
fields:
- schemaVersion: Int
+ schemaVersion: 3
salt: Data(32 bytes)
```
@@ -105,7 +105,7 @@ fields:
recordType = CodexBarDailyAggregate
recordName = <deviceId>_<yyyy-MM-dd>
fields:
- schemaVersion: Int
+ schemaVersion: 3
deviceId: String
date: String
eventCount: 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 → 起止事件计数」解析
+
```text
sessionCount += other.sessionCount
turnCount += other.turnCount
diff --git a/Docs/DevelopmentGuide.md b/Docs/DevelopmentGuide.md
index 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.xml
index 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>