TrollStore / 巨魔
优先推荐- 准备适用的微桥插件包，并安装可用的巨魔注入器。
- 使用巨魔注入器打开插件包，选择微信进行注入。
- 注入完成后，重新打开微信，检查设置页中的微桥入口。
TrollStore 与巨魔注入器是不同工具，安装条件请分别核对。
01
先确认，再动手
你需要准备什么？
一台能运行目标微信版本的 iPhone
微信直接从 App Store 下载即可。安装插件前，确认使用巨魔、越狱还是签名方式。
微桥插件安装包
下载当前提供的插件包。前往下载中心；尚未上架的文件请向管理员获取。
一个用于接入的程序或服务端
微桥本身不提供 AI 对话、自动回复规则或群管理业务，需要由你的程序调用接口实现。
手机与程序之间可用的网络
程序能访问手机，可选 HTTP；只有手机能连接后端，可选长轮询或 WebSocket。
02
按你已有的设备环境选择
安装插件，注入微信。
微信直接从 App Store 下载即可，无需指定版本。先查看设备和系统支持情况，再选择安装方式。
优先推荐巨魔，其次考虑越狱，自签最不推荐。请先通过下方链接确认你的设备是否支持。
Dopamine / 多巴胺越狱
其次考虑- 确认设备已处于可用的越狱环境。
- 使用 Sileo 管理并安装对应插件包。
- 按安装提示完成处理，重新打开微信并检查微桥入口。
包格式与环境需要匹配，不要把其他环境的安装步骤直接套用。
自签或证书签名
自签最不推荐- 准备微信 IPA，供签名工具注入插件。
- 使用轻松签+等工具，将插件注入 IPA。
- 完成 IPA 签名与安装，打开微信检查微桥入口。
无需指定微信版本；自签或证书安装仍需按签名工具的流程准备 IPA，签名有效期由所用方式决定。
本页提供安装路线说明，未列出统一的 iOS 支持区间。具体设备、系统、工具与插件版本的组合，需要以工具说明和维护者确认的适用范围为准。
03
安装后还需要授权
打开微桥，确认可用状态。
1
找到入口
登录微信，在「我 → 设置」页面顶部打开微桥。
2
截图申请
将微桥设置页截图发给管理员，由管理员处理授权。
3
重启并检查
授权完成后重启微信，确认授权状态和有效期。
4
打开总开关
确认账号已登录、授权有效，再开启插件总开关。
插件总开关默认关闭。当前发送、转发与接收事件的有效状态跟随总开关和授权，无需寻找旧版的独立开关。
查看授权价格与联系说明04
先判断网络方向
只选一种主要接入方式。
三种方式都提供业务接口。区别在连接方向，以及你的程序需要实现的通信部分。
HTTP
你的程序能直接访问手机时使用。调用插件已提供的接口，通过 POST /events 拉取事件。
你要填写或确认手机 IP 与实际监听端口
阅读 HTTP 协议 http://<手机IP>:19088长轮询
你的后端适合提供普通 HTTP 服务时使用。实现注册、状态、事件、poll 和命令结果 5 个接口。
插件设置中填写选择长轮询，填写服务端基础地址
阅读长轮询协议 https://<你的服务器>WebSocket
你的后端已支持 WebSocket 时使用。提供一个端点，处理握手、命令、结果、事件与心跳。
插件设置中填写选择 WebSocket，填写完整端点
阅读 WebSocket 协议 wss://<你的服务器>/<端点>配置时容易混淆的地方
- HTTP 可与一个远程通道并用。长轮询与 WebSocket 为单选，同一时刻只运行一种。
- 长轮询填写基础地址。插件会拼接
/agent/*；这些接口由你的服务端实现，手机的 19088 服务不提供它们。 - 无命令时保持 poll 等待。“轮询间隔”默认 20 秒，用于计算请求超时，默认超时 30 秒；不是每隔 20 秒才取一次命令。
- WebSocket 需要按协议握手。填写完整端点，收到
hello后按协议回复hello_ack，并处理心跳与断线重连。 - 插件授权与网络访问控制分开。当前协议没有调用方 API Key 或 Bearer Token 校验；手机 HTTP 应放在可信网络中。
05
先验证链路，再接业务
发送一条消息，接收一个事件。
下面只展示首次自检的入口。完整参数、终态判断和重试规则以你选择的协议为准。
HTTP 自检
把示例中的手机 IP 和端口替换为实际值。以下为 Bash / 终端示例：
1. 检查本地服务
curl http://<手机IP>:19088/health查看 auth_authorized 和 plugin_enabled 等实际状态；仅有 ok: true 不足以证明插件已可用。
2. 发给文件传输助手
curl -X POST http://<手机IP>:19088/send_message \
-H "Content-Type: application/json" \
-d '{"receiver":"filehelper","content":"连通性测试"}'检查接口返回，并在微信里确认实际收到消息。接着调用 POST /events，用另一个账号给手机发消息，处理后保存 next_offset。
长轮询自检
- 启动你按协议实现的后端，在插件中填写基础地址。
- 观察服务端是否收到
register、state、poll。 - 在 poll 响应中下发
send_message，等待/agent/command_result，并在微信确认消息。 - 给手机发送一条消息，确认
/agent/event到达服务端并成功保存。
使用远程通道时，直接通过该通道验证，不要求后端先能访问手机 HTTP。
查看长轮询完整接入说明WebSocket 自检
- 启动你按协议实现的 WebSocket 服务，填入完整端点。
- 确认收到
hello，正确回复hello_ack并观察心跳。 - 发送带有
send_message的命令帧，等待command_result，在微信确认消息。 - 给手机发送一条消息，确认收到
event帧并成功保存。
正常路径跑通后，再检查断线恢复和去重。请求受理不总是业务完成；结果未知时先查询或核实，不要直接换一个请求 ID 重复提交。
06
准备长期运行
配置保活、暂存与日志。
后台保活
长期后台运行建议开启保活总开关，再选择音频或定位通道。音频子项默认开启、定位默认关闭；定位需要在微信前台启动并取得相应权限，可能增加耗电。
保活有助于后台执行，系统仍可能因低内存等原因结束微信。配置已开启，也不代表通道此刻正在运行。
断线事件暂存
远程通道默认开启断线暂存，默认保留 500 条、120 秒，容量上限为 5000 条。若服务端可能停机超过 2 分钟，请调整保留时间与容量。
HTTP 事件使用独立的进程内缓冲区。暂存受容量和时限影响，不能保证无限补发；恢复后仍需要处理重复事件。
崩溃前发送日志
可选开启，尝试向“日志接收 wxid”发送异常线索；默认目标是文件传输助手，留空则只写本地日志。希望管理员接收时，需要填写实际接收目标。
无法保证每次退出前成功发送。排错时也可使用设置页的日志导出，并在分享前检查敏感内容。
07
按现象定位问题
没有跑通？先检查这几处。
没有微桥入口
核对注入是否完成、插件与微信版本是否匹配，重新打开微信。仍未出现时，记录设备环境与版本信息联系管理员。
入口能打开，但接口不可用
确认当前账号已登录、授权有效且总开关已开启。授权后按管理员说明重启微信，再检查实际状态。
连不上后端或手机
按所选模式检查连接方向、IP、端口、协议前缀与服务端监听。HTTP 看手机实际端口；长轮询看基础地址；WS 看完整端点与握手。
请求成功，但没看到预期效果
查看业务返回与异步终态，在微信确认效果。超时或结果未知时，按对应接口核实状态与重试边界。
准备好接入你的业务了？
进入文档中心，选择一种模式阅读完整参数与示例。