docs: 初始化项目落地执行表

This commit is contained in:
2026-05-11 17:06:19 +08:00
parent 9118df9eee
commit bdb0b9a659

View File

@@ -0,0 +1,49 @@
# 项目落地执行表
> **人设**Atlas (Manus QA Owner)
> **对话链接**[点击查看审计对话](https://manus.im/share/current-task-link)
> **更新时间**2026-05-11 10:00 (GMT+8)
> **总进度**15%
## 一、全链路矩阵表
| 路由/页面 | 用户角色 | 核心目标 | 关键操作 | API | 数据表 | 状态 |
|----------|----------|----------|----------|-----|--------|------|
| /ws/device/{id} | 设备端 Agent | 建立长连接,维持心跳 | WebSocket 连接, ACK | N/A | devices | 🟡 测试中 |
| /api/v3/message/send | 存客宝/触客宝 | 下发微信消息指令 | POST 指令 | unified.py | commands | 🟡 测试中 |
| /api/v3/workbench/overview | 管理员 | 查看全量设备概览 | GET 概览数据 | main.py | devices, stats | 🟡 测试中 |
| /api/v3/hook/data/{id} | 管理员 | 获取 Frida Hook 实时数据 | GET 批量数据 | unified.py | N/A | 🟡 测试中 |
| /install.sh | 运维人员 | 一键部署设备端 Agent | curl \| bash | main.py | N/A | 🟡 测试中 |
## 二、第一批测试定义 (Batch 1)
### 1. 页面/接口WebSocket 设备连接
- **测试目标**:验证设备注册、心跳维持及断线重连逻辑。
- **核心路径**Connect -> Auth -> Heartbeat -> ACK.
- **风险点**:并发连接下的 Redis 锁竞争,长连接内存泄漏。
- **涉及接口**`/ws/device/{device_id}`
### 2. 页面/接口:微信消息下发 (Unified API)
- **测试目标**:验证指令从服务端到设备端的端到端延迟与成功率。
- **核心路径**API Call -> Anti-ban Check -> WS Push -> Device Exec -> Result Return.
- **风险点**:防封逻辑误杀,指令超时未 ACK。
- **涉及接口**`/api/v3/message/send`
### 3. 页面/接口:工作台概览 (Workbench Overview)
- **测试目标**:验证多设备状态聚合的准确性。
- **核心路径**GET Overview -> Data Aggregation.
- **风险点**ADB 扫描阻塞导致接口超时。
- **涉及接口**`/api/v3/workbench/overview`
## 三、缺陷清单 (Defect List)
| ID | 描述 | 优先级 | 状态 | 修复说明 |
|----|------|--------|------|----------|
| BUG-001 | 凌晨时段限流逻辑可能导致紧急指令无法下发 | P1 | 待处理 | 需增加紧急指令白名单 |
## 四、复盘与总结
- **目标&结果**:初始化执行表,建立审计矩阵。达成率 100%。
- **过程**:读取 README 与系统架构,识别核心 M1-M12 模块,定义首批测试点。
- **反思**:项目已达到 98% 进度,审计重点应放在极端情况(并发、断网、限流边缘)。
- **总结**:架构清晰,但 逻辑过于厚重,存在维护风险。
- **下一步执行**:开始 Batch 1 自动化脚本审计。