看完啦

中文 | English

把 YouTube 和 B 站长视频，变成可以读、可以搜、可以记的学习资料。

国内下载最新版 · 安装教程 · 版本更新 · 常见问题 · GitHub 备用

完全不懂代码也可以使用。你只需要会下载 ZIP、打开浏览器扩展页面，并把自己的服务密钥粘贴到“设置”中。

它能帮你做什么

你想做的事	“看完啦”会怎么帮你
看懂长视频	把字幕放到视频旁边，点击时间就能跳回对应画面。
阅读外语视频	在原文、中文和双语对照之间切换。
快速抓重点	用 AI 生成章节、重点摘录和带时间戳的概览。
问清楚一句话	选中字幕后点击“解释”，还可以补充自己的问题。
记下有用内容	点击“记笔记”或按键盘上的 N，保存当前时间和字幕。
把学习内容交给 Agent	一键复制学习记录，或下载 Markdown、JSON 文件。

这些内容默认保存在你自己的浏览器里。“看完啦”没有开发者服务器、账号系统、广告或分析统计，也不要求安装本地 AI 软件。

看一眼实际效果

B 站：边看视频，边读概览

_{在 B 站播放页直接生成带时间戳的章节和重点摘录，视频上的“记笔记”按钮也会保留。}

YouTube：字幕、概览和笔记都在同一个侧边栏

字幕与中文翻译 逐句时间戳、原文/中文/双语切换，并可跟随视频播放。

AI 概览与处理进度 生成章节和重点时，会显示当前阶段、已用时间和处理活动。

笔记与 Agent 导出 统一管理笔记，并复制给 Agent 或下载 Markdown、JSON。

重点摘录和划线提问

自动整理重点 每条重点都有时间，可以跳回视频、复制文字或保存为笔记。

针对选中文字继续追问 不只让 AI 解释原文，还可以输入自己的疑问，让回答更有针对性。

保存后马上看到结果 弹窗会显示真正保存的内容和时间链接。

选中文字直接操作 选中字幕后，直接点击“解释”或“笔记”。

3 分钟完成安装

目前使用的是“手动安装版”。第一次操作多几步，后面就可以一直使用。

1. 国内用户先打开 GitCode 发行版；如果无法访问，再打开 GitHub 最新版。
2. 在发行版页面下载名称类似 kanwanla-v版本号.zip 的文件。
3. 找到下载好的 ZIP，双击或右键解压。请把解压后的文件夹放在一个长期不移动的位置。
4. 打开浏览器扩展页面：
   • Chrome：在地址栏输入 chrome://extensions
   • Edge：在地址栏输入 edge://extensions
5. 打开右上角或左侧的开发者模式。
6. 点击加载已解压的扩展程序，选择刚才解压的文件夹。正确的文件夹里面能看到 manifest.json。
7. 回到已经打开的 YouTube 或 B 站视频页面，刷新一次。

如果扩展卡片的名称不是“看完啦”，或版本号低于本页最新版，说明选到了旧文件夹。请重新选择包含 manifest.json 的新版文件夹。

不想自己操作？复制这段给 Agent

点击下面代码块右上角的复制按钮，把整段内容发送给 Codex、Hermes 或其他能够操作电脑的 Agent：

请协助我在这台电脑上安装“看完啦”浏览器扩展。

官方项目：
- GitHub：https://github.com/Zhenxiangai/kanwanla
- 国内镜像：https://gitcode.com/gcw_XQNnjJtX/kanwanla
- 最新版：https://github.com/Zhenxiangai/kanwanla/releases/latest

请按下面的顺序执行：
1. 先确认这台电脑使用的操作系统，以及我要安装到 Chrome 还是 Edge；优先使用我当前正在使用的浏览器。
2. 检查现有扩展和下载目录，再开始修改。保留其他扩展和文件，不覆盖无关内容。
3. 只从上面的官方项目下载最新发行版 ZIP。国内镜像有可用发行版时优先使用；否则使用 GitHub 最新发行版。
4. 解压到一个长期保留、不会被系统自动清理的独立文件夹，并确认该文件夹里有 manifest.json。
5. 打开 chrome://extensions 或 edge://extensions，开启开发者模式，选择“加载已解压的扩展程序”。如果这一步必须由我点击，请一次只告诉我一个简短操作，等我完成后再继续。
6. 核对扩展卡片名称为“看完啦”，并记录显示的版本号。不要删除、停用或重新配置其他扩展。
7. 打开一个正常的 YouTube 或 B 站视频页面并刷新，确认“摘要”或“记笔记”入口出现，侧边栏可以打开。
8. 安装完成后，再引导我进入“设置”页面。API 密钥由我亲自填写；不要读取、复制、记录或代填任何 API 密钥。

