Skip to content

Repository files navigation

🎓 videnote

把考公 / 考研网课变成带「题目截取 + 要点解析 + 关键截图 + 时间戳」的结构化复习笔记 把整个课程合集,一键变成一本讲义

Turn exam-prep lecture videos (考公/考研) into structured revision notes — questions captured with answers & analysis, key screenshots, timestamp links. Playlist in, printable handbook out. Zero-cost by default.

简体中文 | English

License: MIT Python Platform Cost PRs Welcome

网课视频 → 结构化笔记

⬅️ 网课视频的一帧  |  videnote 生成的笔记(公式已转 LaTeX)➡️


🤔 考公考研党都懂的痛

两小时的行测网课,老师说"大家看这道题"的时候——字幕里什么都没有。 看完感觉都会了,做题发现全忘了,想找那道例题得把视频重新拖一遍。

网课的重点在画面上的题目和板书,不在口播里。videnote 让 AI 真的看画面,把网课变成能直接刷题复习的笔记:

  • 📝 题目截取 —— 题干、选项、答案、解析四要素完整提取,解析严格来自老师的讲解,不是 AI 自己编的
  • 答案速查表 —— 笔记末尾自动生成「章节 × 题号 × 答案」表,自测对答案不用翻全文
  • 🎯 考点要点 —— 解题技巧、口诀、易错点优先收录;每节小标题就是考点(如"图形推理-对称性考法")
  • 🖼️ 内容感知关键帧 —— 像素差定位内容变化 → 稳定段末尾截取 → OCR 文本差去重 → pHash 聚类。截图是 AI 看过画面之后选的,不是对着字幕猜位置盲截
  • 👀 双通道融合 —— 字幕(听到的)× 画面(看到的)互补。ASR 把"通分"听成"通风"?以板书为准。手写公式?转写成 LaTeX
  • 🔗 时间戳锚定 —— 每个章节、每张图都可点击跳回视频原位置,复习时想听原讲解一键跳转
  • 📚 合集 → 讲义 —— 46P 的系统课链接丢进来,出来一本带总目录、章节编号的完整讲义(Markdown / Word / PDF)
  • 💰 零成本 —— 默认全程智谱免费模型(glm-4.1v-thinking-flash + glm-4.5-flash),一分钱不花

🤖 不想自己动手?复制给你的 AI 工具

零 API key 模式:videnote 可以作为 Claude Code skill 运行——预处理脚本负责下载/字幕/挑帧,AI 工具自己读画面、写笔记,全程不需要注册任何 key。

把下面这段原样粘贴给 Claude Code / Cursor / Codex 等 AI 编程工具:

帮我把 videnote 安装为 AI 工具的 skill(零 API key 模式):
1. git clone https://github.com/duchenone/videnote && cd videnote && pip install -e .
2. 把 skill/videnote 目录复制到我的 skills 目录
   (Claude Code 是 ~/.claude/skills/,其他工具按其 skill 目录约定)
3. 用 python -m videnote.prepare 对一个短的 B站视频做冒烟测试
4. 完成后告诉我:以后我粘贴视频链接说"做笔记"就行了

装好后,对 AI 说一句"帮我把这个视频做成笔记" + 粘贴链接即可。

也可以走传统 CLI 模式(videnote <url>,用智谱免费模型,需要免费 key)——两种模式任选。

🆚 和同类工具的区别

传统字幕总结类 videnote
视频里的题目 完全丢失(字幕里没有题) 题干/选项/答案/解析完整截取
截图怎么选 LLM 只看字幕猜位置,盲截那一秒 看过画面再选:内容变化检测 + 文本差去重
画面信息 仅作插图(或没有) VLM 转写题目/板书/公式,参与笔记生成
复习自测 不支持 答案速查表,刷题模式直接对答案
合集课程 一次一个视频 合集 → 带目录的完整讲义
甜区 通用视频 考公 / 考研网课(题目 + PPT + 板书密集型)
成本 需自配付费 API 默认全程免费模型

📦 安装

git clone https://github.com/duchenone/videnote.git
cd videnote
pip install -e .

需要一把 智谱 API key(免费注册,读帧和合成模型均不收费):

export ZHIPU_API_KEY=你的key      # Windows: set ZHIPU_API_KEY=你的key

🚀 使用

