Skip to content
Back to search

bili-note

Extract Bilibili videos and opus/article posts into readable Markdown knowledge notes. Use when the user asks to 提取/提炼/总结/整理 B站 or bilibili video/图文/动态/opus content, save a B站 note to a local knowledge base, include useful comments, handle multi-part videos, fetch B站 AI subtitles, download opus images, or fall back to audio transcription.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/rimagination-bili-note/badge.svg)](/listings/rimagination-bili-note)

HTML

<a href="/listings/rimagination-bili-note"><img src="/api/listings/rimagination-bili-note/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

把下面这句话发给 Agent:

请帮我安装这个 skill:
https://github.com/Rimagination/bili-note

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 390 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: bili-note
  3. description: Extract Bilibili videos and opus/article posts into readable Markdown knowledge notes. Use when the user asks to 提取/提炼/总结/整理 B站 or bilibili video/图文/动态/opus content, save a B站 note to a local knowledge base, include useful comments, handle multi-part videos, fetch B站 AI subtitles, download opus images, or fall back to audio transcription.
  4. ---
  5. # Bili Note
  6. 把 B站视频和图文动态变成可检索、可复用的 Markdown 知识笔记。视频优先拿字幕;字幕拿不到时再转写音频;图文优先抓正文、图片和代码块;用户要评论区时抓取评论并过滤无关讨论。
  7. 联网或登录态操作必须先使用 `web-access`。
  8. 网页 AI 字幕支持两条路线:Chrome 使用 `web-access`,Edge 使用开启远程调试的 Chromium DevTools Protocol 直连。两条路线都让已登录的 B站页面自己请求字幕接口,不读取或复制 Cookie/profile。Playwright 临时浏览器不属于受支持路线。
  9. Bili Note 与 DyNote 共享可复用本地资源。默认共享目录是 `%USERPROFILE%\.cache\rimagination-notes`,Qwen3-ASR 环境默认是 `%USERPROFILE%\.cache\rimagination-notes\qwen3-asr-venv`。如果任一 skill 已经安装过 Qwen3-ASR,另一个 skill 必须优先复用,不要重复安装。Hugging Face、Whisper 和 faster-whisper 缓存按本机通用缓存复用。
  10. ## 字幕密度与视觉理解
  11. B 站视频优先拿字幕,但字幕/转写不等于完整理解。长视频如果字幕字数明显偏少,可能说明核心信息在画面、PPT、板书、代码演示、屏幕操作或无解说片段中。
  12. - 每次视频运行都必须先做轻量预检,再询问用户是否开启“关键帧视觉理解”。预检只读取元数据、分P信息和已有字幕文件,不下载视频;它会显示时长、字幕字数、字幕密度和画面依赖建议。收到明确的 `on` 或 `off` 后才能进入后续流程。询问时说明:`on` 会抽取最多 12 帧,先合成为一张 4×3 联系图,再按需要打开单帧,视觉输入会增加 tokens;`off` 只走字幕、转写、评论和元数据路线,节省视觉输入 tokens。
  13. - 用户选择 `on` 时,给 `run_bili_note.py` 传 `--visual-review on`;选择 `off` 时传 `--visual-review off`。脚本默认 `--visual-review ask`,直接在终端运行也会在轻量预检后停下来等待选择。
  14. - 关键帧理解选择只对视频运行生效。图文/动态已有图片材料,按图文视觉理解流程处理。
  15. - 归档后必须读取 `metadata/note_budget.json`。如果 `visual_dependency.needs_visual_review=true`,不要把稀疏字幕写成完整学习笔记。
  16. - 这种情况下,先采用更合适的技术:抽取代表性关键帧或截图,再做 OCR 或多模态视觉理解;必要时重新抓网页 AI 字幕或补本地自动语音识别。
  17. - 如果当前接入的模型或工具不能看图,必须告诉用户:关键帧理解属于高级视觉能力,需要多模态模型、OCR 工具或人工查看;当前只能基于字幕/元数据生成有限笔记并标注覆盖范围。
  18. - 最终笔记和用户回复要转述 `visual_dependency.warnings`,并说明是否已经补了视觉证据。
  19. 关键帧视觉理解采用低成本的两阶段读取:先看一张 4×3 联系图建立全片画面地图;联系图中出现文字、代码、图表或界面细节时,再依据工作目录的 `keyframes_manifest.json` 打开对应单帧。归档后对应路径是 `archive_dir/metadata/keyframes_manifest.json`。不要默认把 12 张完整图片全部送入模型。
  20. 选择 `on` 后,先查看 `keyframes/contact_sheet.png`,再结合 `keyframes/README.md` 和工作目录的 `keyframes_manifest.json` 定位时间点。把视觉观察写入材料包的 `metadata/visual_review.md`,每条关联 `KF-Pxx-xx`、分P、时间和观察结论;不确定的画面标记为待核实。关键帧证据可通过 `indexes/关键帧索引.jsonl` 和总证据索引回查。
  21. ## 依赖与环境检查
  22. 默认路线尽量零第三方 Python 依赖:视频元数据、公开字幕、图文正文、图片清单、评论、归档、证据索引和笔记预算都用标准库完成。网页 AI 字幕和音频转写是增强路线,不是启动门槛。
  23. 第一次使用、换机器、用户怀疑依赖不全,或准备使用网页 AI 字幕 / 音频转写兜底时,先运行:
  24. ```powershell
  25. $skill = "$env:USERPROFILE\.codex\skills\bili-note"
  26. $py = "python"
  27. & $py "$skill\scripts\check_environment.py"
  28. ```
  29. 根据检查结果选择路线:
  30. - `public_subtitles_comments_archive=OK`:优先走默认字幕/图文、评论和归档流程。
  31. - `browser_ai_subtitles=OK`:当公开接口只有 `ai-zh` 且 `subtitle_url` 为空时,走 Chrome + `web-access` 网页 AI 字幕。
  32. - `edge_browser_ai_subtitles=OK`:需要 Edge 远程调试端口和 `websocket-client`,总入口加 `--browser edge`。
  33. - `audio_asr_fallback=OK`:只有字幕和网页 AI 字幕都不可得、且用户确实需要完整转写时,才走音频转写。中文或未指定语言优先共享 Qwen3-ASR;明确外语视频优先 Whisper 系后端。
  34. - 某个增强能力缺失时,只说明该路线暂不可用;不要把它说成整个 skill 不可用。
  35. - 网页登录态只通过已授权的 Chrome `web-access` 页面或 Edge 远程调试页面使用;不要读取或复制 Cookie/profile,不要强制结束用户浏览器进程。两种浏览器路线都不可用时就跳过网页 AI 字幕并说明覆盖范围。
  36. ## 默认流程
  37. 1. 读清用户要什么:视频或图文链接、是否要评论区、保存路径、是否需要全文材料或只要提炼。
  38. 2. 如果是首次使用、依赖状态不明、字幕抓取失败或用户要求音频转写,先用 `check_environment.py` 判断当前可走路线。
  39. 3. 如果是视频,先让总入口完成轻量预检;它只抓元数据和字幕,不下载视频。根据预检结果向用户说明建议,并完成关键帧视觉理解询问;用户选择后把 `--visual-review on` 或 `--visual-review off` 传给总入口。
  40. 4. 优先用 `run_bili_note.py` 一键完成可自动化部分。它会自动识别 `/video/BV...`、`/opus/...`、`/dynamic/...` 或纯 opus id。
  41. 5. 如果是图文/动态,走 `extract_bilibili_opus.py` 路线:抓正文、标题、作者、发布时间、图片、代码块、图文证据索引;用户加 `--comments` 时抓图文评论。
  42. 6. 如果是视频,优先下载字幕:
  43. - 普通字幕 URL 可用时,直接用 `--download-subtitles`。
  44. - 如果普通接口显示 `ai-zh` 但 `subtitle_url` 为空,不要说“没有字幕”;改走“网页 AI 字幕”流程。
  45. - 如果字幕仍不可得,再按需要下载音频并用本地自动语音识别转写。中文优先 Qwen3-ASR,明确外语优先 Whisper 系后端。
  46. 7. 用户要求评论区时,用 `--comments` 抓取主评论和子评论;写入笔记时过滤打卡、求资料、广告、闲聊等技术无关内容。
  47. 8. 归档原始材料:把完整字幕或图文正文、图片、完整评论、元数据和 JSONL 索引存到知识库旁边的长期目录。
  48. 9. 用户选择 `on` 时,在写前定标前查看 `keyframes/contact_sheet.png`,必要时查看对应单帧,并保存 `metadata/visual_review.md`。
  49. 10. 写前定标:必须先读取 `metadata/note_budget.json`,把推荐字数区间、压缩比目标、写作粒度、互动质量倍率、证据块数量和 `visual_dependency` 作为本次笔记的写作目标。视频按时长、字幕字数、证据块、评论量和互动质量定标;图文按正文长度、图片/代码/证据块、评论量和互动质量定标。
  50. - 如果 `visual_dependency.risk` 是 `medium` 或 `high`,先补关键帧/OCR/多模态视觉理解,或明确告诉用户当前缺少视觉理解能力,不能写成完整解析。
  51. 11. 按预算写 Markdown:默认写成“学习型笔记”,目标是让人或 Agent 像学完一节课或读完一篇教程一样获得概念、方法、判断标准、实践步骤和自测题;根据预算决定详略,不要把长课和短视频写成差不多字数。来源、覆盖范围和归档路径放到后半部分。正文证据默认用论文式编号 `[1][2]`,不直接堆长证据 ID。
  52. 12. 写后验收:用 `score_bili_note.py` 校验笔记字数、压缩比、每分钟/每篇笔记密度和证据引用比例。评分只做 QA 和微调,不代替写前定标;太短时优先补“学习收获、知识地图、概念卡、实战流程、坑点、自测题”,不要只堆分P摘要或段落摘要。
  53. ## 常用命令
  54. 在 PowerShell 中先设定 skill 路径:
  55. ```powershell
  56. $skill = "$env:USERPROFILE\.codex\skills\bili-note"
  57. $py = "python"
  58. ```
  59. ### 0. 检查依赖和可用路线
  60. ```powershell
  61. & $py "$skill\scripts\check_environment.py"
  62. ```
  63. 需要给其他脚本读取时输出 JSON:
  64. ```powershell
  65. & $py "$skill\scripts\check_environment.py" --json
  66. ```
  67. ### 1. 一键提取和归档
  68. 默认先用总入口。它会自动跳过已有输出,适合断点续跑。
  69. ```powershell
  70. & $py "$skill\scripts\run_bili_note.py" "https://www.bilibili.com/video/BVxxxx/" `
  71. --work-dir ".\tmp_bili_extract" `
  72. --archive-dir "D:\knowledge\知识库\Rag技术\原始材料\BVxxxx_视频短标题" `
  73. --visual-review on `
  74. --comments
  75. ```
  76. 如果用户选择关闭,把上面的 `--visual-review on` 改为 `--visual-review off`。每次视频运行都重新询问,不能沿用上一次选择。
  77. 图文/动态也用同一个入口:
  78. ```powershell
  79. & $py "$skill\scripts\run_bili_note.py" "https://www.bilibili.com/opus/1194341967364882439" `
  80. --work-dir ".\tmp_bili_opus" `
  81. --archive-dir "D:\knowledge\知识库\Rag技术\原始材料\O1194341967364882439_图文短标题" `
  82. --comments
  83. ```
  84. 如果只想保存图文正文和图片 URL,不下载图片文件,加:
  85. ```powershell
  86. --no-download-images
  87. ```
  88. 如果普通接口没有字幕,但网页播放器能拿到 AI 字幕,Chrome 先用 `web-access` 打开已登录页面并取得 target id,然后加:
  89. ```powershell
  90. --browser-target "CDP_TARGET_ID"
  91. ```
  92. 运行后先看:
  93. - `bili_note_run_report.md`:本次跑了什么、跳过了什么、下一步读哪里。
  94. - `visual_preflight.json`:询问前的时长、字幕密度、风险和建议,方便复核本次选择依据。
  95. - `keyframes/contact_sheet.png`:开启关键帧视觉理解时生成的 4×3 联系图。
  96. - `keyframes_manifest.json`:工作目录中的关键帧编号、分P、时间和单帧路径。
  97. - `archive_dir/metadata/keyframes_manifest.json`:归档后的关键帧清单。
  98. - `archive_dir/metadata/visual_review.md`:视觉模型对关键帧的观察结果,由 Agent 在理解后写入。
  99. - `archive_dir/indexes/证据索引.jsonl`:写总结时可引用的图文/字幕/评论证据块。
  100. - `archive_dir/indexes/图文全集.md`:完整图文正文合集。
  101. - `archive_dir/indexes/字幕全集.md`:完整字幕合集。
  102. - `archive_dir/metadata/note_budget.json`:推荐笔记字数、压缩比、写作粒度和字幕稀疏时的画面依赖提示。
  103. - `archive_dir/metadata/visual_preflight.json`:归档后的关键帧选择预检记录。
  104. ### 2. 抓元数据和分P目录
  105. ```powershell
  106. & $py "$skill\scripts\extract_bilibili.py" "BVxxxx" --out ".\tmp_bili_extract"
  107. ```
  108. ### 3. 下载普通公开字幕
  109. ```powershell
  110. & $py "$skill\scripts\extract_bilibili.py" "BVxxxx" --out ".\tmp_bili_extract" --parts all --download-subtitles
  111. ```
  112. ### 4. 下载网页 AI 字幕
  113. 当 `subtitle_probe.json` 里有 `ai-zh`,但 `subtitle_url` 为空时,使用这条路线。Chrome 需要 `web-access` 的 `/targets` 和 `/eval` 代理接口;Edge 使用直接 CDP 路线。
  114. Chrome 路线:
  115. 1. 用 `web-access` 打开已登录 Chrome 中的 B站视频页,确认页面已加载。
  116. 2. 查看浏览器 target id:
  117. ```powershell
  118. curl.exe -s http://localhost:3456/targets
  119. ```
  120. 3. 下载 AI 字幕:
  121. ```powershell
  122. & $py "$skill\scripts\fetch_browser_ai_subtitles.py" --target "CDP_TARGET_ID" --out ".\tmp_bili_extract"
  123. ```
  124. Edge 路线:
  125. 1. 用 `--remote-debugging-port=9222` 启动 Edge 独立实例,在其中登录 B 站并打开视频页。
  126. 2. 安装可选依赖:`python -m pip install websocket-client`。
  127. 3. 运行总入口:
  128. ```powershell
  129. & $py "$skill\scripts\run_bili_note.py" "BVxxxx" `
  130. --work-dir ".\tmp_bili_extract" `
  131. --browser edge `
  132. --subtitle-mode browser
  133. ```
  134. 也可以直接运行字幕脚本;它会优先选择 Edge 中 URL 包含 `bilibili.com` 的页面:
  135. ```powershell
  136. & $py "$skill\scripts\fetch_browser_ai_subtitles.py" `
  137. --browser edge `
  138. --edge-cdp-url "http://127.0.0.1:9222" `
  139. --out ".\tmp_bili_extract"
  140. ```
  141. 输出包括:
  142. - `browser_ai_subtitle_urls.json`:每个分P的 AI 字幕 URL。
  143. - `browser_ai_subtitle_manifest.json`:下载清单。
  144. - `browser_ai_subtitles\*.txt`:纯文本字幕。
  145. - `browser_ai_subtitles\*.srt`:SRT 字幕。
  146. - `browser_ai_subtitles\*.subtitle.json`:B站原始字幕 JSON。
  147. 这条路线让 B站页面自己用登录态请求 `/x/player/wbi/v2`,不读取、不打印浏览器 cookie。
  148. 如果下载到的 AI 字幕明显乱码、内容与标题或课程主题不相干,不要把它当作可靠全文。优先标注“AI 字幕质量不可用”,再考虑 ASR 兜底;若 ASR 也不可用,只能基于分P标题、简介、评论和元数据生成有限学习指南,并明确局限。
  149. ### 5. 抓评论区
  150. ```powershell
  151. & $py "$skill\scripts\extract_bilibili.py" "BVxxxx" --out ".\tmp_bili_extract" --comments
  152. ```
  153. 图文评论用总入口或图文脚本:
  154. ```powershell
  155. & $py "$skill\scripts\extract_bilibili_opus.py" "https://www.bilibili.com/opus/1194341967364882439" --out ".\tmp_bili_opus" --comments
  156. ```
  157. 抓取后检查 `comments.md` 和 `comments_raw.json`。写入最终笔记时,只保留与内容主题相关的评论、纠错、技术补充、实践经验和有价值问题。
  158. ### 6. 音频转写兜底
  159. 只有在字幕和网页 AI 字幕都不可用时才用本地自动语音识别。长视频不要默认全量转写,除非用户明确要求。中文或未指定语言默认 `--asr-backend auto` 会优先共享 Qwen3-ASR;明确外语视频时用 Whisper 系后端。
  160. ```powershell
  161. & $py "$skill\scripts\extract_bilibili.py" "BVxxxx" --out ".\tmp_bili_extract" --parts "1,10,38" --download-audio --transcribe --asr-backend auto --asr-model base
  162. ```
  163. 首次使用 Qwen3-ASR 前先安装共享环境:
  164. ```powershell
  165. & $py "$skill\scripts\setup_qwen_asr_env.py"
  166. & $py "$skill\scripts\check_environment.py"
  167. ```
  168. 中文视频可显式指定 Qwen3-ASR:
  169. ```powershell
  170. & $py "$skill\scripts\extract_bilibili.py" "BVxxxx" --out ".\tmp_bili_extract" --parts "1,10,38" --download-audio --transcribe --asr-backend qwen3-asr
  171. ```
  172. ### 7. 归档完整材料
  173. 把临时提取目录整理成长期材料包。这个步骤默认要做,方便后续根据总结继续提问和回查证据。
  174. ```powershell
  175. & $py "$skill\scripts\archive_bili_materials.py" --extract-dir ".\tmp_bili_extract" --archive-dir "D:\knowledge\知识库\Rag技术\原始材料\BVxxxx_视频短标题"
  176. ```
  177. 长期材料包包含:
  178. - `articles/图文全文.md`:完整图文 Markdown。
  179. - `articles/图文全文.txt`:完整图文纯文本。
  180. - `images/`:图文图片和图片清单。
  181. - `indexes/图文全集.md`:合并后的完整图文正文。
  182. - `indexes/图文全集.jsonl`:按图文内容块切分,适合检索和问答。
  183. - `indexes/图文证据索引.md`:图文证据块,适合给总结加引用。
  184. - `indexes/图文证据索引.jsonl`:图文证据块,适合程序检索。
  185. - `subtitles/txt/`:每个分P的完整纯文本字幕。
  186. - `subtitles/srt/`:每个分P的完整 SRT 字幕和时间轴。
  187. - `subtitles/json/`:B站原始字幕 JSON。
  188. - `comments/comments_raw.json`:完整评论原始结构。
  189. - `comments/评论全集.md`:完整评论 Markdown。
  190. - `indexes/字幕全集.md`:合并后的完整字幕,适合人工阅读。
  191. - `indexes/字幕全集.jsonl`:按字幕片段切分,适合检索和问答。
  192. - `indexes/字幕证据索引.md`:按时间段合并的字幕证据块,适合给总结加引用。
  193. - `indexes/字幕证据索引.jsonl`:按时间段合并的字幕证据块,适合程序检索。
  194. - `indexes/评论全集.jsonl`:按评论/回复切分,适合检索和问答。
  195. - `indexes/评论证据索引.jsonl`:按评论/回复生成的证据块。
  196. - `indexes/证据索引.jsonl`:图文/字幕证据和评论证据的合并索引。
  197. - `metadata/`:内容元数据、字幕清单、图文清单、评论清单。
  198. - `metadata/note_budget.json`:按内容信息量和互动质量生成的笔记预算,用于控制长短视频、长短图文的提炼粒度,并提示字幕稀疏时的视觉补证需求。
  199. ### 8. 写前读取预算,写后验收信噪比
  200. 写笔记前先看预算。预算是本次笔记的目标,不是写完后才补救的报告:
  201. ```powershell
  202. Get-Content -Encoding UTF8 "D:\knowledge\知识库\Rag技术\原始材料\BVxxxx_视频短标题\metadata\note_budget.json"
  203. ```
  204. 重点先确定:
  205. - 推荐字数区间:`recommended_note_chars_min` 到 `recommended_note_chars_max`。
  206. - 写作粒度:`granularity` 和 `writing_guidance`。
  207. - 信息量基准:视频看 `duration_minutes`、`subtitle_chars`,图文看 `content_chars`、`reading_minutes_estimate`。
  208. - 字幕密度:视频看 `subtitle_chars_per_minute` 和 `visual_dependency`;长视频字幕过少时先补关键帧/OCR/多模态视觉理解。
  209. - 质量倍率:`quality_multiplier` 和 `quality_metrics`,用于判断是否值得保留更多细节。
  210. - 证据规模:`all_evidence_blocks`,用于决定关键判断需要覆盖多少证据。
  211. 写完最终 Markdown 后,用归档目录里的预算给笔记打分:
  212. ```powershell
  213. & $py "$skill\scripts\score_bili_note.py" `
  214. --archive-dir "D:\knowledge\知识库\Rag技术\原始材料\BVxxxx_视频短标题" `
  215. --note-path "D:\knowledge\知识库\Rag技术\观点X:视频短标题.md" `
  216. --out "D:\knowledge\知识库\Rag技术\原始材料\BVxxxx_视频短标题\metadata\note_score.json"
  217. ```
  218. 也可以直接把评分结果写入笔记正文:
  219. ```powershell
  220. & $py "$skill\scripts\update_note_budget_section.py" `
  221. --archive-dir "D:\knowledge\知识库\Rag技术\原始材料\BVxxxx_视频短标题" `
  222. --note-path "D:\knowledge\知识库\Rag技术\观点X:视频短标题.md"
  223. ```
  224. 重点看:
  225. - `status`:`too_short` 表示遗漏风险高,`too_long` 表示可能重复堆料,`ok` 表示落在写前推荐区间。
  226. - `quality_multiplier`:点赞、收藏、投币、评论、弹幕、分享、播放量和发布距今天数形成的互动质量倍率。
  227. - `actual_compression_ratio`:笔记字数 / 字幕字数。长视频应允许更高总字数,但仍要保持压缩。
  228. - `note_chars_per_minute`:每分钟视频对应多少笔记字。长课程不应和短视频接近同一个总字数。
  229. - `evidence_reference_ratio`:笔记中引用的证据块占比。关键判断要能回查图文证据 `O...`、字幕证据 `Pxx@...` 或评论证据 `C...`;正文用统一数字编号,文末编号脚注和 reference-style 链接定义必须指向含完整证据 ID 的归档文件。
  230. ## 笔记写法
  231. 默认输出必须是“学习型笔记”,不是目录搬运、分P流水账或证据清单。读完后应有“我真的学会了一些东西”的获得感。
  232. ### 推荐结构
  233. 1. `# 标题`
  234. 2. `## 学完你应该获得什么`:用 5-8 条写清楚读者学完后能理解、判断或完成什么。
  235. 3. `## 一句话总论`:说明视频最核心的判断,避免只复述标题。
  236. 4. `## 适用场景与前置知识`:这套内容适合谁、不适合谁,读者需要先知道什么。
  237. 5. `## 知识地图`:把核心概念、模块、流程和它们之间的关系讲清楚。课程型视频要有模块表;短观点视频要有论证链。
  238. 6. `## 核心概念卡`:每个重要概念都写成“是什么、为什么重要、怎么用、常见误区、相关证据”。
  239. 7. `## 方法或流程`:把原内容中的操作、架构、决策流程、参数选择、评估方法抽成可复用步骤。
  240. 8. `## 关键洞察`:写作者真正想表达的判断,区分“事实描述、经验判断、推荐做法、限制条件”。
  241. 9. `## 实践清单`:给出可以照着做的步骤、检查项、失败信号和排错方向。
  242. 10. `## 坑点与反例`:整理视频和评论区提到的踩坑、争议、误区、边界条件。
  243. 11. `## 自测题`:写 5-10 个问题和简短答案,帮助人或 Agent 检查是否学会。
  244. 12. `## 证据与原文位置`:只放关键证据引用,不要让证据淹没学习内容。
  245. 13. `## 来源、覆盖与局限`:URL、BVID、UP、发布时间、字幕/评论覆盖、原始材料路径和局限放在后面。
  246. ### 写作标准
  247. - 先解释“为什么”和“怎么迁移使用”,再列“他说了什么”。
  248. - 对课程型长视频,按学习模块组织,不要按分P机械压缩。每个模块至少包含:学习目标、核心概念、关键步骤、常见坑、可操作结论。
  249. - 对观点型短视频,按“问题背景 -> 作者判断 -> 论据 -> 适用边界 -> 对用户的启发”组织。
  250. - 对技术教程和图文长文,保留架构、数据流、代码思路、配置项、图片结论、评估方式和排错路径。
  251. - 如果长视频字幕/转写密度过低,先补视觉证据;没有多模态视觉能力时,明确把当前笔记标为“基于字幕/元数据的有限整理”。
  252. - 评论区只写有学习价值的内容:纠错、补充案例、实践经验、替代方案、争议点。
  253. - 证据引用服务于学习,不要把笔记写成引用列表。正文默认使用统一的论文式数字编号,例如 `[1][2]`;图文证据、字幕证据、评论证据共用一套编号,按正文首次出现顺序递增。不要在正文段落里直接塞很长的 `O<opus_id>-E001`、`Pxx@hh:mm:ss-hh:mm:ss` 或 `C<rpid>`。
  254. - 在 `## 来源、覆盖与局限` 之前放 `## 证据脚注`。脚注用有序列表写明编号和证据链接,例如 `1. [图文证据 E006](原始材料/O.../indexes/图文证据索引.md#O...-E006)`;列表后再放 reference-style 链接定义,例如 `[1]: 原始材料/O.../indexes/图文证据索引.md#O...-E006 "图文证据 E006"`,让正文里的 `[1]` 也能点击跳转。
  255. - 保留 `## 证据与原文位置` 作为证据总览,但总览里也只写 `[1]`、`[2]` 这样的编号,不再直接显示长证据 ID。
  256. - 写前先按 `note_budget.json` 定标,再开始写笔记;写后评分只用于验收和微调,不要把主要长度决策推迟到评分阶段。
  257. - 预算偏短或写后评分过短时,优先补“概念解释、流程图式文字、实践清单、自测题、反例和边界”,不要只增加摘要段落。
  258. - 热度是“值得多写”的辅助信号,不是替代证据。点赞、收藏、评论、弹幕、投币、分享和发布距今天数会提高或降低推荐字数,但扩写必须来自图文正文、字幕、评论证据和内容结构。
  259. ### 不合格信号
  260. - 开头大段来源信息,读者看半天还不知道学到了什么。
  261. - 只有“核心观点/分P提炼/代表性证据”,没有概念解释、方法步骤和自测。
  262. - 把每个分P压成一句话,长课程读完仍不知道怎么做。
  263. - 长视频字幕极少,却没有提示画面依赖,也没有补关键帧/OCR/视觉理解。
  264. - 只总结作者立场,不写适用条件、反例和失败场景。
  265. - 评论区只是罗列热评,没有转化成纠错、补充或实践提醒。
  266. 不要把“只看了标题/目录”的内容写成“完整提取”。如果只抓到部分字幕或只转写了部分分P,明确列出覆盖范围。
  267. ## B站字幕注意事项
  268. - 普通 `/x/player/v2` 可能只返回 `ai-zh` 字幕元信息,`subtitle_url` 为空。
  269. - 网页播放器接口 `/x/player/wbi/v2` 常能返回真正的 AI 字幕 URL。
  270. - AI 字幕常把技术词识别错:RAG 可能识别成 RG、ROG、rap;LangChain 可能识别成 non chain、long chain;reranker 可能识别成“瑞 rank”。
  271. - 总结时要结合分P标题和技术语境校正术语。
  272. ## B站图文注意事项
  273. - 图文/动态正文优先从页面内的 `window.__INITIAL_STATE__` 读取;公开 polymer 动态接口可能返回风控错误。
  274. - 图文正文会保留标题、段落、标题层级、列表、代码块、链接卡片、图片 URL 和图片清单。
  275. - 图文评论对象通常不是 opus id 本身,而是页面数据里的 `basic.comment_type` 和 `basic.comment_id_str`;抓评论时不要硬套视频的 `type=1/oid=aid`。
  276. - 如果用户让你总结图文中的图片含义,先检查 `images/` 或 `images_manifest.json`;仅凭图片 URL 不足以判断内容时,应说明图片视觉内容未被完整理解。
  277. ## 相关文件
  278. - `scripts/check_environment.py`:检查核心流程、网页 AI 字幕、音频转写和测试依赖是否可用。
  279. - `scripts/setup_qwen_asr_env.py`:创建/更新共享的 Qwen3-ASR Python 环境。
  280. - `scripts/run_qwen_asr.py`:调用 Qwen3-ASR-0.6B,可按 chunk 分段避免显存溢出。
  281. - `scripts/run_bili_note.py`:一键运行视频/图文提取、评论、归档和证据索引流程。
  282. - `scripts/extract_bilibili.py`:元数据、字幕探测、普通字幕、音频、音频转写、评论抓取。
  283. - `scripts/extract_bilibili_opus.py`:B站图文/动态正文、图片、代码块和图文评论抓取。
  284. - `scripts/fetch_browser_ai_subtitles.py`:通过已登录网页播放器下载 B站 AI 字幕。
  285. - `scripts/edge_cdp.py`:连接 Edge 远程调试页面的可选 CDP 适配器。
  286. - `scripts/extract_video_keyframes.py`:按分P时长抽取最多 12 张代表帧,生成 4×3 联系图和关键帧清单。
  287. - `scripts/archive_bili_materials.py`:归档完整材料,生成全文索引、证据索引和带字幕密度/视觉依赖提示的笔记预算。
  288. - `scripts/score_bili_note.py`:按 `metadata/note_budget.json` 验收最终笔记的长度、压缩比、证据引用和视觉依赖提示。
  289. - `scripts/update_note_budget_section.py`:把预算、互动质量和信噪比评分写回 Markdown 笔记。
  290. - `references/bilibili-api-notes.md`:接口细节和已知坑。
