cc-pets 1.3.3 → 1.4.1

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.
@@ -0,0 +1,600 @@
1
+ #import "CCPetsPhrases.h"
2
+
3
+ NSString *const PetPhraseTagDone = @"done";
4
+ NSString *const PetPhraseTagFail = @"fail";
5
+ NSString *const PetPhraseTagQuotaLow = @"quota_low";
6
+ NSString *const PetPhraseTagLateNight = @"late_night";
7
+ NSString *const PetPhraseTagLongSession = @"long_session";
8
+ NSString *const PetPhraseTagWake = @"wake";
9
+ NSString *const PetPhraseTagIdle = @"idle";
10
+
11
+ NSString *const PetPhraseTagStateStarting = @"state_starting";
12
+ NSString *const PetPhraseTagStateIdle = @"state_idle";
13
+ NSString *const PetPhraseTagStateThinking = @"state_thinking";
14
+ NSString *const PetPhraseTagStateAutoReview = @"state_auto_review";
15
+ NSString *const PetPhraseTagStateApproval = @"state_approval";
16
+ NSString *const PetPhraseTagStateSubagent = @"state_subagent";
17
+ NSString *const PetPhraseTagStateTool = @"state_tool";
18
+ NSString *const PetPhraseTagStateToolBash = @"state_tool_bash";
19
+ NSString *const PetPhraseTagStateToolEdit = @"state_tool_edit";
20
+ NSString *const PetPhraseTagStateToolRead = @"state_tool_read";
21
+ NSString *const PetPhraseTagStateToolDone = @"state_tool_done";
22
+ NSString *const PetPhraseTagStateToolFailed = @"state_tool_failed";
23
+ NSString *const PetPhraseTagStateCompleted = @"state_completed";
24
+ NSString *const PetPhraseTagStateFailed = @"state_failed";
25
+ NSString *const PetPhraseTagStateNotification = @"state_notification";
26
+
27
+ const NSUInteger PetPhraseMaxLength = 30;
28
+ // 最近说过的这么多条不再重复。模板库不大,靠这个把主观重复感压下去。
29
+ static const NSUInteger PetPhraseRecentMemory = 12;
30
+
31
+ NSArray<NSString *> *PetPhraseSlotNames(void) {
32
+ static NSArray<NSString *> *names;
33
+ static dispatch_once_t once;
34
+ dispatch_once(&once, ^{
35
+ names = @[@"quota5h", @"resetTime", @"toolName", @"sessionMin", @"failCount", @"hour"];
36
+ });
37
+ return names;
38
+ }
39
+
40
+ NSString *PetPhrasesFilePath(void) {
41
+ NSString *override = NSProcessInfo.processInfo.environment[@"CC_PETS_PHRASES_FILE"];
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;
49
+ return [NSHomeDirectory() stringByAppendingPathComponent:@".cc-pets/phrases.txt"];
50
+ }
51
+
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;
130
+ static dispatch_once_t once;
131
+ dispatch_once(&once, ^{
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: @"需要关注",
145
+ };
146
+ });
147
+ return map[tag] ?: tag;
148
+ }
149
+
150
+ // 去掉行尾注释。
151
+ //
152
+ // 必须支持行尾注释,否则模板里 "[state_subagent] # 子 Agent 工作中" 这样的小节名
153
+ // 会因为结尾不是 ] 而不被识别,它下面的台词全部无处安放被丢掉——整个文件静默失效,
154
+ // 用户取消注释后什么都不会发生,连报错都没有。
155
+ //
156
+ // 只在 # 前面是空白(或位于行首)时才截断:这样台词里写 "进度#1" 之类不会被误伤。
157
+ static NSString *PetLineWithoutTrailingComment(NSString *line) {
158
+ if ([line hasPrefix:@"#"]) return @"";
159
+ NSRange search = NSMakeRange(0, line.length);
160
+ while (search.length > 0) {
161
+ NSRange hash = [line rangeOfString:@"#" options:0 range:search];
162
+ if (hash.location == NSNotFound) break;
163
+ unichar previous = [line characterAtIndex:hash.location - 1];
164
+ if (previous == ' ' || previous == '\t') {
165
+ return [[line substringToIndex:hash.location] stringByTrimmingCharactersInSet:
166
+ NSCharacterSet.whitespaceCharacterSet];
167
+ }
168
+ NSUInteger next = hash.location + 1;
169
+ search = NSMakeRange(next, line.length - next);
170
+ }
171
+ return line;
172
+ }
173
+
174
+ // 用户词库:~/.cc-pets/speech.txt
175
+ //
176
+ // # 井号开头是注释
177
+ // [fail]
178
+ // 又挂了?我陪你看看。
179
+ // [done]
180
+ // 收工!
181
+ //
182
+ // 逐行解析,容错到底:不认识的小节名跳过、空行跳过、超长的丢掉,
183
+ // 单行有问题绝不影响其他行。这是选纯文本而不是 JSON 的全部理由。
184
+ //
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) {
261
+ static NSDictionary *cached;
262
+ static NSDate *cachedStamp;
263
+ static NSString *cachedPath;
264
+
265
+ NSString *path = PetPhrasesFilePath();
266
+ NSDictionary *attributes = [NSFileManager.defaultManager attributesOfItemAtPath:path error:nil];
267
+ NSDate *stamp = attributes[NSFileModificationDate];
268
+ if (stamp && cachedStamp && [stamp isEqualToDate:cachedStamp] &&
269
+ [path isEqualToString:cachedPath]) {
270
+ return cached;
271
+ }
272
+ cachedPath = path;
273
+ cachedStamp = stamp;
274
+ cached = nil;
275
+ if (!stamp) return nil;
276
+
277
+ NSString *text = [NSString stringWithContentsOfFile:path
278
+ encoding:NSUTF8StringEncoding error:nil];
279
+ if (text.length == 0) return nil;
280
+ cached = ParsePhrasesText(text, nil);
281
+ return cached;
282
+ }
283
+
284
+ // 模板本身是数据,不是格式串。**绝不能把它交给 stringWithFormat:**——
285
+ // 用户词库里一个 %@ 就会让桌宠当场崩溃。这里只做白名单内的字面量替换。
286
+ static NSString *FillSlots(NSString *template, NSDictionary<NSString *, NSString *> *slots) {
287
+ NSMutableString *result = [template mutableCopy];
288
+ for (NSString *name in PetPhraseSlotNames()) {
289
+ NSString *token = [NSString stringWithFormat:@"{%@}", name];
290
+ if ([result rangeOfString:token].location == NSNotFound) continue;
291
+ NSString *value = slots[name];
292
+ // 该填的槽位没给值:整条作废。宁可不说,也不能吐出 "额度只剩 {quota5h} 了"。
293
+ if (value.length == 0) return nil;
294
+ [result replaceOccurrencesOfString:token withString:value
295
+ options:NSLiteralSearch range:NSMakeRange(0, result.length)];
296
+ }
297
+ return result;
298
+ }
299
+
300
+ // 候选就是文件里那一节,没有别的来源。
301
+ static NSArray<NSString *> *CandidatesForTag(NSString *tag) {
302
+ NSArray *entries = LoadUserPhrases()[tag];
303
+ if (![entries isKindOfClass:NSArray.class]) return @[];
304
+ NSMutableArray<NSString *> *result = [NSMutableArray array];
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];
311
+ }
312
+ return result;
313
+ }
314
+
315
+ // 从候选里挑一条填好槽位的。抽出来是为了让"试说一句"能对着还没保存的文本走同一条路。
316
+ static NSString *PickFromCandidates(NSArray<NSString *> *candidates,
317
+ NSDictionary<NSString *, NSString *> *slots, BOOL rememberRecent) {
318
+ if (candidates.count == 0) return nil;
319
+
320
+ // 最近说过的先排除。全被排除掉时(词条太少)就放开限制,总比不说话强。
321
+ static NSMutableArray<NSString *> *recent;
322
+ static dispatch_once_t once;
323
+ dispatch_once(&once, ^{ recent = [NSMutableArray array]; });
324
+
325
+ NSMutableArray<NSString *> *pool = [NSMutableArray array];
326
+ for (NSString *text in candidates) {
327
+ if (!rememberRecent || ![recent containsObject:text]) [pool addObject:text];
328
+ }
329
+ if (pool.count == 0) [pool addObjectsFromArray:candidates];
330
+
331
+ // 槽位填不上的条目要跳过,所以随机打乱后依次试,而不是一把梭。
332
+ NSMutableArray<NSString *> *shuffled = [pool mutableCopy];
333
+ for (NSUInteger index = shuffled.count; index > 1; index--) {
334
+ NSUInteger swap = arc4random_uniform((uint32_t)index);
335
+ [shuffled exchangeObjectAtIndex:index - 1 withObjectAtIndex:swap];
336
+ }
337
+ for (NSString *template in shuffled) {
338
+ NSString *text = FillSlots(template, slots);
339
+ if (text.length == 0) continue;
340
+ if (rememberRecent) {
341
+ [recent addObject:template];
342
+ while (recent.count > PetPhraseRecentMemory) [recent removeObjectAtIndex:0];
343
+ }
344
+ return text;
345
+ }
346
+ return nil;
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
+ }
@@ -0,0 +1,17 @@
1
+ #import <Cocoa/Cocoa.h>
2
+
3
+ // app 内置的台词编辑器。
4
+ //
5
+ // 为什么不用系统默认编辑器(原来是 openURL: 交给"文本编辑"):那条路没有任何反馈。
6
+ // 用户改完保存、桌宠照旧,他无从知道是小节名拼错了、还是句子超了 30 字、还是槽位
7
+ // 写错了名字——这些全都是静默失效。编辑器存在的唯一理由就是把校验结果当场摆出来。
8
+ @interface PetPhrasesEditorController : NSWindowController
9
+
10
+ // 打开(已开着就前置)。窗口是单例,避免两个窗口各自编辑同一个文件互相覆盖。
11
+ + (void)present;
12
+
13
+ // "试说一句"回调:把选中情境的一条台词交给桌宠当场说出来。
14
+ // 编辑器不认识气泡,也不该认识——它只负责给出文本。
15
+ + (void)setSpeakHandler:(void (^)(NSString *text))handler;
16
+
17
+ @end