cc-pets 2.1.1 → 2.2.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.
Files changed (74) hide show
  1. package/CC_BRIDGE.md +5 -0
  2. package/CC_BRIDGE.zh-CN.md +4 -0
  3. package/CHANGELOG.md +40 -1
  4. package/CHANGELOG.zh-CN.md +40 -1
  5. package/CONTRIBUTING.md +54 -0
  6. package/CONTRIBUTING.zh-CN.md +45 -0
  7. package/README.md +57 -14
  8. package/README.zh-CN.md +56 -14
  9. package/Resources/Info.plist +3 -1
  10. package/Resources/en.lproj/InfoPlist.strings +1 -0
  11. package/Resources/phrases.default.en.txt +182 -0
  12. package/Resources/zh-Hans.lproj/InfoPlist.strings +1 -0
  13. package/Resources/zh-Hans.lproj/Localizable.strings +332 -0
  14. package/Sources/CCPets/CCPetsAppDelegate+AgentEvents.m +215 -0
  15. package/Sources/CCPets/CCPetsAppDelegate+AgentStatus.m +660 -0
  16. package/Sources/CCPets/CCPetsAppDelegate+Bridge.m +299 -0
  17. package/Sources/CCPets/CCPetsAppDelegate+Pets.m +185 -0
  18. package/Sources/CCPets/CCPetsAppDelegate+Private.h +325 -0
  19. package/Sources/CCPets/CCPetsAppDelegate+Quota.m +216 -0
  20. package/Sources/CCPets/CCPetsAppDelegate+Settings.m +226 -0
  21. package/Sources/CCPets/CCPetsAppDelegate+Speech.m +392 -0
  22. package/Sources/CCPets/CCPetsAppDelegate+Update.m +459 -0
  23. package/Sources/CCPets/CCPetsAppDelegate.h +13 -14
  24. package/Sources/CCPets/CCPetsAppDelegate.m +68 -2466
  25. package/Sources/CCPets/CCPetsCleanup.h +4 -0
  26. package/Sources/CCPets/CCPetsCleanup.m +41 -7
  27. package/Sources/CCPets/CCPetsEvents.m +4 -3
  28. package/Sources/CCPets/CCPetsL10n.h +55 -0
  29. package/Sources/CCPets/CCPetsL10n.m +219 -0
  30. package/Sources/CCPets/CCPetsPaths.h +0 -1
  31. package/Sources/CCPets/CCPetsPaths.m +0 -1
  32. package/Sources/CCPets/CCPetsPhrases.h +7 -1
  33. package/Sources/CCPets/CCPetsPhrases.m +86 -31
  34. package/Sources/CCPets/CCPetsPhrasesEditor.m +62 -64
  35. package/Sources/CCPets/CCPetsPreviews.m +7 -6
  36. package/Sources/CCPets/CCPetsUsage.h +0 -1
  37. package/Sources/CCPets/CCPetsUsage.m +0 -3
  38. package/Sources/CCPets/CCPetsVersion.h +10 -0
  39. package/Sources/CCPets/CCPetsVersion.m +92 -2
  40. package/Sources/CCPets/MenuToggleSwitch.m +3 -2
  41. package/Sources/CCPets/PetView.h +2 -0
  42. package/Sources/CCPets/PetView.m +115 -74
  43. package/Sources/CCPets/QuotaDashboardView.m +122 -88
  44. package/Sources/CCPets/main.m +16 -1
  45. package/bin/cc-pets +25 -20
  46. package/bin/claude-with-pet +2 -1
  47. package/bin/codex-with-pet +2 -1
  48. package/package.json +5 -3
  49. package/scripts/bridge/cli.mjs +47 -39
  50. package/scripts/bridge/core.mjs +28 -27
  51. package/scripts/bridge/hook.mjs +7 -6
  52. package/scripts/bridge/install.mjs +42 -19
  53. package/scripts/bridge/mcp-server.mjs +79 -71
  54. package/scripts/bridge/options.mjs +7 -6
  55. package/scripts/bridge/process.mjs +22 -0
  56. package/scripts/bridge/reservations.mjs +6 -5
  57. package/scripts/bridge/store.mjs +10 -9
  58. package/scripts/build.sh +24 -5
  59. package/scripts/check-l10n.mjs +168 -0
  60. package/scripts/configure-updater.mjs +4 -3
  61. package/scripts/doctor.mjs +470 -0
  62. package/scripts/i18n.mjs +122 -0
  63. package/scripts/i18n.zsh +66 -0
  64. package/scripts/install-app.sh +3 -2
  65. package/scripts/install-claude-hooks.mjs +22 -27
  66. package/scripts/install-codex-hooks.mjs +10 -15
  67. package/scripts/install-shell-integration.sh +6 -5
  68. package/scripts/integration-markers.mjs +51 -0
  69. package/scripts/locales/zh-Hans.json +366 -0
  70. package/scripts/pet-store.mjs +47 -45
  71. package/scripts/uninstall-app.sh +4 -3
  72. package/scripts/uninstall-integrations.mjs +24 -51
  73. package/scripts/uninstall-shell-integration.sh +8 -7
  74. /package/Resources/{phrases.default.txt → phrases.default.zh-Hans.txt} +0 -0