# 单个网课视频 → 笔记
videnote "https://www.bilibili.com/video/BVxxxx"

# 系统课合集 → 讲义(自动识别,无需开关)
videnote "https://www.bilibili.com/video/BVxxxx"

# 只要某一分 P
videnote "https://www.bilibili.com/video/BVxxxx?p=2"

# 本地视频
videnote ./lecture.mp4

# 同时输出 Word + PDF(需 pandoc;PDF 经本机 Word/LibreOffice 导出)
videnote <url> --formats docx,pdf
📄 看看真实输出(18 分钟考研数学板书课)
# 未定式∞-∞型极限的求解方法

> 未定式∞-∞型极限可通过通分、倒代换、拉格朗日中值定理、提因式和
> 分子有理化等方法求解。通分法将未定式转化为分式形式……

## 大纲
- [00:00](https://www.bilibili.com/video/BV1Fry9BcE8q?p=2&t=0) ∞-∞型极限的求解方法
- [04:01](https://www.bilibili.com/video/BV1Fry9BcE8q?p=2&t=241) 通分与泰勒解法
- ...

## [00:00](...) 未定式∞-∞型极限的求解方法
- 通分法:适用于有分母的未定式∞-∞型极限。
- 倒代换:令 $x = \frac{1}{t}$ 创造分母再通分。
- 拉格朗日中值定理:将 $f(b) - f(a)$ 转换为 $f'(\xi)(b - a)$。
- 分子有理化:如 $\sqrt{A} - \sqrt{B}$ 乘以 $\sqrt{A} + \sqrt{B}$。

![图6 03:03](assets/frame_00183s.jpg)
*图6:未定式∞-∞型函数数列极限的求解方法及相关技巧*

✅ 公式是 VLM 从手写板书转写的 LaTeX ✅ 时间戳点击跳回视频原位置 ✅ 截图自动截取在老师写完、画面停稳的时刻

📝 题目截取输出结构(v0.2 新增,例题讲解类视频)

每节笔记中,讲到的题目会单独成块;文末附答案速查表:

### 题目精析

**题1** 从所给的四个选项中,选择最合适的一个填入问号处…… [图2]

- A. ...
- B. ...
- C. ...
- D. ...

> 答案:**D** 题干图形均为轴对称图形,且对称轴方向依次顺时针旋转45°……

---

## 答案速查

| 章节 | 题号 | 答案 |
|---|---|---|
| 对称性考法 | 题1 | D |
| 对称性考法 | 题2 | B |

注:以上为输出结构示意。题目截获率等指标待真实例题课实测后公布(见 Roadmap)。

⚙️ 工作原理

视频 → 1fps采样 → 内容感知关键帧(像素差→稳定段→OCR文本差→pHash去重)
     → 两阶段VLM(flash筛帧 → thinking精读: 题目完整转写 / 公式转LaTeX)
     → 字幕(官方CC → 必剪ASR → whisper 降级链) × 画面对齐
     → map-reduce合成(考点要点 + 题目四要素) → Markdown / Word / PDF
  • 字幕源降级链:B站官方字幕 → 必剪(BCut)免费转写 → faster-whisper 本地,哪层能用走哪层
  • 中间结果全量缓存,中断重跑自动续跑;合集逐 P 独立缓存
  • 追求更高合成质量可在 config.yaml 一键换 DeepSeek

🗺️ Roadmap

  • 内容感知关键帧抽取
  • 字幕×画面双通道融合(公式转 LaTeX)
  • 时间戳锚定笔记
  • 合集 → 讲义
  • Word / PDF 导出
  • 题目截取 + 答案速查(考公考研定向)
  • 题目截获率实测(真实例题课,数据将公布于 README)
  • Anki 卡片导出(题目直接进记忆曲线)
  • MCP Server(在 Claude Code / Cursor 里直接调用)
  • YouTube 支持
  • Web UI

🙏 致谢

  • 必剪转写接口实现参考了 BiliNote(通用视频笔记工具,推荐一并关注)
  • 读帧与合成由 智谱 GLM 免费模型驱动

📄 License

MIT © duchenone

About

把 B站考公/考研网课变成带题目截取+要点解析+关键截图+时间戳的结构化复习笔记 | Turn exam-prep lecture videos into structured notes with questions, analysis, screenshots and timestamps

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages