📬 read-receipt-tracker

基于 WeKit 的微信 Xposed 模块，已修复 DEX 缓存更新问题，内置已读追踪服务端，无需额外部署服务器，开箱即用。

使用原版 WeKit，配合本项目提供的自建服务器使用。适合已有服务器或想在 Termux/Java 插件中运行服务端的用户。

• 特点：原版 WeKit 不变，服务端独立部署，可选择 Linux / Windows / Termux / Java 插件等多种方式
• 下载：WeKit 原版 Release

轻量级 Java 插件，无需编译 APK，在支持 Java 脚本的微信模块中加载即可使用。包含服务端和客户端两个配套插件：

💡 兼容模块：WeKit、WAuxiliary (WA)、WuYu、HChat 等

📝 使用流程：先装服务端并启动隧道 → 再装客户端并配置服务器地址

源码：plugins/java-read-tracker/ · plugins/read-tracker-client/

Python 后端（推荐）：

git clone https://github.com/gaigebeckmanChristinaJames/read-receipt-tracker.git
cd read-receipt-tracker
pip install flask
python run.py

C++ 后端（高性能）：

apt install meson ninja-build libsqlite3-dev libssl-dev
cd cpp
meson setup builddir && meson compile -C builddir
./builddir/rrtracker-server 5000 receipts.db

一键部署（systemd 托管）：

bash scripts/setup-linux.sh                # 后台托管
bash scripts/setup-linux.sh --foreground   # 前台运行
bash scripts/setup-linux.sh --tunnel       # 自动隧道保活

pip install flask
python run.py

打开 http://localhost:5000 即可访问管理面板。

标准版（含 IP 定位）：

pkg update -y && pkg install curl -y
bash <(curl -fL "https://cdn.jsdelivr.net/gh/gaigebeckmanChristinaJames/read-receipt-tracker@main/scripts/ultimate-setup.sh")

Lite 版（无 IP 定位）：

bash <(curl -fL "https://cdn.jsdelivr.net/gh/gaigebeckmanChristinaJames/read-receipt-tracker@main/scripts/ultimate-setup-lite.sh")

需要公网地址时另开会话：

pkg install cloudflared
cloudflared tunnel --protocol http2 --url http://127.0.0.1:5000

独立的 Android APP，无需 Root / Xposed，安装后直接运行已读追踪服务器，内置 cloudflared 公网隧道和 Web 控制台。零第三方依赖，纯 Android 框架 API。

无需单独部署服务器，直接在微信模块中加载「已读服务器」Java 插件即可，内置 HTTP 服务和 cloudflared 公网隧道。

• 文件名：read-tracker-java-server.zip
• 支持模块：WeKit / WAuxiliary / WuYu / HChat

POST /register
Content-Type: application/json

{ "wxId": "user123", "content": "你好", "createTime": 1700000000000 }

响应：返回 pixel_url，嵌入消息即可追踪。

GET /pixel?wxId=user123&id=xxx

返回 1×1 透明 GIF。

这是 WeKit 的 DEX 缓存问题。本项目提供的修改版 APK 已修复此问题，直接下载 最新版 安装即可。

Java 客户端插件的已读统计需要在浏览器控制台中查看。发送 #消息 后，打开管理面板的浏览器控制台即可看到已读人数。

不一定。有三种选择：

1. WeKit 修改版 APK：内置服务端，完全不需要服务器
2. Java 插件版：内置 cloudflared 隧道，自动获取公网地址
3. 自建服务器：Linux/Windows/Termux/Docker 均可

IP 定位使用三级接口自动备份（ip-api.com → ipwho.is → ipinfo.io），如果都不准确可以用 ENABLE_GEO=0 关闭定位功能。