cc-pets 2.2.1 → 2.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (171) hide show
  1. package/CC_BRIDGE.md +5 -2
  2. package/CC_BRIDGE.zh-CN.md +4 -2
  3. package/CHANGELOG.md +60 -0
  4. package/CHANGELOG.zh-CN.md +60 -0
  5. package/CONTRIBUTING.md +13 -10
  6. package/CONTRIBUTING.zh-CN.md +11 -10
  7. package/README.md +113 -24
  8. package/README.zh-CN.md +89 -28
  9. package/Resources/zh-Hans.lproj/Localizable.strings +568 -17
  10. package/Sources/CCPets/{CCPetsAppDelegate+AgentEvents.m → App/CCPetsAppDelegate+AgentEvents.m} +15 -5
  11. package/Sources/CCPets/{CCPetsAppDelegate+AgentStatus.m → App/CCPetsAppDelegate+AgentStatus.m} +82 -23
  12. package/Sources/CCPets/{CCPetsAppDelegate+Bridge.m → App/CCPetsAppDelegate+Bridge.m} +35 -24
  13. package/Sources/CCPets/{CCPetsAppDelegate+Pets.m → App/CCPetsAppDelegate+Pets.m} +17 -3
  14. package/Sources/CCPets/{CCPetsAppDelegate+Private.h → App/CCPetsAppDelegate+Private.h} +70 -22
  15. package/Sources/CCPets/App/CCPetsAppDelegate+Profiles.m +238 -0
  16. package/Sources/CCPets/{CCPetsAppDelegate+Quota.m → App/CCPetsAppDelegate+Quota.m} +47 -32
  17. package/Sources/CCPets/{CCPetsAppDelegate+Settings.m → App/CCPetsAppDelegate+Settings.m} +86 -98
  18. package/Sources/CCPets/{CCPetsAppDelegate+Speech.m → App/CCPetsAppDelegate+Speech.m} +8 -4
  19. package/Sources/CCPets/App/CCPetsAppDelegate+Workbench.m +139 -0
  20. package/Sources/CCPets/{CCPetsAppDelegate.h → App/CCPetsAppDelegate.h} +15 -0
  21. package/Sources/CCPets/{CCPetsAppDelegate.m → App/CCPetsAppDelegate.m} +107 -11
  22. package/Sources/CCPets/App/CCPetsOpenCommand.h +13 -0
  23. package/Sources/CCPets/App/CCPetsOpenCommand.m +99 -0
  24. package/Sources/CCPets/{main.m → App/main.m} +68 -1
  25. package/Sources/CCPets/{CCPetsBridge.h → Bridge/CCPetsBridge.h} +17 -4
  26. package/Sources/CCPets/{CCPetsBridge.m → Bridge/CCPetsBridge.m} +32 -17
  27. package/Sources/CCPets/Bridge/CCPetsBridgeCLI.h +10 -0
  28. package/Sources/CCPets/Bridge/CCPetsBridgeCLI.m +792 -0
  29. package/Sources/CCPets/Bridge/CCPetsBridgeCore.h +60 -0
  30. package/Sources/CCPets/Bridge/CCPetsBridgeCore.m +558 -0
  31. package/Sources/CCPets/Bridge/CCPetsBridgeSetup.h +24 -0
  32. package/Sources/CCPets/Bridge/CCPetsBridgeSetup.m +501 -0
  33. package/Sources/CCPets/Bridge/CCPetsBridgeStore.h +103 -0
  34. package/Sources/CCPets/Bridge/CCPetsBridgeStore.m +779 -0
  35. package/Sources/CCPets/Integrations/CCPetsCLISupport.h +75 -0
  36. package/Sources/CCPets/Integrations/CCPetsCLISupport.m +342 -0
  37. package/Sources/CCPets/Integrations/CCPetsEvents.h +15 -0
  38. package/Sources/CCPets/{CCPetsEvents.m → Integrations/CCPetsEvents.m} +23 -0
  39. package/Sources/CCPets/Integrations/CCPetsIntegrations.h +51 -0
  40. package/Sources/CCPets/Integrations/CCPetsIntegrations.m +662 -0
  41. package/Sources/CCPets/Integrations/CCPetsProfiles.h +38 -0
  42. package/Sources/CCPets/Integrations/CCPetsProfiles.m +516 -0
  43. package/Sources/CCPets/{CCPetsTerminalFocus.m → Integrations/CCPetsTerminalFocus.m} +42 -12
  44. package/Sources/CCPets/Pet/CCPetsPetStore.h +12 -0
  45. package/Sources/CCPets/Pet/CCPetsPetStore.m +476 -0
  46. package/Sources/CCPets/{CCPetsPhrases.h → Pet/CCPetsPhrases.h} +11 -2
  47. package/Sources/CCPets/{CCPetsPhrases.m → Pet/CCPetsPhrases.m} +19 -2
  48. package/Sources/CCPets/{CCPetsPhrasesEditor.m → Pet/CCPetsPhrasesEditor.m} +4 -1
  49. package/Sources/CCPets/Pet/PetView+Interaction.m +207 -0
  50. package/Sources/CCPets/Pet/PetView+Menu.m +598 -0
  51. package/Sources/CCPets/Pet/PetView+MicroBehavior.m +234 -0
  52. package/Sources/CCPets/Pet/PetView+Private.h +81 -0
  53. package/Sources/CCPets/{PetView.h → Pet/PetView.h} +3 -5
  54. package/Sources/CCPets/Pet/PetView.m +635 -0
  55. package/Sources/CCPets/Support/CCPetsDoctor.h +25 -0
  56. package/Sources/CCPets/Support/CCPetsDoctor.m +632 -0
  57. package/Sources/CCPets/Support/CCPetsJSON.h +27 -0
  58. package/Sources/CCPets/Support/CCPetsJSON.m +397 -0
  59. package/Sources/CCPets/{CCPetsL10n.h → Support/CCPetsL10n.h} +3 -1
  60. package/Sources/CCPets/{CCPetsL10n.m → Support/CCPetsL10n.m} +30 -1
  61. package/Sources/CCPets/Support/CCPetsPreferences.h +31 -0
  62. package/Sources/CCPets/Support/CCPetsPreferences.m +85 -0
  63. package/Sources/CCPets/UI/CCPetsDiagnosticsPage.h +25 -0
  64. package/Sources/CCPets/UI/CCPetsDiagnosticsPage.m +440 -0
  65. package/Sources/CCPets/UI/CCPetsFormBuilder.h +42 -0
  66. package/Sources/CCPets/UI/CCPetsFormBuilder.m +268 -0
  67. package/Sources/CCPets/{CCPetsGlassView.h → UI/CCPetsGlassView.h} +5 -1
  68. package/Sources/CCPets/{CCPetsGlassView.m → UI/CCPetsGlassView.m} +25 -7
  69. package/Sources/CCPets/UI/CCPetsMainWindow.h +55 -0
  70. package/Sources/CCPets/UI/CCPetsMainWindow.m +730 -0
  71. package/Sources/CCPets/UI/CCPetsSettingsPage.h +62 -0
  72. package/Sources/CCPets/UI/CCPetsSettingsPage.m +917 -0
  73. package/Sources/CCPets/UI/CCPetsUIStyle.h +132 -0
  74. package/Sources/CCPets/UI/CCPetsUIStyle.m +816 -0
  75. package/Sources/CCPets/UI/CCPetsUsageChartView.h +15 -0
  76. package/Sources/CCPets/UI/CCPetsUsageChartView.m +284 -0
  77. package/Sources/CCPets/UI/CCPetsUsagePage.h +32 -0
  78. package/Sources/CCPets/UI/CCPetsUsagePage.m +717 -0
  79. package/Sources/CCPets/UI/CCPetsUsageShared.h +53 -0
  80. package/Sources/CCPets/UI/CCPetsUsageStore.m +120 -0
  81. package/Sources/CCPets/UI/CCPetsUsageWidgets.h +30 -0
  82. package/Sources/CCPets/UI/CCPetsUsageWidgets.m +201 -0
  83. package/Sources/CCPets/UI/CCPetsWorkbench.h +40 -0
  84. package/Sources/CCPets/UI/CCPetsWorkbenchPages.h +13 -0
  85. package/Sources/CCPets/UI/CCPetsWorkbenchPages.m +783 -0
  86. package/Sources/CCPets/{MenuToggleSwitch.m → UI/MenuToggleSwitch.m} +1 -0
  87. package/Sources/CCPets/{CCPetsCodexRateLimits.h → Usage/CCPetsCodexRateLimits.h} +1 -0
  88. package/Sources/CCPets/{CCPetsCodexRateLimits.m → Usage/CCPetsCodexRateLimits.m} +10 -3
  89. package/Sources/CCPets/{CCPetsQuotaHistory.h → Usage/CCPetsQuotaHistory.h} +3 -0
  90. package/Sources/CCPets/{CCPetsQuotaHistory.m → Usage/CCPetsQuotaHistory.m} +58 -0
  91. package/Sources/CCPets/Usage/CCPetsUsage+ClaudeReader.m +436 -0
  92. package/Sources/CCPets/Usage/CCPetsUsage+CodexReader.m +392 -0
  93. package/Sources/CCPets/Usage/CCPetsUsage+CodexSessions.m +484 -0
  94. package/Sources/CCPets/Usage/CCPetsUsage+Internal.h +96 -0
  95. package/Sources/CCPets/Usage/CCPetsUsage+Models.m +285 -0
  96. package/Sources/CCPets/Usage/CCPetsUsage+TokenTotals.m +655 -0
  97. package/Sources/CCPets/Usage/CCPetsUsage.h +57 -0
  98. package/Sources/CCPets/Usage/CCPetsUsage.m +225 -0
  99. package/Sources/CCPets/Usage/CCPetsUsageMode.h +10 -0
  100. package/Sources/CCPets/Usage/CCPetsUsageMode.m +163 -0
  101. package/Sources/CCPets/{CCPetsUsageMonitor.h → Usage/CCPetsUsageMonitor.h} +3 -0
  102. package/Sources/CCPets/{CCPetsUsageMonitor.m → Usage/CCPetsUsageMonitor.m} +163 -6
  103. package/Sources/CCPets/Usage/QuotaDashboardView+Primitives.m +328 -0
  104. package/Sources/CCPets/Usage/QuotaDashboardView+Private.h +103 -0
  105. package/Sources/CCPets/Usage/QuotaDashboardView+Rendering.m +616 -0
  106. package/Sources/CCPets/{QuotaDashboardView.h → Usage/QuotaDashboardView.h} +17 -0
  107. package/Sources/CCPets/Usage/QuotaDashboardView.m +587 -0
  108. package/THIRD_PARTY_NOTICES.md +1 -1
  109. package/THIRD_PARTY_NOTICES.zh-CN.md +1 -1
  110. package/bin/cc-pets +8 -6
  111. package/bin/claude-with-pet +10 -2
  112. package/bin/codex-with-pet +13 -5
  113. package/package.json +1 -1
  114. package/scripts/build.sh +7 -3
  115. package/scripts/i18n.zsh +9 -52
  116. package/scripts/install-app.sh +4 -0
  117. package/scripts/install-shell-integration.sh +17 -10
  118. package/scripts/uninstall-shell-integration.sh +6 -1
  119. package/Sources/CCPets/CCPetsEvents.h +0 -10
  120. package/Sources/CCPets/CCPetsUsage.h +0 -36
  121. package/Sources/CCPets/CCPetsUsage.m +0 -2069
  122. package/Sources/CCPets/PetView.m +0 -1839
  123. package/Sources/CCPets/QuotaDashboardView.m +0 -1145
  124. package/scripts/bridge/cli.mjs +0 -237
  125. package/scripts/bridge/core.mjs +0 -228
  126. package/scripts/bridge/hook.mjs +0 -150
  127. package/scripts/bridge/install.mjs +0 -311
  128. package/scripts/bridge/mcp-server.mjs +0 -308
  129. package/scripts/bridge/options.mjs +0 -87
  130. package/scripts/bridge/process.mjs +0 -151
  131. package/scripts/bridge/reservations.mjs +0 -248
  132. package/scripts/bridge/store.mjs +0 -433
  133. package/scripts/bridge/watch.mjs +0 -69
  134. package/scripts/check-l10n.mjs +0 -168
  135. package/scripts/configure-updater.mjs +0 -43
  136. package/scripts/detect-cli.mjs +0 -68
  137. package/scripts/doctor.mjs +0 -470
  138. package/scripts/i18n.mjs +0 -122
  139. package/scripts/install-claude-hooks.mjs +0 -253
  140. package/scripts/install-codex-hooks.mjs +0 -78
  141. package/scripts/integration-markers.mjs +0 -51
  142. package/scripts/locales/zh-Hans.json +0 -366
  143. package/scripts/pet-store.mjs +0 -415
  144. package/scripts/uninstall-integrations.mjs +0 -205
  145. /package/Sources/CCPets/{CCPetsAppDelegate+Update.m → App/CCPetsAppDelegate+Update.m} +0 -0
  146. /package/Sources/CCPets/{CCPetsVersion.h → App/CCPetsVersion.h} +0 -0
  147. /package/Sources/CCPets/{CCPetsVersion.m → App/CCPetsVersion.m} +0 -0
  148. /package/Sources/CCPets/{CCPetsTerminalFocus.h → Integrations/CCPetsTerminalFocus.h} +0 -0
  149. /package/Sources/CCPets/{CCPetsImageLoader.h → Pet/CCPetsImageLoader.h} +0 -0
  150. /package/Sources/CCPets/{CCPetsImageLoader.m → Pet/CCPetsImageLoader.m} +0 -0
  151. /package/Sources/CCPets/{CCPetsPetSize.h → Pet/CCPetsPetSize.h} +0 -0
  152. /package/Sources/CCPets/{CCPetsPetSize.m → Pet/CCPetsPetSize.m} +0 -0
  153. /package/Sources/CCPets/{CCPetsPhrasesEditor.h → Pet/CCPetsPhrasesEditor.h} +0 -0
  154. /package/Sources/CCPets/{CCPetsPreviews.h → Pet/CCPetsPreviews.h} +0 -0
  155. /package/Sources/CCPets/{CCPetsPreviews.m → Pet/CCPetsPreviews.m} +0 -0
  156. /package/Sources/CCPets/Resources/{/351/273/230/350/256/244.webp" → ByteMochi.webp} +0 -0
  157. /package/Sources/CCPets/{CCPetsCleanup.h → Support/CCPetsCleanup.h} +0 -0
  158. /package/Sources/CCPets/{CCPetsCleanup.m → Support/CCPetsCleanup.m} +0 -0
  159. /package/Sources/CCPets/{CCPetsPaths.h → Support/CCPetsPaths.h} +0 -0
  160. /package/Sources/CCPets/{CCPetsPaths.m → Support/CCPetsPaths.m} +0 -0
  161. /package/Sources/CCPets/{CCPetsSystemMonitor.h → Support/CCPetsSystemMonitor.h} +0 -0
  162. /package/Sources/CCPets/{CCPetsSystemMonitor.m → Support/CCPetsSystemMonitor.m} +0 -0
  163. /package/Sources/CCPets/{CCPetsGlassMenu.h → UI/CCPetsGlassMenu.h} +0 -0
  164. /package/Sources/CCPets/{CCPetsGlassMenu.m → UI/CCPetsGlassMenu.m} +0 -0
  165. /package/Sources/CCPets/{MenuChoiceRow.h → UI/MenuChoiceRow.h} +0 -0
  166. /package/Sources/CCPets/{MenuChoiceRow.m → UI/MenuChoiceRow.m} +0 -0
  167. /package/Sources/CCPets/{MenuHintView.h → UI/MenuHintView.h} +0 -0
  168. /package/Sources/CCPets/{MenuHintView.m → UI/MenuHintView.m} +0 -0
  169. /package/Sources/CCPets/{MenuPetSizeView.h → UI/MenuPetSizeView.h} +0 -0
  170. /package/Sources/CCPets/{MenuPetSizeView.m → UI/MenuPetSizeView.m} +0 -0
  171. /package/Sources/CCPets/{MenuToggleSwitch.h → UI/MenuToggleSwitch.h} +0 -0
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.3.0:主菜单、多账号与按模型统计 Token 用量">
3
3
  </p>
4
4
 
5
5
  # CC Pets
@@ -9,21 +9,19 @@
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.3.0 新功能
13
13
 
14
- - **宠物大小调整**:右键「宠物大小」可实时缩放至 50%~200%,设置自动保存;
15
- 小尺寸宠物的状态卡与气泡同比例缩小,并修复 Retina 屏幕上的精灵图模糊。
16
- - **台词来源选择**:「碎碎念 → 台词来源」可选择「专属台词」或「默认台词」,
17
- 立即生效,切换宠物和重启后仍保留。
18
- - **菜单与编辑器修复**:单选后菜单保持展开、勾选即时更新,长英文标题完整显示;
19
- 台词编辑器切换语言时统一刷新文案,并保留未保存的编辑。
14
+ - **主菜单**:从菜单或 `cc-pets open` 打开概览、会话、用量、宠物、多账号、提醒、设置和诊断,
15
+ 集中查看在线会话、跳转终端和管理桌宠设置。
16
+ - **多账号与模型用量**:在「多账号」页管理 Claude / Codex Home,按账号隔离额度、历史和在线状态;
17
+ 查看最近 7、30、90 天的 Token 图表,按账号和模型筛选,独立设置订阅额度或 API 用量展示。
18
+ - **原生运行时与诊断修复**:Hooks、CC Bridge 和 CLI 工具运行时无需 Node.js;
19
+ 诊断页可修复已登记账号的 Hooks 和 Claude status line,修改前自动备份配置。
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.3.0.md)。
22
22
 
