alltuu-downloader - SKILL.md Agent Skill

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=live
https://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

可能原因：

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

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

下载 403

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

缺少 ws 模块

Missing dependency: ws

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

注意事项

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