cc-pets 1.4.7 → 2.0.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/CHANGELOG.md CHANGED
@@ -1,283 +1,46 @@
1
1
  # 更新记录
2
2
 
3
- 本项目遵循语义化版本号。
3
+ 本项目遵循语义化版本号。版本号以 `package.json` 为唯一来源。
4
4
 
5
- ## [Unreleased]
5
+ ## [2.0.0] - 2026-08-23
6
6
 
7
- - 台词可以按宠物分别配置了。`~/.cc-pets/speech.txt` 仍是所有宠物的通用台词,某一只想换
8
- 口吻时在 `~/.cc-pets/speech/<宠物名>.txt` 里**只写想改的小节**,没写的照旧走通用。
9
- 台词编辑器顶部多了「通用 / 当前宠物」的切换,切换宠物时自动跟随。
10
- - 回落按**小节整体**做,不按行合并:专属写了 `[idle]` 就只说专属那几句,通用那一节
11
- 一句都不参与。按行合并的话,用户没有任何写法能表达"这只宠物这句话不要说"。
12
- - 判据是"这一节在不在"而不是"有没有内容":专属里写了标签却不写台词,表示这只宠物在
13
- 这个情境闭嘴。当成"空的等于没写"去回落的话,这个意图就再也写不出来了。
14
- - 专属词库的校验规则单独一套:缺小节是常态(缺就回落),所以"标签不能删"和
15
- "`[state_*]` 至少留一句"都不适用。套通用规则的话,用户想改一句话得先抄一整份
16
- 22 节的文件过来。同理,保存时不给专属文件补标签——补完之后每一节都"存在",
17
- 这只宠物就再也不会回落了。
18
- - 专属页右上角有「填入出厂模板」,解决空白页无从下手。填进来的是整份**注释状态**的
19
- 出厂台词:用户看得见每一节能写什么,而注释一行都不算数,所以填完之后仍然全部回落到
20
- 通用,想让哪一节归这只宠物管就去掉那一节的 `#`。直接填未注释的完整出厂台词是错的——
21
- 那样 22 节全被接管,再也不会回落;只填小节头的空骨架更糟,等于这只宠物全情境闭嘴。
22
- - 专属文件懒创建,不预先给每只宠物生成空文件:空文件和没有文件语义完全一样,
23
- 凭空造一堆只会让目录全是噪音。删掉宠物素材也不删它的台词文件,装回来还在。
7
+ 首个开源版本。
24
8
 
25
- - 修复台词编辑器里 ⌘C/⌘V/⌘X/⌘A/⌘Z/⌘⇧Z 全部没反应。这些快捷键不是 `NSTextView` 自己
26
- 处理的:按键先走 `NSApp.mainMenu` 的 `performKeyEquivalent:`,命中菜单项之后才沿响应者链
27
- 发 `copy:` / `paste:` 这些消息。这个 app 是 `LSUIElement`,此前从没设过主菜单,所以全部
28
- 落空。现在装一个只有「编辑」的主菜单——`LSUIElement` 按定义不显示自己的菜单栏,它只是
29
- 一张快捷键路由表,用户看不见。菜单项的 target 一律留空交给响应者链,以后新加的文本框
30
- 自动就有这些快捷键。
31
- - 修复 `npm install` 失败:`package.json` 的 `files` 白名单逐个列 `Resources/` 下的文件,
32
- 新增的 `Resources/phrases.default.txt` 没进去,发布包里没有这个文件,`build.sh` 拷贝那一步
33
- 直接失败。本地从工作树构建看不出来,所以给发布包完整性测试补上了资源文件这一档。
9
+ ### 桌宠与互动
34
10
 
35
- - 用户词库改名 `~/.cc-pets/phrases.txt` → `~/.cc-pets/speech.txt`。换名字是为了让"迁移过
36
- 没有"变成一个平凡的判断(新文件在就是迁移过了)——靠猜内容特征(有没有 replace 行、
37
- 缺不缺某个小节)都不可靠,用户改过之后更没法判断。
38
- - 老词库在**启动时**就自动合并进新文件,不等用户打开编辑器:拖到那时候再迁移的话,
39
- 从升级到他第一次点"编辑台词"这段时间,桌宠说的会是出厂台词而不是他自己写的,
40
- 而没人会把这件事和"我该去点一下编辑台词"联系起来。合并规则是"出厂 + 用户"取并集,
41
- 因为老语义就是两者混着说;老文件里写过 `replace` 的,他写过的那几节按他的来,
42
- 没写过的仍旧用出厂内容(照搬老语义会让 15 个 `state_` 小节全空,而新版没有兜底文案,
43
- 状态卡副行会直接残掉)。老文件里的注释一概不搬,按新模板的来。
44
- - 老文件合并后先留着,第一次打开编辑器时问一次要不要改名成 `phrases.txt.bak` 收起来——
45
- 合并是我们替用户做的,动他的文件得他自己点头。改名而不是删除:内容还在原地,万一合并
46
- 合错了还能翻出来对;而 `PetPhrasesLegacyFilePath` 只认 `phrases.txt`,改完名它既不会
47
- 再被当成迁移源,也不会再弹询问。留着原名不动有两个坑:改它不会有任何效果,而且哪天
48
- `speech.txt` 丢了,启动时会再从它合并一遍,把用户迁移之后写的台词全冲掉。
49
- - 台词改成"文件即全部":删掉代码里的内置词库,默认台词变成随 app 打包的
50
- `Resources/phrases.default.txt`,首次启动拷到 `~/.cc-pets/phrases.txt`,之后运行时
51
- 只认这个文件。同时删掉 merge / `replace` 两种模式——运行期同时存在两份词库就必然
52
- 要回答"以谁为准",而那正是原来那套配置让人看不懂的根源。现在删掉一节就是那个情境
53
- 不吭声,用户看到的文件就是桌宠的全部台词。
54
- - 台词编辑从「交给系统文本编辑器」换成 app 内置编辑器。原来那条路没有任何反馈:
55
- 小节名拼错、句子超 30 字、槽位写错名字全是静默失效,用户只知道"改了没用"。
56
- - 标签行被删掉时,保存会自动把它加回原位并告知补了哪些(⌘Z 可撤销)。光报错等于把人
57
- 卡死:编辑器里已经看不到那一行,用户既不知道少的是哪个,也不知道该写成什么样,
58
- 只能翻文档或者点"恢复出厂"把自己的改动全丢掉。标签被删而台词还在时,那串台词会并进
59
- 上一节,所以标签要插回那串台词**前面**才能带着它们一起归位;标签连着台词一起删掉的
60
- 情况下只补标签,不能顺手把上一节的台词抢过来。
61
- - 保存时校验并当场列出问题。标签行是配置项,22 个一个都不能删;
62
- 能不能留空才分两种——`[state_*]` 是状态卡副行的唯一正文来源,空了也拦,情绪句留空
63
- 只提示(就是那个情境不主动开口)。"整行被删"和"还在但空了"分开报,因为要做的动作
64
- 不一样:一个是把 `[标签]` 那行加回来,一个是补句台词。槽位名拼错也会报——这类最难自查。
65
- - 连续的"不在任何 [情境] 下面"的散句合并成一条提示。删掉一个小节头会让它下面整串台词
66
- 变成散句,逐行报的话十几条提示会把真正该看的那条错误挤下去。
67
- - 编辑器的保存分成「保存」(⌘S)和「保存并关闭」(⏎)。⌘S 而不是回车是因为这是多行
68
- 文本编辑器,回车要用来换行。校验没过或 mtime 冲突被取消时不关窗,避免改动跟着窗口一起没。
69
- - 编辑器新增「试说一句」:选一个情境,桌宠当场说出来。读的是还没保存的文本,槽位用
70
- 示例数据填,不用等真的额度告急才能看到效果。另有「恢复出厂台词…」(可 ⌘Z 撤销)。
71
- - 保存前比对 mtime,文件被外部改过时问一次,可选覆盖或重新载入,不静默吃掉别人的改动。
72
- - 状态卡副行没有内容时收成单行,不再留一块空白——代码里已经没有兜底文案了,
73
- 外部编辑器清空某个 `state_` 小节时显示层必须自己站得住。
11
+ - macOS 原生 AppKit 桌宠,运行时不依赖 Electron,也不需要 Codex/Claude 桌面端。
12
+ - 待机呼吸、随机小动作、拖动滞后与落脚回弹;头部、口袋、脚部和身体两侧的悬停与点击反馈。
13
+ - 右键菜单可切换桌宠、刷新用量、开关额度历史与系统通知、检查更新或退出。
14
+ - 支持内置素材与 `~/.cc-pets/pets/` 下的外部素材,兼容 `spriteVersionNumber` v1 / v2 网格。
74
15
 
75
- - 碎碎念不再受"agent 是否在线"影响。原来的闸门是"状态卡可见就闭嘴",而状态卡只要客户端
76
- 活着就常驻,等于开着终端就永远不会碎碎念——独立气泡那条路径实际上从来没跑到过。
77
- 改成按"agent 在不在干活"判断:只有状态卡处于 idle 或根本没显示时才说话,thinking /
78
- tool / approval / notification / completed / failed 的工作文案优先级最高,闲话一律让路。
79
- - 碎碎念借走状态卡副行说完一句后会自动还原状态文案(`restoreStatusDetail`),此前借走就
80
- 不还,副行会一直挂着上一句闲话;同时不再用闲话覆盖 `lastPetVoiceText`,那是状态文案的
81
- 去重缓存,被污染后下一次同状态事件会把闲话当成该状态的文案复读出来。
82
- - 右键菜单「碎碎念」新增频率四档(很少 / 正常 / 较多 / 话痨)。每小时预算、两句间隔、
83
- 静默门槛、出话概率这四道闸互相牵制,单调任何一道都不会真的变频繁,所以只对用户暴露
84
- 一个档位、四个值一起走;正常档即改造前的原值。`CCPetsSpeechCooldown` 与
85
- `CCPetsSpeechHourlyBudget` 保留为更细的手动覆盖,写了就压过档位。
86
- - README 补齐「碎碎念」一节:频率档位表、`phrases.txt` 写法、槽位与情境标签契约、
87
- 调试用的 `defaults` 键(含域名必须是 bundle identifier 这一点)。
16
+ ### 额度与用量
88
17
 
89
- ## [1.3.2] - 2026-08-19
90
- ### 桌宠活物感改造
18
+ - 从本机 `~/.codex/sessions` 与 Claude Code 官方 status line 数据读取 5 小时额度、周额度和重置时间。
19
+ - 悬停口袋展开额度面板,用两张卡分别展示 Codex、Claude 的剩余百分比、本机 Token 与近 7 天趋势。
20
+ - 可选记录最近 7 天的本地额度历史;默认关闭,仅保存在本机。
21
+ - 支持「订阅额度 / API 用量」两种展示模式。
91
22
 
