| name | alltuu-downloader |
| description | 喔图(alltuu.com)云摄影相册批量下载工具。当用户需要从 alltuu.com / m.alltuu.com 相册批量下载原图时使用此技能。支持下载原图（6720x4480 级别），自动处理签名URL，并发下载。适用于 alltuu.com/album/ 相册链接。 |
喔图相册下载器
从喔图云摄影（alltuu.com）相册批量下载原图。
使用场景
当用户提供以下类型的链接时使用此技能：
https://m.alltuu.com/album/XXXXXXXX/?menu=livehttps://www.alltuu.com/album/XXXXXXXX/- 任何包含 alltuu.com 的相册链接
前置条件
- Chrome Canary 需要运行并开启远程调试端口（默认 9222）
- Node.js 已安装
- ws npm 包已安装（脚本会提示安装方式）
启动 Chrome Canary
/Applications/Google\ Chrome\ Canary.app/Contents/MacOS/Google\ Chrome\ Canary \
--remote-debugging-port=9222 \
--user-data-dir=/tmp/chrome-canary-debug-profile \
--proxy-server="http://127.0.0.1:7890" &
安装 ws 依赖
cd /tmp && npm init -y && npm install ws
工作流程
1. 提取相册 ID
从 URL 中提取相册 ID（通常是 10 位数字或短码）。
示例：
- URL:
https://m.alltuu.com/album/1644727243/?menu=live
- 相册 ID:
1644727243
2. 创建下载目录
在用户指定位置创建目录（默认 ~/Downloads/alltuu），也可自定义，如 ~/Downloads/樱花。
3. 执行下载
cd /tmp && node <skill_dir>/scripts/download.js \
--album <albumId> \
--output <download_dir> \
--concurrency 5
参数说明：
| 参数 | 说明 | 默认值 |
|---|
--album | 相册 ID（必需） | 无 |
--output | 下载保存目录 | ~/Downloads/alltuu |
--concurrency | 并发下载数 | 5 |
--cdp-port | Chrome CDP 端口 | 9222 |
4. 下载结果
脚本会显示每张照片的下载状态：
✅ photo_001.jpg (6720x4480) 11.6MB
✅ photo_002.jpg (6720x4480) 7.5MB
⏭️ photo_003.jpg (already exists, 4.4MB)
❌ Failed: HTTP 403
🎉 Done! Success: 60, Failed: 0
📁 Saved to: /Users/.../Downloads/樱花
技术原理
alltuu.com 是纯 SPA 应用，照片数据通过前端 JS 动态加载，图片存储在阿里云 OSS，需要签名 URL 才能访问。
脚本通过 Chrome CDP 协议：
- 打开相册页面，等待 JS 渲染
- 拦截
v4c.alltuu.com 的 fpl（fetch photo list）API 响应
- 从响应 JSON 中提取各尺寸签名 URL
- 优先下载
ol（original，原图），回退到 url1920 → bl → sl
URL 类型说明
| 字段 | 域名 | 说明 |
|---|
ol | uio.alltuu.com | 原图（最大尺寸） |
url1920 | uip.alltuu.com | 1920px 版本 |
bl | uib.alltuu.com | 大图 |
sl | uis.alltuu.com | 缩略图 |
ssl | uis.alltuu.com | 小方图（200x200） |
故障排查
Chrome 未运行
Error: Cannot connect to Chrome on port 9222
解决：启动 Chrome Canary（见前置条件）。
相册加载失败
Failed to capture photo list API response
可能原因：
解决：在 Chrome Canary 中手动打开相册链接确认能正常访问。
下载 403
原因：签名 URL 过期（有效期约 30 天）。
解决：重新运行脚本获取新的签名 URL。
缺少 ws 模块
Missing dependency: ws
解决：cd /tmp && npm init -y && npm install ws
注意事项
- 需要 Chrome Canary：脚本依赖浏览器渲染获取签名 URL，纯 HTTP 请求无法绕过
- 签名有时效：OSS 签名 URL 有过期时间，下载时效内使用即可
- 相册权限：仅支持公开相册，需要密码的相册需先在浏览器中解锁
- 断点续传：已下载的文件会自动跳过，可安全重复运行
