cortico-world-wechat-claw 0.1.3 → 0.1.6

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,5 +1,108 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.1.6
4
+
5
+ 收来的文件从「插件自己的数据目录」搬进**桌宠工作区**,并把「能发什么」收紧到工作区,
6
+ 从而关掉「模型可以把本机任意文件发到微信」这个口子。两件事其实是同一件事:文件放在桌宠
7
+ 够得到的地方,边界才能划在「工作区」而不是「整台机器」。
8
+
9
+ ### 收件目录搬进工作区
10
+
11
+ - 入站媒体落在 `<工作区>/wechat-inbox/{images,files,videos,voices}/`,不再堆在
12
+ `<dataDir>/wechat-claw/inbox/`。桌宠读得到、改得了、也能发回去。
13
+ - **文件名保留对方给的原文名**,后面接本地时间戳(`报告-20261108-144219.pdf`),撞名退到
14
+ `-2`、`-3`,写入用 `wx` 独占标志,从不覆盖已有文件。文件名先过 `safeFileName`:去掉目录部分
15
+ (挡 `..` 与 `C:`)、Windows 禁止的符号、控制字符与保留名(`CON`/`NUL`/`COM1`…)。
16
+ - 压缩后的图与视频拼图放进 `<收件目录>/.derived/`,不与原件混在一起。
17
+ - 工作区是 Git 仓库时(Coopanion 的 Coo 就是,每次写文件 `git add -A`),启动时把收件目录
18
+ 追加进工作区的 `.gitignore`——十几 MB 的视频不该进版本历史。**只在 `.gitignore` 已存在时追加**,幂等。
19
+ - 工作区怎么认:`WorldContext` 不给 `memoryDir`,所以按框架自己的顺序还原——`config.json` 的
20
+ `paths.memory` 优先,其次探测 `<部署目录>/workspace`(Coo 的约定),再退到 `memory`。
21
+
22
+ ### 发送边界:只许工作区里的文件
23
+
24
+ - `wechat_send_image` / `wechat_send_file` 只接受**工作区、收件目录,以及 `sendExtraDirs` 里额外
25
+ 放行的目录**内的路径。原来的实现接受任意绝对路径——模型一旦被说服,就能把 `auth.json`、
26
+ `context-tokens.json`、浏览器 cookie 一起上传到微信 CDN。
27
+ - 判断前做 `realpath`:`..` 和符号链接都绕不出去;检查返回的规范化路径直接用于后续 `stat`/`readFile`,
28
+ 不给「检查后被换掉」留窗口。
29
+ - 拒绝时的回执列出允许的目录和收件目录,让模型改路径而不是反复试错。
30
+ - 顺带把凭据目录隔离坐实:它们在工作区之外,因此现在拿不到也发不走。
31
+
32
+ ### 配置变更
33
+
34
+ - 新增 `inboxDir`(默认空=`<工作区>/wechat-inbox`,改完需重启)。
35
+ - 新增 `sendExtraDirs`(默认空=只有工作区能发;热生效)。
36
+ - 配置组的「⚠ 安全提示:启用后模型能把本机任意文件发到微信」换成对边界的说明。
37
+ - `wechat_status` 多了 `workspace`、`inbox`、`sendRoots` 三项;环境提示词新增
38
+ `{{wechat.inbox}}` 与 `{{wechat.workspace}}`,并写清「只能发工作区里的文件」。
39
+
40
+ ### 升级注意
41
+
42
+ 旧版本收下的媒体留在 `<dataDir>/wechat-claw/inbox/` 原处,不自动搬迁——那些文件桌宠依然读不到,
43
+ 需要的话手动复制进工作区的 `wechat-inbox/`。
44
+
45
+ ## 0.1.5
46
+
47
+ 修两件事:图片/视频投递超限导致上游报错,以及分段发送时换行前的句号没被去掉。
48
+
49
+ ### 修复「超长或超大图片被直接发给 Provider,导致上游报 HTTP 400」
50
+
51
+ - **新增图片闸门**:交给模型之前先查体积、最长边、数量。默认 16 MB / 4096 像素 / 单次 10 张,
52
+ 都比上游的硬限制(32 MB / 8192 / 15 张)更保守,留出余量。
53
+ - **超限先压缩**:装了 ffmpeg 时先缩到最长边 4096,再按 JPEG 质量 3→6→9 逐级降质,
54
+ 每一级都重新查体积。
55
+ - **没装 ffmpeg 就过滤**:只判断不处理,超限的图不附。
56
+ - **丢弃必说明原因**:`[图片未附:体积 23.4 MB,超过 16 MB 上限]`、
57
+ `[图片未附:尺寸 8192×6144,最长边超过 4096 像素]`、`[图片未附:超出 10 张上限,这是第 11 张]`。
58
+ 绝不静默吞掉,免得用户以为消息丢了。
59
+ - **压不下去也说清楚**:`[图片未附:…,压缩后仍超标]`、`[图片未附:…,且没有 ffmpeg 可压缩]`。
60
+ - **先看元数据再读内容**:体积从文件系统拿、尺寸只读文件头,32 MB 的图不会先整读进内存。
61
+ - **顺手修掉一个误判**:损坏的 PNG 会让尺寸解析读出天文数字(实测 17 亿像素),
62
+ 一张 26 字节的小图会被当成超长图丢掉。现在对读出的尺寸做合理性检查。
63
+
64
+ ### 视频抽帧改成拼图
65
+
66
+ - **一次视频只产出一张图**,不再是 4 张散图。4 份图片输入变成 1 份,token 省四分之三。
67
+ - **布局跟着帧数和方向走**:竖屏横排(4 帧 4×1、9 帧 9×1),横屏网格(4 帧 2×2、6 帧 3×2、
68
+ 9 帧 3×3)。空格由 ffmpeg 的 `tile` 自动补黑。
69
+ - **正文告诉模型怎么读**:写明「2列×2行,从左上到右下按时间顺序」、原视频分辨率、每格实际尺寸。
70
+ - **帧数仍由用户自定义**,上限 9。配置页会明确写出代价:帧数越多 ffmpeg 越慢,每格画面越小、细节丢得越多。
71
+ - 拼图本身也过图片闸门:帧数多或分辨率高时超限同样会被压缩。
72
+
73
+ ### 配置变更
74
+
75
+ - 新增 `imageMaxMb`(16)、`imageMaxEdge`(4096)、`imageMaxCount`(10)。
76
+ - **删除 `videoFrameMaxEdge`**:单帧尺寸现在由布局自动推导,不再手填。
77
+
78
+ ### 分段发送修正:换行前的句号也要去掉
79
+
80
+ - 早先只有「没有换行、按句号拆」时才删句号;「按换行拆」时,句号落在段内被原样发出,
81
+ 于是微信里看到的是「……重一点。\n下一句」。操作者要的是句号一并去掉,这里补齐。
82
+ - **只剥段尾**:`插件成熟度第一。文档齐全。` 里第一个句号在句子中间,保留;段尾那个去掉,
83
+ 否则句子会粘在一起。
84
+ - ASCII `.` 在段尾无条件剥:它已经在段尾,不可能是小数或域名的一部分。
85
+ - 连续句号(`说完了。。`)、全角句点(`.`)与混排(`..。`)一并清干净。
86
+ - 换行后紧跟句号(`甲\n。\n乙`)不会留下空段。
87
+
88
+ 未发布,等攒够反馈再发。
89
+ ## 0.1.4
90
+
91
+ 新增语义分段发送。
92
+
93
+ - **按语义把一次回复拆成多条微信消息**,一条一条发,像人一句一句说话。
94
+ - **拆分只算一次**:有换行就只按换行拆;没有换行才按句号;再没有才按 `!?…~`。
95
+ 换行与句号同时出现时不会拆两次,也不会多出空段。
96
+ - **删谁不删谁**:换行、`。`、`.` 删掉(微信里带句号显得生硬);`!?!?…~~` 只拆不删,语气留着。
97
+ ASCII `.` 只在后面跟空白或位于结尾时才当句号,`3.14`、`docs.nonebot.dev`、`report.md` 不会被切坏。
98
+ - **间隔可配**:固定间隔或随机区间,单位秒。默认固定 2 秒。
99
+ - **两道上限**:单次最多 12 段(超出并进最后一段)、累计等待最多 30 秒(到点就不再等,
100
+ 但剩下的**照常发完**,不会因为等不起就漏发)。
101
+ - 每段之间会亮一次「正在输入」,让人看着像还在打字。
102
+ - 环境提示词里说明分段规则,让模型知道换行会变成独立消息、句号会被删掉。
103
+
104
+ 默认开启。不想要就在配置页关掉「分段发送」,行为回到 0.1.3。
105
+
3
106
  ## 0.1.3
