# 2026-07-14 公网 SDK 完整测试汇总

## 结论

生产 SDK、WSS、宝塔 Frida RPC、15 项微信读类、应用启动、当前应用、真机截图、UI 树、鉴权与 CORS 已通过。朋友圈发布两次失败；其他对外写类尚需确认后执行，不能纳入“全功能成功”。

## 环境

| 项目 | 当前值 |
|---|---|
| 生产地址 | `https://wpsdk.quwanzhi.com` |
| 设备 | Redmi 2312DRAABC / Android 13 |
| 设备 ID | `xgfe65eimrrofyws` |
| 设备 MD5 | `ed25814d9c92b3430696dc96c2142b5f` |
| 微信 | 8.0.69 |
| Agent | 5.0.1 |
| 项目 | `cunkebao` |
| Hook | 宝塔 `server/frida`，96 actions / 26 modules |

## 测试结果

| 分类 | 通过 | 失败/待确认 | 状态 |
|---|---:|---:|---|
| 服务健康与就绪 | 2 | 0 | ✅ |
| 微信安全读类 | 15 | 0 | ✅ |
| 设备控制 | 4 | 0 | ✅ 修复后复验 |
| 外部鉴权 | 4 | 0 | ✅ |
| 浏览器 CORS | 1 | 0 | ✅ 修复后复验 |
| 5 路并发 ping | 5 | 0 | ✅ 全部 HTTP 200 |
| 朋友圈发布 | 0 | 2 次失败 | ❌ 微信提示内容未发表 |
| 其他写类 | 0 | 待人工确认 | ⏳ |

### 微信读类

全部 HTTP 200，通道 `server/frida`：`ping`、`get_hook_status`、`get_wechat_version`、`get_process_info`、`get_profile`、`check_account_status`、`get_device_info`、`get_network_info`、`get_storage_info`、`get_contacts`、`get_groups`、`get_labels`、`get_recent_messages`、`get_safety_center`、`check_restrictions`。

### 设备控制

- `app_start`：通过，公网启动微信。
- `app_current`：初测 404；增加 WS fallback 后 HTTP 200。
- `screenshot`：初测假成功无图片；APK 增加 PNG Base64 后通过，1080×2400。
- `ui_tree`：本轮 HTTP 200；MIUI 特定页面仍可能限制 uiautomator，必须检查正文。

截图证据：`开发文档/8、部署/06-存客宝宝塔/images/公网API真机截图_20260714.png`。

### 鉴权与 CORS

- `/health` 无 Key：200。
- `/api/v3/devices` 无 Key：401；错误 Key：401；正确 Key：200。
- 不存在设备：404“设备不存在”。
- OPTIONS 初测 401；放行预检后复验 200，允许 `X-API-Key`。
- 5 路公网并发 `ping` 全部 HTTP 200，耗时约 3.31 秒，通道均为 `server/frida`；测试后设备仍在线。

### 朋友圈失败

- 配图、文字、公开范围均完成。
- 首次发表及重新发送均提示“内容未发表”。
- 证据：`朋友圈首次发布失败_20260714.png`、`朋友圈重试失败_20260714.png`。

## 本轮修复

1. 控制台统一附加 API Key，401 不再伪装成“0 台设备”。
2. 宝塔侧增加真实 Frida Session/RPC 桥。
3. `/app/current` 对 WS 设备增加 fallback。
4. Android 截图返回完整 PNG Base64，并改用应用缓存解决读取权限。
5. API 鉴权中间件放行 CORS OPTIONS 预检。
6. Android 前台服务增加 AgentEngine 单实例锁，避免重复 START 创建两条 WS。

## 当前错误与风险

| ID | 问题 | 影响 | 当前状态 |
|---|---|---|---|
| `SNS-01` | 朋友圈内容上传失败 | 朋友圈写类不可交付 | 待查账号限制/上传网络 |
| `WS-01` | SDK 重启后曾出现双 Engine | 设备短时离线 | 已修，持续观察 |
| `MIUI-01` | MIUI 普通 ADB/ATX 注入受限 | UI 自动化不稳定 | Root sendevent 可兜底 |
| `WRITE-01` | 发消息等写类未获本轮确认 | 不能声称全量通过 | 等待白名单测试 |

## 验收口径

“HTTP 200”不等于业务成功。必须检查业务字段、通道、真实数据或截图。朋友圈按失败记录；未测试写类不做成功结论。
