cc-pets 1.0.4 → 1.0.5

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,20 @@
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
+ - 修复额度卡片的在线徽章恒亮:此前按"有没有额度数据"判定,而额度会一直缓存,导致
14
+ 客户端早已退出、甚至单独打开 App 从未运行过 Agent 时两张卡片也显示在线。现改为按该
15
+ provider 是否还有存活客户端判定,并用事件活跃度覆盖不经包装脚本启动的会话。包装脚本
16
+ 启动的会话退出后 3 秒内转为"离线",不再被为直接启动会话准备的 60 秒静默宽限拖住。
17
+ - 额度面板调整信息层级:官方剩余百分比升为主值、本机 Token 降为次级;汇总条改为
18
+ 「今日」与「最近 7 天」双端 Token 合计——两家的 `resets_at` 并不一致,按各自订阅窗口
19
+ 算出的数不在同一区间上,改用与订阅无关的自然日窗口才可相加;"数据刷新"改由面板自身定时器走字;无 Agent 在线时
20
+ 状态配色转灰;额度窗口缺失的列标注"当前无活跃窗口"。
7
21
  - 新增 `cc-pets clean` 和带确认的 `cc-pets uninstall --purge`,并自动清理测试临时目录与过期运行状态。
8
22
  - 更新日志每次更新前截断,并限制为最近 1 MB,避免长期残留增长。
