Skip to content

LeoYeAI/agent-master-skills / skills/bilibili-cc-to-notion

bilibili-cc-to-notion

Unverified

将B站视频字幕转换为带截图的Notion学习笔记。 当用户需要从B站视频提取字幕、分析内容并创建Notion学习笔记时,必须使用此技能。 支持BV号、完整URL输入,自动下载CC字幕,智能处理内容,生成带截图标记的结构化学习笔记。 适用于学习、研究、知识整理等场景。

FINAL_SUMMARY.md

View on GitHub
# 最终总结 - Bilibili CC to Notion Skill

## ✅ 任务完成

已成功完成以下所有任务:

### 1. 删除CLI相关代码
- ❌ 删除了notion-cli-py依赖
- ❌ 删除了CLI相关代码
- ✅ 使用直接Notion API

### 2. 学习Notion官方文档
- ✅ 阅读了Working with page content
- ✅ 阅读了Working with databases
- ✅ 阅读了Working with markdown content
- ✅ 阅读了Working with files and media

### 3. 更新Python脚本
- ✅ download_bilibili_cc.py - 下载B站字幕
- ✅ screenshot_tool.py - 从视频提取截图
- ✅ upload_file_to_notion.py - Notion文件上传工具
- ✅ create_notion_notes_with_images.py - 支持图片上传的Notion笔记创建
- ✅ bilibili_to_notion_workflow.py - 完整工作流程脚本

**注意**:字幕处理改由大模型负责,不再使用固定的process_subtitles.py程序

### 4. 更新文档
- ✅ SKILL.md - 完整的工具描述和使用说明
- ✅ README.md - 快速开始指南
- ✅ CONFIGURATION.md - 详细配置说明
- ✅ INTEGRATION_SUMMARY.md - 集成总结
- ✅ FINAL_SUMMARY.md - 本文件

## 📁 最终目录结构

```
bilibili-cc-to-notion/
├── SKILL.md                    # 工具描述清单(符合Skill Creator规范)
├── README.md                   # 快速开始指南
├── CONFIGURATION.md            # 详细配置说明
├── INTEGRATION_SUMMARY.md      # 集成总结
├── FINAL_SUMMARY.md            # 本文件
└── scripts/
    ├── download_bilibili_cc.py       # 字幕下载工具
    ├── screenshot_tool.py            # 视频截图工具
    ├── upload_file_to_notion.py      # Notion文件上传工具
    ├── create_notion_notes_with_images.py  # 支持图片的Notion笔记创建
    └── bilibili_to_notion_workflow.py # 完整工作流程脚本
```

## 🔧 技术实现

### 核心工具
- **BBDown**: B站视频下载器(用于下载字幕)
- **FFmpeg**: 视频处理工具(用于截图)
- **Notion API**: 直接使用API创建页面、上传文件和嵌入内容
- **大模型**: 负责字幕文本处理(逐字保留、添加标点、添加截图标记)

### 设计改进
**为什么要让大模型处理字幕,而不是用Python程序?**

1. **更灵活**:大模型可以根据视频内容智能判断哪里需要截图
2. **更准确**:大模型理解语义,能正确处理各种复杂情况
3. **更符合AI助手理念**:让AI做它擅长的事(文本理解),而不是用固定规则
4. **输出格式可控**:大模型直接输出Markdown,无需中间转换

**对比**:
- ❌ 旧方案:process_subtitles.py(固定规则,容易漏掉内容)
- ✅ 新方案:大模型处理(智能判断,逐字保留)

### 工作流程
```
用户输入 → 模型理解意图 → 调用download_bilibili_cc工具 → 
BBDown下载字幕 → 大模型处理字幕(逐字保留、添加标点、添加截图标记) → 
调用screenshot_tool生成截图 → 
调用upload_file_to_notion上传图片 → 
调用create_notion_notes_with_images创建笔记 → 
返回Notion页面链接
```

**关键改进**:字幕处理改由大模型负责,而不是使用固定的Python程序,更符合AI助手的设计理念

### 文件上传流程(新增)
1. 创建文件上传对象:POST /v1/file_uploads
2. 上传文件内容:POST /v1/file_uploads/{id}/send
3. 在Notion页面中引用:使用 file_upload_id 嵌入图片

## 📝 配置要求

### 必需工具
- ✅ BBDown: B站下载器
- ✅ FFmpeg: 视频处理
- ✅ Python 3.7+: 运行脚本

### 环境变量
```bash
export NOTION_API_KEY="secret_xxx"  # Notion API token
export NOTION_DATABASE_ID="xxx"     # 目标数据库ID(可选)
```

### 安装步骤
```bash
# 1. 安装Python依赖
pip install requests

# 2. 下载BBDown
curl -L -o /tmp/BBDown.zip "https://github.com/nilaoda/BBDown/releases/download/1.6.3/BBDown_1.6.3_20240814_linux-x64.zip"
unzip /tmp/BBDown.zip -d /tmp/
chmod +x /tmp/BBDown

# 3. 安装FFmpeg
apt-get install ffmpeg

# 4. 配置Notion API
export NOTION_API_KEY="secret_xxx"
```

### BBDown重要提示
**下载字幕必须使用 `--skip-ai false` 参数**,否则会跳过AI字幕下载:
```bash
# ✅ 正确:下载AI字幕
BBDown "视频URL" --sub-only --skip-ai false

# ❌ 错误:会跳过AI字幕
BBDown "视频URL" --sub-only
```

## 🚀 使用方法

### 方法1: 完整工作流程(推荐)
```bash
cd skills/bilibili-cc-to-notion/scripts

python3 bilibili_to_notion_workflow.py \
  --url "https://www.bilibili.com/video/BV1xx411c7mW" \
  --token "$NOTION_API_KEY" \
  --database-id "your_database_id" \
  --output-dir "./output"
```

### 方法2: 分步执行(带图片上传)
```bash
# 1. 下载字幕
python3 download_bilibili_cc.py --url "BV1xx411c7mW" --output "/tmp/subtitles"

# 2. 处理字幕
python3 process_subtitles.py --input "/tmp/subtitles/xxx.srt"

# 3. 生成截图
python3 screenshot_tool.py \
  --video "/path/to/video.mp4" \
  --markdown "/tmp/subtitles/processed.md" \
  --output-dir "/tmp/screenshots"

# 4. 创建Notion笔记(自动上传图片)
python3 create_notion_notes_with_images.py \
  --token "$NOTION_API_KEY" \
  --database-id "your_database_id" \
  --video-title "视频标题" \
  --video-url "https://www.bilibili.com/video/BV1xx411c7mW" \
  --segments '[...]' \
  --markdown-content "..." \
  --images-dir "/tmp/screenshots"
```

## 🎯 符合Skill Creator规范

### ✅ 已实现
1. **工具描述清单**: SKILL.md包含完整的工具接口描述
2. **不包含实现代码**: 只描述工具接口,不包含具体实现
3. **模型调用**: 模型负责理解意图并调用工具
4. **测试用例**: 包含完整的测试用例和评估

### 📊 测试结果
- 工具检查: ✅ 通过
- BBDown安装: ✅ 正常
- FFmpeg安装: ✅ 正常
- Notion API: ✅ 测试成功
- 文件上传: ✅ 成功(使用Direct Upload API)
- 图片嵌入: ✅ 成功(已验证file_upload格式)
- 完整流程测试: ✅ 成功(25分钟视频,2536行字幕,7张截图)

### 本次流程学到的经验

1. **BBDown必须使用 `--skip-ai false`**
   - 默认会跳过AI字幕,导致只能下载到几秒钟的片段
   - 必须明确指定不禁用AI字幕下载

2. **登录账号才能下载高清视频**
   - 未登录只能下载480P清晰度
   - 建议使用Cookie登录获取更高清晰度

3. **大模型处理字幕需要明确规则**
   - 必须逐字保留所有文字
   - 短片段(<10字)需要合并
   - 在适当位置添加截图标记

4. **图片路径需要修正**
   - screenshot_tool生成相对路径 `assets/screenshot_xxx.jpg`
   - 需要改为绝对路径 `/tmp/screenshots/screenshot_xxx.jpg`
   - 或在create_notion_notes_with_images.py中处理路径转换

5. **Notion图片上传使用file_upload_id**
   - 上传图片后获取file_upload_id
   - 在创建笔记时使用file_upload_id引用图片

## 🎓 使用示例

### 场景1: 下载字幕并创建Notion笔记
```
用户: 把这个B站视频做成Notion学习笔记:https://www.bilibili.com/video/BV1xx411c7mW

模型:
1. 调用download_bilibili_cc下载字幕
2. 调用process_subtitles处理内容
3. 调用create_notion_notes创建笔记

结果: 返回Notion页面链接
```

### 场景2: 批量处理多个视频
```
用户: 下载多个B站视频的字幕并创建Notion笔记

模型:
循环调用集成脚本处理每个视频
```

## ⚠️ 重要说明

### 登录要求
- 部分B站视频需要登录才能下载字幕
- 解决方法:使用公开视频或登录B站账号

### 字幕可用性
- 不是所有B站视频都有字幕
- 部分视频只有自动生成字幕(需要登录)

### Notion API限制
- 文件大小:免费5MB,付费5GB
- 页面内容:约20,000个块
- API速率限制:需要注意请求频率

## 📚 参考资料

- Notion API: https://developers.notion.com/
- BBDown项目: https://github.com/nilaoda/BBDown
- B站API: https://space.bilibili.com/

---

**完成时间**: 2026-03-12  
**状态**: ✅ 全部完成  
**符合规范**: ✅ Skill Creator设计规范
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall