youtube

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