cc-pets 1.4.8 → 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 +30 -286
- package/CONTRIBUTING.md +1 -1
- package/LICENSE +1 -1
- package/README.md +30 -53
- package/SECURITY.md +2 -2
- package/Sources/CCPets/CCPetsAppDelegate.m +2 -2
- package/Sources/CCPets/CCPetsPhrases.h +4 -4
- package/Sources/CCPets/CCPetsPhrases.m +7 -7
- package/Sources/CCPets/CCPetsPhrasesEditor.m +22 -22
- package/package.json +5 -5
- package/scripts/build.sh +1 -1
- package/scripts/install-git-hooks.sh +2 -3
- package/scripts/pet-store.mjs +21 -2
package/CHANGELOG.md
CHANGED
|
@@ -1,302 +1,46 @@
|
|
|
1
1
|
# 更新记录
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
本项目遵循语义化版本号。版本号以 `package.json` 为唯一来源。
|
|
4
4
|
|
|
5
|
-
## [
|
|
5
|
+
## [2.0.0] - 2026-08-23
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
`codex resume` 会一直往**建会话那天**的目录里追加,实测有用户近 8 天的全部 `token_count`
|
|
9
|
-
都写在 15 天前的 `sessions/2026/08/06/` 下。此前候选文件按 `YYYY/MM/DD` 目录名剪枝,
|
|
10
|
-
扫到过期目录就整个收手,这个仍在被写的文件一次都没被打开过——而额度百分比走的是另一条
|
|
11
|
-
按 mtime 找文件的路径,照常显示,于是现象是"额度有、Token 是 0",很难往这里想。
|
|
12
|
-
- 窗口之前的日期目录不再收手,改成继续扫、只收 **mtime** 落在窗口内的文件;连续 60 个
|
|
13
|
-
这样的目录都没捞到活跃文件才停,成本上界与历史长度无关(本机 47 个日期目录实测
|
|
14
|
-
`--status` 耗时无变化)。天数上限用完时同样降级成 mtime 过滤而不是 `return`,
|
|
15
|
-
否则上限之外那个正在续写的旧会话又会被切掉一次。
|
|
16
|
-
- 判据是 mtime 而不是文件里的时间戳:回填或伪造的时间戳不该把三个月前的会话拉回今天。
|
|
17
|
-
两条测试互为对照——事件时间戳新但 mtime 老的不计入,目录老但 mtime 新的必须计入。
|
|
18
|
-
- 当前正在增量读取的会话、以及 FSEvents 这一轮点名的并发会话,一律无条件参与聚合。
|
|
19
|
-
内核已经确认它们刚被写过,这个结论比任何按路径名或 mtime 的推断都可靠。此前额度竞选
|
|
20
|
-
落选的会话直接被丢掉,可它们同样带着新的 `token_count`。
|
|
21
|
-
- 月度归档带上 schema 版本号:旧口径归出来的档本身缺数,且一旦落盘就不再重算,
|
|
22
|
-
换了扫描方式也不会自愈,因此版本对不上就整份丢掉重算一次。
|
|
23
|
-
- 顺带修好了额度兜底路径 `LatestQuotaInRecentSessions`:它共用同一份候选列表,此前
|
|
24
|
-
在这类机器上同样看不见活跃会话,只是碰巧没被触发。
|
|
7
|
+
首个开源版本。
|
|
25
8
|
|
|
26
|
-
|
|
27
|
-
口吻时在 `~/.cc-pets/speech/<宠物名>.txt` 里**只写想改的小节**,没写的照旧走通用。
|
|
28
|
-
台词编辑器顶部多了「通用 / 当前宠物」的切换,切换宠物时自动跟随。
|
|
29
|
-
- 回落按**小节整体**做,不按行合并:专属写了 `[idle]` 就只说专属那几句,通用那一节
|
|
30
|
-
一句都不参与。按行合并的话,用户没有任何写法能表达"这只宠物这句话不要说"。
|
|
31
|
-
- 判据是"这一节在不在"而不是"有没有内容":专属里写了标签却不写台词,表示这只宠物在
|
|
32
|
-
这个情境闭嘴。当成"空的等于没写"去回落的话,这个意图就再也写不出来了。
|
|
33
|
-
- 专属词库的校验规则单独一套:缺小节是常态(缺就回落),所以"标签不能删"和
|
|
34
|
-
"`[state_*]` 至少留一句"都不适用。套通用规则的话,用户想改一句话得先抄一整份
|
|
35
|
-
22 节的文件过来。同理,保存时不给专属文件补标签——补完之后每一节都"存在",
|
|
36
|
-
这只宠物就再也不会回落了。
|
|
37
|
-
- 专属页右上角有「填入出厂模板」,解决空白页无从下手。填进来的是整份**注释状态**的
|
|
38
|
-
出厂台词:用户看得见每一节能写什么,而注释一行都不算数,所以填完之后仍然全部回落到
|
|
39
|
-
通用,想让哪一节归这只宠物管就去掉那一节的 `#`。直接填未注释的完整出厂台词是错的——
|
|
40
|
-
那样 22 节全被接管,再也不会回落;只填小节头的空骨架更糟,等于这只宠物全情境闭嘴。
|
|
41
|
-
- 专属文件懒创建,不预先给每只宠物生成空文件:空文件和没有文件语义完全一样,
|
|
42
|
-
凭空造一堆只会让目录全是噪音。删掉宠物素材也不删它的台词文件,装回来还在。
|
|
9
|
+
### 桌宠与互动
|
|
43
10
|
|
|
44
|
-
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
一张快捷键路由表,用户看不见。菜单项的 target 一律留空交给响应者链,以后新加的文本框
|
|
49
|
-
自动就有这些快捷键。
|
|
50
|
-
- 修复 `npm install` 失败:`package.json` 的 `files` 白名单逐个列 `Resources/` 下的文件,
|
|
51
|
-
新增的 `Resources/phrases.default.txt` 没进去,发布包里没有这个文件,`build.sh` 拷贝那一步
|
|
52
|
-
直接失败。本地从工作树构建看不出来,所以给发布包完整性测试补上了资源文件这一档。
|
|
11
|
+
- macOS 原生 AppKit 桌宠,运行时不依赖 Electron,也不需要 Codex/Claude 桌面端。
|
|
12
|
+
- 待机呼吸、随机小动作、拖动滞后与落脚回弹;头部、口袋、脚部和身体两侧的悬停与点击反馈。
|
|
13
|
+
- 右键菜单可切换桌宠、刷新用量、开关额度历史与系统通知、检查更新或退出。
|
|
14
|
+
- 支持内置素材与 `~/.cc-pets/pets/` 下的外部素材,兼容 `spriteVersionNumber` v1 / v2 网格。
|
|
53
15
|
|
|
54
|
-
|
|
55
|
-
没有"变成一个平凡的判断(新文件在就是迁移过了)——靠猜内容特征(有没有 replace 行、
|
|
56
|
-
缺不缺某个小节)都不可靠,用户改过之后更没法判断。
|
|
57
|
-
- 老词库在**启动时**就自动合并进新文件,不等用户打开编辑器:拖到那时候再迁移的话,
|
|
58
|
-
从升级到他第一次点"编辑台词"这段时间,桌宠说的会是出厂台词而不是他自己写的,
|
|
59
|
-
而没人会把这件事和"我该去点一下编辑台词"联系起来。合并规则是"出厂 + 用户"取并集,
|
|
60
|
-
因为老语义就是两者混着说;老文件里写过 `replace` 的,他写过的那几节按他的来,
|
|
61
|
-
没写过的仍旧用出厂内容(照搬老语义会让 15 个 `state_` 小节全空,而新版没有兜底文案,
|
|
62
|
-
状态卡副行会直接残掉)。老文件里的注释一概不搬,按新模板的来。
|
|
63
|
-
- 老文件合并后先留着,第一次打开编辑器时问一次要不要改名成 `phrases.txt.bak` 收起来——
|
|
64
|
-
合并是我们替用户做的,动他的文件得他自己点头。改名而不是删除:内容还在原地,万一合并
|
|
65
|
-
合错了还能翻出来对;而 `PetPhrasesLegacyFilePath` 只认 `phrases.txt`,改完名它既不会
|
|
66
|
-
再被当成迁移源,也不会再弹询问。留着原名不动有两个坑:改它不会有任何效果,而且哪天
|
|
67
|
-
`speech.txt` 丢了,启动时会再从它合并一遍,把用户迁移之后写的台词全冲掉。
|
|
68
|
-
- 台词改成"文件即全部":删掉代码里的内置词库,默认台词变成随 app 打包的
|
|
69
|
-
`Resources/phrases.default.txt`,首次启动拷到 `~/.cc-pets/phrases.txt`,之后运行时
|
|
70
|
-
只认这个文件。同时删掉 merge / `replace` 两种模式——运行期同时存在两份词库就必然
|
|
71
|
-
要回答"以谁为准",而那正是原来那套配置让人看不懂的根源。现在删掉一节就是那个情境
|
|
72
|
-
不吭声,用户看到的文件就是桌宠的全部台词。
|
|
73
|
-
- 台词编辑从「交给系统文本编辑器」换成 app 内置编辑器。原来那条路没有任何反馈:
|
|
74
|
-
小节名拼错、句子超 30 字、槽位写错名字全是静默失效,用户只知道"改了没用"。
|
|
75
|
-
- 标签行被删掉时,保存会自动把它加回原位并告知补了哪些(⌘Z 可撤销)。光报错等于把人
|
|
76
|
-
卡死:编辑器里已经看不到那一行,用户既不知道少的是哪个,也不知道该写成什么样,
|
|
77
|
-
只能翻文档或者点"恢复出厂"把自己的改动全丢掉。标签被删而台词还在时,那串台词会并进
|
|
78
|
-
上一节,所以标签要插回那串台词**前面**才能带着它们一起归位;标签连着台词一起删掉的
|
|
79
|
-
情况下只补标签,不能顺手把上一节的台词抢过来。
|
|
80
|
-
- 保存时校验并当场列出问题。标签行是配置项,22 个一个都不能删;
|
|
81
|
-
能不能留空才分两种——`[state_*]` 是状态卡副行的唯一正文来源,空了也拦,情绪句留空
|
|
82
|
-
只提示(就是那个情境不主动开口)。"整行被删"和"还在但空了"分开报,因为要做的动作
|
|
83
|
-
不一样:一个是把 `[标签]` 那行加回来,一个是补句台词。槽位名拼错也会报——这类最难自查。
|
|
84
|
-
- 连续的"不在任何 [情境] 下面"的散句合并成一条提示。删掉一个小节头会让它下面整串台词
|
|
85
|
-
变成散句,逐行报的话十几条提示会把真正该看的那条错误挤下去。
|
|
86
|
-
- 编辑器的保存分成「保存」(⌘S)和「保存并关闭」(⏎)。⌘S 而不是回车是因为这是多行
|
|
87
|
-
文本编辑器,回车要用来换行。校验没过或 mtime 冲突被取消时不关窗,避免改动跟着窗口一起没。
|
|
88
|
-
- 编辑器新增「试说一句」:选一个情境,桌宠当场说出来。读的是还没保存的文本,槽位用
|
|
89
|
-
示例数据填,不用等真的额度告急才能看到效果。另有「恢复出厂台词…」(可 ⌘Z 撤销)。
|
|
90
|
-
- 保存前比对 mtime,文件被外部改过时问一次,可选覆盖或重新载入,不静默吃掉别人的改动。
|
|
91
|
-
- 状态卡副行没有内容时收成单行,不再留一块空白——代码里已经没有兜底文案了,
|
|
92
|
-
外部编辑器清空某个 `state_` 小节时显示层必须自己站得住。
|
|
16
|
+
### 额度与用量
|
|
93
17
|
|
|
94
|
-
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
- 碎碎念借走状态卡副行说完一句后会自动还原状态文案(`restoreStatusDetail`),此前借走就
|
|
99
|
-
不还,副行会一直挂着上一句闲话;同时不再用闲话覆盖 `lastPetVoiceText`,那是状态文案的
|
|
100
|
-
去重缓存,被污染后下一次同状态事件会把闲话当成该状态的文案复读出来。
|
|
101
|
-
- 右键菜单「碎碎念」新增频率四档(很少 / 正常 / 较多 / 话痨)。每小时预算、两句间隔、
|
|
102
|
-
静默门槛、出话概率这四道闸互相牵制,单调任何一道都不会真的变频繁,所以只对用户暴露
|
|
103
|
-
一个档位、四个值一起走;正常档即改造前的原值。`CCPetsSpeechCooldown` 与
|
|
104
|
-
`CCPetsSpeechHourlyBudget` 保留为更细的手动覆盖,写了就压过档位。
|
|
105
|
-
- README 补齐「碎碎念」一节:频率档位表、`phrases.txt` 写法、槽位与情境标签契约、
|
|
106
|
-
调试用的 `defaults` 键(含域名必须是 bundle identifier 这一点)。
|
|
18
|
+
- 从本机 `~/.codex/sessions` 与 Claude Code 官方 status line 数据读取 5 小时额度、周额度和重置时间。
|
|
19
|
+
- 悬停口袋展开额度面板,用两张卡分别展示 Codex、Claude 的剩余百分比、本机 Token 与近 7 天趋势。
|
|
20
|
+
- 可选记录最近 7 天的本地额度历史;默认关闭,仅保存在本机。
|
|
21
|
+
- 支持「订阅额度 / API 用量」两种展示模式。
|
|
107
22
|
|
|
108
|
-
|
|
109
|
-
### 桌宠活物感改造
|
|
23
|
+
### Agent 状态
|
|
110
24
|
|
|
111
|
-
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
`--render-*` 一格宠物都不画,改坏 PetView 它们照样全绿)。改造过程中它抓到两次
|
|
116
|
-
等价性破坏:素材经 `LoadPetSpriteImage` 缩略后未必能被行列整除(默认素材单格高
|
|
117
|
-
151.67px),`CGImageCreateWithImageInRect` 预裁会把小数矩形取整、`contentsRect` 交给
|
|
118
|
-
CA 缩放也有自己的采样相位,两者都和原来的 `drawInRect:fromRect:` 对不上,边缘整行错位。
|
|
119
|
-
最终照搬原绘制调用按格预栅格化并缓存,9 行与 11 行素材均逐字节一致。
|
|
120
|
-
- 屏幕睡眠时一并冻结 layer 时间轴并清空栅格化缓存。停表只管得住 `NSTimer` 驱动的逐帧
|
|
121
|
-
动画,CA 动画的时钟在 render server 那边,屏幕睡了照跑。
|
|
122
|
-
- 待机加入呼吸(1.5px 上浮,`reduceMotion` 下不启用)。只向上不做对称摆动:宠物视图在
|
|
123
|
-
230×170 窗口里位于 (43,0,144,150),下方没有余量,往下 1px 就被窗口裁掉。
|
|
124
|
-
- 拖动加入水平滞后与落脚 squash。拖动由窗口服务器接管、拿不到连续事件,改从
|
|
125
|
-
`NSWindowDidMoveNotification` 取位移。只做水平方向:左右各有 43px 余量,垂直方向下方是 0。
|
|
126
|
-
- 待机微动层:每 8~25 秒(泊松随机)做一个有始有终的小动作。11 行素材按角度顺序连播
|
|
127
|
-
row 9/10 的朝向格,等于白捡一个转头动画——那 16 格本是静止姿势,连起来就是转头,不需要
|
|
128
|
-
任何新素材;9 行素材退到 row 3 张望。**不再改待机循环本身的节奏**:随机长停某一帧和整轮
|
|
129
|
-
变速都试过,素材不受控(第 0 帧不保证是自然站姿),一律被读成"动画卡住了"。
|
|
130
|
-
- 内在状态:无聊曲线(闲置 2/10/30 分钟三档,微动频率先升后降)、生理余韵(agent 事件累积
|
|
131
|
-
用力值,25 秒半衰期,呼吸分三档快慢)、注意力惯性(鼠标移动 88% 被忽略,被吸引后 3~8 秒
|
|
132
|
-
失去兴趣,再冷却 4~12 秒)。注意力惯性顺带把绕宠物移动鼠标时的开销压了下来。
|
|
133
|
-
- 无聊曲线的计时基准是真实事件流而不是 `agentActive`:`mouseDown:` 会无条件清掉后者,
|
|
134
|
-
用户随手点一下宠物就会让曲线误启动。上次交互时间落盘,隔几小时再开机从"打盹"档开始。
|
|
135
|
-
- 素材能力(是否有十六向朝向行)在换素材时算一次,微动改为按能力过滤的数据表;行数判断从
|
|
136
|
-
四处收敛到一处,两档行为密度保持一致,切换素材应读作"性格不同"而非"功能残缺"。
|
|
25
|
+
- 由 Codex Hooks 与 Claude Code Hooks 驱动思考、工具调用、审批、子 Agent、完成与失败动画。
|
|
26
|
+
- 桌宠旁显示脱敏后的玻璃状态卡片,可折叠并显示活跃 CLI 会话数。
|
|
27
|
+
- 可分别启用任务完成、失败和等待审批的 macOS 系统通知。
|
|
28
|
+
- 第三方 CLI Agent 可通过统一 Provider 事件协议接入,详见 `PROVIDER_PROTOCOL.md`。
|
|
137
29
|
|
|
138
|
-
###
|
|
30
|
+
### 台词
|
|
139
31
|
|
|
140
|
-
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
- 排版层级反转:事实降为眉标(11pt Medium 浅灰),宠物的话升为正文(14pt Medium 深色)。
|
|
144
|
-
- 状态卡与说话气泡按文案长度伸缩,不再是固定宽度。宽度用控件自身的 `fittingSize` 量——
|
|
145
|
-
按字符串量的 `sizeWithAttributes:` 比 `NSTextField` 真正需要的窄几个点,会让"刚好够"
|
|
146
|
-
变成省略号。
|
|
147
|
-
- 新增"碎碎念":额度告急、连续失败、深夜、久坐、久别重逢等时刻主动说一句。每小时上限 4 句
|
|
148
|
-
且两句间隔至少 4 分钟——状态播报不受此限,那是替换样板文案而非额外说话。有状态卡时话并入
|
|
149
|
-
它的副行,没有才起独立气泡,同一时刻屏幕上只有一个东西在说话。
|
|
150
|
-
- 额度台词按档位下穿触发(20%/10%/5%),不是"低于阈值就一直说";额度是分钟级刷新的,
|
|
151
|
-
不设档一小时预算瞬间烧光。回血后档位回升,下个周期才能再触发。
|
|
32
|
+
- 桌宠台词全部来自 `~/.cc-pets/speech.txt`,可在内置编辑器中修改,支持实时数据槽位。
|
|
33
|
+
- 可为单只宠物写专属台词(`~/.cc-pets/speech/<宠物名>.txt`),按小节整体覆盖通用台词。
|
|
34
|
+
- 四档碎碎念频率,Agent 工作期间不插嘴。
|
|
152
35
|
|
|
153
|
-
###
|
|
36
|
+
### 安装与集成
|
|
154
37
|
|
|
155
|
-
-
|
|
156
|
-
|
|
157
|
-
-
|
|
158
|
-
|
|
159
|
-
- 用户台词永远按数据处理,绝不交给 `stringWithFormat:`——一个 `%@` 就会让桌宠当场崩溃。
|
|
160
|
-
测试里有断言守着这条,以及行尾注释剥离、超长条目丢弃、槽位缺值时整条作废(宁可不说,
|
|
161
|
-
也不吐出带花括号的半成品)。
|
|
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` 提供可重复执行的初始化与清理流程。
|
|
162
42
|
|
|
163
|
-
###
|
|
43
|
+
### 隐私
|
|
164
44
|
|
|
165
|
-
-
|
|
166
|
-
-
|
|
167
|
-
- 常驻内存较改造前上升,栅格化缓存上限已从 48 格降到 20 格并在息屏时清空,实际效果待复测。
|
|
168
|
-
|
|
169
|
-
## [1.3.2] - 2026-08-17
|
|
170
|
-
- 优化“切换桌宠”子菜单:素材名称按 5 个中文字符的视觉宽度展示,超出后追加 `...`;外部素材增加
|
|
171
|
-
垃圾桶删除入口,首次点击后原位置变为红字“确认”,再次点击才执行删除。切换或删除素材时
|
|
172
|
-
子菜单保持展开,并立即更新当前项勾选和删除状态;内置素材及当前已应用素材不显示删除图标。
|
|
173
|
-
|
|
174
|
-
## [1.3.1] - 2026-08-17
|
|
175
|
-
- 修复长期使用后桌宠崩溃、且此后每次启动都在 0.2 秒内再崩(表现为"打不开了"):Claude
|
|
176
|
-
Token 摘要缓存落盘后,下次启动读回时会对同一块缓冲区继续追加新记录,而判断它可不可变
|
|
177
|
-
用的是 `isKindOfClass:NSMutableData`——`NSData` 是类簇,二进制 plist 解析出来的**不可变**
|
|
178
|
-
`__NSCFData` 对这个判断同样返回 YES。于是只读缓冲区被当成可变的原地 `appendBytes`,
|
|
179
|
-
每条记录写出界 48 字节(ASan:`heap-buffer-overflow`,`0 bytes after 6640-byte region`,
|
|
180
|
-
分配点在 `__CFBinaryPlistCreateObjectFiltered`)。越界写破坏的是堆元数据,进程不会当场
|
|
181
|
-
死,而是在之后任意一次内存分配上倒下,所以三份崩溃报告的落点(`EnumerateLines`、
|
|
182
|
-
`SaveTokenSummaryCache`)和真正的写入点毫无关系,只是先撞上的受害者。
|
|
183
|
-
触发要同时满足"缓存已落盘、重启后读回、该会话文件之后又变长",因此新装的机器碰不到,
|
|
184
|
-
攒够会话的老用户则一旦中招每次启动必崩。改为缓存一读回来就把记录换成本进程创建的可变
|
|
185
|
-
副本,只替换记录本身、其余字段原样保留(Codex 侧条目形状不同,整条重建会抹掉
|
|
186
|
-
`start`/`total`/`segments`/`days`);追加处那个失效的可变性判断一并删除,避免再写回去。
|
|
187
|
-
- `cc-pets --clean` 补上 Token 摘要缓存(`*-token-cache-*.plist`、`*-monthly-usage-*.plist`
|
|
188
|
-
及落盘中断留下的 `.tmp`)。它同样只是缓存,丢了只意味着重新解析一遍会话文件,原先却漏在
|
|
189
|
-
清理之外,于是缓存一旦出问题,`clean` 救不回来,只能让用户手动删文件。
|
|
190
|
-
## [1.3.0] - 2026-08-12
|
|
191
|
-
- 修复面板上的剩余额度来回跳(实测 Claude 5 小时窗口 99% → 94% → 又回 99%):多个会话的
|
|
192
|
-
status line 各写各的额度快照到同一个文件,而"响应更早、落盘更晚"在并发下完全正常,
|
|
193
|
-
无条件覆盖会让旧快照盖掉新快照。改为逐窗口按"同一 `resets_at` 内用量只增不减"取舍,
|
|
194
|
-
窗口滚动(`resets_at` 变大)时无条件接受,某个窗口超过 10 分钟没有被接受过时也放行,
|
|
195
|
-
免得官方口径调整(例如临时提额)后面板被钉死——这个逃生阀按窗口各记各的接受时刻,
|
|
196
|
-
被拒绝的快照不会把它续期,否则只要还有会话在持续上报就永远到不了。读改写全程用独立
|
|
197
|
-
锁文件加 `flock` 串行化,数据文件仍由 rename 整体替换;加锁是非阻塞加有限重试,拿不到
|
|
198
|
-
就放弃这次采样,免得一个卡死的写者把之后每一次 status line 渲染永久挂住。响应缺某个
|
|
199
|
-
窗口时保留旧值,不再整块覆盖。
|
|
200
|
-
Codex 侧同一问题一并修,判据统一成"按额度采样时刻取最新":兜底扫描近期会话时不再按
|
|
201
|
-
文件 mtime 命中即返回;一批文件事件里有多个会话同时变更时,也不再取遍历到的最后一个,
|
|
202
|
-
而是读各自的尾巴比采样时刻(会话拿到额度后还会追加别的行,mtime 顺序和采样顺序并不
|
|
203
|
-
一致)。内核已经点名变更文件的路径不再重跑基于 mtime 的会话发现,否则刚选中的结果会
|
|
204
|
-
立刻被推翻。`cc-pets --clean` / 完整卸载会一并删除额度写锁;7 天启动清理刻意放过它,
|
|
205
|
-
锁文件 mtime 创建后不再更新,删掉一个正被持有的锁会让互斥失效。
|
|
206
|
-
- 修复敲 `Claude` / `Codex`(任意非全小写写法)时桌宠不启动:shell 集成从 alias 改为
|
|
207
|
-
`~/.cc-pets/shims` 下的软链加 `PATH` 前置。alias 名区分大小写,而 macOS 文件系统默认
|
|
208
|
-
不区分,`Claude` 匹配不到 alias 就直接命中真二进制,绕过了包装脚本。shim 靠文件系统
|
|
209
|
-
自身的大小写不敏感覆盖全部写法。包装脚本随之不再用 `whence -p` 找真二进制(会先命中
|
|
210
|
-
shim 自己导致无限 `exec`),改为遍历候选并跳过 shim。升级会自动把旧 alias 段迁移成
|
|
211
|
-
shim 段,卸载会一并删除软链和目录。
|
|
212
|
-
- 新增 `cc-pets pet` 素材管理命令(`search` / `add` / `list` / `remove` / `source` / `dir`),
|
|
213
|
-
把素材下载到 cc-pets 自己的目录 `~/.cc-pets/pets/`,不再写 `~/.petdex/pets/` 和
|
|
214
|
-
`~/.codex/pets/`。两端都认 `CC_PETS_PETS_DIR` 覆盖。
|
|
215
|
-
- 桌宠端只扫 `~/.cc-pets/pets/` 和包内素材,无条件不再读 `~/.petdex/pets/` 和
|
|
216
|
-
`~/.codex/pets/`——那两个目录由别的工具写入,混在一起就挑不出自己装的宠物。
|
|
217
|
-
- 新增“导入 Codex 素材”开关(右键菜单,默认关):打开时立即把 `~/.codex/pets/` 里
|
|
218
|
-
有精灵图的素材**复制**进自己的目录,之后每次启动再导入一次。复制而非关联,Codex
|
|
219
|
-
那边的后续改动不影响桌宠;同名目录一律跳过不覆盖,自己装的素材优先;导入的素材写
|
|
220
|
-
`.source.json`(`source: "codex"`),`cc-pets pet list` 里单独分组。重复导入是幂等的。
|
|
221
|
-
- 素材列表改为启动时加载一次,之后按素材目录的 mtime 判断是否重扫。`add` / `remove`
|
|
222
|
-
会改动目录因而立即生效,没有增删时打开右键菜单只做一次 `stat`,不再每次遍历目录。
|
|
223
|
-
- 素材来源抽象成「源」:`SOURCES` 表里一行就是一个源(清单地址、资源 host 白名单、
|
|
224
|
-
Referer),当前内置 PetDex,名称支持 `petdex:boba` 这样的源前缀,默认源用
|
|
225
|
-
`CC_PETS_SOURCE` 切换。这样以后接自建 registry 不用动命令面和目录结构。
|
|
226
|
-
清单按源分别缓存 6 小时,下载只接受源白名单内的 host。
|
|
227
|
-
- 素材来源记在宠物目录内的 `.source.json`,目录名保持素材本名,桌宠菜单不受影响;
|
|
228
|
-
`list` 按来源分组。跨源同名或覆盖手放素材时 `add` 会拒绝并提示用 `--as` 改名安装,
|
|
229
|
-
同源重装则直接更新。
|
|
230
|
-
- 新增 Codex 与 Claude Code 本地 Token 用量统计,按官方重置时间对齐 5 小时与 7 天窗口;
|
|
231
|
-
Claude 侧按 `message.id + requestId` 去重,避免 `--resume`/fork 复制的记录重复计数。
|
|
232
|
-
官方订阅额度仍以服务端百分比为准。
|
|
233
|
-
- Token 聚合改为增量跟读并按额度窗口节流,事件驱动的高频刷新不再重复扫描近 7 天会话;
|
|
234
|
-
过期日期目录按目录名剪枝,无 Token 数据的会话文件缓存失败结果不再反复重读。
|
|
235
|
-
- 新开 Codex 会话时不再因为尚无 `rate_limits` 而清空面板上已知的额度。
|
|
236
|
-
- 修正跨窗口 Codex 会话的 Token 高估:Codex 会把同一份 `token_count` 重复写进会话
|
|
237
|
-
(实测近 7 天 68 个会话里 14 个存在重复,累加值整体偏高约 1%,最差的单个会话偏高
|
|
238
|
-
7.7%),窗口内那一段改为按 `total_token_usage` 求差,累计值对重复事件是幂等的。
|
|
239
|
-
- 桌宠端不再跟随继承来的 `CODEX_HOME`,与 `CLAUDE_CONFIG_DIR` 的处理对齐:常驻进程会一直
|
|
240
|
-
带着启动时的环境,用它选目录等于永久绑定到第一个拉起桌宠的那份 Codex 配置。需要时用
|
|
241
|
-
`CC_PETS_CODEX_HOME` 覆盖;跑在会话里的记录端仍认 `CODEX_HOME`。
|
|
242
|
-
- 修复存在多个 Claude 配置目录时统计错账号:桌宠是被客户端启动的常驻进程,会一直带着
|
|
243
|
-
启动时的 `CLAUDE_CONFIG_DIR`,等于永久绑定到"第一个拉起它的账号"。现固定只统计
|
|
244
|
-
`~/.claude`(可用 `CC_PETS_CLAUDE_CONFIG_DIR` 覆盖),包装脚本启动桌宠时也不再透传该
|
|
245
|
-
变量。额度文件改为按配置目录分开存放,多个配置目录的 status line 不再互相覆盖——此前
|
|
246
|
-
面板可能把一个账号的剩余百分比配上另一个账号的用量。
|
|
247
|
-
- 应用内更新遇到暂时性故障时自动重试一次,不再直接弹"更新失败"。刚发布的版本存在
|
|
248
|
-
registry 传播竞态:`/latest` 已经报出新版本,而同一时刻 `npm install cc-pets@<新版本>`
|
|
249
|
-
解析到的包元数据可能还是旧的并报 `ETARGET`。重试改用一次性缓存目录强制冷取
|
|
250
|
-
(`--prefer-online` 命中 304 时仍会拿到旧元数据),不影响用户真正的 npm 缓存。
|
|
251
|
-
权限、磁盘、脚本失败等真实故障不重试,照常上报。
|
|
252
|
-
- 修复状态气泡在任务完成后被打回"正在思考":`Stop` 之后仍会飘来 `SubagentStop` /
|
|
253
|
-
`PostToolUse` 等尾巴事件,它们与 `UserPromptSubmit` 归一成同一个状态,现按事件名拦截,
|
|
254
|
-
终态只能被新一轮真实动作解除。
|
|
255
|
-
- 状态气泡新增"待机中":`正在启动` 超过 8 秒没有后续事件即落到待机,不再让启动态和
|
|
256
|
-
空闲态显示成同一句"正在准备当前会话…"。
|
|
257
|
-
- 修复测试污染用户真实事件流:跑包装脚本的用例只隔离了 `TMPDIR`,而事件文件走
|
|
258
|
-
`NSTemporaryDirectory()` 不认它,每次跑测试都会写入 3 条 `SessionStart`,把正在运行的
|
|
259
|
-
桌宠打回"正在启动"。相关用例补上 `CC_PETS_STATE_DIR`,并加了基线校验防止再犯。
|
|
260
|
-
- 修复额度卡片的在线徽章恒亮:此前按"有没有额度数据"判定,而额度会一直缓存,导致
|
|
261
|
-
客户端早已退出、甚至单独打开 App 从未运行过 Agent 时两张卡片也显示在线。现改为按该
|
|
262
|
-
provider 是否还有存活客户端判定,并用事件活跃度覆盖不经包装脚本启动的会话。包装脚本
|
|
263
|
-
启动的会话退出后 3 秒内转为"离线",不再被为直接启动会话准备的 60 秒静默宽限拖住。
|
|
264
|
-
- 额度面板调整信息层级:官方剩余百分比升为主值、本机 Token 降为次级;汇总条改为
|
|
265
|
-
分别展示 Codex、Claude 的「今日」与「最近 7 天」Token;统计改用与订阅无关的自然日窗口,
|
|
266
|
-
并保留 Provider 归属;"数据刷新"改由面板自身定时器走字;无 Agent 在线时
|
|
267
|
-
状态配色转灰;额度窗口缺失的列标注"当前无活跃窗口"。
|
|
268
|
-
- 新增 `cc-pets clean` 和带确认的 `cc-pets uninstall --purge`,并自动清理测试临时目录与过期运行状态。
|
|
269
|
-
- 更新日志每次更新前截断,并限制为最近 1 MB,避免长期残留增长。
|
|
270
|
-
- Codex/Claude 额度读取改为 FSEvents/VNODE 事件监听,并保留 120 秒容错刷新,降低空闲文件扫描与 JSON 解析。
|
|
271
|
-
- 精灵图按显示尺寸降采样,菜单预览改用有限缓存;待审批记录增加 TTL 与容量上限。
|
|
272
|
-
- 低电量模式和系统“减少动态效果”开启时自动降低动画刷新频率。
|
|
273
|
-
- 新增可展开折叠的玻璃 Agent 状态卡片、活跃 CLI 会话数徽标和可选的完成、失败、审批系统通知。
|
|
274
|
-
- 历史记录与系统通知设置改用右侧高对比度迷你开关,支持在菜单保持展开时连续调整。
|
|
275
|
-
- 折叠圆钮固定锚定在桌宠头部右上区域,展开和折叠时不再跳动。
|
|
276
|
-
- Agent 连续 1 分钟没有新状态事件时,状态卡片和圆钮会自动隐藏。
|
|
277
|
-
- Codex/Claude 包装器会在启动桌宠前写入 Provider 启动事件,避免共享事件流导致启动瞬间显示错误来源。
|
|
278
|
-
- 工具或子 Agent 完成后,状态卡片会恢复为思考中;仅在当前回合真正结束时显示任务完成。
|
|
279
|
-
- 新增统一 Provider 事件协议,第三方 CLI Agent 可接入桌宠状态和动画。
|
|
280
|
-
- 新增默认关闭的本地额度历史,按 15 分钟采样并滚动保留 7 天趋势。
|
|
281
|
-
|
|
282
|
-
## [0.2.15] - 2026-07-24
|
|
283
|
-
|
|
284
|
-
- 支持 Codex/PetDex `spriteVersionNumber: 2` 的 `8×11` 精灵图布局及十六向鼠标跟随。
|
|
285
|
-
- 新增右键“检查更新…”,可在应用内确认并完成 npm 版本升级,无需手动打开终端。
|
|
286
|
-
- 自动更新成功后由独立进程等待旧桌宠退出并启动新版,避免旧进程继续报告可更新。
|
|
287
|
-
|
|
288
|
-
## [0.2.0] - 2026-07-22
|
|
289
|
-
|
|
290
|
-
- 项目和 npm 包更名为 CC Pets。
|
|
291
|
-
- 新版安装器会自动清理旧版 `codex-pet` Hooks、Claude status line 包装和 shell aliases。
|
|
292
|
-
- 旧版迁移只匹配 CC Pets 的完整命令签名,避免误删复用相似标记的其他工具配置。
|
|
293
|
-
- 新增原创默认桌宠 ByteMochi,移除公开包中的第三方角色素材。
|
|
294
|
-
- 新增 Codex CLI 与 Claude Code CLI 共存、Agent 动画和额度面板。
|
|
295
|
-
- 新增 PetDex 外部素材动态扫描与桌宠切换。
|
|
296
|
-
- 新增 `cc-pets uninstall`,可移除本项目 Hooks、恢复 Claude status line 并清理 shell aliases。
|
|
297
|
-
- 构建支持 PNG、WebP 和空素材目录。
|
|
298
|
-
- 补充隐私、安全、贡献和第三方素材说明。
|
|
299
|
-
|
|
300
|
-
## [0.1.0] - 2026-07-21
|
|
301
|
-
|
|
302
|
-
- 首个可用版本。
|
|
45
|
+
- 不上传会话内容、额度、凭据或使用统计,不包含遥测。
|
|
46
|
+
- 状态卡片与通知只显示 Provider、状态类别和脱敏后的工具类别。
|
package/CONTRIBUTING.md
CHANGED
package/LICENSE
CHANGED
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
|
-
-
|
|
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`
|
|
275
|
-
|
|
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
|
-
|
|
287
|
-
|
|
288
|
-
|
|
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
|
-
|
|
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://
|
|
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
|
-
|
|
503
|
-
|
|
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
|
-
|
|
482
|
+
程序会自动收集 `Sources/CCPets/Resources/` 下的 `.webp` 和 `.png` 作为内置素材——
|
|
483
|
+
向仓库提交新的内置素材时,必须是原创作品或带有允许再分发的明确许可证,
|
|
484
|
+
受版权保护的角色不要放进来。
|
|
508
485
|
|
|
509
486
|
### 素材管理
|
|
510
487
|
|
package/SECURITY.md
CHANGED
|
@@ -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
|
|
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
|
-
//
|
|
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
|
-
//
|
|
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
|
-
//
|
|
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:@"
|
|
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:@"
|
|
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
|
-
"
|
|
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
|
-
//
|
|
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:@"
|
|
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
|
-
//
|
|
564
|
-
alert.messageText = self.petScope ? @"清空这只宠物的专属台词?" : @"
|
|
562
|
+
// 专属词库的"默认状态"就是空白:清空 = 这只宠物全部回落到通用台词。
|
|
563
|
+
// 拿默认词库去填它是错的——那等于把 22 个小节全部标成"专属接管",再也不会回落。
|
|
564
|
+
alert.messageText = self.petScope ? @"清空这只宠物的专属台词?" : @"恢复默认台词?";
|
|
565
565
|
alert.informativeText = self.petScope ?
|
|
566
566
|
@"清空之后,这只宠物说的全部回到通用台词。还没保存,可以按 ⌘Z 撤销。" :
|
|
567
|
-
@"
|
|
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:@"
|
|
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
|
-
@"
|
|
587
|
+
@"已填入默认台词,按保存才会写进文件。" warning:NO];
|
|
588
588
|
}
|
|
589
589
|
|
|
590
590
|
@end
|
package/package.json
CHANGED
|
@@ -1,16 +1,16 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "cc-pets",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "2.0.0",
|
|
4
4
|
"description": "A native macOS desktop pet for Codex CLI and Claude Code",
|
|
5
|
-
"author": "
|
|
5
|
+
"author": "UniverseWang",
|
|
6
6
|
"license": "MIT",
|
|
7
7
|
"repository": {
|
|
8
8
|
"type": "git",
|
|
9
|
-
"url": "git+https://
|
|
9
|
+
"url": "git+https://github.com/wangxinyu-sqn/cc-pets.git"
|
|
10
10
|
},
|
|
11
|
-
"homepage": "https://
|
|
11
|
+
"homepage": "https://github.com/wangxinyu-sqn/cc-pets",
|
|
12
12
|
"bugs": {
|
|
13
|
-
"url": "https://
|
|
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
|
-
#
|
|
5
|
-
#
|
|
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
|
package/scripts/pet-store.mjs
CHANGED
|
@@ -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), {
|
|
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, {
|
|
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
|
}
|