51 lines
2.4 KiB
Markdown
51 lines
2.4 KiB
Markdown
# youtube-download — 便携技能包
|
||
|
||
把 YouTube 视频下成本地最高画质 MP4（最高 4K，内含最佳音质 Opus 音轨）。默认规格：只下视频版，不单独下音频；除非用户明确要求音频版。已处理好现代 yt-dlp 下 YouTube 的两个坑：JS 运行时 + 机器人检测 cookie。
|
||
|
||
## 目录
|
||
|
||
```
|
||
youtube-download/
|
||
├─ SKILL.md # 技能说明（给 AI agent 读的：何时用、怎么用、坑）
|
||
├─ README.md # 本文件
|
||
└─ scripts/
|
||
├─ yt-download.ps1 # Windows 一键脚本（自动装 yt-dlp/deno）
|
||
└─ yt-download.sh # Linux/macOS 一键脚本
|
||
```
|
||
|
||
## 快速开始
|
||
|
||
**Windows**
|
||
```powershell
|
||
powershell -ExecutionPolicy Bypass -File scripts\yt-download.ps1 "https://www.youtube.com/watch?v=VIDEO_ID"
|
||
```
|
||
首次运行会自动把 `yt-dlp.exe` 和 `deno.exe` 下到 `scripts\bin\`。还需要系统装了 `ffmpeg`（`winget install Gyan.FFmpeg`）。
|
||
|
||
**Linux/macOS**
|
||
```bash
|
||
bash scripts/yt-download.sh "https://www.youtube.com/watch?v=VIDEO_ID"
|
||
```
|
||
需先装 `yt-dlp`、`ffmpeg`、以及 JS 运行时 `bun` / `deno` / `node` 任一（命令见 SKILL.md 顶部；脚本默认优先用 bun）。
|
||
|
||
## 登录/受限视频要 cookie
|
||
|
||
公开视频不用管。如果报 `Sign in to confirm you're not a bot`：
|
||
|
||
1. 浏览器（已登录 YouTube）装扩展 **Get cookies.txt LOCALLY**。
|
||
2. 打开着 youtube.com 标签页，点扩展 → Export，得到 Netscape 格式 cookie 文件。
|
||
3. 改名为 `cookies.txt` 放进 `scripts/` 目录（脚本会自动带上）。
|
||
4. 报“cookies no longer valid”时重新导出覆盖即可。
|
||
|
||
⚠️ cookie 是你的登录凭证，别外发、别提交到 git。本包**不含** cookie。
|
||
|
||
## 在 Codex / 其他 agent 里用
|
||
|
||
Codex（OpenAI CLI）没有 Claude 那种正式 skill 装载机制，但这个包是纯文档 + 脚本，任何 agent 都能用：
|
||
|
||
- 把整个 `youtube-download/` 文件夹放进项目，或放到 Codex 能读到的位置。
|
||
- 在项目根的 `AGENTS.md` 里加一句指路，例如：
|
||
> 需要下载 YouTube 视频时，读 `youtube-download/SKILL.md` 并运行其中的脚本。
|
||
- 或直接让 Codex “按 youtube-download/SKILL.md 的方法下这个链接”。
|
||
|
||
如果目标是 **Claude Code / Claude Agent**：把 `youtube-download/` 整个放进 `~/.claude/skills/`（或项目的 `.claude/skills/`）即可作为技能被自动发现（靠 SKILL.md 的 frontmatter）。
|