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 CHANGED
@@ -4,6 +4,121 @@
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
+
61
+ ## [1.3.2] - 2026-08-19
62
+ ### 桌宠活物感改造
63
+
64
+ - 渲染层从 `drawRect:` 改为 layer-backed,精灵内容挂在独立的 `CALayer` 上,为呼吸和拖动
65
+ 物理让路——这两样必须走 Core Animation:插值和合成都在 render server 侧,主进程零唤醒;
66
+ 若走 `drawRect:`,呼吸要平滑就得约 20fps,而动画定时器原本才 4.5 次/秒,一项就能把
67
+ 常驻开销全部吐回去。为此新增 `--render-pet` 逐格渲染 PetView 并逐字节比对(原有三个
68
+ `--render-*` 一格宠物都不画,改坏 PetView 它们照样全绿)。改造过程中它抓到两次
69
+ 等价性破坏:素材经 `LoadPetSpriteImage` 缩略后未必能被行列整除(默认素材单格高
70
+ 151.67px),`CGImageCreateWithImageInRect` 预裁会把小数矩形取整、`contentsRect` 交给
71
+ CA 缩放也有自己的采样相位,两者都和原来的 `drawInRect:fromRect:` 对不上,边缘整行错位。
72
+ 最终照搬原绘制调用按格预栅格化并缓存,9 行与 11 行素材均逐字节一致。
73
+ - 屏幕睡眠时一并冻结 layer 时间轴并清空栅格化缓存。停表只管得住 `NSTimer` 驱动的逐帧
74
+ 动画,CA 动画的时钟在 render server 那边,屏幕睡了照跑。
75
+ - 待机加入呼吸(1.5px 上浮,`reduceMotion` 下不启用)。只向上不做对称摆动:宠物视图在
76
+ 230×170 窗口里位于 (43,0,144,150),下方没有余量,往下 1px 就被窗口裁掉。
77
+ - 拖动加入水平滞后与落脚 squash。拖动由窗口服务器接管、拿不到连续事件,改从
78
+ `NSWindowDidMoveNotification` 取位移。只做水平方向:左右各有 43px 余量,垂直方向下方是 0。
79
+ - 待机微动层:每 8~25 秒(泊松随机)做一个有始有终的小动作。11 行素材按角度顺序连播
80
+ row 9/10 的朝向格,等于白捡一个转头动画——那 16 格本是静止姿势,连起来就是转头,不需要
81
+ 任何新素材;9 行素材退到 row 3 张望。**不再改待机循环本身的节奏**:随机长停某一帧和整轮
82
+ 变速都试过,素材不受控(第 0 帧不保证是自然站姿),一律被读成"动画卡住了"。
83
+ - 内在状态:无聊曲线(闲置 2/10/30 分钟三档,微动频率先升后降)、生理余韵(agent 事件累积
84
+ 用力值,25 秒半衰期,呼吸分三档快慢)、注意力惯性(鼠标移动 88% 被忽略,被吸引后 3~8 秒
85
+ 失去兴趣,再冷却 4~12 秒)。注意力惯性顺带把绕宠物移动鼠标时的开销压了下来。
86
+ - 无聊曲线的计时基准是真实事件流而不是 `agentActive`:`mouseDown:` 会无条件清掉后者,
87
+ 用户随手点一下宠物就会让曲线误启动。上次交互时间落盘,隔几小时再开机从"打盹"档开始。
88
+ - 素材能力(是否有十六向朝向行)在换素材时算一次,微动改为按能力过滤的数据表;行数判断从
89
+ 四处收敛到一处,两档行为密度保持一致,切换素材应读作"性格不同"而非"功能残缺"。
90
+
91
+ ### 状态卡改由宠物口吻叙述
92
+
93
+ - 每个 hook 状态的副行文案改为宠物口吻,从台词库随机取、带最近使用抑制,同一状态每次读到的
94
+ 不一样。原来"正在调用工具…"一句覆盖四类工具,现在执行命令/编辑文件/查找资料/子 Agent
95
+ 各说各的,信息量反而更大。取不到台词时回落原系统文案。
96
+ - 排版层级反转:事实降为眉标(11pt Medium 浅灰),宠物的话升为正文(14pt Medium 深色)。
97
+ - 状态卡与说话气泡按文案长度伸缩,不再是固定宽度。宽度用控件自身的 `fittingSize` 量——
98
+ 按字符串量的 `sizeWithAttributes:` 比 `NSTextField` 真正需要的窄几个点,会让"刚好够"
99
+ 变成省略号。
100
+ - 新增"碎碎念":额度告急、连续失败、深夜、久坐、久别重逢等时刻主动说一句。每小时上限 4 句
101
+ 且两句间隔至少 4 分钟——状态播报不受此限,那是替换样板文案而非额外说话。有状态卡时话并入
102
+ 它的副行,没有才起独立气泡,同一时刻屏幕上只有一个东西在说话。
103
+ - 额度台词按档位下穿触发(20%/10%/5%),不是"低于阈值就一直说";额度是分钟级刷新的,
104
+ 不设档一小时预算瞬间烧光。回血后档位回升,下个周期才能再触发。
105
+
106
+ ### 自定义台词
107
+
108
+ - 支持 `~/.cc-pets/phrases.txt` 自定义台词,右键菜单"碎碎念 → 自定义台词…"生成模板并打开。
109
+ 模板写满中文说明与逐条示例,取消注释即生效。
110
+ - 格式是纯文本而非 JSON:普通用户写不了 JSON,且少个逗号就整个文件失效、我们静默回落内置,
111
+ 用户只会觉得"改了没用"。纯文本逐行解析,写错只丢那一行。
112
+ - 用户台词永远按数据处理,绝不交给 `stringWithFormat:`——一个 `%@` 就会让桌宠当场崩溃。
113
+ 测试里有断言守着这条,以及行尾注释剥离、超长条目丢弃、槽位缺值时整条作废(宁可不说,
114
+ 也不吐出带花括号的半成品)。
115
+
116
+ ### 已知未完成
117
+
118
+ - README 尚未记录台词文件、情境标签契约与调试用的 defaults 键。
119
+ - 呼吸、微动、拖动物理没有总开关(碎碎念有)。
120
+ - 常驻内存较改造前上升,栅格化缓存上限已从 48 格降到 20 格并在息屏时清空,实际效果待复测。
121
+
7
122
  ## [1.3.2] - 2026-08-17
