CodexBar 是一个 macOS 菜单栏应用,用于查看本机 Codex 账号状态、额度、Token 用量、详细统计信息
Swift appkitcodexcodex-clideveloper-toolsmacosmacos-appmenu-bar-appopenai-codexproductivityswiftswiftuiusage-tracker
fix: 修复 CloudKit 同步清理并发布 3.4.1
Bob6a2095276e39
diff --git a/CodexBar.xcodeproj/project.pbxproj b/CodexBar.xcodeproj/project.pbxprojindex 0a3ddda..aa7f8db 100644--- a/CodexBar.xcodeproj/project.pbxproj+++ b/CodexBar.xcodeproj/project.pbxproj@@ -274,7 +274,7 @@"CODE_SIGN_IDENTITY[sdk=macosx*]" = "Apple Development";CODE_SIGN_STYLE = Automatic;COMBINE_HIDPI_IMAGES = YES;- CURRENT_PROJECT_VERSION = 50;+ CURRENT_PROJECT_VERSION = 51;DEAD_CODE_STRIPPING = YES;DEVELOPMENT_TEAM = 4KJ362VJW5;ENABLE_APP_INTENTS_METADATA_GENERATION = NO;@@ -290,7 +290,7 @@"$(inherited)","@executable_path/../Frameworks",);- MARKETING_VERSION = 3.4.0;+ MARKETING_VERSION = 3.4.1;PRODUCT_BUNDLE_IDENTIFIER = app.zabrian.codexbar;PRODUCT_NAME = "$(TARGET_NAME)";REGISTER_APP_GROUPS = YES;@@ -313,7 +313,7 @@"CODE_SIGN_IDENTITY[sdk=macosx*]" = "Apple Development";CODE_SIGN_STYLE = Automatic;COMBINE_HIDPI_IMAGES = YES;- CURRENT_PROJECT_VERSION = 50;+ CURRENT_PROJECT_VERSION = 51;DEAD_CODE_STRIPPING = YES;DEVELOPMENT_TEAM = 4KJ362VJW5;ENABLE_APP_INTENTS_METADATA_GENERATION = NO;@@ -329,7 +329,7 @@"$(inherited)","@executable_path/../Frameworks",);- MARKETING_VERSION = 3.4.0;+ MARKETING_VERSION = 3.4.1;PRODUCT_BUNDLE_IDENTIFIER = app.zabrian.codexbar;PRODUCT_NAME = "$(TARGET_NAME)";PROVISIONING_PROFILE_SPECIFIER = "";diff --git a/CodexBar/Services/Notifications/CodexNotificationService.swift b/CodexBar/Services/Notifications/CodexNotificationService.swiftindex fd80966..c60d834 100644--- a/CodexBar/Services/Notifications/CodexNotificationService.swift+++ b/CodexBar/Services/Notifications/CodexNotificationService.swift@@ -582,7 +582,7 @@ nonisolated struct CodexNotificationContent: Equatable {static func creditExpiry(count: Int, expirationDate: Date) -> CodexNotificationContent {CodexNotificationContent(- title: "重置次数即将过期",+ title: "重置即将过期",body: "有 \(count) 个重置次数将于 \(CodexDateFormat.localDisplayString(from: expirationDate)) 过期")}diff --git a/CodexBar/Services/Workflow/WorkflowSyncService.swift b/CodexBar/Services/Workflow/WorkflowSyncService.swiftindex c398c29..c5abef0 100644--- a/CodexBar/Services/Workflow/WorkflowSyncService.swift+++ b/CodexBar/Services/Workflow/WorkflowSyncService.swift@@ -639,34 +639,43 @@ private extension WorkflowSyncService {return try Self.remoteDailyRecords(from: matches)}- func fetchExpiredCurrentDeviceRecordIDs(+ func fetchCurrentDeviceRecordIDsToPrune(deviceId: String,cutoffKey: String) async throws -> [CKRecord.ID] {let query = CKQuery(recordType: RecordTypes.dailyAggregate,predicate: NSPredicate(- format: "%K == %@ AND %K < %@",+ format: "%K == %@",FieldKeys.deviceId,- deviceId,- FieldKeys.date,- cutoffKey+ deviceId))- return try await fetchAllRecordMatches(matching: query).map { recordID, result in- _ = try result.get()- return recordID+ let currentDeviceMatches = try await fetchAllRecordMatches(+ matching: query,+ desiredKeys: [FieldKeys.date]+ )+ return try currentDeviceMatches.compactMap { recordID, result in+ let record = try result.get()+ guard let date = record[FieldKeys.date] as? String,+ WorkflowStorage.isValidDateKey(date) else {+ // 无法进入保留窗口比较的当前设备记录是异常数据, 一并清理+ return recordID+ }++ return date < cutoffKey ? recordID : nil}}func fetchAllRecordMatches(- matching query: CKQuery+ matching query: CKQuery,+ desiredKeys: [String]? = nil) async throws -> [(CKRecord.ID, Result<CKRecord, Error>)] {let firstPage = try await database.records(matching: query,inZoneWith: syncZoneID,- desiredKeys: nil,+ desiredKeys: desiredKeys,resultsLimit: Metrics.queryFetchLimit)var matches = firstPage.matchResults@@ -675,7 +684,7 @@ private extension WorkflowSyncService {while let currentCursor = cursor {let page = try await database.records(continuingMatchFrom: currentCursor,- desiredKeys: nil,+ desiredKeys: desiredKeys,resultsLimit: Metrics.queryFetchLimit)matches.append(contentsOf: page.matchResults)@@ -735,7 +744,7 @@ private extension WorkflowSyncService {let expiredDates = Set(state.hashByDate.keys.filter { $0 < cutoffKey })state.replacementDates.removeAll { $0 < cutoffKey }var recordIDs = try await Set(- fetchExpiredCurrentDeviceRecordIDs(+ fetchCurrentDeviceRecordIDsToPrune(deviceId: deviceId,cutoffKey: cutoffKey)diff --git a/Docs/CrossDeviceSync.md b/Docs/CrossDeviceSync.mdindex fe39576..2479c2d 100644--- a/Docs/CrossDeviceSync.md+++ b/Docs/CrossDeviceSync.md@@ -422,7 +422,7 @@ date < retentionCutoffDate其他设备的记录不会由本机删除。每台设备只负责清理自己上传的过期记录。-清理候选直接通过 CloudKit 按 `deviceId == 当前设备 && date < retentionCutoffDate` 分页查询,并使用查询结果中的完整 `CKRecord.ID` 分批删除。因此清理不依赖已经过滤过期行的 `cache.jsonl`,legacy 名称和 `<device>_<date>_<generation>` 名称都会进入删除请求。只有全部删除成功或返回 `unknownItem` 后才更新 `lastPrunedDate`;中途失败会在下一轮继续查询和幂等重试。+清理候选先通过 CloudKit 按 `deviceId == 当前设备` 分页查询,并通过 `desiredKeys` 只读取 `date` 字段,再在本地校验日期格式并按 `date < retentionCutoffDate` 过滤。CloudKit 的 `date` 是字符串字段,不在服务端使用范围比较;缺失 `date` 或不是合法 `yyyy-MM-dd` 的当前设备记录视为异常记录并一并删除。清理使用查询结果中的完整 `CKRecord.ID` 分批执行,不依赖已经过滤过期行的 `cache.jsonl`,legacy 名称和 `<device>_<date>_<generation>` 名称都会进入删除请求。只有全部删除成功或返回 `unknownItem` 后才更新 `lastPrunedDate`;中途失败会在下一轮继续查询和幂等重试。当前实现不会因为本机 `daily.jsonl` 删除了某个仍在 210 天窗口内的日期,就主动删除该日期对应的 CloudKit 记录。它会等到该记录超过 210 天保留窗口后再清理。diff --git a/Docs/DevelopmentGuide.md b/Docs/DevelopmentGuide.mdindex ee9748b..3def2af 100644--- a/Docs/DevelopmentGuide.md+++ b/Docs/DevelopmentGuide.md@@ -899,7 +899,7 @@ UI 展示指标来自 `WorkflowDailyAggregate.metrics`:| 上下文压缩 | `max(preCompactCount, postCompactCount)` || 最热模型 | 合并 `modelCounts` 后取计数最高的模型, 并列时按名称升序 |-跨设备同步只在 `performMaintenance: true, synchronize: true` 的刷新中执行。`WorkflowSyncScheduler` 会合并同步开关、Hook 重新开启、同步账号恢复可用和自动刷新产生的同步请求;同步中不取消重启, 冷却窗口内只保留一次待补跑请求, 补跑前重新校验 Hook 开启、跨设备同步偏好为 true 且同步账号可用。`WorkflowSyncService` 先用本机 daily 聚合生成脱敏 `WorkflowSyncedDailyAggregate`, 保留 `sourceGeneration`、`projectCounts` 和 `modelCounts`, 再为保留窗口内的全部本机日期计算稳定 hash、按日期稳定排序候选项, 每批最多上传 25 天, 每轮最多使用 20 秒。zone 存在性确认和 account salt 首次成功后在 actor 内跨轮缓存, 任一轮同步失败时作废, 下一轮重新确认(覆盖 iCloud 账号切换)。同步先刷新一次 CloudKit 缓存再决定上传:只在当前 `deviceId`、当前待上传日期内查找本机副本;同 generation 复用现有记录并按 `eventCount` 防倒退;没有 generation 的记录必须与本机全部同步业务字段完全一致才会被认作同一来源,即使两边 generation 都是 `nil` 也不能跳过内容比较;确认从空文件开始的新 generation 使用独立记录;来源不明确的非空替换在已有云端贡献时只确认保留云端,不自动上传为新贡献。每批处理后立即保存已经上传或确认保留的 `state.hashByDate`; 只有实际上传时更新 `lastUploadAt`, 未完成的 backfill 留给后续自动刷新继续。上传后再次拉取 CloudKit 变化。没有 `cursor.data` 时先 query 全量 `CodexBarDailyAggregate` 回填 `cache.jsonl`; 有游标时优先拉 CloudKit 增量, 游标失效或增量失败时不写入日志窗口, 直接全量重建缓存。删除变化只移除 cache 记录,不清除已确认 hash,所以外部删除不会在本机 daily 未变化时立即回传。`cache.jsonl` 按 record name 保存所有设备和 generation 的记录;展示时当前本机 generation 与同 generation 云端副本按 `eventCount` 择优,确认独立的其他 generation 与其他设备记录继续累加;来源不明确的替换继续使用已有云端记录。增量路径先写 `cache.jsonl`, 成功后再写 `cursor.data`, 避免游标提前推进导致未落盘记录被跳过。同步失败会通过 `CodexBar.workflowSyncDidFinish` 通知发送 `didSucceed=false` 和归类后的 `failureMessage`, 主面板同步图标进入失败态。+跨设备同步只在 `performMaintenance: true, synchronize: true` 的刷新中执行。`WorkflowSyncScheduler` 会合并同步开关、Hook 重新开启、同步账号恢复可用和自动刷新产生的同步请求;同步中不取消重启, 冷却窗口内只保留一次待补跑请求, 补跑前重新校验 Hook 开启、跨设备同步偏好为 true 且同步账号可用。`WorkflowSyncService` 先用本机 daily 聚合生成脱敏 `WorkflowSyncedDailyAggregate`, 保留 `sourceGeneration`、`projectCounts` 和 `modelCounts`, 再为保留窗口内的全部本机日期计算稳定 hash、按日期稳定排序候选项, 每批最多上传 25 天, 每轮最多使用 20 秒。zone 存在性确认和 account salt 首次成功后在 actor 内跨轮缓存, 任一轮同步失败时作废, 下一轮重新确认(覆盖 iCloud 账号切换)。同步先刷新一次 CloudKit 缓存再决定上传:只在当前 `deviceId`、当前待上传日期内查找本机副本;同 generation 复用现有记录并按 `eventCount` 防倒退;没有 generation 的记录必须与本机全部同步业务字段完全一致才会被认作同一来源,即使两边 generation 都是 `nil` 也不能跳过内容比较;确认从空文件开始的新 generation 使用独立记录;来源不明确的非空替换在已有云端贡献时只确认保留云端,不自动上传为新贡献。每批处理后立即保存已经上传或确认保留的 `state.hashByDate`; 只有实际上传时更新 `lastUploadAt`, 未完成的 backfill 留给后续自动刷新继续。上传后再次拉取 CloudKit 变化。没有 `cursor.data` 时先 query 全量 `CodexBarDailyAggregate` 回填 `cache.jsonl`; 有游标时优先拉 CloudKit 增量, 游标失效或增量失败时不写入日志窗口, 直接全量重建缓存。删除变化只移除 cache 记录,不清除已确认 hash,所以外部删除不会在本机 daily 未变化时立即回传。每天清理当前设备过期记录时,CloudKit 只按 `deviceId` 等值查询并只返回 `date` 字段;合法日期的保留窗口比较在本地完成,缺失或格式非法的当前设备记录作为异常记录删除。`cache.jsonl` 按 record name 保存所有设备和 generation 的记录;展示时当前本机 generation 与同 generation 云端副本按 `eventCount` 择优,确认独立的其他 generation 与其他设备记录继续累加;来源不明确的替换继续使用已有云端记录。增量路径先写 `cache.jsonl`, 成功后再写 `cursor.data`, 避免游标提前推进导致未落盘记录被跳过。同步失败会通过 `CodexBar.workflowSyncDidFinish` 通知发送 `didSucceed=false` 和归类后的 `failureMessage`, 主面板同步图标进入失败态。显式日期重建完成后, `WorkflowSyncService` 把实际重建日期写入 `state.replacementDates`, 清除对应日期的确认 hash, 并在快照合并时忽略当前设备这些日期的旧缓存。同步可用时先全量重建 CloudKit 缓存, 再分批删除当前设备对应日期的 legacy 和全部 generation 记录; 删除成功或返回 `unknownItem` 后从本地 cache 移除旧记录, 随后按正常上传流程写入本机新 generation。日期只有在新记录确认后才从 `replacementDates` 移除; 删除、上传或同步中途失败时保留请求并在后续同步幂等重试。其他设备和范围外日期不参与替换。diff --git a/appcast.xml b/appcast.xmlindex 4b89d72..8fc8efe 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.4.1</title>+ <sparkle:version>51</sparkle:version>+ <sparkle:shortVersionString>3.4.1</sparkle:shortVersionString>+ <sparkle:minimumSystemVersion>15.0</sparkle:minimumSystemVersion>+ <sparkle:releaseNotesLink>https://codexbar.zabrian.app/notes#3.4.1</sparkle:releaseNotesLink>+ <pubDate>Wed, 22 Jul 2026 11:10:11 +0800</pubDate>+ <enclosure url="https://codexbar.zabrian.app/download/CodexBar-v3.4.1.dmg" sparkle:edSignature="ET2yGbVBwxCYVtUGjyqMD4CxkEhHdtdigdsFdsvr3AZFnkohhltcwuM+mpl9LdKV6T2FdL1vm3N9Rf4NMwNtBA==" length="4177727" type="application/octet-stream"/>+ </item><item><title>CodexBar.app 3.4.0</title><sparkle:version>50</sparkle:version>