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.
@@ -1,4 +1,5 @@
1
1
  #import "PetView.h"
2
+ #import <QuartzCore/QuartzCore.h>
2
3
  #import "MenuToggleSwitch.h"
3
4
  #import "CCPetsPaths.h"
4
5
  #import "CCPetsImageLoader.h"
@@ -13,10 +14,91 @@ static const CGFloat PetSubmenuRowWidth = 134.0;
13
14
  static const CGFloat PetMenuControlGap = 8.0;
14
15
  static const NSInteger PetMenuCheckViewTag = 1001;
15
16
  static const NSInteger PetMenuDeleteButtonTag = 1002;
17
+ // 呼吸:只向上浮,不做上下对称摆动。宠物视图在 230×170 的窗口里位于 (43,0,144,150),
18
+ // 下方一点余量都没有,往下 1px 就被窗口裁掉。静止位不变,所以离屏基准图不受影响。
19
+ static const CGFloat PetBreathRise = 1.5;
20
+ static const NSTimeInterval PetBreathPeriod = 3.6;
21
+ // 拖动滞后只做水平方向。窗口左右各有 43px 余量,而下方是 0——垂直滞后往下一点就被裁掉,
22
+ // 只留向上会变成不对称的怪动作,不如不做。反正拖动本来就按水平方向选跑动行,
23
+ // 水平滞后正好强化那个方向感。
24
+ static const CGFloat PetDragLagMax = 13.0;
25
+ static const CGFloat PetDragLagFactor = 0.85;
26
+ // 松手后的"落脚":先压扁再回弹到静止。锚点在脚底,所以压扁是往下坐,不会越界。
27
+ static const NSTimeInterval PetSettleDuration = 0.34;
28
+ // 微动层:待机时每隔一段随机时间做一个有始有终的小动作。间隔必须随机——固定周期
29
+ // 会被下意识数出拍子,一旦数出来就全毁了。
30
+ static const NSTimeInterval PetMicroIntervalMin = 8.0;
31
+ static const NSTimeInterval PetMicroIntervalMax = 25.0;
32
+ // 无聊曲线的三个拐点(秒)。闲久了先躁动、再倦、最后几乎不动,是条先升后降的曲线。
33
+ static const NSTimeInterval PetBoredomRestless = 120.0;
34
+ static const NSTimeInterval PetBoredomTired = 600.0;
35
+ static const NSTimeInterval PetBoredomDrowsy = 1800.0;
36
+ // 十六向朝向定格保持多久(秒)。这是素材本来就设计成静止的格子,定格不违和。
37
+ static const NSTimeInterval PetGlanceHoldMin = 0.7;
38
+ static const NSTimeInterval PetGlanceHoldMax = 1.6;
39
+ // 生理余韵:agent 干完活之后呼吸会快一阵,再用几十秒平复回基线。
40
+ // 事件结束不等于状态归零——这种跨状态的连续性是免费的活物感。
41
+ static const double PetExertionPerEvent = 0.15;
42
+ static const NSTimeInterval PetExertionHalfLife = 25.0;
43
+ // 上次交互时间落盘的键。重启后接着算无聊曲线,隔了几小时再开就是从"打盹"开始,
44
+ // 而不是每次启动都精神抖擞。
45
+ static NSString *const PetLastActivityKey = @"CCPetsLastActivityAt";
46
+ static const NSTimeInterval PetActivitySaveInterval = 60.0;
47
+
48
+ // 微动的种类。加新动作就往这里加一项、再往 microBehaviorTable 里登记一行,
49
+ // 调度器不用改。
50
+ typedef NS_ENUM(NSInteger, PetMicroBehaviorKind) {
51
+ PetMicroBehaviorGlance, // 逐格转头看鼠标,需要十六向朝向行
52
+ PetMicroBehaviorScan, // row 3 张望,任何素材都有
53
+ };
16
54
 
17
55
  @interface PetView ()
18
56
  @property(weak) NSMenu *activePetSwitchMenu;
19
57
  @property(copy) NSString *pendingDeletePetID;
58
+ // 素材能力:由行数在 applySheet: 时一次算出,之后全程只读这个,不再各处判行数。
59
+ //
60
+ // 散在各处写 rowCount == 11 的话,每加一个行为就多一处分支,测试翻倍且迟早漂移。
61
+ // 收成能力位之后,差异降级成"微动表里哪几行可用"这一个数据问题,调度器根本
62
+ // 不知道有分档这回事。
63
+ @property BOOL hasLookRows;
64
+ // 按能力过滤后的可用微动表,每项 @{kind, weight}。
65
+ @property NSArray<NSDictionary *> *microBehaviorTable;
66
+ // 精灵内容单独挂一层:呼吸、弹簧、落地 squash 都要对这一层做 CA 动画,放在视图自己的
67
+ // layer 上会连带影响命中测试和子视图几何。
68
+ @property CALayer *spriteLayer;
69
+ // 当前帧已经停了几拍,够 frameHolds 里那个数才推进。
70
+ @property NSUInteger holdTicks;
71
+ // 待机当前的速度档(拍/帧)。行为已关,字段留给微动层的慢放用。
72
+ @property NSUInteger idleHold;
73
+ // 微动层:独立于 oneShot 的一套标志。
74
+ //
75
+ // 绝对不能复用 oneShot——它在 nextFrame: 里播完会连带把 agentActive 清成 NO
76
+ // (见那一处注释)。微动是待机期间的自发动作,跟 agent 状态毫无关系,借它的壳会把
77
+ // "agent 正在干活"这个状态误清掉。
78
+ @property BOOL microActive;
79
+ // 下一次换图走一次短淡入淡出。进出微动那一下是硬切,加这一下过渡就不突兀了。
80
+ @property BOOL fadeNextContents;
81
+ @property NSInteger microCountdown;
82
+ // 最后一次"有事发生"的时间:agent 事件、鼠标交互、拖动都算。无聊曲线按它算。
83
+ //
84
+ // 不要改用 agentActive 判断闲了多久:mouseDown: 会无条件把它清成 NO,不管 agent
85
+ // 是不是还在跑,用户随手点一下宠物就会让无聊曲线误启动。
86
+ @property NSTimeInterval lastActivityTime;
87
+ // 注意力:真正在看的方向、以及这次注意力还能维持多久。
88
+ @property NSTimeInterval attentionUntil;
89
+ @property NSTimeInterval attentionCooldownUntil;
90
+ // 生理余韵:用力程度(0~1,按半衰期衰减)、上次更新时刻、当前呼吸档位。
91
+ @property double exertion;
92
+ @property NSTimeInterval exertionUpdatedAt;
93
+ @property NSInteger breathLevel;
94
+ @property NSTimeInterval lastActivitySavedAt;
95
+ // 拖动期间记上一次窗口位置,用来算这一帧走了多远。窗口服务器接管拖动后不给应用连续
96
+ // 事件,但 NSWindowDidMoveNotification 照发,这是拖动中唯一拿得到的位移信号。
97
+ @property NSPoint lastDragWindowOrigin;
98
+ @property BOOL observingWindowMove;
99
+ // 按格栅格化的位图。视网膜下每格 280×300×4 ≈ 328KB,整表 88 格会到 28MB,
100
+ // 所以设 cost 上限让它只留住真正在播的那些格。
101
+ @property NSCache<NSNumber *, id> *cellCache;
20
102
  @end