@@ -0,0 +1,226 @@
1
+ // 右键菜单里的各项设置开关。
2
+ #import "CCPetsAppDelegate+Private.h"
3
+
4
+ @implementation AppDelegate (Settings)
5
+ - (NSString *)systemMetricKeyForTag:(NSInteger)tag {
6
+ if (tag == 1) return SystemCPUEnabledKey;
7
+ if (tag == 2) return SystemTemperatureEnabledKey;
8
+ if (tag == 3) return SystemMemoryEnabledKey;
9
+ return nil;
10
+ }
11
+ - (void)applySystemMetricPreferences {
12
+ NSUserDefaults *defaults = NSUserDefaults.standardUserDefaults;
13
+ self.quotaView.systemCPUEnabled = [defaults boolForKey:SystemCPUEnabledKey];
14
+ self.quotaView.systemTemperatureEnabled =
15
+ [defaults boolForKey:SystemTemperatureEnabledKey];
16
+ self.quotaView.systemMemoryEnabled = [defaults boolForKey:SystemMemoryEnabledKey];
17
+ self.quotaView.needsDisplay = YES;
18
+ }
19
+ - (void)applyUsageDisplayModePreferences {
20
+ NSUserDefaults *defaults = NSUserDefaults.standardUserDefaults;
21
+ self.quotaView.codexShowsAPIUsage =
22
+ [[defaults stringForKey:CodexUsageDisplayModeKey] isEqualToString:@"api"];
23
+ self.quotaView.claudeShowsAPIUsage =
24
+ [[defaults stringForKey:ClaudeUsageDisplayModeKey] isEqualToString:@"api"];
25
+ self.quotaView.needsDisplay = YES;
26
+ }
27
+ - (void)setUsageDisplayModeFromControl:(NSButton *)sender {
28
+ NSString *key = sender.tag == 1 ? CodexUsageDisplayModeKey
29
+ : (sender.tag == 2 ? ClaudeUsageDisplayModeKey : nil);
30
+ NSString *mode = sender.state == NSControlStateValueOn ? @"api" : @"subscription";
31
+ if (!key) return;
32
+ [NSUserDefaults.standardUserDefaults setObject:mode forKey:key];
33
+ [self applyUsageDisplayModePreferences];
34
+ // 展示模式决定了会话要回溯多远(订阅 8 天 / API 到上月月初),切换之后必须重新聚合,
35
+ // 否则刚打开 API 视图时手里只有一段按 8 天窗口扫出来的数据。
36
+ [self refreshUsage:nil];
37
+ }
38
+ - (void)toggleSystemMetric:(NSButton *)sender {
39
+ NSString *key = [self systemMetricKeyForTag:sender.tag];
40
+ if (!key) return;
41
+ NSUserDefaults *defaults = NSUserDefaults.standardUserDefaults;
42
+ BOOL enabled = ![defaults boolForKey:key];
43
+ [defaults setBool:enabled forKey:key];
44
+ sender.state = enabled ? NSControlStateValueOn : NSControlStateValueOff;
45
+ [self applySystemMetricPreferences];
46
+ [self updateSystemMetricsTimer];
47
+ }
48
+ // 开关打开时立刻导入一次,不用等下次启动——用户点开关就是想现在看到那些素材。
49
+ - (void)toggleImportCodexPets:(NSButton *)sender {
50
+ NSUserDefaults *defaults = NSUserDefaults.standardUserDefaults;
51
+ BOOL enabled = ![defaults boolForKey:ImportCodexPetsKey];
52
+ [defaults setBool:enabled forKey:ImportCodexPetsKey];
53
+ sender.state = enabled ? NSControlStateValueOn : NSControlStateValueOff;
54
+ if (!enabled) return;
55
+ NSUInteger imported = ImportCodexPets();
56
+ if (imported == 0) return;
57
+ [self invalidatePetOptionsCache];
58
+ [self showImportedCodexPetsAlert:imported];
59
+ }
60
+ - (void)showImportedCodexPetsAlert:(NSUInteger)imported {
61
+ [NSApp activateIgnoringOtherApps:YES];
62
+ NSAlert *alert = [NSAlert new];
63
+ alert.messageText = L(@"Codex Pets Imported");
64
+ [alert addButtonWithTitle:L(@"OK")];
65
+ [alert runModal];
66
+ }
67
+ - (NSString *)notificationKeyForTag:(NSInteger)tag {
68
+ if (tag == 1) return NotificationCompletionKey;
69
+ if (tag == 2) return NotificationFailureKey;
70
+ if (tag == 3) return NotificationApprovalKey;
71
+ if (tag == 4) return NotificationStallKey;
72
+ return nil;
73
+ }
74
+ // sender 是菜单里的 MenuChoiceRowView,勾选状态由它自己更新。
75
+ - (void)setPanelTheme:(MenuChoiceRowView *)sender {
76
+ NSString *theme = sender.representedObject;
77
+ if (![@[@"classic", @"liquid"] containsObject:theme]) return;
78
+ [NSUserDefaults.standardUserDefaults setObject:theme forKey:CCPetsPanelThemeKey];
79
+ [self.statusGlass applyTheme];
80
+ [self.speechGlass applyTheme];
81
+ [self.quotaGlass applyTheme];
82
+ [self.updateBadgeGlass applyTheme];
83
+ self.statusShadowView.hidden = self.statusGlass.usesLiquidGlass;
84
+ self.quotaView.usesLiquidGlass = self.quotaGlass.usesLiquidGlass;
85
+ self.quotaView.cardScrimAlpha = CCPetsGlassCardScrimAlpha();
86
+ self.quotaView.needsDisplay = YES;
87
+ [self applyBubbleTextStyle];
88
+ // quotaView 换了父视图,mouseExited 不一定会送达;切主题是在宠物右键菜单里点的,
89
+ // 鼠标此刻不在面板上,直接复位,免得面板一直当作"悬停中"不收起。
90
+ self.dashboardHovering = NO;
91
+ }
92
+ // 状态卡和说话气泡原来是浅色磨砂配深色字;换成原生清透玻璃后背景是任意壁纸加一层
93
+ // 压暗,深色字会看不见,改成白字加贴字形的投影,和额度面板一致。
94
+ - (void)applyBubbleTextStyle {
95
+ NSShadow *shadow = [NSShadow new];
96
+ shadow.shadowColor = [NSColor colorWithWhite:0 alpha:0.45];
97
+ shadow.shadowBlurRadius = 2;
98
+ shadow.shadowOffset = NSMakeSize(0, -0.5);
99
+ BOOL statusLiquid = self.statusGlass.usesLiquidGlass;
100
+ self.statusTitleLabel.textColor = statusLiquid ? [NSColor colorWithWhite:1 alpha:0.78]
101
+ : [NSColor colorWithWhite:0.42 alpha:0.90];
102
+ self.statusDetailLabel.textColor = statusLiquid ? [NSColor colorWithWhite:1 alpha:0.97]
103
+ : [NSColor colorWithWhite:0.12 alpha:0.96];
104
+ self.statusTitleLabel.shadow = statusLiquid ? shadow : nil;
105
+ self.statusDetailLabel.shadow = statusLiquid ? shadow : nil;
106
+ BOOL speechLiquid = self.speechGlass.usesLiquidGlass;
107
+ self.speechLabel.textColor = speechLiquid ? [NSColor colorWithWhite:1 alpha:0.97]
108
+ : [NSColor colorWithWhite:0.10 alpha:0.96];
109
+ self.speechLabel.shadow = speechLiquid ? shadow : nil;
110
+ [self applyUpdateBadgeStyle];
111
+ }
112
+ - (void)setGlassDimLevel:(MenuChoiceRowView *)sender {
113
+ NSNumber *level = sender.representedObject;
114
+ if (![CCPetsGlassDimLevels() containsObject:level]) return;
115
+ [NSUserDefaults.standardUserDefaults setObject:level forKey:CCPetsGlassDimKey];
116
+ [self.quotaGlass applyDimLevel];
117
+ [self.statusGlass applyDimLevel];
118
+ [self.speechGlass applyDimLevel];
119
+ [self.updateBadgeGlass applyDimLevel];
120
+ self.quotaView.cardScrimAlpha = CCPetsGlassCardScrimAlpha();
121
+ self.quotaView.needsDisplay = YES;
122
+ }
123
+ - (void)toggleSpeech:(NSButton *)sender {
124
+ NSUserDefaults *defaults = NSUserDefaults.standardUserDefaults;
125
+ id current = [defaults objectForKey:@"CCPetsSpeechEnabled"];
126
+ BOOL enabled = current == nil ? YES : [current boolValue];
127
+ [defaults setBool:!enabled forKey:@"CCPetsSpeechEnabled"];
128
+ sender.state = !enabled ? NSControlStateValueOn : NSControlStateValueOff;
129
+ // 更新提示不算碎碎念,关掉碎碎念时不收它。
130
+ if (enabled && !self.updateBubbleVisible) [self hideSpeechBubble];
131
+ }
132
+ - (void)togglePetInteraction:(NSButton *)sender {
133
+ NSUserDefaults *defaults = NSUserDefaults.standardUserDefaults;
134
+ BOOL enabled = ![defaults boolForKey:PetInteractionEnabledKey];
135
+ [defaults setBool:enabled forKey:PetInteractionEnabledKey];
136
+ sender.state = enabled ? NSControlStateValueOn : NSControlStateValueOff;
137
+ }
138
+ - (void)setPetInteractionHeartThreshold:(NSMenuItem *)sender {
139
+ NSNumber *value = [sender.representedObject isKindOfClass:NSNumber.class] ?
140
+ sender.representedObject : @3;
141
+ [NSUserDefaults.standardUserDefaults setInteger:MAX((NSInteger)2, value.integerValue)
142
+ forKey:PetInteractionHeartThresholdKey];
143
+ }
144
+ - (void)setPetInteractionAnnoyedThreshold:(NSMenuItem *)sender {
145
+ NSNumber *value = [sender.representedObject isKindOfClass:NSNumber.class] ?
146
+ sender.representedObject : @10;
147
+ NSInteger heart = MAX((NSInteger)2, [NSUserDefaults.standardUserDefaults
148
+ integerForKey:PetInteractionHeartThresholdKey]);
149
+ [NSUserDefaults.standardUserDefaults setInteger:MAX(heart + 1, value.integerValue)
150
+ forKey:PetInteractionAnnoyedThresholdKey];
151
+ }
152
+ - (void)setPetInteractionInterval:(NSMenuItem *)sender {
153
+ NSNumber *value = [sender.representedObject isKindOfClass:NSNumber.class] ?
154
+ sender.representedObject : @1.2;
155
+ [NSUserDefaults.standardUserDefaults setDouble:MAX(0.4, MIN(3.0, value.doubleValue))
156
+ forKey:PetInteractionIntervalKey];
157
+ }
158
+ // 频率档位。改完立刻生效——四道闸都是现读的,不缓存。
159
+ // 顺手把冷却清掉,否则刚调高档位还要等完上一档的冷却才见效,会让人以为没生效。
160
+ - (void)setSpeechFrequency:(NSMenuItem *)sender {
161
+ NSString *value = [sender.representedObject isKindOfClass:NSString.class] ?
162
+ sender.representedObject : PetSpeechFrequencyNormal;
163
+ [NSUserDefaults.standardUserDefaults setObject:value forKey:PetSpeechFrequencyKey];
164
+ self.speechCooldownUntil = 0;
165
+ self.lastIdleSpeechCheck = 0;
166
+ }
167
+ // 台词交给内置编辑器,不再 openURL: 丢给"文本编辑"。
168
+ //
169
+ // 换掉的理由是反馈:系统编辑器保存完什么都不会说,小节名拼错、句子超 30 字、槽位
170
+ // 写错名字全是静默失效,用户只知道"改了没用"。内置编辑器保存时校验并当场报出来,
171
+ // 还能"试说一句"直接听效果。
172
+ - (void)editPhrasesFile:(id)sender {
173
+ // 编辑器只管文本,不认识气泡;把"说出来"这一步作为回调注入。
174
+ __weak typeof(self) weakSelf = self;
175
+ [PetPhrasesEditorController setSpeakHandler:^(NSString *text) {
176
+ [weakSelf presentSpeechText:text];
177
+ }];
178
+ [PetPhrasesEditorController present];
179
+ }
180
+ - (void)toggleNotification:(NSButton *)sender {
181
+ NSString *key = [self notificationKeyForTag:sender.tag];
182
+ if (!key) return;
183
+ NSUserDefaults *defaults = NSUserDefaults.standardUserDefaults;
184
+ if ([defaults boolForKey:key]) {
185
+ [defaults setBool:NO forKey:key];
186
+ sender.state = NSControlStateValueOff;
187
+ return;
188
+ }
189
+ [UNUserNotificationCenter.currentNotificationCenter
190
+ requestAuthorizationWithOptions:UNAuthorizationOptionAlert | UNAuthorizationOptionSound
191
+ completionHandler:^(BOOL granted, NSError *error) {
192
+ dispatch_async(dispatch_get_main_queue(), ^{
193
+ if (granted) {
194
+ [defaults setBool:YES forKey:key];
195
+ sender.state = NSControlStateValueOn;
196
+ } else {
197
+ sender.state = NSControlStateValueOff;
198
+ NSString *message = error.localizedDescription ?:
199
+ L(@"Allow notifications in System Settings → Notifications → CC Pets, then try again.");
200
+ [self showAlertWithTitle:L(@"Can't Enable Notifications") message:message];
201
+ }
202
+ });
203
+ }];
204
+ }
205
+ // 菜单每次右键现建,切换后下次打开就是新语言;这里只刷新常驻的界面。
206
+ - (void)setLanguagePreferenceFromMenu:(NSMenuItem *)sender {
207
+ NSString *preference = [sender.representedObject isKindOfClass:NSString.class] ?
208
+ sender.representedObject : CCPetsLanguageSystem;
209
+ if ([preference isEqualToString:CCPetsLanguagePreference()]) return;
210
+ CCPetsSetLanguagePreference(preference);
211
+ }
212
+ - (void)languageDidChange:(NSNotification *)notification {
213
+ PetPhrasesAdoptLanguageDefaults();
214
+ NSApp.mainMenu = nil;
215
+ [self installEditMenu];
216
+ self.quotaView.needsDisplay = YES;
217
+ // 状态卡标题和副行都是按状态现算的,按最后的状态重排一遍。工具名没留,
218
+ // 工具态会暂时退成"正在使用工具",下一条事件就会补回来。
219
+ if (self.hasAgentStatus && self.lastStatusState.length > 0) {
220
+ [self applyStatusPresentationForState:self.lastStatusState
221
+ provider:self.lastStatusProvider ?: @"Agent" tool:@""];
222
+ }
223
+ // 正在显示的碎碎念是旧语言的,收起即可,下一句自然是新语言。更新提示由更新逻辑自己重排。
224
+ if (!self.updateBubbleVisible) [self hideSpeechBubble];
225
+ }
226
+ @end
@@ -0,0 +1,392 @@
1
+ // 说话气泡与碎碎念。
2
+ #import "CCPetsAppDelegate+Private.h"
3
+
4
+ // 档位写进 defaults 的键;PetView 的右键菜单也要读它。
5
+ NSString *const PetSpeechFrequencyKey = @"CCPetsSpeechFrequency";
6
+
7
+ @implementation AppDelegate (Speech)
8
+ - (BOOL)speechEnabled {
9
+ NSUserDefaults *defaults = NSUserDefaults.standardUserDefaults;
10
+ // 缺省开启;用户可在右键菜单里关掉。
11
+ id value = [defaults objectForKey:@"CCPetsSpeechEnabled"];
12
+ return value == nil ? YES : [value boolValue];
13
+ }
14
+ // 当前档位。现读,右键菜单里改完立刻生效不用重启。
15
+ - (PetSpeechRate)speechRate {
16
+ NSString *value = [NSUserDefaults.standardUserDefaults stringForKey:PetSpeechFrequencyKey];
17
+ if ([value isEqualToString:PetSpeechFrequencyLow]) return PetSpeechRateLow;
18
+ if ([value isEqualToString:PetSpeechFrequencyHigh]) return PetSpeechRateHigh;
19
+ if ([value isEqualToString:PetSpeechFrequencyChatty]) return PetSpeechRateChatty;
20
+ return PetSpeechRateNormal;
21
+ }
22
+ // 预算与冷却。两道闸门都过了才允许说。
23
+ // 默认跟随上面的档位;下面这两个键是更细的手动覆盖,写了就压过档位,
24
+ // 现读,改完立刻生效不用重启:
25
+ // defaults write com.universewang.cc-pets CCPetsSpeechCooldown -float 0
26
+ // defaults write com.universewang.cc-pets CCPetsSpeechHourlyBudget -int 100
27
+ // defaults delete com.universewang.cc-pets CCPetsSpeechCooldown # 交回档位
28
+ // 域名是 bundle identifier,不是 "cc-pets"——写错域的话键会落在另一个 plist 里,
29
+ // 桌宠永远看不到,表现为"设了没反应"。
30
+ - (NSTimeInterval)speechCooldownSeconds {
31
+ id value = [NSUserDefaults.standardUserDefaults objectForKey:@"CCPetsSpeechCooldown"];
32
+ if (![value isKindOfClass:NSNumber.class]) return [self speechRate].cooldown;
33
+ return MAX(0.0, [value doubleValue]);
34
+ }
35
+ - (NSInteger)speechHourlyBudget {
36
+ id value = [NSUserDefaults.standardUserDefaults objectForKey:@"CCPetsSpeechHourlyBudget"];
37
+ if (![value isKindOfClass:NSNumber.class]) return [self speechRate].hourlyBudget;
38
+ return MAX((NSInteger)1, [value integerValue]);
39
+ }
40
+ // agent 是不是正在干活。只有"待机中"和状态卡压根没显示这两种情况算闲——
41
+ // thinking / tool / subagent / approval / notification / completed / failed
42
+ // 副行上都带着用户还需要看的信息,闲话一律让路。
43
+ // 用 hasAgentStatus 而不是 statusPanel.isVisible:用户把状态卡折叠起来时卡片是隐藏的,
44
+ // 但 agent 照样在干活,这时候冒气泡等于绕过折叠又把话糊到脸上。
45
+ - (BOOL)agentBusyForSpeech {
46
+ if (!self.hasAgentStatus) return NO;
47
+ return ![self.lastStatusState isEqualToString:@"idle"];
48
+ }
49
+ - (BOOL)canSpeakNow {
50
+ if (![self speechEnabled]) return NO;
51
+ NSTimeInterval now = NSDate.date.timeIntervalSince1970;
52
+ if (now < self.speechCooldownUntil) return NO;
53
+ if (!self.speechTimestamps) self.speechTimestamps = [NSMutableArray array];
54
+ while (self.speechTimestamps.count > 0 &&
55
+ now - self.speechTimestamps.firstObject.doubleValue > 3600.0) {
56
+ [self.speechTimestamps removeObjectAtIndex:0];
57
+ }
58
+ return (NSInteger)self.speechTimestamps.count < [self speechHourlyBudget];
59
+ }
60
+ // 当前可用的槽位值。取不到的键就不放进去,模板层会因此跳过需要它的那些条目。
61
+ - (NSDictionary<NSString *, NSString *> *)speechSlots {
62
+ return [self speechSlotsWithTool:self.lastSpeechTool];
63
+ }
64
+ - (NSDictionary<NSString *, NSString *> *)speechSlotsWithTool:(NSString *)tool {
65
+ NSMutableDictionary<NSString *, NSString *> *slots = [NSMutableDictionary dictionary];
66
+ NSCalendar *calendar = NSCalendar.currentCalendar;
67
+ slots[@"hour"] = [@([calendar component:NSCalendarUnitHour fromDate:NSDate.date]) stringValue];
68
+ if (self.consecutiveFailures > 0) {
69
+ slots[@"failCount"] = [@(self.consecutiveFailures) stringValue];
70
+ }
71
+ if (self.sessionStartedAt > 0) {
72
+ NSInteger minutes = (NSInteger)((NSDate.date.timeIntervalSince1970 -
73
+ self.sessionStartedAt) / 60.0);
74
+ if (minutes > 0) slots[@"sessionMin"] = [@(minutes) stringValue];
75
+ }
76
+ NSInteger remaining = [self remainingFiveHourQuotaPercent];
77
+ if (remaining >= 0) {
78
+ slots[@"quota5h"] = [NSString stringWithFormat:@"%ld%%", (long)remaining];
79
+ }
80
+ NSString *reset = [self fiveHourResetTimeText];
81
+ if (reset.length > 0) slots[@"resetTime"] = reset;
82
+ // 工具名此前从来没被填过,导致 "{toolName} 这货不靠谱。" 这类台词永远被跳过。
83
+ NSString *trimmed = [tool stringByTrimmingCharactersInSet:
84
+ NSCharacterSet.whitespaceCharacterSet];
85
+ if (trimmed.length > 0 && trimmed.length <= 24) slots[@"toolName"] = trimmed;
86
+ return slots;
87
+ }
88
+ // 5 小时窗口的剩余百分比,取不到返回 -1。Claude 和 Codex 的字段名不一样,都认。
89
+ - (NSInteger)remainingFiveHourQuotaPercent {
90
+ NSDictionary *usage = LatestClaudeUsage() ?: LatestUsage();
91
+ NSDictionary *fiveHour = [usage[@"fiveHour"] isKindOfClass:NSDictionary.class]
92
+ ? usage[@"fiveHour"] : nil;
93
+ id used = fiveHour[@"used_percentage"] ?: fiveHour[@"used_percent"];
94
+ if (![used isKindOfClass:NSNumber.class]) return -1;
95
+ NSInteger remaining = 100 - [used integerValue];
96
+ return MAX((NSInteger)0, MIN((NSInteger)100, remaining));
97
+ }
98
+ // 回血时间,按本机时区格式化。没有这个槽位的话,带 {resetTime} 的词条会被整条跳过。
99
+ - (NSString *)fiveHourResetTimeText {
100
+ NSDictionary *usage = LatestClaudeUsage() ?: LatestUsage();
101
+ NSDictionary *fiveHour = [usage[@"fiveHour"] isKindOfClass:NSDictionary.class]
102
+ ? usage[@"fiveHour"] : nil;
103
+ id resets = fiveHour[@"resets_at"];
104
+ if (![resets isKindOfClass:NSNumber.class]) return nil;
105
+ NSTimeInterval at = [resets doubleValue];
106
+ if (at <= NSDate.date.timeIntervalSince1970) return nil;
107
+ NSDateFormatter *formatter = [NSDateFormatter new];
108
+ formatter.dateFormat = @"HH:mm";
109
+ formatter.timeZone = NSTimeZone.systemTimeZone;
110
+ return [formatter stringFromDate:[NSDate dateWithTimeIntervalSince1970:at]];
111
+ }
112
+ // 额度是"跨阈值"事件,不是状态事件,所以单独判档。
113
+ //
114
+ // 只在向下穿档时说一次:低于 20%% 就一直念叨会变成唠叨,而额度刷新是每分钟级别的,
115
+ // 不设档位的话一小时预算瞬间就被烧光。回血(档位回升)时把标记还回去,
116
+ // 下个周期才能再触发。
117
+ - (void)considerQuotaSpeech {
118
+ NSInteger remaining = [self remainingFiveHourQuotaPercent];
119
+ if (remaining < 0) return;
120
+ NSInteger tier;
121
+ if (remaining <= 5) tier = 0;
122
+ else if (remaining <= 10) tier = 1;
123
+ else if (remaining <= 20) tier = 2;
124
+ else tier = 3;
125
+
126
+ NSInteger previous = self.lastQuotaTier;
127
+ self.lastQuotaTier = tier;
128
+ // 首次拿到数据只记档不出声,免得每次启动都通报一遍额度。
129
+ // (lastQuotaTier 的初值 0 恰好是最低档,不加这道判断的话冷启动必然误判成"刚跌到 5%"。)
130
+ if (!self.lastQuotaTierInitialized) {
131
+ self.lastQuotaTierInitialized = YES;
132
+ return;
133
+ }
134
+ if (tier >= previous) return; // 回血或没跨档
135
+ [self speakWithTag:PetPhraseTagQuotaLow];
136
+ }
137
+ - (void)buildSpeechPanelIfNeeded {
138
+ if (self.speechPanel) return;
139
+ NSSize glassSize = NSMakeSize(210, PetSpeechBodyHeight);
140
+ NSSize size = NSMakeSize(glassSize.width + 12, glassSize.height + 12);
141
+ self.speechPanel = [[NSPanel alloc] initWithContentRect:NSMakeRect(0, 0, size.width, size.height)
142
+ styleMask:NSWindowStyleMaskBorderless | NSWindowStyleMaskNonactivatingPanel
143
+ backing:NSBackingStoreBuffered defer:NO];
144
+ self.speechPanel.opaque = NO;
145
+ self.speechPanel.backgroundColor = NSColor.clearColor;
146
+ self.speechPanel.hasShadow = NO;
147
+ self.speechPanel.level = NSFloatingWindowLevel;
148
+ self.speechPanel.collectionBehavior = NSWindowCollectionBehaviorCanJoinAllSpaces |
149
+ NSWindowCollectionBehaviorFullScreenAuxiliary;
150
+ // 气泡不抢焦点、不接受点击:它是纯播报,挡住宠物就本末倒置了。
151
+ self.speechPanel.ignoresMouseEvents = YES;
152
+
153
+ NSView *root = [[NSView alloc] initWithFrame:NSMakeRect(0, 0, size.width, size.height)];
154
+ self.speechGlass = [[CCPetsGlassView alloc]
155
+ initWithFrame:NSMakeRect(6, 6, glassSize.width, glassSize.height)
156
+ material:NSVisualEffectMaterialPopover appearance:NSAppearanceNameAqua
157
+ cornerRadius:glassSize.height / 2.0];
158
+ self.speechGlass.edgeShadeHeight = 9;
159
+ self.speechGlass.edgeShadeAlpha = 0.6;
160
+ self.speechGlass.usesWidgetGlass = YES;
161
+
162
+ self.speechLabel = [NSTextField labelWithString:@""];
163
+ self.speechLabel.frame = NSMakeRect(14, 10, glassSize.width - 28, 18);
164
+ // 独立气泡里这句话是唯一元素,不与标题争,比并入状态卡时大半档。
165
+ self.speechLabel.font = [NSFont systemFontOfSize:13 weight:NSFontWeightMedium];
166
+ self.speechLabel.textColor = [NSColor colorWithWhite:0.10 alpha:0.96];
167
+ self.speechLabel.alignment = NSTextAlignmentCenter;
168
+ self.speechLabel.lineBreakMode = NSLineBreakByTruncatingTail;
169
+ [self.speechGlass.contentView addSubview:self.speechLabel];
170
+ [root addSubview:self.speechGlass];
171
+ // 平时气泡不接受点击;只有更新提示把它打开,点一下弹更新窗口。
172
+ self.speechClickButton = [[CCPetsStatusClickButton alloc] initWithFrame:root.bounds];
173
+ self.speechClickButton.autoresizingMask = NSViewWidthSizable | NSViewHeightSizable;
174
+ self.speechClickButton.bordered = NO;
175
+ self.speechClickButton.transparent = YES;
176
+ self.speechClickButton.title = @"";
177
+ self.speechClickButton.target = self;
178
+ self.speechClickButton.action = @selector(updateBubbleClicked:);
179
+ self.speechClickButton.hidden = YES;
180
+ [root addSubview:self.speechClickButton];
181
+ [self applyBubbleTextStyle];
182
+ self.speechPanel.contentView = root;
183
+ }
184
+ // 独立气泡只在没有状态卡时出现(有状态卡时话并进它的副行),所以固定放宠物头顶即可,
185
+ // 不用再和状态卡抢位置。
186
+ - (void)positionSpeechPanel {
187
+ NSRect petFrame = self.panel.frame;
188
+ NSRect visible = (self.panel.screen ?: NSScreen.mainScreen).visibleFrame;
189
+ NSSize size = self.speechPanel.frame.size;
190
+ CGFloat x = NSMidX(petFrame) - size.width / 2.0;
191
+ // 头顶放不下就翻到脚下,尾巴跟着改朝向长在顶边。
192
+ CGFloat aboveY = NSMaxY(petFrame) - 6;
193
+ BOOL fitsAbove = aboveY + size.height <= NSMaxY(visible) - 10;
194
+ CGFloat y = fitsAbove ? aboveY : NSMinY(petFrame) - size.height + 6;
195
+ x = fmax(NSMinX(visible) + 10, fmin(x, NSMaxX(visible) - size.width - 10));
196
+ y = fmax(NSMinY(visible) + 10, fmin(y, NSMaxY(visible) - size.height - 10));
197
+ [self.speechPanel setFrameOrigin:NSMakePoint(x, y)];
198
+ }
199
+ // 说一句。tag 取不到词条、预算用完、或状态卡正展开时都直接不说——
200
+ // 两个泡同时挂在宠物头上会很吵。
201
+ - (void)speakWithTag:(NSString *)tag {
202
+ if (![self canSpeakNow]) return;
203
+ NSString *text = PetPhraseForTag(tag, [self speechSlots]);
204
+ if (text.length == 0) return;
205
+
206
+ NSTimeInterval now = NSDate.date.timeIntervalSince1970;
207
+ [self.speechTimestamps addObject:@(now)];
208
+ self.speechCooldownUntil = now + [self speechCooldownSeconds];
209
+
210
+ [self presentSpeechText:text];
211
+ }
212
+ // 话往哪儿显示只在这一处决定:有状态卡就并进它的副行,没有才起独立气泡。
213
+ // 调试触发也必须走这里——否则看到的是现实中不会出现的画面(两个泡叠着)。
214
+ - (void)presentSpeechText:(NSString *)text {
215
+ if (text.length == 0) return;
216
+ if (self.statusPanel.isVisible) {
217
+ self.statusDetailLabel.stringValue = text;
218
+ [self resizeStatusCardToFitText];
219
+ [self positionAgentStatus];
220
+ // 上一句的独立气泡可能还没淡完,收掉它,别和状态卡叠着。更新气泡不归闲话管。
221
+ if (!self.updateBubbleVisible) [self hideSpeechBubble];
222
+ // 副行是状态卡的正文,借走说一句之后必须还回去,否则闲话会一直挂着,
223
+ // 看起来像状态卡卡死了。
224
+ //
225
+ // 这里刻意不写 lastPetVoiceText/lastPetVoiceTag:那两个是状态文案的
226
+ // 去重缓存,被闲话污染的话 restoreStatusDetail 就没有东西可还,而且
227
+ // 下一次同状态事件会把闲话当成"该状态的文案"复读出来。
228
+ [NSObject cancelPreviousPerformRequestsWithTarget:self
229
+ selector:@selector(restoreStatusDetail) object:nil];
230
+ [self performSelector:@selector(restoreStatusDetail) withObject:nil
231
+ afterDelay:PetSpeechDwell];
232
+ return;
233
+ }
234
+ // 更新气泡挂着时闲话让路,别把还没点的提示顶掉。
235
+ if (self.updateBubbleVisible) return;
236
+ [self showSpeechBubbleWithText:text];
237
+ }
238
+ // 把副行还给状态文案。lastPetVoiceText 里存的就是当前状态本该显示的那句。
239
+ - (void)restoreStatusDetail {
240
+ if (!self.statusPanel.isVisible || self.lastPetVoiceText.length == 0) return;
241
+ self.statusDetailLabel.stringValue = self.lastPetVoiceText;
242
+ [self resizeStatusCardToFitText];
243
+ [self positionAgentStatus];
244
+ }
245
+ - (void)showSpeechBubbleWithText:(NSString *)text {
246
+ [self showSpeechBubbleWithText:text dwell:PetSpeechDwell];
247
+ }
248
+ - (void)showSpeechBubbleWithText:(NSString *)text dwell:(NSTimeInterval)dwell {
249
+ [self buildSpeechPanelIfNeeded];
250
+ self.speechLabel.stringValue = text;
251
+ [self resizeSpeechBubbleToFitText];
252
+ [self positionSpeechPanel];
253
+ self.speechPanel.alphaValue = 0;
254
+ [self.speechPanel orderFront:nil];
255
+ [NSAnimationContext runAnimationGroup:^(NSAnimationContext *context) {
256
+ context.duration = 0.18;
257
+ self.speechPanel.animator.alphaValue = 1.0;
258
+ } completionHandler:nil];
259
+ [NSObject cancelPreviousPerformRequestsWithTarget:self
260
+ selector:@selector(hideSpeechBubble) object:nil];
261
+ [self performSelector:@selector(hideSpeechBubble) withObject:nil afterDelay:dwell];
262
+ }
263
+ // 调试触发:写一个标签进 defaults,下一跳(≤3 秒)就强制弹一次独立气泡,
264
+ // 绕开安静期、概率、预算和状态卡判断,弹完自动把键删掉,不会残留。
265
+ // defaults write com.universewang.cc-pets CCPetsSpeechDebugTag -string idle
266
+ // 标签可填 idle / done / fail / quota_low / late_night / long_session / wake
267
+ - (void)consumeSpeechDebugTrigger {
268
+ NSUserDefaults *defaults = NSUserDefaults.standardUserDefaults;
269
+ id value = [defaults objectForKey:@"CCPetsSpeechDebugTag"];
270
+ if (![value isKindOfClass:NSString.class] || [value length] == 0) return;
271
+ [defaults removeObjectForKey:@"CCPetsSpeechDebugTag"];
272
+ NSString *text = PetPhraseForTag(value, [self speechSlots]);
273
+ if (text.length == 0) text = L(@"(No lines available for this tag)");
274
+ [self presentSpeechText:text];
275
+ }
276
+ - (void)hideSpeechBubble {
277
+ if (!self.speechPanel) return;
278
+ self.updateBubbleVisible = NO;
279
+ self.speechPanel.ignoresMouseEvents = YES;
280
+ self.speechClickButton.hidden = YES;
281
+ // 被更新气泡临时收起的状态卡还回去(会话已结束或用户关了状态卡就不还)。
282
+ if (self.updateBubbleSuppressedStatus) {
283
+ self.updateBubbleSuppressedStatus = NO;
284
+ if (self.hasAgentStatus && self.statusBubbleExpanded && !self.statusPanel.isVisible) {
285
+ [self positionAgentStatus];
286
+ [self.statusPanel orderFrontRegardless];
287
+ }
288
+ }
289
+ [NSAnimationContext runAnimationGroup:^(NSAnimationContext *context) {
290
+ context.duration = 0.22;
291
+ self.speechPanel.animator.alphaValue = 0;
292
+ } completionHandler:^{
293
+ if (self.speechPanel.alphaValue <= 0.01) [self.speechPanel orderOut:nil];
294
+ }];
295
+ }
296
+ // 闲着时候的自发说话。
297
+ //
298
+ // 光挂在 agent 事件流上是不够的:那样宠物永远只会就着工作说话,late_night /
299
+ // long_session / idle 这些词条根本没有属于自己的触发时机,独立气泡也永远不会出现
300
+ // (agent 事件必定先把状态卡显示出来,话就并进去了)。
301
+ //
302
+ // 挂在已有的客户端存活定时器上,不新起 timer——常驻唤醒一个都不该多。
303
+ - (void)considerIdleSpeech {
304
+ [self consumeSpeechDebugTrigger];
305
+ if (self.updateBubbleDeferred && ![self agentBusyForSpeech]) [self showUpdateBubble];
306
+ NSTimeInterval now = NSDate.date.timeIntervalSince1970;
307
+ // 真正的判断最多 30 秒做一次,3 秒一跳的定时器上不必每次都算。
308
+ if (now - self.lastIdleSpeechCheck < 30.0) return;
309
+ self.lastIdleSpeechCheck = now;
310
+ // agent 正在干活时闭嘴——工作文案优先级最高,闲话不许顶掉它。
311
+ // 注意判断的是"在不在干活",不是"状态卡在不在":状态卡只要客户端活着就常驻,
312
+ // 用它当闸门等于开着终端就永远不碎碎念。
313
+ if ([self agentBusyForSpeech]) return;
314
+ if (![self canSpeakNow]) return;
315
+
316
+ // 安静多久才算"没人打扰"。复用无聊曲线那个缩放旋钮,测试时一并压缩。
317
+ double scale = 1.0;
318
+ id scaleValue = [NSUserDefaults.standardUserDefaults objectForKey:@"CCPetsBoredomScale"];
319
+ if ([scaleValue isKindOfClass:NSNumber.class] && [scaleValue doubleValue] > 0) {
320
+ scale = MIN([scaleValue doubleValue], 10.0);
321
+ }
322
+ PetSpeechRate rate = [self speechRate];
323
+ NSTimeInterval quiet = self.lastAgentEventAt > 0 ? now - self.lastAgentEventAt : now;
324
+ if (quiet < rate.quietSeconds * scale) return;
325
+
326
+ // 不是每次够条件都说:概率化,免得变成整点报时。
327
+ if (arc4random_uniform(100) >= rate.idleChancePercent) return;
328
+
329
+ // 有待更新版本时,这句话有一半机会换成更新提醒。照样记进预算和冷却,
330
+ // 不额外增加说话次数;碎碎念关着时 canSpeakNow 已经挡掉,不会走到这里。
331
+ if (self.pendingUpdateVersion.length > 0 && !self.updating && !self.updateReminderSnoozed &&
332
+ !self.updateBubbleVisible && arc4random_uniform(100) < UpdateReminderSharePercent) {
333
+ [self.speechTimestamps addObject:@(now)];
334
+ self.speechCooldownUntil = now + [self speechCooldownSeconds];
335
+ [self showUpdateBubbleWithText:[self updateReminderText] dwell:UpdateReminderDwell];
336
+ return;
337
+ }
338
+
339
+ NSInteger hour = [NSCalendar.currentCalendar component:NSCalendarUnitHour fromDate:NSDate.date];
340
+ NSTimeInterval sessionLength = self.sessionStartedAt > 0 ? now - self.sessionStartedAt : 0;
341
+ if (hour >= 1 && hour < 5) [self speakWithTag:PetPhraseTagLateNight];
342
+ else if (sessionLength > 90 * 60.0) [self speakWithTag:PetPhraseTagLongSession];
343
+ else [self speakWithTag:PetPhraseTagIdle];
344
+ }
345
+ // 只在显著时刻说话,不是每个 agent 事件都冒泡。
346
+ - (void)considerSpeechForRecord:(NSDictionary *)record {
347
+ self.lastAgentEventAt = NSDate.date.timeIntervalSince1970;
348
+ NSString *tool = [record[@"tool"] isKindOfClass:NSString.class] ? record[@"tool"] : nil;
349
+ if (tool.length > 0) self.lastSpeechTool = tool;
350
+ NSString *state = [record[@"state"] isKindOfClass:NSString.class] ? record[@"state"] : @"";
351
+ NSString *event = [record[@"event"] isKindOfClass:NSString.class] ? record[@"event"] : @"";
352
+ BOOL failed = [record[@"failed"] boolValue];
353
+ NSTimeInterval now = NSDate.date.timeIntervalSince1970;
354
+
355
+ if ([event isEqualToString:@"SessionStart"]) {
356
+ // 久别重逢:距上次会话超过 4 小时才算,不然每开一个终端都要寒暄一遍。
357
+ BOOL longGap = self.sessionStartedAt <= 0 || now - self.sessionStartedAt > 4 * 3600.0;
358
+ self.sessionStartedAt = now;
359
+ self.consecutiveFailures = 0;
360
+ if (longGap) [self speakWithTag:PetPhraseTagWake];
361
+ return;
362
+ }
363
+ if (failed) {
364
+ self.consecutiveFailures += 1;
365
+ // 单次失败很常见,连续两次才值得出声。
366
+ if (self.consecutiveFailures >= 2) [self speakWithTag:PetPhraseTagFail];
367
+ return;
368
+ }
369
+ if ([state isEqualToString:@"completed"]) {
370
+ self.consecutiveFailures = 0;
371
+ NSInteger hour = [NSCalendar.currentCalendar component:NSCalendarUnitHour
372
+ fromDate:NSDate.date];
373
+ NSTimeInterval sessionLength = self.sessionStartedAt > 0 ? now - self.sessionStartedAt : 0;
374
+ // 同一时刻可能同时满足几个情境,按"更值得一提"的顺序挑一个说,不叠着说。
375
+ if (hour >= 1 && hour < 5) [self speakWithTag:PetPhraseTagLateNight];
376
+ else if (sessionLength > 90 * 60.0) [self speakWithTag:PetPhraseTagLongSession];
377
+ else [self speakWithTag:PetPhraseTagDone];
378
+ }
379
+ }
380
+ // 独立气泡:左右各 16 内边距,没有图标。
381
+ - (void)resizeSpeechBubbleToFitText {
382
+ const CGFloat padding = 16;
383
+ CGFloat width = padding * 2 + PetMeasuredLabelWidth(self.speechLabel);
384
+ width = fmax(96.0, fmin(width, 300.0));
385
+ NSSize panelSize = NSMakeSize(width + 12, PetSpeechBodyHeight + 12);
386
+ [self.speechPanel setContentSize:panelSize];
387
+ self.speechPanel.contentView.frame = NSMakeRect(0, 0, panelSize.width, panelSize.height);
388
+ self.speechGlass.frame = NSMakeRect(6, 6, width, PetSpeechBodyHeight);
389
+ self.speechGlass.cornerRadius = PetSpeechBodyHeight / 2.0;
390
+ self.speechLabel.frame = NSMakeRect(padding, 10, width - padding * 2, 18);
391
+ }
392
+ @end