# AList Video Note Pro 使用手册 > 当前正式版本：`1.0.2` > 插件 ID：`aAAlist-video-note` > 授权产品：`alist-video-note-pro` > 适用场景：课程学习、B 站内容整理、本地视频笔记、片段收藏、OCR 与 AI 问答 ## 1. 产品简介 AList Video Note Pro 把视频播放、播放列表、时间戳笔记、截图、学习卡片、片段收藏、OCR 和可选 AI 问答整合到 Obsidian 中。用户可以从笔记中的时间戳链接回到原视频位置，让视频内容成为可搜索、可整理、可复习的本地知识资料。 插件不会在后台检查更新，也不会把视频、笔记、截图或收藏内容上传到 Peyote 授权服务。只有激活、设备管理、授权同步和主动检查更新时才会访问授权 API。 ## 2. 安装与激活 1. 在安全下载页输入 AList Video Note Pro 激活码并下载安装包。 2. 解压后确认根目录包含 `main.js`、`manifest.json` 和 `styles.css`。 3. 将文件放入当前 Vault 的插件目录： ```text .obsidian/plugins/aAAlist-video-note/ ``` 4. 重启 Obsidian，在“设置 → 第三方插件”启用 AList Video Note Pro。 5. 打开插件设置，在“授权与设备”中输入激活码并填写设备名称。 首次激活需要联网。激活成功后，日常启动和长期离线使用由本机许可证完成验证。默认最多绑定 5 台设备，实际权益以购买方案为准。 ## 3. 支持的视频来源 插件可以打开： - AList 或普通 HTTPS 视频直链； - Obsidian Vault 内的视频； - 桌面端外部本地视频； - B 站 BV、AV、EP、短链和常见页面链接。 移动端不能访问电脑的 `C:\`、`D:\` 或 `file://` 路径。跨设备使用时，建议把视频放入 Vault，或使用移动设备能够访问的网络地址。 ## 4. 打开视频与播放列表 可以通过左侧功能区、命令面板或插件内入口打开视频。粘贴链接或本地路径后，可直接播放，也可以先加入播放列表。 播放列表支持： - 新建、重命名和删除分组； - 添加、删除和搜索视频； - 按分组整理课程或素材； - 记录最近播放视频和位置； - 点击条目立即播放。 建议按课程、项目或主题建立分组，避免所有链接堆积在默认列表中。 ## 5. 时间戳笔记 视频播放到关键位置时，点击“插入当前时间点”。插件会在当前 Markdown 笔记插入可点击的时间链接，例如： ```markdown - [03:21](视频地址#t=00:03:21) ``` 再次点击该链接时，插件会重新打开相应视频并跳转到对应时间。B 站 iframe 受跨域限制，部分模式只能获得近似时间；需要精确时间时优先使用插件可直接控制的本地、直链或原生 video 播放模式。 ## 6. 截图与学习卡片 ### 截图并插入笔记 点击截图按钮后，插件会尽可能截取当前画面，保存到设置的截图目录，并在当前笔记插入图片和时间戳。 默认截图目录： ```text Attachment/Generated Attachments ``` 可以改成当前 Vault 内的其他目录。 ### 视频学习卡片 学习卡片用于记录： - 当前时间与视频回链； - 这一段讲了什么； - 自己的理解； - 后续行动或复习问题。 适合网课、教程、会议录像和影视镜头分析。 ## 7. 视频片段收藏集 “收藏当前视频片段”会建立一张本地收藏卡片，可包含： - 视频标题、来源和时间点； - 回链与截图； - 用户备注； - OCR 文本； - AI 总结； - 标签、状态和所属收藏集。 收藏中心支持搜索、按收藏集/状态/来源筛选、编辑、删除、复制回链和跳回原视频。建议先快速收藏，观看结束后再集中补充标签和备注。 收藏数据保存在当前插件目录下的 `card-favorites` 数据目录中。更新插件时不要删除该目录。 ## 8. OCR 插件支持对收藏截图执行 OCR，可用于提取字幕、PPT、板书、代码和文档页面中的文字。 可以设置： - 收藏时自动截图； - 收藏后自动 OCR； - 百度 OCR 模型； - 百度 OCR API Key 与 Secret Key； - AI Endpoint 作为可选兜底。 API Key 和 Secret Key 保存在本地插件设置中。若 Vault 或插件配置会同步到其他设备，应确认同步目标可信。没有配置 OCR 时建议关闭自动 OCR，需要时再手动执行。 ## 9. AI 问答 可以为收藏卡片配置 OpenAI 兼容的 `/v1/chat/completions` 接口，用于： - 总结片段内容； - 解释 OCR 文字或截图概念； - 整理学习笔记； - 生成复习题； - 结合收藏上下文进行问答。 需要填写 AI Endpoint、API Key 和模型名称。启用 RAG 后，提问可能会把所选收藏卡片的文本、OCR 和备注作为上下文发送到你配置的接口。 ## 10. B 站播放说明 桌面端推荐 iframe 安全模式，避免原生覆盖层遮挡 Obsidian 或系统界面。 移动端提供： - iframe 兼容模式：播放更稳定，但插件无法跨域读取精确时间和当前帧； - 原生 video 实验模式：可以读取真实时间并由系统播放器接管，但部分视频会受登录、防盗链、地区或格式限制。 移动端不能直接截取跨域 iframe 当前帧。可使用 B 站 videoshot 快照裁剪获得接近当前时间的画面；它不是逐帧精确截图。对截图精度要求很高时，应使用本地/直链视频或手动补图。 ## 11. 推荐工作流 ### 网课学习 ```text 添加课程视频 → 播放到重点 → 插入时间戳或截图 → 收藏片段 → OCR 提取字幕/PPT → 补充自己的理解 ``` ### B 站教程整理 ```text 按主题建立播放列表 → 收藏关键步骤 → 使用 #方法/#案例 标签 → 在收藏中心统一整理 → 回写正式 Markdown 笔记 ``` ### 视频知识库 ```text 观看时先快速收藏 → 稍后按状态筛选待整理卡片 → OCR/AI 辅助处理 → 添加回链、标签和复习状态 ``` ## 12. 数据与备份 建议备份当前插件实际安装目录中的： ```text data.json card-favorites/ ``` 截图和写入的 Markdown 笔记位于 Vault 中，也应跟随 Vault 一起备份。 自动更新只替换签名运行文件，并保留插件数据和设置。不要把自定义数据放入 `main.js`、`manifest.json` 或 `styles.css`。 ## 13. 授权、设备与更新 插件设置中的授权区域支持： - 输入激活码； - 使用恢复码； - 管理授权设备； - 联网同步授权状态； - 输入续期码； - 主动检查 Pro 更新。 检查更新只在点击后执行，不在后台轮询。更新包会校验发布签名和产品身份，并通过原子替换及备份降低更新失败风险。 公开文档： - 使用手册：`https://peyote.info/plugins/alist-video-note/manual/` - 更新日志：`https://peyote.info/plugins/alist-video-note/changelog/` ## 14. 常见问题 ### 移动端打不开电脑本地视频 移动设备无法访问电脑磁盘路径。请把视频放进 Vault，或使用手机能够访问的 AList/HTTPS 地址。 ### B 站 iframe 时间或截图不准确 这是跨域限制。切换原生 video 实验模式，或使用本地/直链视频；videoshot 只能提供近似快照。 ### 收藏后没有 OCR 确认卡片有可用截图，并检查 OCR 模型、API Key、Secret Key、网络和接口配额。未配置时可以保留卡片并稍后手动 OCR。 ### 时间戳无法插入 确认当前存在可编辑的 Markdown 笔记，并且播放器已打开视频。只读视图或没有活动编辑器时无法写入。 ### 更新失败 确认许可证仍有更新权益，网络可访问授权服务，并检查实际插件目录是否可写。不要删除 `data.json` 或 `card-favorites` 来重试更新。 ## 15. 隐私与安全 - 播放列表、笔记、截图和收藏默认保存在本地； - AList、B 站、OCR 和 AI 请求会访问你选择的第三方服务； - 不要分享激活码、恢复码、API Key、Secret Key 或插件数据目录； - 只从 Peyote 官网安全下载页获取安装包； - AI 与 OCR 结果应人工核对，不应直接作为事实依据。