cc-pets 2.2.1 → 2.3.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.
Files changed (171) hide show
  1. package/CC_BRIDGE.md +5 -2
  2. package/CC_BRIDGE.zh-CN.md +4 -2
  3. package/CHANGELOG.md +60 -0
  4. package/CHANGELOG.zh-CN.md +60 -0
  5. package/CONTRIBUTING.md +13 -10
  6. package/CONTRIBUTING.zh-CN.md +11 -10
  7. package/README.md +113 -24
  8. package/README.zh-CN.md +89 -28
  9. package/Resources/zh-Hans.lproj/Localizable.strings +568 -17
  10. package/Sources/CCPets/{CCPetsAppDelegate+AgentEvents.m → App/CCPetsAppDelegate+AgentEvents.m} +15 -5
  11. package/Sources/CCPets/{CCPetsAppDelegate+AgentStatus.m → App/CCPetsAppDelegate+AgentStatus.m} +82 -23
  12. package/Sources/CCPets/{CCPetsAppDelegate+Bridge.m → App/CCPetsAppDelegate+Bridge.m} +35 -24
  13. package/Sources/CCPets/{CCPetsAppDelegate+Pets.m → App/CCPetsAppDelegate+Pets.m} +17 -3
  14. package/Sources/CCPets/{CCPetsAppDelegate+Private.h → App/CCPetsAppDelegate+Private.h} +70 -22
  15. package/Sources/CCPets/App/CCPetsAppDelegate+Profiles.m +238 -0
  16. package/Sources/CCPets/{CCPetsAppDelegate+Quota.m → App/CCPetsAppDelegate+Quota.m} +47 -32
  17. package/Sources/CCPets/{CCPetsAppDelegate+Settings.m → App/CCPetsAppDelegate+Settings.m} +86 -98
  18. package/Sources/CCPets/{CCPetsAppDelegate+Speech.m → App/CCPetsAppDelegate+Speech.m} +8 -4
  19. package/Sources/CCPets/App/CCPetsAppDelegate+Workbench.m +139 -0
  20. package/Sources/CCPets/{CCPetsAppDelegate.h → App/CCPetsAppDelegate.h} +15 -0
  21. package/Sources/CCPets/{CCPetsAppDelegate.m → App/CCPetsAppDelegate.m} +107 -11
  22. package/Sources/CCPets/App/CCPetsOpenCommand.h +13 -0
  23. package/Sources/CCPets/App/CCPetsOpenCommand.m +99 -0
  24. package/Sources/CCPets/{main.m → App/main.m} +68 -1
  25. package/Sources/CCPets/{CCPetsBridge.h → Bridge/CCPetsBridge.h} +17 -4
  26. package/Sources/CCPets/{CCPetsBridge.m → Bridge/CCPetsBridge.m} +32 -17
  27. package/Sources/CCPets/Bridge/CCPetsBridgeCLI.h +10 -0
  28. package/Sources/CCPets/Bridge/CCPetsBridgeCLI.m +792 -0
  29. package/Sources/CCPets/Bridge/CCPetsBridgeCore.h +60 -0
  30. package/Sources/CCPets/Bridge/CCPetsBridgeCore.m +558 -0
  31. package/Sources/CCPets/Bridge/CCPetsBridgeSetup.h +24 -0
  32. package/Sources/CCPets/Bridge/CCPetsBridgeSetup.m +501 -0
  33. package/Sources/CCPets/Bridge/CCPetsBridgeStore.h +103 -0
  34. package/Sources/CCPets/Bridge/CCPetsBridgeStore.m +779 -0
  35. package/Sources/CCPets/Integrations/CCPetsCLISupport.h +75 -0
  36. package/Sources/CCPets/Integrations/CCPetsCLISupport.m +342 -0
  37. package/Sources/CCPets/Integrations/CCPetsEvents.h +15 -0
  38. package/Sources/CCPets/{CCPetsEvents.m → Integrations/CCPetsEvents.m} +23 -0
  39. package/Sources/CCPets/Integrations/CCPetsIntegrations.h +51 -0
  40. package/Sources/CCPets/Integrations/CCPetsIntegrations.m +662 -0
  41. package/Sources/CCPets/Integrations/CCPetsProfiles.h +38 -0
  42. package/Sources/CCPets/Integrations/CCPetsProfiles.m +516 -0
  43. package/Sources/CCPets/{CCPetsTerminalFocus.m → Integrations/CCPetsTerminalFocus.m} +42 -12
  44. package/Sources/CCPets/Pet/CCPetsPetStore.h +12 -0
  45. package/Sources/CCPets/Pet/CCPetsPetStore.m +476 -0
  46. package/Sources/CCPets/{CCPetsPhrases.h → Pet/CCPetsPhrases.h} +11 -2
  47. package/Sources/CCPets/{CCPetsPhrases.m → Pet/CCPetsPhrases.m} +19 -2
  48. package/Sources/CCPets/{CCPetsPhrasesEditor.m → Pet/CCPetsPhrasesEditor.m} +4 -1
  49. package/Sources/CCPets/Pet/PetView+Interaction.m +207 -0
  50. package/Sources/CCPets/Pet/PetView+Menu.m +598 -0
  51. package/Sources/CCPets/Pet/PetView+MicroBehavior.m +234 -0
  52. package/Sources/CCPets/Pet/PetView+Private.h +81 -0
  53. package/Sources/CCPets/{PetView.h → Pet/PetView.h} +3 -5
  54. package/Sources/CCPets/Pet/PetView.m +635 -0
  55. package/Sources/CCPets/Support/CCPetsDoctor.h +25 -0
  56. package/Sources/CCPets/Support/CCPetsDoctor.m +632 -0
  57. package/Sources/CCPets/Support/CCPetsJSON.h +27 -0
  58. package/Sources/CCPets/Support/CCPetsJSON.m +397 -0
  59. package/Sources/CCPets/{CCPetsL10n.h → Support/CCPetsL10n.h} +3 -1
  60. package/Sources/CCPets/{CCPetsL10n.m → Support/CCPetsL10n.m} +30 -1
  61. package/Sources/CCPets/Support/CCPetsPreferences.h +31 -0
  62. package/Sources/CCPets/Support/CCPetsPreferences.m +85 -0
  63. package/Sources/CCPets/UI/CCPetsDiagnosticsPage.h +25 -0
  64. package/Sources/CCPets/UI/CCPetsDiagnosticsPage.m +440 -0
  65. package/Sources/CCPets/UI/CCPetsFormBuilder.h +42 -0
  66. package/Sources/CCPets/UI/CCPetsFormBuilder.m +268 -0
  67. package/Sources/CCPets/{CCPetsGlassView.h → UI/CCPetsGlassView.h} +5 -1
  68. package/Sources/CCPets/{CCPetsGlassView.m → UI/CCPetsGlassView.m} +25 -7
  69. package/Sources/CCPets/UI/CCPetsMainWindow.h +55 -0
  70. package/Sources/CCPets/UI/CCPetsMainWindow.m +730 -0
  71. package/Sources/CCPets/UI/CCPetsSettingsPage.h +62 -0
  72. package/Sources/CCPets/UI/CCPetsSettingsPage.m +917 -0
  73. package/Sources/CCPets/UI/CCPetsUIStyle.h +132 -0
  74. package/Sources/CCPets/UI/CCPetsUIStyle.m +816 -0
  75. package/Sources/CCPets/UI/CCPetsUsageChartView.h +15 -0
  76. package/Sources/CCPets/UI/CCPetsUsageChartView.m +284 -0
  77. package/Sources/CCPets/UI/CCPetsUsagePage.h +32 -0
  78. package/Sources/CCPets/UI/CCPetsUsagePage.m +717 -0
  79. package/Sources/CCPets/UI/CCPetsUsageShared.h +53 -0
  80. package/Sources/CCPets/UI/CCPetsUsageStore.m +120 -0
  81. package/Sources/CCPets/UI/CCPetsUsageWidgets.h +30 -0
  82. package/Sources/CCPets/UI/CCPetsUsageWidgets.m +201 -0
  83. package/Sources/CCPets/UI/CCPetsWorkbench.h +40 -0
  84. package/Sources/CCPets/UI/CCPetsWorkbenchPages.h +13 -0
  85. package/Sources/CCPets/UI/CCPetsWorkbenchPages.m +783 -0
  86. package/Sources/CCPets/{MenuToggleSwitch.m → UI/MenuToggleSwitch.m} +1 -0
  87. package/Sources/CCPets/{CCPetsCodexRateLimits.h → Usage/CCPetsCodexRateLimits.h} +1 -0
  88. package/Sources/CCPets/{CCPetsCodexRateLimits.m → Usage/CCPetsCodexRateLimits.m} +10 -3
  89. package/Sources/CCPets/{CCPetsQuotaHistory.h → Usage/CCPetsQuotaHistory.h} +3 -0
  90. package/Sources/CCPets/{CCPetsQuotaHistory.m → Usage/CCPetsQuotaHistory.m} +58 -0
  91. package/Sources/CCPets/Usage/CCPetsUsage+ClaudeReader.m +436 -0
  92. package/Sources/CCPets/Usage/CCPetsUsage+CodexReader.m +392 -0
  93. package/Sources/CCPets/Usage/CCPetsUsage+CodexSessions.m +484 -0
  94. package/Sources/CCPets/Usage/CCPetsUsage+Internal.h +96 -0
  95. package/Sources/CCPets/Usage/CCPetsUsage+Models.m +285 -0
  96. package/Sources/CCPets/Usage/CCPetsUsage+TokenTotals.m +655 -0
  97. package/Sources/CCPets/Usage/CCPetsUsage.h +57 -0
  98. package/Sources/CCPets/Usage/CCPetsUsage.m +225 -0
  99. package/Sources/CCPets/Usage/CCPetsUsageMode.h +10 -0
  100. package/Sources/CCPets/Usage/CCPetsUsageMode.m +163 -0
  101. package/Sources/CCPets/{CCPetsUsageMonitor.h → Usage/CCPetsUsageMonitor.h} +3 -0
  102. package/Sources/CCPets/{CCPetsUsageMonitor.m → Usage/CCPetsUsageMonitor.m} +163 -6
  103. package/Sources/CCPets/Usage/QuotaDashboardView+Primitives.m +328 -0
  104. package/Sources/CCPets/Usage/QuotaDashboardView+Private.h +103 -0
  105. package/Sources/CCPets/Usage/QuotaDashboardView+Rendering.m +616 -0
  106. package/Sources/CCPets/{QuotaDashboardView.h → Usage/QuotaDashboardView.h} +17 -0
  107. package/Sources/CCPets/Usage/QuotaDashboardView.m +587 -0
  108. package/THIRD_PARTY_NOTICES.md +1 -1
  109. package/THIRD_PARTY_NOTICES.zh-CN.md +1 -1
  110. package/bin/cc-pets +8 -6
  111. package/bin/claude-with-pet +10 -2
  112. package/bin/codex-with-pet +13 -5
  113. package/package.json +1 -1
  114. package/scripts/build.sh +7 -3
  115. package/scripts/i18n.zsh +9 -52
  116. package/scripts/install-app.sh +4 -0
  117. package/scripts/install-shell-integration.sh +17 -10
  118. package/scripts/uninstall-shell-integration.sh +6 -1
  119. package/Sources/CCPets/CCPetsEvents.h +0 -10
  120. package/Sources/CCPets/CCPetsUsage.h +0 -36
  121. package/Sources/CCPets/CCPetsUsage.m +0 -2069
  122. package/Sources/CCPets/PetView.m +0 -1839
  123. package/Sources/CCPets/QuotaDashboardView.m +0 -1145
  124. package/scripts/bridge/cli.mjs +0 -237
  125. package/scripts/bridge/core.mjs +0 -228
  126. package/scripts/bridge/hook.mjs +0 -150
  127. package/scripts/bridge/install.mjs +0 -311
  128. package/scripts/bridge/mcp-server.mjs +0 -308
  129. package/scripts/bridge/options.mjs +0 -87
  130. package/scripts/bridge/process.mjs +0 -151
  131. package/scripts/bridge/reservations.mjs +0 -248
  132. package/scripts/bridge/store.mjs +0 -433
  133. package/scripts/bridge/watch.mjs +0 -69
  134. package/scripts/check-l10n.mjs +0 -168
  135. package/scripts/configure-updater.mjs +0 -43
  136. package/scripts/detect-cli.mjs +0 -68
  137. package/scripts/doctor.mjs +0 -470
  138. package/scripts/i18n.mjs +0 -122
  139. package/scripts/install-claude-hooks.mjs +0 -253
  140. package/scripts/install-codex-hooks.mjs +0 -78
  141. package/scripts/integration-markers.mjs +0 -51
  142. package/scripts/locales/zh-Hans.json +0 -366
  143. package/scripts/pet-store.mjs +0 -415
  144. package/scripts/uninstall-integrations.mjs +0 -205
  145. /package/Sources/CCPets/{CCPetsAppDelegate+Update.m → App/CCPetsAppDelegate+Update.m} +0 -0
  146. /package/Sources/CCPets/{CCPetsVersion.h → App/CCPetsVersion.h} +0 -0
  147. /package/Sources/CCPets/{CCPetsVersion.m → App/CCPetsVersion.m} +0 -0
  148. /package/Sources/CCPets/{CCPetsTerminalFocus.h → Integrations/CCPetsTerminalFocus.h} +0 -0
  149. /package/Sources/CCPets/{CCPetsImageLoader.h → Pet/CCPetsImageLoader.h} +0 -0
  150. /package/Sources/CCPets/{CCPetsImageLoader.m → Pet/CCPetsImageLoader.m} +0 -0
  151. /package/Sources/CCPets/{CCPetsPetSize.h → Pet/CCPetsPetSize.h} +0 -0
  152. /package/Sources/CCPets/{CCPetsPetSize.m → Pet/CCPetsPetSize.m} +0 -0
  153. /package/Sources/CCPets/{CCPetsPhrasesEditor.h → Pet/CCPetsPhrasesEditor.h} +0 -0
  154. /package/Sources/CCPets/{CCPetsPreviews.h → Pet/CCPetsPreviews.h} +0 -0
  155. /package/Sources/CCPets/{CCPetsPreviews.m → Pet/CCPetsPreviews.m} +0 -0
  156. /package/Sources/CCPets/Resources/{/351/273/230/350/256/244.webp" → ByteMochi.webp} +0 -0
  157. /package/Sources/CCPets/{CCPetsCleanup.h → Support/CCPetsCleanup.h} +0 -0
  158. /package/Sources/CCPets/{CCPetsCleanup.m → Support/CCPetsCleanup.m} +0 -0
  159. /package/Sources/CCPets/{CCPetsPaths.h → Support/CCPetsPaths.h} +0 -0
  160. /package/Sources/CCPets/{CCPetsPaths.m → Support/CCPetsPaths.m} +0 -0
  161. /package/Sources/CCPets/{CCPetsSystemMonitor.h → Support/CCPetsSystemMonitor.h} +0 -0
  162. /package/Sources/CCPets/{CCPetsSystemMonitor.m → Support/CCPetsSystemMonitor.m} +0 -0
  163. /package/Sources/CCPets/{CCPetsGlassMenu.h → UI/CCPetsGlassMenu.h} +0 -0
  164. /package/Sources/CCPets/{CCPetsGlassMenu.m → UI/CCPetsGlassMenu.m} +0 -0
  165. /package/Sources/CCPets/{MenuChoiceRow.h → UI/MenuChoiceRow.h} +0 -0
  166. /package/Sources/CCPets/{MenuChoiceRow.m → UI/MenuChoiceRow.m} +0 -0
  167. /package/Sources/CCPets/{MenuHintView.h → UI/MenuHintView.h} +0 -0
  168. /package/Sources/CCPets/{MenuHintView.m → UI/MenuHintView.m} +0 -0
  169. /package/Sources/CCPets/{MenuPetSizeView.h → UI/MenuPetSizeView.h} +0 -0
  170. /package/Sources/CCPets/{MenuPetSizeView.m → UI/MenuPetSizeView.m} +0 -0
  171. /package/Sources/CCPets/{MenuToggleSwitch.h → UI/MenuToggleSwitch.h} +0 -0
@@ -0,0 +1,234 @@
1
+ #import "PetView+Private.h"
2
+ #import "CCPetsPaths.h"
3
+
4
+ // 微动层:待机时每隔一段随机时间做一个有始有终的小动作。间隔必须随机——固定周期
5
+ // 会被下意识数出拍子,一旦数出来就全毁了。
6
+ static const NSTimeInterval PetMicroIntervalMin = 8.0;
7
+ static const NSTimeInterval PetMicroIntervalMax = 25.0;
8
+ // 无聊曲线的三个拐点(秒)。闲久了先躁动、再倦、最后几乎不动,是条先升后降的曲线。
9
+ static const NSTimeInterval PetBoredomRestless = 120.0;
10
+ static const NSTimeInterval PetBoredomTired = 600.0;
11
+ static const NSTimeInterval PetBoredomDrowsy = 1800.0;
12
+ // 十六向朝向定格保持多久(秒)。这是素材本来就设计成静止的格子,定格不违和。
13
+ static const NSTimeInterval PetGlanceHoldMin = 0.7;
14
+ static const NSTimeInterval PetGlanceHoldMax = 1.6;
15
+ // 生理余韵:agent 干完活之后呼吸会快一阵,再用几十秒平复回基线。
16
+ // 事件结束不等于状态归零——这种跨状态的连续性是免费的活物感。
17
+ static const double PetExertionPerEvent = 0.15;
18
+ static const NSTimeInterval PetExertionHalfLife = 25.0;
19
+ // 上次交互时间落盘的键。重启后接着算无聊曲线,隔了几小时再开就是从"打盹"开始,
20
+ // 而不是每次启动都精神抖擞。
21
+ static NSString *const PetLastActivityKey = @"CCPetsLastActivityAt";
22
+ static const NSTimeInterval PetActivitySaveInterval = 60.0;
23
+ // 微动的种类。加新动作就往这里加一项、再往 microBehaviorTable 里登记一行,
24
+ // 调度器不用改。
25
+ typedef NS_ENUM(NSInteger, PetMicroBehaviorKind) {
26
+ PetMicroBehaviorGlance, // 逐格转头看鼠标,需要十六向朝向行
27
+ PetMicroBehaviorScan, // row 3 张望,任何素材都有
28
+ };
29
+
30
+ @implementation PetView (MicroBehavior)
31
+ - (void)noteActivity {
32
+ self.lastActivityTime = CFAbsoluteTimeGetCurrent();
33
+ [self scheduleNextMicroBehavior];
34
+ [self persistLastActivityThrottled];
35
+ }
36
+ // 落盘限流:noteActivity 在鼠标划过宠物时会被高频调用,每次都写 defaults 没必要。
37
+ - (void)persistLastActivityThrottled {
38
+ if (self.lastActivityTime - self.lastActivitySavedAt < PetActivitySaveInterval) return;
39
+ self.lastActivitySavedAt = self.lastActivityTime;
40
+ [NSUserDefaults.standardUserDefaults setDouble:self.lastActivityTime
41
+ forKey:PetLastActivityKey];
42
+ }
43
+ - (void)restoreLastActivity {
44
+ double saved = [NSUserDefaults.standardUserDefaults doubleForKey:PetLastActivityKey];
45
+ NSTimeInterval now = CFAbsoluteTimeGetCurrent();
46
+ // 只认过去的时间戳:系统时钟被调过或 defaults 被写坏时,宁可当成"刚刚活动过",
47
+ // 也不能让宠物一启动就以为闲置了几十年直接进打盹。
48
+ if (saved > 0 && saved <= now) self.lastActivityTime = saved;
49
+ else self.lastActivityTime = now;
50
+ self.lastActivitySavedAt = self.lastActivityTime;
51
+ [self scheduleNextMicroBehavior];
52
+ }
53
+ // 当前用力程度,按半衰期衰减。
54
+ - (double)currentExertion {
55
+ NSTimeInterval elapsed = CFAbsoluteTimeGetCurrent() - self.exertionUpdatedAt;
56
+ if (elapsed <= 0) return self.exertion;
57
+ return self.exertion * pow(0.5, elapsed / PetExertionHalfLife);
58
+ }
59
+ - (void)bumpExertion {
60
+ self.exertion = MIN(1.0, [self currentExertion] + PetExertionPerEvent);
61
+ self.exertionUpdatedAt = CFAbsoluteTimeGetCurrent();
62
+ [self updateBreathingIfExertionChanged];
63
+ }
64
+ // 分档而不是连续调:改呼吸快慢要重加 CA 动画,相位会跳一下(最多 1.5px)。
65
+ // 分成三档之后一次任务里只会重加两三次,跳动察觉不到;连续调就是每拍都跳。
66
+ - (NSInteger)exertionLevel {
67
+ double exertion = [self currentExertion];
68
+ if (exertion < 0.2) return 0;
69
+ if (exertion < 0.6) return 1;
70
+ return 2;
71
+ }
72
+ - (void)updateBreathingIfExertionChanged {
73
+ NSInteger level = [self exertionLevel];
74
+ if (level == self.breathLevel) return;
75
+ self.breathLevel = level;
76
+ [self.spriteLayer removeAnimationForKey:@"breath"];
77
+ [self updateBreathingAnimation];
78
+ }
79
+ // 无聊曲线:闲久了先躁动(微动变频繁)、再倦、最后几乎不动。
80
+ // 这条曲线是非单调的,本身就是叙事——"闲得发慌"和"待久了发蔫"是两种不同的状态。
81
+ // 调试用:把无聊曲线的三个拐点整体缩放,好在几十秒内走完本来要半小时的过程。
82
+ // defaults write com.universewang.cc-pets CCPetsBoredomScale -float 0.25
83
+ // defaults delete com.universewang.cc-pets CCPetsBoredomScale # 恢复正常
84
+ // 域名必须是 bundle identifier,写成 "cc-pets" 会落到另一个 plist,桌宠读不到。
85
+ // 每次排期都现读,改完立刻生效,不用重启桌宠。缺省 1.0,也就是不缩放。
86
+ - (double)boredomScale {
87
+ id value = [NSUserDefaults.standardUserDefaults objectForKey:@"CCPetsBoredomScale"];
88
+ if (![value isKindOfClass:NSNumber.class]) return 1.0;
89
+ double scale = [value doubleValue];
90
+ if (!(scale > 0)) return 1.0;
91
+ return MIN(scale, 10.0);
92
+ }
93
+ - (double)microIntervalScale {
94
+ NSTimeInterval idle = (CFAbsoluteTimeGetCurrent() - self.lastActivityTime) / [self boredomScale];
95
+ if (idle < PetBoredomRestless) return 1.0;
96
+ if (idle < PetBoredomTired) return 0.5; // 躁动:间隔减半
97
+ if (idle < PetBoredomDrowsy) return 2.0; // 倦
98
+ return 6.0; // 打盹
99
+ }
100
+ - (void)scheduleNextMicroBehavior {
101
+ double scale = [self microIntervalScale];
102
+ double span = PetMicroIntervalMax - PetMicroIntervalMin;
103
+ double seconds = (PetMicroIntervalMin + span * (arc4random_uniform(1000) / 1000.0)) * scale;
104
+ self.microCountdown = (NSInteger)llround(seconds / PetFrameInterval);
105
+ }
106
+ // 待机之外一律不做:agent 在干活、正在拖、正在播一次性动作、十六向跟随中都不打断。
107
+ - (BOOL)canStartMicroBehavior {
108
+ return !self.microActive && !self.agentActive && !self.oneShot && !self.draggingPet &&
109
+ !self.animationSuspended && self.lookDirection < 0 && self.window != nil &&
110
+ [self isIdleRow:self.rowIndex];
111
+ }
112
+ // 微动只用"有始有终的动作",不改待机流本身的节奏。
113
+ //
114
+ // 9 行素材只有 row 3(观察)语义足够中性——它是一个独立动作,读起来是"它张望了一下"。
115
+ // 强语义行(row 1 跑/bash、row 7 工作/edit)绝不能用:待机时冒出来,用户会以为
116
+ // agent 在干活。
117
+ // 11 行素材额外可以用 row 9/10 的十六向定格:那是素材本来就设计成静止的格子,
118
+ // 定格不违和,且语义纯粹是"朝某个方向看"。
119
+ // 鼠标当前在哪个方向。算法和 updateLookForScreenPoint: 同源,-1 表示算不出来。
120
+ - (NSInteger)directionTowardScreenPoint:(NSPoint)screenPoint {
121
+ if (!self.window) return -1;
122
+ NSPoint center = [self convertPoint:NSMakePoint(NSMidX(self.bounds), NSMidY(self.bounds)) toView:nil];
123
+ center = [self.window convertPointToScreen:center];
124
+ CGFloat dx = screenPoint.x - center.x;
125
+ CGFloat dy = screenPoint.y - center.y;
126
+ if (hypot(dx, dy) <= 1.0) return -1;
127
+ CGFloat degrees = fmod(atan2(dx, dy) * 180.0 / M_PI + 360.0, 360.0);
128
+ return ((NSInteger)llround(degrees / 22.5)) % 16;
129
+ }
130
+ // 十六向是绕一圈排的,两个方向之间要走近的那一侧,否则会绕远大半圈。
131
+ - (NSInteger)directionStepFrom:(NSInteger)from to:(NSInteger)to {
132
+ NSInteger forward = ((to - from) + 16) % 16;
133
+ return forward <= 8 ? 1 : -1;
134
+ }
135
+ // 转头:从目标方向的前几格逐格扫过去 → 停一下 → 再逐格扫回来。
136
+ //
137
+ // 素材里 row 9/10 那 16 格本来只是"朝某个方向的静止姿势",但按角度顺序连着播,
138
+ // 白捡一个转头动画——不需要任何新素材。这是十六向素材最值钱的用法。
139
+ - (BOOL)startGlanceMicroBehavior {
140
+ NSInteger target = [self directionTowardScreenPoint:NSEvent.mouseLocation];
141
+ if (target < 0) return NO;
142
+
143
+ const NSInteger sweep = 3;
144
+ NSInteger step = [self directionStepFrom:(target - sweep + 16) % 16 to:target];
145
+ NSTimeInterval hold = PetGlanceHoldMin +
146
+ (PetGlanceHoldMax - PetGlanceHoldMin) * (arc4random_uniform(1000) / 1000.0);
147
+ NSUInteger holdTicks = MAX((NSUInteger)1, (NSUInteger)llround(hold / PetFrameInterval));
148
+
149
+ NSMutableArray<NSNumber *> *rows = [NSMutableArray array];
150
+ NSMutableArray<NSNumber *> *cols = [NSMutableArray array];
151
+ NSMutableArray<NSNumber *> *holds = [NSMutableArray array];
152
+ // 转过去
153
+ for (NSInteger index = sweep; index >= 0; index--) {
154
+ NSInteger direction = ((target - index * step) % 16 + 16) % 16;
155
+ [rows addObject:@(9 + direction / 8)];
156
+ [cols addObject:@(direction % 8)];
157
+ [holds addObject:index == 0 ? @(holdTicks) : @1];
158
+ }
159
+ // 转回来。最后一格不重复停在目标上,直接从倒数第二格开始退。
160
+ for (NSInteger index = 1; index <= sweep; index++) {
161
+ NSInteger direction = ((target - index * step) % 16 + 16) % 16;
162
+ [rows addObject:@(9 + direction / 8)];
163
+ [cols addObject:@(direction % 8)];
164
+ [holds addObject:@1];
165
+ }
166
+
167
+ // 不动 lookDirection:那个字段一旦 >=0 就进注意力模式,nextFrame: 只做到期检查,
168
+ // 这段序列就没人推进了。
169
+ self.frameRows = rows;
170
+ self.frames = cols;
171
+ self.frameHolds = holds;
172
+ self.holdTicks = 0;
173
+ self.sequenceIndex = 0;
174
+ self.rowIndex = rows.firstObject.integerValue;
175
+ self.frameIndex = cols.firstObject.integerValue;
176
+ self.fadeNextContents = YES;
177
+ self.needsDisplay = YES;
178
+ return YES;
179
+ }
180
+ // 能力集在换素材时算一次。未知行数(比如第三方给了 10 行)自动落到无朝向档,
181
+ // 是安全的降级方向。
182
+ - (void)rebuildCapabilities {
183
+ self.hasLookRows = self.spriteRowCount >= 11;
184
+ NSMutableArray<NSDictionary *> *table = [NSMutableArray array];
185
+ // 两档的行为密度要接近,只让表现形式不同。11 行档不该因为花样多就动得更频繁——
186
+ // 用户切素材时该读作"这只性格不一样",而不是"这只功能残缺"。
187
+ if (self.hasLookRows) {
188
+ [table addObject:@{@"kind": @(PetMicroBehaviorGlance), @"weight": @6}];
189
+ }
190
+ [table addObject:@{@"kind": @(PetMicroBehaviorScan), @"weight": @4}];
191
+ self.microBehaviorTable = table;
192
+ }
193
+ - (void)startScanMicroBehavior {
194
+ self.frameRows = nil;
195
+ self.rowIndex = 3;
196
+ self.frames = [self framesFromZeroThrough:3];
197
+ self.frameHolds = [self uniformHoldsForCount:self.frames.count];
198
+ self.holdTicks = 0;
199
+ self.sequenceIndex = 0;
200
+ self.frameIndex = 0;
201
+ self.fadeNextContents = YES;
202
+ self.needsDisplay = YES;
203
+ }
204
+ - (void)startMicroBehavior {
205
+ self.microActive = YES;
206
+ NSInteger total = 0;
207
+ for (NSDictionary *entry in self.microBehaviorTable) total += [entry[@"weight"] integerValue];
208
+ NSInteger roll = total > 0 ? (NSInteger)arc4random_uniform((uint32_t)total) : 0;
209
+ for (NSDictionary *entry in self.microBehaviorTable) {
210
+ roll -= [entry[@"weight"] integerValue];
211
+ if (roll >= 0) continue;
212
+ // 转头要拿得到鼠标方向,拿不到就顺势退到张望,不算失败。
213
+ if ([entry[@"kind"] integerValue] == PetMicroBehaviorGlance &&
214
+ [self startGlanceMicroBehavior]) {
215
+ return;
216
+ }
217
+ break;
218
+ }
219
+ [self startScanMicroBehavior];
220
+ }
221
+ // 收尾只回待机,绝不碰 agentActive。
222
+ - (void)endMicroBehavior {
223
+ self.microActive = NO;
224
+ self.frameRows = nil;
225
+ self.fadeNextContents = YES;
226
+ self.rowIndex = 0;
227
+ self.frames = [self framesFromZeroThrough:5];
228
+ self.frameHolds = [self uniformHoldsForCount:self.frames.count];
229
+ self.holdTicks = 0;
230
+ self.sequenceIndex = 0;
231
+ self.frameIndex = 0;
232
+ [self scheduleNextMicroBehavior];
233
+ }
234
+ @end
@@ -0,0 +1,81 @@
1
+ // PetView 各个 category 共用的私有属性,以及跨文件调用的方法。
2
+ #import "PetView.h"
3
+ #import <QuartzCore/QuartzCore.h>
4
+
5
+ @interface PetView ()
6
+ @property(weak) NSMenu *activePetSwitchMenu;
7
+ @property(copy) NSString *pendingDeletePetID;
8
+ // 素材能力:由行数在 applySheet: 时一次算出,之后全程只读这个,不再各处判行数。
9
+ //
10
+ // 散在各处写 rowCount == 11 的话,每加一个行为就多一处分支,测试翻倍且迟早漂移。
11
+ // 收成能力位之后,差异降级成"微动表里哪几行可用"这一个数据问题,调度器根本
12
+ // 不知道有分档这回事。
13
+ @property BOOL hasLookRows;
14
+ // 按能力过滤后的可用微动表,每项 @{kind, weight}。
15
+ @property NSArray<NSDictionary *> *microBehaviorTable;
16
+ // 精灵内容单独挂一层:呼吸、弹簧、落地 squash 都要对这一层做 CA 动画,放在视图自己的
17
+ // layer 上会连带影响命中测试和子视图几何。
18
+ @property CALayer *spriteLayer;
19
+ @property NSSize spriteCacheSize;
20
+ // 当前帧已经停了几拍,够 frameHolds 里那个数才推进。
21
+ @property NSUInteger holdTicks;
22
+ // 待机当前的速度档(拍/帧)。行为已关,字段留给微动层的慢放用。
23
+ @property NSUInteger idleHold;
24
+ // 微动层:独立于 oneShot 的一套标志。
25
+ //
26
+ // 绝对不能复用 oneShot——它在 nextFrame: 里播完会连带把 agentActive 清成 NO
27
+ // (见那一处注释)。微动是待机期间的自发动作,跟 agent 状态毫无关系,借它的壳会把
28
+ // "agent 正在干活"这个状态误清掉。
29
+ @property BOOL microActive;
30
+ // 下一次换图走一次短淡入淡出。进出微动那一下是硬切,加这一下过渡就不突兀了。
31
+ @property BOOL fadeNextContents;
32
+ @property NSInteger microCountdown;
33
+ // 最后一次"有事发生"的时间:agent 事件、鼠标交互、拖动都算。无聊曲线按它算。
34
+ //
35
+ // 不要改用 agentActive 判断闲了多久:mouseDown: 会无条件把它清成 NO,不管 agent
36
+ // 是不是还在跑,用户随手点一下宠物就会让无聊曲线误启动。
37
+ @property NSTimeInterval lastActivityTime;
38
+ // 注意力:真正在看的方向、以及这次注意力还能维持多久。
39
+ @property NSTimeInterval attentionUntil;
40
+ @property NSTimeInterval attentionCooldownUntil;
41
+ // 生理余韵:用力程度(0~1,按半衰期衰减)、上次更新时刻、当前呼吸档位。
42
+ @property double exertion;
43
+ @property NSTimeInterval exertionUpdatedAt;
44
+ @property NSInteger breathLevel;
45
+ @property NSTimeInterval lastActivitySavedAt;
46
+ // 拖动期间记上一次窗口位置,用来算这一帧走了多远。窗口服务器接管拖动后不给应用连续
47
+ // 事件,但 NSWindowDidMoveNotification 照发,这是拖动中唯一拿得到的位移信号。
48
+ @property NSPoint lastDragWindowOrigin;
49
+ @property BOOL observingWindowMove;
50
+ // 连击只统计没有变成拖动的左键释放。
51
+ @property NSInteger interactionClickCount;
52
+ @property NSTimeInterval lastInteractionClickAt;
53
+ // 按格栅格化的位图。视网膜下每格 280×300×4 ≈ 328KB,整表 88 格会到 28MB,
54
+ // 所以设 cost 上限让它只留住真正在播的那些格。
55
+ @property NSCache<NSNumber *, id> *cellCache;
56
+
57
+ // 主文件里实现、category 也要用的方法。
58
+ - (NSArray<NSNumber *> *)framesFromZeroThrough:(NSInteger)last;
59
+ - (NSArray<NSNumber *> *)uniformHoldsForCount:(NSUInteger)count;
60
+ - (BOOL)isIdleRow:(NSInteger)row;
61
+ - (void)updateBreathingAnimation;
62
+ @end
63
+
64
+ // 微动层:待机时随机插入的小动作、无聊曲线和用力后的呼吸余韵。
65
+ @interface PetView (MicroBehavior)
66
+ - (void)noteActivity;
67
+ - (void)restoreLastActivity;
68
+ - (void)bumpExertion;
69
+ - (NSInteger)exertionLevel;
70
+ - (void)updateBreathingIfExertionChanged;
71
+ - (void)scheduleNextMicroBehavior;
72
+ - (BOOL)canStartMicroBehavior;
73
+ - (void)rebuildCapabilities;
74
+ - (void)startMicroBehavior;
75
+ - (void)endMicroBehavior;
76
+ @end
77
+
78
+ // 鼠标交互:拖动、松手落脚、连击互动。
79
+ @interface PetView (Interaction)
80
+ - (void)endPetDrag;
81
+ @end
@@ -1,10 +1,8 @@
1
1
  #import <Cocoa/Cocoa.h>
2
2
 
3
- // 连击互动配置。放在 PetView 公共契约里,菜单和点击处理共用同一组 defaults 键。
4
- extern NSString *const PetInteractionEnabledKey;
5
- extern NSString *const PetInteractionHeartThresholdKey;
6
- extern NSString *const PetInteractionAnnoyedThresholdKey;
7
- extern NSString *const PetInteractionIntervalKey;
3
+ // 连击互动配置的 defaults 键(PetInteraction*Key)定义在 CCPetsPreferences,菜单、设置页和
4
+ // 点击处理共用同一组。
5
+ #import "CCPetsPreferences.h"
8
6
 
9
7
  @interface PetView : NSView <NSMenuDelegate>
10
8
  @property(nonatomic) NSImage *sheet;