cc-pets 2.2.0 → 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 (173) hide show
  1. package/CC_BRIDGE.md +5 -2
  2. package/CC_BRIDGE.zh-CN.md +4 -2
  3. package/CHANGELOG.md +85 -0
  4. package/CHANGELOG.zh-CN.md +85 -0
  5. package/CONTRIBUTING.md +28 -11
  6. package/CONTRIBUTING.zh-CN.md +23 -11
  7. package/README.md +127 -27
  8. package/README.zh-CN.md +104 -30
  9. package/Resources/zh-Hans.lproj/Localizable.strings +573 -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} +89 -31
  12. package/Sources/CCPets/{CCPetsAppDelegate+Bridge.m → App/CCPetsAppDelegate+Bridge.m} +35 -24
  13. package/Sources/CCPets/{CCPetsAppDelegate+Pets.m → App/CCPetsAppDelegate+Pets.m} +18 -4
  14. package/Sources/CCPets/{CCPetsAppDelegate+Private.h → App/CCPetsAppDelegate+Private.h} +90 -21
  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/App/CCPetsAppDelegate+Settings.m +269 -0
  18. package/Sources/CCPets/{CCPetsAppDelegate+Speech.m → App/CCPetsAppDelegate+Speech.m} +13 -7
  19. package/Sources/CCPets/{CCPetsAppDelegate+Update.m → App/CCPetsAppDelegate+Update.m} +71 -47
  20. package/Sources/CCPets/App/CCPetsAppDelegate+Workbench.m +139 -0
  21. package/Sources/CCPets/{CCPetsAppDelegate.h → App/CCPetsAppDelegate.h} +16 -2
  22. package/Sources/CCPets/{CCPetsAppDelegate.m → App/CCPetsAppDelegate.m} +110 -12
  23. package/Sources/CCPets/App/CCPetsOpenCommand.h +13 -0
  24. package/Sources/CCPets/App/CCPetsOpenCommand.m +99 -0
  25. package/Sources/CCPets/{main.m → App/main.m} +68 -1
  26. package/Sources/CCPets/{CCPetsBridge.h → Bridge/CCPetsBridge.h} +17 -4
  27. package/Sources/CCPets/{CCPetsBridge.m → Bridge/CCPetsBridge.m} +32 -17
  28. package/Sources/CCPets/Bridge/CCPetsBridgeCLI.h +10 -0
  29. package/Sources/CCPets/Bridge/CCPetsBridgeCLI.m +792 -0
  30. package/Sources/CCPets/Bridge/CCPetsBridgeCore.h +60 -0
  31. package/Sources/CCPets/Bridge/CCPetsBridgeCore.m +558 -0
  32. package/Sources/CCPets/Bridge/CCPetsBridgeSetup.h +24 -0
  33. package/Sources/CCPets/Bridge/CCPetsBridgeSetup.m +501 -0
  34. package/Sources/CCPets/Bridge/CCPetsBridgeStore.h +103 -0
  35. package/Sources/CCPets/Bridge/CCPetsBridgeStore.m +779 -0
  36. package/Sources/CCPets/Integrations/CCPetsCLISupport.h +75 -0
  37. package/Sources/CCPets/Integrations/CCPetsCLISupport.m +342 -0
  38. package/Sources/CCPets/Integrations/CCPetsEvents.h +15 -0
  39. package/Sources/CCPets/{CCPetsEvents.m → Integrations/CCPetsEvents.m} +23 -0
  40. package/Sources/CCPets/Integrations/CCPetsIntegrations.h +51 -0
  41. package/Sources/CCPets/Integrations/CCPetsIntegrations.m +662 -0
  42. package/Sources/CCPets/Integrations/CCPetsProfiles.h +38 -0
  43. package/Sources/CCPets/Integrations/CCPetsProfiles.m +516 -0
  44. package/Sources/CCPets/{CCPetsTerminalFocus.m → Integrations/CCPetsTerminalFocus.m} +42 -12
  45. package/Sources/CCPets/Pet/CCPetsImageLoader.h +5 -0
  46. package/Sources/CCPets/{CCPetsImageLoader.m → Pet/CCPetsImageLoader.m} +10 -2
  47. package/Sources/CCPets/Pet/CCPetsPetSize.h +10 -0
  48. package/Sources/CCPets/Pet/CCPetsPetSize.m +21 -0
  49. package/Sources/CCPets/Pet/CCPetsPetStore.h +12 -0
  50. package/Sources/CCPets/Pet/CCPetsPetStore.m +476 -0
  51. package/Sources/CCPets/{CCPetsPhrases.h → Pet/CCPetsPhrases.h} +18 -2
  52. package/Sources/CCPets/{CCPetsPhrases.m → Pet/CCPetsPhrases.m} +53 -22
  53. package/Sources/CCPets/{CCPetsPhrasesEditor.m → Pet/CCPetsPhrasesEditor.m} +42 -2
  54. package/Sources/CCPets/Pet/PetView+Interaction.m +207 -0
  55. package/Sources/CCPets/Pet/PetView+Menu.m +598 -0
  56. package/Sources/CCPets/Pet/PetView+MicroBehavior.m +234 -0
  57. package/Sources/CCPets/Pet/PetView+Private.h +81 -0
  58. package/Sources/CCPets/{PetView.h → Pet/PetView.h} +3 -5
  59. package/Sources/CCPets/Pet/PetView.m +635 -0
  60. package/Sources/CCPets/Support/CCPetsDoctor.h +25 -0
  61. package/Sources/CCPets/Support/CCPetsDoctor.m +632 -0
  62. package/Sources/CCPets/Support/CCPetsJSON.h +27 -0
  63. package/Sources/CCPets/Support/CCPetsJSON.m +397 -0
  64. package/Sources/CCPets/{CCPetsL10n.h → Support/CCPetsL10n.h} +3 -1
  65. package/Sources/CCPets/{CCPetsL10n.m → Support/CCPetsL10n.m} +30 -1
  66. package/Sources/CCPets/Support/CCPetsPreferences.h +31 -0
  67. package/Sources/CCPets/Support/CCPetsPreferences.m +85 -0
  68. package/Sources/CCPets/UI/CCPetsDiagnosticsPage.h +25 -0
  69. package/Sources/CCPets/UI/CCPetsDiagnosticsPage.m +440 -0
  70. package/Sources/CCPets/UI/CCPetsFormBuilder.h +42 -0
  71. package/Sources/CCPets/UI/CCPetsFormBuilder.m +268 -0
  72. package/Sources/CCPets/{CCPetsGlassView.h → UI/CCPetsGlassView.h} +5 -1
  73. package/Sources/CCPets/{CCPetsGlassView.m → UI/CCPetsGlassView.m} +25 -7
  74. package/Sources/CCPets/UI/CCPetsMainWindow.h +55 -0
  75. package/Sources/CCPets/UI/CCPetsMainWindow.m +730 -0
  76. package/Sources/CCPets/UI/CCPetsSettingsPage.h +62 -0
  77. package/Sources/CCPets/UI/CCPetsSettingsPage.m +917 -0
  78. package/Sources/CCPets/UI/CCPetsUIStyle.h +132 -0
  79. package/Sources/CCPets/UI/CCPetsUIStyle.m +816 -0
  80. package/Sources/CCPets/UI/CCPetsUsageChartView.h +15 -0
  81. package/Sources/CCPets/UI/CCPetsUsageChartView.m +284 -0
  82. package/Sources/CCPets/UI/CCPetsUsagePage.h +32 -0
  83. package/Sources/CCPets/UI/CCPetsUsagePage.m +717 -0
  84. package/Sources/CCPets/UI/CCPetsUsageShared.h +53 -0
  85. package/Sources/CCPets/UI/CCPetsUsageStore.m +120 -0
  86. package/Sources/CCPets/UI/CCPetsUsageWidgets.h +30 -0
  87. package/Sources/CCPets/UI/CCPetsUsageWidgets.m +201 -0
  88. package/Sources/CCPets/UI/CCPetsWorkbench.h +40 -0
  89. package/Sources/CCPets/UI/CCPetsWorkbenchPages.h +13 -0
  90. package/Sources/CCPets/UI/CCPetsWorkbenchPages.m +783 -0
  91. package/Sources/CCPets/{MenuChoiceRow.m → UI/MenuChoiceRow.m} +3 -0
  92. package/Sources/CCPets/UI/MenuPetSizeView.h +5 -0
  93. package/Sources/CCPets/UI/MenuPetSizeView.m +73 -0
  94. package/Sources/CCPets/{MenuToggleSwitch.m → UI/MenuToggleSwitch.m} +1 -0
  95. package/Sources/CCPets/{CCPetsCodexRateLimits.h → Usage/CCPetsCodexRateLimits.h} +1 -0
  96. package/Sources/CCPets/{CCPetsCodexRateLimits.m → Usage/CCPetsCodexRateLimits.m} +10 -3
  97. package/Sources/CCPets/{CCPetsQuotaHistory.h → Usage/CCPetsQuotaHistory.h} +3 -0
  98. package/Sources/CCPets/{CCPetsQuotaHistory.m → Usage/CCPetsQuotaHistory.m} +58 -0
  99. package/Sources/CCPets/Usage/CCPetsUsage+ClaudeReader.m +436 -0
  100. package/Sources/CCPets/Usage/CCPetsUsage+CodexReader.m +392 -0
  101. package/Sources/CCPets/Usage/CCPetsUsage+CodexSessions.m +484 -0
  102. package/Sources/CCPets/Usage/CCPetsUsage+Internal.h +96 -0
  103. package/Sources/CCPets/Usage/CCPetsUsage+Models.m +285 -0
  104. package/Sources/CCPets/Usage/CCPetsUsage+TokenTotals.m +655 -0
  105. package/Sources/CCPets/Usage/CCPetsUsage.h +57 -0
  106. package/Sources/CCPets/Usage/CCPetsUsage.m +225 -0
  107. package/Sources/CCPets/Usage/CCPetsUsageMode.h +10 -0
  108. package/Sources/CCPets/Usage/CCPetsUsageMode.m +163 -0
  109. package/Sources/CCPets/{CCPetsUsageMonitor.h → Usage/CCPetsUsageMonitor.h} +3 -0
  110. package/Sources/CCPets/{CCPetsUsageMonitor.m → Usage/CCPetsUsageMonitor.m} +163 -6
  111. package/Sources/CCPets/Usage/QuotaDashboardView+Primitives.m +328 -0
  112. package/Sources/CCPets/Usage/QuotaDashboardView+Private.h +103 -0
  113. package/Sources/CCPets/Usage/QuotaDashboardView+Rendering.m +616 -0
  114. package/Sources/CCPets/{QuotaDashboardView.h → Usage/QuotaDashboardView.h} +17 -0
  115. package/Sources/CCPets/Usage/QuotaDashboardView.m +587 -0
  116. package/THIRD_PARTY_NOTICES.md +1 -1
  117. package/THIRD_PARTY_NOTICES.zh-CN.md +1 -1
  118. package/bin/cc-pets +8 -6
  119. package/bin/claude-with-pet +10 -2
  120. package/bin/codex-with-pet +13 -5
  121. package/package.json +1 -1
  122. package/scripts/build.sh +7 -3
  123. package/scripts/i18n.zsh +9 -52
  124. package/scripts/install-app.sh +4 -0
  125. package/scripts/install-shell-integration.sh +17 -10
  126. package/scripts/uninstall-shell-integration.sh +6 -1
  127. package/Sources/CCPets/CCPetsAppDelegate+Settings.m +0 -226
  128. package/Sources/CCPets/CCPetsEvents.h +0 -10
  129. package/Sources/CCPets/CCPetsImageLoader.h +0 -4
  130. package/Sources/CCPets/CCPetsUsage.h +0 -36
  131. package/Sources/CCPets/CCPetsUsage.m +0 -2069
  132. package/Sources/CCPets/PetView.m +0 -1806
  133. package/Sources/CCPets/QuotaDashboardView.m +0 -1145
  134. package/scripts/bridge/cli.mjs +0 -237
  135. package/scripts/bridge/core.mjs +0 -228
  136. package/scripts/bridge/hook.mjs +0 -150
  137. package/scripts/bridge/install.mjs +0 -311
  138. package/scripts/bridge/mcp-server.mjs +0 -308
  139. package/scripts/bridge/options.mjs +0 -87
  140. package/scripts/bridge/process.mjs +0 -151
  141. package/scripts/bridge/reservations.mjs +0 -248
  142. package/scripts/bridge/store.mjs +0 -433
  143. package/scripts/bridge/watch.mjs +0 -69
  144. package/scripts/check-l10n.mjs +0 -168
  145. package/scripts/configure-updater.mjs +0 -43
  146. package/scripts/detect-cli.mjs +0 -68
  147. package/scripts/doctor.mjs +0 -470
  148. package/scripts/i18n.mjs +0 -122
  149. package/scripts/install-claude-hooks.mjs +0 -253
  150. package/scripts/install-codex-hooks.mjs +0 -78
  151. package/scripts/integration-markers.mjs +0 -51
  152. package/scripts/locales/zh-Hans.json +0 -366
  153. package/scripts/pet-store.mjs +0 -415
  154. package/scripts/uninstall-integrations.mjs +0 -205
  155. /package/Sources/CCPets/{CCPetsVersion.h → App/CCPetsVersion.h} +0 -0
  156. /package/Sources/CCPets/{CCPetsVersion.m → App/CCPetsVersion.m} +0 -0
  157. /package/Sources/CCPets/{CCPetsTerminalFocus.h → Integrations/CCPetsTerminalFocus.h} +0 -0
  158. /package/Sources/CCPets/{CCPetsPhrasesEditor.h → Pet/CCPetsPhrasesEditor.h} +0 -0
  159. /package/Sources/CCPets/{CCPetsPreviews.h → Pet/CCPetsPreviews.h} +0 -0
  160. /package/Sources/CCPets/{CCPetsPreviews.m → Pet/CCPetsPreviews.m} +0 -0
  161. /package/Sources/CCPets/Resources/{/351/273/230/350/256/244.webp" → ByteMochi.webp} +0 -0
  162. /package/Sources/CCPets/{CCPetsCleanup.h → Support/CCPetsCleanup.h} +0 -0
  163. /package/Sources/CCPets/{CCPetsCleanup.m → Support/CCPetsCleanup.m} +0 -0
  164. /package/Sources/CCPets/{CCPetsPaths.h → Support/CCPetsPaths.h} +0 -0
  165. /package/Sources/CCPets/{CCPetsPaths.m → Support/CCPetsPaths.m} +0 -0
  166. /package/Sources/CCPets/{CCPetsSystemMonitor.h → Support/CCPetsSystemMonitor.h} +0 -0
  167. /package/Sources/CCPets/{CCPetsSystemMonitor.m → Support/CCPetsSystemMonitor.m} +0 -0
  168. /package/Sources/CCPets/{CCPetsGlassMenu.h → UI/CCPetsGlassMenu.h} +0 -0
  169. /package/Sources/CCPets/{CCPetsGlassMenu.m → UI/CCPetsGlassMenu.m} +0 -0
  170. /package/Sources/CCPets/{MenuChoiceRow.h → UI/MenuChoiceRow.h} +0 -0
  171. /package/Sources/CCPets/{MenuHintView.h → UI/MenuHintView.h} +0 -0
  172. /package/Sources/CCPets/{MenuHintView.m → UI/MenuHintView.m} +0 -0
  173. /package/Sources/CCPets/{MenuToggleSwitch.h → UI/MenuToggleSwitch.h} +0 -0
@@ -0,0 +1,268 @@
1
+ #import "CCPetsFormBuilder.h"
2
+ #import "CCPetsUIStyle.h"
3
+
4
+ // 文档视图要翻转坐标(原点在左上),内容才会从顶部往下排,滚动位置也才好算。
5
+ @interface CCPetsFlippedView : NSView
6
+ @end
7
+
8
+ @implementation CCPetsFlippedView
9
+ - (BOOL)isFlipped {
10
+ return YES;
11
+ }
12
+ @end
13
+
14
+ // 内容最宽 1120pt:窗口拉得很宽(包括全屏)时,表单和表格不跟着摊成一长条,行内左右两端离得太远不好对照。
15
+ static const CGFloat FormMaximumWidth = 1120;
16
+ static const CGFloat FormSideInset = 28;
17
+
18
+ @interface CCPetsFormBuilder ()
19
+ @property(nonatomic) NSView *view;
20
+ @property(nonatomic) NSScrollView *scrollView;
21
+ @property(nonatomic) NSStackView *stack;
22
+ @property(nonatomic) NSTextField *subtitleLabel;
23
+ @property(nonatomic) NSStackView *accessories;
24
+ @end
25
+
26
+ @implementation CCPetsFormBuilder
27
+
28
+ - (instancetype)init {
29
+ return [self initWithTitle:@"" subtitle:@""];
30
+ }
31
+
32
+ - (instancetype)initWithTitle:(NSString *)title subtitle:(NSString *)subtitle {
33
+ if ((self = [super init])) {
34
+ NSTextField *titleLabel = CCPetsLabel(title, 22, NSFontWeightBold, CCPetsInkColor());
35
+ NSTextField *subtitleLabel = CCPetsLabel(subtitle, 12, NSFontWeightRegular, CCPetsSecondaryInkColor());
36
+ [titleLabel setContentCompressionResistancePriority:NSLayoutPriorityDefaultLow
37
+ forOrientation:NSLayoutConstraintOrientationHorizontal];
38
+ [subtitleLabel setContentCompressionResistancePriority:NSLayoutPriorityDefaultLow
39
+ forOrientation:NSLayoutConstraintOrientationHorizontal];
40
+ self.subtitleLabel = subtitleLabel;
41
+ NSStackView *titles = [NSStackView stackViewWithViews:@[titleLabel, subtitleLabel]];
42
+ titles.orientation = NSUserInterfaceLayoutOrientationVertical;
43
+ titles.alignment = NSLayoutAttributeLeading;
44
+ titles.spacing = 2;
45
+
46
+ NSStackView *accessories = [NSStackView stackViewWithViews:@[]];
47
+ accessories.spacing = 8;
48
+ accessories.alignment = NSLayoutAttributeCenterY;
49
+ [accessories setContentHuggingPriority:NSLayoutPriorityRequired
50
+ forOrientation:NSLayoutConstraintOrientationHorizontal];
51
+ [accessories setContentCompressionResistancePriority:NSLayoutPriorityRequired
52
+ forOrientation:NSLayoutConstraintOrientationHorizontal];
53
+ self.accessories = accessories;
54
+
55
+ NSView *header = [NSView new];
56
+ NSView *rule = [CCPetsFormBuilder separator];
57
+ for (NSView *view in @[titles, accessories, rule]) {
58
+ view.translatesAutoresizingMaskIntoConstraints = NO;
59
+ [header addSubview:view];
60
+ }
61
+
62
+ NSScrollView *scroll = [[NSScrollView alloc] initWithFrame:NSMakeRect(0, 0, 560, 560)];
63
+ scroll.hasVerticalScroller = YES;
64
+ scroll.autohidesScrollers = YES;
65
+ scroll.drawsBackground = NO;
66
+ NSView *document = [[CCPetsFlippedView alloc] initWithFrame:NSZeroRect];
67
+ document.translatesAutoresizingMaskIntoConstraints = NO;
68
+ scroll.documentView = document;
69
+ NSClipView *clip = scroll.contentView;
70
+
71
+ NSStackView *stack = [NSStackView stackViewWithViews:@[]];
72
+ stack.orientation = NSUserInterfaceLayoutOrientationVertical;
73
+ stack.alignment = NSLayoutAttributeLeading;
74
+ stack.spacing = 16;
75
+ stack.translatesAutoresizingMaskIntoConstraints = NO;
76
+ [document addSubview:stack];
77
+
78
+ NSView *root = [[NSView alloc] initWithFrame:NSMakeRect(0, 0, 640, 560)];
79
+ header.translatesAutoresizingMaskIntoConstraints = NO;
80
+ scroll.translatesAutoresizingMaskIntoConstraints = NO;
81
+ [root addSubview:header];
82
+ [root addSubview:scroll];
83
+
84
+ // "尽量撑满"的优先级卡在两者之间:低于窗口缩放(NSLayoutPriorityWindowSizeStayPut = 500),
85
+ // 否则它加上宽度上限会反过来把窗口宽度锁死,全屏时两侧只能留黑边;又要高于内容的
86
+ // 贴合优先级(250),否则内容列只按自己最窄的宽度排,宽窗口里缩成中间一小条。
87
+ NSLayoutConstraint *fullWidth = [stack.widthAnchor constraintEqualToAnchor:document.widthAnchor
88
+ constant:-2 * FormSideInset];
89
+ fullWidth.priority = NSLayoutPriorityDragThatCannotResizeWindow;
90
+ [NSLayoutConstraint activateConstraints:@[
91
+ [header.topAnchor constraintEqualToAnchor:root.topAnchor],
92
+ [header.leadingAnchor constraintEqualToAnchor:root.leadingAnchor],
93
+ [header.trailingAnchor constraintEqualToAnchor:root.trailingAnchor],
94
+ // 页头和下面的内容列左右对齐:窗口很宽时内容列居中,页头跟着居中。
95
+ [titles.leadingAnchor constraintEqualToAnchor:stack.leadingAnchor],
96
+ [titles.topAnchor constraintEqualToAnchor:header.topAnchor constant:6],
97
+ [titles.bottomAnchor constraintEqualToAnchor:header.bottomAnchor constant:-14],
98
+ [accessories.leadingAnchor constraintGreaterThanOrEqualToAnchor:titles.trailingAnchor constant:16],
99
+ [accessories.trailingAnchor constraintEqualToAnchor:stack.trailingAnchor],
100
+ [accessories.centerYAnchor constraintEqualToAnchor:titles.centerYAnchor],
101
+ [rule.leadingAnchor constraintEqualToAnchor:header.leadingAnchor],
102
+ [rule.trailingAnchor constraintEqualToAnchor:header.trailingAnchor],
103
+ [rule.bottomAnchor constraintEqualToAnchor:header.bottomAnchor],
104
+
105
+ [scroll.topAnchor constraintEqualToAnchor:header.bottomAnchor],
106
+ [scroll.leadingAnchor constraintEqualToAnchor:root.leadingAnchor],
107
+ [scroll.trailingAnchor constraintEqualToAnchor:root.trailingAnchor],
108
+ [scroll.bottomAnchor constraintEqualToAnchor:root.bottomAnchor],
109
+ [document.leadingAnchor constraintEqualToAnchor:clip.leadingAnchor],
110
+ [document.trailingAnchor constraintEqualToAnchor:clip.trailingAnchor],
111
+ [document.topAnchor constraintEqualToAnchor:clip.topAnchor],
112
+ [stack.leadingAnchor constraintGreaterThanOrEqualToAnchor:document.leadingAnchor constant:FormSideInset],
113
+ [stack.centerXAnchor constraintEqualToAnchor:document.centerXAnchor],
114
+ [stack.trailingAnchor constraintLessThanOrEqualToAnchor:document.trailingAnchor constant:-FormSideInset],
115
+ [stack.widthAnchor constraintLessThanOrEqualToConstant:FormMaximumWidth],
116
+ fullWidth,
117
+ [stack.topAnchor constraintEqualToAnchor:document.topAnchor constant:18],
118
+ [stack.bottomAnchor constraintEqualToAnchor:document.bottomAnchor constant:-28],
119
+ ]];
120
+ self.view = root;
121
+ self.scrollView = scroll;
122
+ self.stack = stack;
123
+ }
124
+ return self;
125
+ }
126
+
127
+ - (void)setAccessoryViews:(NSArray<NSView *> *)views {
128
+ for (NSView *view in [self.accessories.arrangedSubviews copy]) {
129
+ [self.accessories removeArrangedSubview:view];
130
+ [view removeFromSuperview];
131
+ }
132
+ for (NSView *view in views) [self.accessories addArrangedSubview:view];
133
+ }
134
+
135
+ + (NSView *)separator {
136
+ CCPetsLineView *line = [CCPetsLineView new];
137
+ line.translatesAutoresizingMaskIntoConstraints = NO;
138
+ [line.heightAnchor constraintEqualToConstant:1].active = YES;
139
+ return line;
140
+ }
141
+
142
+ + (NSView *)rowWithTitle:(NSString *)title controls:(NSArray<NSView *> *)controls {
143
+ return [self rowWithTitle:title subtitle:nil controls:controls];
144
+ }
145
+
146
+ + (NSView *)rowWithTitle:(NSString *)title subtitle:(NSString *)subtitle controls:(NSArray<NSView *> *)controls {
147
+ NSTextField *label = CCPetsLabel(title, 13, NSFontWeightRegular, CCPetsInkColor());
148
+ [label setContentCompressionResistancePriority:NSLayoutPriorityDefaultLow
149
+ forOrientation:NSLayoutConstraintOrientationHorizontal];
150
+ NSView *titleView = label;
151
+ if (subtitle.length > 0) {
152
+ NSTextField *detail = CCPetsLabel(subtitle, 11, NSFontWeightRegular, CCPetsTertiaryInkColor());
153
+ [detail setContentCompressionResistancePriority:NSLayoutPriorityDefaultLow
154
+ forOrientation:NSLayoutConstraintOrientationHorizontal];
155
+ NSStackView *titles = [NSStackView stackViewWithViews:@[label, detail]];
156
+ titles.orientation = NSUserInterfaceLayoutOrientationVertical;
157
+ titles.alignment = NSLayoutAttributeLeading;
158
+ titles.spacing = 1;
159
+ [titles setContentCompressionResistancePriority:NSLayoutPriorityDefaultLow
160
+ forOrientation:NSLayoutConstraintOrientationHorizontal];
161
+ titleView = titles;
162
+ }
163
+ NSView *spacer = [NSView new];
164
+ [spacer setContentHuggingPriority:1 forOrientation:NSLayoutConstraintOrientationHorizontal];
165
+ NSStackView *row = [NSStackView stackViewWithViews:[@[titleView, spacer] arrayByAddingObjectsFromArray:controls]];
166
+ row.orientation = NSUserInterfaceLayoutOrientationHorizontal;
167
+ row.alignment = NSLayoutAttributeCenterY;
168
+ row.spacing = 8;
169
+ row.edgeInsets = NSEdgeInsetsMake(8, 14, 8, 14);
170
+ [row.heightAnchor constraintGreaterThanOrEqualToConstant:subtitle.length > 0 ? 48 : 40].active = YES;
171
+ return row;
172
+ }
173
+
174
+ - (void)addGroupTitle:(NSString *)title note:(NSString *)note {
175
+ [self addGroupTitle:title note:note info:nil];
176
+ }
177
+
178
+ - (void)addGroupTitle:(NSString *)title note:(NSString *)note info:(NSString *)info {
179
+ NSView *label = CCPetsLabel(title, 13, NSFontWeightSemibold, CCPetsInkColor());
180
+ if (info.length > 0) {
181
+ NSImageView *icon = [NSImageView imageViewWithImage:
182
+ [NSImage imageWithSystemSymbolName:@"info.circle" accessibilityDescription:info]];
183
+ icon.symbolConfiguration = [NSImageSymbolConfiguration configurationWithPointSize:11
184
+ weight:NSFontWeightRegular];
185
+ icon.contentTintColor = CCPetsTertiaryInkColor();
186
+ icon.toolTip = info;
187
+ [icon setContentHuggingPriority:NSLayoutPriorityRequired
188
+ forOrientation:NSLayoutConstraintOrientationHorizontal];
189
+ // 图标没有基线,先和标题按中线对齐,外层再按基线对齐 note。
190
+ NSStackView *line = [NSStackView stackViewWithViews:@[label, icon]];
191
+ line.alignment = NSLayoutAttributeCenterY;
192
+ line.spacing = 4;
193
+ label = line;
194
+ }
195
+ NSMutableArray<NSView *> *views = [NSMutableArray arrayWithObject:label];
196
+ if (note.length > 0) [views addObject:CCPetsLabel(note, 11, NSFontWeightRegular, CCPetsTertiaryInkColor())];
197
+ NSStackView *header = [NSStackView stackViewWithViews:views];
198
+ header.spacing = 8;
199
+ header.alignment = NSLayoutAttributeFirstBaseline;
200
+ header.edgeInsets = NSEdgeInsetsMake(0, 2, 0, 0);
201
+ // 分组标题和它下面的卡片贴近一些,和上一组拉开:一眼看出谁属于谁。
202
+ if (self.stack.arrangedSubviews.count > 0) {
203
+ [self.stack setCustomSpacing:22 afterView:self.stack.arrangedSubviews.lastObject];
204
+ }
205
+ [self.stack addArrangedSubview:header];
206
+ [self.stack setCustomSpacing:8 afterView:header];
207
+ }
208
+
209
+ - (NSView *)addGroupWithTitle:(NSString *)title rows:(NSArray<NSView *> *)rows footer:(NSString *)footer {
210
+ if (title.length > 0) [self addGroupTitle:title note:nil];
211
+
212
+ NSStackView *content = [NSStackView stackViewWithViews:@[]];
213
+ content.orientation = NSUserInterfaceLayoutOrientationVertical;
214
+ content.spacing = 0;
215
+ content.translatesAutoresizingMaskIntoConstraints = NO;
216
+ for (NSView *row in rows) {
217
+ if (content.arrangedSubviews.count > 0) {
218
+ NSView *separator = [CCPetsFormBuilder separator];
219
+ [content addArrangedSubview:separator];
220
+ [separator.leadingAnchor constraintEqualToAnchor:content.leadingAnchor constant:14].active = YES;
221
+ [separator.trailingAnchor constraintEqualToAnchor:content.trailingAnchor].active = YES;
222
+ }
223
+ [content addArrangedSubview:row];
224
+ [row.leadingAnchor constraintEqualToAnchor:content.leadingAnchor].active = YES;
225
+ [row.trailingAnchor constraintEqualToAnchor:content.trailingAnchor].active = YES;
226
+ }
227
+
228
+ CCPetsCardView *card = [CCPetsCardView new];
229
+ card.translatesAutoresizingMaskIntoConstraints = NO;
230
+ [card addSubview:content];
231
+ [NSLayoutConstraint activateConstraints:@[
232
+ [content.leadingAnchor constraintEqualToAnchor:card.leadingAnchor],
233
+ [content.trailingAnchor constraintEqualToAnchor:card.trailingAnchor],
234
+ [content.topAnchor constraintEqualToAnchor:card.topAnchor],
235
+ [content.bottomAnchor constraintEqualToAnchor:card.bottomAnchor],
236
+ ]];
237
+ [self addView:card];
238
+ if (footer.length > 0) [self addFootnote:footer];
239
+ return card;
240
+ }
241
+
242
+ - (void)addView:(NSView *)view {
243
+ view.translatesAutoresizingMaskIntoConstraints = NO;
244
+ [self.stack addArrangedSubview:view];
245
+ [view.leadingAnchor constraintEqualToAnchor:self.stack.leadingAnchor].active = YES;
246
+ [view.trailingAnchor constraintEqualToAnchor:self.stack.trailingAnchor].active = YES;
247
+ }
248
+
249
+ - (NSTextField *)addFootnote:(NSString *)text {
250
+ NSTextField *note = CCPetsWrappingLabel(text, 11, NSFontWeightRegular, CCPetsTertiaryInkColor());
251
+ if (self.stack.arrangedSubviews.count > 0) {
252
+ [self.stack setCustomSpacing:8 afterView:self.stack.arrangedSubviews.lastObject];
253
+ }
254
+ note.translatesAutoresizingMaskIntoConstraints = NO;
255
+ [self.stack addArrangedSubview:note];
256
+ [note.leadingAnchor constraintEqualToAnchor:self.stack.leadingAnchor constant:2].active = YES;
257
+ [note.trailingAnchor constraintEqualToAnchor:self.stack.trailingAnchor constant:-2].active = YES;
258
+ return note;
259
+ }
260
+
261
+ - (void)removeAllContent {
262
+ for (NSView *view in [self.stack.arrangedSubviews copy]) {
263
+ [self.stack removeArrangedSubview:view];
264
+ [view removeFromSuperview];
265
+ }
266
+ }
267
+
268
+ @end
@@ -2,10 +2,14 @@
2
2
 
3
3
  extern NSString *const CCPetsPanelThemeKey;
4
4
  NSString *CCPetsPanelTheme(void);
5
- // 桌面小组件式玻璃背后压暗层的档位:0 / 15 / 25 / 45(百分比),默认 25。
5
+ // 桌面小组件式玻璃背后压暗层的不透明度(百分比),0–45 之间连续可调,默认 25。
6
+ // 主窗口用滑块连续调;右键菜单只列 CCPetsGlassDimLevels() 四档,勾选最接近当前值的那档。
6
7
  extern NSString *const CCPetsGlassDimKey;
8
+ extern const NSInteger CCPetsGlassDimMaximum;
7
9
  NSInteger CCPetsGlassDimLevel(void);
8
10
  NSArray<NSNumber *> *CCPetsGlassDimLevels(void);
11
+ // 四档里离 level 最近的一档;两档等距时取较小的。
12
+ NSInteger CCPetsNearestGlassDimLevel(NSInteger level);
9
13
  // 额度卡片衬底的不透明度,跟随压暗档位:卡片区域同时受背后压暗和衬底两层影响,
10
14
  // 衬底固定的话选「通透」时卡片仍然很深。
11
15
  CGFloat CCPetsGlassCardScrimAlpha(void);
@@ -12,23 +12,41 @@ NSString *CCPetsPanelTheme(void) {
12
12
 
13
13
  NSString *const CCPetsGlassDimKey = @"CCPetsGlassDim";
14
14
 
15
+ const NSInteger CCPetsGlassDimMaximum = 45;
16
+
15
17
  NSArray<NSNumber *> *CCPetsGlassDimLevels(void) { return @[@0, @15, @25, @45]; }
16
18
 
17
19
  // 档位来自对照实测:0 最通透但亮背景下小字看不清;25 在暗、亮壁纸上都基本可读;
18
- // 45 最清楚但明显偏暗。没设置过或值不在档位里时用 25。
20
+ // 45 最清楚但明显偏暗,再往上文字反而发闷,所以上限就是 45。没设置过时用 25;
21
+ // 超出范围的值(手改 defaults)夹回 0–45。
19
22
  NSInteger CCPetsGlassDimLevel(void) {
20
23
  id stored = [NSUserDefaults.standardUserDefaults objectForKey:CCPetsGlassDimKey];
21
24
  if (![stored isKindOfClass:NSNumber.class]) return 25;
22
- return [CCPetsGlassDimLevels() containsObject:stored] ? [stored integerValue] : 25;
25
+ double value = [stored doubleValue];
26
+ if (isnan(value)) return 25;
27
+ return MAX((NSInteger)0, MIN(CCPetsGlassDimMaximum, (NSInteger)lround(value)));
28
+ }
29
+
30
+ NSInteger CCPetsNearestGlassDimLevel(NSInteger level) {
31
+ NSInteger nearest = 0;
32
+ for (NSNumber *candidate in CCPetsGlassDimLevels()) {
33
+ if (labs(candidate.integerValue - level) < labs(nearest - level)) nearest = candidate.integerValue;
34
+ }
35
+ return nearest;
23
36
  }
24
37
 
38
+ // 衬底在四个档位上的取值是实测出来的(0.06 / 0.10 / 0.12 / 0.16),档位之间按直线插值,
39
+ // 滑块拖动时卡片深浅连续变化,不会在档位边界上跳一下。
25
40
  CGFloat CCPetsGlassCardScrimAlpha(void) {
26
- switch (CCPetsGlassDimLevel()) {
27
- case 0: return 0.06;
28
- case 15: return 0.10;
29
- case 45: return 0.16;
30
- default: return 0.12;
41
+ static const double levels[] = {0, 15, 25, 45};
42
+ static const double alphas[] = {0.06, 0.10, 0.12, 0.16};
43
+ double level = CCPetsGlassDimLevel();
44
+ for (int index = 1; index < 4; index++) {
45
+ if (level > levels[index]) continue;
46
+ double fraction = (level - levels[index - 1]) / (levels[index] - levels[index - 1]);
47
+ return alphas[index - 1] + (alphas[index] - alphas[index - 1]) * fraction;
31
48
  }
49
+ return alphas[3];
32
50
  }
33
51
 
34
52
  BOOL CCPetsLiquidGlassAvailable(void) {
@@ -0,0 +1,55 @@
1
+ #import <Cocoa/Cocoa.h>
2
+
3
+ // 主窗口:侧边栏 + 内容区的普通 App 窗口,放右键菜单装不下的设置和数据。
4
+ //
5
+ // 桌宠平时是 Accessory(没有 Dock 图标、不出现在 ⌘Tab),主窗口打开期间临时切成 Regular,
6
+ // 像普通 App 一样能切换、有菜单栏;最后一个普通窗口(主窗口、台词编辑器)关掉后切回去。
7
+ // 桌宠自己的浮窗都是 NSPanel,不计入"普通窗口"。
8
+ //
9
+ // 窗口懒创建,关闭即释放,不常驻内存;页面也只在显示时创建。
10
+
11
+ // 页面标识,也是 `cc-pets open <page>` 的参数。侧边栏分两组:
12
+ // 工作台(概览、会话、用量、宠物、多账号)和通用(提醒、设置),诊断单独放在底部。
13
+ extern NSString *const CCPetsMainWindowPageOverview;
14
+ extern NSString *const CCPetsMainWindowPageSessions;
15
+ extern NSString *const CCPetsMainWindowPageUsage;
16
+ extern NSString *const CCPetsMainWindowPagePet;
17
+ extern NSString *const CCPetsMainWindowPageAccounts;
18
+ extern NSString *const CCPetsMainWindowPageAlerts;
19
+ extern NSString *const CCPetsMainWindowPageGeneral;
20
+ extern NSString *const CCPetsMainWindowPageDiagnostics;
21
+
22
+ // 所有页面标识,按侧边栏顺序。`cc-pets open <page>` 用它列出可选页面。
23
+ NSArray<NSString *> *CCPetsMainWindowPageIDs(void);
24
+ // 把参数换成页面标识:认识的原样返回,旧名字换成新页面(settings 拆成三页前是一整页,
25
+ // 现在指向「宠物」),不认识的返回 nil。
26
+ NSString *CCPetsMainWindowResolvePage(NSString *page);
27
+
28
+ // 侧边栏顶部的宠物名片要的数据。由 AppDelegate 提供,窗口只读不写。
29
+ // 键:sheet(NSImage 精灵图)、rowCount、name、state(Agent 状态,无会话时 idle)、
30
+ // status(状态文字)、statusColor(NSColor)、detail(宠物口吻的那句,没有 Agent 在跑时没有)、
31
+ // sessions(在线会话数)、approvals(待审批数)。
32
+ @protocol CCPetsPetCardSource <NSObject>
33
+ - (NSDictionary *)petCardSnapshot;
34
+ @end
35
+
36
+ // 名片上的任何一项变了(换宠物、Agent 状态、会话数、审批数)就发,窗口收到后重读快照。
37
+ // 没有窗口时没人听,发一次只是一次空的广播。
38
+ extern NSNotificationName const CCPetsPetCardDidChangeNotification;
39
+
40
+ // 主窗口外观:system(跟随系统,默认)、light、dark。只管主窗口,桌宠的浮层不受影响。
41
+ // 存在这个键里,改了之后已打开的主窗口当场切换。
42
+ extern NSString *const CCPetsMainWindowAppearanceKey;
43
+ // 当前取值,不认识的值按 system 处理。
44
+ NSString *CCPetsMainWindowAppearancePreference(void);
45
+
46
+ @interface CCPetsMainWindowController : NSWindowController
47
+
48
+ // 打开(已开着就前置)并切到指定页面;page 为 nil 或不认识时打开上次看的页面。
49
+ + (void)presentPage:(NSString *)page;
50
+
51
+ // 点 Dock 图标时调用:主窗口最小化在 Dock 里(或随 App 隐藏)就把它恢复到前台。
52
+ // 没有主窗口时什么也不做,返回 NO。
53
+ + (BOOL)restoreFromDock;
54
+
55
+ @end