wekeapi-message
/wekeapi-message
Wysyła, przekazuje i wycofuje wiadomości WeChat oraz pobiera z nich pliki i historię rozmów przez wekeapi CLI.
- Autor
- wekeapi ↗
- Repozytorium
- wekeapi-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Wysyła, przekazuje i wycofuje wiadomości WeChat oraz pobiera z nich pliki i historię rozmów przez wekeapi CLI.
Oryginalny opis (EN)
wekeapi CLI message 模块:微信消息发送(文本/图片/视频/文件/语音/链接/小程序/Emoji/名片/AppMsg)、消息转发与撤回、下载收到的媒体(图片/视频/语音/文件/Emoji/CDN),以及通过 wekeapi-msg-sync 查询消息记录。当用户要求发微信消息、群发、转发消息、@群成员、撤回消息、查询聊天记录或下载消息里的附件时使用。
Jak działa
- 前置
- 发送
- 转发(同一内容发多人:先 send- 发第一人,再 forward-,效率更高)
- 下载(均支持 --out <路径> 直接保存文件)
- 示例
- 发送后自动落库(自己发的消息也会记录)
- 注意
Podgląd SKILL.md
--- name: wekeapi-message description: wekeapi CLI message 模块:微信消息发送(文本/图片/视频/文件/语音/链接/小程序/Emoji/名片/AppMsg)、消息转发与撤回、下载收到的媒体(图片/视频/语音/文件/Emoji/CDN),以及通过 wekeapi-msg-sync 查询消息记录。当用户要求发微信消息、群发、转发消息、@群成员、撤回消息、查询聊天记录或下载消息里的附件时使用。 --- # message 消息 ## 前置 - 二进制复用 wekeapi-core skill 的 `assets/bin/`(相对该 skill 目录解析,不要写死 skills 根目录),按 OS/架构选择(Windows x64: `wekeapi-windows-amd64.exe` / Windows ARM64: `wekeapi-windows-arm64.exe` / Linux x64: `wekeapi-linux-amd64` / Linux ARM64: `wekeapi-linux-arm64` / macOS Intel: `wekeapi-darwin-amd64` / macOS ARM: `wekeapi-darwin-arm64`),下文以 `$WEKEAPI` 代指;`PATH` 中已有 `wekeapi` 时优先用 `wekeapi`,定位与兜底见 wekeapi-core「二进制」。 - 调用需 token(访问凭证,全部账号共用,`init` 保存后可免传);**多账号时用 `--app-id` 指定本次操作的账号**(取值见 `wekeapi account list`),省略时用默认账号;stdout 恒为 JSON;退出码 0 成功 / 1 API 业务错误 / 2 本地错误。 - `--to-wxid` 好友、群通用(群 ID 形如 `12345@chatroom`)。其余全局约定见 wekeapi-core skill。 - 用户给的是微信号/昵称/备注而非 wxid 时,先用 `$WEKEAPI data contacts --keyword <关键词>` 解析(`data.contacts[].id` 即 wxid),查不到再调远端接口;**不要再用 sqlite3 查本地数据库**。 - **消息由 wekeapi-msg-sync 统一存储**:服务接收消息回调并落库;CLI 发送/转发成功后也会把消息上报落库。查询聊天记录用 `$WEKEAPI data messages`(`--conversation-id S:<wxid>|R:<roomid>`、`--keyword`、`--start-time`/`--end-time`、`--page`/`--limit`),返回 `data.messages[]`(含 `new_msg_id`/`from`/`to`/`room_id`/`content`/`create_time`/`revoked`),`from` 等于自己即本人发出。 ## 发送 > **发送类接口(`send-*` / `forward-*`)必须串行执行,两次调用之间间隔 3 秒以上**(硬性要求,见「注意」)。 | 命令 | 说明 | 参数 | |---|---|---| | `message send-text` | 发文本 | **`--to-wxid`**、**`--content`**;`--ats` 群@成员(逗号分隔,@全部填 `all`,内容需含"@昵称") | | `message send-voice` | 发语音(wav/SILK,≤60 秒) | **`--to-wxid`**、**`--file`/`--url`** | | `message send-image` | 发图片(≤20MB,jpg/png/bmp/webp/tiff) | **`--to-wxid`**、**`--file`/`--url`** | | `message send-video` | 发视频(≤200MB) | **`--to-wxid`**、**`--file`/`--url`** | | `message send-file` | 发文件(≤200MB) | **`--to-wxid`**、**`--file`/`--url`**、**`--file-name`** 含扩展名 | | `message send-link` | 发链接 | **`--to-wxid`**、**`--title`**、**`--link-url`**、**`--file`/`--url`** 缩略图(≤5MB);`--desc` | | `message send-miniapp` | 发小程序(先发给自己取接收消息的 xml) | **`--to-wxid`**、**`--xml`/`--xml-file`** | | `message send-emoji` | 发 Emoji | **`--to-wxid`**、**`--emoji-md5`**、**`--emoji-size`** | | `message send-card` | 发名片 | **`--to-wxid`**、**`--card-wxid`**、**`--card-nickname`**;`--card-alias` | | `message send-appmsg` | 发 AppMsg(视频号/聊天记录/音乐等) | **`--to-wxid`**、**`--xml`/`--xml-file`**;提供 ori* 参数则按转发发送 | | `message revoke` | 撤回消息(newMsgId/createTime 取自发送响应) | **`--to-wxid`**、**`--new-msg-id`**、**`--create-time`** | ## 转发(同一内容发多人:先 send-* 发第一人,再 forward-*,效率更高) **技巧**:把发送接口的完整响应(stdout 原始 JSON)存文件,再 `forward-* --to-wxid 下一人 --data @resp.json` 即可。CLI 会**自动解包**响应包裹(取其中的 `data`)并**自动补全 API 必需的 ori 字段**: - `oriMsgId ← newMsgId` - `oriMsgSourceBase64 ← msgSourceBase64` - `oriMsgTo ← 响应中的 toWxid`(原接收人) - `oriMsgFrom ← 当前账号 wxid`(取所选账号记录,由 `--app-id` 决定) 因此通常**只需再补 `--to-wxid` 指定新接收人**(显式 flag 优先于 `--data`)。若响应用 `jq .data` 只存了内层对象,也同样可用。 | 命令 | 数据来源 | 关键参数 | |---|---|---| | `message forward-image` | send-image 的响应 | **`--to-wxid`** + CDN 字段(`--file-id --file-md5 --aes-key --big-img-size --mid-img-size --thumb-img-width/height/size`;ori 自动补全) | | `message forward-image-msg` | 收到图片消息的 xml | **`--to-wxid`**、**`--xml`/`--xml-file`**;ori 字段可选 | | `message forward-video` | send-video 的响应 | **`--to-wxid`** + CDN 字段(`--file-id --file-md5 --aes-key --new-md5 --crc32 --file-size --play-length --raw-file-id/md5/aes-key/size --thumb-width/height/size`;ori 自动补全) | | `message forward-video-msg` | 收到视频消息的 xml | **`--to-wxid`**、**`--xml`/`--xml-file`** | | `message forward-file` | send-file 的响应 | **`--to-wxid`**、**`--file-name`** + CDN 字段(`--file-id --file-md5 --aes-key --file-crc --file-size`;ori 自动补全) | | `message forward-file-msg` | 收到文件消息的 xml | **`--to-wxid`**、**`--xml`/`--xml-file`** | | `message forward-link` | send-link 的响应 | **`--to-wxid`**、**`--title`**、**`--link-url`** + CDN 字段(`--aes-key --thumb-url --thumb-md5 --thumb-width/height/size --req-id`;ori 自动补全) | | `message forward-link-msg` | 收到链接消息的 xml | **`--to-wxid`**、**`--xml`/`--xml-file`** | | `message forward-miniapp` | 收到小程序消息的 xml | **`--to-wxid`**、**`--xml`/`--xml-file`** + ori 字段 | > ori 字段 = `--ori-msg-id/--ori-msg-from/--ori-msg-to/--ori-msg-source`(原消息 newMsgId、发送/接收人 wxid、MsgSource,自动 base64)。除 `forward-miniapp`(来自接收消息的 xml)外,基于发送响应的 `forward-image/video/file/link` 均会自动补全,无需手填。完整字段含义见 `$WEKEAPI message forward-image --help`。 > 发到朋友圈不是消息模块:链接聊天消息 → 朋友圈用 wekeapi-sns 的 `sns forward-link-msg`,视频号消息/视频号朋友圈 → 朋友圈用 `sns forward-finder`(均以 `--xml/--xml-file` 传原消息 xmlMsg)。 ## 下载(均支持 `--out <路径>` 直接保存文件) | 命令 | 说明 | 参数 | |---|---|---| | `message download-voice` | 下载语音 | **`--new-msg-id`**、**`--xml`/`--xml-file`**、**`--format`** 1-SILK/2-WAV、**`--from-wxid`** | | `message download-image` | 下载图片 | **`--type`** 1-原图/2-常规/3-缩略、**`--xml`/`--xml-file`**;无对应规格返回 -33 | | `message download-video` | 下载视频 | **`--type`** 1-原视频/2-常规/3-缩略、**`--xml`/`--xml-file`** | | `message download-file` | 下载文件(xml 中 type=6 的消息) | **`--xml`/`--xml-file`** | | `message download-emoji` | 下载 Emoji(URL 7 天有效) | **`--xml`/`--xml-file`** | | `message download-cdn` | 无 xml 时用 CDN 字段下载 | **`--type`** 1-高清图/2-常规图/3-缩略图/4-视频/5-文件、**`--file-id`**、**`--aes-key`**、**`--file-size`** | ## 示例 ```bash # 群里发文本并@所有人 $WEKEAPI message send-text --token T --app-id A --to-wxid 12345@chatroom --content '@all 开会了' --ats all # 发图片给第一人,用响应转发给其他人(高效群发) $WEKEAPI message send-image --token T --app-id A --to-wxid wxid_a --file ./photo.jpg > resp.json $WEKEAPI message forward-image --token T --app-id A --to-wxid wxid_b --data @resp.json # 下载收到的图片原图 $WEKEAPI message download-image --token T --app-id A --type 1 --xml '<msg><img .../></msg>' --out ./dl.jpg ``` ## 发送后自动落库(自己发的消息也会记录) `send-*` 与 `forward-*` 命令成功后,CLI 会自动把这条消息写入运行中的 wekeapi-msg-sync,供后续查询: - `from` 取配置里的本账号 wxid;`to`/`new_msg_id`/`create_time` 取发送响应(缺失时回落到请求体/当前时间);`msg_type` 按命令映射(文本 1、图片 3、语音 34、视频 43、名片 42、表情 47、链接/文件/小程序/AppMsg 49)。 - `content` 只存可检索文本:文本存内容、链接存「标题 + 地址」、文件存文件名、名片存昵称;图片/语音/视频等媒体类留空(**不会**把 base64 文件数据写进数据库)。 - 查询验证:`$WEKEAPI data messages --conversation-id S:<对端 wxid>|R:<群id>`,返回项里 `from` 为本账号 wxid,即本人发出。 - 失败不影响发送结果:服务未配置/未运行时直接跳过;写入报错只在 stderr 输出 `warn:`,stdout 仍是发送接口的原始 JSON,退出码不变。 - 若平台同时通过回调推送了该消息,按 `(wx_id, new_msg_id)` 幂等去重,不会出现重复记录。 ## 注意 - **发送间隔(硬性要求)**:所有发送类接口(`send-*` 与 `forward-*`)连续执行时,两次调用之间必须**间隔 3 秒以上**,且只能串行逐条发送,禁止并发批量发送。短时间内连续发送会返回 `-12 调用超限`,遇 `-12` 时停止发送、等待更长时间后再重试。 - **撤回窗口**:微信撤回仅在约 2 分钟内有效,超时返回 `-52`(后端 `[-430]`)。需要撤回时请"先发后立即撤"(拿到 newMsgId/createTime 后马上调 `revoke`)。 - **目标不校验**:向不存在或非法的 `--to-wxid` 发送文本,服务端不做校验,仍返回 `code:0`(不会报业务错误);请自行确保目标 wxid/群 ID 正确。 - **语音格式**:`send-voice` 仅支持 wav / 原生 SILK,其它格式返回 `-30 不支持的格式`。 - 消息存储由 wekeapi-msg-sync 负责,查询用 `$WEKEAPI data messages`;发送/转发命令成功后会主动上报落库(见上文),服务未运行时仅跳过上报,不写本地数据库。
Wersje
W bazie nie ma innych skilli o nazwie wekeapi-message.
Migawka bazy z 13.11.2026 · wersja paczki ee689da7332a (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100wekeapi-contact
Przegląda i porządkuje kontakty WeChat przez wekeapi: wyszukuje znajomych, dodaje, usuwa, zmienia notatki i zamienia nazwy na identyfikatory. - 100wekeapi-autoreply
Nasłuchuje nowych wiadomości WeChat przez wekeapi i zgłasza je w rozmowie, a odpowiedzi wysyła wg reguł użytkownika, z przerwami.