EZR 数据源导出

要解决的具体问题

EZR（驿氪）后台数据导出常面临三类痛点：多租户复用需频繁切换登录凭据、轮询任务易串台取到错误报告、定时任务需人工介入刷新会话。这些问题导致自动化导出流程不稳定，且难以适配新业务域数据源。

技能如何工作

核心能力包括：

• 认证与会话管理：通过 EZR_COOKIE_FILE 或 EZR_SESSION 存储 session，ezr_auto_refresh.py 经 Chrome CDP 自动读取最新 pcl_sid（含 HttpOnly）并重试，遇 ErrorMsg=900（session 过期）自动触发刷新，无需人工复制 cookie。
• 导出流程自动化：ezr_export.py 支持干跑验证（--dry-run）与真实导出（--date/--start/--end），自动推算数据范围；对 daily 型源强制 strict_day 校验，仅接受起止日期均为当天的真单日报告，避免跨天/累计任务串台。
• 数据源发现与扩展：references/data_source_catalog.md 列出已确认源与待确认业务域（如商品订单、会员），scripts/ezr_discover.py 通过触发小范围导出验证 endpoint/Type，打印文件/zip 内层/xlsx sheet 名及首行表头，无需 openpyxl 依赖。

适用边界与注意点

• 并发安全：多 AI 共享同一 Chrome 时，cookie 文件采用原子写（.tmp + os.replace）与写锁（.lock 文件 O_EXCL 创建）防止竞态；建议共享同一 EZR 账号（避免单会话互踢），或使用独立子账号/Chrome 用户目录。
• 时间窗限制：EZR 查询时间段不得超过 180 天，内部轮询窗设为 120 天安全上限；跨天任务需用 --date 按汇报日单日导出，勿人为放大 --start/--end 范围。
• 凭据安全：cookie/pcl_sid 仅存于本地文件或环境变量，禁止硬编码或提交仓库；ezr_auto_refresh.py 读取的 cookie 仅落地本地文件，避免泄露。