阅影 yueying
让 AI 编程助手看懂视频。 Claude Code、Cursor 这些工具读得了图片和文字，却读不了视频。阅影把一段视频（本地文件，或 B站 / YouTube / 抖音 / 小红书等链接）拆成 AI 能读的东西：
- 文字稿：优先抓平台自带字幕；没有就用本地语音识别（faster-whisper），中、英、日、韩、法、德、俄等几十种语言自动检测，全程离线，不上传、不花钱
- 关键帧：在画面明显变化的地方抽帧，每张左下角烧上编号和时间；再拼成九宫格总览图，AI 一眼看完全片走向
- 一份 report.md：简介、章节、画面总览、关键帧清单、按段落带时间戳的文字稿，AI 读这一个文件就能开始干活
然后你就可以对 Claude 说：「帮我看看这个视频，把里面的步骤整理成笔记」「照着这个教程把代码写出来」「这个视频 10 分钟处讲了什么」。
安装
需要 Python 3.9 以上。ffmpeg 会自动带上，不用单独装。
Windows：下载本仓库，双击 install.cmd。它会创建独立的 Python 环境、装好依赖、把 Claude Code 技能放到 ~/.claude/skills/yueying。
手动安装（任何系统）：
pip install yueying # 或 pipx install yueying
pip install "yueying[cuda]" # 有 NVIDIA 显卡再加这个，语音识别快很多
yueying --install-skill # 把 Claude Code 技能装到 ~/.claude/skills/yueying
想装 GitHub 上的最新版：pip install git+https://github.com/vsh5dvsch7-png/yueying.git。
装好技能后，Claude Code 会在需要看视频时自动调用它。Cursor 等支持 Agent Skills 标准的工具，把 ~/.claude/skills/yueying/SKILL.md 复制到对应目录即可。
第一次做语音识别会下载模型（默认 large-v3-turbo，约 1.6 GB）。国内访问 HuggingFace 慢的话，程序会自动切换到 hf-mirror.com 镜像。
用法
yueying 视频.mp4
yueying "https://www.bilibili.com/video/BVxxxx"
yueying "https://www.youtube.com/watch?v=xxxx" --out ./notes/xxx
输出目录默认是 ./yueying_out/<视频名>/：
report.md 给 AI 读的总索引
transcript.txt 按段落、带时间戳的文字稿
transcript.srt 字幕文件，可直接给播放器用
grid_01.jpg ... 九宫格总览图
frames/ 单帧大图，f003_00m15s.jpg 这样命名
manifest.json 给程序读的结构化结果
常用参数：
| 参数 | 作用 |
|---|---|
--lang zh |
指定语言（默认自动检测） |
--model small |
换小模型，没显卡的机器快很多；可选 tiny / base / small / medium / large-v3 / large-v3-turbo |
--device cpu |
强制用 CPU |
--frames 30 |
最多抽多少帧（默认按时长自动，上限 60） |
--scene 0.2 |
场景切换灵敏度，越小越敏感 |
--no-asr |
没字幕也不做语音识别（只要画面） |
--no-frames |
不抽画面（只要文字） |
--force-asr |
有字幕也重新识别 |
--cookies-from-browser chrome |
用浏览器登录态下载（B站 高清 / 会员视频） |
--keep |
保留下载的原视频 |
在 Claude Code 里用
装好技能后，直接说：
帮我看看 D:\课程\第3课.mp4，把知识点整理成笔记
这个视频 https://www.bilibili.com/video/BVxxxx 里的代码帮我抄下来
Claude 会自己跑 yueying，读 report.md 和关键帧，然后按你的要求整理。引用视频内容时它会带上时间点，方便你回看。
工作原理
视频/链接 ──► yt-dlp 下载（≤720p）+ 抓字幕
──► ffmpeg 抽 16k 音频 ──► faster-whisper 识别（有字幕则跳过）
──► ffmpeg 场景检测 ──► 抽帧 ──► Pillow 烧时间戳、拼九宫格
──► report.md / transcript / manifest.json
代码都在 src/yueying/，每个文件一件事：
| 文件 | 管什么 |
|---|---|
cli.py |
命令行入口，串起下面几步 |
download.py |
yt-dlp 下载、挑字幕语言 |
ffm.py |
ffmpeg 封装：探测时长分辨率、抽音频、导内嵌字幕 |
subs.py |
解析 srt / vtt / B站 json 字幕，去掉 YouTube 自动字幕的重复 |
asr.py |
faster-whisper 语音识别，自动选 GPU / CPU，失败回退 |
frames.py |
场景检测、定抽帧时间点、抽帧、烧时间戳、拼九宫格 |
report.py |
生成 report.md、transcript、manifest |
常见问题
识别不准？ 换大模型 --model large-v3，或指定语言 --lang ja。专有名词和代码容易听错，以画面为准，AI 会对照关键帧。
B站 下载失败？ 试试 --cookies-from-browser chrome（先在 Chrome 里登录 B站）。
没有 NVIDIA 显卡很慢？ 用 --model small，一段 10 分钟的视频大约 1 到 2 分钟识别完。
想要更多画面？ --frames 60 --scene 0.2。
致谢
- faster-whisper、yt-dlp、imageio-ffmpeg、Pillow
- 九宫格烧时间戳的做法参考了 video-vision-mcp，按时长分档抽帧参考了 video-analyzer-skill
许可
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file yueying-0.1.0.tar.gz.
File metadata
- Download URL: yueying-0.1.0.tar.gz
- Upload date:
- Size: 21.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ab373df9629334c4bfed7e09fa1b2aa0428c4d64d8256bc9bd453a42bd128a72
|
|
| MD5 |
a5bd505a6d88a0aee9960344cb540437
|
|
| BLAKE2b-256 |
17066255cb7f69d7d95396e2a53058b7cc5e2ccf56b593bc5434a78355536e94
|
Provenance
The following attestation bundles were made for yueying-0.1.0.tar.gz:
Publisher:
publish.yml on vsh5dvsch7-png/yueying
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
yueying-0.1.0.tar.gz -
Subject digest:
ab373df9629334c4bfed7e09fa1b2aa0428c4d64d8256bc9bd453a42bd128a72 - Sigstore transparency entry: 2756495505
- Sigstore integration time:
-
Permalink:
vsh5dvsch7-png/yueying@37378a35d81ab047e060ea682183cd0f1df64220 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/vsh5dvsch7-png
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@37378a35d81ab047e060ea682183cd0f1df64220 -
Trigger Event:
release
-
Statement type:
File details
Details for the file yueying-0.1.0-py3-none-any.whl.
File metadata
- Download URL: yueying-0.1.0-py3-none-any.whl
- Upload date:
- Size: 21.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ca364e9307af9dfb824360064fe2daeb142a743baac38d9f3ced11c84abfb79f
|
|
| MD5 |
f690c7c1cce1fbb12b098b79d95ce544
|
|
| BLAKE2b-256 |
731e1f5deb9fa8aea04ca6066411951c1703d19cdd7125c26be360d072a010ad
|
Provenance
The following attestation bundles were made for yueying-0.1.0-py3-none-any.whl:
Publisher:
publish.yml on vsh5dvsch7-png/yueying
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
yueying-0.1.0-py3-none-any.whl -
Subject digest:
ca364e9307af9dfb824360064fe2daeb142a743baac38d9f3ced11c84abfb79f - Sigstore transparency entry: 2756495527
- Sigstore integration time:
-
Permalink:
vsh5dvsch7-png/yueying@37378a35d81ab047e060ea682183cd0f1df64220 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/vsh5dvsch7-png
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@37378a35d81ab047e060ea682183cd0f1df64220 -
Trigger Event:
release
-
Statement type:
