cc-pets 1.0.5 → 1.0.7

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
@@ -10,6 +10,19 @@
10
10
  - Token 聚合改为增量跟读并按额度窗口节流,事件驱动的高频刷新不再重复扫描近 7 天会话;
11
11
  过期日期目录按目录名剪枝,无 Token 数据的会话文件缓存失败结果不再反复重读。
12
12
  - 新开 Codex 会话时不再因为尚无 `rate_limits` 而清空面板上已知的额度。
13
+ - 应用内更新遇到暂时性故障时自动重试一次,不再直接弹"更新失败"。刚发布的版本存在
14
+ registry 传播竞态:`/latest` 已经报出新版本,而同一时刻 `npm install cc-pets@<新版本>`
15
+ 解析到的包元数据可能还是旧的并报 `ETARGET`。重试改用一次性缓存目录强制冷取
16
+ (`--prefer-online` 命中 304 时仍会拿到旧元数据),不影响用户真正的 npm 缓存。
17
+ 权限、磁盘、脚本失败等真实故障不重试,照常上报。
18
+ - 修复状态气泡在任务完成后被打回"正在思考":`Stop` 之后仍会飘来 `SubagentStop` /
19
+ `PostToolUse` 等尾巴事件,它们与 `UserPromptSubmit` 归一成同一个状态,现按事件名拦截,
20
+ 终态只能被新一轮真实动作解除。
21
+ - 状态气泡新增"待机中":`正在启动` 超过 8 秒没有后续事件即落到待机,不再让启动态和
22
+ 空闲态显示成同一句"正在准备当前会话…"。
23
+ - 修复测试污染用户真实事件流:跑包装脚本的用例只隔离了 `TMPDIR`,而事件文件走
24
+ `NSTemporaryDirectory()` 不认它,每次跑测试都会写入 3 条 `SessionStart`,把正在运行的
25
+ 桌宠打回"正在启动"。相关用例补上 `CC_PETS_STATE_DIR`,并加了基线校验防止再犯。
13
26
  - 修复额度卡片的在线徽章恒亮:此前按"有没有额度数据"判定,而额度会一直缓存,导致
14
27
  客户端早已退出、甚至单独打开 App 从未运行过 Agent 时两张卡片也显示在线。现改为按该
15
28
  provider 是否还有存活客户端判定,并用事件活跃度覆盖不经包装脚本启动的会话。包装脚本
@@ -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 集成需要自行
@@ -84,6 +84,13 @@ static void TrimUpdateLog(NSString *path) {
84
84
  }
85
85
  - (void)startUpdateToVersion:(NSString *)version {
86
86
  if (self.updating) return;
87
+ [self startUpdateToVersion:version attempt:0];
88
+ }
89
+ - (void)retryUpdate:(NSArray *)context {
90
+ self.updating = NO;
91
+ [self startUpdateToVersion:context[0] attempt:[context[1] integerValue]];
92
+ }
93
+ - (void)startUpdateToVersion:(NSString *)version attempt:(NSInteger)attempt {
87
94
  NSDictionary *configuration = [self updaterConfiguration];
88
95
  NSString *nodePath = [configuration[@"nodePath"] isKindOfClass:NSString.class]
89
96
  ? [configuration[@"nodePath"] stringByStandardizingPath] : nil;
@@ -119,14 +126,22 @@ static void TrimUpdateLog(NSString *path) {
119
126
 
120
127
  NSTask *task = [NSTask new];
121
128
  task.executableURL = [NSURL fileURLWithPath:nodePath];
122
- task.arguments = @[
129
+ NSMutableArray<NSString *> *arguments = [@[
123
130
  npmCliPath,
124
131
  @"install",
125
132
  @"--global",
126
133
  [@"cc-pets@" stringByAppendingString:version],
127
134
  @"--allow-scripts=cc-pets",
128
135
  @"--prefer-online"
129
- ];
136
+ ] mutableCopy];
137
+ if (attempt > 0) {
138
+ // 重试走一个一次性缓存目录:ETARGET 的成因就是本机缓存里的包元数据还没有这个
139
+ // 版本,--prefer-online 只是允许重新校验,命中 304 时依然拿到旧元数据。
140
+ // 换缓存目录能强制冷取,又不动用户真正的 npm 缓存。
141
+ [arguments addObjectsFromArray:@[@"--cache",
142
+ [supportDirectory stringByAppendingPathComponent:@"update-retry-cache"]]];
143
+ }
144
+ task.arguments = arguments;
130
145
  NSMutableDictionary<NSString *, NSString *> *environment =
131
146
  [NSProcessInfo.processInfo.environment mutableCopy];
132
147
  NSString *nodeDirectory = nodePath.stringByDeletingLastPathComponent;
@@ -146,14 +161,25 @@ static void TrimUpdateLog(NSString *path) {
146
161
  dispatch_async(dispatch_get_main_queue(), ^{
147
162
  typeof(self) strongSelf = weakSelf;
148
163
  if (!strongSelf) return;
149
- strongSelf.updating = NO;
150
164
  strongSelf.updateTask = nil;
151
165
  if (finishedTask.terminationStatus == EXIT_SUCCESS) {
166
+ strongSelf.updating = NO;
152
167
  if ([strongSelf restartAfterUpdateToVersion:version configuration:configuration]) return;
153
168
  [strongSelf showUpdateAlertWithTitle:@"更新完成"
154
169
  message:@"CC Pets 已更新,但没有找到可自动启动的新版应用,请手动重新启动一次。"];
155
170
  return;
156
171
  }
172
+ // 暂时性故障(典型是刚发布的版本报 ETARGET)自动重试一次再说,
173
+ // 别把一个重试就能过的问题弹成"更新失败"。updating 保持为 YES,
174
+ // 等待期间不接受新的更新请求。
175
+ NSString *log = [NSString stringWithContentsOfFile:logPath
176
+ encoding:NSUTF8StringEncoding error:nil];
177
+ if (attempt == 0 && UpdateFailureIsTransient(log)) {
178
+ [strongSelf performSelector:@selector(retryUpdate:)
179
+ withObject:@[version, @1] afterDelay:UpdateRetryDelay];
180
+ return;
181
+ }
182
+ strongSelf.updating = NO;
157
183
  [NSApp activateIgnoringOtherApps:YES];
158
184
  NSAlert *alert = [NSAlert new];
159
185
  alert.messageText = @"更新失败";
@@ -174,8 +200,11 @@ static void TrimUpdateLog(NSString *path) {
174
200
  [self showUpdateAlertWithTitle:@"无法启动更新" message:launchError.localizedDescription];
175
201
  return;
176
202
  }
177
- [self showUpdateAlertWithTitle:@"正在更新"
178
- message:[NSString stringWithFormat:@"正在下载并安装 CC Pets %@。完成后桌宠会自动重启。", version]];
203
+ // 重试是静默的:第一次已经弹过"正在更新",再弹一次只会让人以为出了两回事。
204
+ if (attempt == 0) {
205
+ [self showUpdateAlertWithTitle:@"正在更新"
206
+ message:[NSString stringWithFormat:@"正在下载并安装 CC Pets %@。完成后桌宠会自动重启。", version]];
207
+ }
179
208
  }
180
209
  - (void)checkForUpdates:(id)sender {
181
210
  if (self.checkingForUpdate || self.updating) return;
@@ -296,6 +325,7 @@ static void TrimUpdateLog(NSString *path) {
296
325
  }
297
326
  - (NSString *)statusTextForState:(NSString *)state tool:(NSString *)tool {
298
327
  if ([state isEqualToString:@"starting"]) return @"正在启动";
328
+ if ([state isEqualToString:@"idle"]) return @"待机中";
299
329
  if ([state isEqualToString:@"thinking"]) return @"正在思考";
300
330
  if ([state isEqualToString:@"auto_review"]) return @"自动审批中";
301
331
  if ([state isEqualToString:@"approval"]) return @"等待审批";
@@ -322,6 +352,7 @@ static void TrimUpdateLog(NSString *path) {
322
352
  }
323
353
  - (NSString *)statusDetailForState:(NSString *)state {
324
354
  if ([state isEqualToString:@"starting"]) return @"正在准备当前会话…";
355
+ if ([state isEqualToString:@"idle"]) return @"会话已就绪,等待你的下一条指令。";
325
356
  if ([state isEqualToString:@"thinking"]) return @"正在分析请求…";
326
357
  if ([state isEqualToString:@"auto_review"]) return @"正在由 Auto-review 审核,无需手动操作。";
327
358
  if ([state isEqualToString:@"approval"]) return @"请回到终端确认操作。";
@@ -344,12 +375,15 @@ static void TrimUpdateLog(NSString *path) {
344
375
  if ([state isEqualToString:@"approval"] || [state isEqualToString:@"notification"]) {
345
376
  return [NSColor colorWithRed:0.92 green:0.58 blue:0.12 alpha:1];
346
377
  }
378
+ // 待机是"没在干活",用中性灰和工作中的蓝拉开距离。
379
+ if ([state isEqualToString:@"idle"]) return [NSColor colorWithWhite:0.55 alpha:1];
347
380
  return [NSColor colorWithRed:0.33 green:0.53 blue:0.78 alpha:1];
348
381
  }
349
382
  - (NSString *)statusSymbolForState:(NSString *)state {
350
383
  if ([state isEqualToString:@"completed"] || [state isEqualToString:@"tool_completed"]) return @"checkmark";
351
384
  if ([state isEqualToString:@"failed"] || [state isEqualToString:@"tool_failed"]) return @"xmark";
352
385
  if ([state isEqualToString:@"approval"] || [state isEqualToString:@"notification"]) return @"exclamationmark";
386
+ if ([state isEqualToString:@"idle"]) return @"zzz";
353
387
  return @"ellipsis";
354
388
  }
355
389
  - (void)updateStatusToggleAppearance {
@@ -389,6 +423,8 @@ static void TrimUpdateLog(NSString *path) {
389
423
  [self hideAgentStatus];
390
424
  }
391
425
  - (void)hideAgentStatus {
426
+ [NSObject cancelPreviousPerformRequestsWithTarget:self
427
+ selector:@selector(enterIdleStatus) object:nil];
392
428
  [self.statusPanel orderOut:nil];
393
429
  [self.statusTogglePanel orderOut:nil];
394
430
  self.hasAgentStatus = NO;
@@ -407,21 +443,20 @@ static void TrimUpdateLog(NSString *path) {
407
443
  [self updateStatusToggleAppearance];
408
444
  [self.statusTogglePanel orderFrontRegardless];
409
445
  }
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;
446
+ // Stop 之后还会飘来 SubagentStop / PostToolUse / TaskCompleted 这类"仍在工作"的尾巴事件
447
+ // (实测 Stop 后 4 秒),它们和 UserPromptSubmit 一样都归一成 thinking,只看 state 分不出来,
448
+ // 所以必须按事件名判断。终态只能被新一轮真实动作解除(用户提问、工具调用、需要关注),
449
+ // 否则"任务已完成"会被打回"正在思考",看起来像任务又活了。
450
+ - (BOOL)isTrailingRecord:(NSDictionary *)record afterState:(NSString *)state {
451
+ if (![state isEqualToString:@"completed"] && ![state isEqualToString:@"failed"]) return NO;
452
+ NSString *event = [record[@"event"] isKindOfClass:NSString.class] ? record[@"event"] : @"";
453
+ return [event isEqualToString:@"SubagentStop"] || [event isEqualToString:@"PostToolUse"] ||
454
+ [event isEqualToString:@"TaskCompleted"];
455
+ }
456
+ - (void)applyStatusPresentationForState:(NSString *)state provider:(NSString *)provider
457
+ tool:(NSString *)tool {
419
458
  self.lastStatusState = state;
420
459
  self.lastStatusProvider = provider;
421
- self.lastStatusTimestamp = [NSDate.date timeIntervalSince1970];
422
- if (!self.providerActivityAt) self.providerActivityAt = [NSMutableDictionary dictionary];
423
- self.providerActivityAt[provider] = @(self.lastStatusTimestamp);
424
- [self updateQuotaLiveState];
425
460
  self.statusTitleLabel.stringValue = [NSString stringWithFormat:@"%@ · %@",
426
461
  provider, [self statusTextForState:state tool:tool]];
427
462
  self.statusDetailLabel.stringValue = [self statusDetailForState:state];
@@ -438,9 +473,41 @@ static void TrimUpdateLog(NSString *path) {
438
473
  else [self.statusPanel orderOut:nil];
439
474
  [self updateStatusToggleAppearance];
440
475
  [self.statusTogglePanel orderFrontRegardless];
476
+ }
477
+ // "正在启动"只在会话拉起的一瞬间成立。之后如果没有任何后续事件,真实情况是会话已就绪、
478
+ // 正在等用户输入——继续显示"正在准备当前会话…"会让启动和待机看起来一模一样。
479
+ - (void)enterIdleStatus {
480
+ if (!self.hasAgentStatus) return;
481
+ [self applyStatusPresentationForState:@"idle"
482
+ provider:self.lastStatusProvider ?: @"Agent" tool:@""];
483
+ }
484
+ - (void)showAgentStatusForRecord:(NSDictionary *)record notify:(BOOL)shouldNotify {
485
+ NSString *provider = SanitizedShortString(record[@"provider"], 32);
486
+ if (provider.length == 0) provider = @"Agent";
487
+ NSString *state = [record[@"state"] isKindOfClass:NSString.class]
488
+ ? record[@"state"] : NormalizedStateForEvent(record[@"event"], [record[@"failed"] boolValue]);
489
+ NSString *tool = [record[@"tool"] isKindOfClass:NSString.class] ? record[@"tool"] : @"";
490
+ // 尾巴事件仍然算"客户端还活着",只是不该改写气泡上的终态。
491
+ self.lastStatusTimestamp = [NSDate.date timeIntervalSince1970];
492
+ if (!self.providerActivityAt) self.providerActivityAt = [NSMutableDictionary dictionary];
493
+ self.providerActivityAt[provider] = @(self.lastStatusTimestamp);
494
+ [self updateQuotaLiveState];
495
+ if (self.hasAgentStatus && [provider isEqualToString:self.lastStatusProvider] &&
496
+ [self isTrailingRecord:record afterState:self.lastStatusState]) return;
497
+
498
+ [NSObject cancelPreviousPerformRequestsWithTarget:self
499
+ selector:@selector(hideAgentStatus) object:nil];
500
+ [NSObject cancelPreviousPerformRequestsWithTarget:self
501
+ selector:@selector(enterIdleStatus) object:nil];
502
+ self.hasAgentStatus = YES;
503
+ [self applyStatusPresentationForState:state provider:provider tool:tool];
441
504
  [self.panel orderFrontRegardless];
442
505
  [self performSelector:@selector(hideAgentStatus)
443
506
  withObject:nil afterDelay:AgentStatusInactivityInterval];
507
+ if ([state isEqualToString:@"starting"]) {
508
+ [self performSelector:@selector(enterIdleStatus) withObject:nil
509
+ afterDelay:AgentStartingGraceInterval];
510
+ }
444
511
  if (shouldNotify) [self notifyForRecord:record];
445
512
  }
446
513
  - (void)showAgentStatusForRecord:(NSDictionary *)record {
@@ -16,6 +16,8 @@ extern NSString *const StatusBubblePreferenceV2Key;
16
16
 
17
17
  extern const NSTimeInterval AgentStatusInactivityInterval;
18
18
  extern const NSTimeInterval AgentStatusOrphanInterval;
19
+ extern const NSTimeInterval AgentStartingGraceInterval;
20
+ extern const NSTimeInterval UpdateRetryDelay;
19
21
  extern const NSTimeInterval UsageRefreshIntervalVisible;
20
22
  extern const NSTimeInterval UsageRefreshIntervalHidden;
21
23
  extern const NSTimeInterval ClientLifecycleInterval;
@@ -38,6 +38,11 @@ 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;
44
+ // 刚发布的版本存在 registry 传播竞态,更新失败后等这么久再自动重试一次。
45
+ const NSTimeInterval UpdateRetryDelay = 5.0;
41
46
  // 额度变化由 FSEvents/VNODE 主动推送;定时器只保留为监听不可用时的 120 秒兜底。
42
47
  // 打开面板和手动刷新仍会立即读取一次。
43
48
  const NSTimeInterval UsageRefreshIntervalVisible = 120.0;
@@ -8,3 +8,6 @@
8
8
  // 自动更新会把比较结果作为是否升级的唯一依据,所以这里刻意不接受预发布号。
9
9
  NSComparisonResult CompareStableVersions(NSString *left, NSString *right, BOOL *valid);
10
10
  int RestartAfterPID(pid_t pid, NSString *appPath, BOOL managed);
11
+
12
+ // npm 安装日志里是否只是暂时性故障(值得自动重试一次),而不是真的装不上。
13
+ BOOL UpdateFailureIsTransient(NSString *log);
@@ -60,3 +60,23 @@ int RestartAfterPID(pid_t pid, NSString *appPath, BOOL managed) {
60
60
  [task waitUntilExit];
61
61
  return task.terminationStatus == EXIT_SUCCESS ? EXIT_SUCCESS : EXIT_FAILURE;
62
62
  }
63
+
64
+ // 刚发布的版本存在 packument 传播与本机 npm 缓存的竞态:registry 的 /latest 已经报出
65
+ // 新版本,而同一时刻 `npm install cc-pets@<新版本>` 解析到的包元数据可能还是旧的,
66
+ // 直接报 ETARGET。这类失败重试一次通常就好,不该当成"装不上"弹错误框。
67
+ // 网络类错误同理。真正的失败(EACCES、ENOSPC、脚本报错等)不在此列,必须如实上报。
68
+ BOOL UpdateFailureIsTransient(NSString *log) {
69
+ if (log.length == 0) return NO;
70
+ static NSArray<NSString *> *markers;
71
+ static dispatch_once_t once;
72
+ dispatch_once(&once, ^{
73
+ markers = @[@"ETARGET", @"ENOTFOUND", @"EAI_AGAIN", @"ETIMEDOUT", @"ECONNRESET",
74
+ @"ERR_SOCKET_TIMEOUT", @"ECONNREFUSED", @"ERR_SSL", @"429", @"503"];
75
+ });
76
+ for (NSString *marker in markers) {
77
+ if ([log rangeOfString:marker options:NSCaseInsensitiveSearch].location != NSNotFound) {
78
+ return YES;
79
+ }
80
+ }
81
+ return NO;
82
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cc-pets",
3
- "version": "1.0.5",
3
+ "version": "1.0.7",
4
4
  "description": "A native macOS desktop pet for Codex CLI and Claude Code",
5
5
  "author": "wangxinyusqn",
6
6
  "license": "MIT",