cortico-world-wechat-claw 0.1.4 → 0.1.7
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 +95 -0
- package/README.md +153 -25
- package/describe.json +7 -7
- package/package.json +4 -4
- package/src/ENV_PROMPT.md +36 -4
- package/src/config.ts +94 -49
- package/src/definition.ts +4 -2
- package/src/driver.ts +3 -2
- package/src/media/frames.ts +107 -76
- package/src/media/imagefit.ts +263 -0
- package/src/media/layout.ts +107 -0
- package/src/paths.ts +241 -0
- package/src/protocol/inbound.ts +51 -30
- package/src/protocol/mime.ts +13 -0
- package/src/segment.ts +32 -49
- package/src/store.ts +11 -0
- package/src/text.ts +3 -3
- package/src/world.ts +301 -108
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,100 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.1.7
|
|
4
|
+
|
|
5
|
+
- 语义段数达到阈值时取消分段,恢复完整原文;超 4000 字仍分条,避免合并后的尾段超限而发送失败。
|
|
6
|
+
- 固定与随机间隔改为「聊天节奏」:按字数决定停顿,短句和特长段立即发送。旧间隔配置不再使用,新节奏默认 1。
|
|
7
|
+
- 按 Provider 声明的实际 MIME 支持投递图片、音乐、语音、视频和文档,文件通道内的媒体也能附上。语音按实际编码保存。
|
|
8
|
+
- 原生视频优先;Provider 不接受视频时继续抽帧。附件未提供的具体原因写进事件正文。
|
|
9
|
+
- 最近消息时间按部署时区显示为 `MM/DD HH:mm`,重启后恢复,解绑时清除。
|
|
10
|
+
- `wechat_status` 和入站日志增加收取延迟、批内排队与本地处理耗时。收信仍参与 Core 的 debounce 合批。
|
|
11
|
+
|
|
12
|
+
## 0.1.6
|
|
13
|
+
|
|
14
|
+
收来的文件从「插件自己的数据目录」搬进**桌宠工作区**,并把「能发什么」收紧到工作区,
|
|
15
|
+
从而关掉「模型可以把本机任意文件发到微信」这个口子。两件事其实是同一件事:文件放在桌宠
|
|
16
|
+
够得到的地方,边界才能划在「工作区」而不是「整台机器」。
|
|
17
|
+
|
|
18
|
+
### 收件目录搬进工作区
|
|
19
|
+
|
|
20
|
+
- 入站媒体落在 `<工作区>/wechat-inbox/{images,files,videos,voices}/`,不再堆在
|
|
21
|
+
`<dataDir>/wechat-claw/inbox/`。桌宠读得到、改得了、也能发回去。
|
|
22
|
+
- **文件名保留对方给的原文名**,后面接本地时间戳(`报告-20261108-144219.pdf`),撞名退到
|
|
23
|
+
`-2`、`-3`,写入用 `wx` 独占标志,从不覆盖已有文件。文件名先过 `safeFileName`:去掉目录部分
|
|
24
|
+
(挡 `..` 与 `C:`)、Windows 禁止的符号、控制字符与保留名(`CON`/`NUL`/`COM1`…)。
|
|
25
|
+
- 压缩后的图与视频拼图放进 `<收件目录>/.derived/`,不与原件混在一起。
|
|
26
|
+
- 工作区是 Git 仓库时(Coopanion 的 Coo 就是,每次写文件 `git add -A`),启动时把收件目录
|
|
27
|
+
追加进工作区的 `.gitignore`——十几 MB 的视频不该进版本历史。**只在 `.gitignore` 已存在时追加**,幂等。
|
|
28
|
+
- 工作区怎么认:`WorldContext` 不给 `memoryDir`,所以按框架自己的顺序还原——`config.json` 的
|
|
29
|
+
`paths.memory` 优先,其次探测 `<部署目录>/workspace`(Coo 的约定),再退到 `memory`。
|
|
30
|
+
|
|
31
|
+
### 发送边界:只许工作区里的文件
|
|
32
|
+
|
|
33
|
+
- `wechat_send_image` / `wechat_send_file` 只接受**工作区、收件目录,以及 `sendExtraDirs` 里额外
|
|
34
|
+
放行的目录**内的路径。原来的实现接受任意绝对路径——模型一旦被说服,就能把 `auth.json`、
|
|
35
|
+
`context-tokens.json`、浏览器 cookie 一起上传到微信 CDN。
|
|
36
|
+
- 判断前做 `realpath`:`..` 和符号链接都绕不出去;检查返回的规范化路径直接用于后续 `stat`/`readFile`,
|
|
37
|
+
不给「检查后被换掉」留窗口。
|
|
38
|
+
- 拒绝时的回执列出允许的目录和收件目录,让模型改路径而不是反复试错。
|
|
39
|
+
- 顺带把凭据目录隔离坐实:它们在工作区之外,因此现在拿不到也发不走。
|
|
40
|
+
|
|
41
|
+
### 配置变更
|
|
42
|
+
|
|
43
|
+
- 新增 `inboxDir`(默认空=`<工作区>/wechat-inbox`,改完需重启)。
|
|
44
|
+
- 新增 `sendExtraDirs`(默认空=只有工作区能发;热生效)。
|
|
45
|
+
- 配置组的「⚠ 安全提示:启用后模型能把本机任意文件发到微信」换成对边界的说明。
|
|
46
|
+
- `wechat_status` 多了 `workspace`、`inbox`、`sendRoots` 三项;环境提示词新增
|
|
47
|
+
`{{wechat.inbox}}` 与 `{{wechat.workspace}}`,并写清「只能发工作区里的文件」。
|
|
48
|
+
|
|
49
|
+
### 升级注意
|
|
50
|
+
|
|
51
|
+
旧版本收下的媒体留在 `<dataDir>/wechat-claw/inbox/` 原处,不自动搬迁——那些文件桌宠依然读不到,
|
|
52
|
+
需要的话手动复制进工作区的 `wechat-inbox/`。
|
|
53
|
+
|
|
54
|
+
## 0.1.5
|
|
55
|
+
|
|
56
|
+
修两件事:图片/视频投递超限导致上游报错,以及分段发送时换行前的句号没被去掉。
|
|
57
|
+
|
|
58
|
+
### 修复「超长或超大图片被直接发给 Provider,导致上游报 HTTP 400」
|
|
59
|
+
|
|
60
|
+
- **新增图片闸门**:交给模型之前先查体积、最长边、数量。默认 16 MB / 4096 像素 / 单次 10 张,
|
|
61
|
+
都比上游的硬限制(32 MB / 8192 / 15 张)更保守,留出余量。
|
|
62
|
+
- **超限先压缩**:装了 ffmpeg 时先缩到最长边 4096,再按 JPEG 质量 3→6→9 逐级降质,
|
|
63
|
+
每一级都重新查体积。
|
|
64
|
+
- **没装 ffmpeg 就过滤**:只判断不处理,超限的图不附。
|
|
65
|
+
- **丢弃必说明原因**:`[图片未附:体积 23.4 MB,超过 16 MB 上限]`、
|
|
66
|
+
`[图片未附:尺寸 8192×6144,最长边超过 4096 像素]`、`[图片未附:超出 10 张上限,这是第 11 张]`。
|
|
67
|
+
绝不静默吞掉,免得用户以为消息丢了。
|
|
68
|
+
- **压不下去也说清楚**:`[图片未附:…,压缩后仍超标]`、`[图片未附:…,且没有 ffmpeg 可压缩]`。
|
|
69
|
+
- **先看元数据再读内容**:体积从文件系统拿、尺寸只读文件头,32 MB 的图不会先整读进内存。
|
|
70
|
+
- **顺手修掉一个误判**:损坏的 PNG 会让尺寸解析读出天文数字(实测 17 亿像素),
|
|
71
|
+
一张 26 字节的小图会被当成超长图丢掉。现在对读出的尺寸做合理性检查。
|
|
72
|
+
|
|
73
|
+
### 视频抽帧改成拼图
|
|
74
|
+
|
|
75
|
+
- **一次视频只产出一张图**,不再是 4 张散图。4 份图片输入变成 1 份,token 省四分之三。
|
|
76
|
+
- **布局跟着帧数和方向走**:竖屏横排(4 帧 4×1、9 帧 9×1),横屏网格(4 帧 2×2、6 帧 3×2、
|
|
77
|
+
9 帧 3×3)。空格由 ffmpeg 的 `tile` 自动补黑。
|
|
78
|
+
- **正文告诉模型怎么读**:写明「2列×2行,从左上到右下按时间顺序」、原视频分辨率、每格实际尺寸。
|
|
79
|
+
- **帧数仍由用户自定义**,上限 9。配置页会明确写出代价:帧数越多 ffmpeg 越慢,每格画面越小、细节丢得越多。
|
|
80
|
+
- 拼图本身也过图片闸门:帧数多或分辨率高时超限同样会被压缩。
|
|
81
|
+
|
|
82
|
+
### 配置变更
|
|
83
|
+
|
|
84
|
+
- 新增 `imageMaxMb`(16)、`imageMaxEdge`(4096)、`imageMaxCount`(10)。
|
|
85
|
+
- **删除 `videoFrameMaxEdge`**:单帧尺寸现在由布局自动推导,不再手填。
|
|
86
|
+
|
|
87
|
+
### 分段发送修正:换行前的句号也要去掉
|
|
88
|
+
|
|
89
|
+
- 早先只有「没有换行、按句号拆」时才删句号;「按换行拆」时,句号落在段内被原样发出,
|
|
90
|
+
于是微信里看到的是「……重一点。\n下一句」。操作者要的是句号一并去掉,这里补齐。
|
|
91
|
+
- **只剥段尾**:`插件成熟度第一。文档齐全。` 里第一个句号在句子中间,保留;段尾那个去掉,
|
|
92
|
+
否则句子会粘在一起。
|
|
93
|
+
- ASCII `.` 在段尾无条件剥:它已经在段尾,不可能是小数或域名的一部分。
|
|
94
|
+
- 连续句号(`说完了。。`)、全角句点(`.`)与混排(`..。`)一并清干净。
|
|
95
|
+
- 换行后紧跟句号(`甲\n。\n乙`)不会留下空段。
|
|
96
|
+
|
|
97
|
+
未发布,等攒够反馈再发。
|
|
3
98
|
## 0.1.4
|
|
4
99
|
|
|
5
100
|
新增语义分段发送。
|
package/README.md
CHANGED
|
@@ -3,6 +3,10 @@
|
|
|
3
3
|
|
|
4
4
|
通过微信 ClawBot(iLink)和 Coopanion 桌宠一对一聊天。**文字、图片、文件双向收发。**
|
|
5
5
|
|
|
6
|
+
文件这条路是这么走的:微信里发来的东西**落在桌宠自己的工作区里**(`wechat-inbox/`),所以它读得到、
|
|
7
|
+
改得了、也能改完再发回去;反过来,**能发到微信的只有工作区里的文件**——工作区外面(凭据、系统目录、
|
|
8
|
+
浏览器数据)不在范围里,模型再被说服也上传不出去。
|
|
9
|
+
|
|
6
10
|
这是独立开发的实现,不复用 `cortico-world-clawbot` 的代码。协议形状对齐腾讯官方
|
|
7
11
|
[`@tencent-weixin/openclaw-weixin`](https://www.npmjs.com/package/@tencent-weixin/openclaw-weixin)
|
|
8
12
|
2.4.10 与它的[后端协议文档](https://github.com/Tencent/openclaw-weixin/blob/main/docs/protocol_zh_CN.md)。
|
|
@@ -12,15 +16,16 @@
|
|
|
12
16
|
| | 现成 `cortico-world-clawbot` 0.1.0 | 这个扩展 |
|
|
13
17
|
|---|---|---|
|
|
14
18
|
| 文本收发 | 支持 | 支持 |
|
|
15
|
-
| 收图片 | 只显示 `[图片]` 占位 |
|
|
16
|
-
| 发图片 | 不支持 | `wechat_send_image`:加密上传到微信 CDN
|
|
17
|
-
| 收文件 | 只显示 `[文件 名字]` 占位 |
|
|
18
|
-
| 发文件 | 不支持 | `wechat_send_file
|
|
19
|
-
|
|
|
19
|
+
| 收图片 | 只显示 `[图片]` 占位 | 解密落到桌宠工作区的 `wechat-inbox/images/`,路径进上下文,模型支持图片时作为附件到达 |
|
|
20
|
+
| 发图片 | 不支持 | `wechat_send_image`:加密上传到微信 CDN 再发;**路径必须在工作区内** |
|
|
21
|
+
| 收文件 | 只显示 `[文件 名字]` 占位 | 解密落到 `wechat-inbox/files/`,保留对方给的原文名;她读得到、改得了,也能原样发回去 |
|
|
22
|
+
| 发文件 | 不支持 | `wechat_send_file`:同上,带原文件名与明文长度;同样只限工作区 |
|
|
23
|
+
| 上传来源 | —— | 只限工作区+收件目录+`sendExtraDirs`;先 `realpath` 再判定,`..` 与符号链接都绕不出去 |
|
|
24
|
+
| 语音 | 占位 | 保留服务端转写文本;原音频落到 `wechat-inbox/voices/`,Provider 支持实际编码时同时附上 |
|
|
20
25
|
| 长文本 | 超 4000 字被拒 | 自动切成多条发送,优先在段落与句号处断开 |
|
|
21
26
|
| 出站视频 | 不支持 | 按 MIME 走视频通道,微信里显示成视频而不是附件 |
|
|
22
27
|
| 入站超限 | 无区分 | 超限、缺参数、下载失败三种原因分别措辞 |
|
|
23
|
-
| 视频 | 占位 |
|
|
28
|
+
| 视频 | 占位 | 可选下载(默认关);Provider 接受时直接附视频,否则按原逻辑抽帧拼图,失败写明原因 |
|
|
24
29
|
| 网络出口 | inherit / direct / proxy | 相同,且把「配置要的出口做不到」如实报出来 |
|
|
25
30
|
| 令牌失效 | 直接断开并清凭据 | 按官方约定暂停一小时后重试,只有 HTTP 401/403 才判定会话过期 |
|
|
26
31
|
| 绑定面板 | 有 | 有,走内建 UI 原语,带二维码、扫码状态、验证码输入 |
|
|
@@ -30,14 +35,14 @@
|
|
|
30
35
|
| 工具 | 作用 |
|
|
31
36
|
|---|---|
|
|
32
37
|
| `wechat_send` | 回复最近一条微信消息;只能发给刚发消息的人,单条上限 4000 字 |
|
|
33
|
-
| `wechat_send_image` |
|
|
34
|
-
| `wechat_send_file` |
|
|
35
|
-
| `wechat_status` |
|
|
38
|
+
| `wechat_send_image` | 把工作区里的一张图发到微信,可带一句说明;工作区外的路径直接拒绝 |
|
|
39
|
+
| `wechat_send_file` | 把工作区里的一个文件发到微信,可带一句说明;同样只限工作区 |
|
|
40
|
+
| `wechat_status` | 连接、账号、最近消息、错误、持有多少条会话令牌,以及工作区/收件目录/允许发送的目录 |
|
|
36
41
|
| `wechat_events` | 按类型和时间查已归档的微信事件 |
|
|
37
42
|
|
|
38
43
|
| 事件 | 作用 |
|
|
39
44
|
|---|---|
|
|
40
|
-
| `wechat-claw.message` |
|
|
45
|
+
| `wechat-claw.message` | 一条微信私聊消息;媒体路径在正文里,Provider 支持的媒体与文档作为附件随事件到达 |
|
|
41
46
|
| `wechat-claw.link` | 绑定成功或会话过期 |
|
|
42
47
|
|
|
43
48
|
## 安装
|
|
@@ -46,9 +51,11 @@
|
|
|
46
51
|
|
|
47
52
|
```bash
|
|
48
53
|
cd %APPDATA%\Coopanion\extensions
|
|
49
|
-
corepack pnpm add "
|
|
54
|
+
corepack pnpm add "<本地包目录,绝对路径,例如 E:\WorkShop\...\cortico-world-wechat-claw>"
|
|
50
55
|
```
|
|
51
56
|
|
|
57
|
+
这条说的是**安装本地包**要填包所在目录的绝对路径,与「发出去的文件路径」无关。
|
|
58
|
+
|
|
52
59
|
装好不等于启用:配置段默认 `enabled: false`,要去 World 总览激活。
|
|
53
60
|
|
|
54
61
|
## 绑定
|
|
@@ -74,19 +81,58 @@ corepack pnpm add "<这个包所在的绝对路径>"
|
|
|
74
81
|
| `receiveVideos` | `false` | 收视频时下载(体积大,默认关) |
|
|
75
82
|
| `receiveVoices` | `true` | 收语音时下载 |
|
|
76
83
|
| `maxInboundMediaMb` | `20` | 单条入站媒体上限,超过只留占位;也是出站媒体的上限 |
|
|
84
|
+
| `inboxDir` | 空 | 收件目录。留空=桌宠工作区下的 `wechat-inbox`;相对路径按工作区解析。改完要重启 |
|
|
85
|
+
| `sendExtraDirs` | 空 | 额外允许发到微信的目录,一行一个(分号、逗号也行)。留空时只有工作区(与收件目录)能发 |
|
|
77
86
|
| `ffmpegSource` | `auto` | 视频抽帧用哪份 ffmpeg:`auto` 先 PATH 再用面板装的那份、`path` 只用 PATH、`off` 不抽帧 |
|
|
78
|
-
| `videoFrames` | `4` |
|
|
79
|
-
| `
|
|
87
|
+
| `videoFrames` | `4` | 每条视频抽几帧(上限 9),抽完拼成一张图;0 表示不抽 |
|
|
88
|
+
| `imageMaxMb` | `16` | 单图体积上限,超了先压缩,压不了就不附 |
|
|
89
|
+
| `imageMaxEdge` | `4096` | 单图最长边上限,超了先缩小 |
|
|
90
|
+
| `imageMaxCount` | `10` | 一次事件投递最多附几张图 |
|
|
80
91
|
| `ffmpegProxyUrl` | 空 | 下载 ffmpeg 用的代理;留空直连(不继承只给模型用的那条代理) |
|
|
81
92
|
| `segmentEnabled` | `true` | 分段发送:一次回复拆成多条微信消息 |
|
|
82
|
-
| `
|
|
83
|
-
| `
|
|
84
|
-
| `segmentDelayMinSec` | `1` | 随机间隔下限,秒 |
|
|
85
|
-
| `segmentDelayMaxSec` | `4` | 随机间隔上限,秒 |
|
|
86
|
-
| `segmentMaxParts` | `12` | 单次最多拆几段,超出并进最后一段 |
|
|
93
|
+
| `segmentPace` | `1` | 聊天节奏,0~10;越大停顿越久,0 不等待 |
|
|
94
|
+
| `segmentMaxParts` | `12` | 语义段数达到此阈值就恢复完整原文,仅按 4000 字上限分条;0 不限 |
|
|
87
95
|
| `segmentMaxTotalSec` | `30` | 累计等待上限,到点不再等但剩下的照常发完 |
|
|
88
96
|
|
|
89
97
|
`bot_token`、同步游标和 `context_token` 都在 `<dataDir>/wechat-claw/`,不进配置、不进日志、不进事件 `meta.raw`。
|
|
98
|
+
**它们在工作区外面,所以发不出去**——`wechat_send_image` / `wechat_send_file` 只接受工作区内的路径(见下)。
|
|
99
|
+
|
|
100
|
+
## 收来的文件落在哪
|
|
101
|
+
|
|
102
|
+
收到的图片、文件、视频、语音直接落进**桌宠工作区的收件目录**:
|
|
103
|
+
|
|
104
|
+
```
|
|
105
|
+
<工作区>/wechat-inbox/
|
|
106
|
+
├── images/ wx-image-20261108-144219.png
|
|
107
|
+
├── files/ 报告-20261108-144219.pdf ← 原文名在前,时间戳在后
|
|
108
|
+
├── videos/ wx-video-20261108-144219.mp4
|
|
109
|
+
├── voices/ wx-voice-20261108-144219.silk
|
|
110
|
+
└── .derived/ 压缩后的图、视频拼图(中间产物)
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
工作区是哪个目录,按框架自己的解析顺序猜:`config.json` 的 `paths.memory` 优先,其次探测
|
|
114
|
+
`<部署目录>/workspace`(Coopanion 的 Coo 用这个),再退到 `memory`。`wechat_status` 会如实报出
|
|
115
|
+
实际用的 `workspace`、`inbox` 和允许发送的目录,`wechat-claw` 的环境提示词里也写着收件目录的绝对路径。
|
|
116
|
+
|
|
117
|
+
放在这里而不是插件自己的数据目录,是因为**桌宠要伸手去够**:它读得到、改得了、也能原样发回去。
|
|
118
|
+
文件名保留对方给的原文名,撞名时退到 `-2`、`-3`,从不覆盖已有文件。
|
|
119
|
+
|
|
120
|
+
工作区如果是一个 Git 仓库(Coopanion 的 Coo 就是),启动时会把 `wechat-inbox/` 追加进工作区的
|
|
121
|
+
`.gitignore`——十几 MB 的视频进版本历史没有意义。**只在 `.gitignore` 已存在时追加**,且幂等。
|
|
122
|
+
|
|
123
|
+
## 发出去只能取工作区里的文件
|
|
124
|
+
|
|
125
|
+
这是本扩展的安全边界:`wechat_send_image` 和 `wechat_send_file` 只接受**工作区、收件目录,
|
|
126
|
+
以及 `sendExtraDirs` 里额外放行的目录**内的路径。
|
|
127
|
+
|
|
128
|
+
理由很实在:模型能被说服。原来把本机任意路径交给它,等于把 `auth.json`、`context-tokens.json`、
|
|
129
|
+
浏览器 cookie 一起交出去。现在这些文件在工作区外面,边界一挡就拿不到了。
|
|
130
|
+
|
|
131
|
+
- 判断前先做 `realpath`,所以 `..` 和符号链接都绕不出去。
|
|
132
|
+
- 拒绝时回执会列出允许的目录和收件目录,模型照着调整路径即可,不需要反复试错。
|
|
133
|
+
- 确实要发工作区以外的素材,把目录写进 `sendExtraDirs`;每加一个,能发出去的东西就多一片。
|
|
134
|
+
|
|
135
|
+
收来的文件在工作区里,所以「收到 → 改 → 发回」这条路是通的,不需要额外放行任何目录。
|
|
90
136
|
|
|
91
137
|
## 分段发送
|
|
92
138
|
|
|
@@ -101,18 +147,32 @@ corepack pnpm add "<这个包所在的绝对路径>"
|
|
|
101
147
|
| 都没有,有 `!?!?…~~` | 只按这些 | **保留** |
|
|
102
148
|
| 都没有 | 整条发 | —— |
|
|
103
149
|
|
|
104
|
-
换行和句号同时出现时(「三层:\n第一。\n
|
|
150
|
+
换行和句号同时出现时(「三层:\n第一。\n第二。」),按换行拆完就结束,**不会再多拆一次**;
|
|
151
|
+
但紧挨换行的段尾句号会一并去掉,所以发出去是「第一」「第二」,段内的句号保留。
|
|
105
152
|
|
|
106
153
|
**为什么删句号**:微信里带句号显得生硬,像在写公文,真人不这么打字。`!?…~` 留着,因为那是语气。
|
|
107
154
|
|
|
108
155
|
**ASCII `.` 有额外保护**:只在后面跟空白或位于结尾时才当句号。所以 `3.14`、`docs.nonebot.dev`、`report.2026.11.md` 不会被切坏。
|
|
109
156
|
|
|
110
|
-
|
|
157
|
+
语义段数**达到** `segmentMaxParts` 时取消语义分段,保留原文的换行和标点直接发送。原文超过微信单条 4000 字时仍按长度分条,每条均不超限。累计等待超过 `segmentMaxTotalSec` 后不再等待,其余消息照常发完。
|
|
158
|
+
|
|
159
|
+
「聊天节奏」控制每条消息发送前的停顿,默认 1:
|
|
160
|
+
|
|
161
|
+
| 每个语义段的字数 | 停顿 |
|
|
162
|
+
|---|---|
|
|
163
|
+
| 0~20 | 立即发送 |
|
|
164
|
+
| 21~80 | 0.6 秒 × 聊天节奏 |
|
|
165
|
+
| 81~300 | 1.4 秒 × 聊天节奏 |
|
|
166
|
+
| 超过 300 | 视作未能断句,立即发送,包括按 4000 字拆出的各条 |
|
|
167
|
+
|
|
168
|
+
达到分段阈值或关闭分段时不等待。旧的 `segmentDelayMode`、`segmentDelayFixedSec`、`segmentDelayMinSec`、`segmentDelayMaxSec` 不再使用,已有配置可删除;没有 `segmentPace` 时使用默认值 1。
|
|
111
169
|
|
|
112
170
|
不想要就在配置页关掉「分段发送」。
|
|
113
171
|
|
|
114
172
|
## 视频抽帧
|
|
115
173
|
|
|
174
|
+
当前 Provider 接受视频的实际 MIME 时,直接将视频作为事件附件交给 Core,不抽帧,也不需要 ffmpeg。只有 Provider 不接受视频时才走下面的抽帧流程。微信文件通道收到的 `.mp4`、`.mov` 等视频同样处理。
|
|
175
|
+
|
|
116
176
|
视频抽帧要 ffmpeg,但扩展不把它打进包里,**也绝不悄悄下载**。
|
|
117
177
|
|
|
118
178
|
### 装 ffmpeg
|
|
@@ -140,6 +200,53 @@ ffmpeg 的源在 GitHub,和微信域名不是一回事。Coopanion 注进环
|
|
|
140
200
|
|
|
141
201
|
**没有可用 ffmpeg 时不会假装看过视频**:正文会写明 `[视频帧未抽取:…]`,模型据此不去描述画面。
|
|
142
202
|
|
|
203
|
+
### 拼图而不是散图
|
|
204
|
+
|
|
205
|
+
抽出的帧会**拼成一张图**,不是发好几张。4 份图片输入变成 1 份,token 省四分之三;模型看到的也是
|
|
206
|
+
时间相邻的画面,更容易判断「中间发生了什么变化」。
|
|
207
|
+
|
|
208
|
+
布局按帧数和视频方向自动推导:
|
|
209
|
+
|
|
210
|
+
| 视频方向 | 4 帧 | 6 帧 | 9 帧 |
|
|
211
|
+
|---|---|---|---|
|
|
212
|
+
| 横屏 | 2×2 田字格 | 3×2 | 3×3 |
|
|
213
|
+
| 竖屏 | 4×1 横排 | 6×1 | 9×1 |
|
|
214
|
+
|
|
215
|
+
正文会写明顺序(例如「2列×2行,从左上到右下按时间顺序」)、原视频分辨率、每格实际尺寸——
|
|
216
|
+
模型据此知道画面被压到多小、细节还剩多少。
|
|
217
|
+
|
|
218
|
+
**帧数越多代价越大**:ffmpeg 解码与拼接更慢(9 帧明显比 4 帧慢),每格画面也被压得越小、细节丢得越多。
|
|
219
|
+
4 帧够看清「视频在讲什么」,想追踪连续动作才往上加。上限 9 帧。
|
|
220
|
+
|
|
221
|
+
## 图片与视频的投递闸门
|
|
222
|
+
|
|
223
|
+
上游 Provider 对图片有硬限制(DeepSeek:单边 ≤8192、单图 ≤32 MB、连续 ≤15 张)。
|
|
224
|
+
超过就整条请求被拒,用户看到的是 HTTP 400 和「发送了不支持的图片」。所以这里在交给模型之前先拦一道。
|
|
225
|
+
|
|
226
|
+
安全线比上游更严:**16 MB / 4096 像素 / 单次 10 张**。
|
|
227
|
+
|
|
228
|
+
| 情况 | 处理 |
|
|
229
|
+
|---|---|
|
|
230
|
+
| 都在范围内 | 原样附上 |
|
|
231
|
+
| 超限且**已装 ffmpeg** | 缩到最长边 4096,再按 JPEG 质量 3→6→9 逐级降质,每级重查体积 |
|
|
232
|
+
| 超限且**没装 ffmpeg** | 不附 |
|
|
233
|
+
| 压不下去 | 不附 |
|
|
234
|
+
| 超出数量额度 | 不附 |
|
|
235
|
+
|
|
236
|
+
**丢弃一定说明原因**,绝不静默吞掉——否则用户会以为消息丢了:
|
|
237
|
+
|
|
238
|
+
```
|
|
239
|
+
[图片未附:体积 23.4 MB,超过 16 MB 上限]
|
|
240
|
+
[图片未附:尺寸 8192×6144,最长边超过 4096 像素]
|
|
241
|
+
[图片未附:超出本次投递 10 张的上限,这是第 11 张]
|
|
242
|
+
[图片未附:体积 23.4 MB,超过 16 MB 上限,且没有 ffmpeg 可压缩]
|
|
243
|
+
[图片未附:尺寸 6000×4000,最长边超过 4096 像素,压缩后仍超标]
|
|
244
|
+
```
|
|
245
|
+
|
|
246
|
+
压成功了也会写:`[图片 尺寸 6000×4000,最长边超过 4096 像素,已压缩为 284 KB]`。
|
|
247
|
+
|
|
248
|
+
数量额度**一次事件投递里累计**,图片消息和视频拼图一起算。
|
|
249
|
+
|
|
143
250
|
## 网络
|
|
144
251
|
|
|
145
252
|
Coopanion 启动 Core 时会把系统代理写进 `HTTP_PROXY`/`HTTPS_PROXY`,那条代理是给模型端点用的。
|
|
@@ -155,14 +262,31 @@ Coopanion 启动 Core 时会把系统代理写进 `HTTP_PROXY`/`HTTPS_PROXY`,
|
|
|
155
262
|
|
|
156
263
|
## 媒体怎么走
|
|
157
264
|
|
|
158
|
-
出站(Coo
|
|
159
|
-
POST 密文到微信 CDN → 从响应头 `x-encrypted-param` 取下载参数 → 发一条图片或文件消息。
|
|
265
|
+
出站(Coo 发图/发文件):**先过路径边界**(只许工作区)→ 读本地文件 → 申请上传参数(明文大小与 MD5)→
|
|
266
|
+
AES-128-ECB 加密 → POST 密文到微信 CDN → 从响应头 `x-encrypted-param` 取下载参数 → 发一条图片或文件消息。
|
|
160
267
|
说明文字作为独立文本消息先发,与官方发送端一致。
|
|
161
268
|
|
|
162
269
|
入站(对方发图/发文件):用 `media.aes_key`(或图片的 `aeskey` 明文十六进制)解密 →
|
|
163
|
-
落到
|
|
270
|
+
落到 `<工作区>/wechat-inbox/{images,files,videos,voices}/`(原文名 + 时间戳)→ 路径写进事件正文 →
|
|
164
271
|
模型接受该 MIME 时字节作为附件随事件到达。
|
|
165
272
|
|
|
273
|
+
能力查询使用 WorldHost 的 `modelFacts.accepts(mime)`,每条消息读取当前 Provider,不按模型名字猜能力。文件通道里的图片、音乐、视频和 Provider 接受的文档也会附上。图片仍经过体积、尺寸和数量限制;语音使用消息声明的实际编码,不把 MP3 误标成 SILK。不支持的编码或文件、读取失败与图片超限都会取消该附件,并把原因写进正文供桌宠告知用户。
|
|
274
|
+
|
|
275
|
+
附件由 Core 和 Provider 转成上游请求。Provider 的 MIME 声明与请求实现必须同时支持该格式;上游拒绝请求时由 Core 显示具体错误,World 不在后台另发模型请求或重试。仅上游模型增加能力、Provider 仍声明只收图片时,原生音视频不会启用。
|
|
276
|
+
|
|
277
|
+
## 最近消息与收信延迟
|
|
278
|
+
|
|
279
|
+
最近消息徽章按部署时区显示,例如 `11/16 16:37`。时间保存在部署数据目录的 `wechat-claw/status.json`,重启后恢复;旧版没有该文件时从当前绑定用户的归档事件恢复。解绑会清除状态。
|
|
280
|
+
|
|
281
|
+
长轮询的 35 秒是请求等待上限,有消息时由服务端提前返回,并非固定每 35 秒收一次。入站事件使用 `debounce`,本地 Cortico 默认静默等待 2.5 秒合批,连续来消息时最长 15 秒;实际值取决于部署的 `batching` 配置。Core 正在调用模型或工具时还要等待相应的轮次边界。
|
|
282
|
+
|
|
283
|
+
媒体下载、压缩和视频抽帧在入站处理里依次执行,处理结束后才继续轮询,较大媒体会拖慢后续消息。原生视频路径跳过抽帧,减少这部分处理。`wechat_status.lastInboundTiming`、事件 `meta.timing` 与「微信入站消息已处理」日志分别提供:
|
|
284
|
+
|
|
285
|
+
- `receivedAt`:这一批长轮询响应到达本机的时间。
|
|
286
|
+
- `receiveDelayMs`:微信消息时间到响应到达的差值,包括服务端、网络与上一次轮询前的等待;两端时钟偏差也会影响它。
|
|
287
|
+
- `queueMs`:同一批消息在本地开始处理前的排队时间。
|
|
288
|
+
- `processingMs`:保存状态、下载和准备附件所用的时间,不含 Core 合批与模型响应。
|
|
289
|
+
|
|
166
290
|
正文里的图片尺寸读自落盘文件本身(JPEG 的 SOF 段、PNG 的 IHDR 等)。微信消息里的
|
|
167
291
|
`thumb_width` / `thumb_height` 是缩略图尺寸,普遍只有 210 像素宽,和真图差一个数量级,
|
|
168
292
|
所以不用它。
|
|
@@ -171,9 +295,10 @@ POST 密文到微信 CDN → 从响应头 `x-encrypted-param` 取下载参数
|
|
|
171
295
|
|
|
172
296
|
- 只支持 1v1 私聊;没有群聊、好友列表、朋友圈、转账或红包。
|
|
173
297
|
- 只能回复,不能主动发起会话。回复需要对方最近一条消息的 `context_token`,约 24 小时后失效。
|
|
298
|
+
- **只能发工作区里的文件**。要发外面的素材,先把目录写进 `sendExtraDirs`,或把文件复制进工作区。
|
|
174
299
|
- 单条文本上限 4000 字;更长的回复由扩展自动分条,断行优先落在段落与句号上。
|
|
175
|
-
-
|
|
176
|
-
-
|
|
300
|
+
- 微信语音通常是 SILK 编码,本扩展只落盘不解码;转写用服务端给的 `voice_item.text`,Provider 支持实际编码时附上原音频。没有转写且不支持该编码时,模型无法听到语音内容。
|
|
301
|
+
- Provider 不接受原生视频时,抽帧需要 ffmpeg;没有可用 ffmpeg 时不抽帧,正文会写明。不做本地音频转写。
|
|
177
302
|
- 微信 ClawBot 是腾讯面向 OpenClaw 的官方通道,不是面向任意第三方 agent 的公开 SDK。条款、灰度范围、额度与接口都可能变化;发布前请核对当前条款。这个扩展不是腾讯或 Coopanion 的官方扩展。
|
|
178
303
|
|
|
179
304
|
## 开发
|
|
@@ -218,6 +343,7 @@ cortico-world-wechat-claw/
|
|
|
218
343
|
│ │ └── fetch.ts # undici 与宿主 fetch 的类型适配
|
|
219
344
|
│ ├── driver.ts # 长轮询、重连退避、令牌失效暂停
|
|
220
345
|
│ ├── store.ts # 凭据与游标
|
|
346
|
+
│ ├── paths.ts # 工作区 / 收件目录 / 文件名 / 发送边界
|
|
221
347
|
│ ├── world.ts # 工具、事件、绑定面板
|
|
222
348
|
│ ├── config.ts # 配置段与文案
|
|
223
349
|
│ ├── definition.ts # WorldDefinition 与自描述
|
|
@@ -229,6 +355,8 @@ cortico-world-wechat-claw/
|
|
|
229
355
|
├── dist/webui.js # 面板产物
|
|
230
356
|
├── scripts/build-webui.mjs
|
|
231
357
|
└── tests/
|
|
358
|
+
├── paths.test.ts # 工作区探测、文件名清理、发送边界
|
|
359
|
+
└── … # 协议、驱动、出站、入站、分段
|
|
232
360
|
```
|
|
233
361
|
|
|
234
362
|
## 许可
|
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",
|
|
@@ -136,8 +136,8 @@
|
|
|
136
136
|
{
|
|
137
137
|
"type": "wechat-claw.message",
|
|
138
138
|
"description": {
|
|
139
|
-
"zh": "
|
|
140
|
-
"en": "A WeChat 1:1 message
|
|
139
|
+
"zh": "一条微信私聊消息;媒体路径写在正文里,Provider 支持的图片、音频、视频和文件作为附件到达。不支持原生视频时尝试抽帧,附件未提供的原因写在正文里。",
|
|
140
|
+
"en": "A WeChat 1:1 message with local media paths. Images, audio, video and files arrive as attachments when accepted by the Provider. Video falls back to frames; unavailable attachments include a reason."
|
|
141
141
|
},
|
|
142
142
|
"trigger": "debounce"
|
|
143
143
|
},
|
|
@@ -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-
|
|
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- 对方发来文件时,路径写在正文里;当前 Provider 支持的图片、音乐、视频和文档会同时作为附件到达,需要本地内容时按路径读。\n- 对方发来视频时,当前 Provider 支持原生视频就直接附上视频;不支持时保留抽帧方式,把几帧**拼成一张图**附上,\n 正文写明布局(如「2列×2行,从左上到右下按时间顺序」)、原视频分辨率与每格尺寸。\n 按这个顺序理解画面;每格都很小,别去描述看不清的细节。正文说「视频帧未抽取」就是真的没看过。\n- 对方发来语音时,正文保留微信服务端转写;Provider 接受实际音频格式时也会附上语音。微信语音通常是 SILK,原生音频能力不保证支持此编码。没有转写也没有可用附件时,不能猜说了什么。\n- 正文写明附件未附、下载失败或抽帧失败时,告诉对方具体原因;不要声称已听过或看过未提供的内容。模型请求被上游拒绝时,以 Core 报告的错误为准。\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语义段数达到配置阈值时,会恢复完整原文直接发送;超过 4000 字仍按微信上限分条。停顿按字数和「聊天节奏」计算,短句与断句失效的特长段直接发送。\n\n对方的 `context_token` 会过期。回复被拒并提示没有可用 token 时,等对方再说一句再回,不要反复重试。\n\n这里发出的一切都会真的进到对方的微信里。不确定要不要发的时候,先问清楚。\n"
|
|
158
158
|
}
|
|
159
159
|
]
|
|
160
160
|
}
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "cortico-world-wechat-claw",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.7",
|
|
4
4
|
"type": "module",
|
|
5
|
-
"description": "
|
|
5
|
+
"description": "在微信里和桌宠一对一聊天:文字、图片、文件双向收发,按 Provider 能力传入原生音视频,不支持视频时抽帧理解。",
|
|
6
6
|
"author": {
|
|
7
7
|
"name": "云纪"
|
|
8
8
|
},
|
|
@@ -46,11 +46,11 @@
|
|
|
46
46
|
"locales": {
|
|
47
47
|
"zh": {
|
|
48
48
|
"displayName": "微信 ClawBot",
|
|
49
|
-
"description": "
|
|
49
|
+
"description": "在微信里和桌宠一对一聊天:文字、图片、文件双向收发,按 Provider 能力传入原生音视频,不支持视频时抽帧理解。"
|
|
50
50
|
},
|
|
51
51
|
"en": {
|
|
52
52
|
"displayName": "WeChat ClawBot",
|
|
53
|
-
"description": "Chat with the pet one-to-one in WeChat: text, images and files both ways,
|
|
53
|
+
"description": "Chat with the pet one-to-one in WeChat: text, images and files both ways, native audio and video when accepted by the Provider, and video frames as a fallback."
|
|
54
54
|
}
|
|
55
55
|
}
|
|
56
56
|
},
|
package/src/ENV_PROMPT.md
CHANGED
|
@@ -7,14 +7,44 @@
|
|
|
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
|
- 对方发来图片时,图片会作为附件一起到达,路径也写在正文里。看不到附件时,按路径自行读取。
|
|
15
|
-
|
|
16
|
-
-
|
|
17
|
-
-
|
|
27
|
+
正文说「图片未附:体积…/尺寸…/超出数量上限」时,那张图是真的没交给你,**不要猜图里有什么**。
|
|
28
|
+
- 对方发来文件时,路径写在正文里;当前 Provider 支持的图片、音乐、视频和文档会同时作为附件到达,需要本地内容时按路径读。
|
|
29
|
+
- 对方发来视频时,当前 Provider 支持原生视频就直接附上视频;不支持时保留抽帧方式,把几帧**拼成一张图**附上,
|
|
30
|
+
正文写明布局(如「2列×2行,从左上到右下按时间顺序」)、原视频分辨率与每格尺寸。
|
|
31
|
+
按这个顺序理解画面;每格都很小,别去描述看不清的细节。正文说「视频帧未抽取」就是真的没看过。
|
|
32
|
+
- 对方发来语音时,正文保留微信服务端转写;Provider 接受实际音频格式时也会附上语音。微信语音通常是 SILK,原生音频能力不保证支持此编码。没有转写也没有可用附件时,不能猜说了什么。
|
|
33
|
+
- 正文写明附件未附、下载失败或抽帧失败时,告诉对方具体原因;不要声称已听过或看过未提供的内容。模型请求被上游拒绝时,以 Core 报告的错误为准。
|
|
34
|
+
|
|
35
|
+
## 能发什么
|
|
36
|
+
|
|
37
|
+
只有你工作区里的文件能发到微信:
|
|
38
|
+
|
|
39
|
+
```
|
|
40
|
+
{{wechat.workspace | (工作区路径还没解析出来。)}}
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
收件目录在工作区里,所以收来的东西发得回去。工作区外面的路径会被直接拒绝——这不是故障,是边界:
|
|
44
|
+
你的配置、密钥和这台机器的其他文件不在工作区的管辖范围内,不该被随手上传出去。
|
|
45
|
+
|
|
46
|
+
要把工作区外的东西发出去,先把它复制进工作区(例如收件目录),再发复制之后那份。
|
|
47
|
+
被拒绝时回执会列出允许的目录,照着调整路径就行,不要换个写法绕过它。
|
|
18
48
|
|
|
19
49
|
## 约束
|
|
20
50
|
|
|
@@ -30,7 +60,7 @@
|
|
|
30
60
|
|
|
31
61
|
拆的顺序按一次算,不会拆两次:
|
|
32
62
|
|
|
33
|
-
-
|
|
63
|
+
- 你写了换行,就只按换行拆;换行会消失,段内不再按标点拆。紧挨换行的段尾句号也会被去掉,段内的句号留着。
|
|
34
64
|
- 没写换行但有句号,就只按句号拆,句号会消失。
|
|
35
65
|
- 都没写,但有 `!?…~`,就按它们拆;它们留着,因为你靠它们表达语气。
|
|
36
66
|
- 都没有,就整条发出去。
|
|
@@ -41,6 +71,8 @@
|
|
|
41
71
|
|
|
42
72
|
分段与间隔都是对方在配置页设的,你看不到也不必猜;照平时的习惯说话就行。
|
|
43
73
|
|
|
74
|
+
语义段数达到配置阈值时,会恢复完整原文直接发送;超过 4000 字仍按微信上限分条。停顿按字数和「聊天节奏」计算,短句与断句失效的特长段直接发送。
|
|
75
|
+
|
|
44
76
|
对方的 `context_token` 会过期。回复被拒并提示没有可用 token 时,等对方再说一句再回,不要反复重试。
|
|
45
77
|
|
|
46
78
|
这里发出的一切都会真的进到对方的微信里。不确定要不要发的时候,先问清楚。
|