介绍
# YouTube Instant Article
将 YouTube 视频转换为 Telegraph Instant View 文章，包含视觉幻灯片和带时间戳的摘要。
## 何时使用
**始终在以下情况使用此技能：** - 用户分享了 YouTube URL（任何 youtube.com 或 youtu.be 链接） - "总结这个视频" - "这个视频是关于什么的？" - "把这个变成一篇文章" - "给我这个视频的大意"
**仅对以下情况使用通用的 `summarize`：** - 非 YouTube URL（文章、网站、PDF） - 明确的“只给我转录文本”请求
## 快速开始
```bash source /Users/viticci/clawd/.env && {baseDir}/scripts/generate.sh "$ARGUMENTS" ```
## 选项
| 标志 | 默认值 | 描述 | |------|---------|-------------| | `--slides-max N` | 6 | 最多提取的幻灯片数量 | | `--debug` | off | 保留临时文件用于调试 |
## 环境变量
所需的环境变量从 `/Users/viticci/clawd/.env` 加载： - `TELEGRAPH_TOKEN` - Telegraph API 访问令牌 - `OPENAI_API_KEY` - 用于 GPT-5.2 摘要生成
## 输出
Telegraph Instant View 文章包含： - 📺 顶部的视频链接 - 🖼️ 与带时间戳章节交错排列的幻灯片 - ⏱️ 带时间戳的关键时刻 - 💬 作为块引用的精彩语录 - ✨ 来自 YouTube 的正确标题
## 架构
``` YouTube URL │ ├─► summarize --extract (get video title) │ ├─► summarize --slides (extract key frames) │ ├─► summarize --timestamps (GPT-5.2 summary) │ ├─► catbox.moe (upload images) │ └─► Telegraph API (create article) ```
## 主要功能
### 图片托管：catbox.moe - 无需 API 密钥 - 无过期时间 - 可靠的 CDN - 直接 URL 嵌入
### LLM：OpenAI GPT-5.2 - 快速（约 4-5 秒） - 高质量摘要 - 自动提取时间戳
### 布局：交错排列的图片 - 图片分布在各个带时间戳的章节中 - 不集中在顶部 - 每个主要章节都有一张相关的幻灯片
## ⚠️ 重要说明
### Instant View 生成时间 Telegram 需要 **1-2 分钟** 来为新页面生成 Instant View。如果 ⚡ 按钮没有立即出现，请稍候并重试。
### 脚本要求 - 使用 **zsh**（而非 bash）以支持关联数组 - 依赖：`summarize`、`jq`、`curl` - 可选：`ffmpeg`（用于本地视频处理）
### 始终使用脚本 **切勿手动创建 Telegraph 内容。** 始终使用 `generate.sh`： - 确保使用正确的 h4 标题（Instant View 必需） - 正确分布图片 - 自动提取视频标题
## 依赖项
- `summarize` v0.10.0+ (`brew install steipete/tap/summarize`) - `jq` (`brew install jq`) - `curl` (macOS 预装) - 具有访问 GPT-5.2 权限的 OpenAI API 密钥
## 处理时间
| 视频时长 | 大约耗时 | |--------------|--------------| | < 15 分钟 | 20-30秒 | | 15-30 分钟 | 30-45秒 | | 30+ 分钟 | 45-60秒+ |
## 故障排除
### "Failed to get summary"（获取摘要失败） - 检查 `OPENAI_API_KEY` 是否已设置 - 验证 API 密钥是否有 GPT-5.2 访问权限 - 尝试使用 `--debug` 标志
### 没有 Instant View 按钮 - 等待 1-2 分钟让 Telegram 处理 - 验证文章是否有内容（非空） - 检查图片是否已加载（直接访问 Telegraph URL）
### 图片不显示 - catbox.moe 可能暂时宕机 - 在调试输出中检查上传是否成功 - 验证 URL 是否为 HTTPS