21
103
 
22
104
  @implementation PetView
@@ -26,9 +108,24 @@ static const NSInteger PetMenuDeleteButtonTag = 1002;
26
108
  _spriteRowCount = rowCount;
27
109
  _lookDirection = -1;
28
110
  _frames = @[@0, @1, @2, @3, @4, @5];
111
+ _frameHolds = @[@1, @1, @1, @1, @1, @1];
29
112
  _petMenuPreviewCache = [NSCache new];
30
113
  _petMenuPreviewCache.countLimit = 24;
31
114
  _petMenuPreviewCache.totalCostLimit = 4 * 1024 * 1024;
115
+ _cellCache = [NSCache new];
116
+ _cellCache.totalCostLimit = 6 * 1024 * 1024;
117
+ self.wantsLayer = YES;
118
+ _spriteLayer = [CALayer layer];
119
+ // 像素素材放大必须用最近邻,等价于原来 drawRect: 里的 NSImageInterpolationNone。
120
+ _spriteLayer.magnificationFilter = kCAFilterNearest;
121
+ _spriteLayer.minificationFilter = kCAFilterNearest;
122
+ // contentsScale 由 rebuildSpriteCache 按 backingScaleFactor 定,这里不预设。
123
+ // 锚点放在脚底:呼吸和之后的落地 squash 都该以脚为支点,锚在正中会变成
124
+ // "整体缩放",看着像忽远忽近而不是有重量。
125
+ _spriteLayer.anchorPoint = CGPointMake(0.5, 0.0);
126
+ [self.layer addSublayer:_spriteLayer];
127
+ [self layoutSpriteLayer];
128
+ [self rebuildSpriteCache];
32
129
  [NSNotificationCenter.defaultCenter addObserver:self
33
130
  selector:@selector(powerStateDidChange:)
34
131
  name:NSProcessInfoPowerStateDidChangeNotification object:nil];
@@ -42,6 +139,7 @@ static const NSInteger PetMenuDeleteButtonTag = 1002;
42
139
  NSTrackingActiveAlways | NSTrackingInVisibleRect
43
140
  owner:self userInfo:nil];
44
141
  [self addTrackingArea:tracking];
142
+ [self rebuildCapabilities];
45
143
  [self updateLookTracking];
46
144
  }
47
145
  return self;
@@ -67,11 +165,13 @@ static const NSInteger PetMenuDeleteButtonTag = 1002;
67
165
  [self.frameTimer invalidate];
68
166
  self.frameTimer = nil;
69
167
  [self updateFrameTimer];
168
+ [self updateBreathingAnimation];
70
169
  }
71
- // 动画帧只在“可见”且“不处于十六向跟随”时推进。跟随模式显示的是静态定格,
72
- // nextFrame: 进来只会立刻 return,定时器纯属空转。
170
+ // 定时器只看可见性。十六向跟随期间它也要转——注意力现在是有时限的,到点必须有人
171
+ // 把它收回来,而 updateLookForScreenPoint: 只在鼠标移动时才被调用,鼠标一停就没人
172
+ // 收尾了。跟随期间 nextFrame: 除了这个到期检查之外仍然什么都不做。
73
173
  - (void)updateFrameTimer {
74
- BOOL shouldRun = !self.animationSuspended && self.lookDirection < 0;
174
+ BOOL shouldRun = !self.animationSuspended;
75
175
  if (shouldRun == self.frameTimer.isValid) return;
76
176
  if (!shouldRun) {
77
177
  [self.frameTimer invalidate];
@@ -100,10 +200,38 @@ static const NSInteger PetMenuDeleteButtonTag = 1002;
100
200
  if (_animationSuspended == suspended) return;
101
201
  _animationSuspended = suspended;
102
202
  [self updateFrameTimer];
103
- if (!suspended) self.needsDisplay = YES;
203
+ // 停表只管得住 NSTimer 驱动的逐帧动画。呼吸、弹簧这些走 CA,时钟在 render server
204
+ // 那边,屏幕睡了照跑——必须把这一层的本地时间也冻住,否则 P0 省下来的电又漏回去。
205
+ [self setSpriteLayerPaused:suspended];
206
+ if (suspended) {
207
+ // 屏幕睡了就把栅格化缓存整个放掉:这是常驻内存里最大的一块,而睡眠期间一格都用不上。
208
+ // 醒来重新栅格化只是几毫秒的事,换十几兆常驻内存很划算。
209
+ [self.cellCache removeAllObjects];
210
+ } else {
211
+ [self updateSpriteContents];
212
+ }
213
+ }
214
+ // 冻结/恢复 layer 自己的时间轴。恢复时要把暂停期间流逝的时间补回 beginTime,
215
+ // 否则动画会从"睡了多久就跳多远"的位置继续。
216
+ - (void)setSpriteLayerPaused:(BOOL)paused {
217
+ CALayer *layer = self.spriteLayer;
218
+ if (!layer) return;
219
+ if (paused) {
220
+ if (layer.speed == 0.0) return;
221
+ CFTimeInterval now = [layer convertTime:CACurrentMediaTime() fromLayer:nil];
222
+ layer.speed = 0.0;
223
+ layer.timeOffset = now;
224
+ } else {
225
+ if (layer.speed != 0.0) return;
226
+ CFTimeInterval pausedAt = layer.timeOffset;
227
+ layer.speed = 1.0;
228
+ layer.timeOffset = 0.0;
229
+ layer.beginTime = 0.0;
230
+ layer.beginTime = [layer convertTime:CACurrentMediaTime() fromLayer:nil] - pausedAt;
231
+ }
104
232
  }
105
233
  - (void)startLookTracking {
106
- if (self.spriteRowCount != 11 || self.globalMouseMonitor || self.localMouseMonitor) return;
234
+ if (!self.hasLookRows || self.globalMouseMonitor || self.localMouseMonitor) return;
107
235
  __weak PetView *weakSelf = self;
108
236
  self.globalMouseMonitor = [NSEvent addGlobalMonitorForEventsMatchingMask:NSEventMaskMouseMoved
109
237
  handler:^(NSEvent *event) {
@@ -127,11 +255,32 @@ static const NSInteger PetMenuDeleteButtonTag = 1002;
127
255
  self.lookDirection = -1;
128
256
  }
129
257
  - (void)updateLookTracking {
130
- if (self.spriteRowCount == 11) [self startLookTracking];
258
+ if (self.hasLookRows) [self startLookTracking];
131
259
  else [self stopLookTracking];
132
260
  }
261
+ // 注意力有惯性也有衰减,这是活物和传感器的分水岭。
262
+ //
263
+ // 改造前是鼠标一动就实时跟随——那是摄像头。现在是:多数移动它压根不理会,偶尔才
264
+ // "注意到",看一阵子就失去兴趣回正,而且短期内不会再被同一波移动勾走。
265
+ // 副作用是开销大幅下降:原来屏幕上每个鼠标事件都要换一次朝向定格并重绘,现在只有
266
+ // 真正处于注意状态的那几秒才跟。
267
+ - (void)releaseAttention {
268
+ if (self.lookDirection < 0) return;
269
+ self.lookDirection = -1;
270
+ self.attentionCooldownUntil = CFAbsoluteTimeGetCurrent() +
271
+ 4.0 + 8.0 * (arc4random_uniform(1000) / 1000.0);
272
+ [self playRow:0 throughFrame:5 oneShot:NO];
273
+ }
133
274
  - (void)updateLookForScreenPoint:(NSPoint)screenPoint {
134
- if (self.spriteRowCount != 11 || self.draggingPet || self.oneShot || self.agentActive || !self.window) return;
275
+ if (!self.hasLookRows || self.draggingPet || self.oneShot || self.agentActive ||
276
+ self.microActive || !self.window) return;
277
+ NSTimeInterval now = CFAbsoluteTimeGetCurrent();
278
+ if (self.lookDirection < 0) {
279
+ if (now < self.attentionCooldownUntil) return;
280
+ // 绝大多数移动都不理会。这一条就是"惰性"本身。
281
+ if (arc4random_uniform(100) >= 12) return;
282
+ self.attentionUntil = now + 3.0 + 5.0 * (arc4random_uniform(1000) / 1000.0);
283
+ }
135
284
 
136
285
  NSPoint windowPoint = [self.window convertPointFromScreen:screenPoint];
137
286
  NSPoint localPoint = [self convertPoint:windowPoint fromView:nil];
@@ -157,11 +306,52 @@ static const NSInteger PetMenuDeleteButtonTag = 1002;
157
306
  for (NSInteger index = 0; index <= last; index++) [result addObject:@(index)];
158
307
  return result;
159
308
  }
309
+ // 全 1 的停留表 = 原来的匀速播放。
310
+ - (NSArray<NSNumber *> *)uniformHoldsForCount:(NSUInteger)count {
311
+ NSMutableArray<NSNumber *> *result = [NSMutableArray arrayWithCapacity:count];
312
+ for (NSUInteger index = 0; index < count; index++) [result addObject:@1];
313
+ return result;
314
+ }
315
+ // 待机的停留表:整轮统一放慢或加快,**绝不定格某一帧**。
316
+ //
317
+ // 试过"随机挑一帧长停 8~18 拍"做发呆,实测很别扭,别改回去。原因是素材不受控:
318
+ // 每套素材的待机行内容都不一样,第 0 帧也不保证是自然站姿,随便定格一帧经常停在
319
+ // 动作做到一半的姿势上,读起来是"动画卡住了"而不是"它在休息"。
320
+ // 改成只调速度:慢下来同样能读出"它安静了",而且因为始终在动,任何素材都不会翻车。
321
+ //
322
+ // 速度在 1~3 拍/帧之间随机游走(0.22~0.66s 一帧),并在一轮之内从上一档平滑过渡到
323
+ // 新一档,避免在循环接缝处突然变速。上限压在 3 拍,再慢就接近定格了。
324
+ // 现在返回匀速,等于关掉了这个行为。frameHolds 机制本身保留:微动层要用它做
325
+ // "慢放一个已有动作"和"定格朝向若干拍",而且全 1 时行为和改造前完全一致,留着零成本。
326
+ //
327
+ // 两版都试过,都不行,别再往回走:
328
+ // 1. 随机挑一帧长停 8~18 拍做"发呆"——素材不受控,第 0 帧也不保证是自然站姿,
329
+ // 经常停在动作做到一半的姿势上,读起来是"动画卡住了"。
330
+ // 2. 整轮 1~3 拍随机游走做"慢下来"——同样是在改一条连续动画的播放节奏,
331
+ // 观感是掉帧,不是休息。
332
+ // 结论:待机行本身已经是完整循环,动它的节奏一律读成故障。待机的活物感要靠
333
+ // **往流里插入有始有终的动作**(微动层),而不是改流本身的速度。
334
+ - (NSArray<NSNumber *> *)idleHoldsForCount:(NSUInteger)count {
335
+ return [self uniformHoldsForCount:count];
336
+ }
337
+ - (BOOL)isIdleRow:(NSInteger)row {
338
+ return row == 0;
339
+ }
160
340
  - (void)playRow:(NSInteger)row throughFrame:(NSInteger)last oneShot:(BOOL)oneShot {
161
341
  if (!oneShot && !self.oneShot && self.rowIndex == row) return;
342
+ // 任何外部动作(悬停、拖动、agent 事件)都直接接管,微动无条件让位。
343
+ if (self.microActive) {
344
+ self.microActive = NO;
345
+ [self scheduleNextMicroBehavior];
346
+ }
162
347
  self.lookDirection = -1;
348
+ self.frameRows = nil;
163
349
  self.rowIndex = row;
164
350
  self.frames = [self framesFromZeroThrough:last];
351
+ self.frameHolds = [self isIdleRow:row] && !oneShot
352
+ ? [self idleHoldsForCount:self.frames.count]
353
+ : [self uniformHoldsForCount:self.frames.count];
354
+ self.holdTicks = 0;
165
355
  self.sequenceIndex = 0;
166
356
  self.frameIndex = 0;
167
357
  self.oneShot = oneShot;
@@ -175,6 +365,7 @@ static const NSInteger PetMenuDeleteButtonTag = 1002;
175
365
  return dx * dx + dy * dy <= 1.0;
176
366
  }
177
367
  - (void)updateHoverForPoint:(NSPoint)point {
368
+ [self noteActivity];
178
369
  BOOL overPocket = [self isPocketPoint:point];
179
370
  if (self.pocketHoverChanged) self.pocketHoverChanged(overPocket);
180
371
  if (overPocket) {
@@ -217,7 +408,10 @@ static const NSInteger PetMenuDeleteButtonTag = 1002;
217
408
  [self playRow:0 throughFrame:5 oneShot:NO];
218
409
  }
219
410
  - (void)nextFrame:(NSTimer *)timer {
220
- if (self.lookDirection >= 0) return;
411
+ if (self.lookDirection >= 0) {
412
+ if (CFAbsoluteTimeGetCurrent() >= self.attentionUntil) [self releaseAttention];
413
+ return;
414
+ }
221
415
  // performWindowDragWithEvent: 会立即返回,且窗口服务器可能吞掉 mouseUp。
222
416
  // 动画时钟同时作为释放兜底,避免拖动状态永久停留在 running 行。
223
417
  if (self.draggingPet &&
@@ -225,20 +419,257 @@ static const NSInteger PetMenuDeleteButtonTag = 1002;
225
419
  [self endPetDrag];
226
420
  return;
227
421
  }
422
+ // 用力程度随时间衰减,掉档时把呼吸调回慢档。
423
+ if (self.breathLevel != 0) [self updateBreathingIfExertionChanged];
424
+
425
+ // 微动调度:只在待机且无人打扰时倒数,到点起一个小动作。
426
+ if ([self canStartMicroBehavior]) {
427
+ self.microCountdown -= 1;
428
+ if (self.microCountdown <= 0) {
429
+ [self startMicroBehavior];
430
+ return;
431
+ }
432
+ }
433
+
434
+ // 当前帧还没停够拍数就原地不动。停留期间连 needsDisplay 都不置,这一拍是纯空转。
435
+ self.holdTicks += 1;
436
+ if (self.holdTicks < [self holdForSequenceIndex:self.sequenceIndex]) return;
437
+ self.holdTicks = 0;
438
+
228
439
  self.sequenceIndex += 1;
229
440
  if (self.sequenceIndex >= self.frames.count) {
230
441
  if (self.oneShot) {
231
442
  self.rowIndex = 0;
232
443
  self.frames = [self framesFromZeroThrough:5];
444
+ self.frameHolds = [self idleHoldsForCount:self.frames.count];
233
445
  self.oneShot = NO;
234
446
  self.agentActive = NO;
447
+ self.microActive = NO;
448
+ [self scheduleNextMicroBehavior];
449
+ } else if (self.microActive) {
450
+ // 微动播完就回待机。这条分支独立于 oneShot,所以不会清 agentActive。
451
+ [self endMicroBehavior];
452
+ self.needsDisplay = YES;
453
+ return;
235
454
  }
236
455
  self.sequenceIndex = 0;
237
456
  }
238
457
  self.frameIndex = self.frames[self.sequenceIndex].integerValue;
239
458
  self.needsDisplay = YES;
240
459
  }
460
+ #pragma mark - 微动层
461
+
462
+ - (void)noteActivity {
463
+ self.lastActivityTime = CFAbsoluteTimeGetCurrent();
464
+ [self scheduleNextMicroBehavior];
465
+ [self persistLastActivityThrottled];
466
+ }
467
+ // 落盘限流:noteActivity 在鼠标划过宠物时会被高频调用,每次都写 defaults 没必要。
468
+ - (void)persistLastActivityThrottled {
469
+ if (self.lastActivityTime - self.lastActivitySavedAt < PetActivitySaveInterval) return;
470
+ self.lastActivitySavedAt = self.lastActivityTime;
471
+ [NSUserDefaults.standardUserDefaults setDouble:self.lastActivityTime
472
+ forKey:PetLastActivityKey];
473
+ }
474
+ - (void)restoreLastActivity {
475
+ double saved = [NSUserDefaults.standardUserDefaults doubleForKey:PetLastActivityKey];
476
+ NSTimeInterval now = CFAbsoluteTimeGetCurrent();
477
+ // 只认过去的时间戳:系统时钟被调过或 defaults 被写坏时,宁可当成"刚刚活动过",
478
+ // 也不能让宠物一启动就以为闲置了几十年直接进打盹。
479
+ if (saved > 0 && saved <= now) self.lastActivityTime = saved;
480
+ else self.lastActivityTime = now;
481
+ self.lastActivitySavedAt = self.lastActivityTime;
482
+ [self scheduleNextMicroBehavior];
483
+ }
484
+ // 当前用力程度,按半衰期衰减。
485
+ - (double)currentExertion {
486
+ NSTimeInterval elapsed = CFAbsoluteTimeGetCurrent() - self.exertionUpdatedAt;
487
+ if (elapsed <= 0) return self.exertion;
488
+ return self.exertion * pow(0.5, elapsed / PetExertionHalfLife);
489
+ }
490
+ - (void)bumpExertion {
491
+ self.exertion = MIN(1.0, [self currentExertion] + PetExertionPerEvent);
492
+ self.exertionUpdatedAt = CFAbsoluteTimeGetCurrent();
493
+ [self updateBreathingIfExertionChanged];
494
+ }
495
+ // 分档而不是连续调:改呼吸快慢要重加 CA 动画,相位会跳一下(最多 1.5px)。
496
+ // 分成三档之后一次任务里只会重加两三次,跳动察觉不到;连续调就是每拍都跳。
497
+ - (NSInteger)exertionLevel {
498
+ double exertion = [self currentExertion];
499
+ if (exertion < 0.2) return 0;
500
+ if (exertion < 0.6) return 1;
501
+ return 2;
502
+ }
503
+ - (void)updateBreathingIfExertionChanged {
504
+ NSInteger level = [self exertionLevel];
505
+ if (level == self.breathLevel) return;
506
+ self.breathLevel = level;
507
+ [self.spriteLayer removeAnimationForKey:@"breath"];
508
+ [self updateBreathingAnimation];
509
+ }
510
+ // 无聊曲线:闲久了先躁动(微动变频繁)、再倦、最后几乎不动。
511
+ // 这条曲线是非单调的,本身就是叙事——"闲得发慌"和"待久了发蔫"是两种不同的状态。
512
+ // 调试用:把无聊曲线的三个拐点整体缩放,好在几十秒内走完本来要半小时的过程。
513
+ // defaults write com.universewang.cc-pets CCPetsBoredomScale -float 0.25
514
+ // defaults delete com.universewang.cc-pets CCPetsBoredomScale # 恢复正常
515
+ // 域名必须是 bundle identifier,写成 "cc-pets" 会落到另一个 plist,桌宠读不到。
516
+ // 每次排期都现读,改完立刻生效,不用重启桌宠。缺省 1.0,也就是不缩放。
517
+ - (double)boredomScale {
518
+ id value = [NSUserDefaults.standardUserDefaults objectForKey:@"CCPetsBoredomScale"];
519
+ if (![value isKindOfClass:NSNumber.class]) return 1.0;
520
+ double scale = [value doubleValue];
521
+ if (!(scale > 0)) return 1.0;
522
+ return MIN(scale, 10.0);
523
+ }
524
+ - (double)microIntervalScale {
525
+ NSTimeInterval idle = (CFAbsoluteTimeGetCurrent() - self.lastActivityTime) / [self boredomScale];
526
+ if (idle < PetBoredomRestless) return 1.0;
527
+ if (idle < PetBoredomTired) return 0.5; // 躁动:间隔减半
528
+ if (idle < PetBoredomDrowsy) return 2.0; // 倦
529
+ return 6.0; // 打盹
530
+ }
531
+ - (void)scheduleNextMicroBehavior {
532
+ double scale = [self microIntervalScale];
533
+ double span = PetMicroIntervalMax - PetMicroIntervalMin;
534
+ double seconds = (PetMicroIntervalMin + span * (arc4random_uniform(1000) / 1000.0)) * scale;
535
+ self.microCountdown = (NSInteger)llround(seconds / PetFrameInterval);
536
+ }
537
+ // 待机之外一律不做:agent 在干活、正在拖、正在播一次性动作、十六向跟随中都不打断。
538
+ - (BOOL)canStartMicroBehavior {
539
+ return !self.microActive && !self.agentActive && !self.oneShot && !self.draggingPet &&
540
+ !self.animationSuspended && self.lookDirection < 0 && self.window != nil &&
541
+ [self isIdleRow:self.rowIndex];
542
+ }
543
+ // 微动只用"有始有终的动作",不改待机流本身的节奏。
544
+ //
545
+ // 9 行素材只有 row 3(观察)语义足够中性——它是一个独立动作,读起来是"它张望了一下"。
546
+ // 强语义行(row 1 跑/bash、row 7 工作/edit)绝不能用:待机时冒出来,用户会以为
547
+ // agent 在干活。
548
+ // 11 行素材额外可以用 row 9/10 的十六向定格:那是素材本来就设计成静止的格子,
549
+ // 定格不违和,且语义纯粹是"朝某个方向看"。
550
+ // 鼠标当前在哪个方向。算法和 updateLookForScreenPoint: 同源,-1 表示算不出来。
551
+ - (NSInteger)directionTowardScreenPoint:(NSPoint)screenPoint {
552
+ if (!self.window) return -1;
553
+ NSPoint center = [self convertPoint:NSMakePoint(NSMidX(self.bounds), NSMidY(self.bounds)) toView:nil];
554
+ center = [self.window convertPointToScreen:center];
555
+ CGFloat dx = screenPoint.x - center.x;
556
+ CGFloat dy = screenPoint.y - center.y;
557
+ if (hypot(dx, dy) <= 1.0) return -1;
558
+ CGFloat degrees = fmod(atan2(dx, dy) * 180.0 / M_PI + 360.0, 360.0);
559
+ return ((NSInteger)llround(degrees / 22.5)) % 16;
560
+ }
561
+ // 十六向是绕一圈排的,两个方向之间要走近的那一侧,否则会绕远大半圈。
562
+ - (NSInteger)directionStepFrom:(NSInteger)from to:(NSInteger)to {
563
+ NSInteger forward = ((to - from) + 16) % 16;
564
+ return forward <= 8 ? 1 : -1;
565
+ }
566
+ // 转头:从目标方向的前几格逐格扫过去 → 停一下 → 再逐格扫回来。
567
+ //
568
+ // 素材里 row 9/10 那 16 格本来只是"朝某个方向的静止姿势",但按角度顺序连着播,
569
+ // 白捡一个转头动画——不需要任何新素材。这是十六向素材最值钱的用法。
570
+ - (BOOL)startGlanceMicroBehavior {
571
+ NSInteger target = [self directionTowardScreenPoint:NSEvent.mouseLocation];
572
+ if (target < 0) return NO;
573
+
574
+ const NSInteger sweep = 3;
575
+ NSInteger step = [self directionStepFrom:(target - sweep + 16) % 16 to:target];
576
+ NSTimeInterval hold = PetGlanceHoldMin +
577
+ (PetGlanceHoldMax - PetGlanceHoldMin) * (arc4random_uniform(1000) / 1000.0);
578
+ NSUInteger holdTicks = MAX((NSUInteger)1, (NSUInteger)llround(hold / PetFrameInterval));
579
+
580
+ NSMutableArray<NSNumber *> *rows = [NSMutableArray array];
581
+ NSMutableArray<NSNumber *> *cols = [NSMutableArray array];
582
+ NSMutableArray<NSNumber *> *holds = [NSMutableArray array];
583
+ // 转过去
584
+ for (NSInteger index = sweep; index >= 0; index--) {
585
+ NSInteger direction = ((target - index * step) % 16 + 16) % 16;
586
+ [rows addObject:@(9 + direction / 8)];
587
+ [cols addObject:@(direction % 8)];
588
+ [holds addObject:index == 0 ? @(holdTicks) : @1];
589
+ }
590
+ // 转回来。最后一格不重复停在目标上,直接从倒数第二格开始退。
591
+ for (NSInteger index = 1; index <= sweep; index++) {
592
+ NSInteger direction = ((target - index * step) % 16 + 16) % 16;
593
+ [rows addObject:@(9 + direction / 8)];
594
+ [cols addObject:@(direction % 8)];
595
+ [holds addObject:@1];
596
+ }
597
+
598
+ // 不动 lookDirection:那个字段一旦 >=0 就进注意力模式,nextFrame: 只做到期检查,
599
+ // 这段序列就没人推进了。
600
+ self.frameRows = rows;
601
+ self.frames = cols;
602
+ self.frameHolds = holds;
603
+ self.holdTicks = 0;
604
+ self.sequenceIndex = 0;
605
+ self.rowIndex = rows.firstObject.integerValue;
606
+ self.frameIndex = cols.firstObject.integerValue;
607
+ self.fadeNextContents = YES;
608
+ self.needsDisplay = YES;
609
+ return YES;
610
+ }
611
+ // 能力集在换素材时算一次。未知行数(比如第三方给了 10 行)自动落到无朝向档,
612
+ // 是安全的降级方向。
613
+ - (void)rebuildCapabilities {
614
+ self.hasLookRows = self.spriteRowCount >= 11;
615
+ NSMutableArray<NSDictionary *> *table = [NSMutableArray array];
616
+ // 两档的行为密度要接近,只让表现形式不同。11 行档不该因为花样多就动得更频繁——
617
+ // 用户切素材时该读作"这只性格不一样",而不是"这只功能残缺"。
618
+ if (self.hasLookRows) {
619
+ [table addObject:@{@"kind": @(PetMicroBehaviorGlance), @"weight": @6}];
620
+ }
621
+ [table addObject:@{@"kind": @(PetMicroBehaviorScan), @"weight": @4}];
622
+ self.microBehaviorTable = table;
623
+ }
624
+ - (void)startScanMicroBehavior {
625
+ self.frameRows = nil;
626
+ self.rowIndex = 3;
627
+ self.frames = [self framesFromZeroThrough:3];
628
+ self.frameHolds = [self uniformHoldsForCount:self.frames.count];
629
+ self.holdTicks = 0;
630
+ self.sequenceIndex = 0;
631
+ self.frameIndex = 0;
632
+ self.fadeNextContents = YES;
633
+ self.needsDisplay = YES;
634
+ }
635
+ - (void)startMicroBehavior {
636
+ self.microActive = YES;
637
+ NSInteger total = 0;
638
+ for (NSDictionary *entry in self.microBehaviorTable) total += [entry[@"weight"] integerValue];
639
+ NSInteger roll = total > 0 ? (NSInteger)arc4random_uniform((uint32_t)total) : 0;
640
+ for (NSDictionary *entry in self.microBehaviorTable) {
641
+ roll -= [entry[@"weight"] integerValue];
642
+ if (roll >= 0) continue;
643
+ // 转头要拿得到鼠标方向,拿不到就顺势退到张望,不算失败。
644
+ if ([entry[@"kind"] integerValue] == PetMicroBehaviorGlance &&
645
+ [self startGlanceMicroBehavior]) {
646
+ return;
647
+ }
648
+ break;
649
+ }
650
+ [self startScanMicroBehavior];
651
+ }
652
+ // 收尾只回待机,绝不碰 agentActive。
653
+ - (void)endMicroBehavior {
654
+ self.microActive = NO;
655
+ self.frameRows = nil;
656
+ self.fadeNextContents = YES;
657
+ self.rowIndex = 0;
658
+ self.frames = [self framesFromZeroThrough:5];
659
+ self.frameHolds = [self uniformHoldsForCount:self.frames.count];
660
+ self.holdTicks = 0;
661
+ self.sequenceIndex = 0;
662
+ self.frameIndex = 0;
663
+ [self scheduleNextMicroBehavior];
664
+ }
665
+ - (NSUInteger)holdForSequenceIndex:(NSUInteger)index {
666
+ if (index >= self.frameHolds.count) return 1;
667
+ NSUInteger hold = self.frameHolds[index].unsignedIntegerValue;
668
+ return hold > 0 ? hold : 1;
669
+ }
241
670
  - (void)handleAgentEvent:(NSString *)event tool:(NSString *)tool failed:(BOOL)failed {
671
+ [self noteActivity];
672
+ [self bumpExertion];
242
673
  if ([event isEqualToString:@"SessionStart"]) {
243
674
  self.agentActive = YES;
244
675
  [self playRow:4 throughFrame:4 oneShot:YES];
@@ -300,6 +731,7 @@ static const NSInteger PetMenuDeleteButtonTag = 1002;
300
731
  // 起点于是落在远处,后面要多走同样的距离才够过阈值——表现为按住之后宠物迟迟不动。
301
732
  // 阈值判定发生在窗口服务器接手拖动之前,窗口此刻还没动,所以窗口坐标是稳定的参照系。
302
733
  - (void)mouseDown:(NSEvent *)event {
734
+ [self noteActivity];
303
735
  self.agentActive = NO;
304
736
  self.dragStartMouse = event.locationInWindow;
305
737
  }
@@ -319,14 +751,77 @@ static const NSInteger PetMenuDeleteButtonTag = 1002;
319
751
  if (self.pocketHoverChanged) self.pocketHoverChanged(NO);
320
752
  if (self.dragStateChanged) self.dragStateChanged(YES);
321
753
  [self playRow:movingRight ? 1 : 2 throughFrame:7 oneShot:NO];
754
+ [self startObservingWindowMove];
322
755
 
323
756
  [self.window performWindowDragWithEvent:event];
324
757
  }
758
+ - (void)startObservingWindowMove {
759
+ if (self.observingWindowMove || !self.window) return;
760
+ self.lastDragWindowOrigin = self.window.frame.origin;
761
+ self.observingWindowMove = YES;
762
+ [NSNotificationCenter.defaultCenter addObserver:self
763
+ selector:@selector(petWindowMovedWhileDragging:)
764
+ name:NSWindowDidMoveNotification object:self.window];
765
+ }
766
+ - (void)stopObservingWindowMove {
767
+ if (!self.observingWindowMove) return;
768
+ self.observingWindowMove = NO;
769
+ [NSNotificationCenter.defaultCenter removeObserver:self
770
+ name:NSWindowDidMoveNotification object:self.window];
771
+ }
772
+ // 精灵在窗口内往反方向落后一点,看着就有了重量。滞后量跟这一帧的位移走,
773
+ // 停手不动时位移为 0,会自然归位。
774
+ - (void)petWindowMovedWhileDragging:(NSNotification *)notification {
775
+ if (!self.draggingPet || self.reduceMotion) return;
776
+ NSPoint origin = self.window.frame.origin;
777
+ CGFloat dx = origin.x - self.lastDragWindowOrigin.x;
778
+ self.lastDragWindowOrigin = origin;
779
+
780
+ CGFloat lag = -dx * PetDragLagFactor;
781
+ lag = MAX(-PetDragLagMax, MIN(PetDragLagMax, lag));
782
+ // 缩短隐式动画时长:默认 0.25s 追不上手,看着是糊而不是滞后。0.12s 既平滑又跟手。
783
+ [CATransaction begin];
784
+ [CATransaction setAnimationDuration:0.12];
785
+ [CATransaction setAnimationTimingFunction:
786
+ [CAMediaTimingFunction functionWithName:kCAMediaTimingFunctionEaseOut]];
787
+ self.spriteLayer.transform = CATransform3DMakeTranslation(lag, 0, 0);
788
+ [CATransaction commit];
789
+ }
325
790
  - (void)endPetDrag {
326
791
  if (!self.draggingPet) return;
327
792
  self.draggingPet = NO;
793
+ [self stopObservingWindowMove];
328
794
  if (self.dragStateChanged) self.dragStateChanged(NO);
329
795
  [self playRow:0 throughFrame:5 oneShot:NO];
796
+ [self playSettleAnimation];
797
+ }
798
+ // 落脚:从当前滞后位置 → 压扁 → 轻微回弹过冲 → 静止。
799
+ // 整段只动 transform 一个属性,和挂在 position.y 上的呼吸互不干扰。
800
+ - (void)playSettleAnimation {
801
+ CALayer *layer = self.spriteLayer;
802
+ if (!layer) return;
803
+ if (self.reduceMotion) {
804
+ layer.transform = CATransform3DIdentity;
805
+ return;
806
+ }
807
+ CATransform3D current = ((CALayer *)layer.presentationLayer ?: layer).transform;
808
+ CAKeyframeAnimation *settle = [CAKeyframeAnimation animationWithKeyPath:@"transform"];
809
+ settle.values = @[
810
+ [NSValue valueWithCATransform3D:current],
811
+ [NSValue valueWithCATransform3D:CATransform3DMakeScale(1.07, 0.92, 1.0)],
812
+ [NSValue valueWithCATransform3D:CATransform3DMakeScale(0.97, 1.04, 1.0)],
813
+ [NSValue valueWithCATransform3D:CATransform3DIdentity]
814
+ ];
815
+ settle.keyTimes = @[@0.0, @0.34, @0.68, @1.0];
816
+ settle.duration = PetSettleDuration;
817
+ settle.timingFunction = [CAMediaTimingFunction
818
+ functionWithName:kCAMediaTimingFunctionEaseOut];
819
+ // 先把 model 值落到静止态且不触发隐式动画,否则它会和下面的关键帧同时跑。
820
+ [CATransaction begin];
821
+ [CATransaction setDisableActions:YES];
822
+ layer.transform = CATransform3DIdentity;
823
+ [CATransaction commit];
824
+ [layer addAnimation:settle forKey:@"settle"];
330
825
  }
331
826
  - (void)mouseUp:(NSEvent *)event {
332
827
  if (self.draggingPet) {
@@ -335,27 +830,196 @@ static const NSInteger PetMenuDeleteButtonTag = 1002;
335
830
  }
336
831
  [self playRow:7 throughFrame:5 oneShot:YES];
337
832
  }
338
- - (void)drawRect:(NSRect)dirtyRect {
833
+ // 每一格都用**原来 drawRect: 那一次绘制**预先栅格化成位图,再交给 layer。
834
+ //
835
+ // 试过两条更"聪明"的路,都不行,别改回去:
836
+ // 1. CGImageCreateWithImageInRect 预裁——素材经 LoadPetSpriteImage 缩略后不保证能被
837
+ // 8 列 rowCount 行整除(默认素材 1536×1872 会装成 1120×1365,cellHeight=151.67),
838
+ // 小数矩形会被取整,采样相位偏掉,边缘整行错位。
839
+ // 2. 整表交给 layer + contentsRect 选帧——CA 自己的最近邻缩放相位同样和 NSImage 对不上,
840
+ // 实测形状吻合度反而从 99.4% 掉到 93.5%。
841
+ // 照搬原来的 drawInRect:fromRect: 才能保证逐像素等价:栅格化的是同一段代码,只是从
842
+ // 每帧执行挪到了每格一次。
843
+ - (void)rebuildSpriteCache {
844
+ [self.cellCache removeAllObjects];
845
+ CGFloat scale = self.spriteScale;
846
+ self.spriteLayer.contentsScale = scale;
847
+ // 上限按倍率和行数定,不能写死:11 行素材光十六向朝向就占 16 格,加上待机和动作帧,
848
+ // 固定 6MB(视网膜下约 18 格)会卡在淘汰边缘,鼠标绕着宠物转就不停重栅格化。
849
+ //
850
+ // 但也不能给太多。实测这一块是常驻内存最大的单一新增项:视网膜下每格 328KB,
851
+ // 原来给 48 格 = 15.4MB,而真实活跃工作集只有待机 6 帧 + 当前动作 ≤8 帧 +
852
+ // 偶尔几个朝向格,20 格足够,超出的部分纯粹是白占着。
853
+ NSSize pointSize = NSInsetRect(self.bounds, 2, 0).size;
854
+ NSUInteger cellCost = (NSUInteger)(ceil(pointSize.width * scale) *
855
+ ceil(pointSize.height * scale) * 4);
856
+ NSUInteger affordable = MIN((NSUInteger)(self.spriteRowCount * 8), (NSUInteger)20);
857
+ self.cellCache.totalCostLimit = MAX(cellCost * affordable, (NSUInteger)(2 * 1024 * 1024));
858
+ [self updateSpriteContents];
859
+ }
860
+ // 视网膜屏上必须按 backingScaleFactor 栅格化。原来 drawRect: 是直接画进 2x 的后备存储,
861
+ // 等于用更高分辨率去采样那个 151.67 高的源格;预栅格化成 1x 位图再让 layer 放大,
862
+ // 会比改造前糊一档。
863
+ - (CGFloat)spriteScale {
864
+ CGFloat scale = self.window.backingScaleFactor;
865
+ return scale > 0 ? scale : 1.0;
866
+ }
867
+ - (void)viewDidChangeBackingProperties {
868
+ [super viewDidChangeBackingProperties];
869
+ // 换显示器会改 backingScaleFactor,缓存里全是按旧倍率栅格化的位图,必须整体作废。
870
+ [self rebuildSpriteCache];
871
+ }
872
+ - (CGImageRef)cellImageForRow:(NSInteger)row frame:(NSInteger)frame {
873
+ if (!self.sheet || self.spriteRowCount <= 0) return NULL;
874
+ NSNumber *key = @(row * 8 + frame);
875
+ id cached = [self.cellCache objectForKey:key];
876
+ if (cached) return (__bridge CGImageRef)cached;
877
+
878
+ NSRect target = NSInsetRect(self.bounds, 2, 0);
879
+ NSSize pointSize = target.size;
880
+ if (pointSize.width <= 0 || pointSize.height <= 0) return NULL;
881
+ CGFloat scale = self.spriteScale;
882
+ NSInteger pixelWidth = (NSInteger)ceil(pointSize.width * scale);
883
+ NSInteger pixelHeight = (NSInteger)ceil(pointSize.height * scale);
884
+
885
+ NSBitmapImageRep *rep = [[NSBitmapImageRep alloc]
886
+ initWithBitmapDataPlanes:NULL pixelsWide:pixelWidth pixelsHigh:pixelHeight
887
+ bitsPerSample:8 samplesPerPixel:4 hasAlpha:YES isPlanar:NO
888
+ colorSpaceName:NSDeviceRGBColorSpace bytesPerRow:0 bitsPerPixel:0];
889
+ rep.size = pointSize;
890
+
339
891
  CGFloat cellWidth = self.sheet.size.width / 8.0;
340
892
  CGFloat cellHeight = self.sheet.size.height / self.spriteRowCount;
341
- NSRect source = NSMakeRect(self.frameIndex * cellWidth,
342
- self.sheet.size.height - (self.rowIndex + 1) * cellHeight, cellWidth, cellHeight);
343
- [self.sheet drawInRect:NSInsetRect(self.bounds, 2, 0) fromRect:source
893
+ NSRect source = NSMakeRect(frame * cellWidth,
894
+ self.sheet.size.height - (row + 1) * cellHeight, cellWidth, cellHeight);
895
+
896
+ NSGraphicsContext *context = [NSGraphicsContext graphicsContextWithBitmapImageRep:rep];
897
+ [NSGraphicsContext saveGraphicsState];
898
+ NSGraphicsContext.currentContext = context;
899
+ [self.sheet drawInRect:NSMakeRect(0, 0, pointSize.width, pointSize.height) fromRect:source
344
900
  operation:NSCompositingOperationSourceOver fraction:1.0
345
901
  respectFlipped:NO hints:@{NSImageHintInterpolation: @(NSImageInterpolationNone)}];
902
+ [NSGraphicsContext restoreGraphicsState];
903
+
904
+ CGImageRef cell = rep.CGImage;
905
+ if (!cell) return NULL;
906
+ [self.cellCache setObject:(__bridge id)cell forKey:key
907
+ cost:(NSUInteger)(pixelWidth * pixelHeight * 4)];
908
+ return cell;
909
+ }
910
+ // 只打标记,真正换图交给 AppKit 的显示周期。
911
+ //
912
+ // 不要改回"在 setter 里同步换 contents":十六向跟随装的是全局鼠标监听,屏幕上每个
913
+ // 鼠标移动事件都会写 rowIndex/frameIndex(一次方向变化还是连写两个)。同步更新等于
914
+ // 几百次/秒一次不落,实测疯狂动鼠标时 CPU 6~8%,冷缓存期峰值 12.5%。改造前那两个是
915
+ // 无副作用的纯属性 + needsDisplay,由 AppKit 合并成每刷新周期最多一次——这里要还原的
916
+ // 就是那个语义。
917
+ - (void)updateSpriteContents {
918
+ self.needsDisplay = YES;
919
+ }
920
+ // layer-backed 视图走 updateLayer 而不是 drawRect:,AppKit 每个显示周期最多调一次。
921
+ - (BOOL)wantsUpdateLayer {
922
+ return YES;
923
+ }
924
+ // 换 contents 会触发 CA 默认的 0.25s 淡入。逐帧动画上那就是一层永久的拖影,必须关掉。
925
+ - (void)updateLayer {
926
+ CGImageRef cell = [self cellImageForRow:self.rowIndex frame:self.frameIndex];
927
+ if (!cell) return;
928
+ // 逐帧动画默认必须关掉隐式动画,否则每一帧都带 0.25s 淡入,等于一层永久拖影。
929
+ // 只有进出微动那一下例外:那是两个不相干姿势之间的硬切,给一次短淡化才不突兀。
930
+ if (self.fadeNextContents) {
931
+ self.fadeNextContents = NO;
932
+ CATransition *fade = [CATransition animation];
933
+ fade.type = kCATransitionFade;
934
+ fade.duration = 0.13;
935
+ [self.spriteLayer addAnimation:fade forKey:@"contentsFade"];
936
+ }
937
+ [CATransaction begin];
938
+ [CATransaction setDisableActions:YES];
939
+ self.spriteLayer.contents = (__bridge id)cell;
940
+ [CATransaction commit];
941
+ }
942
+ - (void)layout {
943
+ [super layout];
944
+ [self layoutSpriteLayer];
945
+ }
946
+ // 锚点是脚底 (0.5, 0),所以不能直接设 frame——那会把锚点当左下角算。改用 bounds + position。
947
+ - (void)layoutSpriteLayer {
948
+ NSRect target = NSInsetRect(self.bounds, 2, 0);
949
+ [CATransaction begin];
950
+ [CATransaction setDisableActions:YES];
951
+ self.spriteLayer.bounds = CGRectMake(0, 0, NSWidth(target), NSHeight(target));
952
+ self.spriteLayer.position = CGPointMake(NSMidX(target), NSMinY(target));
953
+ [CATransaction commit];
954
+ }
955
+ // 呼吸是常驻 CA 动画:插值和合成都在 render server 侧,主进程零唤醒。
956
+ // 用 byValue 而不是 toValue,动画相对当前 model 值走,换素材或重新布局都不用重设。
957
+ - (void)updateBreathingAnimation {
958
+ // reduceMotion 下彻底不做。这不是省电问题——系统开了减弱动效,持续浮动本身就是
959
+ // 用户明确不想要的东西。
960
+ BOOL shouldBreathe = self.window != nil && !self.reduceMotion;
961
+ if (!shouldBreathe) {
962
+ [self.spriteLayer removeAnimationForKey:@"breath"];
963
+ return;
964
+ }
965
+ if ([self.spriteLayer animationForKey:@"breath"]) return;
966
+ // 越用力呼吸越快、起伏越大。平复回基线是自然衰减出来的,不用单独写过渡。
967
+ NSInteger level = [self exertionLevel];
968
+ double tempo = level == 0 ? 1.0 : (level == 1 ? 0.72 : 0.52);
969
+ double rise = level == 0 ? PetBreathRise : PetBreathRise * (level == 1 ? 1.3 : 1.7);
970
+ CABasicAnimation *breath = [CABasicAnimation animationWithKeyPath:@"position.y"];
971
+ breath.byValue = @(rise);
972
+ breath.duration = PetBreathPeriod * tempo / 2.0;
973
+ breath.autoreverses = YES;
974
+ breath.repeatCount = HUGE_VALF;
975
+ breath.timingFunction = [CAMediaTimingFunction
976
+ functionWithName:kCAMediaTimingFunctionEaseInEaseOut];
977
+ [self.spriteLayer addAnimation:breath forKey:@"breath"];
978
+ }
979
+ - (void)viewDidMoveToWindow {
980
+ [super viewDidMoveToWindow];
981
+ // 进窗口才知道 backingScaleFactor,缓存要按真实倍率重建;呼吸也从这里起步。
982
+ [self rebuildSpriteCache];
983
+ [self updateBreathingAnimation];
984
+ [self restoreLastActivity];
985
+ }
986
+ - (void)setRowIndex:(NSInteger)value {
987
+ if (_rowIndex == value) return;
988
+ _rowIndex = value;
989
+ [self updateSpriteContents];
990
+ }
991
+ - (void)setFrameIndex:(NSInteger)value {
992
+ if (_frameIndex == value) return;
993
+ _frameIndex = value;
994
+ [self updateSpriteContents];
995
+ }
996
+ - (void)setSheet:(NSImage *)sheet {
997
+ if (_sheet == sheet) return;
998
+ _sheet = sheet;
999
+ [self rebuildSpriteCache];
1000
+ }
1001
+ - (void)setSpriteRowCount:(NSInteger)count {
1002
+ if (_spriteRowCount == count) return;
1003
+ _spriteRowCount = count;
1004
+ [self rebuildSpriteCache];
346
1005
  }
347
1006
  - (void)applySheet:(NSImage *)sheet petID:(NSString *)petID rowCount:(NSInteger)rowCount {
348
- self.sheet = sheet;
349
- self.spriteRowCount = rowCount;
1007
+ // 直接写 ivar 再统一重建:走 setter 会因为 sheet 和 rowCount 分两次设置而拿旧行数
1008
+ // 白裁一遍缓存。
1009
+ _sheet = sheet;
1010
+ _spriteRowCount = rowCount;
1011
+ _rowIndex = 0;
1012
+ _frameIndex = 0;
350
1013
  self.lookDirection = -1;
351
1014
  self.currentPetID = petID;
352
- self.rowIndex = 0;
353
- self.frameIndex = 0;
354
1015
  self.sequenceIndex = 0;
355
1016
  self.frames = [self framesFromZeroThrough:5];
1017
+ self.frameHolds = [self idleHoldsForCount:self.frames.count];
1018
+ self.holdTicks = 0;
356
1019
  self.oneShot = NO;
1020
+ [self rebuildSpriteCache];
1021
+ [self rebuildCapabilities];
357
1022
  [self updateLookTracking];
358
- self.needsDisplay = YES;
359
1023
  }
360
1024
  - (void)selectPetFromButton:(NSButton *)sender {
361
1025
  NSString *petID = sender.identifier;
@@ -768,6 +1432,20 @@ static const NSInteger PetMenuDeleteButtonTag = 1002;
768
1432
  tag:[option[@"tag"] integerValue]];
769
1433
  }
770
1434
  systemStatusItem.submenu = systemStatusMenu;
1435
+ NSMenuItem *speechItem = [menu addItemWithTitle:@"碎碎念" action:nil keyEquivalent:@""];
1436
+ NSMenu *speechMenu = [NSMenu new];
1437
+ id speechValue = [NSUserDefaults.standardUserDefaults objectForKey:@"CCPetsSpeechEnabled"];
1438
+ [self addPersistentSwitchToMenu:speechMenu
1439
+ title:@"启用碎碎念"
1440
+ checked:speechValue == nil ? YES : [speechValue boolValue]
1441
+ action:@selector(toggleSpeech:)
1442
+ width:PetSubmenuRowWidth
1443
+ tag:1];
1444
+ // 没有这个入口,九成用户不会知道台词可以自己改。
1445
+ NSMenuItem *editPhrases = [speechMenu addItemWithTitle:@"自定义台词…"
1446
+ action:@selector(editPhrasesFile:) keyEquivalent:@""];
1447
+ editPhrases.target = NSApp.delegate;
1448
+ speechItem.submenu = speechMenu;
771
1449
  NSMenuItem *updateItem = [menu addItemWithTitle:@"检查更新…" action:@selector(checkForUpdates:) keyEquivalent:@""];
772
1450
  updateItem.target = NSApp.delegate;
773
1451
  [menu addItem:NSMenuItem.separatorItem];