92
- - 渲染层从 `drawRect:` 改为 layer-backed,精灵内容挂在独立的 `CALayer` 上,为呼吸和拖动
93
- 物理让路——这两样必须走 Core Animation:插值和合成都在 render server 侧,主进程零唤醒;
94
- 若走 `drawRect:`,呼吸要平滑就得约 20fps,而动画定时器原本才 4.5 次/秒,一项就能把
95
- 常驻开销全部吐回去。为此新增 `--render-pet` 逐格渲染 PetView 并逐字节比对(原有三个
96
- `--render-*` 一格宠物都不画,改坏 PetView 它们照样全绿)。改造过程中它抓到两次
97
- 等价性破坏:素材经 `LoadPetSpriteImage` 缩略后未必能被行列整除(默认素材单格高
98
- 151.67px),`CGImageCreateWithImageInRect` 预裁会把小数矩形取整、`contentsRect` 交给
99
- CA 缩放也有自己的采样相位,两者都和原来的 `drawInRect:fromRect:` 对不上,边缘整行错位。
100
- 最终照搬原绘制调用按格预栅格化并缓存,9 行与 11 行素材均逐字节一致。
101
- - 屏幕睡眠时一并冻结 layer 时间轴并清空栅格化缓存。停表只管得住 `NSTimer` 驱动的逐帧
102
- 动画,CA 动画的时钟在 render server 那边,屏幕睡了照跑。
103
- - 待机加入呼吸(1.5px 上浮,`reduceMotion` 下不启用)。只向上不做对称摆动:宠物视图在
104
- 230×170 窗口里位于 (43,0,144,150),下方没有余量,往下 1px 就被窗口裁掉。
105
- - 拖动加入水平滞后与落脚 squash。拖动由窗口服务器接管、拿不到连续事件,改从
106
- `NSWindowDidMoveNotification` 取位移。只做水平方向:左右各有 43px 余量,垂直方向下方是 0。
107
- - 待机微动层:每 8~25 秒(泊松随机)做一个有始有终的小动作。11 行素材按角度顺序连播
108
- row 9/10 的朝向格,等于白捡一个转头动画——那 16 格本是静止姿势,连起来就是转头,不需要
109
- 任何新素材;9 行素材退到 row 3 张望。**不再改待机循环本身的节奏**:随机长停某一帧和整轮
110
- 变速都试过,素材不受控(第 0 帧不保证是自然站姿),一律被读成"动画卡住了"。
111
- - 内在状态:无聊曲线(闲置 2/10/30 分钟三档,微动频率先升后降)、生理余韵(agent 事件累积
112
- 用力值,25 秒半衰期,呼吸分三档快慢)、注意力惯性(鼠标移动 88% 被忽略,被吸引后 3~8 秒
113
- 失去兴趣,再冷却 4~12 秒)。注意力惯性顺带把绕宠物移动鼠标时的开销压了下来。
114
- - 无聊曲线的计时基准是真实事件流而不是 `agentActive`:`mouseDown:` 会无条件清掉后者,
115
- 用户随手点一下宠物就会让曲线误启动。上次交互时间落盘,隔几小时再开机从"打盹"档开始。
116
- - 素材能力(是否有十六向朝向行)在换素材时算一次,微动改为按能力过滤的数据表;行数判断从
117
- 四处收敛到一处,两档行为密度保持一致,切换素材应读作"性格不同"而非"功能残缺"。
23
+ ### Agent 状态
118
24
 
119
- ### 状态卡改由宠物口吻叙述
25
+ - 由 Codex Hooks 与 Claude Code Hooks 驱动思考、工具调用、审批、子 Agent、完成与失败动画。
26
+ - 桌宠旁显示脱敏后的玻璃状态卡片,可折叠并显示活跃 CLI 会话数。
27
+ - 可分别启用任务完成、失败和等待审批的 macOS 系统通知。
28
+ - 第三方 CLI Agent 可通过统一 Provider 事件协议接入,详见 `PROVIDER_PROTOCOL.md`。
120
29
 
121
- - 每个 hook 状态的副行文案改为宠物口吻,从台词库随机取、带最近使用抑制,同一状态每次读到的
122
- 不一样。原来"正在调用工具…"一句覆盖四类工具,现在执行命令/编辑文件/查找资料/子 Agent
123
- 各说各的,信息量反而更大。取不到台词时回落原系统文案。
124
- - 排版层级反转:事实降为眉标(11pt Medium 浅灰),宠物的话升为正文(14pt Medium 深色)。
125
- - 状态卡与说话气泡按文案长度伸缩,不再是固定宽度。宽度用控件自身的 `fittingSize` 量——
126
- 按字符串量的 `sizeWithAttributes:` 比 `NSTextField` 真正需要的窄几个点,会让"刚好够"
127
- 变成省略号。
128
- - 新增"碎碎念":额度告急、连续失败、深夜、久坐、久别重逢等时刻主动说一句。每小时上限 4 句
129
- 且两句间隔至少 4 分钟——状态播报不受此限,那是替换样板文案而非额外说话。有状态卡时话并入
130
- 它的副行,没有才起独立气泡,同一时刻屏幕上只有一个东西在说话。
131
- - 额度台词按档位下穿触发(20%/10%/5%),不是"低于阈值就一直说";额度是分钟级刷新的,
132
- 不设档一小时预算瞬间烧光。回血后档位回升,下个周期才能再触发。
30
+ ### 台词
133
31
 
134
- ### 自定义台词
32
+ - 桌宠台词全部来自 `~/.cc-pets/speech.txt`,可在内置编辑器中修改,支持实时数据槽位。
33
+ - 可为单只宠物写专属台词(`~/.cc-pets/speech/<宠物名>.txt`),按小节整体覆盖通用台词。
34
+ - 四档碎碎念频率,Agent 工作期间不插嘴。
135
35
 
136
- - 支持 `~/.cc-pets/phrases.txt` 自定义台词,右键菜单"碎碎念 → 自定义台词…"生成模板并打开。
137
- 模板写满中文说明与逐条示例,取消注释即生效。
138
- - 格式是纯文本而非 JSON:普通用户写不了 JSON,且少个逗号就整个文件失效、我们静默回落内置,
139
- 用户只会觉得"改了没用"。纯文本逐行解析,写错只丢那一行。
140
- - 用户台词永远按数据处理,绝不交给 `stringWithFormat:`——一个 `%@` 就会让桌宠当场崩溃。
141
- 测试里有断言守着这条,以及行尾注释剥离、超长条目丢弃、槽位缺值时整条作废(宁可不说,
142
- 也不吐出带花括号的半成品)。
36
+ ### 安装与集成
143
37
 
144
- ### 已知未完成
38
+ - `npm install -g cc-pets` 自动构建原生应用、安装两套 Hooks 与 shell 集成,并安装
39
+ `~/Applications/CC Pets.app`。
40
+ - 通过 `~/.cc-pets/shims` 下的软链接管 `codex` / `claude`,任意大小写写法都能拉起桌宠。
41
+ - `cc-pets install` / `uninstall` / `uninstall-app` 提供可重复执行的初始化与清理流程。
145
42
 
146
- - README 尚未记录台词文件、情境标签契约与调试用的 defaults 键。
147
- - 呼吸、微动、拖动物理没有总开关(碎碎念有)。
148
- - 常驻内存较改造前上升,栅格化缓存上限已从 48 格降到 20 格并在息屏时清空,实际效果待复测。
43
+ ### 隐私
149
44
 
