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.
@@ -40,108 +40,111 @@ NSArray<NSString *> *PetPhraseSlotNames(void) {
40
40
  NSString *PetPhrasesFilePath(void) {
41
41
  NSString *override = NSProcessInfo.processInfo.environment[@"CC_PETS_PHRASES_FILE"];
42
42
  if (override.length > 0) return override.stringByStandardizingPath;
43
+ return [NSHomeDirectory() stringByAppendingPathComponent:@".cc-pets/speech.txt"];
44
+ }
45
+
46
+ NSString *PetPhrasesLegacyFilePath(void) {
47
+ NSString *override = NSProcessInfo.processInfo.environment[@"CC_PETS_PHRASES_LEGACY_FILE"];
48
+ if (override.length > 0) return override.stringByStandardizingPath;
43
49
  return [NSHomeDirectory() stringByAppendingPathComponent:@".cc-pets/phrases.txt"];
44
50
  }
45
51
 
46
- // 内置词库。每个情境 8 条以上,尽量带槽位——模板能填进精确的真实数据,
47
- // 这一点恰恰是生成式给不了的:"你已经连着干了 97 分钟了"比"干挺久了"有力得多。
48
- static NSDictionary<NSString *, NSArray<NSString *> *> *BuiltinPhrases(void) {
49
- static NSDictionary *phrases;
52
+ BOOL PetPhrasesLegacyFileExists(void) {
53
+ return [NSFileManager.defaultManager fileExistsAtPath:PetPhrasesLegacyFilePath()];
54
+ }
55
+
56
+ BOOL PetPhrasesArchiveLegacyFile(void) {
57
+ NSFileManager *manager = NSFileManager.defaultManager;
58
+ NSString *source = PetPhrasesLegacyFilePath();
59
+ if (![manager fileExistsAtPath:source]) return YES;
60
+ NSString *target = [source stringByAppendingPathExtension:@"bak"];
61
+ // 已经有一份更早的备份就顶掉:它比这份更旧,留着只会让人分不清哪份是哪份。
62
+ if ([manager fileExistsAtPath:target]) [manager removeItemAtPath:target error:nil];
63
+ return [manager moveItemAtPath:source toPath:target error:nil];
64
+ }
65
+
66
+ NSString *PetPhrasesDefaultFilePath(void) {
67
+ NSString *override = NSProcessInfo.processInfo.environment[@"CC_PETS_PHRASES_DEFAULT_FILE"];
68
+ if (override.length > 0) return override.stringByStandardizingPath;
69
+ NSString *bundled = [NSBundle.mainBundle pathForResource:@"phrases.default"
70
+ ofType:@"txt"];
71
+ if (bundled.length > 0) return bundled;
72
+ // 直接跑 .build/release/cc-pets(没有 app bundle)时退到可执行文件旁边,
73
+ // 否则开发期跑起来一句台词都没有,会被误当成解析出了问题。
74
+ NSString *executable = NSBundle.mainBundle.executablePath.stringByDeletingLastPathComponent;
75
+ return [executable stringByAppendingPathComponent:@"phrases.default.txt"];
76
+ }
77
+
78
+ BOOL PetPhrasesEnsureFileExists(void) {
79
+ NSFileManager *manager = NSFileManager.defaultManager;
80
+ NSString *path = PetPhrasesFilePath();
81
+ if ([manager fileExistsAtPath:path]) return YES;
82
+ NSString *defaultText = [NSString stringWithContentsOfFile:PetPhrasesDefaultFilePath()
83
+ encoding:NSUTF8StringEncoding error:nil];
84
+ if (defaultText.length == 0) return NO;
85
+ [manager createDirectoryAtPath:path.stringByDeletingLastPathComponent
86
+ withIntermediateDirectories:YES attributes:nil error:nil];
87
+
88
+ // 老用户:启动时就把老词库合并过来,不等他打开编辑器。
89
+ //
90
+ // 拖到编辑器里再迁移的话,从升级到他第一次打开编辑器这段时间,桌宠说的会是出厂
91
+ // 台词而不是他自己写的——没人会把这件事和"我该去点一下编辑台词"联系起来。
92
+ // 老文件这一步不删,等编辑器里问过用户再删。
93
+ NSString *legacyText = [NSString stringWithContentsOfFile:PetPhrasesLegacyFilePath()
94
+ encoding:NSUTF8StringEncoding error:nil];
95
+ NSString *text = legacyText.length > 0 ?
96
+ PetPhraseTextMergedFromLegacy(legacyText, defaultText) : defaultText;
97
+ return [text writeToFile:path atomically:YES encoding:NSUTF8StringEncoding error:nil];
98
+ }
99
+
100
+ // 标签清单。顺序就是出厂模板里的顺序,校验提示按这个顺序报,
101
+ // 用户对着文件从上往下找得到。
102
+ NSArray<NSString *> *PetPhraseStateTags(void) {
103
+ static NSArray<NSString *> *tags;
104
+ static dispatch_once_t once;
105
+ dispatch_once(&once, ^{
106
+ tags = @[PetPhraseTagStateStarting, PetPhraseTagStateIdle, PetPhraseTagStateThinking,
107
+ PetPhraseTagStateTool, PetPhraseTagStateToolBash, PetPhraseTagStateToolEdit,
108
+ PetPhraseTagStateToolRead, PetPhraseTagStateToolDone, PetPhraseTagStateToolFailed,
109
+ PetPhraseTagStateSubagent, PetPhraseTagStateApproval, PetPhraseTagStateAutoReview,
110
+ PetPhraseTagStateCompleted, PetPhraseTagStateFailed, PetPhraseTagStateNotification];
111
+ });
112
+ return tags;
113
+ }
114
+
115
+ NSArray<NSString *> *PetPhraseAllTags(void) {
116
+ static NSArray<NSString *> *tags;
117
+ static dispatch_once_t once;
118
+ dispatch_once(&once, ^{
119
+ NSMutableArray *all = [@[PetPhraseTagIdle, PetPhraseTagDone, PetPhraseTagFail,
120
+ PetPhraseTagWake, PetPhraseTagLateNight, PetPhraseTagLongSession,
121
+ PetPhraseTagQuotaLow] mutableCopy];
122
+ [all addObjectsFromArray:PetPhraseStateTags()];
123
+ tags = all;
124
+ });
125
+ return tags;
126
+ }
127
+
128
+ NSString *PetPhraseTagDescription(NSString *tag) {
129
+ static NSDictionary<NSString *, NSString *> *map;
50
130
  static dispatch_once_t once;
51
131
  dispatch_once(&once, ^{
52
- phrases = @{
53
- PetPhraseTagDone: @[
54
- @"搞定了,歇会儿吧。", @"这次挺顺利的。", @"又完成一件,不错。",
55
- @"收工,{toolName} 没闹脾气。", @"好了,接下来干嘛?", @"稳。",
56
- @"完事了,喝口水。", @"这波很干净。", @"成了,我看着呢。"
57
- ],
58
- PetPhraseTagFail: @[
59
- @"失败 {failCount} 次了,喘口气。", @"没事,再试一次。",
60
- @"{toolName} 这货不靠谱。", @"卡住了?我陪你看看。",
61
- @"别急,慢慢来。", @"又红了…深呼吸。", @"这个坑我也没见过。",
62
- @"失败也是信息。", @"要不换个思路?"
63
- ],
64
- PetPhraseTagQuotaLow: @[
65
- @"额度只剩 {quota5h} 了。", @"省着点用啊。",
66
- @"快见底了,{resetTime} 才回血。", @"要不歇会儿等回血?",
67
- @"额度告急,悠着点。", @"{quota5h}…有点悬。",
68
- @"再跑就没了。", @"离 {resetTime} 还早呢。"
69
- ],
70
- PetPhraseTagLateNight: @[
71
- @"都 {hour} 点了。", @"该睡了吧?", @"这个点还在写…",
72
- @"明天再改也不迟。", @"夜深了,注意身体。",
73
- @"{hour} 点的代码不太可信。", @"熬夜写的明天要重写的。",
74
- @"我先困了,你随意。"
75
- ],
76
- PetPhraseTagLongSession: @[
77
- @"连着干 {sessionMin} 分钟了。", @"起来走两步吧。",
78
- @"{sessionMin} 分钟了,眼睛歇歇。", @"坐太久了。",
79
- @"要不伸个懒腰?", @"该补水了。", @"歇五分钟不亏。",
80
- @"腰还好吗?"
81
- ],
82
- PetPhraseTagWake: @[
83
- @"你回来啦。", @"好久不见。", @"等你半天了。",
84
- @"来活了?", @"我还以为你不来了。", @"醒了醒了。",
85
- @"开工吧。", @"哟。"
86
- ],
87
- // Agent 状态的宠物口吻文案。标题仍然给事实("Claude · 正在编辑文件"),
88
- // 这里给的是旁边那句话,所以不必重复状态本身,只说宠物的观察和态度。
89
- PetPhraseTagStateStarting: @[
90
- @"正在把它叫醒…", @"它还在穿鞋,稍等。", @"马上就好。", @"它爬起来了。"
91
- ],
92
- PetPhraseTagStateIdle: @[
93
- @"它准备好了,你说吧。", @"安静着呢,随时开工。",
94
- @"就位了,等你发话。", @"我们都听着。"
95
- ],
96
- PetPhraseTagStateThinking: @[
97
- @"它在想,我在旁边看着。", @"让它想想,别催。",
98
- @"脑子转起来了。", @"这题它得琢磨会儿。", @"安静,它在思考。"
99
- ],
100
- PetPhraseTagStateAutoReview: @[
101
- @"有人替你把关了。", @"自动审着呢,不用管。", @"这轮它自己会查。"
102
- ],
103
- PetPhraseTagStateApproval: @[
104
- @"它等你点头。", @"卡住了,回终端看一眼。",
105
- @"要你拿主意。", @"不敢乱动,等你发话。"
106
- ],
107
- PetPhraseTagStateSubagent: @[
108
- @"它喊帮手了。", @"派了个小弟出去。", @"这活儿分出去了。"
109
- ],
110
- PetPhraseTagStateTool: @[
111
- @"它动手了。", @"在翻工具箱。", @"忙起来了。"
112
- ],
113
- PetPhraseTagStateToolBash: @[
114
- @"在敲命令了。", @"终端里忙着呢。", @"这条命令我看着。"
115
- ],
116
- PetPhraseTagStateToolEdit: @[
117
- @"在改文件,别手抖。", @"动笔了。", @"文件正在被折腾。"
118
- ],
119
- PetPhraseTagStateToolRead: @[
120
- @"到处翻资料呢。", @"在找线索。", @"翻书中…"
121
- ],
122
- PetPhraseTagStateToolDone: @[
123
- @"这一步成了。", @"搞定一个。", @"稳住了。"
124
- ],
125
- PetPhraseTagStateToolFailed: @[
126
- @"这步崴了。", @"工具闹脾气了。", @"它好像有点坏了。。。"
127
- ],
128
- PetPhraseTagStateCompleted: @[
129
- @"干完了,歇会儿。", @"收工!", @"这轮结束了。", @"齐活。"
130
- ],
131
- PetPhraseTagStateFailed: @[
132
- @"翻车了,回终端看看。", @"没成,去瞧瞧。", @"这次栽了。"
133
- ],
134
- PetPhraseTagStateNotification: @[
135
- @"有点事找你聊聊。", @"抬头看一眼。", @"这儿有情况。"
136
- ],
137
- PetPhraseTagIdle: @[
138
- @"发会儿呆。", @"我来啦!!!", @"随时叫我。",
139
- @"今天挺安静。", @"我就看看。", @"要不要蹬会儿?",
140
- @"闲着也是闲着。", @"嗯…"
141
- ]
132
+ map = @{
133
+ PetPhraseTagIdle: @"闲着没事", PetPhraseTagDone: @"任务完成",
134
+ PetPhraseTagFail: @"连续失败", PetPhraseTagWake: @"隔了很久又开工",
135
+ PetPhraseTagLateNight: @"深夜还在干", PetPhraseTagLongSession: @"连续工作很久",
136
+ PetPhraseTagQuotaLow: @"额度告急",
137
+ PetPhraseTagStateStarting: @"正在启动", PetPhraseTagStateIdle: @"待机中",
138
+ PetPhraseTagStateThinking: @"正在思考", PetPhraseTagStateTool: @"正在用工具",
139
+ PetPhraseTagStateToolBash: @"正在执行命令", PetPhraseTagStateToolEdit: @"正在编辑文件",
140
+ PetPhraseTagStateToolRead: @"正在查找资料", PetPhraseTagStateToolDone: @"单步操作完成",
141
+ PetPhraseTagStateToolFailed: @"工具执行失败", PetPhraseTagStateSubagent: @"子 Agent 工作中",
142
+ PetPhraseTagStateApproval: @"等待审批", PetPhraseTagStateAutoReview: @"自动审批中",
143
+ PetPhraseTagStateCompleted: @"任务已完成", PetPhraseTagStateFailed: @"任务失败",
144
+ PetPhraseTagStateNotification: @"需要关注",
142
145
  };
143
146
  });
144
- return phrases;
147
+ return map[tag] ?: tag;
145
148
  }
146
149
 
147
150
  // 去掉行尾注释。
@@ -168,7 +171,7 @@ static NSString *PetLineWithoutTrailingComment(NSString *line) {
168
171
  return line;
169
172
  }
170
173
 
171
- // 用户词库:~/.cc-pets/phrases.txt
174
+ // 用户词库:~/.cc-pets/speech.txt
172
175
  //
173
176
  // # 井号开头是注释
174
177
  // [fail]
@@ -179,8 +182,82 @@ static NSString *PetLineWithoutTrailingComment(NSString *line) {
179
182
  // 逐行解析,容错到底:不认识的小节名跳过、空行跳过、超长的丢掉,
180
183
  // 单行有问题绝不影响其他行。这是选纯文本而不是 JSON 的全部理由。
181
184
  //
182
- // 首行写 replace 可以完全顶掉内置词条;缺省是和内置合并。
183
- static NSDictionary *LoadUserPhrases(void) {
185
+ // 文件即全部:没有 merge、没有 replace。删掉一节就是那个情境不吭声。
186
+ //
187
+ // 解析和校验共用这一个函数:校验器要报"第几行为什么被丢了",如果它自己再写一套
188
+ // 判断,两边迟早会漂移——用户看到"校验通过"而桌宠照样不说话,是最糟的一种 bug。
189
+ // 所以这里把每一次丢弃都通过 onDrop 回调抛出去,校验器只负责把它们变成人话。
190
+ static void FlushOrphans(void (^onDrop)(NSInteger line, NSString *reason),
191
+ NSInteger *start, NSInteger *count) {
192
+ if (*count == 0) return;
193
+ if (onDrop) {
194
+ onDrop(*start, *count == 1 ? @"这一句不在任何 [情境] 下面,不会生效" :
195
+ [NSString stringWithFormat:@"这里有 %ld 句不在任何 [情境] 下面,都不会生效",
196
+ (long)*count]);
197
+ }
198
+ *count = 0;
199
+ }
200
+
201
+ static NSDictionary<NSString *, NSArray<NSString *> *> *ParsePhrasesText(NSString *text,
202
+ void (^onDrop)(NSInteger line, NSString *reason)) {
203
+ NSMutableDictionary<NSString *, NSMutableArray<NSString *> *> *groups =
204
+ [NSMutableDictionary dictionary];
205
+ NSString *current = nil;
206
+ // 小节名拼错时,它下面的台词全都无处安放。但那不是"每一行都错了"——
207
+ // 错的只有小节名那一行。逐行报的话,一个拼错的小节能刷出十几条一模一样的提示,
208
+ // 真正该改的那一行反而被淹掉。所以只报小节头,底下的行安静吞掉。
209
+ BOOL insideUnknownSection = NO;
210
+ // 连续的"无处安放"的句子只报一条。删掉一个小节头,它下面那一串台词会全部变成
211
+ // 散句——逐行报的话,一个错误能刷出十几条提示,把真正该看的那条错误挤下去。
212
+ NSInteger orphanStart = 0, orphanCount = 0;
213
+ NSArray<NSString *> *rawLines = [text componentsSeparatedByCharactersInSet:
214
+ NSCharacterSet.newlineCharacterSet];
215
+ NSSet<NSString *> *known = [NSSet setWithArray:PetPhraseAllTags()];
216
+ for (NSUInteger index = 0; index < rawLines.count; index++) {
217
+ NSInteger lineNumber = (NSInteger)index + 1;
218
+ NSString *line = [rawLines[index] stringByTrimmingCharactersInSet:
219
+ NSCharacterSet.whitespaceCharacterSet];
220
+ line = PetLineWithoutTrailingComment(line);
221
+ if (line.length == 0) continue;
222
+ if ([line hasPrefix:@"["] && [line hasSuffix:@"]"]) {
223
+ FlushOrphans(onDrop, &orphanStart, &orphanCount);
224
+ NSString *tag = [line substringWithRange:NSMakeRange(1, line.length - 2)];
225
+ tag = [tag stringByTrimmingCharactersInSet:NSCharacterSet.whitespaceCharacterSet];
226
+ if (![known containsObject:tag]) {
227
+ current = nil;
228
+ insideUnknownSection = YES;
229
+ if (onDrop) onDrop(lineNumber,
230
+ [NSString stringWithFormat:@"没有 [%@] 这个情境,下面的台词都不会生效", tag]);
231
+ continue;
232
+ }
233
+ insideUnknownSection = NO;
234
+ current = tag;
235
+ if (!groups[current]) groups[current] = [NSMutableArray array];
236
+ continue;
237
+ }
238
+ // 还没进任何小节的散句无处安放,直接跳过,不猜用户想放哪。
239
+ if (current.length == 0) {
240
+ if (!insideUnknownSection) {
241
+ if (orphanCount == 0) orphanStart = lineNumber;
242
+ orphanCount++;
243
+ }
244
+ continue;
245
+ }
246
+ if (line.length > PetPhraseMaxLength) {
247
+ if (onDrop) onDrop(lineNumber, [NSString stringWithFormat:
248
+ @"这句 %lu 个字,超过 %lu 字上限", (unsigned long)line.length,
249
+ (unsigned long)PetPhraseMaxLength]);
250
+ continue;
251
+ }
252
+ [groups[current] addObject:line];
253
+ }
254
+ FlushOrphans(onDrop, &orphanStart, &orphanCount);
255
+ return groups;
256
+ }
257
+
258
+ // 从磁盘读。mtime 没变就直接用上次的结果——取句子本来就低频,这点开销可以忽略,
259
+ // 换来的是用户改完保存立刻生效,不用重启桌宠。
260
+ static NSDictionary<NSString *, NSArray<NSString *> *> *LoadUserPhrases(void) {
184
261
  static NSDictionary *cached;
185
262
  static NSDate *cachedStamp;
186
263
  static NSString *cachedPath;
@@ -188,8 +265,6 @@ static NSDictionary *LoadUserPhrases(void) {
188
265
  NSString *path = PetPhrasesFilePath();
189
266
  NSDictionary *attributes = [NSFileManager.defaultManager attributesOfItemAtPath:path error:nil];
190
267
  NSDate *stamp = attributes[NSFileModificationDate];
191
- // 比对 mtime 做热加载:取句子本来就低频,这点开销可以忽略,
192
- // 换来的是用户改完存盘立刻生效,不用重启桌宠。
193
268
  if (stamp && cachedStamp && [stamp isEqualToDate:cachedStamp] &&
194
269
  [path isEqualToString:cachedPath]) {
195
270
  return cached;
@@ -202,33 +277,7 @@ static NSDictionary *LoadUserPhrases(void) {
202
277
  NSString *text = [NSString stringWithContentsOfFile:path
203
278
  encoding:NSUTF8StringEncoding error:nil];
204
279
  if (text.length == 0) return nil;
205
-
206
- NSMutableDictionary<NSString *, NSMutableArray<NSString *> *> *groups =
207
- [NSMutableDictionary dictionary];
208
- BOOL replace = NO;
209
- NSString *current = nil;
210
- for (NSString *rawLine in [text componentsSeparatedByCharactersInSet:
211
- NSCharacterSet.newlineCharacterSet]) {
212
- NSString *line = [rawLine stringByTrimmingCharactersInSet:
213
- NSCharacterSet.whitespaceCharacterSet];
214
- line = PetLineWithoutTrailingComment(line);
215
- if (line.length == 0) continue;
216
- if ([line isEqualToString:@"replace"]) { replace = YES; continue; }
217
- if ([line hasPrefix:@"["] && [line hasSuffix:@"]"]) {
218
- current = [line substringWithRange:NSMakeRange(1, line.length - 2)];
219
- current = [current stringByTrimmingCharactersInSet:
220
- NSCharacterSet.whitespaceCharacterSet];
221
- continue;
222
- }
223
- // 还没进任何小节的散句无处安放,直接跳过,不猜用户想放哪。
224
- if (current.length == 0) continue;
225
- if (line.length > PetPhraseMaxLength) continue;
226
- NSMutableArray *bucket = groups[current];
227
- if (!bucket) { bucket = [NSMutableArray array]; groups[current] = bucket; }
228
- [bucket addObject:line];
229
- }
230
- if (groups.count == 0 && !replace) return nil;
231
- cached = @{@"mode": replace ? @"replace" : @"merge", @"phrases": groups};
280
+ cached = ParsePhrasesText(text, nil);
232
281
  return cached;
233
282
  }
234
283
 
@@ -248,35 +297,24 @@ static NSString *FillSlots(NSString *template, NSDictionary<NSString *, NSString
248
297
  return result;
249
298
  }
250
299
 
251
- // 合并候选:内置 + 用户。replace 模式下只要用户的。
300
+ // 候选就是文件里那一节,没有别的来源。
252
301
  static NSArray<NSString *> *CandidatesForTag(NSString *tag) {
253
- NSDictionary *user = LoadUserPhrases();
254
- BOOL replace = [user[@"mode"] isKindOfClass:NSString.class] &&
255
- [user[@"mode"] isEqualToString:@"replace"];
302
+ NSArray *entries = LoadUserPhrases()[tag];
303
+ if (![entries isKindOfClass:NSArray.class]) return @[];
256
304
  NSMutableArray<NSString *> *result = [NSMutableArray array];
257
- if (!replace) {
258
- NSArray *builtin = BuiltinPhrases()[tag];
259
- if (builtin) [result addObjectsFromArray:builtin];
260
- }
261
- id userPhrases = user[@"phrases"];
262
- if ([userPhrases isKindOfClass:NSDictionary.class]) {
263
- id entries = ((NSDictionary *)userPhrases)[tag];
264
- if ([entries isKindOfClass:NSArray.class]) {
265
- for (id entry in (NSArray *)entries) {
266
- // 解析时已逐行校验过,这里再挡一道,防止将来换了来源出岔子。
267
- if (![entry isKindOfClass:NSString.class]) continue;
268
- NSString *text = entry;
269
- if (text.length == 0 || text.length > PetPhraseMaxLength) continue;
270
- [result addObject:text];
271
- }
272
- }
305
+ for (id entry in (NSArray *)entries) {
306
+ // 解析时已逐行校验过,这里再挡一道,防止将来换了来源出岔子。
307
+ if (![entry isKindOfClass:NSString.class]) continue;
308
+ NSString *text = entry;
309
+ if (text.length == 0 || text.length > PetPhraseMaxLength) continue;
310
+ [result addObject:text];
273
311
  }
274
312
  return result;
275
313
  }
276
314
 
277
- NSString *PetPhraseForTag(NSString *tag, NSDictionary<NSString *, NSString *> *slots) {
278
- if (tag.length == 0) return nil;
279
- NSArray<NSString *> *candidates = CandidatesForTag(tag);
315
+ // 从候选里挑一条填好槽位的。抽出来是为了让"试说一句"能对着还没保存的文本走同一条路。
316
+ static NSString *PickFromCandidates(NSArray<NSString *> *candidates,
317
+ NSDictionary<NSString *, NSString *> *slots, BOOL rememberRecent) {
280
318
  if (candidates.count == 0) return nil;
281
319
 
282
320
  // 最近说过的先排除。全被排除掉时(词条太少)就放开限制,总比不说话强。
@@ -286,7 +324,7 @@ NSString *PetPhraseForTag(NSString *tag, NSDictionary<NSString *, NSString *> *s
286
324
 
287
325
  NSMutableArray<NSString *> *pool = [NSMutableArray array];
288
326
  for (NSString *text in candidates) {
289
- if (![recent containsObject:text]) [pool addObject:text];
327
+ if (!rememberRecent || ![recent containsObject:text]) [pool addObject:text];
290
328
  }
291
329
  if (pool.count == 0) [pool addObjectsFromArray:candidates];
292
330
 
@@ -299,9 +337,264 @@ NSString *PetPhraseForTag(NSString *tag, NSDictionary<NSString *, NSString *> *s
299
337
  for (NSString *template in shuffled) {
300
338
  NSString *text = FillSlots(template, slots);
301
339
  if (text.length == 0) continue;
302
- [recent addObject:template];
303
- while (recent.count > PetPhraseRecentMemory) [recent removeObjectAtIndex:0];
340
+ if (rememberRecent) {
341
+ [recent addObject:template];
342
+ while (recent.count > PetPhraseRecentMemory) [recent removeObjectAtIndex:0];
343
+ }
304
344
  return text;
305
345
  }
306
346
  return nil;
307
347
  }
348
+
349
+ NSString *PetPhraseForTag(NSString *tag, NSDictionary<NSString *, NSString *> *slots) {
350
+ if (tag.length == 0) return nil;
351
+ return PickFromCandidates(CandidatesForTag(tag), slots, YES);
352
+ }
353
+
354
+ // 试说一句:对着编辑器里还没保存的文本取。不计入"最近说过",
355
+ // 否则用户连点几下预览就会把正式说话的去重记忆挤空。
356
+ NSString *PetPhraseForTagInText(NSString *tag, NSString *text,
357
+ NSDictionary<NSString *, NSString *> *slots) {
358
+ if (tag.length == 0 || text.length == 0) return nil;
359
+ NSArray *entries = ParsePhrasesText(text, nil)[tag];
360
+ if (![entries isKindOfClass:NSArray.class]) return nil;
361
+ return PickFromCandidates(entries, slots, NO);
362
+ }
363
+
364
+ @implementation PetPhraseIssue
365
+ @end
366
+
367
+ static PetPhraseIssue *MakeIssue(NSInteger line, PetPhraseIssueLevel level, NSString *message) {
368
+ PetPhraseIssue *issue = [PetPhraseIssue new];
369
+ issue.line = line;
370
+ issue.level = level;
371
+ issue.message = message;
372
+ return issue;
373
+ }
374
+
375
+ // 保存时校验。分两级:
376
+ // 错误 —— 只有一种,state_ 小节空了。状态卡副行没地方取文案,卡片会残掉,
377
+ // 所以直接拦下不给保存。
378
+ // 提示 —— 其余全部。情绪句整节没有是合法的(就是那个情境不吭声),
379
+ // 被丢掉的行也只影响自己,说清楚就行,不挡用户。
380
+ // 小节头写成出厂词库里的样子:[tag] 补空格对齐到 24 列,再跟中文说明。
381
+ static NSString *SectionHeaderLine(NSString *tag) {
382
+ NSString *head = [NSString stringWithFormat:@"[%@]", tag];
383
+ NSMutableString *line = [head mutableCopy];
384
+ while (line.length < 24) [line appendString:@" "];
385
+ [line appendFormat:@"# %@", PetPhraseTagDescription(tag)];
386
+ return line;
387
+ }
388
+
389
+ // 这一行是不是会被解析器当成台词(既不是空行、注释,也不是小节头)。
390
+ static BOOL IsContentLine(NSString *rawLine) {
391
+ NSString *line = PetLineWithoutTrailingComment([rawLine stringByTrimmingCharactersInSet:
392
+ NSCharacterSet.whitespaceCharacterSet]);
393
+ if (line.length == 0) return NO;
394
+ return !([line hasPrefix:@"["] && [line hasSuffix:@"]"]);
395
+ }
396
+
397
+ // 这一行是不是 tag 的小节头。
398
+ static BOOL IsHeaderLine(NSString *rawLine, NSString *tag) {
399
+ NSString *line = PetLineWithoutTrailingComment([rawLine stringByTrimmingCharactersInSet:
400
+ NSCharacterSet.whitespaceCharacterSet]);
401
+ return [line isEqualToString:[NSString stringWithFormat:@"[%@]", tag]];
402
+ }
403
+
404
+ NSString *PetPhraseTextMergedFromLegacy(NSString *legacyText, NSString *defaultText) {
405
+ if (legacyText.length == 0) return defaultText;
406
+
407
+ NSDictionary<NSString *, NSArray<NSString *> *> *legacy = ParsePhrasesText(legacyText, nil);
408
+ // 老文件里独立成行的 replace 表示"只说我写的"。这个写法在新版里已经没有了,
409
+ // 但迁移时必须认——不认的话,用过它的人升级后会突然多出一堆他当初特意关掉的话。
410
+ BOOL replaceMode = NO;
411
+ for (NSString *rawLine in [legacyText componentsSeparatedByCharactersInSet:
412
+ NSCharacterSet.newlineCharacterSet]) {
413
+ NSString *line = PetLineWithoutTrailingComment([rawLine
414
+ stringByTrimmingCharactersInSet:NSCharacterSet.whitespaceCharacterSet]);
415
+ if ([line isEqualToString:@"replace"]) { replaceMode = YES; break; }
416
+ }
417
+
418
+ // 拿出厂模板当骨架,逐节把内容换掉。注释、分节说明全都用新模板的,
419
+ // 老文件里的注释一概不搬。
420
+ NSMutableArray<NSString *> *output = [NSMutableArray array];
421
+ NSArray<NSString *> *lines = [defaultText componentsSeparatedByString:@"\n"];
422
+ NSSet<NSString *> *known = [NSSet setWithArray:PetPhraseAllTags()];
423
+ NSString *current = nil;
424
+ for (NSString *rawLine in lines) {
425
+ NSString *line = PetLineWithoutTrailingComment([rawLine
426
+ stringByTrimmingCharactersInSet:NSCharacterSet.whitespaceCharacterSet]);
427
+ BOOL isHeader = [line hasPrefix:@"["] && [line hasSuffix:@"]"] &&
428
+ [known containsObject:[line substringWithRange:NSMakeRange(1, line.length - 2)]];
429
+ if (isHeader) {
430
+ current = [line substringWithRange:NSMakeRange(1, line.length - 2)];
431
+ [output addObject:rawLine];
432
+ NSArray<NSString *> *userLines = legacy[current];
433
+ NSMutableArray<NSString *> *merged = [NSMutableArray array];
434
+ // 出厂在前、用户的追加在后,顺序稳定,用户一眼能看出哪几句是自己写的。
435
+ //
436
+ // replace 模式只覆盖用户**写过**的那些小节,没写过的仍旧用出厂内容。
437
+ // 照搬老语义(没写的一律清空)会让 15 个 state_ 小节全空:老版那些小节空了
438
+ // 还有一层兜底文案顶着,新版把兜底删了,状态卡副行会直接残掉。
439
+ if (!replaceMode || userLines.count == 0) {
440
+ [merged addObjectsFromArray:ParsePhrasesText(defaultText, nil)[current] ?: @[]];
441
+ }
442
+ for (NSString *text in userLines) {
443
+ if (![merged containsObject:text]) [merged addObject:text];
444
+ }
445
+ [output addObjectsFromArray:merged];
446
+ continue;
447
+ }
448
+ // 小节内的原有台词由上面一次性写完,这里跳过;注释和空行照抄,骨架才立得住。
449
+ if (current != nil && line.length > 0) continue;
450
+ [output addObject:rawLine];
451
+ }
452
+ return [output componentsJoinedByString:@"\n"];
453
+ }
454
+
455
+ // 找 tag 的小节头在第几行,没有返回 -1。
456
+ static NSInteger HeaderIndex(NSArray<NSString *> *lines, NSString *tag) {
457
+ for (NSUInteger index = 0; index < lines.count; index++) {
458
+ if (IsHeaderLine(lines[index], tag)) return (NSInteger)index;
459
+ }
460
+ return -1;
461
+ }
462
+
463
+ NSString *PetPhraseTextWithRestoredTags(NSString *text,
464
+ NSArray<NSString *> **restored) {
465
+ NSMutableArray<NSString *> *lines = [[(text ?: @"")
466
+ componentsSeparatedByString:@"\n"] mutableCopy];
467
+ NSMutableArray<NSString *> *added = [NSMutableArray array];
468
+ NSArray<NSString *> *order = PetPhraseAllTags();
469
+
470
+ for (NSUInteger position = 0; position < order.count; position++) {
471
+ NSString *tag = order[position];
472
+ if (HeaderIndex(lines, tag) >= 0) continue;
473
+
474
+ // 本节能插的范围:上一个还在的标签之后,下一个还在的标签之前。
475
+ NSInteger lower = 0;
476
+ BOOL hasPrevious = NO;
477
+ for (NSInteger back = (NSInteger)position - 1; back >= 0; back--) {
478
+ NSInteger found = HeaderIndex(lines, order[back]);
479
+ if (found < 0) continue;
480
+ lower = found + 1;
481
+ hasPrevious = YES;
482
+ break;
483
+ }
484
+ NSInteger upper = (NSInteger)lines.count;
485
+ for (NSUInteger ahead = position + 1; ahead < order.count; ahead++) {
486
+ NSInteger found = HeaderIndex(lines, order[ahead]);
487
+ if (found < 0) continue;
488
+ upper = found;
489
+ break;
490
+ }
491
+ if (lower > upper) lower = upper;
492
+
493
+ // 范围内按空行切成若干"台词块"。
494
+ //
495
+ // 标签被删而台词还在时,那串台词会并进上一节(解析器只认小节头,看不出中间
496
+ // 断过),所以范围里会出现两块:前一块是上一节自己的,后一块才是被删标签的。
497
+ // 标签连着台词一起被删时只剩一块,那块是上一节的,不能抢。
498
+ NSMutableArray<NSNumber *> *blockStarts = [NSMutableArray array];
499
+ BOOL inBlock = NO;
500
+ for (NSInteger index = lower; index < upper; index++) {
501
+ if (IsContentLine(lines[(NSUInteger)index])) {
502
+ if (!inBlock) { [blockStarts addObject:@(index)]; inBlock = YES; }
503
+ } else if (lines[(NSUInteger)index].length == 0) {
504
+ inBlock = NO;
505
+ }
506
+ }
507
+ // 没有上一节时,范围里的块本来就是本节的,第一块就是。
508
+ NSInteger expected = hasPrevious ? 1 : 0;
509
+ NSInteger insertAt = upper;
510
+ if ((NSInteger)blockStarts.count > expected) {
511
+ insertAt = blockStarts.lastObject.integerValue;
512
+ }
513
+
514
+ [lines insertObject:SectionHeaderLine(tag) atIndex:(NSUInteger)insertAt];
515
+ // 整节都被删过的情况下,补回的标签会直接顶在下一个标签上面,看起来像挤在一起。
516
+ if ((NSUInteger)insertAt + 1 < lines.count &&
517
+ [lines[(NSUInteger)insertAt + 1] hasPrefix:@"["]) {
518
+ [lines insertObject:@"" atIndex:(NSUInteger)insertAt + 1];
519
+ }
520
+ // 和上一节之间留个空行,别和别人的台词粘在一起。
521
+ if (insertAt > 0 && lines[(NSUInteger)insertAt - 1].length > 0) {
522
+ [lines insertObject:@"" atIndex:(NSUInteger)insertAt];
523
+ }
524
+ [added addObject:tag];
525
+ }
526
+
527
+ if (restored) *restored = added;
528
+ return [lines componentsJoinedByString:@"\n"];
529
+ }
530
+
531
+ NSArray<PetPhraseIssue *> *PetPhraseValidateText(NSString *text) {
532
+ NSMutableArray<PetPhraseIssue *> *issues = [NSMutableArray array];
533
+ NSDictionary *groups = ParsePhrasesText(text ?: @"", ^(NSInteger line, NSString *reason) {
534
+ [issues addObject:MakeIssue(line, PetPhraseIssueLevelWarning, reason)];
535
+ });
536
+
537
+ // 槽位拼错是最难自查的一类:句子看着没问题,运行时却被整条跳过。
538
+ // 白名单外的花括号一律报出来。
539
+ NSSet<NSString *> *slots = [NSSet setWithArray:PetPhraseSlotNames()];
540
+ NSRegularExpression *pattern = [NSRegularExpression
541
+ regularExpressionWithPattern:@"\\{([^{}]*)\\}" options:0 error:nil];
542
+ NSArray<NSString *> *lines = [(text ?: @"") componentsSeparatedByCharactersInSet:
543
+ NSCharacterSet.newlineCharacterSet];
544
+ for (NSUInteger index = 0; index < lines.count; index++) {
545
+ NSString *line = PetLineWithoutTrailingComment([lines[index]
546
+ stringByTrimmingCharactersInSet:NSCharacterSet.whitespaceCharacterSet]);
547
+ if (line.length == 0) continue;
548
+ for (NSTextCheckingResult *match in [pattern matchesInString:line options:0
549
+ range:NSMakeRange(0, line.length)]) {
550
+ NSString *name = [line substringWithRange:[match rangeAtIndex:1]];
551
+ if ([slots containsObject:name]) continue;
552
+ [issues addObject:MakeIssue((NSInteger)index + 1, PetPhraseIssueLevelWarning,
553
+ [NSString stringWithFormat:@"{%@} 不是可用的数据名,这句永远不会出现", name])];
554
+ }
555
+ }
556
+
557
+ // 标签行是配置项,不是内容——22 个小节头一个都不能删,删了就报错。
558
+ //
559
+ // 内容能不能为空才分两种:state_ 那组是状态卡副行的唯一正文来源,空了卡片就残,
560
+ // 所以也拦下;情绪句留空是合法选择,就是那个情境不主动开口,只提示。
561
+ //
562
+ // "整节被删了"和"节还在但空了"分开报:用户要做的动作不一样,前者得把 [state_xxx]
563
+ // 那一行加回来,后者只要补一句台词。报同一句话的话,文件里根本没有那行的用户
564
+ // 会满文件去找一个不存在的小节。
565
+ NSSet<NSString *> *stateTags = [NSSet setWithArray:PetPhraseStateTags()];
566
+ for (NSString *tag in PetPhraseAllTags()) {
567
+ NSArray *entries = groups[tag];
568
+ if (entries == nil) {
569
+ [issues addObject:MakeIssue(0, PetPhraseIssueLevelError, [NSString stringWithFormat:
570
+ @"少了 [%@](%@)这一行,标签不能删——加回来即可,下面不写台词也行",
571
+ tag, PetPhraseTagDescription(tag)])];
572
+ continue;
573
+ }
574
+ if (entries.count > 0) continue;
575
+ if ([stateTags containsObject:tag]) {
576
+ [issues addObject:MakeIssue(0, PetPhraseIssueLevelError, [NSString stringWithFormat:
577
+ @"[%@](%@)至少要留一句", tag, PetPhraseTagDescription(tag)])];
578
+ } else {
579
+ [issues addObject:MakeIssue(0, PetPhraseIssueLevelWarning, [NSString stringWithFormat:
580
+ @"[%@](%@)是空的,这个情境桌宠不会主动开口", tag, PetPhraseTagDescription(tag)])];
581
+ }
582
+ }
583
+
584
+ // 错误排前面,其次按行号;不带行号的(整节缺失)排到同级最后。
585
+ [issues sortUsingComparator:^NSComparisonResult(PetPhraseIssue *a, PetPhraseIssue *b) {
586
+ if (a.level != b.level) return a.level > b.level ? NSOrderedAscending : NSOrderedDescending;
587
+ if (a.line == b.line) return NSOrderedSame;
588
+ if (a.line == 0) return NSOrderedDescending;
589
+ if (b.line == 0) return NSOrderedAscending;
590
+ return a.line < b.line ? NSOrderedAscending : NSOrderedDescending;
591
+ }];
592
+ return issues;
593
+ }
594
+
595
+ BOOL PetPhraseIssuesHaveError(NSArray<PetPhraseIssue *> *issues) {
596
+ for (PetPhraseIssue *issue in issues) {
597
+ if (issue.level == PetPhraseIssueLevelError) return YES;
598
+ }
599
+ return NO;
600
+ }