fix

README.md

@@ -1,178 +1,136 @@
 # WeChatIntercept
 
-macOS 微信防撤回工具，持续更新，欢迎star。
+macOS 微信防撤回工具，支持微信 4.1.x 系列，欢迎共建和 star。
-
-## 最新版本
-
-**支持微信 4.1.x 系列**，适配微信全新 C++ 架构，通过 DYLD 运行时注入实现防撤回。内置**特征码自动寻址**机制，应对微信动态更新。
-
-### 功能
-
-- 对方撤回的消息保留可见
-- 自己撤回正常工作
-- 撤回时弹出 macOS 系统通知（显示谁撤回了消息，含用户昵称）
-- 通知开关可随时切换
-- 微信动态更新后自动适配（特征码搜索）
-
-### 原理
-
-通过注入运行时 hook 动态库（`WeChatAntiRevoke.dylib`），拦截微信内部的 `isRevokeMessage()` 函数：
-
-- 对方撤回 → 返回 false（消息保留）+ 弹出通知
-- 自己撤回 → 返回 true（正常处理）
-
-通过读取当前登录用户 ID（完整字符串匹配），精确区分自己与对方。
-
-Hook 安装采用三级查找策略：
-1. **快速路径**：硬编码地址 + 完整 5 条指令特征码验证
-2. **特征码搜索**：扫描 `wechat.dylib __TEXT` 段，自动定位新版本函数地址
-3. **fallback**：4.1.9 dispatch slot 写入
-
-### 适用范围
-
-- macOS 微信 4.1.x 系列（4.1.9 / 4.1.10 已验证，更新版本依赖运行时自动寻址）
-- Apple Silicon（arm64）及 Intel（x86_64）
-- macOS Sequoia / Sonoma / Ventura / Tahoe 等（自动处理 provenance 限制）
-
-### 使用
-
-```bash
-chmod +x patch.sh         # 添加可执行权限
-./patch.sh                # 安装防撤回
-./patch.sh openNotify     # 开启撤回通知
-./patch.sh closeNotify    # 关闭撤回通知
-./patch.sh --uninstall    # 卸载
-./patch.sh --help         # 帮助
-```
-
-首次运行可能需要约 30 秒（自动解除系统文件保护并重签名）。
-
-### 配置
-
-配置文件路径：`~/.config/antirevoke/config`
-
-```ini
-notify=1    # 1=开启撤回通知, 0=关闭
-```
-
-安装时默认开启通知，也可通过命令随时切换：
-
-```bash
-./patch.sh openNotify     # 等同于设置 notify=1
-./patch.sh closeNotify    # 等同于设置 notify=0
-```
-
-修改后立即生效，无需重启微信。
-
-#### 注意：需要给脚本编辑器打开通知权限！！！
-<img width="912" height="108" alt="image" src="https://github.com/user-attachments/assets/5865c263-7511-4b58-92a0-e69edba54f3d" />
-
-
-### 依赖
-
-macOS 系统自带工具，无需额外安装：
-- clang（Xcode Command Line Tools）
-- python3
-- codesign
-- tar
-
-如未安装 Xcode Command Line Tools，运行：`xcode-select --install`
-
-### 调试
-
-```bash
-./patch.sh --debug        # 调试模式（不安装 hook，仅签名允许 lldb attach）
-cat /tmp/antirevoke_debug.log   # 查看运行时日志
-```
-
-### 微信版本更新后
-
-微信支持动态更新（无需经过 App Store），更新后 build 号变化可能导致 hook 失效。
-
-脚本会自动应对：
-
-1. **特征码动态搜索**：当硬编码地址失效时，自动扫描 `wechat.dylib` 的 `__TEXT` 段查找 `isRevokeMessage` 函数特征码。微信小版本更新（仅函数地址改变、实现不变）的情况下，**自动适配，无需任何操作**。
-
-2. **大版本校验放宽**：脚本只校验 `CFBundleShortVersionString` 是否为 `4.1.x`，不再依赖精确 build 号。新 build 号（如 4.1.11）也能正常安装，运行时通过特征码自动寻址。
-
-3. **失败提示**：如果特征码也匹配不到（微信改了实现），系统通知会弹出提示：
-   - `WeChatIntercept 需更新` — 微信版本号变化（如 4.1.10 → 4.1.11），需要更新脚本
-   - `WeChatIntercept 异常` — 已适配的 build 号但仍失败（极罕见）
-
-4. **消息对象偏移失效**：如果 `msg+0x18` 偏移读取的 sender ID 持续出现非可打印 ASCII 内容，累计达到阈值后会弹出 `"快去催 WeChatIntercept 作者更新适配"` 通知。日常对方撤回的多次调用不会误触发。
-
-### 排查步骤
-
-如果防撤回功能不生效：
-
-1. 查看运行时日志：`cat /tmp/antirevoke_debug.log`
-2. 关键日志说明：
-   - `[已适配]` — build 号在已知列表，安装应该成功
-   - `[未适配]` — build 号未知，靠运行时自动寻址
-   - `快速路径命中` — 硬编码地址有效，正常工作
-   - `特征码搜索找到` — 自动找到新地址，正常工作（说明微信地址变了但实现没变）
-   - `hook 安装失败` — 需要更新脚本，请前往 GitHub 检查最新版本或提交 issue
-3. 提交 issue 时附带：
-   - 微信版本：`defaults read /Applications/WeChat.app/Contents/Info.plist CFBundleShortVersionString` 与 `CFBundleVersion`
-   - 调试日志：`/tmp/antirevoke_debug.log`
-
-### 已知限制
-
-- **聊天框内无撤回提示**：由于微信 4.x 的架构限制（C++ 实现 + 符号 strip + 数据库加密），无法在聊天界面内插入系统消息。替代方案为 macOS 系统通知。
-
-- **为什么不能像旧版那样在聊天框内显示提示？**
-
-  旧版微信 macOS（3.x）使用 Objective-C，可通过 Method Swizzling 调用内部消息插入 API。4.x 版本核心逻辑全部迁移到 C++（仅剩 65 个 ObjC 类，90MB+ 代码段，符号已 strip），撤回处理通过虚函数 + 加密数据库 + 协程调度完成，无法稳定地从外部构造调用链插入消息。
-
-### 风险说明
-
-1. 微信每次升级后，地址、结构体字段、运行时行为都可能变化，补丁可能立即失效。脚本内置特征码自动寻址机制可应对函数地址变化，但无法应对函数实现/消息对象结构的根本变化。
-
-2. 本项目仅承诺仓库内标明的已验证版本（4.1.9 / 4.1.10）；4.1.x 系列其他 build 号通过运行时自动寻址尽力支持，但不保证 100% 兼容。
-
-3. 本项目仅用于技术研究与兼容性分析，请自行承担使用风险。
 
 ---
 
-## 旧版本
+## 功能
 
-支持微信 3.7.0 及更早版本，基于 DYLD 注入 + Method Swizzling，支持撤回提示和自定义前缀。
+| 功能     | 说明                                                                     |
+| -------- | ------------------------------------------------------------------------ |
+| 防撤回   | 对方撤回的消息保留可见，自己撤回正常工作                                 |
+| 撤回通知 | 弹出 macOS 系统通知，显示谁撤回了什么内容                                |
+| 消息原文 | 通知中展示被撤回的原始消息（消息内容文本 / [图片] / [视频] / [文件] 等） |
+| 自动适配 | 内置特征码搜索，微信小版本更新后无需手动操作                             |
 
-### 功能
+通知效果：
 
-1. 防撤回（支持聊天框内拦截提示）
+- `拦截到「张三」撤回了一条消息：你好`
-2. 免认证登录
+- `拦截到「张三」撤回了一条消息：[图片]`
-3. 拦截提示语自定义前缀
+- 拿不到原文时降级：`拦截到「张三」撤回了一条消息`
+
+---
+
+## 快速开始
+
+```bash
+# 1. 安装防撤回（必须）
+chmod +x patch.sh
+./patch.sh
+
+# 2. 安装消息监听（可选，撤回通知带原文）
+./patch.sh --monitor-install
+```
+
+完成。微信会自动重启，之后对方撤回消息时你会收到系统通知。
+
+---
+
+## 命令一览
+
+| 命令                             | 作用                                   |
+| -------------------------------- | -------------------------------------- |
+| `./patch.sh`                     | 安装防撤回                             |
+| `./patch.sh --monitor-install`   | 安装消息监听（后台自动运行，开机自启） |
+| `./patch.sh --monitor-status`    | 查看监听状态                           |
+| `./patch.sh --monitor-uninstall` | 卸载消息监听                           |
+| `./patch.sh --uninstall`         | 卸载防撤回                             |
+| `./patch.sh --help`              | 查看帮助                               |
+
+---
+
+## 适用范围
+
+- macOS 微信 4.1.x（4.1.9 / 4.1.10 已验证）
+- Apple Silicon（arm64）+ Intel（x86_64）
+- macOS Sequoia / Sonoma / Ventura / Tahoe
+
+---
+
+## 依赖
+
+macOS 系统自带，无需额外安装：
+
+- clang / python3 / codesign / lldb（Xcode Command Line Tools）
+
+如未安装：`xcode-select --install`
+
+---
+
+## 注意事项
+
+1. **首次运行**约需 30 秒（解除系统文件保护 + 重签名）
+2. **通知权限**：需给「脚本编辑器」开启通知权限，否则看不到弹窗  
+   <img width="912" height="108" alt="image" src="https://github.com/user-attachments/assets/5865c263-7511-4b58-92a0-e69edba54f3d" />
+3. **微信动态更新**：微信存在动态更新机制，版本号不变，但方法地址会变，重新运行`./patch.sh`即可，脚本会自动寻址
+4. **消息原文覆盖率**：私聊 + 大部分群聊可正常获取；部分群聊因对象结构差异会降级为不带原文（后续优化）
+
+---
+
+## 排查
+
+防撤回不生效时：
+
+```bash
+cat /tmp/antirevoke_debug.log         # 查看 hook 安装日志
+cat /tmp/wechat_monitor_daemon.log    # 查看消息监听日志
+./patch.sh --monitor-status           # 查看监听状态
+```
+
+关键日志含义：
+
+- `快速路径命中` / `特征码搜索找到` → hook 安装成功
+- `hook 安装失败` → 微信版本变化较大，需更新脚本
+
+提交 issue 时请附带微信版本和日志文件。
+
+---
+
+## 卸载
+
+```bash
+./patch.sh --monitor-uninstall   # 卸载消息监听（如安装过）
+./patch.sh --uninstall           # 卸载防撤回，恢复原始微信
+```
+
+---
+
+## 调试（开发者）
+
+```bash
+./patch.sh --debug     # 仅签名允许 lldb attach，不装 hook
+./patch.sh --monitor   # 前台运行消息监听（Ctrl+C 退出）
+```
+
+---
+
+## 风险说明
+
+1. 微信升级后补丁可能失效，脚本内置自动寻址尽力兼容，但无法应对函数实现的根本变化
+2. 仅承诺已验证版本（4.1.9 / 4.1.10），其他 build 号尽力支持
+3. 仅用于技术研究，请自行承担使用风险
+
+---
+
+## 旧版本（微信 3.7.0）
+
+支持微信 3.7.0 及更早版本，基于 Method Swizzling，支持聊天框内撤回提示 + 自定义前缀。
 
 <img width="301" alt="image" src="https://user-images.githubusercontent.com/18585610/159691061-3f24b69f-a494-4549-a530-7724b1b40060.png">
 
