photoplus-downloader

name	photoplus-downloader
description	PhotoPlus相册批量下载原图工具。当用户需要从 photoplus.cn/live/ 相册批量下载原图时使用此技能。适用于 photoplus.cn 相册链接，支持多线程并发、自动跳过已下载文件。

PhotoPlus 相册下载器

从 PhotoPlus 相册（photoplus.cn）批量下载原图。

触发条件

用户提供包含 photoplus.cn 的相册链接，例如：

• https://live.photoplus.cn/live/67458816?accessFrom=live
• https://live.photoplus.cn/live/67458816

Gotchas

• 不要从 GitHub 克隆脚本，本地 scripts/download_photos.py 已可直接使用
• 下载前必须先确认相册信息，不要拿到链接就直接下载
• 依赖 requests 和 tqdm，首次运行前需安装
• 需要 Python 3

工作流程

1. 提取相册 ID

从 URL 路径中提取 /live/ 后面的数字。

示例：https://live.photoplus.cn/live/67458816?accessFrom=live → ID 为 67458816

2. 确认相册信息

运行脚本获取相册信息，确认后再下载：

cd {skill_dir}/scripts
python3 download_photos.py --id [相册ID] --count 1

向用户展示总照片数量，确认是否继续下载。

3. 安装依赖（如需）

pip3 install --break-system-packages requests tqdm

4. 执行下载

用户确认后，下载全部照片：

cd {skill_dir}/scripts
python3 download_photos.py --id [相册ID] --count 9999

参数：

• --id：相册 ID（必需）
• --count：下载数量（默认 9999 即全部）

5. 验证结果

ls {skill_dir}/scripts/dist/[相册ID]/ | wc -l

向用户报告下载数量和保存路径。默认保存在 scripts/dist/[相册ID]/。

6. 移动照片（可选）

如用户需要移动到指定目录：

mv {skill_dir}/scripts/dist/[相册ID]/* ~/Downloads/[目标目录]/

故障排查

详见 references/troubleshooting.md