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
package/README.zh-CN.md CHANGED
@@ -1,5 +1,5 @@
1
1
  <p align="center">
2
- <img src="docs/images/cover.png" alt="CC Pets v2.2.1:宠物大小调整与台词来源选择">
2
+ <img src="docs/images/cover.png" alt="CC Pets v2.4.0:终端精准跳转、启动保护与用量改进">
3
3
  </p>
4
4
 
5
5
  # CC Pets
@@ -9,24 +9,21 @@
9
9
  一个不依赖 Codex/Claude 桌面端的 macOS 原生桌宠。直接启动桌面端,或启动 Codex CLI / Claude Code CLI 时自动出现,
10
10
  并通过 Codex App Server 官方接口与 Claude Code 官方 status line 数据读取 5 小时额度、周额度和周重置时间。
11
11
 
12
- ## v2.2.1 新功能
12
+ ## v2.4.0 新功能
13
13
 
14
- - **宠物大小调整**:右键「宠物大小」可实时缩放至 50%~200%,设置自动保存;
15
- 小尺寸宠物的状态卡与气泡同比例缩小,并修复 Retina 屏幕上的精灵图模糊。
16
- - **台词来源选择**:「碎碎念 → 台词来源」可选择「专属台词」或「默认台词」,
17
- 立即生效,切换宠物和重启后仍保留。
18
- - **菜单与编辑器修复**:单选后菜单保持展开、勾选即时更新,长英文标题完整显示;
19
- 台词编辑器切换语言时统一刷新文案,并保留未保存的编辑。
14
+ - **终端精准跳转**:支持 VS Code 及其分支、JetBrains、Ghostty 和 iTerm2,
15
+ 在设置页集中管理权限和终端扩展。
16
+ - **启动保护与 CC Bridge**:可选 Shadowrocket 出口检查,会话身份匹配更严格,
17
+ 未确认的信箱消息可恢复。
18
+ - **用量与宠物管理**:修复 Codex Token 计数、补充后台用量,按账号提醒低额度,
19
+ 更新外观设置,并支持删除自定义宠物。
20
20
 
21
- 完整改动见 [更新记录](./CHANGELOG.zh-CN.md) 和 [Release Note](./docs/release-notes-v2.2.1.md)。
21
+ 完整改动见 [更新记录](./CHANGELOG.zh-CN.md) 和 [Release Note](./docs/release-notes-v2.4.0.md)。
22
22
 
23
23
  ## 界面预览
24
24
 
25
- 简体中文:额度面板与右键菜单。
26
-
27
25
  <p align="center">
28
- <img src="docs/images/liquid-glass-panel.png" width="45%" alt="Liquid Glass 主题下的中文额度面板">
29
- <img src="docs/images/liquid-glass-menu.png" width="45%" alt="中文右键菜单与面板主题子菜单">
26
+ <img src="docs/images/liquid-glass-panel.png" width="48%" alt="Liquid Glass 主题下的中文额度面板"> <img src="docs/images/liquid-glass-menu.png" width="48%" alt="中文右键菜单与面板主题子菜单">
30
27
  </p>
31
28
 
32
29
  ## 功能
@@ -52,10 +49,73 @@
52
49
  - 可选记录最近 7 天的本地额度历史,并在额度卡片中显示趋势
53
50
  - 可分别启用任务完成、失败、等待审批和响应超时的 macOS 系统通知
54
51
  - 内置一个原创素材,更多桌宠可从兼容 PetDex 的素材源按需下载到本机
52
+ - 提供普通的主菜单:概览、会话与 CC Bridge 消息、按模型的 Token 用量、全部设置和内置诊断(见[主菜单](#主菜单))
55
53
  - 使用原生 AppKit,运行时不依赖 Electron
56
54
 
55
+ ## 主菜单
56
+
57
+ 除了右键菜单和悬停额度面板,CC Pets 还有一个普通的 App 窗口,集中看会话、用量和设置。
58
+ 从右键菜单(**主菜单**)、应用菜单或终端都能打开:
59
+
60
+ ```bash
61
+ cc-pets open # 上次看的页面
62
+ cc-pets open overview
63
+ cc-pets open sessions
64
+ cc-pets open usage
65
+ cc-pets open accounts
66
+ cc-pets open general # 还有 pet、accounts、alerts、diagnostics
67
+ ```
68
+
69
+ <p align="center">
70
+ <img src="docs/images/main-menu-overview.png" width="48%" alt="主菜单概览页:宠物、今日 Token 用量和各账号额度卡片">
71
+ <img src="docs/images/main-menu-usage.png" width="48%" alt="主菜单用量页:按模型堆叠的近 30 天每日用量图和模型明细表">
72
+ </p>
73
+
74
+ - **侧边栏**:顶部是会动的当前宠物和它的状态,下面分两组:**工作台**(概览、会话、用量、宠物、多账号)
75
+ 和**通用**(提醒、设置)。诊断放在最底下,有问题要处理时带角标。
76
+ - **概览**:宠物和它此刻在做什么,今日总用量和输入、输出、缓存输入、请求数,诊断发现问题时的提醒,
77
+ 以及 Claude / Codex 的简洁账号卡片:订阅模式展示 5 小时和本周的剩余额度环、重置时间与本周节奏;API 模式展示本月调用、Token 总量,并补充日均调用及输入/输出 Token。数据与悬停面板同源。每个已登记账号独立显示一张卡片,两列排列;「查看诊断」位于名称后,仅在该账号确实有诊断问题时出现。暂未采集到额度不视为配置异常。
78
+ - **会话**:此刻在线的 Agent 会话(等审批的置顶,每行可「跳到终端」),以及 CC Bridge 的
79
+ 消息往来:卡在信箱里待投递的、最近送达的。仅显示消息交互,无消息正文。
80
+ - **用量**:本机 Claude Code / Codex 最近 7、30、90 天的 Token 用量。顶部和概览同一套五格:总用量
81
+ (输入 + 缓存写 + 输出 + 缓存输入 + 后台用量)、输入、输出、缓存输入(附命中率)、请求数。本机 Codex SQLite 日志补充的后台用量仅计入总量,不推算 Token 明细。每日柱状图按模型分色堆叠,
82
+ 颜色固定跟着模型走,可以在这五项之间切换;点图例或表格里的模型只看它,鼠标移到柱子上看当天各模型的数值。
83
+ 数据全部来自本机会话日志,不会发送到任何地方;按日归档让 Claude Code 清理旧转录之后,历史仍然留得住。
84
+ - **多账号**:添加 Claude / Codex Home,查看账号的目录与集成状态,并通过“管理”菜单修复、重命名、重新定位或移除自定义 Home 的集成。
85
+ - **宠物 / 提醒 / 设置**:桌宠的全部设置拆成三页(宠物:选宠物、确认删除未选中的自定义宠物、大小、碎碎念、点击互动、导入 Codex 素材;提醒:系统通知、桌面状态卡和系统状态;
86
+ 设置:语言、面板外观和素材目录),另有更细的项(比如连击阈值、可以连续调节的玻璃压暗,菜单里仍是四档)。
87
+ 右键菜单只留最常用的几项:管理桌宠、宠物大小、显示消息气泡、用量展示模式、面板主题和 CC Bridge,其余都到这里改。改动会立刻作用到桌面上的宠物,在菜单里改的也会同步显示在这里。
88
+ 会改写 Claude Code / Codex 配置的选项(启用 CC Bridge、免审批)仍只在右键菜单里。
89
+ - **诊断**:和 `cc-pets doctor` 同一套检查,要处理的问题置顶,每条带所属模块、修复命令和「复制命令」;
90
+ 正常项折叠成一行。还有「重新检查」和「复制报告」(路径显示为 `~`,可以直接贴进 issue)。
91
+ 已登记账号的 Hooks 和 Claude status line 问题可点「自动修复」或「全部修复」,修复前备份配置及相关脚本,完成后自动重新检查。备份路径显示在页面上,其中 `manifest.json` 记录原文件路径、权限及备份文件;修复失败时显示原因,其他问题仍需复制命令执行。普通 `cc-pets doctor` 仍然只读。PATH 顺序那一项在这里只提示去终端运行 `cc-pets doctor`:
92
+ 桌宠进程自己的 PATH 不是你终端的 PATH。版本检查比较本地包、当前运行的原生程序与已安装 App;
93
+ 源码 checkout/worktree 显示「本地源码包」,npm 安装显示「本地 npm 包」,无法确认来源时显示「本地包」。
94
+ 这些标签不表示 npm 已发布该版本;线上版本由更新检查单独查询。
95
+
96
+ 窗口在打开时才创建,关闭即释放,关着的时候没有任何后台任务。Dock 图标和菜单栏只在窗口打开期间出现,
97
+ 窗口最小化后点 Dock 图标可以恢复。
98
+
57
99
  ## 互动方式
58
100
 
101
+ ### JetBrains IDE 终端跳转
102
+
103
+ 基于 IntelliJ 平台的 JetBrains IDE(IDEA、PyCharm、WebStorm、GoLand、CLion、PhpStorm、RubyMine、Rider 等)
104
+ 2026.2 / 2026.3 的本地 Reworked 终端可通过 **CC Pets Terminal** 插件精确跳转。
105
+ 在桌宠「设置 → 通用 → 终端跳转」中,每个检测到的 IDE 一行,点「安装」确认后插件会写入该 IDE 的插件目录;
106
+ IDE 正在运行时重启即可加载,打开项目后自动连接,无需配置端口。随 CC Pets 带来新版插件时,该行会显示「更新」。
107
+ 自定义了插件目录(`idea.plugins.path`)的 IDE 退回手动安装:Settings → Plugins → ⚙ → Install Plugin from Disk。
108
+ 每个 IDE 以及稳定版与 EAP 的插件相互独立;Classic 和远程终端暂不支持。
109
+ 详细安装、构建和本机通信说明见 [插件说明](plugins/jetbrains/README.md)。
110
+
111
+ ### VS Code 终端跳转
112
+
113
+ VS Code 1.80+ 及其分支(Cursor、Windsurf、VSCodium、Insiders 等)可通过 **CC Pets Terminal** 扩展
114
+ 精确跳到集成终端,面板、分屏和编辑器区里的终端都支持。在「设置 → 通用 → 终端跳转」中每个检测到的应用一行,
115
+ 点「安装」确认后用该应用自带的命令行工具安装随包 VSIX;已打开的窗口通常自动连接,否则执行「Developer: Reload Window」。
116
+ 没有命令行工具的应用退回手动安装:扩展视图 → ⋯ → 从 VSIX 安装…。未安装扩展时点击卡片只会激活应用;
117
+ 远程窗口(SSH、WSL、容器)暂不支持。详见 [扩展说明](plugins/vscode/README.md)。
118
+
59
119
  ### Agent 工作状态
60
120
 
61
121
  | Agent 事件 | 桌宠反馈 |
@@ -86,10 +146,10 @@ Claude Code Hook 会合并到 `~/.claude/settings.json`,现有的 `env`、`mod
86
146
  这类会话没有 pid 文件,只要 Hook 还在持续发事件就会留在最近会话列表里,闲置 60 秒后移出列表。
87
147
 
88
148
  所有 Hook 状态卡都可以点击;右侧圆形状态图标会展开最近 8 个在线 Agent 终端会话。
89
- macOS Terminal 和 iTerm2 会按 TTY 精确选中对应标签页或 Session。VS Code、
90
- JetBrains IDE、Warp、WezTerm、Ghostty 等在不安装扩展的模式下仅激活对应应用;应用
91
- 内部标签页是否恢复由应用自身决定。首次回跳 Terminal 或 iTerm2 时,macOS 可能要求
92
- 允许 CC Pets 控制该终端应用。
149
+ macOS Terminal 和 iTerm2 会按 TTY 精确选中对应标签页或 Session,Ghostty 1.4+ 还支持精确选择分屏。
150
+ VS Code 和 JetBrains IDE 通过随包扩展精确选择终端;未安装扩展时,以及 Warp、WezTerm 和旧版 Ghostty,
151
+ 仅前置对应应用。跳转 Terminal、iTerm2 或 Ghostty 时,macOS 可能要求 Automation 权限,
152
+ 可在「设置 → 终端跳转」管理权限与扩展。
93
153
 
94
154
  ### 鼠标互动
95
155
 
@@ -104,7 +164,7 @@ JetBrains IDE、Warp、WezTerm、Ghostty 等在不安装扩展的模式下仅激
104
164
  | 按住并向右拖动 | 播放向右拖行动画,同时移动桌宠 |
105
165
  | 按住并向左拖动 | 播放向左拖行动画,同时移动桌宠 |
106
166
  | 鼠标移开或拖动结束 | 恢复默认待机动画 |
107
- | 右键桌宠 | 切换桌宠、设置历史/通知、在「帮助」中检查更新或查看关于、退出 |
167
+ | 右键桌宠 | 切换桌宠、调大小、消息气泡、用量展示模式、面板主题、CC Bridge、「帮助」、打开主菜单、退出 |
108
168
 
109
169
  右键菜单「宠物大小」提供 50%~200% 的滑动条,拖动时实时缩放并显示百分比,
110
170
  点击「恢复默认」回到 100%。大小会自动保存,切换桌宠或重启后保留;缩放时脚底位置固定。
@@ -114,21 +174,50 @@ Hook 状态卡和消息气泡在宠物小于 100% 时同比例缩小,文字、
114
174
  右键菜单「面板主题」提供「经典」和「Liquid Glass」,默认使用经典样式。
115
175
  选择后立即应用于额度面板、状态条和说话气泡,并在重启后保留。Liquid Glass 使用系统原生玻璃,
116
176
  仅在 macOS 26 及以上可选;构建原生玻璃支持需要 macOS 26 或更新的 SDK。同一子菜单里的「玻璃压暗」
117
- 可在通透(0%)、轻度(15%)、标准(25%,默认)、清晰(45%)之间切换,作用于额度面板、状态卡和
177
+ 可在通透(0%)、轻度(25%)、标准(50%)、清晰(100%)之间切换,作用于额度面板、状态卡和
118
178
  说话气泡:档位越低越通透,档位越高在浅色背景上越容易看清。
119
179
 
180
+ ### 启动前检查小火箭
181
+
182
+ 在 **主菜单 → 设置 → 启动保护** 打开「Shadowrocket」开关(默认关闭)。
183
+ 启动保护按软件分别配置,当前提供 Shadowrocket,后续软件可在同一分组增加独立开关。
184
+ 通过 CC Pets 包装器启动 `claude` / `codex` 时,会先确认 Shadowrocket 的系统 VPN
185
+ 状态为已连接,再向对应服务的 `/cdn-cgi/trace` 发起 HTTPS GET,检查出口 IP 和地区;失败会在终端提示原因并返回非零退出码,
186
+ 不会启动 CLI,也不会登记会话或发送启动事件。关闭开关后不进行网络检查。
187
+
188
+ 仅识别 Shadowrocket 的 VPN 配置,不把「应用进程正在运行」当成代理已连接。
189
+ Claude 默认检查 `api.anthropic.com`;Codex 根据当前 Home 的 `auth.json` 选择:ChatGPT 登录检查
190
+ `chatgpt.com`,API Key 登录检查 `api.openai.com`。模式未知(例如凭据仅在 Keychain 中)时,两者都必须通过。
191
+ 返回的 `ip`、`loc`、`h` 必须有效且匹配目标域名;`loc=CN` 或 `HK` 会阻止启动。
192
+ 请求失败、非 HTTP 200、无效响应、未知地区、TLS 错误或超时也会阻止启动;成功时在终端显示域名、出口 IP 和地区。
193
+ 每次尝试连接最多等待 8 秒,请求总计最多 15 秒,外层进程保护时限为 16 秒。
194
+ 临时传输故障或 HTTP 502 / 503 / 504 会间隔 1 秒重试一次,重试前再次确认 VPN 连接状态。
195
+ 两次请求均超时时,每个域名约等待 31 秒,另加 VPN 检查及进程开销。
196
+ 被拦截地区、无效 trace 和证书错误不重试。失败提示区分连接、响应及进程超时,
197
+ 显示尝试次数和 DNS / TCP / TLS / 响应的累计耗时。不再额外做系统 DNS 或首页 HEAD 探测。
198
+ 请求不带账号凭据,正常校验证书,忽略 `~/.curlrc`,不跟随重定向。
199
+
200
+ Claude 支持当前 `CLAUDE_CONFIG_DIR` 下 `settings.json` 中的网络环境变量及终端代理变量,
201
+ 优先使用其中的 `ANTHROPIC_BASE_URL`。Codex 支持 `CODEX_HOME/config.toml` 中常见的单行字符串
202
+ 路由配置(`model_provider`、`profile`、`model_providers.<id>.base_url`、`chatgpt_base_url`)、
203
+ `--profile` / `-p`、`OPENAI_BASE_URL` 和终端代理变量。自定义地址检查同一源站的 `/cdn-cgi/trace`,
204
+ 不回退到其他域名;网关必须提供有效 trace,且结果只代表到网关的出口,不代表网关到上游的出口。
205
+ 复杂路由 TOML、未支持的云服务商、命令行配置覆盖及项目网络覆盖会拒绝检查并提示原因。
206
+ 企业托管网络配置不在支持范围内。此检查不验证账号、密钥或服务支持地区,也不能保证探测后出口不变。
207
+ 直接启动原始 CLI 二进制或桌面客户端不会经过此保护。
208
+
120
209
  ### 界面语言
121
210
 
122
- 右键菜单「语言」提供「跟随系统」和所有已打包的语言,目前是「English」「简体中文」。
211
+ 主菜单「设置」页的「语言」提供「跟随系统」和所有已打包的语言,目前是「English」「简体中文」。
123
212
  跟随系统时,取 macOS 首选语言里第一个支持的语言,都不支持就用英文。菜单和面板立即切换;对话框里的系统按钮在下次启动后跟上。
124
213
  选择会写入 `~/.cc-pets/language`,`cc-pets` 命令、hooks 和 CC Bridge 消息因此使用同一种语言;
125
214
  单次命令可以用 `CC_PETS_LANGUAGE=en` 或 `zh-Hans` 覆盖。如果从没改过 `~/.cc-pets/speech.txt`,
126
215
  它会换成新语言的默认台词;改过的台词保持不动。想贡献其他语言的翻译,
127
216
  见 [新增一种语言](./CONTRIBUTING.zh-CN.md#新增一种语言)。
128
217
 
129
- 右键菜单中的“切换桌宠”只扫描 `~/.cc-pets/pets/`(见 [素材管理](#素材管理))和包内素材,
218
+ 右键菜单中的「管理桌宠」只扫描 `~/.cc-pets/pets/`(见 [素材管理](#素材管理))和包内素材,
130
219
  **不会**去读 `~/.petdex/pets/` 和 `~/.codex/pets/`——那两个目录由 PetDex CLI 和 Codex 写入,
131
- 混在一起就找不到自己装的宠物了。要用 Codex 那边的素材,打开右键菜单里的“导入 Codex
220
+ 混在一起就找不到自己装的宠物了。要用 Codex 那边的素材,打开主菜单「宠物」页的“导入 Codex
132
221
  素材”开关,它们会被复制进你自己的目录(见 [导入 Codex 素材](#导入-codex-素材))。
133
222
 
134
223
  外部桌宠使用目录名作为菜单名称,内置桌宠使用素材文件名(不显示扩展名)。选择后立即
@@ -161,7 +250,7 @@ Agent 状态动画会优先播放。
161
250
 
162
251
  右键菜单中的“记录本地额度历史”默认关闭。启用后只在本机
163
252
  `~/Library/Application Support/CC Pets/quota-history.json` 保存最近 7 天的数据,
164
- 每 15 分钟最多记录一次。系统通知也默认关闭,可在“系统通知”子菜单中分别启用任务完成、
253
+ 每 15 分钟最多记录一次。系统通知也默认关闭,可在主菜单「提醒」页分别启用任务完成、
165
254
  任务失败、等待审批和响应超时通知。最后一项在 Agent 停在等待审批超过 2 分钟、
166
255
  或停在思考态超过 5 分钟时提醒一次;该会话有新事件后重新武装,下次卡住会再提醒。
167
256
 
@@ -171,10 +260,16 @@ Provider、脱敏状态和通用说明,不提供消息输入,也不会显示
171
260
  连续 1 分钟没有收到新的 Agent 状态事件时,卡片和圆钮会一起自动隐藏;下一次收到事件时
172
261
  会重新显示并重新计时。
173
262
 
263
+ API 用量模式下,月度 Token 趋势将今日用量和记录天数分行显示;悬停可查看当前所选账号的峰值。
264
+ Codex 耗尽标记从采样时起五分钟后失效,从缓存恢复也不会延长有效期。
265
+
174
266
  ## 碎碎念
175
267
 
268
+ 低额度提醒按订阅账号分别跟踪剩余 20%、10%、5% 阈值,注明触发账号,冷却期间排队播报。
269
+ 首次采样、过期额度和 API 用量账号不触发提醒;普通额度台词的槽位使用剩余额度最低的订阅账号。
270
+
176
271
  桌宠会以自己的口吻讲话:Agent 干活时讲的话直接写在状态卡副行上,闲着的时候单独冒气泡。
177
- 右键菜单「碎碎念」里可以整体开关、调频率、选择台词来源、改台词。
272
+ 主菜单「宠物」页的「碎碎念」里可以整体开关、调频率、选择台词来源、改台词。
178
273
 
179
274
  「台词来源」里可单选 **专属台词** 或 **默认台词**:专属台词优先使用当前宠物的
180
275
  词库,缺少的小节沿用通用词库;默认台词只使用 `~/.cc-pets/speech.txt` 中的通用台词,
@@ -198,7 +293,7 @@ Agent **正在干活**时(思考、调用工具、等待审批、子 Agent 工
198
293
 
199
294
  ### 编辑台词
200
295
 
201
- 右键菜单「碎碎念 → 编辑台词…」打开内置编辑器。桌宠说的**所有**话都在
296
+ 主菜单「宠物」页「碎碎念」里的「编辑台词…」打开内置编辑器。桌宠说的**所有**话都在
202
297
  `~/.cc-pets/speech.txt` 里,代码里没有第二份词库——首次启动时从 app 内的默认词库
203
298
  拷一份出来,之后就只认这个文件。
204
299
 
@@ -232,7 +327,7 @@ Agent **正在干活**时(思考、调用工具、等待审批、子 Agent 工
232
327
 
233
328
  上面那份 `speech.txt` 是**所有**宠物的通用台词。想让某一只换个口吻,编辑器顶部有一个
234
329
  「**通用** / **当前宠物 · ×××**」的切换——切到右边,写的就只属于当前这只宠物,
235
- 存在 `~/.cc-pets/speech/<宠物名>.txt`(内置素材是 `builtin-默认.txt`)。
330
+ 存在 `~/.cc-pets/speech/<宠物名>.txt`(内置素材是 `builtin-ByteMochi.txt`)。
236
331
 
237
332
  这一页**初次打开是空白的,这是正常的**:空白 = 这只宠物全部沿用通用台词。
238
333
  不知道能写什么就点右上角 **填入默认模板**,它会把整份默认台词以**注释状态**填进来
@@ -242,10 +337,10 @@ Agent **正在干活**时(思考、调用工具、等待审批、子 Agent 工
242
337
  手写的话,**只写想改的小节**就行:
243
338
 
244
339
  ```
245
- # ~/.cc-pets/speech/external-哆啦A梦.txt
340
+ # ~/.cc-pets/speech/external-团子.txt
246
341
  [idle]
247
- 铜锣烧…
248
- 口袋里好像有点东西。
342
+ 想吃糯米团…
343
+ 兜里好像有点东西。
249
344
 
250
345
  [done]
251
346
  诺,任意门给你。
@@ -313,11 +408,23 @@ defaults delete com.universewang.cc-pets CCPetsSpeechCooldown # 交
313
408
  ## 系统要求
314
409
 
315
410
  - macOS 13 或更高版本
316
- - Node.js 18 或更高版本
411
+ - Node.js 18 或更高版本,仅供 npm 安装与升级使用;桌宠本身以及 `cc-pets` 命令、Hooks、
412
+ CC Bridge 都是原生程序,运行时不依赖 Node
317
413
  - 已安装并登录 Codex CLI 和/或 Claude Code CLI
318
414
  - zsh
319
415
  - Xcode Command Line Tools,可通过 `xcode-select --install` 安装
320
416
 
417
+ ## CC Bridge
418
+
419
+ [CC Bridge](./CC_BRIDGE.zh-CN.md) 是默认关闭的可选功能,让本机 Claude Code / Codex 会话互发消息并预留文件。
420
+ 身份识别优先验证会话 ID;按 PID 回退时只接受唯一在线会话,共享宿主下身份不明确会拒绝操作。
421
+ Codex 消息使用接收方的 Home 投递。
422
+
423
+ 未确认的信箱消息可在异常退出后恢复。输出和确认之间崩溃时可能重复投递同一消息 ID;送达不代表已读或同意。
424
+ 关闭自动唤醒后,已运行的 watcher 也会停止主动取信;关闭 Bridge 后 CLI 拒绝发送、改名和收件。
425
+ 集成未能完整移除时会报错,可排除原因后重试。详细配置与投递边界见使用指南,修复列表见
426
+ [未发布更新记录](./CHANGELOG.zh-CN.md#unreleased)。
427
+
321
428
  ## 安装
322
429
 
323
430
  ### npm 安装
@@ -374,6 +481,17 @@ npm 的安装后脚本会自动构建原生应用、安装两套 Agent Hooks,
374
481
  `codex` 与 `claude` 软链,再向 `~/.zshrc` 追加带明确标记的一行把该目录前置到 `PATH`,不会覆盖真实的 CLI 二进制。
375
482
  用 shim 而不是 alias,是因为 alias 名区分大小写而 macOS 文件系统默认不区分:`Claude`、`CODEX` 这类写法
376
483
  匹配不到 alias,会直接命中真二进制,桌宠不会被拉起。shim 让任意大小写写法都落到同一个文件上。
484
+
485
+ ### 多账号
486
+
487
+ CC Pets 会自动发现并集成官方 `~/.claude` 和 `~/.codex` Home。`~/.claude-x`、
488
+ `~/.codex-work` 等自定义 Home 不会被自动扫描,必须从「主菜单 → 多账号」(位于“宠物”下方)手动添加。
489
+ 默认使用文件夹名作为账号名称并保持原样,也可以在该页的“管理”菜单中重命名。每个 Provider
490
+ 拥有独立的循环额度卡片,用量页也可以按账号筛选本机会话 Token 历史。
491
+
492
+ 添加账号时会配置 Pet Hooks 和用量采集。若 CC Bridge 已开启,会同时配置它的 Hooks、
493
+ 权限与 MCP;若尚未开启,之后启用 CC Bridge 时会自动为所有已登记账号补齐。
494
+
377
495
  首次安装需要新开终端让 `PATH` 生效;以后升级只需执行 npm 命令。
378
496
  同时会将标准 macOS 应用安装到 `~/Applications/CC Pets.app`,可从 Finder 或 Launchpad 启动,
379
497
  不需要管理员权限。npm 升级时会同步更新该应用。
@@ -428,6 +546,9 @@ cc-pets clean
428
546
  # 检查安装、Hooks、status line、shim 与 CC Bridge 是否正常,并给出修复建议;输出已脱敏,可直接贴进 issue
429
547
  cc-pets doctor
430
548
 
549
+ # 打开主菜单并定位到页面(overview / sessions / usage / pet / accounts / alerts / general / diagnostics,省略则打开上次看的页面)
550
+ cc-pets open [page]
551
+
431
552
  # 列出偏好、桌宠素材、台词、缓存与运行时状态的存放位置和大小(--json 输出机器可读格式)
432
553
  cc-pets paths
433
554
 
@@ -527,7 +648,10 @@ Codex 侧同理:桌宠固定只统计 `~/.codex`,不读继承来的 `CODEX_H
527
648
  自然日窗口(今日 = 本机零点至今,最近 7 天 = 含今天在内的 7 个自然日),因为两家的
528
649
  `resets_at` 并不一致,按各自订阅窗口算出的数不在同一区间上,相加没有意义。每个 Agent 卡片按 5 小时和 7 天两列
529
650
  展示官方剩余百分比(主值)、本机 Token 用量和重置时间,右侧是近 7 天额度趋势。右键菜单的
530
- “用量展示模式”可分别为 Codex、Claude 选择“订阅额度”或“API 用量”;API 用量模式只替换对应
651
+ “用量展示模式”保留原有切换控件,按已登记账号分别设置,旧的平台设置作为未单独设置账号的默认值。
652
+ 明确识别为 API 认证时,固定显示 API 用量并禁用切换;订阅认证仍可在“订阅额度”和“API 用量”之间切换。
653
+ 认证类型不明时保留手动切换;缺少额度数据不会被当作 API 认证的证据。认证类型在后台刷新,不记录密钥或 CLI 认证输出。
654
+ API 用量模式只替换对应
531
655
  卡片内部,展示本月调用次数、本月输入/输出 Token、较上月同期变化和本月按日 Token 趋势。
532
656
  “调用次数”来自本机会话记录:Claude 按请求标识去重,Codex 按去重后的累计 Token 快照计数。
533
657
  某个窗口
@@ -556,7 +680,7 @@ Codex 侧同理:桌宠固定只统计 `~/.codex`,不读继承来的 `CODEX_H
556
680
 
557
681
  ## 素材与版权
558
682
 
559
- **本项目不自建素材仓库。** 仓库和 npm 包里只有一个内置素材 `默认.webp`(原创角色
683
+ **本项目不自建素材仓库。** 仓库和 npm 包里只有一个内置素材 `ByteMochi.webp`(原创角色
560
684
  ByteMochi,随代码按 MIT License 分发)。其余桌宠素材一律**由用户自己从素材源按需下载**
561
685
  到本机 `~/.cc-pets/pets/`,既不进仓库,也不进 npm 发布包。
562
686
 
@@ -581,7 +705,7 @@ v2(`1536×2288`、`8×11`),单元格均为 `192×208`,前九行遵循相
581
705
  ```bash
582
706
  cc-pets pet search otter # 搜索可用素材(不带关键词就列全部)
583
707
  cc-pets pet add boba # 下载到 ~/.cc-pets/pets/boba/
584
- cc-pets pet add boba doraemon # 一次装多个
708
+ cc-pets pet add boba otterumells # 一次装多个
585
709
  cc-pets pet list # 列出已安装的素材,按来源分组
586
710
  cc-pets pet remove boba # 删除
587
711
  cc-pets pet source # 列出可用的素材源
@@ -599,7 +723,7 @@ cc-pets pet search petdex:otter
599
723
  ```
600
724
 
601
725
  一个源的完整定义就是清单地址、资源 host 白名单和 Referer 三项,集中在
602
- `scripts/pet-store.mjs` 顶部的 `SOURCES` 表里。以后接自建 registry 时在表里加一行即可,
726
+ `Sources/CCPets/Pet/CCPetsPetStore.m` 的 `Sources()` 表里。以后接自建 registry 时在表里加一行即可,
603
727
  命令、目录结构和桌宠端都不用改。默认源用 `CC_PETS_SOURCE` 切换。
604
728
 
605
729
  来源记录在宠物目录内的 `.source.json`(`{ "source", "slug", "installedAt" }`),下载来的
@@ -620,7 +744,7 @@ cc-pets pet add boba --as 波霸
620
744
 
621
745
  #### 导入 Codex 素材
622
746
 
623
- 桌宠不读 `~/.codex/pets/`。如果你在 Codex 桌面端已经装了一批素材,打开右键菜单里的
747
+ 桌宠不读 `~/.codex/pets/`。如果你在 Codex 桌面端已经装了一批素材,打开主菜单「宠物」页的
624
748
  **“导入 Codex 素材”** 开关,桌宠会把那里的素材**复制**进 `~/.cc-pets/pets/`:开关打开的
625
749
  当下导入一次,之后每次启动再导入一次。
626
750
 
@@ -652,8 +776,13 @@ PetDex 官方 CLI(`npx petdex install <slug>`)会把素材放在 `~/.petdex/
652
776
 
653
777
  ## 隐私
654
778
 
655
- - Codex 额度通过本机 Codex CLI 启动的官方 App Server 读取,沿用 Codex CLI 自身的登录状态;Codex Token 只从本机 `~/.codex/sessions` 读取(可用 `CC_PETS_CODEX_HOME` 覆盖)。
779
+ - 可选 Shadowrocket 启动保护默认关闭;启用后检查本机 VPN 状态,并向配置的服务 `/cdn-cgi/trace` 端点发起 HTTPS 请求。端点可见连接的出口 IP;请求不携带账号凭据、校验 TLS 且不跟随重定向。路由与支持限制见启动保护章节。
780
+ - Token 统计还会读取本机 Codex SQLite 日志和线程元数据,并在本机缓存派生用量与增量读取游标,不上传这些日志。
781
+ - 已安装的终端扩展仅监听 `127.0.0.1`,并验证本地请求身份;实例元数据与本地访问令牌保存在 `~/Library/Application Support/CC Pets/ide-instances/`,权限仅限本人。扩展安装经确认后写入所选 IDE 的插件或扩展目录;通过脚本跳转终端需要 macOS Automation 权限。
782
+ - Codex 额度通过本机 Codex CLI 启动的官方 App Server 读取,沿用 Codex CLI 自身的登录状态;Codex Token 从本机已登记 Home 的会话记录及 SQLite 数据读取(默认 Home 可用 `CC_PETS_CODEX_HOME` 覆盖)。
656
783
  - Claude 额度只从 Claude Code 传给本机 status line 的 `rate_limits` 字段读取。
784
+ - 为区分 API 账号和订阅账号,CC Pets 会读取各已登记 Home 中的认证配置(Claude 的 `settings.json`;Codex 的 `auth.json` 和 `config.toml`),并可能在本机运行该 Home 的 `claude auth status` / `codex login status`。只在内存中保留识别出的模式,不保存密钥、邮箱或命令输出。
785
+ - 诊断页修复前,会把受影响的配置文件和脚本备份到 `~/Library/Application Support/CC Pets/diagnostic-backups/`(仅本人可读),备份只保存在本机。
657
786
  - Agent Hooks 只向当前用户的临时目录写入桌宠事件和额度缓存。
658
787
  - 额度历史默认关闭;启用后只在本机保留最近 7 天的剩余比例快照。
659
788
  - 状态气泡和通知只显示 Provider、状态及脱敏工具类别,不显示会话正文。
@@ -681,6 +810,8 @@ CC Pets 建立的软链,并恢复安装前的 Claude status line;其他用
681
810
 
682
811
  CC Pets 是社区开源项目,与 OpenAI、Anthropic、PetDex 及任何角色版权方不存在隶属、授权
683
812
  或官方合作关系。Codex、ChatGPT、Claude 及相关图标和商标归各自权利人所有。
813
+ 未能读取已安装应用的图标时,会使用随包提供、统一视觉尺寸的 Claude 和 Codex 备用图标。
814
+ 来源及版权归属见[第三方声明](./THIRD_PARTY_NOTICES.zh-CN.md),这些图标不适用本项目的 MIT License。
684
815
 
685
816
  ## License
686
817
 
Binary file
Binary file