| name | download-picture |
| description | 从光环云课堂答案解析页抓取题图 CDN 地址、写入 image_manifest、下载到 data/practice/assets 并回写题库 JS。用户提到 downloadPicture、题图、拉图、 下载图片、光环题图、aura 答案页、fetch_aura、image_manifest 时使用。 |
downloadPicture（光环练习场题图下载）
前置条件
- 用户已在 Cursor 内置浏览器 打开并登录 yun.aura.cn（非系统 Chrome 亦可，脚本读 Cursor 分区 Cookie）。
- 目标套卷已有
data/practice/<setKey>.js，且题文中含题图文件名（如 9-5.png、图片2.png）。
- 依赖（缺则安装）：
pip install browser-cookie3 requests
用户需提供
- 答案解析长页 URL（含
tid/数字，如 …/write/75.html 或 …/write/75/lid/0.html）
- 套卷 key（如
zonghe_11、moni_2）
- 可选：tid 数字（写入
data/practice/captures/aura_tid_map.json）
标准流程（必须执行，不要只口头说明）
在仓库根目录运行：
python3 tools/fetch_aura_practice_images.py \
"<答案解析页完整 URL>" \
--set-key <setKey> \
--tid <tid> \
--download
示例：
python3 tools/fetch_aura_practice_images.py \
"https://yun.aura.cn/Test/alsTyper/lid/0/tid/7028333/typer/1/write/75.html" \
--set-key zonghe_10 --tid 7028333 --download
脚本会：
- 用 Cursor 浏览器 Cookie 拉取页面 HTML
- 提取
img01.aura.cn/wx/ueditor/ 图片 URL
- 按
download_practice_images.collect_refs() 的题图顺序对齐文件名
- 更新
data/practice/image_manifest.json
--download 时调用 tools/download_practice_images.py --rewrite --set <setKey>
完成后自检
ls data/practice/assets/<setKey>/ | wc -l
python3 tools/download_practice_images.py --set <setKey>
在本地练习场打开对应套卷，抽查含图题目解析是否显示图片。
失败与备用方案
| 现象 | 处理 |
|---|
未找到 Cursor 浏览器 Cookie | 提醒用户在 Cursor 里打开光环并登录一次 |
URL 数 < 题图名 | 确认链接是答案解析长页；或让用户保持该页打开，用浏览器 Network 抓 img01.aura.cn |
| Cookie 脚本失败 | 备用：控制台粘贴 tools/capture_aura_images.js → merge_captured_urls.py <json> --download |
备用 B（Agent 代抓）：用户已打开答案页时，可 browser_navigate 到该 URL、滚到底部、browser_network_requests 收集 ueditor 图，按题图在 collect_refs 中的顺序写入 manifest，再跑 download_practice_images.py --rewrite --set <setKey>。
关键路径（勿删）
| 路径 | 用途 |
|---|
tools/fetch_aura_practice_images.py | 主入口（本技能） |
tools/download_practice_images.py | 下载 + 回写 JS |
tools/merge_captured_urls.py | 控制台 JSON 合并 |
tools/capture_aura_images.js | 浏览器手动抓取 |
data/practice/image_manifest.json | 文件名 → CDN URL |
data/practice/captures/aura_tid_map.json | tid → setKey |
data/practice/assets/<setKey>/ | 本地题图 |
更多说明：data/practice/captures/README.md
与导题技能的关系
- 先
practice-import-unified 导入题库（含题图占位文件名）
- 再
downloadPicture 补全题图资源
- 无题图套卷（如部分
zonghe_2）跳过本技能
