cc-pets 1.4.0 → 1.4.2

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.
@@ -5,6 +5,7 @@
5
5
  #import "CCPetsQuotaHistory.h"
6
6
  #import "CCPetsImageLoader.h"
7
7
  #import "CCPetsPhrases.h"
8
+ #import "CCPetsPhrasesEditor.h"
8
9
  #import "CCPetsUsage.h"
9
10
  #import "MenuToggleSwitch.h"
10
11
  #import <UserNotifications/UserNotifications.h>
@@ -33,6 +34,30 @@ static void TrimUpdateLog(NSString *path) {
33
34
  chmod(path.fileSystemRepresentation, S_IRUSR | S_IWUSR);
34
35
  }
35
36
 
37
+ // 碎碎念的话痨程度。四道闸(每小时预算 / 两句间隔 / 静默门槛 / 出话概率)本来是
38
+ // 四个互相牵制的常数,单独调任何一个都不会真的变频繁——比如把冷却调到 0,
39
+ // 每小时 4 句的预算照样卡死。所以对用户只暴露一个档位,四个值一起走。
40
+ //
41
+ // normal 档就是改造前的原值,默认不变。
42
+ typedef struct {
43
+ NSInteger hourlyBudget;
44
+ NSTimeInterval cooldown;
45
+ NSTimeInterval quietSeconds; // 距上一次 agent 事件多久才算"没人打扰"
46
+ uint32_t idleChancePercent; // 每次判定(≤30 秒一次)的出话概率
47
+ } PetSpeechRate;
48
+
49
+ static const PetSpeechRate PetSpeechRateLow = {2, 480.0, 300.0, 15};
50
+ static const PetSpeechRate PetSpeechRateNormal = {4, 240.0, 180.0, 25};
51
+ static const PetSpeechRate PetSpeechRateHigh = {8, 120.0, 90.0, 45};
52
+ static const PetSpeechRate PetSpeechRateChatty = {20, 45.0, 45.0, 70};
53
+
54
+ // 档位写进 defaults 的值。字符串而不是整数:以后加档、调顺序都不会让老配置错位。
55
+ NSString *const PetSpeechFrequencyKey = @"CCPetsSpeechFrequency";
56
+ static NSString *const PetSpeechFrequencyLow = @"low";
57
+ static NSString *const PetSpeechFrequencyNormal = @"normal";
58
+ static NSString *const PetSpeechFrequencyHigh = @"high";
59
+ static NSString *const PetSpeechFrequencyChatty = @"chatty";
60
+
36
61
  @implementation AppDelegate
37
62
  - (NSString *)applicationSupportDirectory {
38
63
  return ApplicationSupportDirectory();
@@ -330,107 +355,29 @@ static void TrimUpdateLog(NSString *path) {
330
355
  sender.state = !enabled ? NSControlStateValueOn : NSControlStateValueOff;
331
356
  if (enabled) [self hideSpeechBubble];
332
357
  }
333
- // 词库文件平时不存在(不存在就等于"用内置"),只有用户主动点这一项才现写一个带注释的
334
- // 样板出来——避免每台机器一装就多个没人动过的配置文件。
358
+ // 频率档位。改完立刻生效——四道闸都是现读的,不缓存。
359
+ // 顺手把冷却清掉,否则刚调高档位还要等完上一档的冷却才见效,会让人以为没生效。
360
+ - (void)setSpeechFrequency:(NSMenuItem *)sender {
361
+ NSString *value = [sender.representedObject isKindOfClass:NSString.class] ?
362
+ sender.representedObject : PetSpeechFrequencyNormal;
363
+ [NSUserDefaults.standardUserDefaults setObject:value forKey:PetSpeechFrequencyKey];
364
+ self.speechCooldownUntil = 0;
365
+ self.lastIdleSpeechCheck = 0;
366
+ }
367
+ // 台词交给内置编辑器,不再 openURL: 丢给"文本编辑"。
368
+ //
369
+ // 换掉的理由是反馈:系统编辑器保存完什么都不会说,小节名拼错、句子超 30 字、槽位
370
+ // 写错名字全是静默失效,用户只知道"改了没用"。内置编辑器保存时校验并当场报出来,
371
+ // 还能"试说一句"直接听效果。
335
372
  - (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]];
