cc-pets 2.2.1 → 2.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.
Files changed (197) hide show
  1. package/CC_BRIDGE.md +24 -2
  2. package/CC_BRIDGE.zh-CN.md +19 -2
  3. package/CHANGELOG.md +111 -0
  4. package/CHANGELOG.zh-CN.md +111 -0
  5. package/CONTRIBUTING.md +35 -10
  6. package/CONTRIBUTING.zh-CN.md +28 -10
  7. package/README.md +212 -32
  8. package/README.zh-CN.md +167 -36
  9. package/Resources/AgentIcons/claude.png +0 -0
  10. package/Resources/AgentIcons/codex.icns +0 -0
  11. package/Resources/IDEPlugins/cc-pets-terminal.vsix +0 -0
  12. package/Resources/IDEPlugins/cc-pets-terminal.zip +0 -0
  13. package/Resources/zh-Hans.lproj/Localizable.strings +699 -20
  14. package/Sources/CCPets/{CCPetsAppDelegate+AgentEvents.m → App/CCPetsAppDelegate+AgentEvents.m} +15 -5
  15. package/Sources/CCPets/{CCPetsAppDelegate+AgentStatus.m → App/CCPetsAppDelegate+AgentStatus.m} +90 -25
  16. package/Sources/CCPets/{CCPetsAppDelegate+Bridge.m → App/CCPetsAppDelegate+Bridge.m} +35 -24
  17. package/Sources/CCPets/{CCPetsAppDelegate+Pets.m → App/CCPetsAppDelegate+Pets.m} +17 -3
  18. package/Sources/CCPets/{CCPetsAppDelegate+Private.h → App/CCPetsAppDelegate+Private.h} +71 -23
  19. package/Sources/CCPets/App/CCPetsAppDelegate+Profiles.m +238 -0
  20. package/Sources/CCPets/{CCPetsAppDelegate+Quota.m → App/CCPetsAppDelegate+Quota.m} +47 -32
  21. package/Sources/CCPets/{CCPetsAppDelegate+Settings.m → App/CCPetsAppDelegate+Settings.m} +87 -102
  22. package/Sources/CCPets/{CCPetsAppDelegate+Speech.m → App/CCPetsAppDelegate+Speech.m} +121 -51
  23. package/Sources/CCPets/App/CCPetsAppDelegate+Workbench.m +139 -0
  24. package/Sources/CCPets/{CCPetsAppDelegate.h → App/CCPetsAppDelegate.h} +17 -2
  25. package/Sources/CCPets/{CCPetsAppDelegate.m → App/CCPetsAppDelegate.m} +107 -11
  26. package/Sources/CCPets/App/CCPetsOpenCommand.h +13 -0
  27. package/Sources/CCPets/App/CCPetsOpenCommand.m +99 -0
  28. package/Sources/CCPets/{main.m → App/main.m} +74 -1
  29. package/Sources/CCPets/{CCPetsBridge.h → Bridge/CCPetsBridge.h} +17 -4
  30. package/Sources/CCPets/{CCPetsBridge.m → Bridge/CCPetsBridge.m} +43 -23
  31. package/Sources/CCPets/Bridge/CCPetsBridgeCLI.h +10 -0
  32. package/Sources/CCPets/Bridge/CCPetsBridgeCLI.m +832 -0
  33. package/Sources/CCPets/Bridge/CCPetsBridgeCore.h +59 -0
  34. package/Sources/CCPets/Bridge/CCPetsBridgeCore.m +576 -0
  35. package/Sources/CCPets/Bridge/CCPetsBridgeSetup.h +24 -0
  36. package/Sources/CCPets/Bridge/CCPetsBridgeSetup.m +507 -0
  37. package/Sources/CCPets/Bridge/CCPetsBridgeStore.h +106 -0
  38. package/Sources/CCPets/Bridge/CCPetsBridgeStore.m +897 -0
  39. package/Sources/CCPets/Integrations/CCPetsCLISupport.h +75 -0
  40. package/Sources/CCPets/Integrations/CCPetsCLISupport.m +342 -0
  41. package/Sources/CCPets/Integrations/CCPetsEvents.h +15 -0
  42. package/Sources/CCPets/{CCPetsEvents.m → Integrations/CCPetsEvents.m} +23 -0
  43. package/Sources/CCPets/Integrations/CCPetsIDEIntegration.h +21 -0
  44. package/Sources/CCPets/Integrations/CCPetsIDEIntegration.m +503 -0
  45. package/Sources/CCPets/Integrations/CCPetsIntegrations.h +51 -0
  46. package/Sources/CCPets/Integrations/CCPetsIntegrations.m +662 -0
  47. package/Sources/CCPets/Integrations/CCPetsLaunchPreflight.h +5 -0
  48. package/Sources/CCPets/Integrations/CCPetsLaunchPreflight.m +367 -0
  49. package/Sources/CCPets/Integrations/CCPetsProfiles.h +38 -0
  50. package/Sources/CCPets/Integrations/CCPetsProfiles.m +516 -0
  51. package/Sources/CCPets/{CCPetsTerminalFocus.h → Integrations/CCPetsTerminalFocus.h} +2 -1
  52. package/Sources/CCPets/{CCPetsTerminalFocus.m → Integrations/CCPetsTerminalFocus.m} +148 -36
  53. package/Sources/CCPets/Integrations/CCPetsTerminalIntegration.h +17 -0
  54. package/Sources/CCPets/Integrations/CCPetsTerminalIntegration.m +64 -0
  55. package/Sources/CCPets/Integrations/CCPetsVSCodeIntegration.h +23 -0
  56. package/Sources/CCPets/Integrations/CCPetsVSCodeIntegration.m +475 -0
  57. package/Sources/CCPets/Pet/CCPetsPetStore.h +12 -0
  58. package/Sources/CCPets/Pet/CCPetsPetStore.m +476 -0
  59. package/Sources/CCPets/{CCPetsPhrases.h → Pet/CCPetsPhrases.h} +11 -2
  60. package/Sources/CCPets/{CCPetsPhrases.m → Pet/CCPetsPhrases.m} +19 -2
  61. package/Sources/CCPets/{CCPetsPhrasesEditor.m → Pet/CCPetsPhrasesEditor.m} +4 -1
  62. package/Sources/CCPets/Pet/PetView+Interaction.m +207 -0
  63. package/Sources/CCPets/Pet/PetView+Menu.m +598 -0
  64. package/Sources/CCPets/Pet/PetView+MicroBehavior.m +234 -0
  65. package/Sources/CCPets/Pet/PetView+Private.h +81 -0
  66. package/Sources/CCPets/{PetView.h → Pet/PetView.h} +3 -5
  67. package/Sources/CCPets/Pet/PetView.m +635 -0
  68. package/Sources/CCPets/Support/CCPetsDoctor.h +25 -0
  69. package/Sources/CCPets/Support/CCPetsDoctor.m +646 -0
  70. package/Sources/CCPets/Support/CCPetsJSON.h +27 -0
  71. package/Sources/CCPets/Support/CCPetsJSON.m +397 -0
  72. package/Sources/CCPets/{CCPetsL10n.h → Support/CCPetsL10n.h} +3 -1
  73. package/Sources/CCPets/{CCPetsL10n.m → Support/CCPetsL10n.m} +30 -1
  74. package/Sources/CCPets/Support/CCPetsPreferences.h +33 -0
  75. package/Sources/CCPets/Support/CCPetsPreferences.m +117 -0
  76. package/Sources/CCPets/UI/CCPetsDiagnosticsPage.h +25 -0
  77. package/Sources/CCPets/UI/CCPetsDiagnosticsPage.m +440 -0
  78. package/Sources/CCPets/UI/CCPetsFormBuilder.h +44 -0
  79. package/Sources/CCPets/UI/CCPetsFormBuilder.m +279 -0
  80. package/Sources/CCPets/UI/CCPetsGlassView.h +57 -0
  81. package/Sources/CCPets/{CCPetsGlassView.m → UI/CCPetsGlassView.m} +60 -11
  82. package/Sources/CCPets/UI/CCPetsMainWindow.h +55 -0
  83. package/Sources/CCPets/UI/CCPetsMainWindow.m +730 -0
  84. package/Sources/CCPets/UI/CCPetsSettingsPage.h +64 -0
  85. package/Sources/CCPets/UI/CCPetsSettingsPage.m +1412 -0
  86. package/Sources/CCPets/UI/CCPetsUIStyle.h +135 -0
  87. package/Sources/CCPets/UI/CCPetsUIStyle.m +865 -0
  88. package/Sources/CCPets/UI/CCPetsUsageChartView.h +15 -0
  89. package/Sources/CCPets/UI/CCPetsUsageChartView.m +288 -0
  90. package/Sources/CCPets/UI/CCPetsUsagePage.h +32 -0
  91. package/Sources/CCPets/UI/CCPetsUsagePage.m +712 -0
  92. package/Sources/CCPets/UI/CCPetsUsageShared.h +53 -0
  93. package/Sources/CCPets/UI/CCPetsUsageStore.m +120 -0
  94. package/Sources/CCPets/UI/CCPetsUsageWidgets.h +30 -0
  95. package/Sources/CCPets/UI/CCPetsUsageWidgets.m +201 -0
  96. package/Sources/CCPets/UI/CCPetsWorkbench.h +40 -0
  97. package/Sources/CCPets/UI/CCPetsWorkbenchPages.h +13 -0
  98. package/Sources/CCPets/UI/CCPetsWorkbenchPages.m +783 -0
  99. package/Sources/CCPets/{MenuToggleSwitch.m → UI/MenuToggleSwitch.m} +1 -0
  100. package/Sources/CCPets/{CCPetsCodexRateLimits.h → Usage/CCPetsCodexRateLimits.h} +1 -0
  101. package/Sources/CCPets/{CCPetsCodexRateLimits.m → Usage/CCPetsCodexRateLimits.m} +10 -3
  102. package/Sources/CCPets/{CCPetsQuotaHistory.h → Usage/CCPetsQuotaHistory.h} +3 -0
  103. package/Sources/CCPets/{CCPetsQuotaHistory.m → Usage/CCPetsQuotaHistory.m} +58 -0
  104. package/Sources/CCPets/Usage/CCPetsUsage+ClaudeReader.m +436 -0
  105. package/Sources/CCPets/Usage/CCPetsUsage+CodexBackground.m +193 -0
  106. package/Sources/CCPets/Usage/CCPetsUsage+CodexReader.m +392 -0
  107. package/Sources/CCPets/Usage/CCPetsUsage+CodexSessions.m +484 -0
  108. package/Sources/CCPets/Usage/CCPetsUsage+Internal.h +97 -0
  109. package/Sources/CCPets/Usage/CCPetsUsage+Models.m +323 -0
  110. package/Sources/CCPets/Usage/CCPetsUsage+TokenTotals.m +655 -0
  111. package/Sources/CCPets/Usage/CCPetsUsage.h +58 -0
  112. package/Sources/CCPets/Usage/CCPetsUsage.m +225 -0
  113. package/Sources/CCPets/Usage/CCPetsUsageMode.h +10 -0
  114. package/Sources/CCPets/Usage/CCPetsUsageMode.m +163 -0
  115. package/Sources/CCPets/{CCPetsUsageMonitor.h → Usage/CCPetsUsageMonitor.h} +3 -0
  116. package/Sources/CCPets/{CCPetsUsageMonitor.m → Usage/CCPetsUsageMonitor.m} +174 -19
  117. package/Sources/CCPets/Usage/QuotaDashboardView+Primitives.m +328 -0
  118. package/Sources/CCPets/Usage/QuotaDashboardView+Private.h +103 -0
  119. package/Sources/CCPets/Usage/QuotaDashboardView+Rendering.m +598 -0
  120. package/Sources/CCPets/{QuotaDashboardView.h → Usage/QuotaDashboardView.h} +17 -0
  121. package/Sources/CCPets/Usage/QuotaDashboardView.m +713 -0
  122. package/THIRD_PARTY_NOTICES.md +8 -4
  123. package/THIRD_PARTY_NOTICES.zh-CN.md +6 -2
  124. package/bin/cc-pets +8 -6
  125. package/bin/claude-with-pet +12 -2
  126. package/bin/codex-with-pet +15 -5
  127. package/package.json +5 -1
  128. package/plugins/jetbrains/README.md +62 -0
  129. package/plugins/jetbrains/src/main/java/com/ccpets/terminal/TerminalBridge.java +379 -0
  130. package/plugins/jetbrains/src/main/java/com/ccpets/terminal/TerminalIdentity.java +24 -0
  131. package/plugins/jetbrains/src/main/java/com/ccpets/terminal/TerminalStartup.java +12 -0
  132. package/plugins/jetbrains/src/main/resources/META-INF/plugin.xml +23 -0
  133. package/plugins/jetbrains/src/main/resources/META-INF/pluginIcon.svg +380 -0
  134. package/plugins/vscode/README.md +63 -0
  135. package/plugins/vscode/extension.js +210 -0
  136. package/plugins/vscode/package.json +18 -0
  137. package/scripts/build-idea-plugin.sh +101 -0
  138. package/scripts/build-vscode-extension.sh +112 -0
  139. package/scripts/build.sh +31 -5
  140. package/scripts/compile-cached.zsh +133 -0
  141. package/scripts/i18n.zsh +9 -52
  142. package/scripts/install-app.sh +4 -0
  143. package/scripts/install-shell-integration.sh +17 -10
  144. package/scripts/uninstall-shell-integration.sh +6 -1
  145. package/Sources/CCPets/CCPetsEvents.h +0 -10
  146. package/Sources/CCPets/CCPetsGlassView.h +0 -31
  147. package/Sources/CCPets/CCPetsUsage.h +0 -36
  148. package/Sources/CCPets/CCPetsUsage.m +0 -2069
  149. package/Sources/CCPets/PetView.m +0 -1839
  150. package/Sources/CCPets/QuotaDashboardView.m +0 -1145
  151. package/scripts/bridge/cli.mjs +0 -237
  152. package/scripts/bridge/core.mjs +0 -228
  153. package/scripts/bridge/hook.mjs +0 -150
  154. package/scripts/bridge/install.mjs +0 -311
  155. package/scripts/bridge/mcp-server.mjs +0 -308
  156. package/scripts/bridge/options.mjs +0 -87
  157. package/scripts/bridge/process.mjs +0 -151
  158. package/scripts/bridge/reservations.mjs +0 -248
  159. package/scripts/bridge/store.mjs +0 -433
  160. package/scripts/bridge/watch.mjs +0 -69
  161. package/scripts/check-l10n.mjs +0 -168
  162. package/scripts/configure-updater.mjs +0 -43
  163. package/scripts/detect-cli.mjs +0 -68
  164. package/scripts/doctor.mjs +0 -470
  165. package/scripts/i18n.mjs +0 -122
  166. package/scripts/install-claude-hooks.mjs +0 -253
  167. package/scripts/install-codex-hooks.mjs +0 -78
  168. package/scripts/integration-markers.mjs +0 -51
  169. package/scripts/locales/zh-Hans.json +0 -366
  170. package/scripts/pet-store.mjs +0 -415
  171. package/scripts/uninstall-integrations.mjs +0 -205
  172. /package/Sources/CCPets/{CCPetsAppDelegate+Update.m → App/CCPetsAppDelegate+Update.m} +0 -0
  173. /package/Sources/CCPets/{CCPetsVersion.h → App/CCPetsVersion.h} +0 -0
  174. /package/Sources/CCPets/{CCPetsVersion.m → App/CCPetsVersion.m} +0 -0
  175. /package/Sources/CCPets/{CCPetsImageLoader.h → Pet/CCPetsImageLoader.h} +0 -0
  176. /package/Sources/CCPets/{CCPetsImageLoader.m → Pet/CCPetsImageLoader.m} +0 -0
  177. /package/Sources/CCPets/{CCPetsPetSize.h → Pet/CCPetsPetSize.h} +0 -0
  178. /package/Sources/CCPets/{CCPetsPetSize.m → Pet/CCPetsPetSize.m} +0 -0
  179. /package/Sources/CCPets/{CCPetsPhrasesEditor.h → Pet/CCPetsPhrasesEditor.h} +0 -0
  180. /package/Sources/CCPets/{CCPetsPreviews.h → Pet/CCPetsPreviews.h} +0 -0
  181. /package/Sources/CCPets/{CCPetsPreviews.m → Pet/CCPetsPreviews.m} +0 -0
  182. /package/Sources/CCPets/Resources/{/351/273/230/350/256/244.webp" → ByteMochi.webp} +0 -0
  183. /package/Sources/CCPets/{CCPetsCleanup.h → Support/CCPetsCleanup.h} +0 -0
  184. /package/Sources/CCPets/{CCPetsCleanup.m → Support/CCPetsCleanup.m} +0 -0
  185. /package/Sources/CCPets/{CCPetsPaths.h → Support/CCPetsPaths.h} +0 -0
  186. /package/Sources/CCPets/{CCPetsPaths.m → Support/CCPetsPaths.m} +0 -0
  187. /package/Sources/CCPets/{CCPetsSystemMonitor.h → Support/CCPetsSystemMonitor.h} +0 -0
  188. /package/Sources/CCPets/{CCPetsSystemMonitor.m → Support/CCPetsSystemMonitor.m} +0 -0
  189. /package/Sources/CCPets/{CCPetsGlassMenu.h → UI/CCPetsGlassMenu.h} +0 -0
  190. /package/Sources/CCPets/{CCPetsGlassMenu.m → UI/CCPetsGlassMenu.m} +0 -0
  191. /package/Sources/CCPets/{MenuChoiceRow.h → UI/MenuChoiceRow.h} +0 -0
  192. /package/Sources/CCPets/{MenuChoiceRow.m → UI/MenuChoiceRow.m} +0 -0
  193. /package/Sources/CCPets/{MenuHintView.h → UI/MenuHintView.h} +0 -0
  194. /package/Sources/CCPets/{MenuHintView.m → UI/MenuHintView.m} +0 -0
  195. /package/Sources/CCPets/{MenuPetSizeView.h → UI/MenuPetSizeView.h} +0 -0
  196. /package/Sources/CCPets/{MenuPetSizeView.m → UI/MenuPetSizeView.m} +0 -0
  197. /package/Sources/CCPets/{MenuToggleSwitch.h → UI/MenuToggleSwitch.h} +0 -0
@@ -0,0 +1,279 @@
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
+ static void FillCardContent(NSStackView *content, NSArray<NSView *> *rows) {
210
+ for (NSView *view in content.arrangedSubviews.copy) [view removeFromSuperview];
211
+ for (NSView *row in rows) {
212
+ if (content.arrangedSubviews.count > 0) {
213
+ NSView *separator = [CCPetsFormBuilder separator];
214
+ [content addArrangedSubview:separator];
215
+ [separator.leadingAnchor constraintEqualToAnchor:content.leadingAnchor constant:14].active = YES;
216
+ [separator.trailingAnchor constraintEqualToAnchor:content.trailingAnchor].active = YES;
217
+ }
218
+ [content addArrangedSubview:row];
219
+ [row.leadingAnchor constraintEqualToAnchor:content.leadingAnchor].active = YES;
220
+ [row.trailingAnchor constraintEqualToAnchor:content.trailingAnchor].active = YES;
221
+ }
222
+ }
223
+
224
+ + (void)replaceRowsInCard:(NSView *)card withRows:(NSArray<NSView *> *)rows {
225
+ for (NSView *content in card.subviews) {
226
+ if ([content isKindOfClass:NSStackView.class]) { FillCardContent((NSStackView *)content, rows); return; }
227
+ }
228
+ }
229
+
230
+ - (NSView *)addGroupWithTitle:(NSString *)title rows:(NSArray<NSView *> *)rows footer:(NSString *)footer {
231
+ if (title.length > 0) [self addGroupTitle:title note:nil];
232
+
233
+ NSStackView *content = [NSStackView stackViewWithViews:@[]];
234
+ content.orientation = NSUserInterfaceLayoutOrientationVertical;
235
+ content.spacing = 0;
236
+ content.translatesAutoresizingMaskIntoConstraints = NO;
237
+ FillCardContent(content, rows);
238
+
239
+ CCPetsCardView *card = [CCPetsCardView new];
240
+ card.translatesAutoresizingMaskIntoConstraints = NO;
241
+ [card addSubview:content];
242
+ [NSLayoutConstraint activateConstraints:@[
243
+ [content.leadingAnchor constraintEqualToAnchor:card.leadingAnchor],
244
+ [content.trailingAnchor constraintEqualToAnchor:card.trailingAnchor],
245
+ [content.topAnchor constraintEqualToAnchor:card.topAnchor],
246
+ [content.bottomAnchor constraintEqualToAnchor:card.bottomAnchor],
247
+ ]];
248
+ [self addView:card];
249
+ if (footer.length > 0) [self addFootnote:footer];
250
+ return card;
251
+ }
252
+
253
+ - (void)addView:(NSView *)view {
254
+ view.translatesAutoresizingMaskIntoConstraints = NO;
255
+ [self.stack addArrangedSubview:view];
256
+ [view.leadingAnchor constraintEqualToAnchor:self.stack.leadingAnchor].active = YES;
257
+ [view.trailingAnchor constraintEqualToAnchor:self.stack.trailingAnchor].active = YES;
258
+ }
259
+
260
+ - (NSTextField *)addFootnote:(NSString *)text {
261
+ NSTextField *note = CCPetsWrappingLabel(text, 11, NSFontWeightRegular, CCPetsTertiaryInkColor());
262
+ if (self.stack.arrangedSubviews.count > 0) {
263
+ [self.stack setCustomSpacing:8 afterView:self.stack.arrangedSubviews.lastObject];
264
+ }
265
+ note.translatesAutoresizingMaskIntoConstraints = NO;
266
+ [self.stack addArrangedSubview:note];
267
+ [note.leadingAnchor constraintEqualToAnchor:self.stack.leadingAnchor constant:2].active = YES;
268
+ [note.trailingAnchor constraintEqualToAnchor:self.stack.trailingAnchor constant:-2].active = YES;
269
+ return note;
270
+ }
271
+
272
+ - (void)removeAllContent {
273
+ for (NSView *view in [self.stack.arrangedSubviews copy]) {
274
+ [self.stack removeArrangedSubview:view];
275
+ [view removeFromSuperview];
276
+ }
277
+ }
278
+
279
+ @end
@@ -0,0 +1,57 @@
1
+ #import <Cocoa/Cocoa.h>
2
+
3
+ extern NSString *const CCPetsPanelThemeKey;
4
+ NSString *CCPetsPanelTheme(void);
5
+ // 桌面小组件式玻璃背后压暗层的实际不透明度(百分比),0–45 之间连续可调,默认 25。
6
+ // 界面上统一换算成 0–100 的“强度”展示:100 对应实际 45。
7
+ // 主窗口用滑块连续调;右键菜单只列 CCPetsGlassDimLevels() 四档,勾选最接近当前值的那档。
8
+ extern NSString *const CCPetsGlassDimKey;
9
+ extern const NSInteger CCPetsGlassDimMaximum;
10
+ // 实际不透明度百分比(0–45,可带小数)。
11
+ double CCPetsGlassDimLevel(void);
12
+ // 展示用强度(0–100)。
13
+ NSInteger CCPetsGlassDimPercent(void);
14
+ // 强度(0–100)换算成实际不透明度百分比(0–45)。
15
+ double CCPetsGlassDimLevelForPercent(double percent);
16
+ // 菜单四档,单位是展示强度(0–100)。
17
+ NSArray<NSNumber *> *CCPetsGlassDimLevels(void);
18
+ // 四档里离 percent 最近的一档;两档等距时取较小的。
19
+ NSInteger CCPetsNearestGlassDimLevel(NSInteger percent);
20
+ // 额度卡片衬底的不透明度,跟随压暗档位:卡片区域同时受背后压暗和衬底两层影响,
21
+ // 衬底固定的话选「通透」时卡片仍然很深。
22
+ CGFloat CCPetsGlassCardScrimAlpha(void);
23
+ // 同上,但按传入的实际压暗值(0–45)计算;设置页预览拖动滑块时用。
24
+ CGFloat CCPetsGlassCardScrimAlphaForLevel(double level);
25
+
26
+ // 宠物说话气泡的样式:真实气泡和设置页的 Liquid Glass 预览共用,改一处两边同步。
27
+ static const CGFloat CCPetsSpeechBubbleHeight = 38.0;
28
+ static const CGFloat CCPetsSpeechBubblePadding = 16.0;
29
+ static const CGFloat CCPetsSpeechBubbleFontSize = 13.0;
30
+ static const CGFloat CCPetsSpeechBubbleEdgeShadeHeight = 9.0;
31
+ static const CGFloat CCPetsSpeechBubbleEdgeShadeAlpha = 0.6;
32
+ // 玻璃上白字的贴字形投影(状态卡、气泡、额度面板一致)。
33
+ NSShadow *CCPetsGlassTextShadow(void);
34
+ // 运行系统和构建 SDK 都支持 NSGlassEffectView 时才为 YES。
35
+ BOOL CCPetsLiquidGlassAvailable(void);
36
+
37
+ // 固定的内容容器使主题切换不影响文字、按钮和悬停状态。
38
+ @interface CCPetsGlassView : NSView
39
+ @property(nonatomic, readonly) NSView *contentView;
40
+ @property(nonatomic, readonly) BOOL usesLiquidGlass;
41
+ @property(nonatomic) CGFloat cornerRadius;
42
+ // 桌面小组件式玻璃:背景清晰、边缘折射,并在玻璃背后垫一层压暗托住白字。只适合白字面板。
43
+ @property(nonatomic) BOOL usesWidgetGlass;
44
+ // 上下沿压高光暗带的高度和最深处不透明度,默认 12pt / 0.6(额度面板实测值)。
45
+ // 胶囊形的状态卡、气泡比较矮,要在设置 usesWidgetGlass 之前调小。
46
+ @property(nonatomic) CGFloat edgeShadeHeight;
47
+ @property(nonatomic) CGFloat edgeShadeAlpha;
48
+ // 不看当前主题,始终用原生玻璃(设置页的 Liquid Glass 预览用);系统不支持时仍退回磨砂。
49
+ @property(nonatomic) BOOL forcesLiquidGlass;
50
+ - (instancetype)initWithFrame:(NSRect)frame material:(NSVisualEffectMaterial)material
51
+ appearance:(NSAppearanceName)appearance cornerRadius:(CGFloat)cornerRadius;
52
+ - (void)applyTheme;
53
+ // 只按当前档位更新压暗层透明度,不重建玻璃。
54
+ - (void)applyDimLevel;
55
+ // 按指定的实际压暗值(0–45)更新压暗层,不读偏好;预览拖动滑块时用。
56
+ - (void)applyDimLevel:(double)level;
57
+ @end
@@ -12,23 +12,62 @@ NSString *CCPetsPanelTheme(void) {
12
12
 
13
13
  NSString *const CCPetsGlassDimKey = @"CCPetsGlassDim";
14
14
 
15
- NSArray<NSNumber *> *CCPetsGlassDimLevels(void) { return @[@0, @15, @25, @45]; }
15
+ const NSInteger CCPetsGlassDimMaximum = 45;
16
+
17
+ NSArray<NSNumber *> *CCPetsGlassDimLevels(void) { return @[@0, @25, @50, @100]; }
16
18
 
17
19
  // 档位来自对照实测:0 最通透但亮背景下小字看不清;25 在暗、亮壁纸上都基本可读;
18
- // 45 最清楚但明显偏暗。没设置过或值不在档位里时用 25。
19
- NSInteger CCPetsGlassDimLevel(void) {
20
+ // 45 最清楚但明显偏暗,再往上文字反而发闷,所以上限就是 45。没设置过时用 25;
21
+ // 超出范围的值(手改 defaults)夹回 0–45。界面按 0–100 展示,存的仍是实际值,可带小数
22
+ // (菜单的 25 / 50 档对应实际 11.25 / 22.5)。
23
+ double CCPetsGlassDimLevel(void) {
20
24
  id stored = [NSUserDefaults.standardUserDefaults objectForKey:CCPetsGlassDimKey];
21
25
  if (![stored isKindOfClass:NSNumber.class]) return 25;
22
- return [CCPetsGlassDimLevels() containsObject:stored] ? [stored integerValue] : 25;
26
+ double value = [stored doubleValue];
27
+ if (isnan(value)) return 25;
28
+ return MAX(0.0, MIN((double)CCPetsGlassDimMaximum, value));
29
+ }
30
+
31
+ NSInteger CCPetsGlassDimPercent(void) {
32
+ return lround(CCPetsGlassDimLevel() * 100.0 / CCPetsGlassDimMaximum);
33
+ }
34
+
35
+ double CCPetsGlassDimLevelForPercent(double percent) {
36
+ return MAX(0.0, MIN(100.0, percent)) * CCPetsGlassDimMaximum / 100.0;
37
+ }
38
+
39
+ NSInteger CCPetsNearestGlassDimLevel(NSInteger percent) {
40
+ NSInteger nearest = 0;
41
+ for (NSNumber *candidate in CCPetsGlassDimLevels()) {
42
+ if (labs(candidate.integerValue - percent) < labs(nearest - percent)) nearest = candidate.integerValue;
43
+ }
44
+ return nearest;
45
+ }
46
+
47
+ // 衬底在四个档位上的取值是实测出来的(0.06 / 0.10 / 0.12 / 0.16),档位之间按直线插值,
48
+ // 滑块拖动时卡片深浅连续变化,不会在档位边界上跳一下。
49
+ NSShadow *CCPetsGlassTextShadow(void) {
50
+ NSShadow *shadow = [NSShadow new];
51
+ shadow.shadowColor = [NSColor colorWithWhite:0 alpha:0.45];
52
+ shadow.shadowBlurRadius = 2;
53
+ shadow.shadowOffset = NSMakeSize(0, -0.5);
54
+ return shadow;
23
55
  }
24
56
 
25
57
  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;
58
+ return CCPetsGlassCardScrimAlphaForLevel(CCPetsGlassDimLevel());
59
+ }
60
+
61
+ CGFloat CCPetsGlassCardScrimAlphaForLevel(double level) {
62
+ static const double levels[] = {0, 15, 25, 45};
63
+ static const double alphas[] = {0.06, 0.10, 0.12, 0.16};
64
+ level = MAX(0.0, MIN((double)CCPetsGlassDimMaximum, level));
65
+ for (int index = 1; index < 4; index++) {
66
+ if (level > levels[index]) continue;
67
+ double fraction = (level - levels[index - 1]) / (levels[index] - levels[index - 1]);
68
+ return alphas[index - 1] + (alphas[index] - alphas[index - 1]) * fraction;
31
69
  }
70
+ return alphas[3];
32
71
  }
33
72
 
34
73
  BOOL CCPetsLiquidGlassAvailable(void) {
@@ -126,7 +165,7 @@ BOOL CCPetsLiquidGlassAvailable(void) {
126
165
  // 编译期和运行期双重保护,仍能用旧 SDK 构建并在 macOS 13 上运行。
127
166
  #if __MAC_OS_X_VERSION_MAX_ALLOWED >= 260000
128
167
  if (@available(macOS 26.0, *)) {
129
- if ([CCPetsPanelTheme() isEqualToString:@"liquid"]) {
168
+ if (self.forcesLiquidGlass || [CCPetsPanelTheme() isEqualToString:@"liquid"]) {
130
169
  NSGlassEffectView *glass = [[NSGlassEffectView alloc] initWithFrame:self.bounds];
131
170
  glass.style = self.usesWidgetGlass
132
171
  ? NSGlassEffectViewStyleClear : NSGlassEffectViewStyleRegular;
@@ -218,11 +257,21 @@ static BOOL CCPetsExperimentalGlassVariantEnabled(void) {
218
257
  #endif
219
258
 
220
259
  - (void)applyDimLevel {
221
- CGFloat alpha = CCPetsGlassDimLevel() / 100.0;
260
+ [self applyDimLevel:CCPetsGlassDimLevel()];
261
+ }
262
+
263
+ - (void)applyDimLevel:(double)level {
264
+ CGFloat alpha = level / 100.0;
222
265
  self.backdropDimView.layer.backgroundColor = [NSColor colorWithWhite:0 alpha:alpha].CGColor;
223
266
  self.backdropDimView.hidden = alpha <= 0;
224
267
  }
225
268
 
269
+ - (void)setForcesLiquidGlass:(BOOL)forcesLiquidGlass {
270
+ if (_forcesLiquidGlass == forcesLiquidGlass) return;
271
+ _forcesLiquidGlass = forcesLiquidGlass;
272
+ [self applyTheme];
273
+ }
274
+
226
275
  - (void)setUsesWidgetGlass:(BOOL)usesWidgetGlass {
227
276
  if (_usesWidgetGlass == usesWidgetGlass) return;
228
277
  _usesWidgetGlass = usesWidgetGlass;
@@ -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