 butubb
|
97cec6e211
|
feat(通知): 系统级 Webhook 通知子系统（事件目录 + 可插拔适配器 + 防刷屏）
平台此前出了问题只能靠人盯页面。现在各组件统一走 `notifier.notify(事件, **字段)`，
推到企业微信 / 自建服务；**所有可通知点都登记进事件目录，默认全关，用户按 webhook 勾选**。
## 架构（`core/notifier.py` + `core/notify_events.py`）
业务线程调 `notify()` → 只做内存操作（读配置快照/匹配订阅/入队）→ 返回；
后台 1 个 dispatcher（聚合 + 每 hook 限流 + 折叠摘要）+ 3 个 sender（真实 HTTP、退避重试）
负责真正发出去。硬约束：**notify 零 DB、零 HTTP、零阻塞、异常不冒泡**——所以任务线程里
可以直接调（不用 app_context、不用 try/except），但**必须放在所有 `with self._lock` 之外**。
- **事件目录 36 条**（任务批次/单设备/设备/Worker/业务/安装/系统/AI），支持 `task.*` 通配订阅；
语义分工避免重复告警：`worker.*` 是单次尝试级，`task.device.success/failed` 是唯一权威结论。
- **适配器可插拔**：`wecom`（markdown，按 4096 **字节**截断、超限不截半个汉字）+
`json`（模板占位符，替换值按 JSON 转义，保存前干跑校验）；钉钉/飞书留了插槽（前端置灰）。
- **防打爆四层**：聚合窗口（默认 30s，同批次合并成一条并带样本）→ 令牌桶限流（默认 18/分，
对齐企微硬限 20）→ 被限流的**折叠成摘要不丢弃** → 有界队列背压。取舍：失败通知最多延迟
一个窗口，换来群不被刷屏。
## 安全与存储
- 配置只落 `app_meta.notify_webhooks` 一个键（**不建表** → 不涉及备份覆盖红线）。
- URL 本身就是凭据（企微 `?key=`）→ 接口回显/发送记录/日志一律 `mask_url()/scrub()`；
编辑时留空即不修改；secret 永不回显。DATA_MODEL 的明文凭据告警补上了这一条。
- 发送记录：内存环形缓冲 200 条（重启清空）+ 独立 `logs/notify.log`。
## 接入点（每个都放在锁外、不改 return 顺序）
task_manager（批次开始/结束用新增的 `_BatchTracker` 统一在 finally 计数、单设备成功/失败/
离线/重试/停止/抢占/归还/cron 停止）、device_worker 心跳看门狗、generic 任务选择器连续失效、
apk 安装开始/完成、设备上下线（**状态沿检测**，只报新变化）、备份导出/恢复、经验巡检、
用户登录、服务启停。
## 前端
系统 Tab 新增「通知 / Webhook」子分栏：多条 webhook 列表（URL 打码）+ 编辑弹窗（格式/URL/
密钥/事件勾选树带 ★建议/聚合/限流/自定义模板/预览）+ 发送测试 + 发送记录。
## 自测
- 进程内逻辑 10 组断言全绿：聚合合并、限流+折叠、无配置/全局关静默丢弃、未知事件、
内部异常不外泄、JSON 转义（标题含引号换行仍合法）、URL/异常消息脱敏、配置校验。
- 端到端（假 webhook 接收端）17 项断言全绿：真实事件投递（user.login / task.batch.no_device）、
企微请求体形状、**HTTP 200 + errcode 93000 判为失败**、500 重试 3 次、记录里 URL 打码。
- 韧性：webhook 指向黑洞地址时登录耗时 100~114ms（基线 107~133ms，**异步隔离生效**）；
配置写成坏 JSON 服务照常启动、通知静默不发、日志有 error（服务端实测后已复原）。
- 页面：系统 → 通知 面板/弹窗/36 个事件复选框/预览全部正常，无 JS 报错。
- 自测数据已清理（webhook、自建任务、写坏又复原的配置键）。
文档：新增 doc/NOTIFY.md（事件表/配置/格式约束/防刷屏/加事件三步骤/排障）并登记进 doc/README；
API.md §2.11；DATA_MODEL 的 app_meta 键表与明文凭据告警；ARCHITECTURE 线程表/分层/扩展点；
根 README 功能索引与日志表。
|
2026-09-15 13:55:14 +08:00 |
|
|
butubb
|
eda71c8e5f
|
fix: USB 设备双路径——优先本机 adb 直连，其次 220 远程 adb server（原实现只查远程，本机 USB 会被误判不在 server）
|
2026-08-19 08:08:40 +08:00 |
|
|
butubb
|
a5ce57b6fd
|
阶段3: 摘除 STF——删除 stf_client/stf_device_mgmt 与全部引用（STF 容器重启/设备管理/强制释放占用/agent 按钮/占用列），调度与设备管理完全基于本地设备池+adb；错误类迁入 device_worker，create_worker 去 stf 参数
|
2026-08-18 08:08:32 +08:00 |
|
|
butubb
|
645938b305
|
阶段2: USB 远程 adb server 打通（220 host 网络 5037 全接口监听，无需改 220）+ 自建远程看屏（MJPEG 流 + u2 触控 tap/swipe/key/text，ws-scrcpy 不在 npm 改自建）
|
2026-08-17 16:50:12 +08:00 |
|
|
butubb
|
5354fe6379
|
阶段1: 调度/生命周期切换 device_pool——task_manager 设备解析与状态查询、STFDevice 去 occupy/release、web_server 端点换数据源（USB 桥接保留到阶段 2）
|
2026-08-17 11:16:13 +08:00 |
|
|
butubb
|
8a3cd67a97
|
fix: 设备异常状态清除（清除异常/一键清除，检查与更新原子化防竞态）
|
2026-08-11 08:22:24 +08:00 |
|
|
butubb
|
fcbdb0a8a1
|
feat: 通用步骤支持概率触发、循环按时间、预计结束时间上报
- 步骤新增 probability 参数：<100 时按百分比概率决定是否执行（实现"偶尔点赞"）
- loop 支持 loop_mode=rounds/time，按时间循环跑满 loop_duration 秒
- BaseWorker._start_timer 上报 end_time（开始+max_duration），task_manager 透出
|
2026-08-08 16:30:54 +08:00 |
|
|
butubb
|
3a38d9a57f
|
fix: adb 命令超时 + STF 释放失败检查，杜绝设备卡死/占用悬空
- adb 所有命令加 30s 超时：connect 到不可达地址不再无限挂起（worker 不再卡 connecting）
- STF release 检查响应状态并重试：504 等失败不再被静默吞掉，释放失败会真实上报
- release_all_mine 返回 (released, failed)；web /api/release 透出失败列表
|
2026-08-08 16:30:42 +08:00 |
|
|
butubb
|
bce48fc137
|
chore: 初始化仓库（排除 adb 二进制文件以解决推送超时）
|
2026-08-07 13:55:48 +08:00 |
|