150
- ## [1.3.2] - 2026-08-17
151
- - 优化“切换桌宠”子菜单:素材名称按 5 个中文字符的视觉宽度展示,超出后追加 `...`;外部素材增加
152
- 垃圾桶删除入口,首次点击后原位置变为红字“确认”,再次点击才执行删除。切换或删除素材时
153
- 子菜单保持展开,并立即更新当前项勾选和删除状态;内置素材及当前已应用素材不显示删除图标。
154
-
155
- ## [1.3.1] - 2026-08-17
156
- - 修复长期使用后桌宠崩溃、且此后每次启动都在 0.2 秒内再崩(表现为"打不开了"):Claude
157
- Token 摘要缓存落盘后,下次启动读回时会对同一块缓冲区继续追加新记录,而判断它可不可变
158
- 用的是 `isKindOfClass:NSMutableData`——`NSData` 是类簇,二进制 plist 解析出来的**不可变**
159
- `__NSCFData` 对这个判断同样返回 YES。于是只读缓冲区被当成可变的原地 `appendBytes`,
160
- 每条记录写出界 48 字节(ASan:`heap-buffer-overflow`,`0 bytes after 6640-byte region`,
161
- 分配点在 `__CFBinaryPlistCreateObjectFiltered`)。越界写破坏的是堆元数据,进程不会当场
162
- 死,而是在之后任意一次内存分配上倒下,所以三份崩溃报告的落点(`EnumerateLines`、
163
- `SaveTokenSummaryCache`)和真正的写入点毫无关系,只是先撞上的受害者。
164
- 触发要同时满足"缓存已落盘、重启后读回、该会话文件之后又变长",因此新装的机器碰不到,
165
- 攒够会话的老用户则一旦中招每次启动必崩。改为缓存一读回来就把记录换成本进程创建的可变
166
- 副本,只替换记录本身、其余字段原样保留(Codex 侧条目形状不同,整条重建会抹掉
167
- `start`/`total`/`segments`/`days`);追加处那个失效的可变性判断一并删除,避免再写回去。
168
- - `cc-pets --clean` 补上 Token 摘要缓存(`*-token-cache-*.plist`、`*-monthly-usage-*.plist`
169
- 及落盘中断留下的 `.tmp`)。它同样只是缓存,丢了只意味着重新解析一遍会话文件,原先却漏在
170
- 清理之外,于是缓存一旦出问题,`clean` 救不回来,只能让用户手动删文件。
171
- ## [1.3.0] - 2026-08-12
172
- - 修复面板上的剩余额度来回跳(实测 Claude 5 小时窗口 99% → 94% → 又回 99%):多个会话的
173
- status line 各写各的额度快照到同一个文件,而"响应更早、落盘更晚"在并发下完全正常,
174
- 无条件覆盖会让旧快照盖掉新快照。改为逐窗口按"同一 `resets_at` 内用量只增不减"取舍,
175
- 窗口滚动(`resets_at` 变大)时无条件接受,某个窗口超过 10 分钟没有被接受过时也放行,
176
- 免得官方口径调整(例如临时提额)后面板被钉死——这个逃生阀按窗口各记各的接受时刻,
177
- 被拒绝的快照不会把它续期,否则只要还有会话在持续上报就永远到不了。读改写全程用独立
178
- 锁文件加 `flock` 串行化,数据文件仍由 rename 整体替换;加锁是非阻塞加有限重试,拿不到
179
- 就放弃这次采样,免得一个卡死的写者把之后每一次 status line 渲染永久挂住。响应缺某个
180
- 窗口时保留旧值,不再整块覆盖。
181
- Codex 侧同一问题一并修,判据统一成"按额度采样时刻取最新":兜底扫描近期会话时不再按
182
- 文件 mtime 命中即返回;一批文件事件里有多个会话同时变更时,也不再取遍历到的最后一个,
183
- 而是读各自的尾巴比采样时刻(会话拿到额度后还会追加别的行,mtime 顺序和采样顺序并不
184
- 一致)。内核已经点名变更文件的路径不再重跑基于 mtime 的会话发现,否则刚选中的结果会
185
- 立刻被推翻。`cc-pets --clean` / 完整卸载会一并删除额度写锁;7 天启动清理刻意放过它,
186
- 锁文件 mtime 创建后不再更新,删掉一个正被持有的锁会让互斥失效。
187
- - 修复敲 `Claude` / `Codex`(任意非全小写写法)时桌宠不启动:shell 集成从 alias 改为
188
- `~/.cc-pets/shims` 下的软链加 `PATH` 前置。alias 名区分大小写,而 macOS 文件系统默认
189
- 不区分,`Claude` 匹配不到 alias 就直接命中真二进制,绕过了包装脚本。shim 靠文件系统
190
- 自身的大小写不敏感覆盖全部写法。包装脚本随之不再用 `whence -p` 找真二进制(会先命中
191
- shim 自己导致无限 `exec`),改为遍历候选并跳过 shim。升级会自动把旧 alias 段迁移成
192
- shim 段,卸载会一并删除软链和目录。
193
- - 新增 `cc-pets pet` 素材管理命令(`search` / `add` / `list` / `remove` / `source` / `dir`),
194
- 把素材下载到 cc-pets 自己的目录 `~/.cc-pets/pets/`,不再写 `~/.petdex/pets/` 和
195
- `~/.codex/pets/`。两端都认 `CC_PETS_PETS_DIR` 覆盖。
196
- - 桌宠端只扫 `~/.cc-pets/pets/` 和包内素材,无条件不再读 `~/.petdex/pets/` 和
197
- `~/.codex/pets/`——那两个目录由别的工具写入,混在一起就挑不出自己装的宠物。
198
- - 新增“导入 Codex 素材”开关(右键菜单,默认关):打开时立即把 `~/.codex/pets/` 里
199
- 有精灵图的素材**复制**进自己的目录,之后每次启动再导入一次。复制而非关联,Codex
200
- 那边的后续改动不影响桌宠;同名目录一律跳过不覆盖,自己装的素材优先;导入的素材写
201
- `.source.json`(`source: "codex"`),`cc-pets pet list` 里单独分组。重复导入是幂等的。
202
- - 素材列表改为启动时加载一次,之后按素材目录的 mtime 判断是否重扫。`add` / `remove`
203
- 会改动目录因而立即生效,没有增删时打开右键菜单只做一次 `stat`,不再每次遍历目录。
204
- - 素材来源抽象成「源」:`SOURCES` 表里一行就是一个源(清单地址、资源 host 白名单、
205
- Referer),当前内置 PetDex,名称支持 `petdex:boba` 这样的源前缀,默认源用
206
- `CC_PETS_SOURCE` 切换。这样以后接自建 registry 不用动命令面和目录结构。
207
- 清单按源分别缓存 6 小时,下载只接受源白名单内的 host。
208
- - 素材来源记在宠物目录内的 `.source.json`,目录名保持素材本名,桌宠菜单不受影响;
209
- `list` 按来源分组。跨源同名或覆盖手放素材时 `add` 会拒绝并提示用 `--as` 改名安装,
210
- 同源重装则直接更新。
211
- - 新增 Codex 与 Claude Code 本地 Token 用量统计,按官方重置时间对齐 5 小时与 7 天窗口;
212
- Claude 侧按 `message.id + requestId` 去重,避免 `--resume`/fork 复制的记录重复计数。
213
- 官方订阅额度仍以服务端百分比为准。
214
- - Token 聚合改为增量跟读并按额度窗口节流,事件驱动的高频刷新不再重复扫描近 7 天会话;
215
- 过期日期目录按目录名剪枝,无 Token 数据的会话文件缓存失败结果不再反复重读。
216
- - 新开 Codex 会话时不再因为尚无 `rate_limits` 而清空面板上已知的额度。
217
- - 修正跨窗口 Codex 会话的 Token 高估:Codex 会把同一份 `token_count` 重复写进会话
218
- (实测近 7 天 68 个会话里 14 个存在重复,累加值整体偏高约 1%,最差的单个会话偏高
219
- 7.7%),窗口内那一段改为按 `total_token_usage` 求差,累计值对重复事件是幂等的。
220
- - 桌宠端不再跟随继承来的 `CODEX_HOME`,与 `CLAUDE_CONFIG_DIR` 的处理对齐:常驻进程会一直
221
- 带着启动时的环境,用它选目录等于永久绑定到第一个拉起桌宠的那份 Codex 配置。需要时用
222
- `CC_PETS_CODEX_HOME` 覆盖;跑在会话里的记录端仍认 `CODEX_HOME`。
223
- - 修复存在多个 Claude 配置目录时统计错账号:桌宠是被客户端启动的常驻进程,会一直带着
224
- 启动时的 `CLAUDE_CONFIG_DIR`,等于永久绑定到"第一个拉起它的账号"。现固定只统计
225
- `~/.claude`(可用 `CC_PETS_CLAUDE_CONFIG_DIR` 覆盖),包装脚本启动桌宠时也不再透传该
226
- 变量。额度文件改为按配置目录分开存放,多个配置目录的 status line 不再互相覆盖——此前
227
- 面板可能把一个账号的剩余百分比配上另一个账号的用量。
228
- - 应用内更新遇到暂时性故障时自动重试一次,不再直接弹"更新失败"。刚发布的版本存在
229
- registry 传播竞态:`/latest` 已经报出新版本,而同一时刻 `npm install cc-pets@<新版本>`
230
- 解析到的包元数据可能还是旧的并报 `ETARGET`。重试改用一次性缓存目录强制冷取
231
- (`--prefer-online` 命中 304 时仍会拿到旧元数据),不影响用户真正的 npm 缓存。
232
- 权限、磁盘、脚本失败等真实故障不重试,照常上报。
233
- - 修复状态气泡在任务完成后被打回"正在思考":`Stop` 之后仍会飘来 `SubagentStop` /
234
- `PostToolUse` 等尾巴事件,它们与 `UserPromptSubmit` 归一成同一个状态,现按事件名拦截,
235
- 终态只能被新一轮真实动作解除。
236
- - 状态气泡新增"待机中":`正在启动` 超过 8 秒没有后续事件即落到待机,不再让启动态和
237
- 空闲态显示成同一句"正在准备当前会话…"。
238
- - 修复测试污染用户真实事件流:跑包装脚本的用例只隔离了 `TMPDIR`,而事件文件走
239
- `NSTemporaryDirectory()` 不认它,每次跑测试都会写入 3 条 `SessionStart`,把正在运行的
240
- 桌宠打回"正在启动"。相关用例补上 `CC_PETS_STATE_DIR`,并加了基线校验防止再犯。
241
- - 修复额度卡片的在线徽章恒亮:此前按"有没有额度数据"判定,而额度会一直缓存,导致
242
- 客户端早已退出、甚至单独打开 App 从未运行过 Agent 时两张卡片也显示在线。现改为按该
243
- provider 是否还有存活客户端判定,并用事件活跃度覆盖不经包装脚本启动的会话。包装脚本
244
- 启动的会话退出后 3 秒内转为"离线",不再被为直接启动会话准备的 60 秒静默宽限拖住。
245
- - 额度面板调整信息层级:官方剩余百分比升为主值、本机 Token 降为次级;汇总条改为
246
- 分别展示 Codex、Claude 的「今日」与「最近 7 天」Token;统计改用与订阅无关的自然日窗口,
247
- 并保留 Provider 归属;"数据刷新"改由面板自身定时器走字;无 Agent 在线时
248
- 状态配色转灰;额度窗口缺失的列标注"当前无活跃窗口"。
249
- - 新增 `cc-pets clean` 和带确认的 `cc-pets uninstall --purge`,并自动清理测试临时目录与过期运行状态。
250
- - 更新日志每次更新前截断,并限制为最近 1 MB,避免长期残留增长。
251
- - Codex/Claude 额度读取改为 FSEvents/VNODE 事件监听,并保留 120 秒容错刷新,降低空闲文件扫描与 JSON 解析。
252
- - 精灵图按显示尺寸降采样,菜单预览改用有限缓存;待审批记录增加 TTL 与容量上限。
253
- - 低电量模式和系统“减少动态效果”开启时自动降低动画刷新频率。
254
- - 新增可展开折叠的玻璃 Agent 状态卡片、活跃 CLI 会话数徽标和可选的完成、失败、审批系统通知。
255
- - 历史记录与系统通知设置改用右侧高对比度迷你开关,支持在菜单保持展开时连续调整。
256
- - 折叠圆钮固定锚定在桌宠头部右上区域,展开和折叠时不再跳动。
257
- - Agent 连续 1 分钟没有新状态事件时,状态卡片和圆钮会自动隐藏。
258
- - Codex/Claude 包装器会在启动桌宠前写入 Provider 启动事件,避免共享事件流导致启动瞬间显示错误来源。
259
- - 工具或子 Agent 完成后,状态卡片会恢复为思考中;仅在当前回合真正结束时显示任务完成。
260
- - 新增统一 Provider 事件协议,第三方 CLI Agent 可接入桌宠状态和动画。
261
- - 新增默认关闭的本地额度历史,按 15 分钟采样并滚动保留 7 天趋势。
262
-
263
- ## [0.2.15] - 2026-07-24
264
-
265
- - 支持 Codex/PetDex `spriteVersionNumber: 2` 的 `8×11` 精灵图布局及十六向鼠标跟随。
266
- - 新增右键“检查更新…”,可在应用内确认并完成 npm 版本升级,无需手动打开终端。
267
- - 自动更新成功后由独立进程等待旧桌宠退出并启动新版,避免旧进程继续报告可更新。
268
-
269
- ## [0.2.0] - 2026-07-22
270
-
271
- - 项目和 npm 包更名为 CC Pets。
272
- - 新版安装器会自动清理旧版 `codex-pet` Hooks、Claude status line 包装和 shell aliases。
273
- - 旧版迁移只匹配 CC Pets 的完整命令签名,避免误删复用相似标记的其他工具配置。
274
- - 新增原创默认桌宠 ByteMochi,移除公开包中的第三方角色素材。
275
- - 新增 Codex CLI 与 Claude Code CLI 共存、Agent 动画和额度面板。
276
- - 新增 PetDex 外部素材动态扫描与桌宠切换。
277
- - 新增 `cc-pets uninstall`,可移除本项目 Hooks、恢复 Claude status line 并清理 shell aliases。
278
- - 构建支持 PNG、WebP 和空素材目录。
279
- - 补充隐私、安全、贡献和第三方素材说明。
280
-
281
- ## [0.1.0] - 2026-07-21
282
-
283
- - 首个可用版本。
45
+ - 不上传会话内容、额度、凭据或使用统计,不包含遥测。
46
+ - 状态卡片与通知只显示 Provider、状态类别和脱敏后的工具类别。
package/CONTRIBUTING.md CHANGED
@@ -8,7 +8,7 @@
8
8
  4. 运行 `npm test`,确保原生构建、Hooks、额度采集、卸载和包装器测试全部通过。
9
9
  5. 对用户可见的行为变化同步更新 `README.md` 和 `CHANGELOG.md`。
10
10
 
11
- 建议先通过 Gitee Issue 描述较大的功能或兼容性改动,再提交 Pull Request。
11
+ 建议先开一个 GitHub Issue 描述较大的功能改动,达成一致后再提交 Pull Request。
12
12
 
13
13
  ## 素材规范
14
14
 
package/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2026 wangxinyusqn
3
+ Copyright (c) 2026 UniverseWang
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
package/README.md CHANGED
@@ -18,6 +18,7 @@
18
18
  - 支持第三方 CLI Agent 通过统一 Provider 事件协议接入动画和状态
19
19
  - 可选记录最近 7 天的本地额度历史,并在额度卡片中显示趋势
20
20
  - 可分别启用任务完成、失败和等待审批的 macOS 系统通知
21
+ - 内置一个原创素材,更多桌宠可从兼容 PetDex 的素材源按需下载到本机
21
22
  - 使用原生 AppKit,运行时不依赖 Electron
22
23
 
23
24
  ## 互动方式
@@ -44,7 +45,7 @@ Claude Code Hook 会合并到 `~/.claude/settings.json`,现有的 `env`、`mod
44
45
  仍保持原脚本路径,Claude Code 可以继续查找和修改该脚本;脚本输入会同时提供给原状态栏
45
46
  和桌宠,原有输出不变。
46
47
  通过 npm 安装或升级时会自动重新构建应用、安装或更新两套 Hooks,并配置 shell 集成;如果旧版桌宠正在运行,
47
- 安装器会自动重启桌宠,使新版本生效。`cc-pets install` 保留为手动修复和重新初始化命令。
48
+ 安装器会自动重启桌宠,使新版本生效。`cc-pets install` 用于手动修复或重新初始化。
48
49
 
49
50
  ### 鼠标互动
50
51
 
@@ -130,16 +131,9 @@ Agent **正在干活**时(思考、调用工具、等待审批、子 Agent 工
130
131
  ### 编辑台词
131
132
 
132
133
  右键菜单「碎碎念 → 编辑台词…」打开内置编辑器。桌宠说的**所有**话都在
133
- `~/.cc-pets/speech.txt` 里,代码里没有第二份词库——首次启动时从 app 内的出厂词库
134
+ `~/.cc-pets/speech.txt` 里,代码里没有第二份词库——首次启动时从 app 内的默认词库
134
135
  拷一份出来,之后就只认这个文件。
135
136
 
136
- > **从旧版升级**:原来的 `~/.cc-pets/phrases.txt` 会在启动时自动合并到 `speech.txt`,
137
- > 你写过的台词一句不丢,注释换成新版的。第一次打开编辑器时会问要不要把那个已经不起
138
- > 作用的旧文件改名成 `phrases.txt.bak` 收起来——内容留在原地,但不会再被当成迁移源。
139
- >
140
- > 选「先留着」也可以,只是要知道两件事:改它不会有任何效果;哪天 `speech.txt` 丢了,
141
- > 启动时会再从它合并一遍,把你迁移之后写的台词冲掉。
142
-
143
137
  语义只有一条:**文件里有什么就说什么**。没有合并、没有 replace、没有兜底,
144
138
  删掉一节就是那个情境不吭声。
145
139
 
@@ -162,7 +156,7 @@ Agent **正在干活**时(思考、调用工具、等待审批、子 Agent 工
162
156
 
163
157
  - **试说一句** —— 选一个情境,桌宠当场把那一节里的一句说出来。读的是编辑器里
164
158
  **还没保存**的文本,槽位用示例数据填,所以不用等到真的额度告急才能看到效果
165
- - **恢复出厂台词…** —— 把编辑器内容换成出厂词库,按 ⌘Z 可撤销,不保存不写文件
159
+ - **恢复默认台词…** —— 把编辑器内容换成默认词库,按 ⌘Z 可撤销,不保存不写文件
166
160
  - **保存**(⌘S)/ **保存并关闭**(⏎)—— 保存时校验,问题当场列出来。
167
161
  校验没过或被 mtime 冲突取消时不会关窗,改动不会跟着窗口一起消失
168
162
 
@@ -173,7 +167,7 @@ Agent **正在干活**时(思考、调用工具、等待审批、子 Agent 工
173
167
  存在 `~/.cc-pets/speech/<宠物名>.txt`(内置素材是 `builtin-默认.txt`)。
174
168
 
175
169
  这一页**初次打开是空白的,这是正常的**:空白 = 这只宠物全部沿用通用台词。
176
- 不知道能写什么就点右上角 **填入出厂模板**,它会把整份出厂台词以**注释状态**填进来
170
+ 不知道能写什么就点右上角 **填入默认模板**,它会把整份默认台词以**注释状态**填进来
177
171
  (每行都以 `#` 开头,一句都不生效,这只宠物说的还是通用台词)。想让哪一节归它自己管,
178
172
  把那一节行首的 `#` 去掉再改字就行。
179
173
 