4
107
 
5
108
  - **正文里的图片尺寸改成真图尺寸。** 之前用的是 `image_item.thumb_width` / `thumb_height`,
package/README.md CHANGED
@@ -20,7 +20,7 @@
20
20
  | 长文本 | 超 4000 字被拒 | 自动切成多条发送,优先在段落与句号处断开 |
21
21
  | 出站视频 | 不支持 | 按 MIME 走视频通道,微信里显示成视频而不是附件 |
22
22
  | 入站超限 | 无区分 | 超限、缺参数、下载失败三种原因分别措辞 |
23
- | 视频 | 占位 | 可选下载(默认关);抽帧可用时附几帧画面,不可用时正文写明没抽帧 |
23
+ | 视频 | 占位 | 可选下载(默认关);抽帧可用时把若干帧拼成一张图附上,不可用时正文写明没抽帧 |
24
24
  | 网络出口 | inherit / direct / proxy | 相同,且把「配置要的出口做不到」如实报出来 |
25
25
  | 令牌失效 | 直接断开并清凭据 | 按官方约定暂停一小时后重试,只有 HTTP 401/403 才判定会话过期 |
26
26
  | 绑定面板 | 有 | 有,走内建 UI 原语,带二维码、扫码状态、验证码输入 |
@@ -74,12 +74,85 @@ corepack pnpm add "<这个包所在的绝对路径>"
74
74
  | `receiveVideos` | `false` | 收视频时下载(体积大,默认关) |