373
+ // 编辑器只管文本,不认识气泡;把"说出来"这一步作为回调注入。
374
+ __weak typeof(self) weakSelf = self;
375
+ [PetPhrasesEditorController setSpeakHandler:^(NSString *text) {
376
+ [weakSelf presentSpeechText:text];
377
+ }];
378
+ [PetPhrasesEditorController present];
433
379
  }
380
+
434
381
  - (void)toggleNotification:(NSButton *)sender {
435
382
  NSString *key = [self notificationKeyForTag:sender.tag];
436
383
  if (!key) return;
@@ -552,22 +499,6 @@ static void TrimUpdateLog(NSString *path) {
552
499
  }
553
500
  return PetPhraseTagStateTool;
554
501
  }
555
- // 词库取不到就落回原来的系统文案。用户把词库写坏了也只是少了口吻,不会剩个空行。
556
- - (NSString *)fallbackDetailForState:(NSString *)state {
557
- if ([state isEqualToString:@"starting"]) return @"正在准备当前会话…";
558
- if ([state isEqualToString:@"idle"]) return @"会话已就绪,等待你的下一条指令。";
559
- if ([state isEqualToString:@"thinking"]) return @"正在分析需求…";
560
- if ([state isEqualToString:@"auto_review"]) return @"正在由 Auto-review 审核,无需手动操作。";
561
- if ([state isEqualToString:@"approval"]) return @"请回到终端确认操作。";
562
- if ([state isEqualToString:@"subagent"]) return @"正在协调子 Agent。";
563
- if ([state isEqualToString:@"tool"]) return @"正在调用工具…";
564
- if ([state isEqualToString:@"tool_completed"]) return @"工具调用已完成。";
565
- if ([state isEqualToString:@"tool_failed"]) return @"工具执行失败,请查看终端。";
566
- if ([state isEqualToString:@"completed"]) return @"当前任务已经完成。";
567
- if ([state isEqualToString:@"failed"]) return @"任务失败,请回到终端查看详情。";
568
- if ([state isEqualToString:@"notification"]) return @"有一条状态需要你关注。";
569
- return @"正在处理当前任务。";
570
- }
571
502
  - (NSString *)statusDetailForState:(NSString *)state tool:(NSString *)tool {
572
503
  NSString *tag = [self petVoiceTagForState:state tool:tool];
573
504
  // 同一个状态连着来一串事件时不重摇,否则副行会不停闪。一次状态转换说一句就够。
@@ -575,7 +506,6 @@ static void TrimUpdateLog(NSString *path) {
575
506
  return self.lastPetVoiceText;
576
507
  }
577
508
  NSString *text = PetPhraseForTag(tag, [self speechSlots]);
578
- if (text.length == 0) text = [self fallbackDetailForState:state];
579
509
  self.lastPetVoiceTag = tag;
580
510
  self.lastPetVoiceText = text;
581
511
  return text;
@@ -651,6 +581,9 @@ static void TrimUpdateLog(NSString *path) {
651
581
  self.statusTitleLabel.stringValue = [NSString stringWithFormat:@"%@ · %@",
652
582
  provider, [self statusTextForState:state tool:tool]];
653
583
  self.statusDetailLabel.stringValue = [self statusDetailForState:state tool:tool];
584
+ // 上一句碎碎念借走的副行已经被新状态覆盖,取消那次归还,否则它会把旧文案写回来。
585
+ [NSObject cancelPreviousPerformRequestsWithTarget:self
586
+ selector:@selector(restoreStatusDetail) object:nil];
654
587
  NSColor *stateColor = [self statusColorForState:state];
655
588
  self.statusIconButton.layer.backgroundColor = [stateColor colorWithAlphaComponent:0.28].CGColor;
656
589
  NSImage *icon = [NSImage imageWithSystemSymbolName:[self statusSymbolForState:state]
@@ -900,6 +833,9 @@ static void TrimUpdateLog(NSString *path) {
900
833
  }
901
834
  }
902
835
  - (void)applicationDidFinishLaunching:(NSNotification *)notification {
836
+ // 台词全在这个文件里,代码里没有第二份。首次启动先从出厂词库拷一份出来,
837
+ // 否则新装的桌宠一句话都不会说。
838
+ PetPhrasesEnsureFileExists();
903
839
  self.managedByCLI = [NSProcessInfo.processInfo.arguments containsObject:@"--managed"];
904
840
  NSString *binaryDir = NSProcessInfo.processInfo.arguments.firstObject.stringByStandardizingPath.stringByDeletingLastPathComponent;
905
841
  NSBundle *mainBundle = NSBundle.mainBundle;
@@ -1276,11 +1212,6 @@ static const NSTimeInterval UsageRefreshCoalesceWindow = 2.0;
1276
1212
 
1277
1213
 
1278
1214
 
1279
- // 每小时最多说几句。桌宠一直叭叭两小时就会让人想卸载——沉默是活物感的一部分,
1280
- // 越没事的时候越要闭嘴。
1281
- static const NSInteger PetSpeechHourlyBudget = 4;
1282
- // 两句之间的最短间隔。预算没用完也不能连着说。
1283
- static const NSTimeInterval PetSpeechCooldown = 240.0;
1284
1215
  // 气泡停留时长。
1285
1216
  static const NSTimeInterval PetSpeechDwell = 4.5;
1286
1217
  // 气泡与状态卡的本体高度。
@@ -1292,6 +1223,8 @@ static const NSTimeInterval PetSpeechDwell = 4.5;
1292
1223
  // 结论:保持药丸 + 原生圆角,靠贴近宠物来表达归属。
1293
1224
  static const CGFloat PetSpeechBodyHeight = 38.0;
1294
1225
  static const CGFloat PetStatusBodyHeight = 58.0;
1226
+ // 副行没东西可显示时的高度,只放得下标题一行。
1227
+ static const CGFloat PetStatusSingleLineHeight = 40.0;
1295
1228
 
1296
1229
  - (BOOL)speechEnabled {
1297
1230
  NSUserDefaults *defaults = NSUserDefaults.standardUserDefaults;
@@ -1299,23 +1232,41 @@ static const CGFloat PetStatusBodyHeight = 58.0;
1299
1232
  id value = [defaults objectForKey:@"CCPetsSpeechEnabled"];
1300
1233
  return value == nil ? YES : [value boolValue];
1301
1234
  }
1235
+ // 当前档位。现读,右键菜单里改完立刻生效不用重启。
1236
+ - (PetSpeechRate)speechRate {
1237
+ NSString *value = [NSUserDefaults.standardUserDefaults stringForKey:PetSpeechFrequencyKey];
1238
+ if ([value isEqualToString:PetSpeechFrequencyLow]) return PetSpeechRateLow;
1239
+ if ([value isEqualToString:PetSpeechFrequencyHigh]) return PetSpeechRateHigh;
1240
+ if ([value isEqualToString:PetSpeechFrequencyChatty]) return PetSpeechRateChatty;
1241
+ return PetSpeechRateNormal;
1242
+ }
1302
1243
  // 预算与冷却。两道闸门都过了才允许说。
1303
- // 调试/调优用,现读,改完立刻生效不用重启:
1244
+ // 默认跟随上面的档位;下面这两个键是更细的手动覆盖,写了就压过档位,
1245
+ // 现读,改完立刻生效不用重启:
1304
1246
  // defaults write com.universewang.cc-pets CCPetsSpeechCooldown -float 0
1305
1247
  // defaults write com.universewang.cc-pets CCPetsSpeechHourlyBudget -int 100
1306
- // defaults delete com.universewang.cc-pets CCPetsSpeechCooldown # 恢复
1248
+ // defaults delete com.universewang.cc-pets CCPetsSpeechCooldown # 交回档位
1307
1249
  // 域名是 bundle identifier,不是 "cc-pets"——写错域的话键会落在另一个 plist 里,
1308
1250
  // 桌宠永远看不到,表现为"设了没反应"。
1309
1251
  - (NSTimeInterval)speechCooldownSeconds {
1310
1252
  id value = [NSUserDefaults.standardUserDefaults objectForKey:@"CCPetsSpeechCooldown"];
1311
- if (![value isKindOfClass:NSNumber.class]) return PetSpeechCooldown;
1253
+ if (![value isKindOfClass:NSNumber.class]) return [self speechRate].cooldown;
1312
1254
  return MAX(0.0, [value doubleValue]);
1313
1255
  }
1314
1256
  - (NSInteger)speechHourlyBudget {
1315
1257
  id value = [NSUserDefaults.standardUserDefaults objectForKey:@"CCPetsSpeechHourlyBudget"];
1316
- if (![value isKindOfClass:NSNumber.class]) return PetSpeechHourlyBudget;
1258
+ if (![value isKindOfClass:NSNumber.class]) return [self speechRate].hourlyBudget;
1317
1259
  return MAX((NSInteger)1, [value integerValue]);
1318
1260
  }
1261
+ // agent 是不是正在干活。只有"待机中"和状态卡压根没显示这两种情况算闲——
1262
+ // thinking / tool / subagent / approval / notification / completed / failed
1263
+ // 副行上都带着用户还需要看的信息,闲话一律让路。
1264
+ // 用 hasAgentStatus 而不是 statusPanel.isVisible:用户把状态卡折叠起来时卡片是隐藏的,
1265
+ // 但 agent 照样在干活,这时候冒气泡等于绕过折叠又把话糊到脸上。
1266
+ - (BOOL)agentBusyForSpeech {
1267
+ if (!self.hasAgentStatus) return NO;
1268
+ return ![self.lastStatusState isEqualToString:@"idle"];
1269
+ }
1319
1270
  - (BOOL)canSpeakNow {
1320
1271
  if (![self speechEnabled]) return NO;
1321
1272
  NSTimeInterval now = NSDate.date.timeIntervalSince1970;
@@ -1481,15 +1432,31 @@ static const CGFloat PetStatusBodyHeight = 58.0;
1481
1432
  if (text.length == 0) return;
1482
1433
  if (self.statusPanel.isVisible) {
1483
1434
  self.statusDetailLabel.stringValue = text;
1484
- self.lastPetVoiceText = text;
1485
1435
  [self resizeStatusCardToFitText];
1486
1436
  [self positionAgentStatus];
1487
1437
  // 上一句的独立气泡可能还没淡完,收掉它,别和状态卡叠着。
1488
1438
  [self hideSpeechBubble];
1439
+ // 副行是状态卡的正文,借走说一句之后必须还回去,否则闲话会一直挂着,
1440
+ // 看起来像状态卡卡死了。
1441
+ //
1442
+ // 这里刻意不写 lastPetVoiceText/lastPetVoiceTag:那两个是状态文案的
1443
+ // 去重缓存,被闲话污染的话 restoreStatusDetail 就没有东西可还,而且
1444
+ // 下一次同状态事件会把闲话当成"该状态的文案"复读出来。
1445
+ [NSObject cancelPreviousPerformRequestsWithTarget:self
1446
+ selector:@selector(restoreStatusDetail) object:nil];
1447
+ [self performSelector:@selector(restoreStatusDetail) withObject:nil
1448
+ afterDelay:PetSpeechDwell];
1489
1449
  return;
1490
1450
  }
1491
1451
  [self showSpeechBubbleWithText:text];
1492
1452
  }
1453
+ // 把副行还给状态文案。lastPetVoiceText 里存的就是当前状态本该显示的那句。
1454
+ - (void)restoreStatusDetail {
1455
+ if (!self.statusPanel.isVisible || self.lastPetVoiceText.length == 0) return;
1456
+ self.statusDetailLabel.stringValue = self.lastPetVoiceText;
1457
+ [self resizeStatusCardToFitText];
1458
+ [self positionAgentStatus];
1459
+ }
1493
1460
  - (void)showSpeechBubbleWithText:(NSString *)text {
1494
1461
  [self buildSpeechPanelIfNeeded];
1495
1462
  self.speechLabel.stringValue = text;
@@ -1540,8 +1507,10 @@ static const CGFloat PetStatusBodyHeight = 58.0;
1540
1507
  // 真正的判断最多 30 秒做一次,3 秒一跳的定时器上不必每次都算。
1541
1508
  if (now - self.lastIdleSpeechCheck < 30.0) return;
1542
1509
  self.lastIdleSpeechCheck = now;
1543
- // 有状态卡在说话就不插嘴;这条路径专属于"屏幕上什么都没有"的时候。
1544
- if (self.statusPanel.isVisible) return;
1510
+ // agent 正在干活时闭嘴——工作文案优先级最高,闲话不许顶掉它。
1511
+ // 注意判断的是"在不在干活",不是"状态卡在不在":状态卡只要客户端活着就常驻,
1512
+ // 用它当闸门等于开着终端就永远不碎碎念。
1513
+ if ([self agentBusyForSpeech]) return;
1545
1514
  if (![self canSpeakNow]) return;
1546
1515
 
1547
1516
  // 安静多久才算"没人打扰"。复用无聊曲线那个缩放旋钮,测试时一并压缩。
@@ -1550,11 +1519,12 @@ static const CGFloat PetStatusBodyHeight = 58.0;
1550
1519
  if ([scaleValue isKindOfClass:NSNumber.class] && [scaleValue doubleValue] > 0) {
1551
1520
  scale = MIN([scaleValue doubleValue], 10.0);
1552
1521
  }
1522
+ PetSpeechRate rate = [self speechRate];
1553
1523
  NSTimeInterval quiet = self.lastAgentEventAt > 0 ? now - self.lastAgentEventAt : now;
1554
- if (quiet < 180.0 * scale) return;
1524
+ if (quiet < rate.quietSeconds * scale) return;
1555
1525
 
1556
1526
  // 不是每次够条件都说:概率化,免得变成整点报时。
1557
- if (arc4random_uniform(100) >= 25) return;
1527
+ if (arc4random_uniform(100) >= rate.idleChancePercent) return;
1558
1528
 
1559
1529
  NSInteger hour = [NSCalendar.currentCalendar component:NSCalendarUnitHour fromDate:NSDate.date];
1560
1530
  NSTimeInterval sessionLength = self.sessionStartedAt > 0 ? now - self.sessionStartedAt : 0;
@@ -1611,12 +1581,22 @@ static CGFloat PetMeasuredLabelWidth(NSTextField *label) {
1611
1581
  // 状态卡:左内边距 20 + 文字 + 间隙 8 + 图标 34 + 右内边距 14。
1612
1582
  - (void)resizeStatusCardToFitText {
1613
1583
  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));
1584
+ // 副行没内容时收成单行,而不是留一块空白。
1585
+ //
1586
+ // 台词全在 speech.txt 里,代码里没有兜底文案:用户把某个 state_ 小节清空了,
1587
+ // 副行就真的没有东西可显示。编辑器保存时会拦下这种文件,但外部编辑器绕得过去,
1588
+ // 所以显示层必须自己站得住。
1589
+ BOOL hasDetail = self.statusDetailLabel.stringValue.length > 0;
1590
+ CGFloat height = hasDetail ? PetStatusBodyHeight : PetStatusSingleLineHeight;
1591
+ CGFloat textWidth = PetMeasuredLabelWidth(self.statusTitleLabel);
1592
+ if (hasDetail) {
1593
+ textWidth = fmax(textWidth, PetMeasuredLabelWidth(self.statusDetailLabel));
1594
+ }
1617
1595
  CGFloat glassWidth = leading + textWidth + gap + iconWidth + trailing;
1618
1596
  glassWidth = fmax(210.0, fmin(glassWidth, 420.0));
1619
- if (fabs(NSWidth(self.statusGlass.frame) - glassWidth) < 0.5) return;
1597
+ // 高度也要参与早退判断,否则单行/双行之间切换时尺寸不会更新。
1598
+ if (fabs(NSWidth(self.statusGlass.frame) - glassWidth) < 0.5 &&
1599
+ fabs(NSHeight(self.statusGlass.frame) - height) < 0.5) return;
1620
1600
 
1621
1601
  NSSize panelSize = NSMakeSize(glassWidth + 12, height + 12);
1622
1602
  [self.statusPanel setContentSize:panelSize];
@@ -1630,10 +1610,15 @@ static CGFloat PetMeasuredLabelWidth(NSTextField *label) {
1630
1610
  CGPathRelease(path);
1631
1611
 
1632
1612
  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);
1613
+ self.statusDetailLabel.hidden = !hasDetail;
1614
+ if (hasDetail) {
1615
+ self.statusTitleLabel.frame = NSMakeRect(leading, 34, labelWidth, 14);
1616
+ self.statusDetailLabel.frame = NSMakeRect(leading, 10, labelWidth, 22);
1617
+ } else {
1618
+ self.statusTitleLabel.frame = NSMakeRect(leading, (height - 14) / 2.0, labelWidth, 14);
1619
+ }
1620
+ self.statusIconButton.frame = NSMakeRect(glassWidth - trailing - iconWidth,
1621
+ (height - iconWidth) / 2.0, iconWidth, iconWidth);
1637
1622
  }
1638
1623
 
1639
1624
  // 独立气泡:左右各 16 内边距,没有图标。
@@ -1,9 +1,13 @@
1
1
  #import <Foundation/Foundation.h>
2
2
 
3
- // 桌宠说的话。内置词库 + 用户词库合并,按情境标签取一条,填好槽位后返回。
3
+ // 桌宠说的话。全部来自用户词库文件,代码里不再留一份内置词库。
4
4
  //
5
5
  // 这一层刻意和"怎么显示""什么时候说"完全分开:取句子是一个纯函数式的接口,
6
6
  // 以后换成大模型生成只是换掉这里的实现,气泡和触发逻辑一个字都不用动。
7
+ //
8
+ // 语义只有一条:**文件里有什么就说什么**。没有合并、没有 replace、没有兜底。
9
+ // 删掉一节就是那个情境不吭声。这样用户看到的文件就是桌宠的全部台词,
10
+ // 不存在"我明明删了它还在说"这种解释不清的状态。
7
11
 
8
12
  // 情境标签。**这是发布给用户的稳定契约**,用户词库按它分组,不要随版本改名,
9
13
  // 否则别人写好的词库会静默失效。
@@ -34,15 +38,57 @@ extern NSString *const PetPhraseTagStateCompleted;
34
38
  extern NSString *const PetPhraseTagStateFailed;
35
39
  extern NSString *const PetPhraseTagStateNotification;
36
40
 
37
- // 用户词库路径:~/.cc-pets/phrases.txt。可用 CC_PETS_PHRASES_FILE 覆盖(测试用)。
41
+ // 全部标签,按模板里的出现顺序。校验器和"缺了哪节"的提示都靠它。
42
+ NSArray<NSString *> *PetPhraseAllTags(void);
43
+ // state_ 那组。它们是状态卡副行的唯一来源,每节至少要留一句,空了就拦下不给保存。
44
+ NSArray<NSString *> *PetPhraseStateTags(void);
45
+ // 标签的中文说明,给校验提示用("缺少 [state_thinking](正在思考)")。
46
+ NSString *PetPhraseTagDescription(NSString *tag);
47
+
48
+ // 用户词库路径:~/.cc-pets/speech.txt。可用 CC_PETS_PHRASES_FILE 覆盖(测试用)。
38
49
  //
39
50
  // 纯文本而不是 JSON:普通用户写不了 JSON,而且少个逗号整个文件失效、我们静默降级,
40
51
  // 用户只会觉得"改了没用"。纯文本一行一句,写错只丢那一行。
41
52
  NSString *PetPhrasesFilePath(void);
53
+ // 出厂词库路径:app bundle 里的 phrases.default.txt。
54
+ // 可用 CC_PETS_PHRASES_DEFAULT_FILE 覆盖(测试用)。
55
+ NSString *PetPhrasesDefaultFilePath(void);
56
+ // 老版词库路径:~/.cc-pets/phrases.txt。可用 CC_PETS_PHRASES_LEGACY_FILE 覆盖(测试用)。
57
+ //
58
+ // 换个文件名是为了让"迁移过没有"这件事变成一个平凡的判断:新文件在就是迁移过了。
59
+ // 靠猜内容特征(有没有 replace 行、缺不缺某个小节)都不可靠,用户改过之后更没法判断。
60
+ NSString *PetPhrasesLegacyFilePath(void);
61
+
62
+ // 老版词库还在不在。在的话说明还没提示用户删掉它。
63
+ BOOL PetPhrasesLegacyFileExists(void);
64
+ // 把老版词库改名成 phrases.txt.bak。用户在提示里确认之后调用。
65
+ //
66
+ // 改名而不是删除:内容还在原地,万一合并合错了还能翻出来对。同时 PetPhrasesLegacyFilePath
67
+ // 只认 phrases.txt,改完名它既不会再被当成迁移源,也不会再弹询问——留着原名不动的话,
68
+ // 哪天 speech.txt 丢了,启动时会再从它合并一遍,把用户迁移之后写的台词全冲掉。
69
+ BOOL PetPhrasesArchiveLegacyFile(void);
70
+
71
+ // 把老版词库合并进出厂词库。纯函数,不碰磁盘,方便测。
72
+ //
73
+ // 合并而不是覆盖:老语义是"内置 + 用户的混着说",用户当时听到的就是两者的并集,
74
+ // 直接拿用户那几句顶掉整节的话,桌宠会突然变哑。老文件里写了 replace 的除外——
75
+ // 那是"只说我的",照办。
76
+ // 注释一律不搬,按新模板的来。
77
+ NSString *PetPhraseTextMergedFromLegacy(NSString *legacyText, NSString *defaultText);
78
+
79
+ // 用户词库不存在就准备一份:有老版词库就合并过来,否则从出厂词库拷。返回是否可用。
80
+ //
81
+ // 出厂词库是一个随 app 打包的文本文件,不是代码里的字典:默认台词只在"生成文件"
82
+ // 这一刻出现一次,之后运行时只认用户文件。两份词库同时存在于运行期就必然要回答
83
+ // "以谁为准",那正是 merge/replace 那套让人看不懂的根源。
84
+ BOOL PetPhrasesEnsureFileExists(void);
42
85
 
43
86
  // 取一条填好槽位的话。取不到返回 nil(调用方应当直接不说话,而不是显示占位符)。
44
87
  // slots 的键是白名单里的槽位名(不含花括号),值统一按字符串处理。
45
88
  NSString *PetPhraseForTag(NSString *tag, NSDictionary<NSString *, NSString *> *slots);
89
+ // 从一段还没保存的文本里取某个标签的一条,供编辑器的"试说一句"用。
90
+ NSString *PetPhraseForTagInText(NSString *tag, NSString *text,
91
+ NSDictionary<NSString *, NSString *> *slots);
46
92
 
47
93
  // 允许出现在模板里的槽位。白名单制:没列在这里的一律原样留着,不做替换。
48
94
  NSArray<NSString *> *PetPhraseSlotNames(void);
@@ -50,3 +96,32 @@ NSArray<NSString *> *PetPhraseSlotNames(void);
50
96
  // 单条模板的长度上限(字符)。超了直接丢弃——气泡布局撑不下,
51
97
  // 与其截断出半句话不如不说。
52
98
  extern const NSUInteger PetPhraseMaxLength;
99
+
100
+ // 校验结果的一条。
101
+ typedef NS_ENUM(NSInteger, PetPhraseIssueLevel) {
102
+ // 提示:可以保存,只是有一部分不会生效或情境会静默。
103
+ PetPhraseIssueLevelWarning = 0,
104
+ // 错误:拦下不给保存。目前只有一种——state_ 小节空了。
105
+ PetPhraseIssueLevelError = 1,
106
+ };
107
+
108
+ @interface PetPhraseIssue : NSObject
109
+ @property(nonatomic) NSInteger line; // 1 起。0 表示不针对具体某一行
110
+ @property(nonatomic) PetPhraseIssueLevel level;
111
+ @property(nonatomic, copy) NSString *message;
112
+ @end
113
+
114
+ // 把被删掉的标签行补回原位。返回补好的文本,restored 带回补了哪些标签(按文件顺序)。
115
+ //
116
+ // 标签删掉之后,用户在编辑器里看不到任何线索——他既不知道少的是哪一个,也不知道该写成
117
+ // 什么样。光报错等于把人卡死在那儿,所以保存时直接补回去,再告诉他补了什么。
118
+ //
119
+ // 补的位置有讲究:标签被删而台词还在时,那串台词会变成"不在任何 [情境] 下面"的散句,
120
+ // 标签必须插回那串散句的**前面**,它们才会重新归位;插到别处的话台词就真的丢了。
121
+ // restored 可以传 NULL。
122
+ NSString *PetPhraseTextWithRestoredTags(NSString *text, NSArray<NSString *> **restored);
123
+
124
+ // 校验一段文本。保存时调用,不做实时校验——边打边标红只会干扰输入。
125
+ NSArray<PetPhraseIssue *> *PetPhraseValidateText(NSString *text);
126
+ // 有没有致命错误。有就不能保存。
127
+ BOOL PetPhraseIssuesHaveError(NSArray<PetPhraseIssue *> *issues);