8
123
  - 优化“切换桌宠”子菜单:素材名称按 5 个中文字符的视觉宽度展示,超出后追加 `...`;外部素材增加
9
124
  垃圾桶删除入口,首次点击后原位置变为红字“确认”,再次点击才执行删除。切换或删除素材时
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 或更高版本
@@ -1,4 +1,5 @@
1
1
  #import <Cocoa/Cocoa.h>
2
+ #import <QuartzCore/QuartzCore.h>
2
3
  #import "PetView.h"
3
4
  #import "QuotaDashboardView.h"
4
5
  #import "CCPetsUsageMonitor.h"
@@ -7,8 +8,29 @@
7
8
  @interface AppDelegate : NSObject <NSApplicationDelegate>
8
9
  @property NSPanel *panel;
9
10
  @property NSPanel *quotaPanel;
11
+ // 说话气泡。懒创建:用户不开启说话功能就永远不存在这个窗口。
12
+ @property NSPanel *speechPanel;
13
+ @property NSTextField *speechLabel;
14
+ @property NSVisualEffectView *speechGlass;
15
+ // 预算制:这一小时说过几句、以及冷却到什么时候。
16
+ @property NSMutableArray<NSNumber *> *speechTimestamps;
17
+ @property NSTimeInterval speechCooldownUntil;
18
+ @property NSTimeInterval lastIdleSpeechCheck;
19
+ @property NSTimeInterval lastAgentEventAt;
20
+ // 上一次选中的状态标签与文案。同状态的连串事件里保持不变,避免副行闪烁。
21
+ @property(copy) NSString *lastPetVoiceTag;
22
+ @property(copy) NSString *lastPetVoiceText;
23
+ @property NSTimeInterval sessionStartedAt;
24
+ @property NSInteger consecutiveFailures;
25
+ // 最近一次 agent 事件的工具名,供 {toolName} 槽位使用。
26
+ @property(copy) NSString *lastSpeechTool;
27
+ // 上次播报额度时剩余百分比落在哪一档。只在向下穿档时说,不是"低于阈值就一直说"。
28
+ @property NSInteger lastQuotaTier;
29
+ @property BOOL lastQuotaTierInitialized;
10
30
  @property NSPanel *statusPanel;
11
31
  @property NSVisualEffectView *statusGlass;
32
+ // 卡片要随文案长度伸缩,阴影层得跟着一起改,所以不能再是个局部变量。
33
+ @property NSView *statusShadowView;
12
34
  @property NSTextField *statusTitleLabel;
13
35
  @property NSTextField *statusDetailLabel;
14
36
  @property NSButton *statusIconButton;