75
75
  | `receiveVoices` | `true` | 收语音时下载 |
76
76
  | `maxInboundMediaMb` | `20` | 单条入站媒体上限,超过只留占位;也是出站媒体的上限 |
77
+ | `inboxDir` | 空 | 收件目录。留空=桌宠工作区下的 `wechat-inbox`;相对路径按工作区解析。改完要重启 |
78
+ | `sendExtraDirs` | 空 | 额外允许发到微信的目录,一行一个(分号、逗号也行)。留空时只有工作区(与收件目录)能发 |
77
79
  | `ffmpegSource` | `auto` | 视频抽帧用哪份 ffmpeg:`auto` 先 PATH 再用面板装的那份、`path` 只用 PATH、`off` 不抽帧 |
78
- | `videoFrames` | `4` | 每条视频抽几帧,0 表示不抽 |
79
- | `videoFrameMaxEdge` | `640` | 每帧最长边像素 |
80
+ | `videoFrames` | `4` | 每条视频抽几帧(上限 9),抽完拼成一张图;0 表示不抽 |
81
+ | `imageMaxMb` | `16` | 单图体积上限,超了先压缩,压不了就不附 |
82
+ | `imageMaxEdge` | `4096` | 单图最长边上限,超了先缩小 |
83
+ | `imageMaxCount` | `10` | 一次事件投递最多附几张图 |
80
84
  | `ffmpegProxyUrl` | 空 | 下载 ffmpeg 用的代理;留空直连(不继承只给模型用的那条代理) |
85
+ | `segmentEnabled` | `true` | 分段发送:一次回复拆成多条微信消息 |
86
+ | `segmentDelayMode` | `fixed` | `fixed` 固定间隔;`random` 在 `segmentDelayMinSec`~`segmentDelayMaxSec` 之间随机 |
87
+ | `segmentDelayFixedSec` | `2` | 固定间隔,秒 |
88
+ | `segmentDelayMinSec` | `1` | 随机间隔下限,秒 |
89
+ | `segmentDelayMaxSec` | `4` | 随机间隔上限,秒 |
90
+ | `segmentMaxParts` | `12` | 单次最多拆几段,超出并进最后一段 |
91
+ | `segmentMaxTotalSec` | `30` | 累计等待上限,到点不再等但剩下的照常发完 |
81
92
 
82
93
  `bot_token`、同步游标和 `context_token` 都在 `<dataDir>/wechat-claw/`,不进配置、不进日志、不进事件 `meta.raw`。
