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 会读到上一次的内容 → 误报"写入可能被拒"(实测内容已写入却回失败)
This commit is contained in:
2026-09-24 16:12:58 +08:00
parent e82fd64695
commit 7ce4ae9016
24 changed files with 1455 additions and 62 deletions
+60 -2
View File
@@ -192,8 +192,18 @@ adb -s <serial> shell am start -n <pkg>/.ClipActivity --es text_b64 <base64(UTF-
- **必须 base64**:adb shell 直传中文/特殊字符会变形
- 必须用**透明 Activity**(有焦点才能写剪贴板),写完**立即退出**
- 平台判定失败的方式:`am start` 输出里有 `unable to resolve Intent` / `does not exist`
→ 视为"设备未安装 Agent"
- 平台判定失败的方式:`am start` 输出里有 `unable to resolve Intent` / `does not exist` /
`Error type 3` → 视为"这台设备没有这个通道"
**平台按顺序试两个包**(`core/clipboard_helper.py` 的 `_CLIP_TARGETS`):
| 顺序 | 包 | 说明 |
|---|---|---|
| 1 | `com.example.deviceagent`(**本 Agent**) | 现在的标准通道;装了就只调它 |
| 2 | `com.example.clipinject`(早期独立 APK) | 老设备上可能还残留 → 兜底;走这条会在日志里提示"建议装设备端 Agent" |
两个都没有时报"设备未安装剪贴板注入通道:需要设备端 Agent"(不再只说 ClipInject,
否则用户会去装那个已经不再分发的旧 APK)。**设备端无需为这条改动做任何事**。
### 5.2 设备身份显示(设备端已实现)
@@ -206,6 +216,51 @@ adb -s <serial> shell am start -n <pkg>/.InfoActivity \
要求:全屏大字、再次调用可覆盖内容、`close` 可关闭、不驻留前台。
#### 5.2.1 本机账号台账(`accounts_b64`,可选 extras — **需要设备端配合实现**)
平台在**打开**身份页时会顺带把这台设备在「账号」页登记的抖音账号推过去
(`--es close 1` 时**不带**)。**中文必须 base64**(同 §5.1:adb shell 直传中文会变形):
```bash
adb -s <serial> shell am start -n <pkg>/.InfoActivity \
--es name "A03" --es serial "192.168.20.63:5555" --es server "http://192.168.20.220:18050" \
--es ip "192.168.20.63" \
--es accounts_b64 "<base64(UTF-8 JSON)>"
```
解码:**标准 base64**(不是 URL-safe)+ UTF-8。JSON 结构(字段名的设备端解析按名取,多余字段忽略):
```json
{"v":1,"total":4,"shown":4,"truncated":false,
"note":"设备『A03』登记 4 个号",
"accounts":[
{"name":"AA建材王总","douyin_id":"66057500463","device_name":"A03","device_no":"A03",
"sim_in_device":true,"can_post_video":true}]}
```
| 字段 | 说明 |
|------|------|
| `v` | 本块格式版本(当前 **1**)。解不出来时用它区分"格式变了"与"平台没给" |
| `total` / `shown` / `truncated` | 该设备在台账里的总数 / 本次带了几条 / 是否被截断 |
| `accounts[].name` | 账号名称(台账的「账号名称」列) |
| `accounts[].douyin_id` | **抖音号(纯号)**,如 `35377983067` |
| `accounts[].sim_in_device` / `can_post_video` | 卡在机内 / 可发视频(布尔) |
| `accounts[].phone` | **默认不推**(大字页是机器旁的公开屏幕,手机号不宜默认上屏)。需要时平台请求体传 `{"include_phone":true}` |
**设备端要做的**(当前版本忽略该 extra,行为与旧版逐字一致):
1. 读 `accounts_b64` → base64 解码 → `JSONObject`
2. 在身份页上按 `name` / `douyin_id` 渲染一个列表(建议 1~3 行简短列表,最多显示 `shown` 条)
3. `truncated=true` 时提示"还有更多,见平台账号页"
**约定与边界**(平台侧实现见 `web/device_agent_api.py` 的 `_encode_accounts`):
- **没有这个 extra = 这台设备在台账里没有账号**(不是"平台忘了给")——设备端保持原样显示即可,
不要显示空列表
- 超预算时平台**按整条丢**(`shown` 变小 + `truncated=true`),**绝不按字节切**(切了就是坏 JSON);
台账过大时可能**整个 extra 不发**(平台响应体里 `warn` 会说明原因)
- 台账读取失败时同样**不发**这个 extra —— 台账故障不影响"显示身份"这个动作
### 5.3 扫码配置(设备端已实现)
平台「设备池」里点某台设备的「**二维码**」→ 生成一张二维码 → 手机上的 Agent 点
@@ -239,6 +294,9 @@ adb -s <serial> shell am start -n <pkg>/.ConfigActivity \
## 6. 版本与兼容
- **§5.2.1 的 `accounts_b64` 是"加字段"= 小版本**:`agent_api_version` **仍是 1**,
设备端忽略它时行为必须与旧版逐字一致(只是大字页少一块内容)。也**不**走
`bootstrap`:身份页由平台用 adb 推,加进 bootstrap 没人用还会让契约多一处要同步。
- `agent_api_version`(当前 **1**)在每次 `bootstrap` 响应里返回
- **设备端**:启动时对比自己实现的版本,不一致要在日志里明确记下来(不要静默)
- **平台端**: