cc-pets 1.4.0 → 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 CHANGED
@@ -4,6 +4,60 @@
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
+ - 用户词库改名 `~/.cc-pets/phrases.txt` → `~/.cc-pets/speech.txt`。换名字是为了让"迁移过
8
+ 没有"变成一个平凡的判断(新文件在就是迁移过了)——靠猜内容特征(有没有 replace 行、
9
+ 缺不缺某个小节)都不可靠,用户改过之后更没法判断。
10
+ - 老词库在**启动时**就自动合并进新文件,不等用户打开编辑器:拖到那时候再迁移的话,
11
+ 从升级到他第一次点"编辑台词"这段时间,桌宠说的会是出厂台词而不是他自己写的,
12
+ 而没人会把这件事和"我该去点一下编辑台词"联系起来。合并规则是"出厂 + 用户"取并集,
13
+ 因为老语义就是两者混着说;老文件里写过 `replace` 的,他写过的那几节按他的来,
14
+ 没写过的仍旧用出厂内容(照搬老语义会让 15 个 `state_` 小节全空,而新版没有兜底文案,
15
+ 状态卡副行会直接残掉)。老文件里的注释一概不搬,按新模板的来。
16
+ - 老文件合并后先留着,第一次打开编辑器时问一次要不要改名成 `phrases.txt.bak` 收起来——
17
+ 合并是我们替用户做的,动他的文件得他自己点头。改名而不是删除:内容还在原地,万一合并
18
+ 合错了还能翻出来对;而 `PetPhrasesLegacyFilePath` 只认 `phrases.txt`,改完名它既不会
19
+ 再被当成迁移源,也不会再弹询问。留着原名不动有两个坑:改它不会有任何效果,而且哪天
20
+ `speech.txt` 丢了,启动时会再从它合并一遍,把用户迁移之后写的台词全冲掉。
21
+ - 台词改成"文件即全部":删掉代码里的内置词库,默认台词变成随 app 打包的
22
+ `Resources/phrases.default.txt`,首次启动拷到 `~/.cc-pets/phrases.txt`,之后运行时
23
+ 只认这个文件。同时删掉 merge / `replace` 两种模式——运行期同时存在两份词库就必然
24
+ 要回答"以谁为准",而那正是原来那套配置让人看不懂的根源。现在删掉一节就是那个情境
25
+ 不吭声,用户看到的文件就是桌宠的全部台词。
26
+ - 台词编辑从「交给系统文本编辑器」换成 app 内置编辑器。原来那条路没有任何反馈:
27
+ 小节名拼错、句子超 30 字、槽位写错名字全是静默失效,用户只知道"改了没用"。
28
+ - 标签行被删掉时,保存会自动把它加回原位并告知补了哪些(⌘Z 可撤销)。光报错等于把人
29
+ 卡死:编辑器里已经看不到那一行,用户既不知道少的是哪个,也不知道该写成什么样,
30
+ 只能翻文档或者点"恢复出厂"把自己的改动全丢掉。标签被删而台词还在时,那串台词会并进
31
+ 上一节,所以标签要插回那串台词**前面**才能带着它们一起归位;标签连着台词一起删掉的
32
+ 情况下只补标签,不能顺手把上一节的台词抢过来。
33
+ - 保存时校验并当场列出问题。标签行是配置项,22 个一个都不能删;
34
+ 能不能留空才分两种——`[state_*]` 是状态卡副行的唯一正文来源,空了也拦,情绪句留空
35
+ 只提示(就是那个情境不主动开口)。"整行被删"和"还在但空了"分开报,因为要做的动作
36
+ 不一样:一个是把 `[标签]` 那行加回来,一个是补句台词。槽位名拼错也会报——这类最难自查。
37
+ - 连续的"不在任何 [情境] 下面"的散句合并成一条提示。删掉一个小节头会让它下面整串台词
38
+ 变成散句,逐行报的话十几条提示会把真正该看的那条错误挤下去。
39
+ - 编辑器的保存分成「保存」(⌘S)和「保存并关闭」(⏎)。⌘S 而不是回车是因为这是多行
40
+ 文本编辑器,回车要用来换行。校验没过或 mtime 冲突被取消时不关窗,避免改动跟着窗口一起没。
41
+ - 编辑器新增「试说一句」:选一个情境,桌宠当场说出来。读的是还没保存的文本,槽位用
42
+ 示例数据填,不用等真的额度告急才能看到效果。另有「恢复出厂台词…」(可 ⌘Z 撤销)。
43
+ - 保存前比对 mtime,文件被外部改过时问一次,可选覆盖或重新载入,不静默吃掉别人的改动。
44
+ - 状态卡副行没有内容时收成单行,不再留一块空白——代码里已经没有兜底文案了,
45
+ 外部编辑器清空某个 `state_` 小节时显示层必须自己站得住。
46
+
47
+ - 碎碎念不再受"agent 是否在线"影响。原来的闸门是"状态卡可见就闭嘴",而状态卡只要客户端
48
+ 活着就常驻,等于开着终端就永远不会碎碎念——独立气泡那条路径实际上从来没跑到过。
49
+ 改成按"agent 在不在干活"判断:只有状态卡处于 idle 或根本没显示时才说话,thinking /
50
+ tool / approval / notification / completed / failed 的工作文案优先级最高,闲话一律让路。
51
+ - 碎碎念借走状态卡副行说完一句后会自动还原状态文案(`restoreStatusDetail`),此前借走就
52
+ 不还,副行会一直挂着上一句闲话;同时不再用闲话覆盖 `lastPetVoiceText`,那是状态文案的
53
+ 去重缓存,被污染后下一次同状态事件会把闲话当成该状态的文案复读出来。
54
+ - 右键菜单「碎碎念」新增频率四档(很少 / 正常 / 较多 / 话痨)。每小时预算、两句间隔、
55
+ 静默门槛、出话概率这四道闸互相牵制,单调任何一道都不会真的变频繁,所以只对用户暴露
56
+ 一个档位、四个值一起走;正常档即改造前的原值。`CCPetsSpeechCooldown` 与
57
+ `CCPetsSpeechHourlyBudget` 保留为更细的手动覆盖,写了就压过档位。
58
+ - README 补齐「碎碎念」一节:频率档位表、`phrases.txt` 写法、槽位与情境标签契约、
59
+ 调试用的 `defaults` 键(含域名必须是 bundle identifier 这一点)。
60
+
7
61
  ## [1.3.2] - 2026-08-19
8
62
  ### 桌宠活物感改造
9
63
 
package/README.md CHANGED
@@ -10,6 +10,8 @@
10
10
  - 鼠标悬停口袋时展开额度详情面板,用两张卡分别显示 Codex、Claude 的剩余 5 小时额度、周额度和精确到秒的周重置时间
11
11
  - reset 时间自动转换为 Mac 当前系统时区,例如 `Jul 22 3pm America/Los_Angeles` 在上海时区显示为 `7/23 06:00:00`
12
12
  - 支持待机、左右拖动、身体两侧感应、头部/脚部悬停和点击反馈动画
13
+ - 待机呼吸、随机小动作(11 行素材会转头看鼠标)、拖动时的水平滞后与落脚回弹
14
+ - 桌宠以自己的口吻播报 Agent 状态,闲着时还会自己碎碎念,台词和频率都可自定义
13
15
  - 支持拖动桌宠位置,右键刷新用量、检查更新或退出
14
16
  - 响应 Codex 与 Claude Code Agent 的思考、工具调用、审批、子 Agent、完成和失败状态
15
17
  - 在桌宠旁显示脱敏后的玻璃 Agent 状态卡片,可展开、折叠并显示活跃 CLI 会话数
@@ -105,6 +107,104 @@ Provider、脱敏状态和通用说明,不提供消息输入,也不会显示
105
107
  连续 1 分钟没有收到新的 Agent 状态事件时,卡片和圆钮会一起自动隐藏;下一次收到事件时
106
108
  会重新显示并重新计时。
107
109
 
110
+ ## 碎碎念
111
+
112
+ 桌宠会以自己的口吻讲话:Agent 干活时讲的话直接写在状态卡副行上,闲着的时候单独冒气泡。
113
+ 右键菜单「碎碎念」里可以整体开关、调频率、改台词。
114
+
115
+ ### 频率
116
+
117
+ 四个档位,一个开关同时管住四道闸——它们互相牵制,单调其中任何一道都不会真的变频繁:
118
+
119
+ | 档位 | 每小时最多 | 两句最短间隔 | 静默多久才算闲 | 每次判定的出话概率 |
120
+ |--------------|------------|--------------|----------------|--------------------|
121
+ | 很少 | 2 句 | 480 秒 | 300 秒 | 15% |
122
+ | 正常(默认) | 4 句 | 240 秒 | 180 秒 | 25% |
123
+ | 较多 | 8 句 | 120 秒 | 90 秒 | 45% |
124
+ | 话痨 | 20 句 | 45 秒 | 45 秒 | 70% |
125
+
126
+ Agent **正在干活**时(思考、调用工具、等待审批、子 Agent 工作等)不会插嘴,状态卡上的
127
+ 工作文案优先级最高。只有状态卡处于「待机中」或压根没显示时才会碎碎念——所以开着终端
128
+ 也照样会说话,不需要退出 CLI。借走状态卡副行说完一句后,副行会自动还原成状态文案。
129
+
130
+ ### 编辑台词
131
+
132
+ 右键菜单「碎碎念 → 编辑台词…」打开内置编辑器。桌宠说的**所有**话都在
133
+ `~/.cc-pets/speech.txt` 里,代码里没有第二份词库——首次启动时从 app 内的出厂词库
134
+ 拷一份出来,之后就只认这个文件。
135
+
136
+ > **从旧版升级**:原来的 `~/.cc-pets/phrases.txt` 会在启动时自动合并到 `speech.txt`,
137
+ > 你写过的台词一句不丢,注释换成新版的。第一次打开编辑器时会问要不要把那个已经不起
138
+ > 作用的旧文件改名成 `phrases.txt.bak` 收起来——内容留在原地,但不会再被当成迁移源。
139
+ >
140
+ > 选「先留着」也可以,只是要知道两件事:改它不会有任何效果;哪天 `speech.txt` 丢了,
141
+ > 启动时会再从它合并一遍,把你迁移之后写的台词冲掉。
142
+
143
+ 语义只有一条:**文件里有什么就说什么**。没有合并、没有 replace、没有兜底,
144
+ 删掉一节就是那个情境不吭声。
145
+
146
+ ```
147
+ # 井号开头是注释,行尾的 " #" 之后也是注释
148
+ [idle] # 闲着没事
149
+ 又没人理我。
150
+ 今天也是划水的一天。
151
+ ```
152
+
153
+ - `[情境]` 起一节,下面一行一句,直接改字、加行、删行
154
+ - 每句 30 字以内,超了那一行会被丢掉
155
+ - 写错只丢那一行,不会让整个文件失效
156
+
157
+ 可以插入这些实时数据(连花括号一起写):`{quota5h}` `{resetTime}` `{toolName}`
158
+ `{sessionMin}` `{failCount}` `{hour}`。取不到值时,用到该槽位的那一句会被整条跳过,
159
+ 不会显示占位符。
160
+
161
+ 编辑器的三个按钮:
162
+
163
+ - **试说一句** —— 选一个情境,桌宠当场把那一节里的一句说出来。读的是编辑器里
164
+ **还没保存**的文本,槽位用示例数据填,所以不用等到真的额度告急才能看到效果
165
+ - **恢复出厂台词…** —— 把编辑器内容换成出厂词库,按 ⌘Z 可撤销,不保存不写文件
166
+ - **保存**(⌘S)/ **保存并关闭**(⏎)—— 保存时校验,问题当场列出来。
167
+ 校验没过或被 mtime 冲突取消时不会关窗,改动不会跟着窗口一起消失
168
+
169
+ 校验分两级:
170
+
171
+ 标签行是配置项,22 个一个都不能删。删掉之后编辑器里就看不见它了,用户既不知道少的是
172
+ 哪个也不知道该写成什么样,所以保存时会**自动把标签加回原位**——台词还在的话会连同台词
173
+ 一起归位——并在提示里说明补了哪些。能不能留空才分两种:
174
+
175
+ | | 行为 |
176
+ | --- | --- |
177
+ | 任何一行 `[标签]` 被删掉 | **自动加回原位**并告知,⌘Z 可撤销 |
178
+ | `[state_*]` 标签还在但台词删光了 | **拦下不给保存**。状态卡副行的正文只有这一个来源 |
179
+ | 情绪句标签还在但台词删光了 | 提示。这是合法选择,就是那个情境不主动开口 |
180
+ | 小节名拼错、句子超长、散句不在任何情境下 | 提示,只影响那一行 |
181
+ | 槽位名拼错(如 `{quotaLeft}`) | 提示。这类最难自查——句子看着没问题,运行时被整条跳过 |
182
+
183
+ 文件被外部编辑器同时改过时,保存前会问一次,可以选覆盖或重新载入。
184
+
185
+ 情境标签是稳定契约,不随版本改名:
186
+
187
+ - 情绪句(受频率档位的预算限制):`done` `fail` `quota_low` `late_night` `long_session` `wake` `idle`
188
+ - 状态卡副行(由 Agent 事件驱动,不受预算限制):`state_starting` `state_idle` `state_thinking`
189
+ `state_auto_review` `state_approval` `state_subagent` `state_tool` `state_tool_bash`
190
+ `state_tool_edit` `state_tool_read` `state_tool_done` `state_tool_failed` `state_completed`
191
+ `state_failed` `state_notification`
192
+
193
+ ### 调试开关
194
+
195
+ 以下键用于调试和微调,现读现生效,不用重启。**域名是 bundle identifier
196
+ `com.universewang.cc-pets`**,写成 `cc-pets` 会落到另一个 plist 里,桌宠永远读不到,
197
+ 表现为「设了没反应」:
198
+
199
+ ```sh
200
+ defaults write com.universewang.cc-pets CCPetsSpeechFrequency -string chatty
201
+ defaults write com.universewang.cc-pets CCPetsSpeechCooldown -float 0 # 覆盖档位里的间隔
202
+ defaults write com.universewang.cc-pets CCPetsSpeechHourlyBudget -int 100 # 覆盖档位里的预算
203
+ defaults write com.universewang.cc-pets CCPetsBoredomScale -float 0.1 # 压缩无聊曲线与静默门槛
204
+ defaults write com.universewang.cc-pets CCPetsSpeechDebugTag -string quota_low # 立刻弹一次,弹完自动清
205
+ defaults delete com.universewang.cc-pets CCPetsSpeechCooldown # 交回档位
206
+ ```
207
+
108
208
  ## 系统要求
109
209
 
110
210
  - macOS 13 或更高版本
@@ -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 内边距,没有图标。