94
+ **它们在工作区外面,所以发不出去**——`wechat_send_image` / `wechat_send_file` 只接受工作区内的路径(见下)。
95
+
96
+ ## 收来的文件落在哪
97
+
98
+ 收到的图片、文件、视频、语音直接落进**桌宠工作区的收件目录**:
99
+
100
+ ```
101
+ <工作区>/wechat-inbox/
102
+ ├── images/ wx-image-20261108-144219.png
103
+ ├── files/ 报告-20261108-144219.pdf ← 原文名在前,时间戳在后
104
+ ├── videos/ wx-video-20261108-144219.mp4
105
+ ├── voices/ wx-voice-20261108-144219.silk
106
+ └── .derived/ 压缩后的图、视频拼图(中间产物)
107
+ ```
108
+
109
+ 工作区是哪个目录,按框架自己的解析顺序猜:`config.json` 的 `paths.memory` 优先,其次探测
110
+ `<部署目录>/workspace`(Coopanion 的 Coo 用这个),再退到 `memory`。`wechat_status` 会如实报出
111
+ 实际用的 `workspace`、`inbox` 和允许发送的目录,`wechat-claw` 的环境提示词里也写着收件目录的绝对路径。
112
+
113
+ 放在这里而不是插件自己的数据目录,是因为**桌宠要伸手去够**:它读得到、改得了、也能原样发回去。
114
+ 文件名保留对方给的原文名,撞名时退到 `-2`、`-3`,从不覆盖已有文件。
115
+
116
+ 工作区如果是一个 Git 仓库(Coopanion 的 Coo 就是),启动时会把 `wechat-inbox/` 追加进工作区的
117
+ `.gitignore`——十几 MB 的视频进版本历史没有意义。**只在 `.gitignore` 已存在时追加**,且幂等。
118
+
119
+ ## 发出去只能取工作区里的文件
120
+
121
+ 这是本扩展的安全边界:`wechat_send_image` 和 `wechat_send_file` 只接受**工作区、收件目录,
122
+ 以及 `sendExtraDirs` 里额外放行的目录**内的路径。
123
+
124
+ 理由很实在:模型能被说服。把本机任意路径交给它,等于把 `auth.json`、`context-tokens.json`、
125
+ 浏览器 cookie 一起交出去。现在这些文件在工作区外面,边界一挡就拿不到了。
126
+
127
+ - 判断前先做 `realpath`,所以 `..` 和符号链接都绕不出去。
128
+ - 拒绝时回执会列出允许的目录和收件目录,模型照着调整路径即可,不需要反复试错。
129
+ - 确实要发工作区以外的素材,把目录写进 `sendExtraDirs`;每加一个,能发出去的东西就多一片。
130
+
131
+ 收来的文件在工作区里,所以「收到 → 改 → 发回」这条路是通的,不需要额外放行任何目录。
132
+
133
+ ## 分段发送
134
+
135
+ 微信里一次吐一大段不像人说话。打开分段发送后,一次回复会拆成几条,一条一条发,条与条之间停顿。
136
+
137
+ **拆分只算一次**,不会拆两次:
138
+
139
+ | 文本里有 | 按什么拆 | 分隔符 |
140
+ |---|---|---|
141
+ | 换行 `\n` | 只按换行 | 删掉 |
142
+ | 没有换行,有句号 `。..` | 只按句号 | 删掉 |
143
+ | 都没有,有 `!?!?…~~` | 只按这些 | **保留** |
144
+ | 都没有 | 整条发 | —— |
145
+
146
+ 换行和句号同时出现时(「三层:\n第一。\n第二。」),按换行拆完就结束,**不会再多拆一次**;
147
+ 但紧挨换行的段尾句号会一并去掉,所以发出去是「第一」「第二」,段内的句号保留。
148
+
149
+ **为什么删句号**:微信里带句号显得生硬,像在写公文,真人不这么打字。`!?…~` 留着,因为那是语气。
150
+
151
+ **ASCII `.` 有额外保护**:只在后面跟空白或位于结尾时才当句号。所以 `3.14`、`docs.nonebot.dev`、`report.2026.11.md` 不会被切坏。
152
+
153
+ **两道上限**:单次最多 `segmentMaxParts` 段,多的并进最后一段;累计等待超过 `segmentMaxTotalSec` 就不再多等,但**剩下的照常发完**(不会因为等不起而漏发)。
154
+
155
+ 不想要就在配置页关掉「分段发送」。
83
156
 
84
157
  ## 视频抽帧
85
158
 
@@ -110,6 +183,53 @@ ffmpeg 的源在 GitHub,和微信域名不是一回事。Coopanion 注进环
110
183
 
111
184
  **没有可用 ffmpeg 时不会假装看过视频**:正文会写明 `[视频帧未抽取:…]`,模型据此不去描述画面。
112
185
 
186
+ ### 拼图而不是散图
187
+
188
+ 抽出的帧会**拼成一张图**,不是发好几张。4 份图片输入变成 1 份,token 省四分之三;模型看到的也是
189
+ 时间相邻的画面,更容易判断「中间发生了什么变化」。
190
+
191
+ 布局按帧数和视频方向自动推导:
192
+
193
+ | 视频方向 | 4 帧 | 6 帧 | 9 帧 |
194
+ |---|---|---|---|
195
+ | 横屏 | 2×2 田字格 | 3×2 | 3×3 |
196
+ | 竖屏 | 4×1 横排 | 6×1 | 9×1 |
197
+
198
+ 正文会写明顺序(例如「2列×2行,从左上到右下按时间顺序」)、原视频分辨率、每格实际尺寸——
199
+ 模型据此知道画面被压到多小、细节还剩多少。
200
+
201
+ **帧数越多代价越大**:ffmpeg 解码与拼接更慢(9 帧明显比 4 帧慢),每格画面也被压得越小、细节丢得越多。
202
+ 4 帧够看清「视频在讲什么」,想追踪连续动作才往上加。上限 9 帧。
203
+
204
+ ## 图片与视频的投递闸门
205
+
206
+ 上游 Provider 对图片有硬限制(DeepSeek:单边 ≤8192、单图 ≤32 MB、连续 ≤15 张)。
207
+ 超过就整条请求被拒,用户看到的是 HTTP 400 和「发送了不支持的图片」。所以这里在交给模型之前先拦一道。
208
+
209
+ 安全线比上游更严:**16 MB / 4096 像素 / 单次 10 张**。
210
+
211
+ | 情况 | 处理 |
212
+ |---|---|
213
+ | 都在范围内 | 原样附上 |
214
+ | 超限且**已装 ffmpeg** | 缩到最长边 4096,再按 JPEG 质量 3→6→9 逐级降质,每级重查体积 |
215
+ | 超限且**没装 ffmpeg** | 不附 |
216
+ | 压不下去 | 不附 |
217
+ | 超出数量额度 | 不附 |
218
+
219
+ **丢弃一定说明原因**,绝不静默吞掉——否则用户会以为消息丢了:
220
+
221
+ ```
222
+ [图片未附:体积 23.4 MB,超过 16 MB 上限]
223
+ [图片未附:尺寸 8192×6144,最长边超过 4096 像素]
224
+ [图片未附:超出本次投递 10 张的上限,这是第 11 张]
225
+ [图片未附:体积 23.4 MB,超过 16 MB 上限,且没有 ffmpeg 可压缩]
226
+ [图片未附:尺寸 6000×4000,最长边超过 4096 像素,压缩后仍超标]
227
+ ```
228
+
229
+ 压成功了也会写:`[图片 尺寸 6000×4000,最长边超过 4096 像素,已压缩为 284 KB]`。
230
+
231
+ 数量额度**一次事件投递里累计**,图片消息和视频拼图一起算。
232
+
113
233
  ## 网络
