cc-pets 1.3.3 → 1.4.0

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