cc-pets 1.0.4 → 1.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -4,6 +4,28 @@
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
+ - 新增 Codex 与 Claude Code 本地 Token 用量统计,按官方重置时间对齐 5 小时与 7 天窗口;
8
+ Claude 侧按 `message.id + requestId` 去重,避免 `--resume`/fork 复制的记录重复计数。
9
+ 官方订阅额度仍以服务端百分比为准。
10
+ - Token 聚合改为增量跟读并按额度窗口节流,事件驱动的高频刷新不再重复扫描近 7 天会话;
11
+ 过期日期目录按目录名剪枝,无 Token 数据的会话文件缓存失败结果不再反复重读。
12
+ - 新开 Codex 会话时不再因为尚无 `rate_limits` 而清空面板上已知的额度。
13
+ - 修复状态气泡在任务完成后被打回"正在思考":`Stop` 之后仍会飘来 `SubagentStop` /
14
+ `PostToolUse` 等尾巴事件,它们与 `UserPromptSubmit` 归一成同一个状态,现按事件名拦截,
15
+ 终态只能被新一轮真实动作解除。
16
+ - 状态气泡新增"待机中":`正在启动` 超过 8 秒没有后续事件即落到待机,不再让启动态和
17
+ 空闲态显示成同一句"正在准备当前会话…"。
18
+ - 修复测试污染用户真实事件流:跑包装脚本的用例只隔离了 `TMPDIR`,而事件文件走
19
+ `NSTemporaryDirectory()` 不认它,每次跑测试都会写入 3 条 `SessionStart`,把正在运行的
20
+ 桌宠打回"正在启动"。相关用例补上 `CC_PETS_STATE_DIR`,并加了基线校验防止再犯。
21
+ - 修复额度卡片的在线徽章恒亮:此前按"有没有额度数据"判定,而额度会一直缓存,导致
22
+ 客户端早已退出、甚至单独打开 App 从未运行过 Agent 时两张卡片也显示在线。现改为按该
23
+ provider 是否还有存活客户端判定,并用事件活跃度覆盖不经包装脚本启动的会话。包装脚本
24
+ 启动的会话退出后 3 秒内转为"离线",不再被为直接启动会话准备的 60 秒静默宽限拖住。
25
+ - 额度面板调整信息层级:官方剩余百分比升为主值、本机 Token 降为次级;汇总条改为
26
+ 「今日」与「最近 7 天」双端 Token 合计——两家的 `resets_at` 并不一致,按各自订阅窗口
27
+ 算出的数不在同一区间上,改用与订阅无关的自然日窗口才可相加;"数据刷新"改由面板自身定时器走字;无 Agent 在线时
28
+ 状态配色转灰;额度窗口缺失的列标注"当前无活跃窗口"。
7
29
  - 新增 `cc-pets clean` 和带确认的 `cc-pets uninstall --purge`,并自动清理测试临时目录与过期运行状态。
8
30
  - 更新日志每次更新前截断,并限制为最近 1 MB,避免长期残留增长。
9
31
  - Codex/Claude 额度读取改为 FSEvents/VNODE 事件监听,并保留 120 秒容错刷新,降低空闲文件扫描与 JSON 解析。
@@ -36,6 +36,17 @@ printf '%s' '{
36
36
  建议工具类别使用 `shell`、`edit`、`write`、`read`、`search`、`web`、`mcp` 或
37
37
  `agent`。CC Pets 不会执行 `tool` 字段,也不会将其作为通知正文。
38
38
 
39
+ ## 状态显示规则
40
+
41
+ 事件到达顺序不一定等于语义顺序,气泡显示因此有两条额外规则:
42
+
43
+ - **终态具有黏性。** 进入 `completed` 或 `failed` 后,紧随其后的 `tool_completed`
44
+ (以及内部的 `SubagentStop`、`TaskCompleted`)不会改写气泡——这类尾巴事件常常在任务
45
+ 真正结束之后才到达。要解除终态,请发送 `thinking`、`tool`、`approval` 或
46
+ `notification` 等表示新一轮动作的状态。
47
+ - **`starting` 是短时态。** 超过 8 秒没有后续事件,气泡会自动落到"待机中",表示会话
48
+ 已就绪、正在等待输入。长时间的准备工作请显式发送 `thinking`,不要停留在 `starting`。
49
+
39
50
  ## 生命周期
40
51
 
41
52
  事件写入当前用户的临时状态目录,已经运行的 CC Pets 会立即读取。Provider 集成需要自行
package/README.md CHANGED
@@ -243,15 +243,42 @@ Codex 用量来自 `~/.codex/sessions` 的本地 `token_count` 事件:
243
243
  - `window_minutes = 300` 对应 5 小时额度
244
244
  - `window_minutes = 10080` 对应周额度
245
245
  - 桌宠将 `used_percent` 换算为剩余百分比后显示
246
+ - Codex 本地 Token 按服务端 `resets_at - window_minutes` 到 `resets_at` 聚合,
247
+ 与官方 5 小时和 7 天额度周期保持一致
248
+ - Token 统计包含输入、缓存输入、缓存写入、输出、推理输出与总量;面板展示总量
246
249
  - Codex 当前事件未提供某个额度窗口时显示 `--`,不会使用已过期的历史额度冒充当前值
247
250
 
248
251
  Claude 用量来自官方 status line 输入中的 `rate_limits.five_hour` 与
249
252
  `rate_limits.seven_day`。其中的 `used_percentage` 会换算为剩余百分比。该字段仅面向
250
253
  Claude.ai Pro/Max 订阅账号,并在会话完成首次 API 响应后出现;字段尚不可用时显示 `--`。
251
254
 
252
- 额度详情面板使用青色区分 Codex、紫色区分 Claude。5 小时剩余额度使用进度条,周剩余
253
- 额度使用环形进度,右侧展示对应的周重置时间。服务端的 Unix 时间戳会使用 Mac 当前系统时区格式化为
254
- `M/d HH:mm:ss`;因此它与 CLI 中标注其他时区的同一时刻可能日期和小时不同,但代表同一个真实时间。
255
+ Claude Code 本地 Token 来自 `~/.claude/projects` 下的会话转录(受 `CLAUDE_CONFIG_DIR`
256
+ 影响):
257
+
258
+ - 每条 `type = assistant` 的记录带 `message.usage`,是**单次请求的增量**,与 Codex 的
259
+ 会话累计值不同,因此按时间戳逐条落窗口累加
260
+ - 窗口同样对齐 `resets_at`;Claude 的 `rate_limits` 不含 `window_minutes`,窗长按官方
261
+ 订阅固定为 300 / 10080 分钟
262
+ - `--resume`、fork 和 compact 会把旧记录原样复制进新的转录文件,因此按
263
+ `message.id + requestId` 全局去重(两者缺失时回退行级 `uuid`),否则用量会明显虚高
264
+ - 统计包含输入、缓存读取、缓存写入、输出与总量;Claude 的思考 token 已计入
265
+ `output_tokens`,不单列推理项
266
+
267
+ 本地 Token 是 CLI 会话事件的原始计数,不等同于订阅额度。官方额度可能受模型、缓存和
268
+ 请求复杂度等因素影响,应始终以服务端返回的百分比为准。
269
+
270
+ 额度详情面板使用青色区分 Codex、紫色区分 Claude。标题行显示在线 Agent 数,下方汇总条
271
+ 展示「今日」与「最近 7 天」的双端 Token 合计和最近刷新时间。汇总用的是与订阅无关的
272
+ 自然日窗口(今日 = 本机零点至今,最近 7 天 = 含今天在内的 7 个自然日),因为两家的
273
+ `resets_at` 并不一致,按各自订阅窗口算出的数不在同一区间上,相加没有意义;每个 Agent 卡片按 5 小时和 7 天两列
274
+ 展示官方剩余百分比(主值)、本机 Token 用量和重置时间,右侧是近 7 天额度趋势。某个窗口
275
+ 当前没有额度数据时该列标注"当前无活跃窗口"。卡片上的在线徽章表示该 Provider 是否还有
276
+ 运行中的客户端(包装脚本写出的 pid 文件,或该 Provider 最近 60 秒内仍在发事件),与是否
277
+ 已采集到额度数据无关;客户端退出后显示"离线",从未采集到数据时显示"等待数据"。经
278
+ `codex-with-pet` / `claude-with-pet` 启动的会话退出后 3 秒内转为离线;直接运行 `codex` /
279
+ `claude` 时没有可靠的退出信号,最多需要 60 秒静默才会转为离线。服务端的 Unix 时间戳会使用 Mac 当前系统时区
280
+ 格式化为 `M/d HH:mm`;因此它与 CLI 中标注其他时区的同一时刻可能日期和小时不同,但代表
281
+ 同一个真实时间。
255
282
  应用通过文件事件实时读取额度,并保留 120 秒容错刷新;右上角刷新按钮也可立即读取本地数据。Codex 数据随本地 session 更新,Claude 数据则要等 Claude Code