114
234
 
115
235
  Coopanion 启动 Core 时会把系统代理写进 `HTTP_PROXY`/`HTTPS_PROXY`,那条代理是给模型端点用的。
@@ -125,12 +245,12 @@ Coopanion 启动 Core 时会把系统代理写进 `HTTP_PROXY`/`HTTPS_PROXY`,
125
245
 
126
246
  ## 媒体怎么走
127
247
 
128
- 出站(Coo 发图/发文件):读本地文件 → 申请上传参数(明文大小与 MD5)→ AES-128-ECB 加密 →
129
- POST 密文到微信 CDN → 从响应头 `x-encrypted-param` 取下载参数 → 发一条图片或文件消息。
248
+ 出站(Coo 发图/发文件):**先过路径边界**(只许工作区)→ 读本地文件 → 申请上传参数(明文大小与 MD5)→
249
+ AES-128-ECB 加密 → POST 密文到微信 CDN → 从响应头 `x-encrypted-param` 取下载参数 → 发一条图片或文件消息。
130
250
  说明文字作为独立文本消息先发,与官方发送端一致。
131
251
 
132
252
  入站(对方发图/发文件):用 `media.aes_key`(或图片的 `aeskey` 明文十六进制)解密 →
133
- 落到 `<dataDir>/wechat-claw/inbox/{images,files,videos,voices}/` → 路径写进事件正文 →
253
+ 落到 `<工作区>/wechat-inbox/{images,files,videos,voices}/`(原文名 + 时间戳)→ 路径写进事件正文 →
134
254
  模型接受该 MIME 时字节作为附件随事件到达。
135
255
 
136
256
  正文里的图片尺寸读自落盘文件本身(JPEG 的 SOF 段、PNG 的 IHDR 等)。微信消息里的
@@ -188,6 +308,7 @@ cortico-world-wechat-claw/
188
308
  │ │ └── fetch.ts # undici 与宿主 fetch 的类型适配
189
309
  │ ├── driver.ts # 长轮询、重连退避、令牌失效暂停
190
310
  │ ├── store.ts # 凭据与游标
311
+ │ ├── paths.ts # 工作区 / 收件目录 / 文件名 / 发送边界
191
312
  │ ├── world.ts # 工具、事件、绑定面板
192
313
  │ ├── config.ts # 配置段与文案
193
314
  │ ├── definition.ts # WorldDefinition 与自描述
@@ -199,6 +320,8 @@ cortico-world-wechat-claw/
199
320
  ├── dist/webui.js # 面板产物
200
321
  ├── scripts/build-webui.mjs
201
322
  └── tests/
