cc-pets 1.3.2 → 1.4.0

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.
@@ -4,6 +4,8 @@
4
4
  #import "CCPetsEvents.h"
5
5
  #import "CCPetsQuotaHistory.h"
6
6
  #import "CCPetsImageLoader.h"
7
+ #import "CCPetsPhrases.h"
8
+ #import "CCPetsUsage.h"
7
9
  #import "MenuToggleSwitch.h"
8
10
  #import <UserNotifications/UserNotifications.h>
9
11
  #import <signal.h>
@@ -320,6 +322,115 @@ static void TrimUpdateLog(NSString *path) {
320
322
  if (tag == 3) return NotificationApprovalKey;
321
323
  return nil;
322
324
  }
325
+ - (void)toggleSpeech:(NSButton *)sender {
326
+ NSUserDefaults *defaults = NSUserDefaults.standardUserDefaults;
327
+ id current = [defaults objectForKey:@"CCPetsSpeechEnabled"];
328
+ BOOL enabled = current == nil ? YES : [current boolValue];
329
+ [defaults setBool:!enabled forKey:@"CCPetsSpeechEnabled"];
330
+ sender.state = !enabled ? NSControlStateValueOn : NSControlStateValueOff;
331
+ if (enabled) [self hideSpeechBubble];
332
+ }
333
+ // 词库文件平时不存在(不存在就等于"用内置"),只有用户主动点这一项才现写一个带注释的
334
+ // 样板出来——避免每台机器一装就多个没人动过的配置文件。
335
+ - (void)editPhrasesFile:(id)sender {
336
+ NSString *path = PetPhrasesFilePath();
337
+ if (![NSFileManager.defaultManager fileExistsAtPath:path]) {
338
+ [NSFileManager.defaultManager createDirectoryAtPath:path.stringByDeletingLastPathComponent
339
+ withIntermediateDirectories:YES attributes:nil error:nil];
340
+ // 模板必须自解释:用户打开它就该看懂怎么改,而不是先去查文档。
341
+ // 内置示例全部写成注释,取消注释即可生效——比给一堆空小节强得多。
342
+ NSArray<NSString *> *lines = @[
343
+ @"# 桌宠的台词。改完存盘立刻生效,不用重启。",
344
+ @"# ",
345
+ @"# 写法:[情境] 起一节,下面一行一句。井号开头是注释。",
346
+ @"# 你写的会和内置台词合并;想完全用自己的,就在文件最前面单独写一行: replace",
347
+ @"# 每句限 30 字以内,超了会被忽略。",
348
+ @"# ",
349
+ @"# 可以插入这些实时数据(连花括号一起写):",
350
+ @"# {quota5h} 5 小时额度剩余,如 12%",
351
+ @"# {resetTime} 额度回血时间,如 18:30",
352
+ @"# {sessionMin} 本次已工作分钟数",
353
+ @"# {failCount} 连续失败次数",
354
+ @"# {hour} 当前小时,如 2",
355
+ @"# 用了数据的句子,在拿不到该数据时会自动跳过,不会显示成花括号。",
356
+ @"",
357
+ @"",
358
+ @"# ========== 它主动开口的时候 ==========",
359
+ @"",
360
+ @"[done] # 任务完成",
361
+ @"# 收工!",
362
+ @"",
363
+ @"[fail] # 连续失败两次以上",
364
+ @"# 失败 {failCount} 次了,喘口气。",
365
+ @"",
366
+ @"[quota_low] # 额度告急",
367
+ @"# 额度只剩 {quota5h} 了。",
368
+ @"",
369
+ @"[late_night] # 深夜还在干",
370
+ @"# 都 {hour} 点了。",
371
+ @"",
372
+ @"[long_session] # 连续工作很久",
373
+ @"# 连着干 {sessionMin} 分钟了。",
374
+ @"",
375
+ @"[wake] # 隔了很久又开工",
376
+ @"# 你回来啦。",
377
+ @"",
378
+ @"[idle] # 闲着没事",
379
+ @"# 发会儿呆。",
380
+ @"",
381
+ @"",
382
+ @"# ========== 它播报状态时说的话 ==========",
383
+ @"# 这部分是状态卡上那一行,不受\"碎碎念\"开关影响。",
384
+ @"",
385
+ @"[state_starting] # 正在启动",
386
+ @"# 正在把它叫醒…",
387
+ @"",
388
+ @"[state_idle] # 待机中",
389
+ @"# 它准备好了,你说吧。",
390
+ @"",
391
+ @"[state_thinking] # 正在思考",
392
+ @"# 让它想想,别催。",
393
+ @"",
394
+ @"[state_tool_bash] # 正在执行命令",
395
+ @"# 在敲命令了。",
396
+ @"",
397
+ @"[state_tool_edit] # 正在编辑文件",
398
+ @"# 在改文件,别手抖。",
399
+ @"",
400
+ @"[state_tool_read] # 正在查找资料",
401
+ @"# 到处翻资料呢。",
402
+ @"",
403
+ @"[state_subagent] # 子 Agent 工作中",
404
+ @"# 它喊帮手了。",
405
+ @"",
406
+ @"[state_approval] # 等待审批",
407
+ @"# 它等你点头。",
408
+ @"",
409
+ @"[state_auto_review] # 自动审批中",
410
+ @"# 有人替你把关了。",
411
+ @"",
412
+ @"[state_tool_done] # 单步操作完成",
413
+ @"# 这一步成了。",
414
+ @"",
415
+ @"[state_tool_failed] # 工具执行失败",
416
+ @"# 这步崴了。",
417
+ @"",
418
+ @"[state_completed] # 任务已完成",
419
+ @"# 干完了,歇会儿。",
420
+ @"",
421
+ @"[state_failed] # 任务失败",
422
+ @"# 翻车了,回终端看看。",
423
+ @"",
424
+ @"[state_notification] # 需要关注",
425
+ @"# 有事找你。",
426
+ @""
427
+ ];
428
+ NSString *template = [[lines componentsJoinedByString:@"\n"]
429
+ stringByAppendingString:@"\n"];
430
+ [template writeToFile:path atomically:YES encoding:NSUTF8StringEncoding error:nil];
431
+ }
432
+ [NSWorkspace.sharedWorkspace openURL:[NSURL fileURLWithPath:path]];
433
+ }
323
434
  - (void)toggleNotification:(NSButton *)sender {
324
435
  NSString *key = [self notificationKeyForTag:sender.tag];
325
436
  if (!key) return;
@@ -404,7 +515,45 @@ static void TrimUpdateLog(NSString *path) {
404
515
  }
405
516
  return @"正在工作";
406
517
  }
