alltuu-downloader

喔图相册下载器

从喔图云摄影（alltuu.com）相册批量下载原图。

使用场景

当用户提供以下类型的链接时使用此技能：

• https://m.alltuu.com/album/XXXXXXXX/?menu=live
• https://www.alltuu.com/album/XXXXXXXX/
• 任何包含 alltuu.com 的相册链接

前置条件

1. Chrome Canary 需要运行并开启远程调试端口（默认 9222）
2. Node.js 已安装
3. 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 协议：

1. 打开相册页面，等待 JS 渲染
2. 拦截 v4c.alltuu.com 的 fpl（fetch photo list）API 响应
3. 从响应 JSON 中提取各尺寸签名 URL
4. 优先下载 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

可能原因：

• 相册需要密码或登录
• 相册 ID 不正确
• 网络问题

解决：在 Chrome Canary 中手动打开相册链接确认能正常访问。

下载 403

原因：签名 URL 过期（有效期约 30 天）。 解决：重新运行脚本获取新的签名 URL。

缺少 ws 模块

Missing dependency: ws

解决：cd /tmp && npm init -y && npm install ws

注意事项

1. 需要 Chrome Canary：脚本依赖浏览器渲染获取签名 URL，纯 HTTP 请求无法绕过
2. 签名有时效：OSS 签名 URL 有过期时间，下载时效内使用即可
3. 相册权限：仅支持公开相册，需要密码的相册需先在浏览器中解锁
4. 断点续传：已下载的文件会自动跳过，可安全重复运行