不要安装无关软件、本地服务或其他浏览器扩展。遇到失败时先说明具体原因，再给出最小的修复步骤。只有“看完啦”扩展已加载，并且至少一个支持的视频页面能打开侧边栏，才算安装完成。

第一次使用：设置自己的服务

API 密钥是什么

可以把 API 密钥理解成你自己的“服务通行证”。它不是本项目提供的，也不要发给别人。请只把密钥粘贴到扩展的“设置”页面。

想使用的功能	需要准备什么
保存笔记	什么都不用，直接使用。
读取 B 站字幕	不需要 API 密钥；少数字幕需要先在同一个浏览器中登录 B 站。
生成概览、翻译或解释	需要自己的硅基流动 API 密钥。
读取 YouTube 字幕	需要自己的 Supadata API 密钥。

1. 没有硅基流动账号：点击注册硅基流动，创建密钥后粘贴到设置页。
2. 没有 Supadata 账号：点击注册 Supadata，创建密钥后粘贴到设置页。
3. AI 模型看不懂时，不用修改。默认的 deepseek-ai/DeepSeek-V4-Flash 可以直接使用，也可以以后再换。
4. 点击保存设置，回到视频页面刷新一次。

_{设置页已经把 YouTube 字幕、B 站字幕和 AI 服务分开说明。}

平时怎么用

1. 打开一个 YouTube 或 B 站视频。
2. 点击视频附近的摘要按钮，或打开浏览器侧边栏中的“看完啦”。
3. 在侧边栏上方选择：
   • 字幕：阅读、搜索、翻译和跳转时间。
   • 概览：生成章节和重点摘录。
   • 笔记：查看已保存内容，并导出本次学习记录。
4. 想记下当前内容时，点击记笔记，或直接按键盘上的 N。
5. 想问 AI 时，先选中一段字幕，再点击解释。

把学习记录交给 Agent

打开笔记 → 本次学习记录，可以：

• 点击复制给 Agent，得到一段可以直接粘贴给 Hermes、Codex 或其他 Agent 的提示词。
• 点击下载 Markdown，保存成普通笔记文件。
• 点击下载 JSON，交给其他程序继续处理。
• 根据需要勾选包含完整字幕。默认不包含完整字幕，文件会更小，也更注意隐私。

_{设置页还提供一段可编辑的开发提示词，方便让 Agent 在清楚安全边界的前提下继续修改项目。}

如何更新

1. 在“看完啦”侧栏顶部点击检查更新。
2. 如果出现新版本 vX，点击它会打开最新发行版页面。
3. 下载新的 ZIP 并解压。
4. 把新文件复制到原来的扩展文件夹中，选择覆盖同名文件。
5. 回到 chrome://extensions 或 edge://extensions，在“看完啦”卡片上点击重新加载。
6. 刷新视频页面。

浏览器不允许手动安装的扩展自己覆盖本地文件，所以现在还不能做到真正的一键安装更新。顶部按钮负责提醒并带你打开正确的下载页。

常见问题

YouTube 提示“未找到字幕”

这个视频可能没有原生字幕。打开“设置”，把“没有原生字幕时”改为使用 Supadata AI 转写后备，然后重试。AI 转写通常更慢，并可能按视频时长消耗 Supadata 额度。

B 站提示没有字幕

先确认你已经在同一个浏览器中登录 B 站，然后刷新视频。有些视频本身没有提供字幕，这种情况插件也无法读取。

翻译或概览为什么比较慢

速度会受到视频长度、字幕数量、当前网络和所选模型影响。侧边栏会显示正在准备、等待模型或生成内容。完全没有变化时，可以点击重试。

我不会选择 AI 模型

保持默认的 DeepSeek V4 Flash 即可。模型列表是给有特殊需要的用户准备的。

“摘要”或“记笔记”按钮没有出现

先刷新视频页面。如果仍未出现，请到浏览器扩展页面，在“看完啦”卡片上点击重新加载，再回到视频页面刷新。

API 密钥会上传到项目作者那里吗

不会。密钥保存在当前浏览器个人资料中，只在使用对应功能时发送给 Supadata 或硅基流动。不要把密钥写进源码、截图、聊天、日志或 GitHub 提交。

只看 B 站，需要 Supadata 吗

不需要。Supadata 只负责 YouTube 字幕。B 站字幕直接来自 B 站。

支持范围

• Chrome 或 Edge 116 及更高版本。
• YouTube 普通视频播放页。
• B 站 /video/ 和 /list/ 播放页，包括多 P 视频。
• B 站只读取平台提供的字幕轨，不会从视频声音中重新生成字幕。
• YouTube 可选择 Supadata 的 AI 转写后备，但需要用户主动开启。

