feat(scripts): 添加 PEP 723 脚本元数据并修复 HTTP/2 伪头过滤问题

- 为 build_studio_urls.py 和 lookup_groups.py 添加 PEP 723 依赖声明
- 修复 HTTP/2 伪头导致 requests 抛 InvalidHeader 的问题
- 添加 CDP 端口连通性预检查及启动指引
This commit is contained in:
2026-08-27 13:33:34 +08:00
parent b8bd749f43
commit 9020752eed
23 changed files with 885 additions and 294 deletions

View File

@@ -14,12 +14,16 @@
## 运行过程
- **找不到「导出当前视图」按钮 / 点击超时**URL 不是 explore 页,或页面尚未加载完。务必用用户提供的 explore URL别用 overview URL。
- **找不到「导出当前视图」按钮 / 点击超时**
- URL 不是 explore 页,或页面尚未加载完。务必用用户提供的 explore URL别用 overview URL。
- 当前界面该入口是右上角**下载图标按钮**(只有 `aria-label`、无可见文本),脚本已按 label 定位并以文本定位兜底若仍超时确认页面语言为中文或改在英文界面重试label 为 "Export current view")。
- 脚本未捕获到有效响应时会自动重试一次触发;连续失败时手动确认页面能正常导出。
- **没打印「已保存」(未捕获 csv_export 响应)**:导出未被触发,或登录态已失效。重试步骤 2必要时重新登录后重跑。
- **解出的 zip 报损坏 / `Incorrect padding`**`zippedData` 是 URL-safe 无填充 base64脚本已按此解码并做完整性校验后落盘仍报错说明响应内容异常检查是否被代理/网关改写。
- **文件名变成 `export.zip` 而非标准命名**:请求体解析失败触发兜底,内容仍完整;检查日期范围与账号名是否正常。
- **中文/特殊字符文件名**:已把 Windows 非法字符 `\/:*?"<>|` 自动替换为 `_`,不会因文件名失败。
## 产物与去重
- **下载目录不存在导致写盘失败**:脚本不自动建目录。先建 `D:\Downloads``--download-dir`定已存在目录
- **下载目录不存在导致写盘失败**:脚本启动时会自动创建下载目录(`os.makedirs(..., exist_ok=True)`)。沙箱/受限环境看不到 `D:\Downloads`,用 `--download-dir`向工作区内目录即可
- **重名文件**:自动按 `名称 (1).zip``名称 (2).zip` 递增;这是脚本自己的 dedup_path 逻辑,不依赖浏览器。