256
283
  下一次把 `rate_limits` 传给 status line 后才会变化,按钮不会主动请求 Claude 服务端。
257
284
  面板使用原生 AppKit 毛玻璃材质,以紧凑悬浮卡片形式显示在桌宠左上方,并优先使用本机官方 Codex、Claude 应用
@@ -22,6 +22,9 @@
22
22
  @property NSString *lastStatusProvider;
23
23
  @property NSTimeInterval lastStatusTimestamp;
24
24
  @property NSSet<NSString *> *liveClientProviders;
25
+ // 每个 provider 最近一次事件的时间。不经包装脚本启动的客户端没有 pid 文件,
26
+ // 只能靠"最近还在发事件"证明自己活着。
27
+ @property NSMutableDictionary<NSString *, NSNumber *> *providerActivityAt;
25
28
  @property BOOL hasUnlabeledClient;
26
29
  @property NSMutableDictionary<NSString *, NSDictionary *> *pendingApprovalRecords;
27
30
  @property QuotaDashboardView *quotaView;
@@ -40,6 +43,7 @@
40
43
  @property BOOL updating;
41
44
  @property NSTask *updateTask;
42
45
  @property NSTimer *usageTimer;
46
+ @property NSTimer *quotaClockTimer;
43
47
  - (void)showQuotaDashboard;
44
48
  - (void)positionQuotaDashboard;
45
49
  - (void)scheduleQuotaDashboardHide;
@@ -296,6 +296,7 @@ static void TrimUpdateLog(NSString *path) {
296
296
  }
