bili-review

遇到问题或有建议欢迎 📝 提 Issue，觉得好用可以点个 ⭐ Star 支持。

B 站视频总结：AI 字幕 + 弹幕时序 + 楼中楼评论 的三数据源的交叉事实总结。

1. 工具定位与核心价值

很多 B 站视频水分大、商单多，只看视频容易被 UP 主单方面带节奏。
bili-review 把 视频字幕、高能弹幕 和 深度评论 放在一起对比总结，帮你快速了解视频、洞察事实。

• 字幕提取：用 yt-dlp 抓取官方 AI 字幕（使用本地 Cookie）获取视频内容。
• 弹幕分析：免登录拉取全量弹幕，按时间切片找出全片讨论最密集的片段和即时纠错提醒。
• 评论深挖：公开接口抓取高赞热评与楼中楼深度讨论，自动过滤水评和复读机。
• 渐进式总结：
  • 速读卡：判断视频有没有用
  • 详细总结：采用分析框架提炼核心要点

2. Agent 执行工作流

收到总结或分析指令时，按以下 4 步处理：

1. 提取视频 ID：从用户给的链接、BV 号、AV 号或 b23.tv 短链中提取标准 BV 号。
2. 抓取原始数据：
   • 默认抓取全部三源数据：python3 {baseDir}/scripts/bili_review.py all "<bvid>"
   • 只需要弹幕时序：python3 {baseDir}/scripts/bili_review.py danmaku "<bvid>"
   • 只需要看评论区：python3 {baseDir}/scripts/bili_review.py comments "<bvid>" --replies
   • 只需要看字幕：python3 {baseDir}/scripts/bili_review.py subtitle "<bvid>"
3. 选定场景骨架：根据视频属于测评、教程、观点还是科普，选用对应的总结结构。
4. 交付最终总结：遵循双层契约模板输出，结论先行，上下层严禁复读。

3. 四大视频场景总结分析框架

根据视频核心诉求，直接选用对应的总结分析骨架：

4. 质量与排版规则

1. 速读卡和详细总结尽量互不重复。
2. 每段首句出结论：先讲判断，再展开具体数据或事实。关键数据、核心参数、代码指令必须 加粗。
3. 多用表格：涉及优缺点对比、参数对比、版本差异时，一律用 Markdown 小表格呈现。
4. 严禁 AI 套话腔调：严禁出现“综上所述”、“值得注意的是”、“不可否认”、“赋能”、“不仅...而且...”等无意义填充词。
5. 独立客观：直接输出视频总结内容，严禁输出任何问候语、对话开场白或人称称呼。
6. 会话与数据隔离：仅针对当前输入的单一视频数据进行独立事实总结，严禁与历史会话中讨论过的其他视频数据混淆与关联。

5. 标准输出契约模板

Agent 输出必须遵循以下统一 Markdown 结构：

# 《视频标题》视频总结

> 👤 **UP主**：<author> ｜ 📅 **发布时间**：YYYY-MM-DD ｜ 🔗 **视频地址**：https://www.bilibili.com/video/<bvid>

---

### ⚡ 速读卡
- 🚦 **判定结论**：【⚠️ 避坑 / ✅ 必看 / ⏩ 建议跳过 / 🔍 存疑】（一句话定性）
- 📌 **一句话主张**：（30字内）UP 主核心在推什么或讲什么。
- 🔍 **弹幕/评论真相**：（50字内）弹幕高能吐槽与评论区翻车/实测点（附带 [MM:SS] 或点赞数）。
- 🎯 **行动建议**：（20字内）直接划走 / 抄哪段代码 / 哪个时间点起看。

---

## 📌 详细总结

<!-- 根据视频类型，自动选择以下 4 种结构之一展开，不要重复上面的结论 -->

<!-- ==================== 选项 1：测评 / 避坑类 ==================== -->
### 1. 🟢 UP 主吹的卖点（红榜）
- 核心卖点与宣称优势（数据加粗，单段 ≤ 3 行）。
### 2. 🔴 弹幕与评论扒出的槽点（黑榜）
- 弹幕 `[MM:SS]` 密集吐槽点。
- 评论区（附点赞数）实测翻车、暗病、发热或隐藏成本。
### 3. ⚖️ 选型建议与民间平替
- 适合谁 / 千万别买谁 / 评论区推荐的更优替代方案。

<!-- ==================== 选项 2：教程 / 实操类 ==================== -->
### 1. 🛠️ 准备工作与环境依赖
- 必备软件、环境与配置文件（直接给版本与链接）。
### 2. 📋 核心操作步骤（直接抄作业）
- `[MM:SS]` 步骤 1：直接给代码/命令/配置（剔除口水话）。
- `[MM:SS]` 步骤 2：...
### 3. ✂️ 做减法与避坑
- **可跳过的冗余步骤**：标明视频中哪些步骤是弯路，直接跳过。
- **评论区优化补丁**：高赞网友提供的一键脚本或避坑配置。

<!-- ==================== 选项 3：观点 / 商业类 ==================== -->
### 1. 📖 发生了啥（背景与核心矛盾）
### 2. 🧠 UP 主的核心观点与预测
### 3. 🔍 评论区内幕爆料与各方站队（带点赞数）
### 4. 💡 底层真相（对普通人有什么实际影响）

<!-- ==================== 选项 4：科普 / 原理类 ==================== -->
### 1. 💡 通俗大白话比方（5 秒听懂核心概念）
### 2. ⚙️ 底层运作机制与核心链路拆解
### 3. 📌 弹幕纠错与细节补充（指出不严谨处）

6. CLI 常用命令速查

# 1. 登录态提取（首次运行从浏览器抓取 Cookie 存本地，有效期约 150 天）
python3 {baseDir}/scripts/bili_review.py login
python3 {baseDir}/scripts/bili_review.py status

# 2. 一键抓取全部数据（字幕 + 弹幕时序 + 评论区）
python3 {baseDir}/scripts/bili_review.py all "<bvid|url>"

# 3. 仅抓取弹幕时序分析（高能片段 + 即时纠错）
python3 {baseDir}/scripts/bili_review.py danmaku "<bvid|url>"

# 4. 仅抓取字幕（支持 --lang ai-zh / ai-en）
python3 {baseDir}/scripts/bili_review.py subtitle "<bvid|url>" --lang ai-zh

# 5. 仅抓取评论区（--replies 开启楼中楼深挖；--limit 设置楼层数；--all-comments 全量抓取）
python3 {baseDir}/scripts/bili_review.py comments "<bvid|url>" --replies --limit 50