# 慧博快速采集工具

这是面向 `case_analysis.report_collector` 的慧博 APP 研报原件采集工具。目标是把正常单份采集控制在 10 分钟内，并在到时后以 `TIME_BUDGET_STOP` 返回有效子集、阶段耗时和阻断原因。

## 已实现能力

- 固定 `cn.com.hibor` 与 `/sdcard/Android/data/cn.com.hibor/files/myfile/` 边界的 ADB 预检。
- 3–5 屏优先、20 屏/100 候选硬上限的 FAST 候选扫描。
- 详情页机构、日期、分析师、页数核验；登录、付费、订阅等访问控制可见即停止。
- 下载前额度预留，稳定缓存文件确认后记 confirmed，无法确认时记 uncertain；额度规则为 30/25/27/3。
- ADB pull、远端/本地字节数及 SHA-256、PDF magic、`pdfinfo` 可打开性/页数/加密检查。
- 本地归档不覆盖发布；48 列 manifest、元数据 delivery、阶段 timing 和 51 键公开终态。
- `dry-run`、单份和同查询批量任务规格；运行入口必须显式给出 `--execute`。

## 使用边界

`--dry-run` 只检查本地工具与路径，不启动 ADB，也不创建额度账本：

```powershell
python -m hibor_fast_collection --task <task.json> --dry-run
```

真实执行入口如下，但只有在该批次获得明确 APP/额度测试授权后才能调用：

```powershell
python -m hibor_fast_collection --task <task.json> --execute
```

工具不会修改、删除或重命名模拟器缓存原件，不保存认证秘密，不绕过登录/验证码/付费/权限，不解析研报正文，也不生成研究结论。PDF 与 SHA-256 是权威原件。

## 本地验证

```powershell
python -m compileall -q hibor_fast_collection test\hibor_fast_collection
python -m unittest discover -s test\hibor_fast_collection -p test_*.py -v
```

当前测试使用假 ADB/假 UI/合成 PDF，不连接慧博 APP、不触发下载、不消耗额度。真实 SLA 验证需要独立审核通过后的单独执行授权。