1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | bili-note |
| 作者/维护者 | Rimagination（Bai Chuan，清华大学生态环境方向在读博士） |
| 来源链接 | https://github.com/Rimagination/bili-note |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars | 224（数据来自 GitHub API） |
| Forks | 13（数据来自 GitHub API） |
| 最新版本 | 仓库未打 Release 标签，以最近一次提交（2026-06-25）为准 |
| 安装方式 | 对 Agent 说“请帮我安装这个 skill：<仓库地址>”，或手动将仓库克隆至对应技能目录 |
项目自述名称：README 与 Logo 中自称“Bili Note”（含空格），本报告统一使用仓库名 bili-note 作为正式名称。
2. 功能介绍与亮点
bili-note 把 B 站视频、图文（动态/opus）转换成可学习、可检索、可追问的 Markdown 笔记，设计上不同于常见的“一键摘要”类工具：
- 完整归档而非压缩摘要：保存完整字幕、正文、图片、评论、元数据与证据索引，关键判断以编号链接回原文位置，方便复核追问。
- 按信息量动态定标：先按时长、字幕字数、互动热度生成推荐字数与结构密度，再动手写作，避免短视频与长课程被压成同样长度。
- 字幕密度自查：字幕明显偏少时（如内容主要靠画面传达），会提示需关键帧或视觉理解兜底，而非写成“看似完整”的笔记。
- 默认零第三方依赖：核心路径全部基于 B 站公开接口与 Python 标准库；网页字幕、本地转写为按需启用的增强路线。
3. 适用场景
固定分类：内容创作与知识管理。
适合经常在 B 站学习技术、课程或观点类内容，希望把视频/图文沉淀为个人知识库（如 Obsidian）材料的用户；也适合需要为后续 Agent 问答准备可引用证据的场景，如整理系列课程笔记、复盘长视频方法论、归档图文教程配图与关键评论。
4. 跨 Agent 兼容性
- Codex：原生支持。README 与 SKILL.md 的示例路径（如
~/.codex/skills/bili-note）与安装说明均以 Codex 为目标运行环境编写。 - Claude Code：未验证。现有文档未见 Claude Code 相关的安装说明或测试记录。
- OpenClaw：未验证，文档未提及。
- Hermes Agent：未验证，文档未提及。
技能本体是标准的 SKILL.md（YAML front matter + 指令正文）格式。
5. 推荐理由
在同类“视频转笔记”工具普遍走“云端大模型摘要”路线的背景下，bili-note 坚持“先完整归档证据、再按信息量分配详略”，笔记可追溯、可复核，且默认不依赖任何付费 API；作者长期活跃、持续维护多个学术与内容工具类技能，工程质量与安全边界说明清晰，适合希望把 B 站内容真正沉淀为可复用知识库、而非只要一段摘要的用户。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | GitHub 224 星/13 次 fork，落在 200–1k 星区间；开发者社区 LINUX DO 上的独立介绍帖获 682 次浏览、72 个赞、58 次收藏，多位第三方用户在长达一周的讨论串中分享真实使用体验、提出技术问题，并出现与同类项目的公开对比 |
| 可用性 | 8 | 安装只需让 Agent 读取 GitHub 链接即可完成；README（207 行）与 SKILL.md（345 行）文档详尽且含完整示例；默认路径不依赖任何第三方 Python 库，仅增强功能（网页 AI 字幕、本地语音转写）需要额外环境配置；最近一次提交为 2026-06-25，在近 3 个月维护窗口内 |
| 安全性 | 8 | 见下方安全检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① shell 命令及权限范围 | 本机运行 Python 脚本，读写用户指定的本地笔记目录，无需系统级权限 |
| ② 运行时联网外发 | 默认路线仅访问 B 站公开接口（元数据、公开字幕、图文、评论）；增强路线通过用户自己已登录的浏览器会话获取网页字幕，不经第三方服务器中转 |
| ③ API Key/凭据存储 | 默认路线无需任何 API Key；涉及登录态的增强功能由独立的浏览器访问工具管理会话，SKILL.md 明确要求不打印、不存储 auth-key/cookie/token |
| ④ 可疑指令排查 | SKILL.md 正文明确列出“不要做”边界（不绕过登录/付费墙/私密内容、不扩展为 SaaS/云服务），未发现提示词注入或隐蔽外发指令 |
| ⑤ 作者信誉 | 作者为长期活跃的开源作者，GitHub 账号已有 7 年历史、公开仓库 30 余个，涵盖学术工具、地理数据处理等多个领域，无刷星或造假迹象 |
| ⑥ License | MIT，明确 |
| ⑦ 最近维护 | 最近一次提交 2026-06-25 |
综合评分（三项均值）：7.3
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 bili-note 的差异 |
|---|---|---|
wdkns-skills 合集中的 bilibili-render-pdf 子技能（合集仓库整体 625 星，不代表该子技能自身热度） |
依赖关键帧视觉理解，把 B 站内容渲染为 PDF | 产出形式是视觉化 PDF 而非可检索、可追问的 Markdown 知识库材料；更依赖多模态视觉理解，对无字幕/画面信息密集的视频处理路径不同 |
| BiliNote（另一独立项目，注意与 bili-note 名称相近但非同一作者/仓库） | 桌面端 AI 视频笔记工具，调用 OpenAI/DeepSeek 等云端大模型生成摘要，同时支持 YouTube | 是独立桌面应用而非 Agent 技能，核心是“总结”而非“完整归档证据”；依赖云端大模型 API，无 bili-note 默认零依赖的轻量路径 |
差异化在于：保留完整原始材料（字幕、图文正文、图片、评论、证据索引）供后续复核与追问，笔记长度按内容信息量动态分配而非统一压缩比，默认路径不依赖任何付费云端模型。
8. 用户评价
- 开发者社区 LINUX DO《Bili Note：把 B 站视频和图文整理成可追问的 Markdown 笔记》帖（2026-06-22 起，https://linux.do/t/topic/2452065）：用户 Anya_Forger 评价“这个项目很好，已 star”；用户 xuyanz 表示“之前我一般是批量下载字幕建立本地知识库，太耗费时间了”；用户 Ningx 指出已有相似项目 wdkns-skills，作者随后在帖内公开对比了两者的技术路线差异；用户 Conley 表示受此启发自制了类似的 Douyin/B 站转 Markdown 技能。该帖累计 682 次浏览、72 个赞、58 次收藏。
9. 其他补充
同一作者维护有面向抖音内容的姊妹技能 dy-note，与 bili-note 共享本地缓存与语音识别环境，属同一“社交媒体内容归档”产品线延伸；作者主页下还有多个学术研究类技能（论文检索、图表数字化、研究提问打磨等）。
10. 安装使用方式
Codex（已验证支持）：对 Agent 发送：
请帮我安装这个 skill：
https://github.com/Rimagination/bili-note安装完成后，直接发送 B 站视频或图文链接即可触发提取，例如：
请帮我提取这个视频的内容：https://www.bilibili.com/video/BVxxxx/加“和评论区有用的内容”可一并整理评论；说明目标路径可保存到指定目录。
其他 Agent：可尝试手动克隆仓库至对应技能目录后加载 SKILL.md，兼容性未经验证，建议先小范围测试。
如需网页字幕或音频转写兜底，可先运行仓库自带环境检查脚本确认 Chrome、ffmpeg、Whisper/faster-whisper 等依赖；默认路径无需这些依赖。
11. 注意事项
- 仓库未发布正式 Release 版本号，以最近提交时间为准跟踪更新。
- 文档与安装示例主要面向 Codex 编写，在其他 Agent 上使用前建议先手动验证 SKILL.md 路径解析是否正常。
- 增强功能依赖 Chrome、ffmpeg、Whisper/faster-whisper 等本地环境，首次配置需额外时间；默认路径不受此限制。
- 涉及登录态的增强能力通过用户自己的浏览器会话获取，建议仅在受信任设备上使用，并遵守 B 站服务条款用于个人学习归档。