9
23
  - Codex/Claude 额度读取改为 FSEvents/VNODE 事件监听,并保留 120 秒容错刷新,降低空闲文件扫描与 JSON 解析。
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;
@@ -419,6 +419,9 @@ static void TrimUpdateLog(NSString *path) {
419
419
  self.lastStatusState = state;
420
420
  self.lastStatusProvider = provider;
421
421
  self.lastStatusTimestamp = [NSDate.date timeIntervalSince1970];
422
+ if (!self.providerActivityAt) self.providerActivityAt = [NSMutableDictionary dictionary];
423
+ self.providerActivityAt[provider] = @(self.lastStatusTimestamp);
424
+ [self updateQuotaLiveState];
422
425
  self.statusTitleLabel.stringValue = [NSString stringWithFormat:@"%@ · %@",
423
426
  provider, [self statusTextForState:state tool:tool]];
424
427
  self.statusDetailLabel.stringValue = [self statusDetailForState:state];
@@ -904,6 +907,23 @@ static void TrimUpdateLog(NSString *path) {
904
907
  [self.quotaPanel orderFrontRegardless];
905
908
  [self.panel orderFrontRegardless];
906
909
  [self rescheduleUsageTimer];
910
+ [self startQuotaClock];
911
+ }
912
+ // "数据刷新" 显示的是相对时间,没有新数据也得自己走字。面板隐藏时不需要这个定时器,
913
+ // 隐藏的窗口本来就不会重绘。
914
+ - (void)startQuotaClock {
915
+ if (self.quotaClockTimer.isValid) return;
916
+ self.quotaClockTimer = [NSTimer scheduledTimerWithTimeInterval:QuotaClockInterval
917
+ target:self selector:@selector(tickQuotaClock:) userInfo:nil repeats:YES];
918
+ self.quotaClockTimer.tolerance = QuotaClockInterval * 0.3;
919
+ }
920
+ - (void)tickQuotaClock:(id)sender {
921
+ if (!self.quotaPanel.isVisible) {
922
+ [self.quotaClockTimer invalidate];
923
+ self.quotaClockTimer = nil;
924
+ return;
925
+ }
926
+ self.quotaView.needsDisplay = YES;
907
927
  }
908
928
  - (void)positionQuotaDashboard {
909
929
  NSRect petFrame = self.panel.frame;
@@ -951,6 +971,8 @@ static void TrimUpdateLog(NSString *path) {
951
971
  if (!self.pocketHovering && !self.dashboardHovering && !self.petDragging) {
952
972
  [self.quotaPanel orderOut:nil];
953
973
  [self rescheduleUsageTimer];
974
+ [self.quotaClockTimer invalidate];
975
+ self.quotaClockTimer = nil;
954
976
  }
955
977
  }
956
978
  - (void)switchPetToID:(NSString *)petID {
@@ -1100,6 +1122,25 @@ static void TrimUpdateLog(NSString *path) {
1100
1122
  - (void)ensureAgentEventReader:(id)sender {
1101
1123
  if (!self.agentEventSource) [self startAgentEventReader];
1102
1124
  }
1125
+ // 在线判定合并两个信号:包装脚本写出的客户端 pid 文件,以及该 provider 最近是否还在
1126
+ // 发事件。只看前者会把直接跑 claude / codex 的会话误判成离线;只看后者则在客户端退出后
1127
+ // 还要挂满一整个静默窗口。额度数据本身不是在线信号——它一直缓存着,用它判定会恒亮。
1128
+ - (void)updateQuotaLiveState {
1129
+ NSMutableSet<NSString *> *online = [self.liveClientProviders mutableCopy] ?: [NSMutableSet set];
1130
+ NSTimeInterval now = NSDate.date.timeIntervalSince1970;
1131
+ for (NSString *provider in self.providerActivityAt) {
1132
+ NSTimeInterval last = [self.providerActivityAt[provider] doubleValue];
1133
+ if (now - last < AgentStatusInactivityInterval) [online addObject:provider];
1134
+ }
1135
+ NSInteger count = MAX(self.liveClientCount, (NSInteger)online.count);
1136
+ if (self.quotaView.activeAgentCount == count &&
1137
+ [self.quotaView.liveProviders isEqualToSet:online] &&
1138
+ self.quotaView.hasUnlabeledClient == self.hasUnlabeledClient) return;
1139
+ self.quotaView.activeAgentCount = count;
1140
+ self.quotaView.liveProviders = online;
1141
+ self.quotaView.hasUnlabeledClient = self.hasUnlabeledClient;
1142
+ self.quotaView.needsDisplay = YES;
1143
+ }
1103
1144
  - (void)refreshClientLifecycle:(id)sender {
1104
1145
  [self prunePendingApprovalRecords];
1105
1146
  NSString *clientName = [NSString stringWithFormat:@"cc-pets-%u-clients", getuid()];
@@ -1125,9 +1166,20 @@ static void TrimUpdateLog(NSString *path) {
1125
1166
  if (label.length > 0 && label.length <= 32) [providers addObject:label];
1126
1167
  else unlabeled = YES;
1127
1168
  }
1169
+ // 包装脚本启动的客户端有精确的退出信号:pid 文件被回收。这一段不该被为"直接跑
1170
+ // claude / codex"准备的 60 秒活跃度宽限盖住,否则退出后还要挂满一分钟才转离线。
1171
+ // 因此某一家的 pid 文件一旦从有变无,立刻丢掉它的活跃度记录;从来没有过 pid 文件
1172
+ // 的(直接启动)不受影响,继续走宽限。
1173
+ NSSet<NSString *> *previousProviders = self.liveClientProviders;
1128
1174
  self.liveClientCount = liveClients;
1129
1175
  self.liveClientProviders = providers;
1130
1176
  self.hasUnlabeledClient = unlabeled;
1177
+ for (NSString *provider in previousProviders) {
1178
+ if (![providers containsObject:provider]) {
1179
+ [self.providerActivityAt removeObjectForKey:provider];
1180
+ }
1181
+ }
1182
+ [self updateQuotaLiveState];
1131
1183
  [self hideAgentStatusIfClientGone];
1132
1184
  if (self.statusTogglePanel.isVisible && !self.statusBubbleExpanded) {
1133
1185
  [self updateStatusToggleAppearance];
@@ -1143,6 +1195,7 @@ static void TrimUpdateLog(NSString *path) {
1143
1195
  self.quotaView.claudeUsage);
1144
1196
  self.quotaView.codexHistory = QuotaHistorySeries(history, @"codex");
1145
1197
  self.quotaView.claudeHistory = QuotaHistorySeries(history, @"claude");
1198
+ self.quotaView.lastUpdatedAt = NSDate.date.timeIntervalSince1970;
1146
1199
  self.quotaView.needsDisplay = YES;
1147
1200
  }
1148
1201
  - (void)refreshUsage:(id)sender {
@@ -19,5 +19,6 @@ extern const NSTimeInterval AgentStatusOrphanInterval;
19
19
  extern const NSTimeInterval UsageRefreshIntervalVisible;
20
20
  extern const NSTimeInterval UsageRefreshIntervalHidden;
21
21
  extern const NSTimeInterval ClientLifecycleInterval;
22
+ extern const NSTimeInterval QuotaClockInterval;
22
23
  extern const NSTimeInterval AgentEventReaderCheckInterval;
23
24
  extern const NSTimeInterval PetFrameInterval;
@@ -43,6 +43,8 @@ const NSTimeInterval AgentStatusOrphanInterval = 10.0;
43
43
  const NSTimeInterval UsageRefreshIntervalVisible = 120.0;
44
44
  const NSTimeInterval UsageRefreshIntervalHidden = 120.0;
45
45
  const NSTimeInterval ClientLifecycleInterval = 3.0;
46
+ // 面板上"数据刷新"是相对时间,仅在面板可见时按这个间隔重绘走字。
47
+ const NSTimeInterval QuotaClockInterval = 10.0;
46
48
  const NSTimeInterval AgentEventReaderCheckInterval = 5.0;
47
49
  // 精灵动画帧间隔。定时器的 tolerance 让内核可以合并唤醒。
48
50
  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;