 butubb
|
7ce4ae9016
|
feat(账号): 账号台账（web 页 + 任务取号 + 设备端身份页）；fix(剪贴板): 注入通道改走设备端 Agent
一、账号台账（新表 device_account，schema v8）
- core/ledger.py：CRUD、Excel 粘贴解析（Tab 分隔 / 表头乱序缺列 / 是·否布尔 / 逐行留痕）、
按范围取号（本机台账 / 全部 / 按设备分组）、设备端账号块、dry_run 预览
- 新「账号」顶级 Tab（权限 devices）：列表 + 搜索 + 设备筛选 + 增删改 +
粘贴导入（默认先预览再写，逐行显示 新增/覆盖/跳过/失败 + 留痕）
- 设备池加「账号 N」列（0 个显示"未登记"），点开看该设备账号明细
- 任务「条件判断」新增 cmp_source / cmp_group：候选值可直接来自台账，
与手填值**合并（OR）**；取不到号时回落手填值，并把原因写进步骤明细与日志
（否则"永远走 else 分支"而任务照样显示成功，最难查）
- 设备端契约：身份页多推 accounts_b64（base64 JSON；默认不含手机号；
超预算按整条丢且绝不算字节切），见 doc/DEVICE_AGENT.md §5.2.1
- 备份/文档红线：TABLE_LABELS 加「账号台账」；DATA_MODEL/API/ARCHITECTURE/DEPLOY/
TASK_DEV/DEVICE_AGENT/DEVELOPMENT/README 同步；顺手补上 DATA_MODEL 漏列的 done_mark
⚠ 台账里的抖音号是**纯号**，只当"比对用的候选值"：绝不能拿去填「去重」的身份元素
（身份是元素原文逐字算 key，格式不同会让去重静默失效）。代码与文档都写明了。
二、剪贴板注入通道（修：平台还在调早期的独立 APK）
- 改为按顺序尝试：设备端 Agent（com.example.deviceagent/.ClipActivity）→
旧版独立 ClipInject 兜底；两个都没有时报"需要设备端 Agent"（不再只说 ClipInject）
- 读回验证改成**轮询到 3 秒**：透明 Activity 要等窗口拿到焦点才写，
原来只睡 0.5s 会读到上一次的内容 → 误报"写入可能被拒"（实测内容已写入却回失败）
|
2026-09-24 16:12:58 +08:00 |
|
|
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 |
|