bilibili-learner · B站视频学习助手（HanaAgent Skill）

一个 HanaAgent skill（技能包）：把 B站教育/学术视频变成结构化学习资料。

输入一个 B站链接或 BV 号，走完一整条流水线：

视频 → 语音转文字 → AI 分析提取知识点 → Word 学习笔记 → 复习题库 → 后续抽查

能力全景

环节	产出	说明
视频信息获取	标题 / UP 主 / 分集列表	B站公开 API，无需登录
视频下载	360p mp4（约 30MB/集）	scripts/bili_download_audio.py
语音转文字	纯文本 + 带时间戳两份 txt	faster-whisper tiny，CPU int8，中文
AI 知识点分析	视频概览 + 5~8 张知识点卡片 + 知识框架图	卡片含标题/核心概念/详细说明/关键要点
Word 学习笔记	.docx，封面 + 目录 + 卡片 + 框架 + 建议	python-docx
复习题库	12 道左右混合题型 JSON（选择/填空/简答，标难度）	供后期抽查
抽查复习	从题库随机抽题	模仿考研真题题型风格

典型用途：考研、专业课程学习，把 B站上的好课消化成自己的笔记和题库。

安装

把本仓库放进 HanaAgent 的 skills 目录（如 ~/.hanako/skills/bilibili-learner），重启生效。技能由 Agent 在收到"分析这个视频 / 做笔记 / 提取知识点"等请求时自动触发。

依赖

pip install requests faster-whisper av python-docx

首次转写会自动下载 whisper tiny 模型（约 150MB）。

使用

给助手一个 B站链接或 BV 号，再说一句学习诉求，例如：

分析这个视频 https://www.bilibili.com/video/BV1J24y1E7Yc

帮我总结这个视频，生成学习笔记和复习题

这视频做笔记，考考我

助手会依次执行：下载（360p）→ 转写 → 分析 → 生成 .docx 笔记 → 生成复习题 JSON；之后说"考考我"即可从题库抽题。

工作流细节

1. 下载：python scripts/bili_download_audio.py {BV号} {集数}，内容存到 bili_temp/
2. 转写：python scripts/bili_transcribe.py {视频路径}，输出 {名称}_转写.txt 与 _转写_时间戳.txt
3. 分析：AI 读转写文本（注意同音错字，如"咖啡品定"→"康复评定"），产出结构化知识点
4. 出笔记：python-docx 生成封面/目录/知识点卡片/知识框架/实践价值/学习建议
5. 出题库：JSON，choice/fill/short 混合，easy/medium/hard 难度标注

目录结构

bilibili-learner/
├── SKILL.md                      # 技能说明：触发词 + 五步工作流
├── scripts/
│   ├── bili_download_audio.py    # B站 API 拿直链并下载（360p）
│   └── bili_transcribe.py        # faster-whisper 语音转文字（中文）
└── README.md

License

MIT