407
- - (NSString *)statusDetailForState:(NSString *)state {
518
+ // 状态卡副行的正文。每个 hook 状态都由宠物来讲,标题仍然给事实。
519
+ //
520
+ // 这不是"额外说话",是把原来的样板文案整体换成宠物口吻,所以不受说话预算限制——
521
+ // 状态本来就在变,每次变化说一句是应该的。预算只管情绪句那一层。
522
+ - (NSString *)petVoiceTagForState:(NSString *)state tool:(NSString *)tool {
523
+ if ([state isEqualToString:@"starting"]) return PetPhraseTagStateStarting;
524
+ if ([state isEqualToString:@"idle"]) return PetPhraseTagStateIdle;
525
+ if ([state isEqualToString:@"thinking"]) return PetPhraseTagStateThinking;
526
+ if ([state isEqualToString:@"auto_review"]) return PetPhraseTagStateAutoReview;
527
+ if ([state isEqualToString:@"approval"]) return PetPhraseTagStateApproval;
528
+ if ([state isEqualToString:@"subagent"]) return PetPhraseTagStateSubagent;
529
+ if ([state isEqualToString:@"tool_completed"]) return PetPhraseTagStateToolDone;
530
+ if ([state isEqualToString:@"tool_failed"]) return PetPhraseTagStateToolFailed;
531
+ if ([state isEqualToString:@"completed"]) return PetPhraseTagStateCompleted;
532
+ if ([state isEqualToString:@"failed"]) return PetPhraseTagStateFailed;
533
+ if ([state isEqualToString:@"notification"]) return PetPhraseTagStateNotification;
534
+ if ([state isEqualToString:@"tool"]) {
535
+ // 工具四分类和标题那边同源。原来副行只有一句"正在调用工具…"覆盖全部四类,
536
+ // 分开之后副行的信息量反而比改造前更大。
537
+ NSString *lower = tool.lowercaseString;
538
+ if ([lower containsString:@"bash"] || [lower containsString:@"exec"] ||
539
+ [lower containsString:@"shell"] || [lower containsString:@"terminal"]) {
540
+ return PetPhraseTagStateToolBash;
541
+ }
542
+ if ([lower containsString:@"patch"] || [lower containsString:@"edit"] ||
543
+ [lower containsString:@"write"]) return PetPhraseTagStateToolEdit;
544
+ if ([lower containsString:@"read"] || [lower containsString:@"search"] ||
545
+ [lower containsString:@"find"] || [lower containsString:@"grep"] ||
546
+ [lower containsString:@"glob"] || [lower containsString:@"web"] ||
547
+ [lower hasPrefix:@"mcp__"]) return PetPhraseTagStateToolRead;
548
+ if ([lower containsString:@"task"] || [lower containsString:@"agent"]) {
549
+ return PetPhraseTagStateSubagent;
550
+ }
551
+ return PetPhraseTagStateTool;
552
+ }
553
+ return PetPhraseTagStateTool;
554
+ }
555
+ // 词库取不到就落回原来的系统文案。用户把词库写坏了也只是少了口吻,不会剩个空行。
556
+ - (NSString *)fallbackDetailForState:(NSString *)state {
408
557
  if ([state isEqualToString:@"starting"]) return @"正在准备当前会话…";
409
558
  if ([state isEqualToString:@"idle"]) return @"会话已就绪,等待你的下一条指令。";
410
559
  if ([state isEqualToString:@"thinking"]) return @"正在分析需求…";
@@ -419,6 +568,18 @@ static void TrimUpdateLog(NSString *path) {
419
568
  if ([state isEqualToString:@"notification"]) return @"有一条状态需要你关注。";
420
569
  return @"正在处理当前任务。";
421
570
  }
571
+ - (NSString *)statusDetailForState:(NSString *)state tool:(NSString *)tool {
572
+ NSString *tag = [self petVoiceTagForState:state tool:tool];
573
+ // 同一个状态连着来一串事件时不重摇,否则副行会不停闪。一次状态转换说一句就够。
574
+ if ([tag isEqualToString:self.lastPetVoiceTag] && self.lastPetVoiceText.length > 0) {
575
+ return self.lastPetVoiceText;
576
+ }
577
+ NSString *text = PetPhraseForTag(tag, [self speechSlots]);
578
+ if (text.length == 0) text = [self fallbackDetailForState:state];
579
+ self.lastPetVoiceTag = tag;
580
+ self.lastPetVoiceText = text;
581
+ return text;
582
+ }
422
583
  - (NSColor *)statusColorForState:(NSString *)state {
423
584
  if ([state isEqualToString:@"completed"] || [state isEqualToString:@"tool_completed"]) {
424
585
  return [NSColor colorWithRed:0.18 green:0.68 blue:0.35 alpha:1];
@@ -489,7 +650,7 @@ static void TrimUpdateLog(NSString *path) {
489
650
  self.lastStatusProvider = provider;
490
651
  self.statusTitleLabel.stringValue = [NSString stringWithFormat:@"%@ · %@",
491
652
  provider, [self statusTextForState:state tool:tool]];
492
- self.statusDetailLabel.stringValue = [self statusDetailForState:state];
653
+ self.statusDetailLabel.stringValue = [self statusDetailForState:state tool:tool];
493
654
  NSColor *stateColor = [self statusColorForState:state];
494
655
  self.statusIconButton.layer.backgroundColor = [stateColor colorWithAlphaComponent:0.28].CGColor;
495
656
  NSImage *icon = [NSImage imageWithSystemSymbolName:[self statusSymbolForState:state]
@@ -498,9 +659,15 @@ static void TrimUpdateLog(NSString *path) {
498
659
  [NSImageSymbolConfiguration configurationWithPointSize:15 weight:NSFontWeightBold]];
499
660
  self.statusIconButton.contentTintColor = [stateColor blendedColorWithFraction:0.18
500
661
  ofColor:NSColor.blackColor] ?: stateColor;
662
+ [self resizeStatusCardToFitText];
501
663
  [self positionAgentStatus];
502
- if (self.statusBubbleExpanded) [self.statusPanel orderFrontRegardless];
503
- else [self.statusPanel orderOut:nil];
664
+ if (self.statusBubbleExpanded) {
665
+ [self.statusPanel orderFrontRegardless];
666
+ // 卡片一出现就收掉独立气泡:两者都是宠物在说话,同时挂着就是重影。
667
+ if (self.speechPanel.isVisible) [self hideSpeechBubble];
668
+ } else {
669
+ [self.statusPanel orderOut:nil];
670
+ }
504
671
  }
505
672
  // "正在启动"只在会话拉起的一瞬间成立。之后如果没有任何后续事件,真实情况是会话已就绪、
506
673
  // 正在等用户输入——继续显示"正在准备当前会话…"会让启动和待机看起来一模一样。
@@ -590,6 +757,9 @@ static void TrimUpdateLog(NSString *path) {
590
757
  [self.petView handleAgentEvent:animationEvent tool:tool
591
758
  failed:[record[@"failed"] boolValue]];
592
759
  [self showAgentStatusForRecord:record notify:shouldNotify];
760
+ // 说话是事件流的新消费者,不改变事件生产。冷启动重放已被 processAgentEventData
761
+ // 的 recentOnly + 5 秒 cutoff 挡住,再加上预算制和冷却,最坏也只多说一句。
762
+ [self considerSpeechForRecord:record];
593
763
  }
594
764
  - (NSDictionary *)petManifestInDirectory:(NSString *)directory {
595
765
  NSString *jsonPath = [directory stringByAppendingPathComponent:@"pet.json"];
@@ -828,7 +998,7 @@ static void TrimUpdateLog(NSString *path) {
828
998
  name:NSWindowDidMoveNotification object:self.panel];
829
999
  [root addSubview:self.petView];
830
1000
 
831
- NSSize statusGlassSize = NSMakeSize(340, 58);
1001
+ NSSize statusGlassSize = NSMakeSize(340, PetStatusBodyHeight);
832
1002
  NSSize statusSize = NSMakeSize(statusGlassSize.width + 12, statusGlassSize.height + 12);
833
1003
  self.statusPanel = [[NSPanel alloc] initWithContentRect:NSMakeRect(0, 0,
834
1004
  statusSize.width, statusSize.height)
@@ -846,9 +1016,10 @@ static void TrimUpdateLog(NSString *path) {
846
1016
  0, 0, statusSize.width, statusSize.height)];
847
1017
  NSView *statusShadow = [[NSView alloc] initWithFrame:NSMakeRect(
848
1018
  6, 6, statusGlassSize.width, statusGlassSize.height)];
1019
+ self.statusShadowView = statusShadow;
1020
+ statusShadow.layer.cornerRadius = statusGlassSize.height / 2.0;
849
1021
  statusShadow.wantsLayer = YES;
850
1022
  statusShadow.layer.backgroundColor = [NSColor colorWithWhite:0 alpha:0.01].CGColor;
851
- statusShadow.layer.cornerRadius = statusGlassSize.height / 2.0;
852
1023
  statusShadow.layer.cornerCurve = kCACornerCurveContinuous;
853
1024
  statusShadow.layer.shadowColor = NSColor.blackColor.CGColor;
854
1025
  statusShadow.layer.shadowOpacity = 0.24;
@@ -875,16 +1046,18 @@ static void TrimUpdateLog(NSString *path) {
875
1046
  self.statusGlass.layer.borderColor = [NSColor colorWithWhite:1 alpha:0.48].CGColor;
876
1047
 
877
1048
  self.statusTitleLabel = [NSTextField labelWithString:@""];
878
- self.statusTitleLabel.frame = NSMakeRect(20, 30, statusGlassSize.width - 80, 18);
879
- self.statusTitleLabel.font = [NSFont systemFontOfSize:13 weight:NSFontWeightSemibold];
880
- self.statusTitleLabel.textColor = [NSColor colorWithWhite:0.10 alpha:0.96];
1049
+ // 层级是反的:宠物是主角,事实退成眉标。
1050
+ // 标题 11 Medium 浅灰只负责"到底在干什么"这个锚点,副行 14 Medium 深色才是正文。
1051
+ self.statusTitleLabel.frame = NSMakeRect(20, 34, statusGlassSize.width - 80, 14);
1052
+ self.statusTitleLabel.font = [NSFont systemFontOfSize:11 weight:NSFontWeightMedium];
1053
+ self.statusTitleLabel.textColor = [NSColor colorWithWhite:0.42 alpha:0.90];
881
1054
  self.statusTitleLabel.lineBreakMode = NSLineBreakByTruncatingTail;
882
1055
  [self.statusGlass addSubview:self.statusTitleLabel];
883
1056
 
884
1057
  self.statusDetailLabel = [NSTextField labelWithString:@""];
885
- self.statusDetailLabel.frame = NSMakeRect(20, 12, statusGlassSize.width - 80, 17);
886
- self.statusDetailLabel.font = [NSFont systemFontOfSize:12 weight:NSFontWeightRegular];
887
- self.statusDetailLabel.textColor = [NSColor colorWithWhite:0.34 alpha:0.88];
1058
+ self.statusDetailLabel.frame = NSMakeRect(20, 10, statusGlassSize.width - 80, 22);
1059
+ self.statusDetailLabel.font = [NSFont systemFontOfSize:14 weight:NSFontWeightMedium];
1060
+ self.statusDetailLabel.textColor = [NSColor colorWithWhite:0.12 alpha:0.96];
888
1061
  self.statusDetailLabel.lineBreakMode = NSLineBreakByTruncatingTail;
889
1062
  [self.statusGlass addSubview:self.statusDetailLabel];
890
1063
 
@@ -949,6 +1122,7 @@ static void TrimUpdateLog(NSString *path) {
949
1122
  self.pendingApprovalRecords = [NSMutableDictionary dictionary];
950
1123
  self.usageMonitor.changeHandler = ^(NSDictionary *codexUsage, NSDictionary *claudeUsage) {
951
1124
  [weakSelf applyCodexUsage:codexUsage claudeUsage:claudeUsage];
1125
+ [weakSelf considerQuotaSpeech];
952
1126
  };
953
1127
  [self.usageMonitor start];
954
1128
  if ([NSProcessInfo.processInfo.arguments containsObject:@"--preview-dashboard"]) {
@@ -1098,6 +1272,386 @@ static const NSTimeInterval UsageRefreshCoalesceWindow = 2.0;
1098
1272
  if (self.quotaPanel.isVisible) [self positionQuotaDashboard];
1099
1273
  if (self.statusPanel.isVisible) [self positionAgentStatus];
1100
1274
  }
1275
+ #pragma mark - 说话气泡
1276
+
1277
+
1278
+
1279
+ // 每小时最多说几句。桌宠一直叭叭两小时就会让人想卸载——沉默是活物感的一部分,
1280
+ // 越没事的时候越要闭嘴。
1281
+ static const NSInteger PetSpeechHourlyBudget = 4;
1282
+ // 两句之间的最短间隔。预算没用完也不能连着说。
1283
+ static const NSTimeInterval PetSpeechCooldown = 240.0;
1284
+ // 气泡停留时长。
1285
+ static const NSTimeInterval PetSpeechDwell = 4.5;
1286
+ // 气泡与状态卡的本体高度。
1287
+ //
1288
+ // 不要再加尾巴(三角、锥形、思考圆点都试过):药丸的圆角等于高度一半,整条边都是弧,
1289
+ // 尾巴只能从弧上长出来,怎么调都像贴上去的;换成圆角矩形能配尾巴,但那要放弃
1290
+ // layer.cornerRadius + kCACornerCurveContinuous 改用位图 maskImage 裁形,
1291
+ // squircle 和 GPU 端矢量裁切的质感一起丢了,得不偿失。
1292
+ // 结论:保持药丸 + 原生圆角,靠贴近宠物来表达归属。
1293
+ static const CGFloat PetSpeechBodyHeight = 38.0;
1294
+ static const CGFloat PetStatusBodyHeight = 58.0;
1295
+
1296
+ - (BOOL)speechEnabled {
1297
+ NSUserDefaults *defaults = NSUserDefaults.standardUserDefaults;
1298
+ // 缺省开启;用户可在右键菜单里关掉。
1299
+ id value = [defaults objectForKey:@"CCPetsSpeechEnabled"];
1300
+ return value == nil ? YES : [value boolValue];
1301
+ }
1302
+ // 预算与冷却。两道闸门都过了才允许说。
1303
+ // 调试/调优用,现读,改完立刻生效不用重启:
1304
+ // defaults write com.universewang.cc-pets CCPetsSpeechCooldown -float 0
1305
+ // defaults write com.universewang.cc-pets CCPetsSpeechHourlyBudget -int 100
1306
+ // defaults delete com.universewang.cc-pets CCPetsSpeechCooldown # 恢复
1307
+ // 域名是 bundle identifier,不是 "cc-pets"——写错域的话键会落在另一个 plist 里,
1308
+ // 桌宠永远看不到,表现为"设了没反应"。
1309
+ - (NSTimeInterval)speechCooldownSeconds {
1310
+ id value = [NSUserDefaults.standardUserDefaults objectForKey:@"CCPetsSpeechCooldown"];
1311
+ if (![value isKindOfClass:NSNumber.class]) return PetSpeechCooldown;
1312
+ return MAX(0.0, [value doubleValue]);
1313
+ }
1314
+ - (NSInteger)speechHourlyBudget {
1315
+ id value = [NSUserDefaults.standardUserDefaults objectForKey:@"CCPetsSpeechHourlyBudget"];
1316
+ if (![value isKindOfClass:NSNumber.class]) return PetSpeechHourlyBudget;
1317
+ return MAX((NSInteger)1, [value integerValue]);
1318
+ }
1319
+ - (BOOL)canSpeakNow {
1320
+ if (![self speechEnabled]) return NO;
1321
+ NSTimeInterval now = NSDate.date.timeIntervalSince1970;
1322
+ if (now < self.speechCooldownUntil) return NO;
1323
+ if (!self.speechTimestamps) self.speechTimestamps = [NSMutableArray array];
1324
+ while (self.speechTimestamps.count > 0 &&
1325
+ now - self.speechTimestamps.firstObject.doubleValue > 3600.0) {
1326
+ [self.speechTimestamps removeObjectAtIndex:0];
1327
+ }
1328
+ return (NSInteger)self.speechTimestamps.count < [self speechHourlyBudget];
1329
+ }
1330
+ // 当前可用的槽位值。取不到的键就不放进去,模板层会因此跳过需要它的那些条目。
1331
+ - (NSDictionary<NSString *, NSString *> *)speechSlots {
1332
+ return [self speechSlotsWithTool:self.lastSpeechTool];
1333
+ }
1334
+ - (NSDictionary<NSString *, NSString *> *)speechSlotsWithTool:(NSString *)tool {
1335
+ NSMutableDictionary<NSString *, NSString *> *slots = [NSMutableDictionary dictionary];
1336
+ NSCalendar *calendar = NSCalendar.currentCalendar;
1337
+ slots[@"hour"] = [@([calendar component:NSCalendarUnitHour fromDate:NSDate.date]) stringValue];
1338
+ if (self.consecutiveFailures > 0) {
1339
+ slots[@"failCount"] = [@(self.consecutiveFailures) stringValue];
1340
+ }
1341
+ if (self.sessionStartedAt > 0) {
1342
+ NSInteger minutes = (NSInteger)((NSDate.date.timeIntervalSince1970 -
1343
+ self.sessionStartedAt) / 60.0);
1344
+ if (minutes > 0) slots[@"sessionMin"] = [@(minutes) stringValue];
1345
+ }
1346
+ NSInteger remaining = [self remainingFiveHourQuotaPercent];
1347
+ if (remaining >= 0) {
1348
+ slots[@"quota5h"] = [NSString stringWithFormat:@"%ld%%", (long)remaining];
1349
+ }
1350
+ NSString *reset = [self fiveHourResetTimeText];
1351
+ if (reset.length > 0) slots[@"resetTime"] = reset;
1352
+ // 工具名此前从来没被填过,导致 "{toolName} 这货不靠谱。" 这类台词永远被跳过。
1353
+ NSString *trimmed = [tool stringByTrimmingCharactersInSet:
1354
+ NSCharacterSet.whitespaceCharacterSet];
1355
+ if (trimmed.length > 0 && trimmed.length <= 24) slots[@"toolName"] = trimmed;
1356
+ return slots;
1357
+ }
1358
+ // 5 小时窗口的剩余百分比,取不到返回 -1。Claude 和 Codex 的字段名不一样,都认。
1359
+ - (NSInteger)remainingFiveHourQuotaPercent {
1360
+ NSDictionary *usage = LatestClaudeUsage() ?: LatestUsage();
1361
+ NSDictionary *fiveHour = [usage[@"fiveHour"] isKindOfClass:NSDictionary.class]
1362
+ ? usage[@"fiveHour"] : nil;
1363
+ id used = fiveHour[@"used_percentage"] ?: fiveHour[@"used_percent"];
1364
+ if (![used isKindOfClass:NSNumber.class]) return -1;
1365
+ NSInteger remaining = 100 - [used integerValue];
1366
+ return MAX((NSInteger)0, MIN((NSInteger)100, remaining));
1367
+ }
1368
+ // 回血时间,按本机时区格式化。没有这个槽位的话,带 {resetTime} 的词条会被整条跳过。
1369
+ - (NSString *)fiveHourResetTimeText {
1370
+ NSDictionary *usage = LatestClaudeUsage() ?: LatestUsage();
1371
+ NSDictionary *fiveHour = [usage[@"fiveHour"] isKindOfClass:NSDictionary.class]
1372
+ ? usage[@"fiveHour"] : nil;
1373
+ id resets = fiveHour[@"resets_at"];
1374
+ if (![resets isKindOfClass:NSNumber.class]) return nil;
1375
+ NSTimeInterval at = [resets doubleValue];
1376
+ if (at <= NSDate.date.timeIntervalSince1970) return nil;
1377
+ NSDateFormatter *formatter = [NSDateFormatter new];
1378
+ formatter.dateFormat = @"HH:mm";
1379
+ formatter.timeZone = NSTimeZone.systemTimeZone;
1380
+ return [formatter stringFromDate:[NSDate dateWithTimeIntervalSince1970:at]];
1381
+ }
1382
+ // 额度是"跨阈值"事件,不是状态事件,所以单独判档。
1383
+ //
1384
+ // 只在向下穿档时说一次:低于 20%% 就一直念叨会变成唠叨,而额度刷新是每分钟级别的,
1385
+ // 不设档位的话一小时预算瞬间就被烧光。回血(档位回升)时把标记还回去,
1386
+ // 下个周期才能再触发。
1387
+ - (void)considerQuotaSpeech {
1388
+ NSInteger remaining = [self remainingFiveHourQuotaPercent];
1389
+ if (remaining < 0) return;
1390
+ NSInteger tier;
1391
+ if (remaining <= 5) tier = 0;
1392
+ else if (remaining <= 10) tier = 1;
1393
+ else if (remaining <= 20) tier = 2;
1394
+ else tier = 3;
1395
+
1396
+ NSInteger previous = self.lastQuotaTier;
1397
+ self.lastQuotaTier = tier;
1398
+ // 首次拿到数据只记档不出声,免得每次启动都通报一遍额度。
1399
+ // (lastQuotaTier 的初值 0 恰好是最低档,不加这道判断的话冷启动必然误判成"刚跌到 5%"。)
1400
+ if (!self.lastQuotaTierInitialized) {
1401
+ self.lastQuotaTierInitialized = YES;
1402
+ return;
1403
+ }
1404
+ if (tier >= previous) return; // 回血或没跨档
1405
+ [self speakWithTag:PetPhraseTagQuotaLow];
1406
+ }
1407
+ - (void)buildSpeechPanelIfNeeded {
1408
+ if (self.speechPanel) return;
1409
+ NSSize glassSize = NSMakeSize(210, PetSpeechBodyHeight);
1410
+ NSSize size = NSMakeSize(glassSize.width + 12, glassSize.height + 12);
1411
+ self.speechPanel = [[NSPanel alloc] initWithContentRect:NSMakeRect(0, 0, size.width, size.height)
1412
+ styleMask:NSWindowStyleMaskBorderless | NSWindowStyleMaskNonactivatingPanel
1413
+ backing:NSBackingStoreBuffered defer:NO];
1414
+ self.speechPanel.opaque = NO;
1415
+ self.speechPanel.backgroundColor = NSColor.clearColor;
1416
+ self.speechPanel.hasShadow = NO;
1417
+ self.speechPanel.level = NSFloatingWindowLevel;
1418
+ self.speechPanel.collectionBehavior = NSWindowCollectionBehaviorCanJoinAllSpaces |
1419
+ NSWindowCollectionBehaviorFullScreenAuxiliary;
1420
+ // 气泡不抢焦点、不接受点击:它是纯播报,挡住宠物就本末倒置了。
1421
+ self.speechPanel.ignoresMouseEvents = YES;
1422
+
1423
+ NSView *root = [[NSView alloc] initWithFrame:NSMakeRect(0, 0, size.width, size.height)];
1424
+ self.speechGlass = [[NSVisualEffectView alloc]
1425
+ initWithFrame:NSMakeRect(6, 6, glassSize.width, glassSize.height)];
1426
+ self.speechGlass.material = NSVisualEffectMaterialPopover;
1427
+ self.speechGlass.blendingMode = NSVisualEffectBlendingModeBehindWindow;
1428
+ self.speechGlass.state = NSVisualEffectStateActive;
1429
+ self.speechGlass.appearance = [NSAppearance appearanceNamed:NSAppearanceNameAqua];
1430
+ self.speechGlass.wantsLayer = YES;
1431
+ // 圆角交给 layer 自己:cornerRadius 是 GPU 端矢量裁切,配 continuous 曲率就是
1432
+ // macOS 那个 squircle。位图 maskImage 换不来这个质感。
1433
+ self.speechGlass.layer.cornerRadius = glassSize.height / 2.0;
1434
+ self.speechGlass.layer.cornerCurve = kCACornerCurveContinuous;
1435
+ self.speechGlass.layer.masksToBounds = YES;
1436
+ self.speechGlass.layer.borderWidth = 1;
1437
+ self.speechGlass.layer.borderColor = [NSColor colorWithWhite:1 alpha:0.48].CGColor;
1438
+
1439
+ self.speechLabel = [NSTextField labelWithString:@""];
1440
+ self.speechLabel.frame = NSMakeRect(14, 10, glassSize.width - 28, 18);
1441
+ // 独立气泡里这句话是唯一元素,不与标题争,比并入状态卡时大半档。
1442
+ self.speechLabel.font = [NSFont systemFontOfSize:13 weight:NSFontWeightMedium];
1443
+ self.speechLabel.textColor = [NSColor colorWithWhite:0.10 alpha:0.96];
1444
+ self.speechLabel.alignment = NSTextAlignmentCenter;
1445
+ self.speechLabel.lineBreakMode = NSLineBreakByTruncatingTail;
1446
+ [self.speechGlass addSubview:self.speechLabel];
1447
+ [root addSubview:self.speechGlass];
1448
+ self.speechPanel.contentView = root;
1449
+ }
1450
+ // 独立气泡只在没有状态卡时出现(有状态卡时话并进它的副行),所以固定放宠物头顶即可,
1451
+ // 不用再和状态卡抢位置。
1452
+ - (void)positionSpeechPanel {
1453
+ NSRect petFrame = self.panel.frame;
1454
+ NSRect visible = (self.panel.screen ?: NSScreen.mainScreen).visibleFrame;
1455
+ NSSize size = self.speechPanel.frame.size;
1456
+ CGFloat x = NSMidX(petFrame) - size.width / 2.0;
1457
+ // 头顶放不下就翻到脚下,尾巴跟着改朝向长在顶边。
1458
+ CGFloat aboveY = NSMaxY(petFrame) - 6;
1459
+ BOOL fitsAbove = aboveY + size.height <= NSMaxY(visible) - 10;
1460
+ CGFloat y = fitsAbove ? aboveY : NSMinY(petFrame) - size.height + 6;
1461
+ x = fmax(NSMinX(visible) + 10, fmin(x, NSMaxX(visible) - size.width - 10));
1462
+ y = fmax(NSMinY(visible) + 10, fmin(y, NSMaxY(visible) - size.height - 10));
1463
+ [self.speechPanel setFrameOrigin:NSMakePoint(x, y)];
1464
+ }
1465
+ // 说一句。tag 取不到词条、预算用完、或状态卡正展开时都直接不说——
1466
+ // 两个泡同时挂在宠物头上会很吵。
1467
+ - (void)speakWithTag:(NSString *)tag {
1468
+ if (![self canSpeakNow]) return;
1469
+ NSString *text = PetPhraseForTag(tag, [self speechSlots]);
1470
+ if (text.length == 0) return;
1471
+
1472
+ NSTimeInterval now = NSDate.date.timeIntervalSince1970;
1473
+ [self.speechTimestamps addObject:@(now)];
1474
+ self.speechCooldownUntil = now + [self speechCooldownSeconds];
1475
+
1476
+ [self presentSpeechText:text];
1477
+ }
1478
+ // 话往哪儿显示只在这一处决定:有状态卡就并进它的副行,没有才起独立气泡。
1479
+ // 调试触发也必须走这里——否则看到的是现实中不会出现的画面(两个泡叠着)。
1480
+ - (void)presentSpeechText:(NSString *)text {
1481
+ if (text.length == 0) return;
1482
+ if (self.statusPanel.isVisible) {
1483
+ self.statusDetailLabel.stringValue = text;
1484
+ self.lastPetVoiceText = text;
1485
+ [self resizeStatusCardToFitText];
1486
+ [self positionAgentStatus];
1487
+ // 上一句的独立气泡可能还没淡完,收掉它,别和状态卡叠着。
1488
+ [self hideSpeechBubble];
1489
+ return;
1490
+ }
1491
+ [self showSpeechBubbleWithText:text];
1492
+ }
1493
+ - (void)showSpeechBubbleWithText:(NSString *)text {
1494
+ [self buildSpeechPanelIfNeeded];
1495
+ self.speechLabel.stringValue = text;
1496
+ [self resizeSpeechBubbleToFitText];
1497
+ [self positionSpeechPanel];
1498
+ self.speechPanel.alphaValue = 0;
1499
+ [self.speechPanel orderFront:nil];
1500
+ [NSAnimationContext runAnimationGroup:^(NSAnimationContext *context) {
1501
+ context.duration = 0.18;
1502
+ self.speechPanel.animator.alphaValue = 1.0;
1503
+ } completionHandler:nil];
1504
+ [NSObject cancelPreviousPerformRequestsWithTarget:self
1505
+ selector:@selector(hideSpeechBubble) object:nil];
1506
+ [self performSelector:@selector(hideSpeechBubble) withObject:nil afterDelay:PetSpeechDwell];
1507
+ }
1508
+ // 调试触发:写一个标签进 defaults,下一跳(≤3 秒)就强制弹一次独立气泡,
1509
+ // 绕开安静期、概率、预算和状态卡判断,弹完自动把键删掉,不会残留。
1510
+ // defaults write com.universewang.cc-pets CCPetsSpeechDebugTag -string idle
1511
+ // 标签可填 idle / done / fail / quota_low / late_night / long_session / wake
1512
+ - (void)consumeSpeechDebugTrigger {
1513
+ NSUserDefaults *defaults = NSUserDefaults.standardUserDefaults;
1514
+ id value = [defaults objectForKey:@"CCPetsSpeechDebugTag"];
1515
+ if (![value isKindOfClass:NSString.class] || [value length] == 0) return;
1516
+ [defaults removeObjectForKey:@"CCPetsSpeechDebugTag"];
1517
+ NSString *text = PetPhraseForTag(value, [self speechSlots]);
1518
+ if (text.length == 0) text = @"(这个标签取不到词条)";
1519
+ [self presentSpeechText:text];
1520
+ }
1521
+ - (void)hideSpeechBubble {
1522
+ if (!self.speechPanel) return;
1523
+ [NSAnimationContext runAnimationGroup:^(NSAnimationContext *context) {
1524
+ context.duration = 0.22;
1525
+ self.speechPanel.animator.alphaValue = 0;
1526
+ } completionHandler:^{
1527
+ if (self.speechPanel.alphaValue <= 0.01) [self.speechPanel orderOut:nil];
1528
+ }];
1529
+ }
1530
+ // 闲着时候的自发说话。
1531
+ //
1532
+ // 光挂在 agent 事件流上是不够的:那样宠物永远只会就着工作说话,late_night /
1533
+ // long_session / idle 这些词条根本没有属于自己的触发时机,独立气泡也永远不会出现
1534
+ // (agent 事件必定先把状态卡显示出来,话就并进去了)。
1535
+ //
1536
+ // 挂在已有的客户端存活定时器上,不新起 timer——常驻唤醒一个都不该多。
1537
+ - (void)considerIdleSpeech {
1538
+ [self consumeSpeechDebugTrigger];
1539
+ NSTimeInterval now = NSDate.date.timeIntervalSince1970;
1540
+ // 真正的判断最多 30 秒做一次,3 秒一跳的定时器上不必每次都算。
1541
+ if (now - self.lastIdleSpeechCheck < 30.0) return;
1542
+ self.lastIdleSpeechCheck = now;
1543
+ // 有状态卡在说话就不插嘴;这条路径专属于"屏幕上什么都没有"的时候。
1544
+ if (self.statusPanel.isVisible) return;
1545
+ if (![self canSpeakNow]) return;
1546
+
1547
+ // 安静多久才算"没人打扰"。复用无聊曲线那个缩放旋钮,测试时一并压缩。
1548
+ double scale = 1.0;
1549
+ id scaleValue = [NSUserDefaults.standardUserDefaults objectForKey:@"CCPetsBoredomScale"];
1550
+ if ([scaleValue isKindOfClass:NSNumber.class] && [scaleValue doubleValue] > 0) {
1551
+ scale = MIN([scaleValue doubleValue], 10.0);
1552
+ }
1553
+ NSTimeInterval quiet = self.lastAgentEventAt > 0 ? now - self.lastAgentEventAt : now;
1554
+ if (quiet < 180.0 * scale) return;
1555
+
1556
+ // 不是每次够条件都说:概率化,免得变成整点报时。
1557
+ if (arc4random_uniform(100) >= 25) return;
1558
+
1559
+ NSInteger hour = [NSCalendar.currentCalendar component:NSCalendarUnitHour fromDate:NSDate.date];
1560
+ NSTimeInterval sessionLength = self.sessionStartedAt > 0 ? now - self.sessionStartedAt : 0;
1561
+ if (hour >= 1 && hour < 5) [self speakWithTag:PetPhraseTagLateNight];
1562
+ else if (sessionLength > 90 * 60.0) [self speakWithTag:PetPhraseTagLongSession];
1563
+ else [self speakWithTag:PetPhraseTagIdle];
1564
+ }
1565
+ // 只在显著时刻说话,不是每个 agent 事件都冒泡。
1566
+ - (void)considerSpeechForRecord:(NSDictionary *)record {
1567
+ self.lastAgentEventAt = NSDate.date.timeIntervalSince1970;
1568
+ NSString *tool = [record[@"tool"] isKindOfClass:NSString.class] ? record[@"tool"] : nil;
1569
+ if (tool.length > 0) self.lastSpeechTool = tool;
1570
+ NSString *state = [record[@"state"] isKindOfClass:NSString.class] ? record[@"state"] : @"";
1571
+ NSString *event = [record[@"event"] isKindOfClass:NSString.class] ? record[@"event"] : @"";
1572
+ BOOL failed = [record[@"failed"] boolValue];
1573
+ NSTimeInterval now = NSDate.date.timeIntervalSince1970;
1574
+
1575
+ if ([event isEqualToString:@"SessionStart"]) {
1576
+ // 久别重逢:距上次会话超过 4 小时才算,不然每开一个终端都要寒暄一遍。
1577
+ BOOL longGap = self.sessionStartedAt <= 0 || now - self.sessionStartedAt > 4 * 3600.0;
1578
+ self.sessionStartedAt = now;
1579
+ self.consecutiveFailures = 0;
1580
+ if (longGap) [self speakWithTag:PetPhraseTagWake];
1581
+ return;
1582
+ }
1583
+ if (failed) {
1584
+ self.consecutiveFailures += 1;
1585
+ // 单次失败很常见,连续两次才值得出声。
1586
+ if (self.consecutiveFailures >= 2) [self speakWithTag:PetPhraseTagFail];
1587
+ return;
1588
+ }
1589
+ if ([state isEqualToString:@"completed"]) {
1590
+ self.consecutiveFailures = 0;
1591
+ NSInteger hour = [NSCalendar.currentCalendar component:NSCalendarUnitHour
1592
+ fromDate:NSDate.date];
1593
+ NSTimeInterval sessionLength = self.sessionStartedAt > 0 ? now - self.sessionStartedAt : 0;
1594
+ // 同一时刻可能同时满足几个情境,按"更值得一提"的顺序挑一个说,不叠着说。
1595
+ if (hour >= 1 && hour < 5) [self speakWithTag:PetPhraseTagLateNight];
1596
+ else if (sessionLength > 90 * 60.0) [self speakWithTag:PetPhraseTagLongSession];
1597
+ else [self speakWithTag:PetPhraseTagDone];
1598
+ }
1599
+ }
1600
+ #pragma mark - 宽度自适应
1601
+
1602
+ // 卡片和气泡都按文案实际宽度伸缩。固定宽度下"收工!"和"到处翻资料呢。"占一样长的条,
1603
+ // 前者会拖着一大截空白,看着像没加载完。
1604
+ // 用控件自己的 fittingSize 量,不要用 sizeWithAttributes:。
1605
+ // NSTextField 的 cell 有一点内部留白,纯按字符串量出来的宽度会比控件真正需要的小几个点,
1606
+ // 结果就是明明算着"刚好够",显示出来最后一两个字变成省略号。
1607
+ static CGFloat PetMeasuredLabelWidth(NSTextField *label) {
1608
+ if (label.stringValue.length == 0) return 0;
1609
+ return ceil(label.fittingSize.width) + 2;
1610
+ }
1611
+ // 状态卡:左内边距 20 + 文字 + 间隙 8 + 图标 34 + 右内边距 14。
1612
+ - (void)resizeStatusCardToFitText {
1613
+ const CGFloat leading = 20, gap = 8, iconWidth = 34, trailing = 14;
1614
+ CGFloat height = PetStatusBodyHeight;
1615
+ CGFloat textWidth = fmax(PetMeasuredLabelWidth(self.statusTitleLabel),
1616
+ PetMeasuredLabelWidth(self.statusDetailLabel));
1617
+ CGFloat glassWidth = leading + textWidth + gap + iconWidth + trailing;
1618
+ glassWidth = fmax(210.0, fmin(glassWidth, 420.0));
1619
+ if (fabs(NSWidth(self.statusGlass.frame) - glassWidth) < 0.5) return;
1620
+
1621
+ NSSize panelSize = NSMakeSize(glassWidth + 12, height + 12);
1622
+ [self.statusPanel setContentSize:panelSize];
1623
+ self.statusPanel.contentView.frame = NSMakeRect(0, 0, panelSize.width, panelSize.height);
1624
+ self.statusGlass.frame = NSMakeRect(6, 6, glassWidth, height);
1625
+ self.statusShadowView.frame = NSMakeRect(6, 6, glassWidth, height);
1626
+ // shadowPath 是按旧尺寸算死的,卡片变宽后不重算,阴影会留在原来的形状上。
1627
+ CGPathRef path = CGPathCreateWithRoundedRect(self.statusShadowView.bounds,
1628
+ height / 2.0, height / 2.0, NULL);
1629
+ self.statusShadowView.layer.shadowPath = path;
1630
+ CGPathRelease(path);
1631
+
1632
+ CGFloat labelWidth = glassWidth - leading - gap - iconWidth - trailing;
1633
+ self.statusTitleLabel.frame = NSMakeRect(leading, 34, labelWidth, 14);
1634
+ self.statusDetailLabel.frame = NSMakeRect(leading, 10, labelWidth, 22);
1635
+ self.statusIconButton.frame = NSMakeRect(glassWidth - trailing - iconWidth, 12,
1636
+ iconWidth, iconWidth);
1637
+ }
1638
+
1639
+ // 独立气泡:左右各 16 内边距,没有图标。
1640
+ - (void)resizeSpeechBubbleToFitText {
1641
+ const CGFloat padding = 16;
1642
+ CGFloat width = padding * 2 + PetMeasuredLabelWidth(self.speechLabel);
1643
+ width = fmax(96.0, fmin(width, 300.0));
1644
+ NSSize panelSize = NSMakeSize(width + 12, PetSpeechBodyHeight + 12);
1645
+ [self.speechPanel setContentSize:panelSize];
1646
+ self.speechPanel.contentView.frame = NSMakeRect(0, 0, panelSize.width, panelSize.height);
1647
+ self.speechGlass.frame = NSMakeRect(6, 6, width, PetSpeechBodyHeight);
1648
+ self.speechGlass.layer.cornerRadius = PetSpeechBodyHeight / 2.0;
1649
+ self.speechLabel.frame = NSMakeRect(padding, 10, width - padding * 2, 18);
1650
+ }
1651
+
1652
+
1653
+ // 面板底边到"最小那颗圆点底边"的距离。定位要拿它反推面板该放多高,
1654
+ // 才能让圆点正好落在宠物头顶而不是悬在空中。
1101
1655
  - (void)positionAgentStatus {
1102
1656
  NSRect petFrame = self.panel.frame;
1103
1657
  NSRect visible = (self.panel.screen ?: NSScreen.mainScreen).visibleFrame;
@@ -1323,6 +1877,7 @@ static const NSTimeInterval UsageRefreshCoalesceWindow = 2.0;
1323
1877
  self.quotaView.needsDisplay = YES;
1324
1878
  }
1325
1879
  - (void)refreshClientLifecycle:(id)sender {
1880
+ [self considerIdleSpeech];
1326
1881
  [self prunePendingApprovalRecords];
1327
1882
  NSString *clientName = [NSString stringWithFormat:@"cc-pets-%u-clients", getuid()];
1328
1883
  NSString *clientDirectory = [PetStateDirectory() stringByAppendingPathComponent:clientName];