-### 微信 v3.7.0 下载
+```bash
+# 安装：将 Install.sh 拖到终端执行
+# 卸载：将 Uninstall.sh 拖到终端执行
+```
 
-[微信 v3.7.0 版本](https://dldir1.qq.com/weixin/mac/WeChatMac.dmg)
+[微信 v3.7.0 下载](https://dldir1.qq.com/weixin/mac/WeChatMac.dmg)
-
-### 使用方法
-
-- **安装**：cd 到 WeChatIntercept 文件夹，将 `Install.sh` 拖到终端，输入密码回车，重启微信。
-- **卸载**：将 `Uninstall.sh` 拖到终端回车。
-- **自定义前缀**：安装成功后重启微信，屏幕左上角微信菜单栏有个小助手菜单，修改后点击关闭即可。
-
-### 常见问题
-
-1. **无法打开 "insert_dylib"，因为无法验证开发者**
-
-   在系统安全性与隐私处点击允许。
-
-2. **截屏无法使用，已添加屏幕录制权限仍不行**
-
-   在系统安全性与隐私中删除微信，重新添加，重启微信即可。（感谢 [Kylelkh](https://github.com/Kylelkh)）
-
-3. **M1 芯片怎么使用**
-
-   安装 Rosetta，在微信属性中勾选"使用 Rosetta 打开"。（感谢 [Mercury2699](https://github.com/Mercury2699)、[bolosea](https://github.com/bolosea)）
-
----
-
-## 注意
-
-- 微信更新后需重新运行 `./patch.sh`
-- 仅供学习研究用途