视频阅读器 Kandecho/Video-Reader

Video Reader

把 Bilibili、YouTube 和本地视频交给你正在用的 AI 助手阅读：整理内容、核对画面，或带着时间点继续追问。

Video Reader 提供字幕、语音和画面材料，通过 MCP 接入 Codex、Claude Code 和 DSH；理解和回答由助手完成。你可以直接贴链接提问，不必先生成笔记。

开始使用 · 下载整包 · 文档

可以用来做什么

- 读懂一条视频：「整理这条视频的主要观点和论据，标出值得回看的位置。」
- 核对具体细节：「06:12 的图和讲解一致吗？把相关画面拿出来看。」
- 接着讨论或保存：「继续上次没看完的部分，把引用的画面和原话一起导出。」

还可以按主题找 B 站视频、预览分镜，以及按需读取评论、回复和弹幕。长视频可以分次阅读，已取得的材料可继续使用。

整包还包含通用队列与历史、Scroll 个人工作流。Scroll 可给组件单独登录 B 站小号，使用小号首页推荐，与主号收发授权私信、接收转发视频并入队。这些能力已有真实使用；定时工作流等仍在试用，常驻收件和持续后台阅读尚未接入。详见能力状态。

开始使用

当前发布版面向 Windows x64、PowerShell 7 和 Python 3.12。安装需要 uv、FFmpeg / ffprobe；读取 YouTube 时还需要 Node.js。uv 可按需准备 Python。

下载并解压源码包，在解压后的目录打开 PowerShell 7，运行：

& './bootstrap.ps1'
& './run.ps1' doctor

然后按 首次使用指南 接入你的助手，贴一个视频链接并说明你想了解什么。安装不会自动下载语音模型；没有可用字幕的视频，需要另行 配置本地转写。

先了解这些边界

- 处理默认在本地进行。 Gemini 云端读取默认关闭，不会在失败后自动切换到云端。交给助手的材料由你选择的宿主和模型处理。
- 字幕和机器识别可能出错。 重要细节可以回到原话、原图核对；取样画面不能保证覆盖每个短暂动作。
- 平台访问需要相应权限。 B 站使用组件自己的扫码登录；YouTube 可导入你手动导出的短期 Cookie。登录和平台限制仍可能影响读取。

本版的已知限制和验证范围见 发布说明。

按需要查文档

| 你想做什么 | 从这里开始 |
| 第一次安装、接入助手、读一条视频 | 首次使用 |
| 在 DSH 中安装整包薄适配 | DSH 接入 |
| 从 DSH 插件索引发现本项目 | 发现与收录 · 开放插件市场条目 |
| 使用 MCPB 接入包、在官方目录查询 | MCP Registry |
| 区分可用能力、试用部分与未完成项 | 能力状态 |
| 设置模型、登录或调整文件位置 | 安装与配置 |
| 查命令、工具参数、续读和导出 | CLI 与 MCP 参考 |
| 管理待读视频、附言和结果 | 队列与历史 |
| 使用个人推荐、私信收件和授权投递 | Scroll |
| 报告问题或参与开发 | 贡献与复现 |
| 了解开发顺序与阶段验收 | 开发路线 |

Scroll 可按需使用，普通读片无需配置个人投递。文档首页列出完整入口；与 dsh-bili-scroll 等实现的不同侧重见相关项目。

许可

项目原创代码采用 MIT。第三方代码、依赖和模型保留各自许可，见 第三方声明。源码包不含用户视频、私信、凭据或模型。