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.
- package/CHANGELOG.md +115 -0
- package/README.md +100 -0
- package/Sources/CCPets/CCPetsAppDelegate.h +22 -0
- package/Sources/CCPets/CCPetsAppDelegate.m +565 -25
- package/Sources/CCPets/CCPetsPhrases.h +127 -0
- package/Sources/CCPets/CCPetsPhrases.m +600 -0
- package/Sources/CCPets/CCPetsPhrasesEditor.h +17 -0
- package/Sources/CCPets/CCPetsPhrasesEditor.m +369 -0
- package/Sources/CCPets/CCPetsPreviews.h +3 -0
- package/Sources/CCPets/CCPetsPreviews.m +60 -0
- package/Sources/CCPets/PetView.h +9 -4
- package/Sources/CCPets/PetView.m +722 -17
- package/Sources/CCPets/main.m +6 -0
- package/package.json +1 -1
- package/scripts/build.sh +5 -0
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
#import <Foundation/Foundation.h>
|
|
2
|
+
|
|
3
|
+
// 桌宠说的话。全部来自用户词库文件,代码里不再留一份内置词库。
|
|
4
|
+
//
|
|
5
|
+
// 这一层刻意和"怎么显示""什么时候说"完全分开:取句子是一个纯函数式的接口,
|
|
6
|
+
// 以后换成大模型生成只是换掉这里的实现,气泡和触发逻辑一个字都不用动。
|
|
7
|
+
//
|
|
8
|
+
// 语义只有一条:**文件里有什么就说什么**。没有合并、没有 replace、没有兜底。
|
|
9
|
+
// 删掉一节就是那个情境不吭声。这样用户看到的文件就是桌宠的全部台词,
|
|
10
|
+
// 不存在"我明明删了它还在说"这种解释不清的状态。
|
|
11
|
+
|
|
12
|
+
// 情境标签。**这是发布给用户的稳定契约**,用户词库按它分组,不要随版本改名,
|
|
13
|
+
// 否则别人写好的词库会静默失效。
|
|
14
|
+
extern NSString *const PetPhraseTagDone; // 任务完成
|
|
15
|
+
extern NSString *const PetPhraseTagFail; // 任务失败
|
|
16
|
+
extern NSString *const PetPhraseTagQuotaLow; // 额度告急
|
|
17
|
+
extern NSString *const PetPhraseTagLateNight; // 深夜
|
|
18
|
+
extern NSString *const PetPhraseTagLongSession; // 久坐
|
|
19
|
+
extern NSString *const PetPhraseTagWake; // 久别重逢
|
|
20
|
+
extern NSString *const PetPhraseTagIdle; // 闲着
|
|
21
|
+
|
|
22
|
+
// Agent 状态的宠物口吻文案。这些不是"额外说话",而是状态卡副行的正文来源——
|
|
23
|
+
// 每个 hook 状态都由宠物来讲,所以不受说话预算限制。
|
|
24
|
+
// 前缀 state_ 是为了和上面那组情绪标签分开:情绪句会在关键时刻顶掉常规状态文案。
|
|
25
|
+
extern NSString *const PetPhraseTagStateStarting;
|
|
26
|
+
extern NSString *const PetPhraseTagStateIdle;
|
|
27
|
+
extern NSString *const PetPhraseTagStateThinking;
|
|
28
|
+
extern NSString *const PetPhraseTagStateAutoReview;
|
|
29
|
+
extern NSString *const PetPhraseTagStateApproval;
|
|
30
|
+
extern NSString *const PetPhraseTagStateSubagent;
|
|
31
|
+
extern NSString *const PetPhraseTagStateTool; // 说不清是哪类工具时的兜底
|
|
32
|
+
extern NSString *const PetPhraseTagStateToolBash; // 执行命令
|
|
33
|
+
extern NSString *const PetPhraseTagStateToolEdit; // 编辑文件
|
|
34
|
+
extern NSString *const PetPhraseTagStateToolRead; // 查找资料
|
|
35
|
+
extern NSString *const PetPhraseTagStateToolDone;
|
|
36
|
+
extern NSString *const PetPhraseTagStateToolFailed;
|
|
37
|
+
extern NSString *const PetPhraseTagStateCompleted;
|
|
38
|
+
extern NSString *const PetPhraseTagStateFailed;
|
|
39
|
+
extern NSString *const PetPhraseTagStateNotification;
|
|
40
|
+
|
|
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 覆盖(测试用)。
|
|
49
|
+
//
|
|
50
|
+
// 纯文本而不是 JSON:普通用户写不了 JSON,而且少个逗号整个文件失效、我们静默降级,
|
|
51
|
+
// 用户只会觉得"改了没用"。纯文本一行一句,写错只丢那一行。
|
|
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);
|
|
85
|
+
|
|
86
|
+
// 取一条填好槽位的话。取不到返回 nil(调用方应当直接不说话,而不是显示占位符)。
|
|
87
|
+
// slots 的键是白名单里的槽位名(不含花括号),值统一按字符串处理。
|
|
88
|
+
NSString *PetPhraseForTag(NSString *tag, NSDictionary<NSString *, NSString *> *slots);
|
|
89
|
+
// 从一段还没保存的文本里取某个标签的一条,供编辑器的"试说一句"用。
|
|
90
|
+
NSString *PetPhraseForTagInText(NSString *tag, NSString *text,
|
|
91
|
+
NSDictionary<NSString *, NSString *> *slots);
|
|
92
|
+
|
|
93
|
+
// 允许出现在模板里的槽位。白名单制:没列在这里的一律原样留着,不做替换。
|
|
94
|
+
NSArray<NSString *> *PetPhraseSlotNames(void);
|
|
95
|
+
|
|
96
|
+
// 单条模板的长度上限(字符)。超了直接丢弃——气泡布局撑不下,
|
|
97
|
+
// 与其截断出半句话不如不说。
|
|
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);
|