@@ -202,8 +196,8 @@ Agent **正在干活**时(思考、调用工具、等待审批、子 Agent 工
202
196
  专属这一页的规则比通用那份松得多——缺小节本来就是常态,所以「标签不能删」和
203
197
  「`[state_*]` 至少留一句」两条都不适用,只剩逐行的那些检查(超长、槽位拼错、小节名写错)。
204
198
  「试说一句」在专属没写该小节时会照实说出通用的那一句,并注明「这一节来自通用台词」。
205
- 按钮此时也变成 **清空这一页…**:清空即全部回落到通用,专属词库没有「出厂」这个概念。
206
- 「填入出厂模板」填的是注释版而不是直接可用的整份台词,也是同一个道理——直接填进
199
+ 按钮此时也变成 **清空这一页…**:清空即全部回落到通用,专属词库没有「默认」这个概念。
200
+ 「填入默认模板」填的是注释版而不是直接可用的整份台词,也是同一个道理——直接填进
207
201
  22 节未注释的台词,这只宠物就每一节都自己管、再也不会回落了,那正好毁掉这一页的用法。
208
202
 
209
203
  切换宠物后编辑器会自动跟到新那只身上;这一页有没保存的改动时会先问一句。
@@ -261,9 +255,7 @@ defaults delete com.universewang.cc-pets CCPetsSpeechCooldown # 交
261
255
  ### npm 安装
262
256
 
263
257
  ```bash
264
- npm install -g cc-pets@latest \
265
- --allow-scripts=cc-pets \
266
- --prefer-online
258
+ npm install -g cc-pets@latest --allow-scripts=cc-pets
267
259
  # 首次安装后新开一个终端
268
260
  codex
269
261
  # 或
@@ -271,8 +263,8 @@ claude
271
263
  ```
272
264
 
273
265
  `--allow-scripts=cc-pets` 用于允许新版 npm 执行 CC Pets 的 `postinstall`,完成原生应用构建、
274
- Hooks、shell 集成和 `~/Applications/CC Pets.app` 的安装;`--prefer-online` 会优先向 npm Registry
275
- 检查 `latest`,减少刚发布新版本时命中旧元数据缓存的概率。
266
+ Hooks、shell 集成和 `~/Applications/CC Pets.app` 的安装。缺少它时安装仍会成功退出,
267
+ 但这些步骤一个都不会执行。
276
268
 
277
269
  如果已经只执行了 `npm install -g cc-pets@latest`,并看到 npm 提示安装脚本尚未获准,
278
270
  可以在包安装完成后手动初始化:
@@ -283,33 +275,20 @@ cc-pets install
283
275
 
284
276
  #### 关于安装脚本白名单
285
277
 
286
- 新版 npm(12 起默认)引入了安装脚本白名单:不在白名单里的包,`postinstall` 一律不执行。
287
- 它只打印一行 `warn install-scripts`,进程仍然以成功退出,所以**安装看起来是成功的**,
288
- 但原生应用、Hooks 和 shell 集成都不会被安装 —— 表现为敲 `codex` / `claude` 时桌宠不出现。
289
-
290
- 不想每次都带 `--allow-scripts` 参数的话,可以配置一次持久白名单:
278
+ npm 12 起默认启用安装脚本白名单:不在白名单里的包不会执行 `postinstall`,而安装过程仍以
279
+ 成功退出。此时原生应用、Hooks 和 shell 集成都没有装上,表现为敲 `codex` / `claude` 时
280
+ 桌宠不出现。不想每次都带 `--allow-scripts` 参数的话,可以配置一次持久白名单:
291
281
 
292
282
  ```bash
293
283
  npm config set allow-scripts=cc-pets --location=user
294
284
  ```
295
285
 
296
- 这个机制作用于所有带 `postinstall` 的包,不限于 CC Pets。常见的一个例子是 Claude Code 自身:
297
- 它的原生二进制正是由 `postinstall` 铺开的,被拦下时执行 `claude` 会提示
298
- `claude native binary not installed`,而重装并不能修好 —— 因为每次重装都会被同样拦下。
299
- 这类情况可以按需把多个包一起加进白名单:
300
-
301
- ```bash
302
- npm config set allow-scripts=cc-pets,@anthropic-ai/claude-code --location=user
303
- ```
304
-
305
- 怀疑某个 CLI 装完后行为异常时,可以在 `~/.npm/_logs/` 最近的日志里搜 `install-scripts`,
306
- 确认是不是同一个原因。注意白名单只对之后的安装生效,不会回头补跑已经被拦下的脚本,
307
- 所以配置完还需要重装一次对应的包。
286
+ 白名单只对之后的安装生效,不会补跑已经被拦下的脚本,因此配置完需要重装一次。
308
287
 
309
288
  ### 本地源码安装
310
289
 
311
290
  ```bash
312
- git clone https://gitee.com/wangxinyusqn/cc-pets.git
291
+ git clone https://github.com/wangxinyu-sqn/cc-pets.git
313
292
  cd cc-pets
314
293
  npm install -g . --ignore-scripts
315
294
  cc-pets install
@@ -336,19 +315,7 @@ npm 的安装后脚本会自动构建原生应用、安装两套 Agent Hooks,
336
315
  Codex/Claude Hooks 和 shell 集成,并自动重启正在运行的桌宠。自动更新不会请求管理员权限;如果原来的
337
316
  全局 npm 目录不可写或 Node.js/npm 已被移动,应用会保留旧版本并显示更新日志和手动升级命令。
338
317
 
339
- ### 从旧版升级
340
-
341
- 从使用 `codex-pet` 命令的旧版升级时,直接安装新版即可:
342
-
343
- ```bash
344
- npm install -g cc-pets@latest \
345
- --allow-scripts=cc-pets \
346
- --prefer-online
347
- ```
348
-
349
- 新版安装器会自动移除旧版 Hooks、恢复并重新接入 Claude status line,同时把旧的 `codex` / `claude` alias 段迁移成 shim,
350
- 不需要先运行已经移除的 `codex-pet uninstall`。迁移仅识别 CC Pets 的完整命令签名,不会按
351
- `codex`、`claude` 或单个环境变量名称泛化删除其他工具配置。
318
+ ### 指定真实 CLI 路径
352
319
 
353
320
  如果真实 Codex CLI 不在当前 `PATH`,可以显式指定:
354
321
 
@@ -499,12 +466,22 @@ Codex 侧同理:桌宠固定只统计 `~/.codex`,不读继承来的 `CODEX_H
499
466
 
500
467
  ## 素材与版权
501
468
 
502
- 桌宠素材统一放在 `Sources/CCPets/Resources/`,程序会自动收集其中的 `.webp` 和 `.png` 文件。
503
- 内置素材按 `8×9` 网格解析。外部 Codex/PetDex 素材支持
469
+ **本项目不自建素材仓库。** 仓库和 npm 包里只有一个内置素材 `默认.webp`(原创角色
470
+ ByteMochi,随代码按 MIT License 分发)。其余桌宠素材一律**由用户自己从素材源按需下载**
471
+ 到本机 `~/.cc-pets/pets/`,既不进仓库,也不进 npm 发布包。
472
+
473
+ `cc-pets pet` 兼容 [PetDex](https://petdex.dev) 的公开清单接口:清单读
474
+ `https://petdex.dev/api/manifest`,下载只接受清单中位于 `assets.petdex.dev` 的资源地址。
475
+ CC Pets 只负责把素材取回本机并渲染,不修改、不转存、不再分发;素材的著作权归各自作者
476
+ 和平台所有,使用前请遵守 PetDex 与素材作者的许可和使用条款。同样地,桌宠也能直接读取
477
+ 你用 PetDex 官方 CLI 或 Codex 桌面端装好的素材,那些素材由你自己管理。
478
+
479
+ 格式方面,内置素材按 `8×9` 网格解析;外部 Codex/PetDex 素材支持
504
480
  `spriteVersionNumber` v1(`1536×1872`、`8×9`)和
505
481
  v2(`1536×2288`、`8×11`),单元格均为 `192×208`,前九行遵循相同的动作协议。
506
- 角色可能属于受版权保护的作品;公开
507
- 发布本项目或 npm 包前,请确认已经获得素材的使用和分发授权,或替换为原创、可公开分发的素材。
482
+ 程序会自动收集 `Sources/CCPets/Resources/` 下的 `.webp` 和 `.png` 作为内置素材——
483
+ 向仓库提交新的内置素材时,必须是原创作品或带有允许再分发的明确许可证,
484
+ 受版权保护的角色不要放进来。
508
485
 
509
486
  ### 素材管理
510
487
 
package/SECURITY.md CHANGED
@@ -6,8 +6,8 @@
6
6
 
7
7
  ## 报告安全问题
8
8
 
9
- 请不要在公开 Issue 中披露尚未修复的漏洞、凭据或私人会话数据。请通过
10
- [Gitee 维护者主页](https://gitee.com/wangxinyusqn) 私下联系,并提供:
9
+ 请不要在公开 Issue 中披露尚未修复的漏洞、凭据或私人会话数据。请使用 GitHub 的
10
+ **Security → Report a vulnerability**(私密漏洞报告)提交,并提供:
11
11
 
12
12
  - 受影响版本与 macOS 版本
13
13
  - 可复现步骤和影响范围
@@ -132,7 +132,7 @@ static NSString *const PetSpeechFrequencyChatty = @"chatty";
132
132
  if (!nodeExecutable || !npmCliExists) {
133
133
  [self showUpdateAlertWithTitle:@"无法自动更新"
134
134
  message:@"没有找到安装 CC Pets 时使用的 Node.js/npm。请先手动执行一次:\n\n"
135
- "npm install -g cc-pets@latest --allow-scripts=cc-pets --prefer-online"];
135
+ "npm install -g cc-pets@latest --allow-scripts=cc-pets"];
136
136
  return;
137
137
  }
138
138
 
@@ -905,7 +905,7 @@ static NSString *const PetSpeechFrequencyChatty = @"chatty";
905
905
  - (void)applicationDidFinishLaunching:(NSNotification *)notification {
906
906
  // 没有主菜单的话,台词编辑器里 ⌘C/⌘V/⌘A/⌘Z 全部没反应。
907
907
  [self installEditMenu];
908
- // 台词全在这个文件里,代码里没有第二份。首次启动先从出厂词库拷一份出来,
908
+ // 台词全在这个文件里,代码里没有第二份。首次启动先从默认词库拷一份出来,
909
909
  // 否则新装的桌宠一句话都不会说。
910
910
  PetPhrasesEnsureFileExists();
911
911
  if (![NSUserDefaults.standardUserDefaults boolForKey:PetInteractionPhrasesV1MigratedKey] &&
@@ -80,7 +80,7 @@ void PetPhrasesSetCurrentPetID(NSString *petID);
80
80
  NSString *PetPhrasesCurrentPetID(void);
81
81
  // 当前宠物的专属词库路径。还没设过宠物时返回 nil。
82
82
  NSString *PetPhrasesCurrentPetFilePath(void);
83
- // 出厂词库路径:app bundle 里的 phrases.default.txt。
83
+ // 默认词库路径:app bundle 里的 phrases.default.txt。
84
84
  // 可用 CC_PETS_PHRASES_DEFAULT_FILE 覆盖(测试用)。
85
85
  NSString *PetPhrasesDefaultFilePath(void);
86
86
  // 老版词库路径:~/.cc-pets/phrases.txt。可用 CC_PETS_PHRASES_LEGACY_FILE 覆盖(测试用)。
@@ -98,7 +98,7 @@ BOOL PetPhrasesLegacyFileExists(void);
98
98
  // 哪天 speech.txt 丢了,启动时会再从它合并一遍,把用户迁移之后写的台词全冲掉。
99
99
  BOOL PetPhrasesArchiveLegacyFile(void);
100
100
 
101
- // 把老版词库合并进出厂词库。纯函数,不碰磁盘,方便测。
101
+ // 把老版词库合并进默认词库。纯函数,不碰磁盘,方便测。
102
102
  //
103
103
  // 合并而不是覆盖:老语义是"内置 + 用户的混着说",用户当时听到的就是两者的并集,
104
104
  // 直接拿用户那几句顶掉整节的话,桌宠会突然变哑。老文件里写了 replace 的除外——
@@ -106,9 +106,9 @@ BOOL PetPhrasesArchiveLegacyFile(void);
106
106
  // 注释一律不搬,按新模板的来。
107
107
  NSString *PetPhraseTextMergedFromLegacy(NSString *legacyText, NSString *defaultText);
108
108
 
109
- // 用户词库不存在就准备一份:有老版词库就合并过来,否则从出厂词库拷。返回是否可用。
109
+ // 用户词库不存在就准备一份:有老版词库就合并过来,否则从默认词库拷。返回是否可用。
110
110
  //
111
- // 出厂词库是一个随 app 打包的文本文件,不是代码里的字典:默认台词只在"生成文件"
111
+ // 默认词库是一个随 app 打包的文本文件,不是代码里的字典:默认台词只在"生成文件"
112
112
  // 这一刻出现一次,之后运行时只认用户文件。两份词库同时存在于运行期就必然要回答
113
113
  // "以谁为准",那正是 merge/replace 那套让人看不懂的根源。
114
114
  BOOL PetPhrasesEnsureFileExists(void);
@@ -162,7 +162,7 @@ BOOL PetPhrasesEnsureFileExists(void) {
162
162
 
163
163
  // 老用户:启动时就把老词库合并过来,不等他打开编辑器。
164
164
  //
165
- // 拖到编辑器里再迁移的话,从升级到他第一次打开编辑器这段时间,桌宠说的会是出厂
165
+ // 拖到编辑器里再迁移的话,从升级到他第一次打开编辑器这段时间,桌宠说的会是默认
166
166
  // 台词而不是他自己写的——没人会把这件事和"我该去点一下编辑台词"联系起来。
167
167
  // 老文件这一步不删,等编辑器里问过用户再删。
168
168
  NSString *legacyText = [NSString stringWithContentsOfFile:PetPhrasesLegacyFilePath()
@@ -172,7 +172,7 @@ BOOL PetPhrasesEnsureFileExists(void) {
172
172
  return [text writeToFile:path atomically:YES encoding:NSUTF8StringEncoding error:nil];
173
173
  }
174
174
 
175
- // 标签清单。顺序就是出厂模板里的顺序,校验提示按这个顺序报,
175
+ // 标签清单。顺序就是默认模板里的顺序,校验提示按这个顺序报,
176
176
  // 用户对着文件从上往下找得到。
177
177
  NSArray<NSString *> *PetPhraseStateTags(void) {
178
178
  static NSArray<NSString *> *tags;
@@ -514,7 +514,7 @@ static PetPhraseIssue *MakeIssue(NSInteger line, PetPhraseIssueLevel level, NSSt
514
514
  // 所以直接拦下不给保存。
515
515
  // 提示 —— 其余全部。情绪句整节没有是合法的(就是那个情境不吭声),
516
516
  // 被丢掉的行也只影响自己,说清楚就行,不挡用户。
517
- // 小节头写成出厂词库里的样子:[tag] 补空格对齐到 24 列,再跟中文说明。
517
+ // 小节头写成默认词库里的样子:[tag] 补空格对齐到 24 列,再跟中文说明。
518
518
  static NSString *SectionHeaderLine(NSString *tag) {
519
519
  NSString *head = [NSString stringWithFormat:@"[%@]", tag];
520
520
  NSMutableString *line = [head mutableCopy];
@@ -538,7 +538,7 @@ static BOOL IsHeaderLine(NSString *rawLine, NSString *tag) {
538
538
  return [line isEqualToString:[NSString stringWithFormat:@"[%@]", tag]];
539
539
  }
540
540
 
541
- // 标签名或括号被删掉一部分时,出厂小节头后面的中文说明仍能唯一标识它属于哪个情境:
541
+ // 标签名或括号被删掉一部分时,默认小节头后面的中文说明仍能唯一标识它属于哪个情境:
542
542
  // [click_hear] # 连续点击后开心
543
543
  // click_heart] # 连续点击后开心
544
544
  // [] # 连续点击后开心
@@ -566,7 +566,7 @@ NSString *PetPhraseTextMergedFromLegacy(NSString *legacyText, NSString *defaultT
566
566
  if ([line isEqualToString:@"replace"]) { replaceMode = YES; break; }
567
567
  }
568
568
 
569
- // 拿出厂模板当骨架,逐节把内容换掉。注释、分节说明全都用新模板的,
569
+ // 拿默认模板当骨架,逐节把内容换掉。注释、分节说明全都用新模板的,
570
570
  // 老文件里的注释一概不搬。
571
571
  NSMutableArray<NSString *> *output = [NSMutableArray array];
572
572
  NSArray<NSString *> *lines = [defaultText componentsSeparatedByString:@"\n"];
@@ -582,9 +582,9 @@ NSString *PetPhraseTextMergedFromLegacy(NSString *legacyText, NSString *defaultT
582
582
  [output addObject:rawLine];
583
583
  NSArray<NSString *> *userLines = legacy[current];
584
584
  NSMutableArray<NSString *> *merged = [NSMutableArray array];
585
- // 出厂在前、用户的追加在后,顺序稳定,用户一眼能看出哪几句是自己写的。
585
+ // 默认在前、用户的追加在后,顺序稳定,用户一眼能看出哪几句是自己写的。
586
586
  //
587
- // replace 模式只覆盖用户**写过**的那些小节,没写过的仍旧用出厂内容。
587
+ // replace 模式只覆盖用户**写过**的那些小节,没写过的仍旧用默认内容。
588
588
  // 照搬老语义(没写的一律清空)会让 15 个 state_ 小节全空:老版那些小节空了
589
589
  // 还有一层兜底文案顶着,新版把兜底删了,状态卡副行会直接残掉。
590
590
  if (!replaceMode || userLines.count == 0) {
@@ -10,7 +10,7 @@ static void (^PetPhrasesSpeakHandler)(NSString *);
10
10
  @property NSButton *saveButton;
11
11
  @property NSButton *saveAndCloseButton;
12
12
  @property NSButton *revertButton;
13
- // 只在专属页出现:把出厂台词整份填进来,给空白页一个起点。
13
+ // 只在专属页出现:把默认台词整份填进来,给空白页一个起点。
14
14
  @property NSButton *fillButton;
15
15
  // 编辑的是通用词库还是某只宠物的专属词库。
16
16
  @property NSSegmentedControl *scopeControl;
@@ -152,7 +152,7 @@ static void (^PetPhrasesSpeakHandler)(NSString *);
152
152
  saveAndClose.translatesAutoresizingMaskIntoConstraints = NO;
153
153
  self.saveAndCloseButton = saveAndClose;
154
154
 
155
- NSButton *revert = [NSButton buttonWithTitle:@"恢复出厂台词…" target:self
155
+ NSButton *revert = [NSButton buttonWithTitle:@"恢复默认台词…" target:self
156
156
  action:@selector(revertToDefault:)];
157
157
  revert.translatesAutoresizingMaskIntoConstraints = NO;
158
158
  self.revertButton = revert;
@@ -166,9 +166,9 @@ static void (^PetPhrasesSpeakHandler)(NSString *);
166
166
  self.scopeControl = scope;
167
167
 
168
168
  // 专属页初次打开是空白的——空白在语义上是对的(全部回落到通用),但一个空白文本框
169
- // 不告诉任何人该往里写什么。这个按钮就是那个起点:把出厂台词整份填进来,
169
+ // 不告诉任何人该往里写什么。这个按钮就是那个起点:把默认台词整份填进来,
170
170
  // 用户在上面改字、删掉不想接管的小节即可。
171
- NSButton *fill = [NSButton buttonWithTitle:@"填入出厂模板" target:self
171
+ NSButton *fill = [NSButton buttonWithTitle:@"填入默认模板" target:self
172
172
  action:@selector(fillFromDefault:)];
173
173
  fill.translatesAutoresizingMaskIntoConstraints = NO;
174
174
  fill.hidden = YES;
@@ -253,10 +253,10 @@ static void (^PetPhrasesSpeakHandler)(NSString *);
253
253
  }
254
254
 
255
255
  - (void)syncRevertButtonTitle {
256
- // 专属词库没有"出厂"这一说,它的出厂状态就是空文件(全部回落到通用)。
257
- self.revertButton.title = self.petScope ? @"清空这一页…" : @"恢复出厂台词…";
258
- // 通用页不需要这个按钮:它本来就是从出厂台词拷出来的,不存在空白无从下手的问题,
259
- // 想拿回出厂内容有"恢复出厂台词…"。
256
+ // 专属词库没有"默认"这一说,它的默认状态就是空文件(全部回落到通用)。
257
+ self.revertButton.title = self.petScope ? @"清空这一页…" : @"恢复默认台词…";
258
+ // 通用页不需要这个按钮:它本来就是从默认台词拷出来的,不存在空白无从下手的问题,
259
+ // 想拿回默认内容有"恢复默认台词…"。
260
260
  self.fillButton.hidden = !self.petScope;
261
261
  }
262
262
 
@@ -307,7 +307,7 @@ static void (^PetPhrasesSpeakHandler)(NSString *);
307
307
  if (self.petScope && text.length == 0) {
308
308
  [self showStatus:[NSString stringWithFormat:
309
309
  @"%@ · 还是空的,这只宠物现在说的全是通用台词。"
310
- "只写想改的小节即可,或点右上角「填入出厂模板」看看能写些什么。", path]
310
+ "只写想改的小节即可,或点右上角「填入默认模板」看看能写些什么。", path]
311
311
  warning:NO];
312
312
  return;
313
313
  }
@@ -493,14 +493,14 @@ static void (^PetPhrasesSpeakHandler)(NSString *);
493
493
  };
494
494
  }
495
495
 
496
- #pragma mark - 填入出厂台词
496
+ #pragma mark - 填入默认台词
497
497
 
498
498
  // 给空白的专属页一个起点,同时**不破坏回落**。
499
499
  //
500
- // 直接填入完整的出厂台词是错的:那样 22 个小节全都"存在",这只宠物从此每一节都自己
500
+ // 直接填入完整的默认台词是错的:那样 22 个小节全都"存在",这只宠物从此每一节都自己
501
501
  // 管,再也不会回落到通用词库——正好毁掉专属词库的全部用法。
502
502
  //
503
- // 所以填进来的是整份**注释状态**的出厂台词。用户看得见每一节可以写什么(这才是空白页
503
+ // 所以填进来的是整份**注释状态**的默认台词。用户看得见每一节可以写什么(这才是空白页
504
504
  // 真正缺的东西),而注释行在解析时一行都不算数,所以填完之后这只宠物说的仍然全是通用
505
505
  // 台词,什么都没变。想让哪一节归它自己管,把那一节的 # 去掉再改字。
506
506
  //
@@ -533,14 +533,14 @@ static void (^PetPhrasesSpeakHandler)(NSString *);
533
533
  - (void)fillFromDefault:(id)sender {
534
534
  NSString *text = [self commentedDefaultText];
535
535
  if (text.length == 0) {
536
- [self showStatus:@"找不到出厂台词文件。" warning:YES];
536
+ [self showStatus:@"找不到默认台词文件。" warning:YES];
537
537
  return;
538
538
  }
539
539
  // 空白页直接填,不打断——那正是这个按钮存在的理由。已经写了东西才问一句。
540
540
  if ((self.textView.string ?: @"").length > 0) {
541
541
  NSAlert *alert = [NSAlert new];
542
542
  alert.messageText = @"覆盖这一页?";
543
- alert.informativeText = @"这一页现在的内容会被整份出厂台词替换(全部是注释状态)。"
543
+ alert.informativeText = @"这一页现在的内容会被整份默认台词替换(全部是注释状态)。"
544
544
  "还没保存,可以按 ⌘Z 撤销。";
545
545
  [alert addButtonWithTitle:@"覆盖"];
546
546
  [alert addButtonWithTitle:@"取消"];
@@ -551,20 +551,20 @@ static void (^PetPhrasesSpeakHandler)(NSString *);
551
551
  if (![self.textView shouldChangeTextInRange:all replacementString:text]) return;
552
552
  [self.textView.textStorage replaceCharactersInRange:all withString:text];
553
553
  [self.textView didChangeText];
554
- [self showStatus:@"已填入出厂台词,整份都是注释、还不生效。"
554
+ [self showStatus:@"已填入默认台词,整份都是注释、还不生效。"
555
555
  "把想改的那一节行首的 # 去掉,它才归这只宠物管。" warning:NO];
556
556
  }
557
557
 
558
- #pragma mark - 恢复出厂 / 清空
558
+ #pragma mark - 恢复默认 / 清空
559
559
 
560
560
  - (void)revertToDefault:(id)sender {
561
561
  NSAlert *alert = [NSAlert new];
562
- // 专属词库的"出厂状态"就是空白:清空 = 这只宠物全部回落到通用台词。
563
- // 拿出厂词库去填它是错的——那等于把 22 个小节全部标成"专属接管",再也不会回落。
564
- alert.messageText = self.petScope ? @"清空这只宠物的专属台词?" : @"恢复出厂台词?";
562
+ // 专属词库的"默认状态"就是空白:清空 = 这只宠物全部回落到通用台词。
563
+ // 拿默认词库去填它是错的——那等于把 22 个小节全部标成"专属接管",再也不会回落。
564
+ alert.messageText = self.petScope ? @"清空这只宠物的专属台词?" : @"恢复默认台词?";
565
565
  alert.informativeText = self.petScope ?
566
566
  @"清空之后,这只宠物说的全部回到通用台词。还没保存,可以按 ⌘Z 撤销。" :
567
- @"编辑器里的内容会被出厂台词替换。还没保存,可以按 ⌘Z 撤销。";
567
+ @"编辑器里的内容会被默认台词替换。还没保存,可以按 ⌘Z 撤销。";
568
568
  [alert addButtonWithTitle:self.petScope ? @"清空" : @"恢复"];
569
569
  [alert addButtonWithTitle:@"取消"];
570
570
  if ([alert runModal] != NSAlertFirstButtonReturn) return;
@@ -574,7 +574,7 @@ static void (^PetPhrasesSpeakHandler)(NSString *);
574
574
  text = [NSString stringWithContentsOfFile:PetPhrasesDefaultFilePath()
575
575
  encoding:NSUTF8StringEncoding error:nil];
576
576
  if (text.length == 0) {
577
- [self showStatus:@"找不到出厂台词文件。" warning:YES];
577
+ [self showStatus:@"找不到默认台词文件。" warning:YES];
578
578
  return;
579
579
  }
580
580
  }
@@ -584,7 +584,7 @@ static void (^PetPhrasesSpeakHandler)(NSString *);
584
584
  [self.textView.textStorage replaceCharactersInRange:all withString:text];
585
585
  [self.textView didChangeText];
586
586
  [self showStatus:self.petScope ? @"已清空,按保存才会写进文件。" :
587
- @"已填入出厂台词,按保存才会写进文件。" warning:NO];
587
+ @"已填入默认台词,按保存才会写进文件。" warning:NO];
588
588
  }
589
589
 
590
590
  @end
@@ -426,38 +426,82 @@ static NSTimeInterval DayDirectoryEnd(NSURL *year, NSURL *month, NSURL *day) {
426
426
  return date ? date.timeIntervalSince1970 + 86400.0 : 0;
427
427
  }
428
428
 
429
+ // 目录名只说明"会话是哪天建的",不说明"会话哪天还在被写":`codex resume` 会一直往
430
+ // 建会话那天的目录里追加,实测有用户近 8 天的全部 token_count 都写在 15 天前的
431
+ // sessions/2026/08/06/ 里。原实现在这里按目录名直接 return,那台机器上 urls 恒为空,
432
+ // 今日 / 最近 7 天的 Token 于是恒为 0(额度却正常——它走 NewestCodexSessionURL,按 mtime)。
433
+ // 所以窗口之前的目录不再收手,而是继续扫、只收 mtime 落在窗口内的文件。
434
+ // mtime 也是 Claude 侧 AppendRecentTranscriptsInDirectory 用的判据,两边口径就此一致。
435
+ static const NSUInteger ResumeLookbackDays = 60;
436
+
429
437
  // earliest 由调用方按当前口径算好:订阅视图是 8 天,API 视图是本月 1 日(上月已归档)或
430
438
  // 上月 1 日(还没归档,要扫一次把归档建出来),三者都不会早于 8 天下限。
431
439
  static NSArray<NSURL *> *RecentCodexSessionURLs(NSURL *sessionsURL, NSTimeInterval earliest) {
432
440
  NSMutableArray<NSURL *> *urls = [NSMutableArray array];
433
441
  NSUInteger examinedDays = 0;
442
+ // 连续多少个"整天落在窗口之前、且一个活跃文件都没有"的目录。成本上界与历史长度无关:
443
+ // 续写旧会话的用户在这个计数清零之前就被捞到,闲置多年的历史最多多读 60 次目录项。
444
+ NSUInteger staleDays = 0;
434
445
  // 目录个数的上限跟着时间窗口走,再多留几天处理时区边界和异常目录。
435
446
  const NSUInteger maximumTokenDays =
436
447
  (NSUInteger)ceil((NSDate.date.timeIntervalSince1970 - earliest) / 86400.0) + 3;
448
+ NSArray<NSURLResourceKey> *keys = @[NSURLIsRegularFileKey, NSURLContentModificationDateKey];
437
449
  for (NSURL *year in DescendingNumericSubdirectories(sessionsURL)) {
438
450
  for (NSURL *month in DescendingNumericSubdirectories(year)) {
439
451
  for (NSURL *day in DescendingNumericSubdirectories(month)) {
440
- // 只数目录个数不看日期的话,停用一段时间后会把 9 个早已过期的日期目录
441
- // 整个拿去做 summary。目录是倒序的,一旦整天落在窗口之前就能直接收手。
452
+ // 天数上限用完之后不是收手,而是降级成同一套 mtime 过滤:直接 return 会
453
+ // 把上限之外那个仍在续写的旧会话又一次切掉。目录名解析不出日期(dayEnd 为 0)
454
+ // 时按窗口内处理,交给天数上限收手,不误删。
442
455
  NSTimeInterval dayEnd = DayDirectoryEnd(year, month, day);
443
- if (dayEnd > 0 && dayEnd < earliest) return urls;
444
- NSArray<NSURLResourceKey> *keys = @[NSURLIsRegularFileKey, NSURLFileSizeKey];
456
+ BOOL beforeWindow = (dayEnd > 0 && dayEnd < earliest) ||
457
+ examinedDays >= maximumTokenDays;
458
+ if (beforeWindow && staleDays >= ResumeLookbackDays) return urls;
445
459
  NSArray<NSURL *> *contents = [NSFileManager.defaultManager contentsOfDirectoryAtURL:day
446
460
  includingPropertiesForKeys:keys options:NSDirectoryEnumerationSkipsHiddenFiles error:nil];
461
+ BOOL matched = NO;
447
462
  for (NSURL *url in contents) {
448
463
  if (![url.pathExtension.lowercaseString isEqualToString:@"jsonl"]) continue;
449
- NSNumber *regular = nil;
450
- [url getResourceValue:&regular forKey:NSURLIsRegularFileKey error:nil];
451
- if (regular.boolValue) [urls addObject:url];
464
+ NSDictionary *values = [url resourceValuesForKeys:keys error:nil];
465
+ if (![values[NSURLIsRegularFileKey] boolValue]) continue;
466
+ // 窗口内的目录整目录都要(文件本身可能刚建、mtime 还没落后),窗口之前的
467
+ // 目录只认最近被写过的文件——判据是 mtime,不是文件里的时间戳:伪造/回填
468
+ // 的时间戳不该把一份三个月前的会话拉回今天。
469
+ if (beforeWindow) {
470
+ NSDate *modified = values[NSURLContentModificationDateKey];
471
+ if (!modified || modified.timeIntervalSince1970 < earliest) continue;
472
+ }
473
+ [urls addObject:url];
474
+ matched = YES;
452
475
  }
453
- examinedDays += 1;
454
- if (examinedDays >= maximumTokenDays) return urls;
476
+ if (beforeWindow) staleDays = matched ? 0 : staleDays + 1;
477
+ else examinedDays += 1;
455
478
  }
456
479
  }
457
480
  }
458
481
  return urls;
459
482
  }
460
483
 
484
+ // 目录扫描之外再兜一层:当前正在被增量读取的会话、以及 FSEvents 这一轮点名的会话文件,
485
+ // 无条件参与 Token 聚合。内核已经确认它们刚被写过,这个结论比任何按路径名或 mtime 的
486
+ // 推断都可靠。多喂进来的文件不会让数字虚高——窗口过滤在 TokenTotalsInWindow 里按行内
487
+ // 时间戳做,这里只是保证文件有机会被读到。
488
+ static NSArray<NSURL *> *TokenAggregationURLs(NSURL *sessionsURL, NSTimeInterval earliest,
489
+ NSArray<NSURL *> *pinnedURLs) {
490
+ NSMutableArray<NSURL *> *urls = [RecentCodexSessionURLs(sessionsURL, earliest) mutableCopy];
491
+ if (pinnedURLs.count == 0) return urls;
492
+ NSMutableSet<NSString *> *paths = [NSMutableSet setWithCapacity:urls.count];
493
+ for (NSURL *url in urls) [paths addObject:url.path];
494
+ for (NSURL *url in pinnedURLs) {
495
+ if (!url.path.length || [paths containsObject:url.path]) continue;
496
+ // 会话文件可能已经被删/被轮转,PruneTokenCache 拿这份列表当保留集,塞不存在的
497
+ // 路径进去会让缓存条目永远清不掉。
498
+ if (![NSFileManager.defaultManager fileExistsAtPath:url.path]) continue;
499
+ [paths addObject:url.path];
500
+ [urls addObject:url];
501
+ }
502
+ return urls;
503
+ }
504
+
461
505
  static NSData *SessionTailData(NSURL *url) {
462
506
  NSFileHandle *handle = [NSFileHandle fileHandleForReadingFromURL:url error:nil];
463
507
  if (!handle) return nil;
@@ -1003,6 +1047,22 @@ static NSMutableDictionary *LoadTokenSummaryCache(NSString *path) {
1003
1047
  return cache;
1004
1048
  }
1005
1049
 
1050
+ // Codex 归档是"上月已经算完"的物化结果,一旦落盘就再也不重算(见 UsageByAddingTokenTotals
1051
+ // 里的 buildsArchive)。旧版本按日期目录名剪枝,长期续写旧会话的机器归出来的档本身就是缺数的,
1052
+ // 光换扫描口径不会自愈。版本号对不上就整份丢掉,让下一轮重新归一次。
1053
+ static NSString *const MonthlyArchiveSchemaKey = @"schema";
1054
+ static const NSInteger MonthlyArchiveSchemaVersion = 2;
1055
+
1056
+ static NSMutableDictionary *LoadMonthlyUsageArchive(NSString *path) {
1057
+ NSMutableDictionary *archive = LoadTokenSummaryCache(path);
1058
+ NSDictionary *schema = [archive[MonthlyArchiveSchemaKey] isKindOfClass:NSDictionary.class]
1059
+ ? archive[MonthlyArchiveSchemaKey] : nil;
1060
+ if ([schema[@"version"] integerValue] != MonthlyArchiveSchemaVersion) [archive removeAllObjects];
1061
+ // PruneMonthlyArchive 按 YYYY-MM 的字典序裁剪,"schema" 排在所有月份键之后,不会被裁掉。
1062
+ archive[MonthlyArchiveSchemaKey] = @{@"version": @(MonthlyArchiveSchemaVersion)};
1063
+ return archive;
1064
+ }
1065
+
1006
1066
  // NSData 是类簇,可变性判断不能靠 isKindOfClass:二进制 plist 解析出来的**不可变**
1007
1067
  // __NSCFData 对 isKindOfClass:NSMutableData 同样返回 YES。据此把只读缓冲区当成可变的
1008
1068
  // 原地 appendBytes,就会写到它末尾之外——ASan 抓到的正是这一下:
@@ -1066,7 +1126,8 @@ static void PruneMonthlyArchive(NSMutableDictionary *archive) {
1066
1126
  // 收窄到本月,上月的会话文件再也不会被打开;archiveChanged 置位表示这一轮新写了归档,
1067
1127
  // 调用方据此落盘。
1068
1128
  static NSDictionary *UsageByAddingTokenTotals(NSDictionary *usage, NSURL *sessionsURL,
1069
- NSMutableDictionary *cache, NSMutableDictionary *archive, BOOL *archiveChanged) {
1129
+ NSArray<NSURL *> *pinnedURLs, NSMutableDictionary *cache, NSMutableDictionary *archive,
1130
+ BOOL *archiveChanged) {
1070
1131
  if (![usage isKindOfClass:NSDictionary.class]) usage = @{};
1071
1132
  BOOL apiMode = ProviderShowsAPIUsage(CodexUsageDisplayModeKey);
1072
1133
  NSTimeInterval rollingFloor = RollingTokenWindowFloor();
@@ -1084,7 +1145,7 @@ static NSDictionary *UsageByAddingTokenTotals(NSDictionary *usage, NSURL *sessio
1084
1145
  BOOL buildsArchive = apiMode && !archivedDaily;
1085
1146
  NSTimeInterval earliest = buildsArchive ? previousMonthStart
1086
1147
  : (apiMode ? fmin(monthStart, rollingFloor) : rollingFloor);
1087
- NSArray<NSURL *> *urls = RecentCodexSessionURLs(sessionsURL, earliest);
1148
+ NSArray<NSURL *> *urls = TokenAggregationURLs(sessionsURL, earliest, pinnedURLs);
1088
1149
  NSDictionary *five = [usage[@"fiveHour"] isKindOfClass:NSDictionary.class]
1089
1150
  ? usage[@"fiveHour"] : nil;
1090
1151
  NSDictionary *week = [usage[@"week"] isKindOfClass:NSDictionary.class] ? usage[@"week"] : nil;
@@ -1162,8 +1223,9 @@ NSDictionary *LatestUsage(void) {
1162
1223
  NSDictionary *usage = LatestUsageInData(tail, &exhaustedAt)
1163
1224
  ?: LatestQuotaInRecentSessions(sessions, newest);
1164
1225
  // --status 这类一次性调用不带缓存也不写归档:它只需要当下这一份数字。
1165
- usage = UsageByAddingTokenTotals(usage, sessions, [NSMutableDictionary dictionary],
1166
- LoadTokenSummaryCache(MonthlyUsageArchivePath(@"codex", sessions.path)), NULL);
1226
+ usage = UsageByAddingTokenTotals(usage, sessions, newest ? @[newest] : nil,
1227
+ [NSMutableDictionary dictionary],
1228
+ LoadMonthlyUsageArchive(MonthlyUsageArchivePath(@"codex", sessions.path)), NULL);
1167
1229
  return UsageByMarkingExhaustion(usage, exhaustedAt.doubleValue);
1168
1230
  }
1169
1231
 
@@ -1195,6 +1257,9 @@ static const NSTimeInterval TokenCacheSaveInterval = 60.0;
1195
1257
  @property NSTimeInterval tokenComputedAt;
1196
1258
  @property NSTimeInterval exhaustedAt;
1197
1259
  @property BOOL forcesTokenAggregation;
1260
+ // 内核已经点名"刚被写过"的会话文件:当前正在增量读取的这个,以及最近几批 FSEvents 报上来的
1261
+ // 并发会话。它们无条件参与 Token 聚合,不受日期目录扫描的取舍影响。
1262
+ @property NSMutableArray<NSURL *> *pinnedSessionURLs;
1198
1263
  @end
1199
1264
 
1200
1265
  @implementation CodexUsageReader
@@ -1205,7 +1270,8 @@ static const NSTimeInterval TokenCacheSaveInterval = 60.0;
1205
1270
  _tokenSummaryCachePath = TokenSummaryCachePath(@"codex", _sessionsURL.path);
1206
1271
  _tokenSummaryCache = LoadTokenSummaryCache(_tokenSummaryCachePath);
1207
1272
  _monthlyArchivePath = MonthlyUsageArchivePath(@"codex", _sessionsURL.path);
1208
- _monthlyArchive = LoadTokenSummaryCache(_monthlyArchivePath);
1273
+ _monthlyArchive = LoadMonthlyUsageArchive(_monthlyArchivePath);
1274
+ _pinnedSessionURLs = [NSMutableArray array];
1209
1275
  }
1210
1276
  return self;
1211
1277
  }
@@ -1230,8 +1296,11 @@ static const NSTimeInterval TokenCacheSaveInterval = 60.0;
1230
1296
  return UsageByMarkingExhaustion(result, self.exhaustedAt);
1231
1297
  }
1232
1298
  BOOL archiveChanged = NO;
1299
+ // 正在增量读取的会话永远排在钉住列表最前面:它是最不该被漏掉的那一个,而漏掉它
1300
+ // 恰恰是"额度读得出、今日 Token 却是 0"的成因。
1301
+ [self notePinnedSessionURL:self.sessionURL];
1233
1302
  NSDictionary *result = UsageByAddingTokenTotals(usage, self.sessionsURL,
1234
- self.tokenSummaryCache, self.monthlyArchive, &archiveChanged);
1303
+ self.pinnedSessionURLs, self.tokenSummaryCache, self.monthlyArchive, &archiveChanged);
1235
1304
  if (archiveChanged) {
1236
1305
  PruneMonthlyArchive(self.monthlyArchive);
1237
1306
  if (self.persistsCache) SaveTokenSummaryCache(self.monthlyArchive, self.monthlyArchivePath);
@@ -1248,6 +1317,27 @@ static const NSTimeInterval TokenCacheSaveInterval = 60.0;
1248
1317
  - (void)noteExhaustion:(NSNumber *)timestamp {
1249
1318
  if (timestamp.doubleValue > self.exhaustedAt) self.exhaustedAt = timestamp.doubleValue;
1250
1319
  }
1320
+ // 最近被写过的会话,最新的排在前面。并发会话不会太多,留 8 个足够覆盖一批 FSEvents;
1321
+ // 更早的那些反正也会被目录扫描按 mtime 捞回来,钉住它们只是白读文件。
1322
+ static const NSUInteger MaximumPinnedSessions = 8;
1323
+
1324
+ - (void)notePinnedSessionURL:(NSURL *)url {
1325
+ if (!url.path.length) return;
1326
+ NSMutableArray<NSURL *> *pinned = self.pinnedSessionURLs;
1327
+ if (!pinned) {
1328
+ pinned = [NSMutableArray array];
1329
+ self.pinnedSessionURLs = pinned;
1330
+ }
1331
+ for (NSUInteger index = 0; index < pinned.count; index++) {
1332
+ if ([pinned[index].path isEqualToString:url.path]) {
1333
+ [pinned removeObjectAtIndex:index];
1334
+ break;
1335
+ }
1336
+ }
1337
+ [pinned insertObject:url atIndex:0];
1338
+ while (pinned.count > MaximumPinnedSessions) [pinned removeLastObject];
1339
+ }
1340
+
1251
1341
  - (void)selectSessionURL:(NSURL *)url {
1252
1342
  self.sessionURL = url;
1253
1343
  self.offset = 0;
@@ -1256,6 +1346,7 @@ static const NSTimeInterval TokenCacheSaveInterval = 60.0;
1256
1346
  self.usage = nil;
1257
1347
  return;
1258
1348
  }
1349
+ [self notePinnedSessionURL:url];
1259
1350
  NSFileHandle *handle = [NSFileHandle fileHandleForReadingFromURL:url error:nil];
1260
1351
  if (!handle) return;
1261
1352
  unsigned long long size = [handle seekToEndOfFile];
@@ -1379,6 +1470,9 @@ static const NSTimeInterval TokenCacheSaveInterval = 60.0;
1379
1470
  double chosenSampledAt = [self.usage[@"sampledAt"] doubleValue];
1380
1471
  for (NSURL *url in urls) {
1381
1472
  if (![self isSessionURL:url]) continue;
1473
+ // 额度竞选的输赢与 Token 聚合无关:这一批里每个会话文件都刚被写过,落选的那些
1474
+ // 同样带着新的 token_count。钉住它们,别再让日期目录扫描替内核做一次取舍。
1475
+ [self notePinnedSessionURL:url];
1382
1476
  if (self.sessionURL && [url.path isEqualToString:self.sessionURL.path]) {
1383
1477
  currentSession = url;
1384
1478
  continue;
package/package.json CHANGED
@@ -1,16 +1,16 @@
1
1
  {
2
2
  "name": "cc-pets",
3
- "version": "1.4.7",
3
+ "version": "2.0.0",
4
4
  "description": "A native macOS desktop pet for Codex CLI and Claude Code",
5
- "author": "wangxinyusqn",
5
+ "author": "UniverseWang",
6
6
  "license": "MIT",
7
7
  "repository": {
8
8
  "type": "git",
9
- "url": "git+https://gitee.com/wangxinyusqn/cc-pets.git"
9
+ "url": "git+https://github.com/wangxinyu-sqn/cc-pets.git"
10
10
  },
11
- "homepage": "https://gitee.com/wangxinyusqn/cc-pets",
11
+ "homepage": "https://github.com/wangxinyu-sqn/cc-pets",
12
12
  "bugs": {
13
- "url": "https://gitee.com/wangxinyusqn/cc-pets/issues"
13
+ "url": "https://github.com/wangxinyu-sqn/cc-pets/issues"
14
14
  },
15
15
  "keywords": [
16
16
  "codex",
package/scripts/build.sh CHANGED
@@ -51,7 +51,7 @@ if (( ${#SPRITES[@]} > 0 )); then
51
51
  cp "${SPRITES[@]}" "${BUILD_DIR}/"
52
52
  cp "${SPRITES[@]}" "${APP_RESOURCES_DIR}/"
53
53
  fi
54
- # 出厂台词。代码里不再留内置词库,这个文件就是默认台词的唯一来源,
54
+ # 默认台词。代码里不再留内置词库,这个文件就是默认台词的唯一来源,
55
55
  # 首次启动时被拷到 ~/.cc-pets/phrases.txt。
56
56
  # 裸二进制旁边也放一份:直接跑 .build/release/cc-pets 时没有 app bundle。
57
57
  cp "${PROJECT_DIR}/Resources/phrases.default.txt" "${APP_RESOURCES_DIR}/phrases.default.txt"
@@ -1,9 +1,8 @@
1
1
  #!/bin/zsh
2
2
  set -eu
3
3
 
4
- # 仓库托管在 Gitee,而这个项目必须在 macOS 上编译(Cocoa),Gitee Go 只提供 Linux
5
- # runner,跑不了真正的构建。在镜像到 GitHub 之前,本地 pre-push 钩子是唯一能真正
6
- # 起作用的"CI":推送前强制跑一遍 npm test。
4
+ # GitHub Actions 已经在 macOS runner 上跑完整测试,本地 pre-push 钩子是它的前哨:
5
+ # 推送前先在本机强制跑一遍 npm test,避免把编译不过的提交推上去。
7
6
  #
8
7
  # 用法:./scripts/install-git-hooks.sh
9
8
  # 跳过单次检查:git push --no-verify
@@ -25,6 +25,20 @@ const SOURCES = {
25
25
  homepage: "https://petdex.dev"
26
26
  }
27
27
  };
28
+ // 请求素材源时自报家门:对方运维从日志里能看出流量来自 CC Pets 而不是一串默认 UA,
29
+ // 想联系或限流都有个明确的对象。版本号跟着 package.json 走,不另外维护一份。
30
+ const USER_AGENT = (() => {
31
+ let version = "0.0.0";
32
+ try {
33
+ version = JSON.parse(
34
+ fs.readFileSync(new URL("../package.json", import.meta.url), "utf8")
35
+ ).version;
36
+ } catch {
37
+ // 版本读不到不该让下载失败,退回占位版本号即可。
38
+ }
39
+ return `cc-pets/${version} (+https://github.com/wangxinyu-sqn/cc-pets)`;
40
+ })();
41
+
28
42
  // 不能 add、只会出现在已装素材里的来源。桌宠的"导入 Codex 素材"开关会写 source: "codex"。
29
43
  const LOCAL_SOURCE_LABELS = { codex: "Codex(导入)" };
30
44
  const DEFAULT_SOURCE = process.env.CC_PETS_SOURCE || "petdex";
@@ -89,7 +103,10 @@ async function fetchManifest(sourceName, { refresh }) {
89
103
  // 缓存缺失或损坏都当作没有缓存,直接回源。
90
104
  }
91
105
  }
92
- const response = await fetch(manifestUrlFor(sourceName), { redirect: "follow" });
106
+ const response = await fetch(manifestUrlFor(sourceName), {
107
+ redirect: "follow",
108
+ headers: { "User-Agent": USER_AGENT }
109
+ });
93
110
  if (!response.ok) fail(`拉取 ${SOURCES[sourceName].label} 素材清单失败: HTTP ${response.status}`);
94
111
  const body = await response.json();
95
112
  if (!Array.isArray(body?.pets)) fail(`${SOURCES[sourceName].label} 素材清单格式不符合预期`);
@@ -108,7 +125,9 @@ async function download(url, source) {
108
125
  if (parsed.protocol !== "https:" || !source.assetHosts.includes(parsed.hostname)) {
109
126
  throw new Error(`不受信任的素材来源: ${parsed.hostname || url}`);
110
127
  }
111
- const response = await fetch(parsed, { headers: { Referer: source.referer } });
128
+ const response = await fetch(parsed, {
129
+ headers: { Referer: source.referer, "User-Agent": USER_AGENT }
130
+ });
112
131
  if (!response.ok) throw new Error(`下载失败 ${parsed.pathname} -> HTTP ${response.status}`);
113
132
  return Buffer.from(await response.arrayBuffer());
114
133
  }