◆

wechat-ops:微信操作(桌面发送 + 公众号/小程序)

2026-11-10 08:000

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)后有三条硬事实:

  1. 源码不在仓库里。GitHub Release 只分发预编译 Mach-O arm64 二进制,整包 40 MB。发送实现是闭源的。
  2. 后台发送不是辅助功能。反编译二进制后确认:上游在独立微信副本进程内用 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 与服务端激活码。发任意联系人还要先「导航」到该会话,是另一条独立机制。
  3. 微信 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.javaGhidra 侧:扫目标类 / 扫全部元对象并解类名
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 派生,不能沿用旧的 Send id 5;4.2.0 的实际 id 为 8。
  • 上游硬编码的 setText id 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 与读取快照;不应要求用户重复扫码来解决这些前置条件。

四个必须先知道的坑:

  1. Ghidra 官方 release zip 不含 macOS 原生反编译器(os/ 只有 linux/win),REA 会报 executable_missing;要拿包内源码自编,且 Makefile 的 Darwin 分支硬编码 -arch x86_64。
  2. wechat.dylib 带 LC_DYLD_CHAINED_FIXUPS:磁盘上的指针是位编码值,不是明文地址。不先解 fixup,「扫数据段找指向某地址的指针」永远命中 0,会让人误判「这些数据没人引用」。地址要按 8 位十六进制写,多一位就超出镜像、静默返回 0。
  3. 不要拿 REA 做迭代查询:它的 Ghidra 会话每次调用即导入、关闭即丢弃,一个查询要重跑一遍 147 MB 分析。改用 analyzeHeadless + 持久 project,后续 -process -noanalysis 秒级复用。
  4. 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 前端产物学习。

发文到草稿箱(核心流程)

  1. 用 useOrCreateTaskSpace('wechat mp <做什么>') 复用登录态;token 每次都从当前页面 URL 现取,不复用旧值,并核对右上角账号名。
  2. node scripts/md-to-mp-html.mjs article.md --json 把 Markdown 转成 inline-style HTML。
  3. 开 isNew=1 新编辑器页,等编辑器初始化;标题 insertText,正文用合成 paste 写入(不直接写 innerHTML),成功看 chars / h2 数。
  4. 点「保存为草稿」,URL 出现 appmsgid= 即成功。
  5. 只有你明确要求「发表 / 群发」才走发表流程,成功只认发表记录 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 条留言
Markdown
0 字
对话记录每个声音,都值得被看见

对话,从你开始

还没有留言。分享一个想法,或只是打声招呼。

PAGE LOAD / LIVEwechat-ops:微信操作(桌面发送 + 公众号/小程序)加载中