323
+ ├── paths.test.ts # 工作区探测、文件名清理、发送边界
324
+ └── … # 协议、驱动、出站、入站、分段
202
325
  ```
203
326
 
204
327
  ## 许可
package/describe.json CHANGED
@@ -27,14 +27,14 @@
27
27
  },
28
28
  {
29
29
  "name": "wechat_send_image",
30
- "description": "Send a picture to the person whose inbound message arrived most recently. Takes an absolute local file path; the file is uploaded to the WeChat CDN and delivered as a picture. A path whose content is not an image is delivered as a file instead, and the receipt says so. Optional caption is sent as a separate text message first.",
30
+ "description": "Send a picture to the person whose inbound message arrived most recently. Takes an absolute local file path inside the pet workspace (or the configured inbox); paths outside it are refused, so move a file into the workspace first. The file is uploaded to the WeChat CDN and delivered as a picture. A path whose content is not an image is delivered as a file instead, and the receipt says so. Optional caption is sent as a separate text message first.",
31
31
  "parameters": {
32
32
  "type": "object",
33
33
  "additionalProperties": false,
34
34
  "properties": {
35
35
  "path": {
36
36
  "type": "string",
37
- "description": "Absolute path of a local picture file."
37
+ "description": "Absolute path of a local picture file inside the workspace."
38
38
  },
39
39
  "caption": {
40
40
  "type": "string",
@@ -55,14 +55,14 @@
55
55
  },
56
56
  {
57
57
  "name": "wechat_send_file",
58
- "description": "Send a file attachment to the person whose inbound message arrived most recently. Takes an absolute local file path; the file is uploaded to the WeChat CDN and delivered as a downloadable file. Video files are delivered as videos, not as attachments. Optional caption is sent as a separate text message first.",
58
+ "description": "Send a file attachment to the person whose inbound message arrived most recently. Takes an absolute local file path inside the pet workspace (or the configured inbox); paths outside it are refused, so move a file into the workspace first. The file is uploaded to the WeChat CDN and delivered as a downloadable file. Video files are delivered as videos, not as attachments. Optional caption is sent as a separate text message first.",
59
59
  "parameters": {
60
60
  "type": "object",
61
61
  "additionalProperties": false,
62
62
  "properties": {
63
63
  "path": {
64
64
  "type": "string",
65
- "description": "Absolute path of a local file."
65
+ "description": "Absolute path of a local file inside the workspace."
66
66
  },
67
67
  "caption": {
68
68
  "type": "string",
@@ -154,7 +154,7 @@
154
154
  "key": "worlds.wechat-claw.envPrompt",
155
155
  "title": "微信 ClawBot · 环境提示词",
156
156
  "role": "envPrompt",
157
- "content": "微信 ClawBot 是一条一对一私聊通道,接在微信里,只能回复刚发消息的那个人。\n\n## 手边的状态\n\n{{wechat.state | (微信还没接上。)}}\n{{wechat.account | (还没有绑定的微信号。)}}\n{{wechat.lastMessageAt | (还没有收到过微信消息。)}}\n{{wechat.lastError | (最近没有连接错误。)}}\n\n## 什么时候用\n\n微信里来人说话时,会收到一条 `wechat-claw.message`,正文以 `[微信 时间 发送者]` 开头,媒体路径就写在里面。要回话就用 `wechat_send`;图片用 `wechat_send_image`,其他文件用 `wechat_send_file`,两者都接本机绝对路径。\n\n- 对方发来图片时,图片会作为附件一起到达,路径也写在正文里。看不到附件时,按路径自行读取。\n- 对方发来文件时,路径写在正文里,需要内容就按路径读。\n- 对方发来视频时,视频落盘、路径写在正文里;抽帧可用时按时间顺序附几张画面,正文会写明抽了几帧。正文说「视频帧未抽取」就是真的没看过,不要描述画面内容。\n- 对方发来语音时,正文里带服务端的转写文本;语音本身是 SILK 编码,一般不必再处理。没有转写文本时,你只知道时长,不知道说了什么。\n\n## 约束\n\n这条通道只能回复最近发消息的人,不能主动找人,也不能发到别处。`wechat_send` 的回执会写明发给了谁。\n\n一条文本最多 4000 字,超出的部分会自动接着发成下一条,不必自己切。断行位置优先落在段落和句号上。\n\n对方的 `context_token` 会过期。回复被拒并提示没有可用 token 时,等对方再说一句再回,不要反复重试。\n\n这里发出的一切都会真的进到对方的微信里。不确定要不要发的时候,先问清楚。\n"
157
+ "content": "微信 ClawBot 是一条一对一私聊通道,接在微信里,只能回复刚发消息的那个人。\n\n## 手边的状态\n\n{{wechat.state | (微信还没接上。)}}\n{{wechat.account | (还没有绑定的微信号。)}}\n{{wechat.lastMessageAt | (还没有收到过微信消息。)}}\n{{wechat.lastError | (最近没有连接错误。)}}\n\n## 收到的东西在哪\n\n对方发来的图片、文件、视频、语音都落在你的工作区里:\n\n```\n{{wechat.inbox | (收件目录还没解析出来。)}}\n```\n\n它下面按类型分成 `images/`、`files/`、`videos/`、`voices/`,文件名保留对方给的原文名,后面接一个本地时间戳。\n这些文件就是普通文件——**读得到、改得了、也发得回去**。想让对方看到改过之后的版本,改完直接\n用 `wechat_send_file` 发那个路径就行。\n\n## 什么时候用\n\n微信里来人说话时,会收到一条 `wechat-claw.message`,正文以 `[微信 时间 发送者]` 开头,媒体路径就写在里面。要回话就用 `wechat_send`;图片用 `wechat_send_image`,其他文件用 `wechat_send_file`,两者都接本机绝对路径。\n\n- 对方发来图片时,图片会作为附件一起到达,路径也写在正文里。看不到附件时,按路径自行读取。\n 正文说「图片未附:体积…/尺寸…/超出数量上限」时,那张图是真的没交给你,**不要猜图里有什么**。\n- 对方发来文件时,路径写在正文里,需要内容就按路径读。\n- 对方发来视频时,视频落盘、路径写在正文里;抽帧可用时会把几帧**拼成一张图**附上,\n 正文写明布局(如「2列×2行,从左上到右下按时间顺序」)、原视频分辨率与每格尺寸。\n 按这个顺序理解画面;每格都很小,别去描述看不清的细节。正文说「视频帧未抽取」就是真的没看过。\n- 对方发来语音时,正文里带服务端的转写文本;语音本身是 SILK 编码,一般不必再处理。没有转写文本时,你只知道时长,不知道说了什么。\n\n## 能发什么\n\n只有你工作区里的文件能发到微信:\n\n```\n{{wechat.workspace | (工作区路径还没解析出来。)}}\n```\n\n收件目录在工作区里,所以收来的东西发得回去。工作区外面的路径会被直接拒绝——这不是故障,是边界:\n你的配置、密钥和这台机器的其他文件不在工作区的管辖范围内,不该被随手上传出去。\n\n要把工作区外的东西发出去,先把它复制进工作区(例如收件目录),再发复制之后那份。\n被拒绝时回执会列出允许的目录,照着调整路径就行,不要换个写法绕过它。\n\n## 约束\n\n这条通道只能回复最近发消息的人,不能主动找人,也不能发到别处。`wechat_send` 的回执会写明发给了谁。\n\n一条文本最多 4000 字,超出的部分会自动接着发成下一条,不必自己切。断行位置优先落在段落和句号上。\n\n## 分段发送\n\n这一段决定你说话的样子,值得花心思。\n\n打开分段发送时,你写的东西会被拆成好几条微信消息,一条一条发出去,条与条之间会停顿,让对方看着像你还在打字。\n\n拆的顺序按一次算,不会拆两次:\n\n- 你写了换行,就只按换行拆;换行会消失,段内不再按标点拆。紧挨换行的段尾句号也会被去掉,段内的句号留着。\n- 没写换行但有句号,就只按句号拆,句号会消失。\n- 都没写,但有 `!?…~`,就按它们拆;它们留着,因为你靠它们表达语气。\n- 都没有,就整条发出去。\n\n所以换行是你的节奏工具:**想让对方连看几行、想顿一下再说下一句,就写换行**。反过来,一句话里硬写换行会被拆成好几个气泡,看着像结巴。\n\n中文句号会被删掉,因为在微信里带句号显得生硬、像在写公文。这就是聊天里很少见句号的原因。别为了排版写句号。\n\n分段与间隔都是对方在配置页设的,你看不到也不必猜;照平时的习惯说话就行。\n\n对方的 `context_token` 会过期。回复被拒并提示没有可用 token 时,等对方再说一句再回,不要反复重试。\n\n这里发出的一切都会真的进到对方的微信里。不确定要不要发的时候,先问清楚。\n"
158
158
  }
159
159
  ]
160
160
  }
package/dist/webui.js CHANGED
@@ -1,4 +1,4 @@
1
- // ../../extensions/cortico-world-wechat-claw/src/webui/ffmpeg.ts
1
+ // src/webui/ffmpeg.ts
2
2
  var TEXT = {
3
3
  zh: {
4
4
  sheet: "ffmpeg",
@@ -160,7 +160,7 @@ async function mountFfmpeg(ctx) {
160
160
  await readState();
161
161
  }
162
162
 
163
- // ../../extensions/cortico-world-wechat-claw/src/webui/client.ts
163
+ // src/webui/client.ts
164
164
  var TEXT2 = {
165
165
  zh: {
166
166
  sheet: "\u5FAE\u4FE1\u7ED1\u5B9A",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cortico-world-wechat-claw",
3
- "version": "0.1.3",
3
+ "version": "0.1.6",
4
4
  "type": "module",
5
5
  "description": "在微信里和桌宠一对一聊天:文字、图片、文件双向收发,语音用微信的转写文本,视频可按需抽帧给模型看。",
6
6
  "author": {
package/src/ENV_PROMPT.md CHANGED
@@ -7,21 +7,69 @@
7
7
  {{wechat.lastMessageAt | (还没有收到过微信消息。)}}
8
8
  {{wechat.lastError | (最近没有连接错误。)}}
9
9
 
10
+ ## 收到的东西在哪
11
+
12
+ 对方发来的图片、文件、视频、语音都落在你的工作区里:
13
+
14
+ ```
15
+ {{wechat.inbox | (收件目录还没解析出来。)}}
16
+ ```
17
+
18
+ 它下面按类型分成 `images/`、`files/`、`videos/`、`voices/`,文件名保留对方给的原文名,后面接一个本地时间戳。
19
+ 这些文件就是普通文件——**读得到、改得了、也发得回去**。想让对方看到改过之后的版本,改完直接
20
+ 用 `wechat_send_file` 发那个路径就行。
21
+
10
22
  ## 什么时候用
11
23
 
12
24
  微信里来人说话时,会收到一条 `wechat-claw.message`,正文以 `[微信 时间 发送者]` 开头,媒体路径就写在里面。要回话就用 `wechat_send`;图片用 `wechat_send_image`,其他文件用 `wechat_send_file`,两者都接本机绝对路径。
13
25
 
14
26
  - 对方发来图片时,图片会作为附件一起到达,路径也写在正文里。看不到附件时,按路径自行读取。
27
+ 正文说「图片未附:体积…/尺寸…/超出数量上限」时,那张图是真的没交给你,**不要猜图里有什么**。
15
28
  - 对方发来文件时,路径写在正文里,需要内容就按路径读。
16
- - 对方发来视频时,视频落盘、路径写在正文里;抽帧可用时按时间顺序附几张画面,正文会写明抽了几帧。正文说「视频帧未抽取」就是真的没看过,不要描述画面内容。
29
+ - 对方发来视频时,视频落盘、路径写在正文里;抽帧可用时会把几帧**拼成一张图**附上,
30
+ 正文写明布局(如「2列×2行,从左上到右下按时间顺序」)、原视频分辨率与每格尺寸。
31
+ 按这个顺序理解画面;每格都很小,别去描述看不清的细节。正文说「视频帧未抽取」就是真的没看过。
17
32
  - 对方发来语音时,正文里带服务端的转写文本;语音本身是 SILK 编码,一般不必再处理。没有转写文本时,你只知道时长,不知道说了什么。
18
33
 
34
+ ## 能发什么
35
+
36
+ 只有你工作区里的文件能发到微信:
37
+
38
+ ```
39
+ {{wechat.workspace | (工作区路径还没解析出来。)}}
40
+ ```
41
+
42
+ 收件目录在工作区里,所以收来的东西发得回去。工作区外面的路径会被直接拒绝——这不是故障,是边界:
43
+ 你的配置、密钥和这台机器的其他文件不在工作区的管辖范围内,不该被随手上传出去。
44
+
45
+ 要把工作区外的东西发出去,先把它复制进工作区(例如收件目录),再发复制之后那份。
46
+ 被拒绝时回执会列出允许的目录,照着调整路径就行,不要换个写法绕过它。
47
+
19
48
  ## 约束
20
49
 
21
50
  这条通道只能回复最近发消息的人,不能主动找人,也不能发到别处。`wechat_send` 的回执会写明发给了谁。
22
51
 
23
52
  一条文本最多 4000 字,超出的部分会自动接着发成下一条,不必自己切。断行位置优先落在段落和句号上。
24
53
 
54
+ ## 分段发送
55
+
56
+ 这一段决定你说话的样子,值得花心思。
57
+
58
+ 打开分段发送时,你写的东西会被拆成好几条微信消息,一条一条发出去,条与条之间会停顿,让对方看着像你还在打字。
59
+
60
+ 拆的顺序按一次算,不会拆两次:
61
+
62
+ - 你写了换行,就只按换行拆;换行会消失,段内不再按标点拆。紧挨换行的段尾句号也会被去掉,段内的句号留着。
63
+ - 没写换行但有句号,就只按句号拆,句号会消失。
64
+ - 都没写,但有 `!?…~`,就按它们拆;它们留着,因为你靠它们表达语气。
65
+ - 都没有,就整条发出去。
66
+
67
+ 所以换行是你的节奏工具:**想让对方连看几行、想顿一下再说下一句,就写换行**。反过来,一句话里硬写换行会被拆成好几个气泡,看着像结巴。
68
+
69
+ 中文句号会被删掉,因为在微信里带句号显得生硬、像在写公文。这就是聊天里很少见句号的原因。别为了排版写句号。
70
+
71
+ 分段与间隔都是对方在配置页设的,你看不到也不必猜;照平时的习惯说话就行。
72
+
25
73
  对方的 `context_token` 会过期。回复被拒并提示没有可用 token 时,等对方再说一句再回,不要反复重试。
26
74
 
27
75
  这里发出的一切都会真的进到对方的微信里。不确定要不要发的时候,先问清楚。