XiaoyaDownload
搜索并从小雅 Alist 下载电影/剧集到本地目录。输入电影或剧集名称,通过小雅搜索接口查找,选择结果后下载到本地。安全修复 v1.3.2:强化路径穿越防护,使用 pathlib.relative_to() 做严格 containment 检查。
- License 许可
- MIT
- 最近更新
- 2026-06-10
- Stars
- ★ 3
- Forks
- 0
01 前言 Front Matter
- name
- XiaoyaDownload
- description
- 搜索并从小雅 Alist 下载电影/剧集到本地目录。输入电影或剧集名称,通过小雅搜索接口查找,选择结果后下载到本地。安全修复 v1.3.2:强化路径穿越防护,使用 pathlib.relative_to() 做严格 containment 检查。
03 SKILL.md 正文
🎬 XiaoyaDownload — 小雅影音下载器
搜索小雅/Alist 中的电影/剧集,通过本地 WebDAV 挂载复制到 NAS 指定目录。
功能
- 搜索全库 — 输入电影/剧集名称,直接搜索小雅全库资源
- 版本选择 — 显示多个版本(不同画质、大小、格式),你可以挑选
- WebDAV 复制 — NAS 挂载了小雅 WebDAV 时,用
rsync本地高速复制
使用方式
搜索电影/剧集
"搜索肖申克的救赎" "帮我找找盗梦空间"
选择要下载的版本
搜索后列出所有版本,告诉小虾编号:
"下载第1个"
操作示例
🦐: 搜索肖申克的救赎
🔍 正在搜索「肖申克的救赎」...
📋 搜索结果:共 55 个
┌───┬──────────────────────────────────┬──────────────────────┬───────┐
│ # │ 文件 │ 画质·编码 │ 大小 │
├───┼──────────────────────────────────┼──────────────────────┼───────┤
│ 1 │ 📁 【肖申克的救赎】 │ - │ - │
│ 2 │ 🎬 肖申克的救赎.1994.BluRay.1080p.x265.. │ 1080p BluRay x265 │ 11.8GB│
│ 3 │ 🎬 肖申克的救赎.1994.2160p.WEB-DL.x26.. │ 4K HDR x265 │ 25.6GB│
│ 4 │ 📁 肖申克的救赎 4K REMUX │ 4K REMUX │ - │
└───┴──────────────────────────────────┴──────────────────────┴───────┘
🦐: 要下载哪个?(输入编号)
你: 2
🦐: 📁 复制文件: /path/to/your/file.mkv → /path/to/your/download/
rsync 速度: 39 MB/s
✅ 复制完成!
环境配置
创建 .env 文件:
# 小雅/Alist 网页地址(必填)
XIAOYA_HOST=http://your-xiaoya-ip:5678
# 下载保存目录(必填)
DOWNLOAD_DIR=/path/to/your/download
# WebDAV 本地挂载路径(推荐)
WEBDAV_MOUNT=/path/to/your/webdav/mount
CLI 命令
# 配置检查
python3 scripts/xiaoya_download.py setup
# 搜索
python3 scripts/xiaoya_download.py search "肖申克的救赎"
# 复制到本地(WebDAV)
python3 scripts/xiaoya_download.py copy "/电影/IMDB Top 250/200-250/肖申克的救赎...mkv"
依赖
- rsync(系统命令,用于 WebDAV 复制)
- Python 3 + requests 库(
pip3 install requests) - WebDAV 本地挂载(需先在
.env中配置WEBDAV_MOUNT)
安全说明
- 所有远程路径经过 unquote → resolve → 路径穿越检查 后才使用
- 复制操作限定在
WEBDAV_MOUNT目录内 .env配置文件不在发布包中,需用户自行创建
文件结构
skills/XiaoyaDownload/
├── SKILL.md
├── scripts/
│ └── xiaoya_download.py
├── .env # 用户自建(不在发布包中)
├── .env.example
└── _meta.json
04 同仓库更多 Skills
youtube-content
YouTube transcripts to summaries, threads, blogs.
xurl
X/Twitter via xurl CLI: post, search, DM, media, v2 API.
touchdesigner-mcp
Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.
test-driven-development
TDD: enforce RED-GREEN-REFACTOR, tests before code.
teams-meeting-pipeline
Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.
systematic-debugging
4-phase root cause debugging: understand bugs before fixing.