YouTube 学习摘要
使用当前目录内置的 Chrome 扩展，将有原生字幕的 YouTube 视频整理为可检索的学习资料。扩展无需构建，直接以“已解压的扩展程序”加载。
能力边界
- 支持标准
youtube.com/watch视频页及 Supadata 能返回的原生字幕。 - 可显示原文、简体中文或双语字幕，并生成概览、章节、重点引用、讲解和时间戳笔记。
- Shorts、直播、私密或受限视频，以及没有原生字幕的视频可能不可用。
- 当前扩展直接调用 Supadata 与 DeepSeek，使用者自行承担相应额度和服务条款。
安装
- 确认当前目录包含
manifest.json。 - 在 Chrome 地址栏打开
chrome://extensions。 - 开启“开发者模式”，选择“加载已解压的扩展程序”。
- 选择本 Skill 目录本身，也就是包含
manifest.json的目录。 - 固定扩展图标，并打开任意带原生字幕的标准 YouTube 视频验证侧边栏。
浏览器不允许自动操作 chrome:// 页面时，清楚告诉用户上述手动步骤，不要假装已经安装成功。
配置
扩展需要用户自己的 Supadata API Key 和 DeepSeek API Key。让用户在扩展的 Settings 页面亲自粘贴，绝不在聊天、源代码、日志或截图中索取、读取或回显密钥。
- Supadata：获取原生字幕。
- DeepSeek：生成概览、解释、翻译和润色笔记。
- 设置和缓存保存在 Chrome 本地存储；详细数据流见
PRIVACY.md。
不要扩大 manifest.json 中的站点权限，也不要把密钥写入 JavaScript 文件。处理私密、受监管或未获授权的视频内容前，先提醒用户确认数据能否发送给外部服务。
使用流程
- 打开用户提供的标准 YouTube 视频页。
- 打开扩展侧边栏，确认字幕成功载入。
- 按用户需求选择原文、中文或双语模式。
- 生成 Overview，并检查章节和引用时间戳能否跳转到正确位置。
- 需要深入学习时，对选中文本执行讲解，或保存带时间戳的笔记。
- 只翻译当前需要的内容，避免无意义消耗 API 额度。
排错
- 看不到按钮：在
chrome://extensions重新加载扩展，再刷新视频页。 - 无字幕：确认视频公开且有原生字幕，并检查 Supadata 配置和额度。
401/403：由用户在 Settings 中重新检查对应服务的 Key 或权限。429：等待限速恢复，或由用户检查额度和消费上限。- 修改扩展文件后：重新加载扩展并刷新已打开的 YouTube 页面。
验收与回复
至少验证扩展可加载、侧边栏可打开、字幕可显示；涉及真实 API 时，由用户完成密钥输入后再验证概览或翻译。最终报告扩展目录、测试视频、通过的功能和仍存在的服务限制，不包含任何密钥值。
