WeChatBotTweak 是一个运行在设备本地的轻量服务，把消息收发、通讯录、朋友圈与群协作 封装成统一、易调用的接口。数据留在自己的网络里， 任何语言、任何系统都能快速接入。
仅供技术学习与私有化自动化研究 · 请勿用于群发营销或违反微信软件许可及服务协议的用途
个开箱即用的对外接口
消息全覆盖，收发与取流一体
发送方式，覆盖日常沟通场景
未激活也能完整试用
第三方云端中转，数据本地闭环
它解决的不是「能不能发一条消息」，而是「能不能放心、稳定、长期地把微信纳入自己的自动化流程」。
服务运行在设备本地，消息、图片、文件都不经过第三方服务器；只在受信任的网络内对外开放，适合对数据边界有要求的场景。
消息由微信自身的收发通道完成，发送效果、显示样式和手动操作一致，不依赖模拟点击，也不需要维护额外的账号协议。
退到后台自动保持服务，异常中断有自愈与提醒；消息同时提供实时推送和随时补拉，断网也不会漏掉已产生的记录。
标准 HTTP 接口与统一返回格式，配置在微信内可视化完成；随包附带示例客户端，从安装到跑通第一个流程只需几步。
按业务场景分为五组，能力之间可以自由组合。点击标签切换查看。
文字、图片、语音、视频、文件、链接、表情、引用、卡片消息统一接入；群里的 @ 会自动整理成「谁被提到、是否 @ 我、是否 @ 所有人」等清晰字段。
按会话读取最近消息，本地自动留档并控制占用上限；即使实时推送中断，也能随时回来补拉，不必担心数据断档。
自动匹配当前最清晰的可用版本，尚未就绪时会在请求里主动补齐，无需手动点开或重启；视频、语音、文件都以可直接使用的格式返回。
每条新消息即时推送到你指定的服务地址；服务异常、授权到期等提醒走独立通道，业务消息与运维告警互不干扰。
一次刷新即可拿到全量联系人，之后查询都走本地缓存，速度快、对微信无额外负担；换账号、改备注都能重新同步。
列出所有群聊与群内成员，自动使用群内展示名；既可按群查人，也可按人反查所在的群。
按昵称、备注或 ID 反查好友与群，结果结构统一，前端、机器人、工单系统都能直接拿来用。
好友、群聊、公众号自动归类，不需要预先配置白名单或硬编码账号，人员变动后重新同步即可。
读取最新时间线，也能查看指定好友的主页；支持一页页往回翻，想看最新时随时回到起点，翻页节奏完全由你的程序决定。
每条动态都带正文、发布时间、作者、点赞与评论明细，信息流广告默认自动剔除，也可选择保留自行处理。
朋友圈图片可取清晰原图，视频返回可直接播放的文件；常用内容会提前准备，读取后即可下载，不必先手动点开。
点赞、取消赞、发表评论、删除本人评论都支持；执行前可先预演确认，重复提交也有保护，避免误操作。
文字、引用回复、图片、语音、视频、文件覆盖日常沟通；既可直接传内容，也可使用设备上已有的文件，格式自动识别。
支持 @ 指定成员、@所有人以及引用回复叠加 @；群内显示名自动匹配，不必手工维护成员对照表。
读取当前群公告，也可发布新公告；发布默认先预演，确认后才真正通知群成员，避免误发。
会产生真实动作的调用都支持预演，参数不合法会被直接拒绝；发送、点赞、评论等动作均可带唯一标识，超时重试不会重复执行。
在微信「我 → 设置」中打开插件设置页，即可集中管理服务、消息、后台与状态，端口、访问令牌、推送地址等即改即生效，无需连电脑改文件。
微信退到后台仍保持服务可用，服务中断会自动恢复；进程被结束后会有本地提醒，并可同步通知到你的告警地址。
未激活即可完整试用 90 天；激活码一机一号、不可共用，到期前会分阶段提醒，状态与激活都能在设置页或接口中查询。
健康检查随时可查版本、监听状态与微信就绪情况；配合示例客户端，几分钟就能确认整套服务是否正常工作。
都是日常自动化里最容易踩坑的地方，产品里已经替你处理好。
文字到文件、卡片到引用，统一格式输出，业务侧不用为每种消息各写一套解析逻辑。
自动挑最清晰的可用版本，没准备好就主动补齐，不用先去手机上点开，也不用等重启。
浏览、翻页、取图、点赞、评论、删评在同一套能力里，流程不用东拼西凑。
@成员、@所有人、引用回复与群公告都齐备，群名片自动匹配，贴近真实使用习惯。
真实动作支持先预演，非法参数直接拒绝，超时重试有重复保护，不会误发、不会连发两条。
后台持续可用，服务中断自动恢复，掉线与授权状态主动提醒，长期挂着也放心。
常用开关都在微信里的设置页，改完立即生效；不需要连设备、不需要改配置文件。
成功与失败格式一致，提示语直白，不夹带内部实现信息，对接和排错都更省时间。
按消息形态、业务范围、链路方向三个维度核对，避免只覆盖演示场景里的那一种消息。
| 维度 | 覆盖内容 | 能力标签 |
|---|---|---|
| 消息形态 | 文字、图片、语音、视频、文件、链接、表情、引用、卡片消息 | 接收 发送 取回 |
| 会话范围 | 单聊、群聊、公众号；群内 @ 识别、成员显示名、成员与好友反查 | 全场景 |
| 通讯录 | 全量好友、群列表、群成员、好友明细、按名称或 ID 反查 | 可查可用 |
| 朋友圈 | 时间线与好友主页浏览、图片视频取用、点赞 / 评论 / 删除、广告过滤、互动明细 | 读 + 写 |
| 群协作 | 六种发送、@某人、@所有人、引用回复、群公告读取与发布 | 发布前预演 |
| 事件与告警 | 新消息实时推送、掉线 / 授权 / 地址测试独立提醒、消息随时补拉兜底 | 实时 + 补拉 |
| 运行保障 | 健康检查、后台常驻、服务自愈、掉线提醒、访问鉴权、授权与试用管理 | 长期稳定 |
接口契约稳定、失败原因清晰、配置与部署都留了余地，接进现有系统不需要改产品本身。
# 1) 确认服务就绪
curl -s -H "X-Token: $TOKEN" "$BASE/api/health"
# 2) 读取最近消息
curl -s -H "X-Token: $TOKEN" "$BASE/api/messages?chat=<会话ID>&limit=20"
# 3) 发送一条消息
curl -s -X POST "$BASE/api/send/text" -H "X-Token: $TOKEN" \
-H "Content-Type: application/json" \
-d '{"chat":"<会话ID>","text":"你好"}'面向长时间挂机的使用场景，从访问控制、动作安全到真机验证，都按"不会误操作、不会轻易掉线"的标准设计。
全部在真实设备上完成验证；验证过程不向真实会话发送测试内容，也不会产生点赞、评论等社交动作。
适用于已越狱的 iOS 设备；安装、配置、调用，不需要额外服务器或第三方账号。
按设备环境选择对应安装包，安装完成后重启微信，服务即随微信一起启动。
进入微信「我 → 设置」，打开插件设置页，设置访问令牌、推送地址与后台提醒，保存后立即生效。
先做一次健康检查，再读取会话与消息、发送第一条内容；需要实时性就打开消息推送。