Skip to content

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

fix: 修复 CloudKit 同步清理并发布 3.4.1

Bob6a2095276e39
diff --git a/CodexBar.xcodeproj/project.pbxproj b/CodexBar.xcodeproj/project.pbxproj
index 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.swift
index 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.swift
index 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.md
index 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.md
index 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.xml
index 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>