297
297
  - (NSString *)statusTextForState:(NSString *)state tool:(NSString *)tool {
298
298
  if ([state isEqualToString:@"starting"]) return @"正在启动";
299
+ if ([state isEqualToString:@"idle"]) return @"待机中";
299
300
  if ([state isEqualToString:@"thinking"]) return @"正在思考";
300
301
  if ([state isEqualToString:@"auto_review"]) return @"自动审批中";
301
302
  if ([state isEqualToString:@"approval"]) return @"等待审批";
@@ -322,6 +323,7 @@ static void TrimUpdateLog(NSString *path) {
322
323
  }
323
324
  - (NSString *)statusDetailForState:(NSString *)state {
324
325
  if ([state isEqualToString:@"starting"]) return @"正在准备当前会话…";
326
+ if ([state isEqualToString:@"idle"]) return @"会话已就绪,等待你的下一条指令。";
325
327
  if ([state isEqualToString:@"thinking"]) return @"正在分析请求…";
326
328
  if ([state isEqualToString:@"auto_review"]) return @"正在由 Auto-review 审核,无需手动操作。";
327
329
  if ([state isEqualToString:@"approval"]) return @"请回到终端确认操作。";
@@ -344,12 +346,15 @@ static void TrimUpdateLog(NSString *path) {
344
346
  if ([state isEqualToString:@"approval"] || [state isEqualToString:@"notification"]) {
345
347
  return [NSColor colorWithRed:0.92 green:0.58 blue:0.12 alpha:1];
346
348
  }
349
+ // 待机是"没在干活",用中性灰和工作中的蓝拉开距离。
350
+ if ([state isEqualToString:@"idle"]) return [NSColor colorWithWhite:0.55 alpha:1];
347
351
  return [NSColor colorWithRed:0.33 green:0.53 blue:0.78 alpha:1];
348
352
  }
349
353
  - (NSString *)statusSymbolForState:(NSString *)state {
350
354
  if ([state isEqualToString:@"completed"] || [state isEqualToString:@"tool_completed"]) return @"checkmark";
351
355
  if ([state isEqualToString:@"failed"] || [state isEqualToString:@"tool_failed"]) return @"xmark";
352
356
  if ([state isEqualToString:@"approval"] || [state isEqualToString:@"notification"]) return @"exclamationmark";
357
+ if ([state isEqualToString:@"idle"]) return @"zzz";
353
358
  return @"ellipsis";
354
359
  }
355
360
  - (void)updateStatusToggleAppearance {
@@ -389,6 +394,8 @@ static void TrimUpdateLog(NSString *path) {
389
394
  [self hideAgentStatus];
390
395
  }
391
396
  - (void)hideAgentStatus {
397
+ [NSObject cancelPreviousPerformRequestsWithTarget:self
398
+ selector:@selector(enterIdleStatus) object:nil];
392
399
  [self.statusPanel orderOut:nil];
393
400
  [self.statusTogglePanel orderOut:nil];
394
401
  self.hasAgentStatus = NO;
@@ -407,18 +414,20 @@ static void TrimUpdateLog(NSString *path) {
407
414
  [self updateStatusToggleAppearance];
408
415
  [self.statusTogglePanel orderFrontRegardless];
409
416
  }
410
- - (void)showAgentStatusForRecord:(NSDictionary *)record notify:(BOOL)shouldNotify {
411
- [NSObject cancelPreviousPerformRequestsWithTarget:self
412
- selector:@selector(hideAgentStatus) object:nil];
413
- NSString *provider = SanitizedShortString(record[@"provider"], 32);
414
- if (provider.length == 0) provider = @"Agent";
415
- NSString *state = [record[@"state"] isKindOfClass:NSString.class]
416
- ? record[@"state"] : NormalizedStateForEvent(record[@"event"], [record[@"failed"] boolValue]);
417
- NSString *tool = [record[@"tool"] isKindOfClass:NSString.class] ? record[@"tool"] : @"";
418
- self.hasAgentStatus = YES;
417
+ // Stop 之后还会飘来 SubagentStop / PostToolUse / TaskCompleted 这类"仍在工作"的尾巴事件
418
+ // (实测 Stop 后 4 秒),它们和 UserPromptSubmit 一样都归一成 thinking,只看 state 分不出来,
419
+ // 所以必须按事件名判断。终态只能被新一轮真实动作解除(用户提问、工具调用、需要关注),
420
+ // 否则"任务已完成"会被打回"正在思考",看起来像任务又活了。
421
+ - (BOOL)isTrailingRecord:(NSDictionary *)record afterState:(NSString *)state {
422
+ if (![state isEqualToString:@"completed"] && ![state isEqualToString:@"failed"]) return NO;
423
+ NSString *event = [record[@"event"] isKindOfClass:NSString.class] ? record[@"event"] : @"";
424
+ return [event isEqualToString:@"SubagentStop"] || [event isEqualToString:@"PostToolUse"] ||
425
+ [event isEqualToString:@"TaskCompleted"];
426
+ }
427
+ - (void)applyStatusPresentationForState:(NSString *)state provider:(NSString *)provider
428
+ tool:(NSString *)tool {
419
429
  self.lastStatusState = state;
420
430
  self.lastStatusProvider = provider;
421
- self.lastStatusTimestamp = [NSDate.date timeIntervalSince1970];
422
431
  self.statusTitleLabel.stringValue = [NSString stringWithFormat:@"%@ · %@",
423
432
  provider, [self statusTextForState:state tool:tool]];
424
433
  self.statusDetailLabel.stringValue = [self statusDetailForState:state];
@@ -435,9 +444,41 @@ static void TrimUpdateLog(NSString *path) {
435
444
  else [self.statusPanel orderOut:nil];
436
445
  [self updateStatusToggleAppearance];
437
446
  [self.statusTogglePanel orderFrontRegardless];
447
+ }
448
+ // "正在启动"只在会话拉起的一瞬间成立。之后如果没有任何后续事件,真实情况是会话已就绪、
449
+ // 正在等用户输入——继续显示"正在准备当前会话…"会让启动和待机看起来一模一样。
450
+ - (void)enterIdleStatus {
451
+ if (!self.hasAgentStatus) return;
452
+ [self applyStatusPresentationForState:@"idle"
453
+ provider:self.lastStatusProvider ?: @"Agent" tool:@""];
454
+ }
455
+ - (void)showAgentStatusForRecord:(NSDictionary *)record notify:(BOOL)shouldNotify {
456
+ NSString *provider = SanitizedShortString(record[@"provider"], 32);
457
+ if (provider.length == 0) provider = @"Agent";
458
+ NSString *state = [record[@"state"] isKindOfClass:NSString.class]
459
+ ? record[@"state"] : NormalizedStateForEvent(record[@"event"], [record[@"failed"] boolValue]);
460
+ NSString *tool = [record[@"tool"] isKindOfClass:NSString.class] ? record[@"tool"] : @"";
461
+ // 尾巴事件仍然算"客户端还活着",只是不该改写气泡上的终态。
462
+ self.lastStatusTimestamp = [NSDate.date timeIntervalSince1970];
463
+ if (!self.providerActivityAt) self.providerActivityAt = [NSMutableDictionary dictionary];
464
+ self.providerActivityAt[provider] = @(self.lastStatusTimestamp);
465
+ [self updateQuotaLiveState];
466
+ if (self.hasAgentStatus && [provider isEqualToString:self.lastStatusProvider] &&
467
+ [self isTrailingRecord:record afterState:self.lastStatusState]) return;
468
+
469
+ [NSObject cancelPreviousPerformRequestsWithTarget:self
470
+ selector:@selector(hideAgentStatus) object:nil];
471
+ [NSObject cancelPreviousPerformRequestsWithTarget:self
472
+ selector:@selector(enterIdleStatus) object:nil];
473
+ self.hasAgentStatus = YES;
474
+ [self applyStatusPresentationForState:state provider:provider tool:tool];
438
475
  [self.panel orderFrontRegardless];
439
476
  [self performSelector:@selector(hideAgentStatus)
440
477
  withObject:nil afterDelay:AgentStatusInactivityInterval];
478
+ if ([state isEqualToString:@"starting"]) {
479
+ [self performSelector:@selector(enterIdleStatus) withObject:nil
480
+ afterDelay:AgentStartingGraceInterval];
481
+ }
441
482
  if (shouldNotify) [self notifyForRecord:record];
442
483
  }
443
484
  - (void)showAgentStatusForRecord:(NSDictionary *)record {
@@ -904,6 +945,23 @@ static void TrimUpdateLog(NSString *path) {
904
945
  [self.quotaPanel orderFrontRegardless];
905
946
  [self.panel orderFrontRegardless];
906
947
  [self rescheduleUsageTimer];
948
+ [self startQuotaClock];
949
+ }
950
+ // "数据刷新" 显示的是相对时间,没有新数据也得自己走字。面板隐藏时不需要这个定时器,
951
+ // 隐藏的窗口本来就不会重绘。
952
+ - (void)startQuotaClock {
953
+ if (self.quotaClockTimer.isValid) return;
954
+ self.quotaClockTimer = [NSTimer scheduledTimerWithTimeInterval:QuotaClockInterval
955
+ target:self selector:@selector(tickQuotaClock:) userInfo:nil repeats:YES];
956
+ self.quotaClockTimer.tolerance = QuotaClockInterval * 0.3;
957
+ }
958
+ - (void)tickQuotaClock:(id)sender {
959
+ if (!self.quotaPanel.isVisible) {
960
+ [self.quotaClockTimer invalidate];
961
+ self.quotaClockTimer = nil;
962
+ return;
963
+ }
964
+ self.quotaView.needsDisplay = YES;
907
965
  }
908
966
  - (void)positionQuotaDashboard {
909
967
  NSRect petFrame = self.panel.frame;
@@ -951,6 +1009,8 @@ static void TrimUpdateLog(NSString *path) {
951
1009
  if (!self.pocketHovering && !self.dashboardHovering && !self.petDragging) {
952
1010
  [self.quotaPanel orderOut:nil];
953
1011
  [self rescheduleUsageTimer];
1012
+ [self.quotaClockTimer invalidate];
1013
+ self.quotaClockTimer = nil;
954
1014
  }
955
1015
  }
956
1016
  - (void)switchPetToID:(NSString *)petID {
@@ -1100,6 +1160,25 @@ static void TrimUpdateLog(NSString *path) {
1100
1160
  - (void)ensureAgentEventReader:(id)sender {
1101
1161
  if (!self.agentEventSource) [self startAgentEventReader];
1102
1162
  }
1163
+ // 在线判定合并两个信号:包装脚本写出的客户端 pid 文件,以及该 provider 最近是否还在
1164
+ // 发事件。只看前者会把直接跑 claude / codex 的会话误判成离线;只看后者则在客户端退出后
1165
+ // 还要挂满一整个静默窗口。额度数据本身不是在线信号——它一直缓存着,用它判定会恒亮。
1166
+ - (void)updateQuotaLiveState {
1167
+ NSMutableSet<NSString *> *online = [self.liveClientProviders mutableCopy] ?: [NSMutableSet set];
1168
+ NSTimeInterval now = NSDate.date.timeIntervalSince1970;
1169
+ for (NSString *provider in self.providerActivityAt) {
1170
+ NSTimeInterval last = [self.providerActivityAt[provider] doubleValue];
1171
+ if (now - last < AgentStatusInactivityInterval) [online addObject:provider];
1172
+ }
1173
+ NSInteger count = MAX(self.liveClientCount, (NSInteger)online.count);
1174
+ if (self.quotaView.activeAgentCount == count &&
1175
+ [self.quotaView.liveProviders isEqualToSet:online] &&
1176
+ self.quotaView.hasUnlabeledClient == self.hasUnlabeledClient) return;
1177
+ self.quotaView.activeAgentCount = count;
1178
+ self.quotaView.liveProviders = online;
1179
+ self.quotaView.hasUnlabeledClient = self.hasUnlabeledClient;
1180
+ self.quotaView.needsDisplay = YES;
1181
+ }
1103
1182
  - (void)refreshClientLifecycle:(id)sender {
1104
1183
  [self prunePendingApprovalRecords];
1105
1184
  NSString *clientName = [NSString stringWithFormat:@"cc-pets-%u-clients", getuid()];
@@ -1125,9 +1204,20 @@ static void TrimUpdateLog(NSString *path) {
1125
1204
  if (label.length > 0 && label.length <= 32) [providers addObject:label];
1126
1205
  else unlabeled = YES;
1127
1206
  }
1207
+ // 包装脚本启动的客户端有精确的退出信号:pid 文件被回收。这一段不该被为"直接跑
1208
+ // claude / codex"准备的 60 秒活跃度宽限盖住,否则退出后还要挂满一分钟才转离线。
1209
+ // 因此某一家的 pid 文件一旦从有变无,立刻丢掉它的活跃度记录;从来没有过 pid 文件
1210
+ // 的(直接启动)不受影响,继续走宽限。
1211
+ NSSet<NSString *> *previousProviders = self.liveClientProviders;
1128
1212
  self.liveClientCount = liveClients;
1129
1213
  self.liveClientProviders = providers;
1130
1214
  self.hasUnlabeledClient = unlabeled;
1215
+ for (NSString *provider in previousProviders) {
1216
+ if (![providers containsObject:provider]) {
1217
+ [self.providerActivityAt removeObjectForKey:provider];
1218
+ }
1219
+ }
1220
+ [self updateQuotaLiveState];
1131
1221
  [self hideAgentStatusIfClientGone];
1132
1222
  if (self.statusTogglePanel.isVisible && !self.statusBubbleExpanded) {
1133
1223
  [self updateStatusToggleAppearance];
@@ -1143,6 +1233,7 @@ static void TrimUpdateLog(NSString *path) {
1143
1233
  self.quotaView.claudeUsage);
1144
1234
  self.quotaView.codexHistory = QuotaHistorySeries(history, @"codex");
1145
1235
  self.quotaView.claudeHistory = QuotaHistorySeries(history, @"claude");
1236
+ self.quotaView.lastUpdatedAt = NSDate.date.timeIntervalSince1970;
1146
1237
  self.quotaView.needsDisplay = YES;
1147
1238
  }
1148
1239
  - (void)refreshUsage:(id)sender {
@@ -16,8 +16,10 @@ extern NSString *const StatusBubblePreferenceV2Key;
16
16
 
17
17
  extern const NSTimeInterval AgentStatusInactivityInterval;
18
18
  extern const NSTimeInterval AgentStatusOrphanInterval;
19
+ extern const NSTimeInterval AgentStartingGraceInterval;
19
20
  extern const NSTimeInterval UsageRefreshIntervalVisible;
20
21
  extern const NSTimeInterval UsageRefreshIntervalHidden;
21
22
  extern const NSTimeInterval ClientLifecycleInterval;
23
+ extern const NSTimeInterval QuotaClockInterval;
22
24
  extern const NSTimeInterval AgentEventReaderCheckInterval;
23
25
  extern const NSTimeInterval PetFrameInterval;
@@ -38,11 +38,16 @@ const NSTimeInterval AgentStatusInactivityInterval = 60.0;
38
38
  // 留这段宽限是因为不经包装脚本启动的客户端(直接跑 claude / codex)没有 pid
39
39
  // 文件,只能靠"最近还在发事件"证明自己活着,不能一看不到 pid 文件就清掉。
40
40
  const NSTimeInterval AgentStatusOrphanInterval = 10.0;
41
+ // "正在启动"只在会话拉起的一瞬间成立。超过这段还没有任何后续事件,说明会话已经就绪、
42
+ // 正在等用户输入,气泡应当落到"待机中",否则启动态和空闲态看起来完全一样。
43
+ const NSTimeInterval AgentStartingGraceInterval = 8.0;
41
44
  // 额度变化由 FSEvents/VNODE 主动推送;定时器只保留为监听不可用时的 120 秒兜底。
42
45
  // 打开面板和手动刷新仍会立即读取一次。
43
46
  const NSTimeInterval UsageRefreshIntervalVisible = 120.0;
44
47
  const NSTimeInterval UsageRefreshIntervalHidden = 120.0;
45
48
  const NSTimeInterval ClientLifecycleInterval = 3.0;
49
+ // 面板上"数据刷新"是相对时间,仅在面板可见时按这个间隔重绘走字。
50
+ const NSTimeInterval QuotaClockInterval = 10.0;
46
51
  const NSTimeInterval AgentEventReaderCheckInterval = 5.0;
47
52
  // 精灵动画帧间隔。定时器的 tolerance 让内核可以合并唤醒。
48
53
  const NSTimeInterval PetFrameInterval = 0.22;
@@ -12,15 +12,33 @@ int RenderQuotaDashboard(NSString *path) {
12
12
  view.claudeLogo = OfficialAppIcon(@"com.anthropic.claudefordesktop", @"electron.icns");
13
13
  view.codexUsage = LatestUsage() ?: @{
14
14
  @"fiveHour": @{@"used_percent": @34, @"resets_at": @([NSDate.date timeIntervalSince1970] + 7200)},
15
- @"week": @{@"used_percent": @51, @"resets_at": @([NSDate.date timeIntervalSince1970] + 172800)}
15
+ @"week": @{@"used_percent": @51, @"resets_at": @([NSDate.date timeIntervalSince1970] + 172800)},
16
+ @"tokenUsage": @{
17
+ @"fiveHour": @{@"total_tokens": @1284000},
18
+ @"week": @{@"total_tokens": @8642000},
19
+ @"today": @{@"total_tokens": @2140000},
20
+ @"recentWeek": @{@"total_tokens": @8980000},
21
+ @"source": @"local"
22
+ }
16
23
  };
17
24
  view.claudeUsage = LatestClaudeUsage() ?: @{
18
25
  @"fiveHour": @{@"used_percentage": @23, @"resets_at": @([NSDate.date timeIntervalSince1970] + 3600)},
19
- @"week": @{@"used_percentage": @41, @"resets_at": @([NSDate.date timeIntervalSince1970] + 86400)}
26
+ @"week": @{@"used_percentage": @41, @"resets_at": @([NSDate.date timeIntervalSince1970] + 86400)},
27
+ @"tokenUsage": @{
28
+ @"fiveHour": @{@"total_tokens": @962000},
29
+ @"week": @{@"total_tokens": @5310000},
30
+ @"today": @{@"total_tokens": @1470000},
31
+ @"recentWeek": @{@"total_tokens": @5620000},
32
+ @"source": @"local"
33
+ }
20
34
  };
21
35
  view.historyEnabled = YES;
22
36
  view.codexHistory = @[@88, @81, @75, @68, @62, @55, @49];
23
37
  view.claudeHistory = @[@92, @86, @78, @72, @64, @58, @51];
38
+ view.activeAgentCount = 1;
39
+ // 预览里刻意只让一家在线,好把"有额度数据但客户端已退出"的离线态也画出来。
40
+ view.liveProviders = [NSSet setWithObject:@"Claude"];
41
+ view.lastUpdatedAt = NSDate.date.timeIntervalSince1970 - 12;
24
42
  NSInteger pixelWidth = (NSInteger)ceil(NSWidth(view.bounds));
25
43
  NSInteger pixelHeight = (NSInteger)ceil(NSHeight(view.bounds));
26
44
  NSBitmapImageRep *bitmap = [[NSBitmapImageRep alloc]
@@ -2,9 +2,17 @@
2
2
 
3
3
  // Codex 与 Claude 的额度读取。
4
4
  int RecordClaudeUsage(void);
5
+ NSDictionary *ClaudeRateLimits(void);
5
6
  NSDictionary *LatestClaudeUsage(void);
6
7
  NSDictionary *LatestUsage(void);
7
8
 
9
+ // 增量跟读 ~/.claude/projects 下的会话转录,按官方 5 小时 / 7 天窗口聚合本地 Token。
10
+ @interface ClaudeUsageReader : NSObject
11
+ @property NSURL *projectsURL;
12
+ - (NSDictionary *)refresh;
13
+ - (NSDictionary *)refreshWithFullAggregation;
14
+ @end
15
+
8
16
  // 增量跟读当前 Codex 会话文件:只在会话切换时做一次冷读,之后按偏移追读。
9
17
  @interface CodexUsageReader : NSObject
10
18
  @property NSURL *sessionsURL;