wechat-ops:微信操作(桌面发送 + 公众号/小程序)
wechat-ops:微信操作(桌面发送 + 公众号/小程序)
wechat-ops 由原 wechat-bridge(桌面微信发送桥)与 wechat-mp(公众号 / 开发者平台 / 小程序)合并而来,两条主线互不相干,按需要只看其中一条。
| 主线 | 覆盖 | 入口 |
|---|---|---|
| A. 桌面微信发送 | 给文件传输助手或已授权联系人原样单次发消息;loopback HTTP 桥(noop / exec / upstream);原生 Qt 发送 profile 派生(研究型) | 见下方「A」节 |
| B. 微信平台后台 | 公众号草稿 / 发表 / 素材 / 密钥白名单;小程序上传、提审、发布、版本状态;wxapkg 反编译;TikTok Minis | 见下方「B」节 |
A. 桌面微信发送(原 wechat-bridge)
大模型跑完一个长任务,你想在微信里收到结果;又不想它弹出微信窗口、抢走焦点、覆盖剪贴板。wechat-ops 的发送桥(原 wechat-bridge)解决的是「统一调用契约」这一层:一个只绑 127.0.0.1 的本地 HTTP 服务,路由与 leeguooooo/wechat-use 的 bridge 对齐,调用方发一次 POST /send 即可。
它不做什么
默认不发送任何消息。 默认后端是 noop:收到请求只登记,返回 status_unknown,绝不碰微信。这是刻意的安全默认——接真实发送器之前,可以先把 agent、hook、脚本全调通。
它也不是微信机器人:不读消息、不自动回复、不监听群。要收消息走别的通道。
三层技术事实
研究上游仓库(2026-11-10,v1.19.22)后有三条硬事实:
- 源码不在仓库里。GitHub Release 只分发预编译 Mach-O arm64 二进制,整包 40 MB。发送实现是闭源的。
- 后台发送不是辅助功能。反编译二进制后确认:上游在独立微信副本进程内用 LLDB 表达式求值调用 Qt 私有接口
QMetaObject,先把文本setText进聊天输入框(QTextEdit),再对输入视图触发 send 动作(qt_metacall);用qtextedit_metacall_rva/inputview_metacall_rva/editor_vtable_rva等一组按微信 build 指纹(target_module_sha256+module_size)变化的 RVA 定位,早期经task_for_pid/mach_vm_read_overwrite/ LLDB 附着,后改mach_vm_write免附着;绑定微信 4.1.9 特定 build 与服务端激活码。发任意联系人还要先「导航」到该会话,是另一条独立机制。 - 微信 4.x 的 AX 树没有可写输入框。本机 macOS 微信 4.1.10 实测:会话列表读得到(文件传输助手、各个群),但所有元素只有
raise动作,可写的AXValue元素为 0;归档项目ginqi7/macos-wechat-cli也写明「4.x 不支持所需的辅助功能 API」。
因此这个 skill 只做公开 HTTP 协议的独立互操作:是独立实现,注入、dylib、版本适配与激活都不在这一层(RVA 派生工具另附,见下节)。
结论很直接:想要「任意联系人 + 不影响操作电脑 + 静默发送」,必须自备发送器,或按上游 README 装好官方发布物。skill 本身不承诺能发。
附:自己算原生发送 profile
上游的发送依赖一组按微信 build 变化、由服务端下发的 Qt RVA(qtextedit_metacall_rva、inputview_metacall_rva、editor_vtable_rva、qstring_from_utf8_rva、editor_offset、send_action 等)。skill 里附了把这一组从本机微信 Contents/Resources/wechat.dylib 自己算出来的流程:
| 文件 | 用途 |
|---|---|
scripts/derive_profile.py | 一条命令算出 profile.json(版本 + 切片 sha256 + 各类 metacall/vtable RVA) |
scripts/ghidra_macos_bootstrap.sh | 在 macOS arm64 装出 REA 能用的 Ghidra |
scripts/macho_chained_fixups.py | 解 Mach-O chained fixup,回答「谁引用了这个地址」 |
scripts/ghidra/Profile.java / EnumMeta.java | Ghidra 侧:扫目标类 / 扫全部元对象并解类名 |
scripts/ghidra/MetaNames.java / WalkMeta.java / DumpMeta.java | 解某类的方法表 / 继承链 / 原始字段 |
scripts/native/wechat_probe.c | 外部只读探测已登录进程的对象、回指与成员绑定,不调用 Qt 或发送 |
scripts/native/wechat_send.c | 实验安全底座,仅接受 probe\n,写入与发送禁用 |
scripts/native/build_dylib.sh | 编译到显式指定的全新绝对路径,禁止覆盖已有 dylib |
scripts/native/make_clone.sh | 仅准备新副本并签名,不自动启动、登录或测试发送 |
scripts/test_derive_profile.py / scripts/native/test_native.py | 离线方法解析与原生安全回归 |
references/qt-native-send-derivation.md | 端到端流程、已派生的 4.1.10 profile、坑 |
在 WeChat 4.1.10 上已实际派生成功。 关键发现:
ChatInputView持有ChatInputField,后者经中间类继承XTextEdit/QTextEdit;持有关系不能当成继承关系。方法号逐 build 派生,不能沿用旧的Sendid 5;4.2.0 的实际 id 为 8。- 上游硬编码的
setTextid 16 在 4.1.10 上解出来仍是 16(实际是setPlainText),三条独立路径互证(RTTI 链、metaObject()thunk、元对象方法表)。 - 不需要跑完整自动分析:Ghidra 用
-noanalysis导入(只为解 chained fixup)就能把 1116 个类的名字与方法名全解出来。
不能把静态派生当成发送可用。 早期“手拼 Qt6 QString 即可”的说法不成立:上游模板使用 Qt5 风格的单指针数据头,旧代码的偏移还写错了;socket 工作线程也不能直接操作 Qt 控件。当前新版实验 dylib 只支持只读探测,拒绝文本写入和发送。构建输出必须是全新绝对路径,不得覆盖已登录副本映射的 dylib。
2026-11-11 在已登录的 4.2.0 / 270353 副本上,外部只读探测已确认 ChatInputView + 0x200 持有 ChatInputField 编辑器,两对象的 QObject 回指校验通过;没有触发重启、登录或消息发送。该 build 的 Send 局部 id 是 8,setPlainText 仍是 16。RTTI 名称部分被散列化,不能按明文类名盲搜。对象定位成功不等于发送成功。
最终目标是上游完整能力矩阵,而非仅发送桥。 读取/搜索/导出、群成员、媒体、朋友圈、实时接收、TUI、MCP/Wechaty、跨账号及生命周期分别验收,优先复用上游公开 CLI/daemon/SDK,并保留其版本、授权和激活前置条件。上游指定特定 4.1.9 build,不能因 4.2.0 副本能登录就声称全功能兼容;收藏等上游未开放项不伪报支持。具体范围见 skill 的 references/capability-scope.md。
上游 SDK 1.19.22 的真机预检已执行:sessions、contacts、unread 三项均因“尚未激活订阅”以退出码 2 拒绝;doctor 虽退出码 0,但返回 query_ready:false、send_ready:false,另有读取配置和运行环境校验阻塞。静态主题枚举可用不等于伪装功能通过。完整业务验收需要有效上游授权、受支持 build 与读取快照;不应要求用户重复扫码来解决这些前置条件。
四个必须先知道的坑:
- Ghidra 官方 release zip 不含 macOS 原生反编译器(
os/只有 linux/win),REA 会报executable_missing;要拿包内源码自编,且 Makefile 的 Darwin 分支硬编码-arch x86_64。 wechat.dylib带LC_DYLD_CHAINED_FIXUPS:磁盘上的指针是位编码值,不是明文地址。不先解 fixup,「扫数据段找指向某地址的指针」永远命中 0,会让人误判「这些数据没人引用」。地址要按 8 位十六进制写,多一位就超出镜像、静默返回 0。- 不要拿 REA 做迭代查询:它的 Ghidra 会话每次调用即导入、关闭即丢弃,一个查询要重跑一遍 147 MB 分析。改用
analyzeHeadless+ 持久 project,后续-process -noanalysis秒级复用。 - RVA 逐 build 变,微信一热更就要重算(重跑
derive_profile.py)。发任意联系人的「切会话/导航」是另一条独立机制,本流程不覆盖。
已完成一次独立的界面发送验收:2026-11-11,在授权的 WeChatSend 副本中,通过 cua-driver 后台打开文件传输助手、写草稿并回读全文、单次 Return 提交;聊天记录出现唯一测试消息,输入框清空,后续截图未见失败标记。没有重启、重新登录或向其他联系人发送。这是后台界面路径,不是原生 Qt 或 HTTP /send 路径;手机端独立接收与零焦点变化未单独验证。
原生 Qt、HTTP 和聊天 skill 已完成提交及桌面发送侧聊天记录核验。 4.2.0 实验执行器已验证模块指纹、目标副本 pid、编辑器归属、input+0x258 的 filehelper 收件人、空草稿和 UTF-16 回读;在主线程执行 Qt setPlainText / Send 后读到草稿清空,再分离 LLDB。HTTP 经 exec 调用同一原生路径,返回 submitted_unconfirmed。后续后台截图已同时显示三条唯一正文的发出消息气泡,未见失败标记,控件树回读一致。历史回执不改写,手机端接收仍未验证;不能将桌面聊天记录当成服务端送达回执。
新增 scripts/native/native_executor.py、lldb_runner.py 与离线回归测试;通过私有绝对路径 WXS_NATIVE_CONFIG 指定经过核验的限定 build 配置,再将 WECHAT_BRIDGE_EXEC_SEND 设为该脚本。默认只允许文件传输助手;新增精确收件人私有白名单后,未启用 ID 仍在探测/附着前拒绝。拒绝非空草稿、模块漂移与重复正文,串行锁阻止并发附着;发送前持久 claim,结果不明不能删 claim 重发。HTTP 回执额外保留 native_request_id 关联原生回执。该路径仍使用 LLDB 短暂附着,不是免附着生产实现,也不支持任意联系人或媒体。
LLDB 的 expression --timeout 单位是微秒,5 秒应写 5000000。本次没有重启微信或重复扫码;真实字符串工厂、跨 build 生命周期、媒体以及手机端接收确认仍未完成。
三个后端
| 后端 | 行为 | 用途 |
|---|---|---|
noop(默认) | 只登记,返回 status_unknown | 调调用方、跑自检、CI |
exec | 每条操作起一个命令,stdin/stdout 传 JSON | 已有任意发送脚本,接进来 |
upstream | 全路由透传给已运行的 wechat-use bridge | 已装好上游,要统一入口或加鉴权 |
exec 的契约很薄:命令从 stdin 读 {"op":"send","wxid":"...","text":"..."},向 stdout 打印 {"status":"delivered"}。用 python3 -c 包一层就能接任何 CLI。参数走 stdin 而不是拼进命令行,避免注入。
聊天里直接让 agent 发送
已有 wechat-ops skill,无需新建第二个。加载插件后可以说:
- “给文件传输助手发:今天任务已完成。”
- “把下面这段原样发给文件传输助手:……”
/vft-kit:wechat-ops 给文件传输助手发:今天任务已完成。
agent 复用已核验的私有 WXS_NATIVE_CONFIG,把正文作为 JSON stdin 传给 scripts/native/native_executor.py,只调用一次;无需用户开终端,也无需启动 HTTP 服务。配置缺失、进程或模块变化时拒绝,不自动改 PID、重建副本或要求扫码。当前需副本已打开文件传输助手且草稿为空。
明确的收件人和正文即授权该条发送,不再机械二次确认;仅讨论用法或问“能不能做成 skill”不会发送。指定原文时不改写、不加前缀、时间戳或签名;“发给他”若无唯一目标,必须先澄清,不能猜联系人或偷换为文件传输助手。
当前默认仍仅向文件传输助手发送 1–2000 字符文本。 已添加私有精确 ID 白名单与名称映射,但其他联系人、群聊尚未通过端到端发送验收,通用自动导航仍未完成;不支持 @、图片和文件;重复正文会被防重复门禁拒绝,不能靠改正文或删 claim 绕过。submitted_unconfirmed 只能报告“已提交,送达未确认”,status_unknown 不重发。没有聊天记录或接收端证据不得报告“已送达”。原生路径仍为短暂 LLDB 附着的实验实现。
首次更新触发描述后,在 Claude Code 执行 /reload-plugins 刷新 skill 元数据;不需要重新安装插件或重新登录微信。
联系人扩展:先精确核对,不猜人
同一原生执行器可接收只读输入 {"op":"resolve","hint":"备注名"} 或 {"op":"preflight","wxid":"精确ID"}。前者只查操作方私有配置的 recipient_aliases,不冒充完整通讯录;重名返回 ambiguous。后者只核对当前输入视图的精确 ID 与编辑器归属,固定返回 send_ready:false,不附着 LLDB、不写草稿、不发送。
私有配置示例:"recipient_aliases":{"唯一备注":["wxid_exact"]}、"allowed_recipients":["filehelper","wxid_exact"]。映射不授予发送权限,agent 不自动扩大发送白名单。主线程在写入和提交前都检查完整 ID,支持该 build 的 libc++ 短/长字符串;持久 claim 按 pid、目标 ID、正文防重,兼容旧文件助手 claim。
需将新版 wechat_probe.c 编译到全新绝对路径、自测后更新私有配置 probe;执行器会传 RECIPIENT_OFFSET,旧版无精确字段直接拒绝,无需重启微信。已实测文件助手正例、错误目标拒绝,另一现有聊天只做后台打开与原生 ID 读取,未向其发送。搜索框输入尚没有可靠候选,双击打开独立聊天后窗口也可能关闭释放对象,因此通用导航仍未完成,不缓存旧对象继续发送。
用法
以下为可选的 HTTP 接入,默认 noop 不实际发送:
SKILL=<vft-kit>/skills/web-automation/wechat-ops
python3 "$SKILL/scripts/wechat_bridge.py" self-test # 18 项协议自检,零 GUI
python3 "$SKILL/scripts/wechat_bridge.py" probe # 只读环境报告
python3 "$SKILL/scripts/wechat_bridge.py" serve # 127.0.0.1:18400
python3 "$SKILL/scripts/wechat_bridge.py" send "文件传输助手" "任务完成:84/84 通过"
也可直接调 HTTP:
curl -sS -X POST http://127.0.0.1:18400/send \
-H 'Content-Type: application/json' \
-d '{"wxid":"filehelper","text":"hello"}'
路由与上游一致:/health、/chats、/unread、/contacts、/resolve、/chat/{wxid}、/chat/{wxid}/history、/messages/stream(SSE)、/send。另有本 skill 扩展的 /receipt?request_id=X 用于查登记状态。
一个不能省的细节:不重试
上游 SDK 的 bridge.mjs 有个关键约束:网络异常或响应不可解码时抛 AmbiguousSendError,不自动重试——因为消息可能已经发出去了,重试就是重复发送。
发送桥照抄了这条:send 子命令只 POST 一次;服务端异常返回 status_unknown + 502;客户端拿到 status_unknown 以退出码 2 结束。调用方要查状态用 /receipt,不要重发。
安全边界
- 只绑
127.0.0.1,日志不打 wxid、正文、token。 - 可设
WECHAT_BRIDGE_BEARER,非/health路由要求 Bearer 鉴权。 text上限 8000 字符;mention只收 string / list / object。- SSE 默认过滤
fromSelf:true,since默认当前时间,避免since=0把全历史 backfill 出来。
接 wechat-use
上游前置条件不在本 skill 范围内:微信 4.1.9 独立副本、Telegram 激活码(人工审核)、wechat-use setup。
装好之后把端口错开,用 upstream 后端代理:
export WECHAT_BRIDGE_BACKEND=upstream
export WECHAT_BRIDGE_UPSTREAM=http://127.0.0.1:18401
export WECHAT_BRIDGE_PORT=18500
python3 "$SKILL/scripts/wechat_bridge.py" serve
验收与边界
暂停时的续研记录保存在 skill 源目录的 references/handoff-2026-11-11.md,由 SKILL.md 链接;包含验证状态、证据路径和后续步骤,不作为自动发送指令。
self-test 覆盖三后端共 18 项:noop 的参数边界与 status_unknown、Bearer 鉴权(/health 放行、其余 401)、exec 状态与 HTTP→原生回执关联。
已验证:后台界面、原生 Qt、HTTP、聊天 skill 的桌面发送侧聊天记录;精确 ID 只读正反例;另一现有会话后台打开与 ID 读取。执行器离线 20 项(含编译运行 C++ 门禁)、probe 内部 12 项通过。新增多收件人门禁之后尚未真发回归,不能将此前文件助手截图当作新代码的发送验收。最终真机检查确认名称解析、未知名称拒绝、未启用 ID 拒绝,原有回执未变化;当时文件助手没有有效输入对象,预检拒绝。未验证:新门禁真发、其他联系人实际发送、通用自动导航、群聊、手机端接收、与上游 bridge 的联调。离线回归不代替真实业务验收。
B. 微信平台后台:公众号 / 开发者平台 / 小程序(原 wechat-mp)
用 ego-lite 复用登录态操作公众平台(草稿、素材、发表)与开发者平台(密钥、白名单、接口权限),并用 CLI / 接口完成小程序上传、提审、版本查询和反编译复刻。
何时用
- 公众号:Markdown 转草稿、配图与封面、发表、素材 / 发表记录 / 用户管理读取;
- 开发者平台:AppID/AppSecret、IP 白名单、接口权限与额度,排查
40164/48001; - 小程序:开发者工具 CLI、automator 自测、miniprogram-ci 上传体验版、提审与发布、版本状态、广告分享规则、wxapkg 反编译复刻样式;
- TikTok Minis:抓 H5 前端产物学习。
发文到草稿箱(核心流程)
- 用
useOrCreateTaskSpace('wechat mp <做什么>')复用登录态;token每次都从当前页面 URL 现取,不复用旧值,并核对右上角账号名。 node scripts/md-to-mp-html.mjs article.md --json把 Markdown 转成 inline-style HTML。- 开
isNew=1新编辑器页,等编辑器初始化;标题insertText,正文用合成 paste 写入(不直接写innerHTML),成功看chars/h2数。 - 点「保存为草稿」,URL 出现
appmsgid=即成功。 - 只有你明确要求「发表 / 群发」才走发表流程,成功只认发表记录
publish_list按完整标题命中并拿到content_url。
硬规则
- 改密钥、白名单、看接口权限一律去开发者平台;公众平台那页只剩迁移通知。
- 不去
.secrets找密码;只有实际出现扫码 / 确认步骤时才把任务空间交还用户本人。 - 封面是发表硬前置(判据:
.js_cover_preview_new背景图含mmbiz);图片只走本地上传。 - 除非明确说发布 / 群发,一律停在草稿。
- AppSecret 重置后旧值立即失效,先确认能同步配置再动;解除授权、重置密钥、发表、删文、提审与发布动手前先确认。
- 凭据不写进 skill 或仓库;多账号先核对当前登录账号(
.weui-desktop-account__info)。 - 反编译只用于学习研究或有权使用的设计,不分发解出的源码。
小程序:上传、提审、发布
走开发者工具 CLI 与接口:上传 / 预览 / 版本状态 / 提审发布用 scripts/mp-ci.mjs、scripts/wxamp-version-status.mjs、scripts/wxamp-submit-audit-api.mjs(兜底 scripts/wxamp-submit-audit.mjs)。开发者工具 CLI、automator 自测、本地后端与小游戏后台(cua-driver)见 wechat-ops/references/miniprogram-devtools.md;完整版本门禁见 wechat-ops/references/miniprogram-release.md。
反编译 wxapkg 与 TikTok Minis
反编译 wxapkg、还原 WXSS、复刻到 Taro,以及小游戏代码与已访问资源归档,用 wechat-ops/scripts/wxapkg/ 下的脚本,说明见 wechat-ops/references/wxapkg-unpack.md;详细用法与踩坑见 wxapkg-unpack 小程序反编译。TikTok Minis 抓 H5 前端(scripts/tiktok-minis/fetch.py)见 wechat-ops/references/tiktok-minis.md。
报错速查
40164(IP 白名单)、48001(接口未授权)、粘贴重复、发表无反应等报错与定位见 wechat-ops/references/troubleshooting.md。

留言板
0 条留言对话,从你开始
还没有留言。分享一个想法,或只是打声招呼。