cc-pets 2.0.1 → 2.1.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.
- package/CC_BRIDGE.md +239 -0
- package/CC_BRIDGE.zh-CN.md +210 -0
- package/CHANGELOG.md +39 -0
- package/CHANGELOG.zh-CN.md +39 -0
- package/PROVIDER_PROTOCOL.md +6 -0
- package/PROVIDER_PROTOCOL.zh-CN.md +5 -0
- package/README.md +26 -0
- package/README.zh-CN.md +25 -2
- package/Resources/Info.plist +2 -0
- package/Sources/CCPets/CCPetsAppDelegate.h +25 -0
- package/Sources/CCPets/CCPetsAppDelegate.m +751 -29
- package/Sources/CCPets/CCPetsBridge.h +43 -0
- package/Sources/CCPets/CCPetsBridge.m +198 -0
- package/Sources/CCPets/CCPetsEvents.m +7 -2
- package/Sources/CCPets/CCPetsPaths.h +4 -0
- package/Sources/CCPets/CCPetsPaths.m +6 -0
- package/Sources/CCPets/CCPetsQuotaHistory.m +9 -2
- package/Sources/CCPets/CCPetsTerminalFocus.h +11 -0
- package/Sources/CCPets/CCPetsTerminalFocus.m +150 -0
- package/Sources/CCPets/PetView.m +86 -1
- package/Sources/CCPets/QuotaDashboardView.m +17 -4
- package/Sources/CCPets/main.m +5 -0
- package/bin/cc-pets +5 -0
- package/bin/claude-with-pet +8 -2
- package/bin/codex-with-pet +8 -3
- package/package.json +3 -1
- package/scripts/bridge/cli.mjs +229 -0
- package/scripts/bridge/core.mjs +227 -0
- package/scripts/bridge/hook.mjs +149 -0
- package/scripts/bridge/install.mjs +288 -0
- package/scripts/bridge/mcp-server.mjs +300 -0
- package/scripts/bridge/options.mjs +86 -0
- package/scripts/bridge/process.mjs +129 -0
- package/scripts/bridge/reservations.mjs +247 -0
- package/scripts/bridge/store.mjs +432 -0
- package/scripts/bridge/watch.mjs +69 -0
- package/scripts/install-shell-integration.sh +3 -0
- package/scripts/uninstall-integrations.mjs +10 -0
package/README.zh-CN.md
CHANGED
|
@@ -23,9 +23,13 @@
|
|
|
23
23
|
- 支持拖动桌宠位置,右键刷新用量、检查更新或退出
|
|
24
24
|
- 响应 Codex 与 Claude Code Agent 的思考、工具调用、审批、子 Agent、完成和失败状态
|
|
25
25
|
- 在桌宠旁显示脱敏后的玻璃 Agent 状态卡片,可展开、折叠并显示活跃 CLI 会话数
|
|
26
|
+
- 点击任意 Hook 状态卡,可返回触发该事件的终端;直接启动、没走包装脚本的会话同样可以回跳
|
|
27
|
+
- 点击状态卡右侧圆形图标,可从最近 8 个在线 Agent 终端会话中选择并回跳
|
|
28
|
+
- 圆形图标右上角以角标显示正在等待审批的会话数,这些会话在会话列表中置顶
|
|
29
|
+
- Agent 停在等待审批或思考态超过阈值时主动提醒,并把状态卡重新推到眼前
|
|
26
30
|
- 支持第三方 CLI Agent 通过统一 Provider 事件协议接入动画和状态
|
|
27
31
|
- 可选记录最近 7 天的本地额度历史,并在额度卡片中显示趋势
|
|
28
|
-
-
|
|
32
|
+
- 可分别启用任务完成、失败、等待审批和响应超时的 macOS 系统通知
|
|
29
33
|
- 内置一个原创素材,更多桌宠可从兼容 PetDex 的素材源按需下载到本机
|
|
30
34
|
- 使用原生 AppKit,运行时不依赖 Electron
|
|
31
35
|
|
|
@@ -55,6 +59,17 @@ Claude Code Hook 会合并到 `~/.claude/settings.json`,现有的 `env`、`mod
|
|
|
55
59
|
通过 npm 安装或升级时会自动重新构建应用、安装或更新两套 Hooks,并配置 shell 集成;如果旧版桌宠正在运行,
|
|
56
60
|
安装器会自动重启桌宠,使新版本生效。`cc-pets install` 用于手动修复或重新初始化。
|
|
57
61
|
|
|
62
|
+
通过 `codex-with-pet` / `claude-with-pet` 启动时,包装脚本会在 Agent 启动前记录终端身份,
|
|
63
|
+
这是最精确的来源。直接运行 `codex` / `claude`、或终端窗口早于 shim 安装就已打开的会话,
|
|
64
|
+
会回退到内核信息:从进程树解析控制终端和承载终端的应用,这些会话的状态卡同样可以点击回跳。
|
|
65
|
+
这类会话没有 pid 文件,只要 Hook 还在持续发事件就会留在最近会话列表里,闲置 60 秒后移出列表。
|
|
66
|
+
|
|
67
|
+
所有 Hook 状态卡都可以点击;右侧圆形状态图标会展开最近 8 个在线 Agent 终端会话。
|
|
68
|
+
macOS Terminal 和 iTerm2 会按 TTY 精确选中对应标签页或 Session。VS Code、
|
|
69
|
+
JetBrains IDE、Warp、WezTerm、Ghostty 等在不安装扩展的模式下仅激活对应应用;应用
|
|
70
|
+
内部标签页是否恢复由应用自身决定。首次回跳 Terminal 或 iTerm2 时,macOS 可能要求
|
|
71
|
+
允许 CC Pets 控制该终端应用。
|
|
72
|
+
|
|
58
73
|
### 鼠标互动
|
|
59
74
|
|
|
60
75
|
| 操作 | 桌宠反馈 |
|
|
@@ -106,7 +121,8 @@ Agent 状态动画会优先播放。
|
|
|
106
121
|
右键菜单中的“记录本地额度历史”默认关闭。启用后只在本机
|
|
107
122
|
`~/Library/Application Support/CC Pets/quota-history.json` 保存最近 7 天的数据,
|
|
108
123
|
每 15 分钟最多记录一次。系统通知也默认关闭,可在“系统通知”子菜单中分别启用任务完成、
|
|
109
|
-
|
|
124
|
+
任务失败、等待审批和响应超时通知。最后一项在 Agent 停在等待审批超过 2 分钟、
|
|
125
|
+
或停在思考态超过 5 分钟时提醒一次;该会话有新事件后重新武装,下次卡住会再提醒。
|
|
110
126
|
|
|
111
127
|
Agent 状态卡片会根据屏幕剩余空间自动显示在桌宠上方或下方。点击桌宠旁的圆形箭头可以
|
|
112
128
|
折叠卡片;折叠后圆钮会显示当前活跃的 Codex/Claude CLI 会话数,点击后重新展开。卡片只展示
|
|
@@ -374,6 +390,11 @@ printf '%s' '{"schemaVersion":1,"provider":"MyAgent","state":"thinking"}' \
|
|
|
374
390
|
# 手动修复或重新初始化 Hooks、shell 集成,并让已运行桌宠加载当前版本
|
|
375
391
|
cc-pets install
|
|
376
392
|
|
|
393
|
+
# CC Bridge(实验性,默认关闭):让本机 Claude Code / Codex 会话互发消息,详见 CC_BRIDGE.zh-CN.md
|
|
394
|
+
cc-pets bridge enable
|
|
395
|
+
cc-pets bridge status
|
|
396
|
+
cc-pets bridge disable
|
|
397
|
+
|
|
377
398
|
# 安全移除 Hooks、恢复 Claude status line,并清理 shell 集成
|
|
378
399
|
cc-pets uninstall
|
|
379
400
|
|
|
@@ -575,6 +596,8 @@ PetDex 官方 CLI(`npx petdex install <slug>`)会把素材放在 `~/.petdex/
|
|
|
575
596
|
- 状态气泡和通知只显示 Provider、状态及脱敏工具类别,不显示会话正文。
|
|
576
597
|
- 项目不上传会话内容、额度、凭据或使用统计,也不包含遥测服务。
|
|
577
598
|
- 右键“退出桌宠”或执行 `cc-pets uninstall` 后,不会继续运行后台守护进程。
|
|
599
|
+
- [CC Bridge](./CC_BRIDGE.zh-CN.md) 默认关闭;开启后,会话之间的消息正文会保存在当前用户的临时目录
|
|
600
|
+
(仅本人可读,24 小时过期),这是本项目唯一会保存正文的功能。
|
|
578
601
|
|
|
579
602
|
## 卸载
|
|
580
603
|
|
package/Resources/Info.plist
CHANGED
|
@@ -34,19 +34,44 @@
|
|
|
34
34
|
@property NSTextField *statusTitleLabel;
|
|
35
35
|
@property NSTextField *statusDetailLabel;
|
|
36
36
|
@property NSButton *statusIconButton;
|
|
37
|
+
@property NSButton *statusClickButton;
|
|
38
|
+
// 圆形状态图标右上角的待审批角标。状态卡正文永远跟着最新事件走,角标负责让
|
|
39
|
+
// "还有几个会话在等你确认"始终留在视线里。
|
|
40
|
+
@property NSView *approvalBadgeView;
|
|
41
|
+
// CC Bridge 消息角标(图标右下角)与其数据:会话名、最近送达、信箱积压。
|
|
42
|
+
// bridgeSeenAt 之后送达的消息算"未读",打开会话菜单即更新。
|
|
43
|
+
@property NSView *bridgeBadgeView;
|
|
44
|
+
@property NSTimeInterval bridgeSeenAt;
|
|
45
|
+
@property NSDictionary<NSString *, NSDictionary *> *bridgeSessions;
|
|
46
|
+
@property NSArray<NSDictionary *> *bridgeRecentDeliveries;
|
|
47
|
+
@property NSArray<NSDictionary *> *bridgeDeliveryCache;
|
|
48
|
+
@property NSDate *bridgeSentStamp;
|
|
49
|
+
@property NSDictionary<NSString *, NSNumber *> *bridgePendingCounts;
|
|
50
|
+
// 菜单开关触发的 cc-pets bridge 命令正在执行时为 YES,期间忽略新的切换,避免并发改配置。
|
|
51
|
+
@property BOOL bridgeCommandRunning;
|
|
52
|
+
// 已为哪个时间点之前的送达发过系统通知。
|
|
53
|
+
@property NSTimeInterval bridgeNotifiedAt;
|
|
37
54
|
@property BOOL statusBubbleExpanded;
|
|
38
55
|
@property BOOL statusBubbleAbove;
|
|
39
56
|
@property BOOL hasAgentStatus;
|
|
40
57
|
@property NSInteger liveClientCount;
|
|
41
58
|
@property NSString *lastStatusState;
|
|
42
59
|
@property NSString *lastStatusProvider;
|
|
60
|
+
@property NSDictionary *lastTerminalFocusTarget;
|
|
43
61
|
@property NSTimeInterval lastStatusTimestamp;
|
|
44
62
|
@property NSSet<NSString *> *liveClientProviders;
|
|
63
|
+
// 包装脚本仍存活的精确 Agent 会话,键为 provider + TTY。
|
|
64
|
+
@property NSSet<NSString *> *liveAgentSessionKeys;
|
|
45
65
|
// 每个 provider 最近一次事件的时间。不经包装脚本启动的客户端没有 pid 文件,
|
|
46
66
|
// 只能靠"最近还在发事件"证明自己活着。
|
|
47
67
|
@property NSMutableDictionary<NSString *, NSNumber *> *providerActivityAt;
|
|
48
68
|
@property BOOL hasUnlabeledClient;
|
|
49
69
|
@property NSMutableDictionary<NSString *, NSDictionary *> *pendingApprovalRecords;
|
|
70
|
+
// 按终端会话保存最后一条 Hook 状态,供状态图标展开最近多会话列表。
|
|
71
|
+
@property NSMutableDictionary<NSString *, NSDictionary *> *agentSessionRecords;
|
|
72
|
+
// 已经就"卡住"提醒过的会话,元素是会话键 + 该会话当时的时间戳。会话一有新事件
|
|
73
|
+
// 时间戳就变,旧元素随之失效,于是下一次卡住还会再提醒一次。
|
|
74
|
+
@property NSMutableSet<NSString *> *stallNotifiedSessionKeys;
|
|
50
75
|
@property QuotaDashboardView *quotaView;
|
|
51
76
|
@property BOOL managedByCLI;
|
|
52
77
|
@property BOOL pocketHovering;
|