From 0bed6441d8be7592cf6e36be5ae8b6bbc3f4af4a Mon Sep 17 00:00:00 2001 From: fnvtk Date: Fri, 15 May 2026 16:01:52 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=96=B0=E5=A2=9EFrida=E6=8E=A5?= =?UTF-8?q?=E5=8F=A3=E5=BC=80=E5=8F=91=E4=B8=8E=E5=AF=B9=E6=8E=A5=E8=BF=9B?= =?UTF-8?q?=E5=BA=A6=E6=96=87=E6=A1=A3=EF=BC=882026-05-15=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../10、项目管理/Frida接口开发与对接进度.md | 119 ++++++++++++++++++ 1 file changed, 119 insertions(+) create mode 100644 开发文档/10、项目管理/Frida接口开发与对接进度.md diff --git a/开发文档/10、项目管理/Frida接口开发与对接进度.md b/开发文档/10、项目管理/Frida接口开发与对接进度.md new file mode 100644 index 0000000000..2ee77cda82 --- /dev/null +++ b/开发文档/10、项目管理/Frida接口开发与对接进度.md @@ -0,0 +1,119 @@ +# Frida 接口开发与存客宝对接进度 + +> **最后更新**：2026-05-15 08:00 (GMT+8) +> **总开发进度**：52% +> **本阶段进度**：100%（存客宝对接核心模块完成） + +--- + +## 1. 项目背景 + +工作手机 SDK 通过 Frida Hook 技术实现对微信的深度控制，并将获取的客户数据上报至存客宝（CKB）CRM 系统，实现私域流量的自动化管理。 + +--- + +## 2. 已完成功能（截至 2026-05-15） + +### 2.1 Frida Hook 核心（wechat_hook_v2.js） +- 110 个操作 / 24 模块（v3.1） +- 消息收发、联系人管理、群管理、朋友圈、支付、视频号等全功能覆盖 +- 版本适配：8.0.44 ~ 8.0.60，含 default 兜底 + +### 2.2 存客宝专项 Hook 扩展（wechat_hook_ckb_patch.js）✅ 新增 + +| 功能 | 方法名 | 状态 | +|------|--------|------| +| 联系人详细信息（含标签/性别/地区） | `getContactsDetail` | ✅ 完成 | +| 单个联系人详情 | `getContactDetail` | ✅ 完成 | +| 群成员详细信息（含联系人信息） | `getGroupMembersDetail` | ✅ 完成 | +| 新好友添加事件监听 | `startFriendAddListener` | ✅ 完成 | +| 群成员加入事件监听 | `startGroupMemberListener` | ✅ 完成 | +| 批量同步通讯录到存客宝 | `batchSyncContacts` | ✅ 完成 | + +### 2.3 存客宝后端服务（cunke_bao_service.py）✅ 新增 + +- 双重 MD5 签名算法（符合存客宝规范） +- 异步 HTTP 请求（aiohttp + 指数退避重试） +- 速率限制器（滑动窗口，默认 60次/分钟） +- 线索上报（report_lead） +- 新好友事件上报（report_friend_add） +- 群变动事件上报（report_group_change） +- 批量联系人上报（batch_report_contacts） +- 服务统计（get_stats） + +### 2.4 存客宝 API 路由（cunke_bao.py）✅ 新增 + +| 方法 | 路径 | 说明 | +|:----:|------|------| +| POST | `/api/v3/cunke-bao/config` | 设置 API Key 等配置 | +| GET | `/api/v3/cunke-bao/config` | 查询配置（脱敏） | +| GET | `/api/v3/cunke-bao/stats` | 服务统计 | +| POST | `/api/v3/cunke-bao/report-lead` | 手动线索上报 | +| POST | `/api/v3/cunke-bao/batch-contacts` | 批量联系人上报 | +| POST | `/api/v3/cunke-bao/hook/friend-add` | 新好友事件接收 | +| POST | `/api/v3/cunke-bao/hook/group-change` | 群变动事件接收 | +| POST | `/api/v3/cunke-bao/hook/batch-events` | 批量事件接收 | + +--- + +## 3. 待完成任务 + +### Phase 2: 设备端核心（进行中） + +| 任务ID | 描述 | 优先级 | 状态 | +|:------:|------|:------:|:----:| +| H18-H22 | 微信Hook(好友/群) | P1 | 待开始 | +| H23 | Syscall拦截 | P2 | 待开始 | +| H24 | 版本适配优化 | P1 | 进行中 | +| H25-H29 | 模块管理API | P1 | 待开始 | +| H30-H33 | 测试 | P1 | 待开始 | + +### Phase 3: 存客宝对接（进行中） + +| 任务ID | 描述 | 优先级 | 状态 | +|:------:|------|:------:|:----:| +| B-CKB-5 | 错误处理与日志记录完善 | P1 | 待开始 | +| B-CKB-6 | 安全性增强（API Key持久化、频率限制） | P1 | 待开始 | + +### Phase 4: 管理端前端（待开始） + +| 任务ID | 描述 | 优先级 | 状态 | +|:------:|------|:------:|:----:| +| F-CKB-5 | 存客宝配置界面 | P1 | 待开始 | +| F-CKB-6 | 对接状态和日志展示 | P1 | 待开始 | +| F-CKB-7 | 手动触发线索上报 | P2 | 待开始 | + +### Phase 5: 测试（待开始） + +| 任务ID | 描述 | 优先级 | 状态 | +|:------:|------|:------:|:----:| +| D-CKB-1 | 单元测试和集成测试 | P0 | 待开始 | +| D-CKB-2 | 端到端测试（Frida→后端→存客宝） | P0 | 待开始 | +| D-CKB-3 | 更新部署脚本和文档 | P1 | 待开始 | + +--- + +## 4. 下一步执行计划 + +1. **版本适配优化**：完善 `wechat_version_compat.json`，增加 8.0.62+ 版本支持 +2. **性能监控**：在 `HookExecutor` 中增加执行耗时统计 +3. **存客宝配置持久化**：将 API Key 存储到 Redis/MongoDB，重启后自动恢复 +4. **前端管理界面**：在 hub.html 中添加存客宝配置和状态展示页面 +5. **端到端测试**：验证 Frida Hook → 后端服务 → 存客宝的完整链路 + +--- + +## 5. 相关文件链接 + +| 文件 | 说明 | +|------|------| +| [cunke_bao_service.py](../6、后端/cunke_bao_service.md) | 存客宝服务实现 | +| [cunke_bao.py](../5、接口/cunke_bao_router.md) | 存客宝路由实现 | +| [wechat_hook_ckb_patch.js](../6、后端/wechat_hook_ckb_patch.md) | Hook扩展实现 | +| [存客宝对接规范.md](../5、接口/存客宝对接规范.md) | 存客宝API规范 | +| [项目落地执行表.md](../10、项目管理/项目落地执行表.md) | 项目整体进度 | + +--- + +**当前总开发进度：52%** +**当前阶段进度：100%（存客宝对接核心模块）**