README.md · README · 176 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="assets/bili-note-logo.png" alt="Bili Note logo" width="560">
  3. </p>
  4. <p align="center">
  5. <img alt="Bilibili" src="https://img.shields.io/badge/Bilibili-video_%2B_opus-00A1D6?style=for-the-badge">
  6. <img alt="Markdown" src="https://img.shields.io/badge/Markdown-knowledge_base-222222?style=for-the-badge&logo=markdown">
  7. <img alt="License MIT" src="https://img.shields.io/badge/License-MIT-FF6699?style=for-the-badge">
  8. </p>
  9. # Bili Note
  10. Bili Note 是一个面向知识库的 B 站视频与图文笔记工具:完整归档字幕、图文正文、图片与评论,按内容信息量和质量动态控制笔记长度,把 B 站内容整理成可学习、可检索、可追问的 Markdown 笔记。
  11. 它的核心特点是:
  12. - 完整归档:保存完整字幕、图文正文、图片、完整评论、元数据和证据索引,主笔记中的关键判断可以通过论文式编号链接回到原文位置复核。
  13. - 动态长度:短视频和长课程根据内容信息量与结构采用不同的提炼粒度。
  14. - 质量感知:结合内容热度、互动质量、评论讨论度和发布时间等信号调整笔记预算,让更值得深读的内容获得更充分的整理。
  15. - 写前定标:先根据原始材料生成推荐字数、压缩比和写作粒度,再开始写笔记;写后评分只用于验收和微调。
  16. - 字幕密度提醒:长视频如果字幕/转写明显稀疏,会提醒你需要关键帧、OCR 或多模态视觉理解,避免把不完整文本写成完整课程笔记。
  17. - 关键帧视觉理解:视频每次运行前询问用户是否开启;开启后先用最多 12 帧组成 4×3 联系图,再按需查看单帧,控制视觉输入 tokens。
  18. 它的目标是生成一份“学完这节课或读完这篇教程之后真的有收获”的学习型笔记,内容深度由原始材料的信息量和结构决定。
  19. ## 适合什么
  20. - B 站技术视频、课程、观点视频、多 P 系列课和图文/动态/opus 长文。
  21. - 需要长期保存字幕、正文、图片、评论和证据索引的知识库。
  22. - 需要人类阅读、Agent 检索和后续问答的学习材料。
  23. ## 输出内容
  24. 一次完整提取会生成主笔记和原始材料包。主笔记依据材料预算组织学习收获、概念、方法、实践清单和证据位置;材料包保存字幕或图文正文、图片、评论、元数据、索引、预算和评分结果。
  25. <details>
  26. <summary>展开完整输出清单</summary>
  27. 主笔记通常包含:知识地图、概念卡、方法流程、关键洞察、实践清单、坑点、自测题和证据脚注。
  28. 原始材料包通常包含:完整正文和字幕、图片、评论、元数据、JSONL 索引、预算、评分,以及用户开启关键帧后生成的联系图和视觉证据。
  29. </details>
  30. ## 快速使用
  31. ### 1. 安装
  32. 把下面这句话发给 Agent:
  33. ```text
  34. 请帮我安装这个 skill:
  35. https://github.com/Rimagination/bili-note
  36. ```
  37. ### 2. 提取视频或图文
  38. 在 B 站视频页点击分享,复制视频链接,然后把下面这句话发给 Agent:
  39. ```text
  40. 请帮我提取这个视频的内容:https://www.bilibili.com/video/BVxxxx/
  41. ```
  42. 如果也想提取评论区里的有用内容,可以说:
  43. ```text
  44. 请帮我提取这个视频的内容和评论区有用的内容:https://www.bilibili.com/video/BVxxxx/
  45. ```
  46. 图文/动态/opus 链接也一样:
  47. ```text
  48. 请帮我提取这个 B 站图文的内容:https://www.bilibili.com/opus/1194341967364882439
  49. ```
  50. 需要评论区时可以说:
  51. ```text
  52. 请帮我提取这个 B 站图文的内容和评论区有用的内容:https://www.bilibili.com/opus/1194341967364882439
  53. ```
  54. 视频每次运行前,Agent 会询问是否开启关键帧视觉理解。选择开启会额外消耗视觉输入 tokens,但能补充 PPT、板书、代码、界面和无字幕片段的信息;选择关闭会继续使用字幕、转写、评论和元数据路线。
  55. ### 3. 指定保存位置
  56. 如果你有固定文件夹,或者想保存到 Obsidian 知识库里,再加一句保存路径:
  57. ```text
  58. 帮我存放在:“D:\知识库\B站总结” 里
  59. ```
  60. ## 依赖与环境检测
  61. 第一次使用、换机器、字幕路线失败,或准备转写音频前,先让 Agent 检查环境:
  62. ```text
  63. 请帮我检查 Bili Note 的运行环境,并告诉我当前能走公开字幕、网页 AI 字幕、中文 Qwen3-ASR 还是 Whisper 兜底。
  64. ```
  65. Agent 会运行:
  66. ```powershell
  67. python scripts/check_environment.py
  68. ```
  69. 依赖按能力分层:
  70. | 能力 | 依赖 |
  71. | --- | --- |
  72. | 基础提取 | Python 3.10+、B 站网络访问 |
  73. | 网页 AI 字幕 | 已登录的 Chrome + `web-access`,或远程调试的 Edge |
  74. | 中文转写 | `ffmpeg`、共享 Qwen3-ASR 环境 |
  75. | 外语转写 | `ffmpeg`、Whisper / faster-whisper |
  76. | 下载兜底 | `yt-dlp` |
  77. | 关键帧理解 | `ffmpeg`、可访问的视频流、视觉模型 |
  78. Bili Note 与 DyNote 会复用 `%USERPROFILE%\.cache\rimagination-notes` 下的模型和 Qwen3-ASR 环境。普通使用无需安装全部增强依赖,环境缺失时会跳过对应路线并说明覆盖范围。
  79. 默认策略:B 站公开视频优先走公开字幕和网页 AI 字幕;确实需要音频转写时,中文或未指定语言的视频优先 Qwen3-ASR,明确是外语视频时优先 Whisper 系后端。需要手动指定时,可以用 `--asr-backend qwen3-asr` 或 `--asr-backend faster-whisper`。
  80. ## 字幕很少怎么办
  81. Bili Note 默认优先用字幕。长视频字幕/转写明显稀疏时,画面可能包含 PPT、板书、代码、软件操作或无解说片段,预算文件会记录画面依赖提示。
  82. 每次视频运行先做轻量预检,再强制询问是否开启关键帧理解。开启后最多抽取 12 帧,先生成 4×3 联系图,再按需查看单帧;关闭后继续使用字幕、转写、评论和元数据路线。当前模型不能看图时,Agent 会说明覆盖范围。
  83. 预检结果保存在 `visual_preflight.json`。开启关键帧后,工作目录会生成联系图、单帧和 `keyframes_manifest.json`;归档后对应文件位于 `metadata/`,视觉观察写入 `metadata/visual_review.md`。
  84. ## 登录和隐私
  85. 网页 AI 字幕支持 Chrome `web-access` 和 Edge Chromium DevTools Protocol。两条路线都让已登录的 B 站页面自己请求字幕接口;Bili Note 不读取、不导出、不保存 Cookie、localStorage、浏览器 profile 或登录 token。没有浏览器登录态时,会改用公开字幕、正文、评论或音频转写,并说明覆盖范围。
  86. Edge 需要用远程调试端口启动一个独立实例,并在该实例中登录 B 站。Windows PowerShell 示例:
  87. ```powershell
  88. $edge = "${env:ProgramFiles(x86)}\Microsoft\Edge\Application\msedge.exe"
  89. $profile = Join-Path $env:LOCALAPPDATA "bili-note-edge-profile"
  90. & $edge --remote-debugging-port=9222 --user-data-dir="$profile" "https://www.bilibili.com/"
  91. ```
  92. 首次使用时在这个 Edge 实例中登录 B 站,再运行总入口并指定 `--browser edge`。默认端口为 `9222`,可用 `--edge-cdp-url` 修改;另需安装 `websocket-client`:`python -m pip install websocket-client`。
  93. ## 写笔记的原则
  94. - 先讲学习目标、方法和迁移方式,再补充原内容。
  95. - 课程按学习模块组织,观点按背景、判断、论据和适用边界组织。
  96. - 技术教程保留架构、配置、操作步骤、评估方式和排错路径。
  97. - 评论区只保留纠错、案例、实践经验、替代方案和争议点。
  98. - 写作前读取 `metadata/note_budget.json`,写作后用评分结果验收;关键判断使用 `[1][2]` 等编号链接到证据。
  99. ## 相关文件
  100. - `SKILL.md`:完整工作流说明。
  101. - `scripts/run_bili_note.py`:一键运行视频/图文提取、评论、归档和证据索引。
  102. - `scripts/check_environment.py`:检查可用的字幕、浏览器、转写和测试路线。
  103. - `scripts/extract_video_keyframes.py`:生成最多 12 张代表帧和联系图。
  104. - `scripts/fetch_browser_ai_subtitles.py`、`scripts/edge_cdp.py`:获取网页 AI 字幕。
  105. - `scripts/archive_bili_materials.py`、`scripts/score_bili_note.py`:归档材料并验收笔记。
  106. ## 社区友链
  107. - [LINUX DO](https://linux.do/):一个关注开发者、开源项目与 AI 工具交流的社区。感谢社区佬友对开源工具和 Agent 工作流的讨论与反馈。
  108. ## 致谢
  109. Bili Note 的设计和实现参考、依托了这些主要项目与生态:
  110. - [Bilibili](https://www.bilibili.com/):视频、字幕、评论和互动数据来源。
  111. - [yt-dlp](https://github.com/yt-dlp/yt-dlp):可选音频下载兜底。
  112. - [FFmpeg](https://ffmpeg.org/):可选音频转码。
  113. - [Qwen3-ASR](https://huggingface.co/Qwen/Qwen3-ASR-0.6B):可选中文本地自动语音识别后端。
  114. - [OpenAI Whisper](https://github.com/openai/whisper)、[faster-whisper](https://github.com/SYSTRAN/faster-whisper)、[FunASR](https://github.com/modelscope/FunASR):可选外语视频转写后端。
  115. ## 许可证
  116. 本项目使用 MIT License,详见 `LICENSE`。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.