 butubb
|
3422b4f265
|
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。
|
2026-09-13 17:18:30 +08:00 |
|
|
butubb
|
25e4fbb053
|
feat: 应用列表按包名合并 + 剪贴板/安装/版本管理显示设备名
两件事都是"列表看不清楚"的问题：
1) **同一个应用传多个版本会并排显示多行**（v1.2 / v1.3 各占一行），看着像重复。
现在按 **package_name 合并成一个应用一行**，显示最新版：
- `apk_manager.list_latest()`：版本按 version_code 排序取最新，其余版本放进
`versions` 字段；解析不出包名的 APK 各自独立成行（不硬合并）
- 管理页版本列显示 `1.3（另有 1 个旧版本）`，多一个「清理旧版本」按钮
- 「删除」语义改为**删掉这个应用的所有版本**（行=应用），另给
`?scope=older` 只清理旧版本；老的单条删除行为保留（不带 scope）
- **设备端商店也走同一个列表** —— 手机上不会再看到同一个 App 的 v1.2/v1.3 两行
2) **设备只显示地址**（`192.168.20.100:5555`），同型号多台时分不清是哪一台。
三处补齐设备名（平台给设备起的名字，如 A08），统一「名称 · 地址」：
- 剪贴板注入的设备勾选列表（`/api/adb/devices` 经 `_merged_device_list` 带 name）
- 应用管理的安装弹窗（`/api/apks/install/devices` 带 name）
- 应用版本管理表格（`/api/tools/appver` 结果里带 name）
- 顺带：安装进度表里的「设备」列原来显示**型号**（而且是 STF 时代残留的空 dict），
改为显示设备名
没名字的设备（不在池里）自动回退只显示地址，不显示空占位
验证：上传同包名 v1.1/v1.2/v1.3 三个版本 → 列表只出现一行（v1.3，标注共 4 个版本）、
设备端 bootstrap 也只剩 2 个应用；`scope=older` 只留最新、`scope=package` 整包删除；
三个面板在浏览器里渲染无 JS 报错，devText 有名字/没名字两种形态都正确。
|
2026-09-13 16:29:38 +08:00 |
|
|
butubb
|
fa07ed0804
|
feat(platform): 设备端商店支持"请平台静默装"—— 设备请求、平台走 adb 落地
背景：设备端自己调系统安装器在 MIUI 上要过「继续 → 勾选未经安全检测 → 继续更新」
甚至 ICP 备案检查好几步；而平台用 adb（推送 + pm install）装是**静默**的，实测
升级 2.7s、全新安装 7.9s、336MB 大包也没弹过一次框。
所以给设备端商店补一个"请求平台装"的出口：用户还是在手机上选应用（应用商店体验），
真正干活的是平台，几秒钟装完、零弹窗。
- web/device_agent_api.py 新增 `POST /api/device/agent/install`：
设备带令牌调它 → 平台复用应用管理的安装器（`apk_mgr.install`，本身已是
推送 + pm install、并发 5 台）→ 返回是否受理；失败时设备端自行退回本机安装
- 鉴权与设备识别沿用同一套（令牌 + 指纹），未登记设备拒绝并说明原因
注：设备端 APK 那边的对应按钮改动已暂停（用户决定先不动 Agent），
这个接口属于平台侧能力，先落在本次分支里，等 Agent 恢复时直接可用。
|
2026-09-13 15:38:14 +08:00 |
|
|
butubb
|
dad1af8b0b
|
feat: 设备端应用商店（平台侧）—— Agent 直连拉清单/下载/安装，绕开 MIUI 的 USB 安装拦截
背景：`adb install` 在 MIUI 上被「USB 安装」拦下（USER_RESTRICTED），必须人工点确认；
而**由设备上的 App 自己调系统安装器**走的是普通应用安装流程，不触发那道拦截。
平台侧实现（设备端 Agent APK 在另一个仓库，契约见 doc/DEVICE_AGENT.md）：
- web/device_agent_api.py（新）：
* 设备侧 `/api/device/agent/{bootstrap,apk/<id>,report}` —— 无登录会话，靠
`X-Device-Token`（常量时间比对）鉴权；`X-Device-Fingerprint` 让平台认出是哪台设备
（换 IP 也认得出，并把平台分配的名称回给它）；**默认关闭，关闭时统一 404**，
不暴露接口存在性；只读清单与文件，不返回任何配置/密钥
* 管理侧 `/api/agent-store/{config,logs}` —— 登录 + 应用管理权限；启用时自动生成令牌，
可一键重置（旧令牌立即失效）
- core/models.py：新增 `device_install_log`（下载/安装记录，自动裁剪保留 500 条）
- 应用管理页新增「📱 设备端应用商店」面板：开关 / 接入地址 / 令牌（复制·重置）/ 安装记录；
面板里写明它与「平台批量推送」的分工
- doc/DEVICE_AGENT.md（新）：**两个仓库共享的接口契约** —— 接入流程、三个设备接口的
完整规格与错误码、adb 指令协议（剪贴板/身份显示/配置下发）、版本兼容约定、安全须知；
API.md、DATA_MODEL.md、doc/README.md 索引同步
验证：
- 后端 9 组用例：默认关闭 404、无/错令牌 401、指纹认出设备名、清单、下载、上报与失败
原因落库、关闭后重新 404、重置令牌后旧令牌立即失效、未登录管理端被拒 —— 全通过
- 真实浏览器：面板渲染、点开关 → 自动生成令牌 → 设备端带令牌拉到清单且 device.name=A08、
无 JS 报错；测试后已把开关还原为关闭
- 全量回归 105 项通过（42 GET + 62 写探测 + 7 关键业务）
|
2026-09-13 14:40:38 +08:00 |
|