# PROJECT_CONTEXT

## 项目

千牛_数据导出_取数模板CLI_20260531_1331

## 用户目标

用户需要把千牛应用路径“数据-自助分析-取数报表-取数模板”下面的 Excel 表逐个导出，并希望用 HKUDS/CLI-Anything 的思路转换成可复用 CLI。

## 关键约束

- IT profile 不允许执行本机 GUI/键鼠/浏览器点击；千牛页面登录、点击、HAR 采集需要交给 visual-operator。
- 不保存账号密码，不在聊天中输出 Cookie/Token。
- 千牛/生意参谋核心数据属于权限/风控场景；优先官方能力和受控登录态，避免承诺公开 API 可直接全量读取。
- CLI 先做非破坏性导出，不修改模板、不删除、不新建报表。

## 已完成

- 检查 CLI-Hub，没有现成 `qianniu` / `taobao` / `alibaba` harness。
- 创建本项目 CLI harness：`qn-export`。
- 支持命令：`doctor`、`operator-brief`、`scan-har`、`fetch-list`、`build-downloads`、`collect-downloads`、`export-all`。
- 支持从 HAR 识别列表/下载候选接口，cookie 独立传入；也支持“重放列表接口 → 从列表 JSON 生成下载 manifest → 提交异步下载任务 → 轮询 OSS 下载 URL → 逐个保存 Excel”。
- 已用用户上传 HAR 跑通真实批量导出：识别 22 个模板并下载 22 个 xlsx，全部通过 zip 结构校验；输出目录 `deliverables/excels_from_uploaded_har/`，汇总包 `deliverables/千牛取数模板Excel_20260531_22个.zip`。
- visual-operator 已验证千牛页面可见，且点击第一个“下载”会生成 Excel 到 `/Users/bot1/Downloads/My WangWang/`；已收集 1 个 2026-05-31 当前导出样本到项目 deliverables。

## 当前真实导出样本/交付物

- 单个点击样本：`deliverables/operator_downloads/店铺经营核心日报_20260531_5336d755cd24b192510f23dc455079cf.xlsx`
- CLI 批量导出目录：`deliverables/excels_from_uploaded_har/`
- CLI 批量导出汇总包：`deliverables/千牛取数模板Excel_20260531_22个.zip`

## 当前阻塞

无。当前 HAR 已跑通真实端到端导出。后续如果登录态过期，需要重新上传新的 HAR 或 Cookie 文件。

## 推荐下一步

按业务需要读取/汇总 `deliverables/excels_from_uploaded_har/` 下 22 个 Excel，或直接使用汇总包 `deliverables/千牛取数模板Excel_20260531_22个.zip`。如需重新导出，重新采集 HAR 后执行：`scan-har` → `build-downloads` → `export-all --limit 1` → 全量 `export-all`。