23
23
  ## 界面预览
24
24
 
25
- 简体中文:额度面板与右键菜单。
26
-
27
25
  <p align="center">
28
26
  <img src="docs/images/liquid-glass-panel.png" width="45%" alt="Liquid Glass 主题下的中文额度面板">
29
27
  <img src="docs/images/liquid-glass-menu.png" width="45%" alt="中文右键菜单与面板主题子菜单">
@@ -52,8 +50,51 @@
52
50
  - 可选记录最近 7 天的本地额度历史,并在额度卡片中显示趋势
53
51
  - 可分别启用任务完成、失败、等待审批和响应超时的 macOS 系统通知
54
52
  - 内置一个原创素材,更多桌宠可从兼容 PetDex 的素材源按需下载到本机
53
+ - 提供普通的主菜单:概览、会话与 CC Bridge 消息、按模型的 Token 用量、全部设置和内置诊断(见[主菜单](#主菜单))
55
54
  - 使用原生 AppKit,运行时不依赖 Electron
56
55
 
56
+ ## 主菜单
57
+
58
+ 除了右键菜单和悬停额度面板,CC Pets 还有一个普通的 App 窗口,集中看会话、用量和设置。
59
+ 从右键菜单(**主菜单**)、应用菜单或终端都能打开:
60
+
61
+ ```bash
62
+ cc-pets open # 上次看的页面
63
+ cc-pets open overview
64
+ cc-pets open sessions
65
+ cc-pets open usage
66
+ cc-pets open accounts
67
+ cc-pets open general # 还有 pet、accounts、alerts、diagnostics
68
+ ```
69
+
70
+ <p align="center">
71
+ <img src="docs/images/main-menu-overview.png" width="45%" alt="主菜单概览页:宠物、今日 Token 用量和各账号额度卡片">
72
+ <img src="docs/images/main-menu-usage.png" width="45%" alt="主菜单用量页:按模型堆叠的近 30 天每日用量图和模型明细表">
73
+ </p>
74
+
75
+ - **侧边栏**:顶部是会动的当前宠物和它的状态,下面分两组:**工作台**(概览、会话、用量、宠物、多账号)
76
+ 和**通用**(提醒、设置)。诊断放在最底下,有问题要处理时带角标。
77
+ - **概览**:宠物和它此刻在做什么,今日总用量和输入、输出、缓存输入、请求数,诊断发现问题时的提醒,
78
+ 以及 Claude / Codex 的简洁账号卡片:订阅模式展示 5 小时和本周的剩余额度环、重置时间与本周节奏;API 模式展示本月调用、Token 总量,并补充日均调用及输入/输出 Token。数据与悬停面板同源。每个已登记账号独立显示一张卡片,两列排列;「查看诊断」位于名称后,仅在该账号确实有诊断问题时出现。暂未采集到额度不视为配置异常。
79
+ - **会话**:此刻在线的 Agent 会话(等审批的置顶,每行可「跳到终端」),以及 CC Bridge 的
80
+ 消息往来:卡在信箱里待投递的、最近送达的。仅显示消息交互,无消息正文。
81
+ - **用量**:本机 Claude Code / Codex 最近 7、30、90 天的 Token 用量。顶部和概览同一套五格:总用量
82
+ (输入 + 缓存写 + 输出 + 缓存输入)、输入、输出、缓存输入(附命中率)、请求数。每日柱状图按模型分色堆叠,
83
+ 颜色固定跟着模型走,可以在这五项之间切换;点图例或表格里的模型只看它,鼠标移到柱子上看当天各模型的数值。
84
+ 数据全部来自本机会话日志,不会发送到任何地方;按日归档让 Claude Code 清理旧转录之后,历史仍然留得住。
85
+ - **多账号**:添加 Claude / Codex Home,查看账号的目录与集成状态,并通过“管理”菜单修复、重命名、重新定位或移除自定义 Home 的集成。
86
+ - **宠物 / 提醒 / 设置**:桌宠的全部设置拆成三页(宠物:选宠物、大小、碎碎念、点击互动、导入 Codex 素材;提醒:系统通知、桌面状态卡和系统状态;
87
+ 设置:语言、面板外观和素材目录),另有更细的项(比如连击阈值、可以连续调节的玻璃压暗,菜单里仍是四档)。
88
+ 右键菜单只留最常用的几项:管理桌宠、宠物大小、显示消息气泡、用量展示模式、面板主题和 CC Bridge,其余都到这里改。改动会立刻作用到桌面上的宠物,在菜单里改的也会同步显示在这里。
89
+ 会改写 Claude Code / Codex 配置的选项(启用 CC Bridge、免审批)仍只在右键菜单里。
90
+ - **诊断**:和 `cc-pets doctor` 同一套检查,要处理的问题置顶,每条带所属模块、修复命令和「复制命令」;
91
+ 正常项折叠成一行。还有「重新检查」和「复制报告」(路径显示为 `~`,可以直接贴进 issue)。
92
+ 已登记账号的 Hooks 和 Claude status line 问题可点「自动修复」或「全部修复」,修复前备份配置及相关脚本,完成后自动重新检查。备份路径显示在页面上,其中 `manifest.json` 记录原文件路径、权限及备份文件;修复失败时显示原因,其他问题仍需复制命令执行。普通 `cc-pets doctor` 仍然只读。PATH 顺序那一项在这里只提示去终端运行 `cc-pets doctor`:
93
+ 桌宠进程自己的 PATH 不是你终端的 PATH。
94
+
95
+ 窗口在打开时才创建,关闭即释放,关着的时候没有任何后台任务。Dock 图标和菜单栏只在窗口打开期间出现,
96
+ 窗口最小化后点 Dock 图标可以恢复。
97
+
57
98
  ## 互动方式
58
99
 
59
100
  ### Agent 工作状态
@@ -104,7 +145,7 @@ JetBrains IDE、Warp、WezTerm、Ghostty 等在不安装扩展的模式下仅激
104
145
  | 按住并向右拖动 | 播放向右拖行动画,同时移动桌宠 |
105
146
  | 按住并向左拖动 | 播放向左拖行动画,同时移动桌宠 |
106
147
  | 鼠标移开或拖动结束 | 恢复默认待机动画 |
107
- | 右键桌宠 | 切换桌宠、设置历史/通知、在「帮助」中检查更新或查看关于、退出 |
148
+ | 右键桌宠 | 切换桌宠、调大小、消息气泡、用量展示模式、面板主题、CC Bridge、「帮助」、打开主菜单、退出 |
108
149
 
109
150
  右键菜单「宠物大小」提供 50%~200% 的滑动条,拖动时实时缩放并显示百分比,
110
151
  点击「恢复默认」回到 100%。大小会自动保存,切换桌宠或重启后保留;缩放时脚底位置固定。
@@ -119,16 +160,16 @@ Hook 状态卡和消息气泡在宠物小于 100% 时同比例缩小,文字、
119
160
 
120
161
  ### 界面语言
121
162
 
122
- 右键菜单「语言」提供「跟随系统」和所有已打包的语言,目前是「English」「简体中文」。
163
+ 主菜单「设置」页的「语言」提供「跟随系统」和所有已打包的语言,目前是「English」「简体中文」。
123
164
  跟随系统时,取 macOS 首选语言里第一个支持的语言,都不支持就用英文。菜单和面板立即切换;对话框里的系统按钮在下次启动后跟上。
124
165
  选择会写入 `~/.cc-pets/language`,`cc-pets` 命令、hooks 和 CC Bridge 消息因此使用同一种语言;
125
166
  单次命令可以用 `CC_PETS_LANGUAGE=en` 或 `zh-Hans` 覆盖。如果从没改过 `~/.cc-pets/speech.txt`,
126
167
  它会换成新语言的默认台词;改过的台词保持不动。想贡献其他语言的翻译,
127
168
  见 [新增一种语言](./CONTRIBUTING.zh-CN.md#新增一种语言)。
128
169
 
129
- 右键菜单中的“切换桌宠”只扫描 `~/.cc-pets/pets/`(见 [素材管理](#素材管理))和包内素材,
170
+ 右键菜单中的「管理桌宠」只扫描 `~/.cc-pets/pets/`(见 [素材管理](#素材管理))和包内素材,
130
171
  **不会**去读 `~/.petdex/pets/` 和 `~/.codex/pets/`——那两个目录由 PetDex CLI 和 Codex 写入,
131
- 混在一起就找不到自己装的宠物了。要用 Codex 那边的素材,打开右键菜单里的“导入 Codex
172
+ 混在一起就找不到自己装的宠物了。要用 Codex 那边的素材,打开主菜单「宠物」页的“导入 Codex
132
173
  素材”开关,它们会被复制进你自己的目录(见 [导入 Codex 素材](#导入-codex-素材))。
133
174
 
134
175
  外部桌宠使用目录名作为菜单名称,内置桌宠使用素材文件名(不显示扩展名)。选择后立即
@@ -161,7 +202,7 @@ Agent 状态动画会优先播放。
161
202
 
162
203
  右键菜单中的“记录本地额度历史”默认关闭。启用后只在本机
163
204
  `~/Library/Application Support/CC Pets/quota-history.json` 保存最近 7 天的数据,
164
- 每 15 分钟最多记录一次。系统通知也默认关闭,可在“系统通知”子菜单中分别启用任务完成、
205
+ 每 15 分钟最多记录一次。系统通知也默认关闭,可在主菜单「提醒」页分别启用任务完成、
165
206
  任务失败、等待审批和响应超时通知。最后一项在 Agent 停在等待审批超过 2 分钟、
166
207
  或停在思考态超过 5 分钟时提醒一次;该会话有新事件后重新武装,下次卡住会再提醒。
167
208
 
@@ -174,7 +215,7 @@ Provider、脱敏状态和通用说明,不提供消息输入,也不会显示
174
215
  ## 碎碎念
175
216
 
176
217
  桌宠会以自己的口吻讲话:Agent 干活时讲的话直接写在状态卡副行上,闲着的时候单独冒气泡。
177
- 右键菜单「碎碎念」里可以整体开关、调频率、选择台词来源、改台词。
218
+ 主菜单「宠物」页的「碎碎念」里可以整体开关、调频率、选择台词来源、改台词。
178
219
 
179
220
  「台词来源」里可单选 **专属台词** 或 **默认台词**:专属台词优先使用当前宠物的
180
221
  词库,缺少的小节沿用通用词库;默认台词只使用 `~/.cc-pets/speech.txt` 中的通用台词,
@@ -198,7 +239,7 @@ Agent **正在干活**时(思考、调用工具、等待审批、子 Agent 工
198
239
 
199
240
  ### 编辑台词
200
241
 
201
- 右键菜单「碎碎念 → 编辑台词…」打开内置编辑器。桌宠说的**所有**话都在
242
+ 主菜单「宠物」页「碎碎念」里的「编辑台词…」打开内置编辑器。桌宠说的**所有**话都在
202
243
  `~/.cc-pets/speech.txt` 里,代码里没有第二份词库——首次启动时从 app 内的默认词库
203
244
  拷一份出来,之后就只认这个文件。
204
245
 
@@ -232,7 +273,7 @@ Agent **正在干活**时(思考、调用工具、等待审批、子 Agent 工
232
273
 
233
274
  上面那份 `speech.txt` 是**所有**宠物的通用台词。想让某一只换个口吻,编辑器顶部有一个
234
275
  「**通用** / **当前宠物 · ×××**」的切换——切到右边,写的就只属于当前这只宠物,
235
- 存在 `~/.cc-pets/speech/<宠物名>.txt`(内置素材是 `builtin-默认.txt`)。
276
+ 存在 `~/.cc-pets/speech/<宠物名>.txt`(内置素材是 `builtin-ByteMochi.txt`)。
236
277
 
237
278
  这一页**初次打开是空白的,这是正常的**:空白 = 这只宠物全部沿用通用台词。
238
279
  不知道能写什么就点右上角 **填入默认模板**,它会把整份默认台词以**注释状态**填进来
@@ -242,10 +283,10 @@ Agent **正在干活**时(思考、调用工具、等待审批、子 Agent 工
242
283
  手写的话,**只写想改的小节**就行:
243
284
 
244
285
  ```
245
- # ~/.cc-pets/speech/external-哆啦A梦.txt
286
+ # ~/.cc-pets/speech/external-团子.txt
246
287
  [idle]
247
- 铜锣烧…
248
- 口袋里好像有点东西。
288
+ 想吃糯米团…
289
+ 兜里好像有点东西。
249
290
 
250
291
  [done]
251
292
  诺,任意门给你。
@@ -313,7 +354,8 @@ defaults delete com.universewang.cc-pets CCPetsSpeechCooldown # 交
313
354
  ## 系统要求
314
355
 
315
356
  - macOS 13 或更高版本
316
- - Node.js 18 或更高版本
357
+ - Node.js 18 或更高版本,仅供 npm 安装与升级使用;桌宠本身以及 `cc-pets` 命令、Hooks、
358
+ CC Bridge 都是原生程序,运行时不依赖 Node
317
359
  - 已安装并登录 Codex CLI 和/或 Claude Code CLI
318
360
  - zsh
319
361
  - Xcode Command Line Tools,可通过 `xcode-select --install` 安装
@@ -374,6 +416,17 @@ npm 的安装后脚本会自动构建原生应用、安装两套 Agent Hooks,
374
416
  `codex` 与 `claude` 软链,再向 `~/.zshrc` 追加带明确标记的一行把该目录前置到 `PATH`,不会覆盖真实的 CLI 二进制。
375
417
  用 shim 而不是 alias,是因为 alias 名区分大小写而 macOS 文件系统默认不区分:`Claude`、`CODEX` 这类写法
376
418
  匹配不到 alias,会直接命中真二进制,桌宠不会被拉起。shim 让任意大小写写法都落到同一个文件上。
419
+
420
+ ### 多账号
421
+
422
+ CC Pets 会自动发现并集成官方 `~/.claude` 和 `~/.codex` Home。`~/.claude-x`、
423
+ `~/.codex-work` 等自定义 Home 不会被自动扫描,必须从「主菜单 → 多账号」(位于“宠物”下方)手动添加。
424
+ 默认使用文件夹名作为账号名称并保持原样,也可以在该页的“管理”菜单中重命名。每个 Provider
425
+ 拥有独立的循环额度卡片,用量页也可以按账号筛选本机会话 Token 历史。
426
+
427
+ 添加账号时会配置 Pet Hooks 和用量采集。若 CC Bridge 已开启,会同时配置它的 Hooks、
428
+ 权限与 MCP;若尚未开启,之后启用 CC Bridge 时会自动为所有已登记账号补齐。
429
+
377
430
  首次安装需要新开终端让 `PATH` 生效;以后升级只需执行 npm 命令。
378
431
  同时会将标准 macOS 应用安装到 `~/Applications/CC Pets.app`,可从 Finder 或 Launchpad 启动,
379
432
  不需要管理员权限。npm 升级时会同步更新该应用。
@@ -428,6 +481,9 @@ cc-pets clean
428
481
  # 检查安装、Hooks、status line、shim 与 CC Bridge 是否正常,并给出修复建议;输出已脱敏,可直接贴进 issue
429
482
  cc-pets doctor
430
483
 
484
+ # 打开主菜单并定位到页面(overview / sessions / usage / pet / accounts / alerts / general / diagnostics,省略则打开上次看的页面)
485
+ cc-pets open [page]
486
+
431
487
  # 列出偏好、桌宠素材、台词、缓存与运行时状态的存放位置和大小(--json 输出机器可读格式)
432
488
  cc-pets paths
433
489
 
@@ -527,7 +583,10 @@ Codex 侧同理:桌宠固定只统计 `~/.codex`,不读继承来的 `CODEX_H
527
583
  自然日窗口(今日 = 本机零点至今,最近 7 天 = 含今天在内的 7 个自然日),因为两家的
528
584
  `resets_at` 并不一致,按各自订阅窗口算出的数不在同一区间上,相加没有意义。每个 Agent 卡片按 5 小时和 7 天两列
529
585
  展示官方剩余百分比(主值)、本机 Token 用量和重置时间,右侧是近 7 天额度趋势。右键菜单的
530
- “用量展示模式”可分别为 Codex、Claude 选择“订阅额度”或“API 用量”;API 用量模式只替换对应
586
+ “用量展示模式”保留原有切换控件,按已登记账号分别设置,旧的平台设置作为未单独设置账号的默认值。
587
+ 明确识别为 API 认证时,固定显示 API 用量并禁用切换;订阅认证仍可在“订阅额度”和“API 用量”之间切换。
588
+ 认证类型不明时保留手动切换;缺少额度数据不会被当作 API 认证的证据。认证类型在后台刷新,不记录密钥或 CLI 认证输出。
589
+ API 用量模式只替换对应
531
590
  卡片内部,展示本月调用次数、本月输入/输出 Token、较上月同期变化和本月按日 Token 趋势。
532
591
  “调用次数”来自本机会话记录:Claude 按请求标识去重,Codex 按去重后的累计 Token 快照计数。
533
592
  某个窗口
@@ -556,7 +615,7 @@ Codex 侧同理:桌宠固定只统计 `~/.codex`,不读继承来的 `CODEX_H
556
615
 
557
616
  ## 素材与版权
558
617
 
559
- **本项目不自建素材仓库。** 仓库和 npm 包里只有一个内置素材 `默认.webp`(原创角色
618
+ **本项目不自建素材仓库。** 仓库和 npm 包里只有一个内置素材 `ByteMochi.webp`(原创角色
560
619
  ByteMochi,随代码按 MIT License 分发)。其余桌宠素材一律**由用户自己从素材源按需下载**
561
620
  到本机 `~/.cc-pets/pets/`,既不进仓库,也不进 npm 发布包。
562
621
 
@@ -581,7 +640,7 @@ v2(`1536×2288`、`8×11`),单元格均为 `192×208`,前九行遵循相
581
640
  ```bash
582
641
  cc-pets pet search otter # 搜索可用素材(不带关键词就列全部)
583
642
  cc-pets pet add boba # 下载到 ~/.cc-pets/pets/boba/
584
- cc-pets pet add boba doraemon # 一次装多个
643
+ cc-pets pet add boba otterumells # 一次装多个
585
644
  cc-pets pet list # 列出已安装的素材,按来源分组
586
645
  cc-pets pet remove boba # 删除
587
646
  cc-pets pet source # 列出可用的素材源
@@ -599,7 +658,7 @@ cc-pets pet search petdex:otter
599
658
  ```
600
659
 
601
660
  一个源的完整定义就是清单地址、资源 host 白名单和 Referer 三项,集中在
602
- `scripts/pet-store.mjs` 顶部的 `SOURCES` 表里。以后接自建 registry 时在表里加一行即可,
661
+ `Sources/CCPets/Pet/CCPetsPetStore.m` 的 `Sources()` 表里。以后接自建 registry 时在表里加一行即可,
603
662
  命令、目录结构和桌宠端都不用改。默认源用 `CC_PETS_SOURCE` 切换。
604
663
 
605
664
  来源记录在宠物目录内的 `.source.json`(`{ "source", "slug", "installedAt" }`),下载来的
@@ -620,7 +679,7 @@ cc-pets pet add boba --as 波霸
620
679
 
621
680
  #### 导入 Codex 素材
622
681
 
623
- 桌宠不读 `~/.codex/pets/`。如果你在 Codex 桌面端已经装了一批素材,打开右键菜单里的
682
+ 桌宠不读 `~/.codex/pets/`。如果你在 Codex 桌面端已经装了一批素材,打开主菜单「宠物」页的
624
683
  **“导入 Codex 素材”** 开关,桌宠会把那里的素材**复制**进 `~/.cc-pets/pets/`:开关打开的
625
684
  当下导入一次,之后每次启动再导入一次。
626
685
 
@@ -654,6 +713,8 @@ PetDex 官方 CLI(`npx petdex install <slug>`)会把素材放在 `~/.petdex/
654
713
 
655
714
  - Codex 额度通过本机 Codex CLI 启动的官方 App Server 读取,沿用 Codex CLI 自身的登录状态;Codex Token 只从本机 `~/.codex/sessions` 读取(可用 `CC_PETS_CODEX_HOME` 覆盖)。
656
715
  - Claude 额度只从 Claude Code 传给本机 status line 的 `rate_limits` 字段读取。
716
+ - 为区分 API 账号和订阅账号,CC Pets 会读取各已登记 Home 中的认证配置(Claude 的 `settings.json`;Codex 的 `auth.json` 和 `config.toml`),并可能在本机运行该 Home 的 `claude auth status` / `codex login status`。只在内存中保留识别出的模式,不保存密钥、邮箱或命令输出。
717
+ - 诊断页修复前,会把受影响的配置文件和脚本备份到 `~/Library/Application Support/CC Pets/diagnostic-backups/`(仅本人可读),备份只保存在本机。
657
718
  - Agent Hooks 只向当前用户的临时目录写入桌宠事件和额度缓存。
658
719
  - 额度历史默认关闭;启用后只在本机保留最近 7 天的剩余比例快照。
659
720
  - 状态气泡和通知只显示 Provider、状态及脱敏工具类别,不显示会话正文。