Scroll Agent

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。第三方代码、依赖和模型保留各自许可，见 第三方声明。源码包不含用户视频、私信、凭据或模型。