feat: 监控页按名称排序 + 按钮改「看屏 / 打开设备端 Agent」；设备名匹配补 USB 设备
用户反馈的三件事：
1) **监控页设备排序**改成按**名称**（A01/A02/…），没名字的排最后按地址。
之前是 adb 返回的顺序，看着像按 IP 排，同型号多台时对不上号。
排序放在 `/api/status`（后端），大屏页一并受益。
2) **操作按钮改名 + 换实现**：
- 「截图」→「**看屏**」（行为不变，就是查看设备实时画面）
- 「定位」→「**打开设备端 Agent**」：改成让设备上的 Agent 弹身份大字页
（名称/IP/平台地址），替代原来"推 HTML 让设备浏览器打开定位页"那套
（那套要设备装浏览器、页面还依赖设备能访问平台，backlog A1/A2 一直没修）
* 新接口 `POST /api/agent/show-info {serial, close?}`；没装 Agent 时明确报出来
* **先点亮屏幕 + 解除锁屏再拉起** —— 设备息屏时 am start 会把大字页开在锁屏后面，
人看到的还是一片黑（实测踩过）
* 平台地址取操作者当前访问地址；若是 localhost 则换成本机局域网地址
（设备上显示 127.0.0.1 毫无意义）
3) **安装应用的选择设备界面仍显示裸序列号**：USB 设备在 adb 里的 serial 就是
`ro.serialno`，等于池里那条网络记录的**指纹** —— 之前只按 serial 匹配，插着 USB
时会冒出一个没名字的 `s8o7nrt8pbzhfadq`。现在按 serial 或指纹任一命中都取名称，
三处（剪贴板注入 / 安装弹窗 / 安装进度表）统一。
顺带修掉几个自己踩出来的坑：
- `device_pool.list_configured()` 返回的是 **serial 字符串列表**，我当成字典用了
（`.get("serial")` 抛异常被 except 吞掉 → 名字全空）→ 改用 `list_devices()`
- `web/device_agent_api.py` 用了 `PERM_DEVICES` 但没导入 → 服务直接起不来（502）
- Agent 自检里的版本号是写死的常量（升到 1.4 还显示 1.0）→ 改成读包信息
- `doc/API.md` 章节编号（插了一节没把后面整体下移，出现两个 §16）
验证：安装弹窗里 USB 那台现在显示「A07」（指纹匹配）；监控页按钮为
「看屏 / 打开设备端 Agent」；对装/未装 Agent 的设备分别得到大字页 / 明确报错；
大字页实测显示 A07 + 192.168.20.250:18050 + Agent v1.4。
This commit is contained in:
+10
-8
@@ -21,9 +21,10 @@
|
||||
- [11. 运维工具（adb / 剪贴板 / 应用版本 / Tailscale）](#11-运维工具adb--剪贴板--应用版本--tailscale)
|
||||
- [12. AI 控制台](#12-ai-控制台)
|
||||
- [13. 系统备份](#13-系统备份)
|
||||
- [14. 非 JSON 响应汇总](#14-非-json-响应汇总)
|
||||
- [15. 错误分支速查](#15-错误分支速查)
|
||||
- [16. 已知问题](#16-已知问题)
|
||||
- [14. 设备端应用商店](#14-设备端应用商店)
|
||||
- [15. 非 JSON 响应汇总](#15-非-json-响应汇总)
|
||||
- [16. 错误分支速查](#16-错误分支速查)
|
||||
- [17. 已知问题](#17-已知问题)
|
||||
|
||||
---
|
||||
|
||||
@@ -48,14 +49,14 @@
|
||||
### 1.3 CSRF
|
||||
|
||||
- `GET /api/csrf` 取 token（存在 session）；前端对所有非 GET 请求带 `X-CSRF-Token`。
|
||||
- ⚠️ **当前服务端并未强制校验**（`web_server.py` 只 import 了 `_csrf_protect`，没有注册 `before_request`）。即 token 已签发、前端已携带，但**伪造请求不会被拦**。见 [§16 已知问题](#16-已知问题)。
|
||||
- ⚠️ **当前服务端并未强制校验**（`web_server.py` 只 import 了 `_csrf_protect`，没有注册 `before_request`）。即 token 已签发、前端已携带，但**伪造请求不会被拦**。见 [§17 已知问题](#17-已知问题)。
|
||||
|
||||
### 1.4 响应约定
|
||||
|
||||
- 绝大多数接口返回 **JSON**：成功 `{"ok": true, ...}`，失败 `{"ok": false, "error": "中文原因"}`（部分接口额外带 `msg`）。
|
||||
- **HTTP 状态码与 `ok` 并存**：参数错误用 400，权限 403，不存在 404，冲突 409，依赖不可用 502/503。少数接口用 `{"ok":false}` + HTTP 200（如 `POST /api/jobs/<id>/run` 的"任务类型不存在"）。以本文每节标注为准。
|
||||
- 时间统一字符串：`"YYYY-MM-DD HH:MM"`（展示）或 `"YYYY-MM-DD HH:MM:SS"`（cron 相关）。
|
||||
- 非 JSON 接口（HTML / 图片 / SSE / MJPEG / zip）见 [§14](#14-非-json-响应汇总)。
|
||||
- 非 JSON 接口（HTML / 图片 / SSE / MJPEG / zip）见 [§15](#15-非-json-响应汇总)。
|
||||
|
||||
---
|
||||
|
||||
@@ -237,6 +238,7 @@
|
||||
| GET | `/api/agent-store/config` | 读配置（含设备令牌） |
|
||||
| POST | `/api/agent-store/config` | 启用/停用、重置令牌 |
|
||||
| GET | `/api/agent-store/logs` | 设备端安装记录 |
|
||||
| POST | `/api/agent/show-info` | 让设备上的 Agent 显示/关闭**身份大字页**（监控页「打开设备端 Agent」按钮）|
|
||||
|
||||
> 完整协议、鉴权与版本约定见 [DEVICE_AGENT.md](DEVICE_AGENT.md)。
|
||||
|
||||
@@ -749,7 +751,7 @@ multipart 上传 `.zip` 或 `.db`（字段 `file`）→ 校验并暂存：
|
||||
|
||||
| 方法 | 路径 | 响应类型 | 说明 |
|
||||
|------|------|---------|------|
|
||||
| GET | `/` `/wall` `/login` `/locate` | `text/html` | 四个页面（`/locate` 免登录） |
|
||||
| GET | `/` `/wall` `/login` `/locate` | `text/html` | 四个页面（`/locate` 免登录；**已被设备端 Agent 的身份页取代**，仅作历史保留）|
|
||||
| GET | `/api/device/screenshot` | `image/png` | 原始截图（`Cache-Control: no-store`） |
|
||||
| GET | `/api/screen/thumb` | `image/jpeg` | 360px 缩略图 + `X-Screen-State` |
|
||||
| GET | `/api/screen/stream` | `multipart/x-mixed-replace` | MJPEG 实时流 |
|
||||
@@ -759,7 +761,7 @@ multipart 上传 `.zip` 或 `.db`（字段 `file`）→ 校验并暂存：
|
||||
|
||||
---
|
||||
|
||||
## 15. 错误分支速查
|
||||
## 16. 错误分支速查
|
||||
|
||||
| 码 | 典型触发 |
|
||||
|----|---------|
|
||||
@@ -775,7 +777,7 @@ multipart 上传 `.zip` 或 `.db`（字段 `file`）→ 校验并暂存：
|
||||
|
||||
---
|
||||
|
||||
## 16. 已知问题
|
||||
## 17. 已知问题
|
||||
|
||||
| 问题 | 影响 | 位置 |
|
||||
|------|------|------|
|
||||
|
||||
Reference in New Issue
Block a user