数据和隐私

• 设置、字幕缓存、翻译、概览、笔记、划线问答和阅读位置都保存在当前浏览器个人资料中。
• 项目没有开发者后端、账号系统、广告或分析统计。
• 完整字幕不会自动复制给 Agent，必须由你明确勾选。
• 更新检查只读取 GitCode 或 GitHub 上公开的版本号和发行说明；不会发送视频、字幕、笔记或 API 密钥。
• 需要清除数据时，可在设置页使用清除缓存的摘要或重置扩展数据。

更完整的数据说明请看 PRIVACY.md，安全问题请看 SECURITY.md。

给开发者：技术实现与本地验证

字幕来源

• YouTube：把规范化视频链接发送到 Supadata。默认只读取已有字幕；用户明确开启后，才使用 AI 转写后备。
• Bilibili：通过 api.bilibili.com/x/web-interface/view 获取视频信息，通过 api.bilibili.com/x/player/wbi/v2 获取字幕列表，再从 hdslb.com 下载字幕 JSON。

AI 服务

• 接口：https://api.siliconflow.cn/v1
• 默认模型：deepseek-ai/DeepSeek-V4-Flash
• 用户仍可加载账号可用模型，或手动填写模型 ID。

本地开发

项目使用原生 HTML、CSS 和 JavaScript，不需要构建前端，也不需要本地服务。

npm test
npm run check
npm run package

打包后会生成 dist/kanwanla-v<版本>.zip。提交改动前请同时检查 Chrome、Edge、YouTube 和 B 站。

开源来源与授权

“看完啦”由 Zhenxiangai/kanwanla 独立维护，基于 Zara Zhang 的 zarazhangrui/youtube-digest 二次开发，并依据 MIT License 使用和发布。

原项目及改编代码的版权声明保留在 LICENSE、NOTICE 和对应源文件中。欢迎阅读 CONTRIBUTING.md 后参与改进。

和参考项目相比，“看完啦”增加了什么

“看完啦”基于 zarazhangrui/youtube-digest 二次开发。下面只对比这个原始项目与“看完啦”当前已经实现的功能。

你关心的功能	原始 YouTube 项目	看完啦
支持的视频网站	YouTube	一个扩展同时支持 YouTube 和 B 站。
YouTube 没有原生字幕	不生成字幕	可由用户主动开启 Supadata AI 转写后备；默认仍优先原生字幕。
AI 服务和模型	固定 DeepSeek V4 Flash	默认使用硅基流动 DeepSeek V4 Flash，也可读取账号可用模型或手动更换。
中文和语言选择	原文、中文、双语内容视图	新安装中文优先；界面语言、AI 输出语言和字幕显示方式可以分别选择。
遇到看不懂的一句话	选中文字后让 AI 解释	选中文字后，不只解释，还能输入自己的具体疑问，让 AI 针对回答。
记笔记和带走内容	保存带时间戳笔记	YouTube 与 B 站都可点击或按 N 保存；立即显示真实保存内容，并可复制给 Agent、下载 Markdown 或 JSON。
等待 AI 概览时	生成章节与重点	统一显示正在准备、等待模型、生成、整理等真实阶段和已用时间。
安装后的更新	从 GitHub 手动下载	侧栏顶端直接检查；国内优先 GitCode，失败自动回退 GitHub。解压安装版仍需手动覆盖并重新加载。

简单说，“看完啦”最主要的增量不是把两个项目简单拼在一起，而是把双平台、可选模型、针对性提问、可靠笔记、Agent 学习记录和国内更新入口整理成同一套更容易上手的流程。

这不是优劣排名，只是帮助第一次使用的人快速看懂本项目在原始 YouTube 项目基础上增加了什么。对比依据为 2026-09-01 的公开说明，后续可能变化。

版本更新：每次升级能得到什么

最新版 v2.2.3：概览切页不断线

这次更新	对你的好处
打开插件后自动开始概览	可以先阅读字幕，章节和重点摘录会同时在后台生成。
切换页面后返回会续接任务	不再从头生成，也不会因为重新打开侧栏而重复调用模型。
恢复真实处理阶段和已用时间	返回原视频时能看见同一任务的最新进度。
更新按钮增加侧栏直接回退	Chrome 旧后台异常时仍可检查并打开可信的最新版下载页。

以前几个版本也解决了很实际的问题：v2.2.2 统一国内仓库，v2.1.3 增加国内下载，v2.1.2 把检查更新放到侧栏顶端，v2.1.1 修复笔记并加入划线提问、真实进度和 Agent 导出。

查看完整版本更新记录 · 查看所有发行版