164 lines
4.3 KiB
Markdown
164 lines
4.3 KiB
Markdown
# NotebookLM内容生成工具
|
||
|
||
`NotebookLM` `浏览器自动化` `幻灯片生成` `播客` `信息图` `视频生成` `Python`
|
||
|
||
# NotebookLM 超级技能
|
||
|
||
通过浏览器自动化，从 NotebookLM 笔记本生成幻灯片、播客、信息图和视频。
|
||
|
||
## 功能特性
|
||
|
||
- **幻灯片** - 为不同受众生成演示文稿（技术人员、投资者、客户、高管、初学者）
|
||
- **音频概述** - 以 80 多种语言创建 AI 播客风格的讨论
|
||
- **信息图** - 支持多种方向的可视化摘要
|
||
- **视频概述** - 可自定义主题的解说视频
|
||
|
||
## 安装
|
||
|
||
### 作为 Claude Code 技能安装
|
||
|
||
1. 将此仓库克隆到技能目录：
|
||
```bash
|
||
git clone https://github.com/ainergiz/notebooklm-superskill.git ~/.claude/skills/notebooklm-superskill
|
||
```
|
||
|
||
2. 重启 Claude Code 以加载技能。
|
||
|
||
### 独立使用
|
||
|
||
1. 克隆仓库：
|
||
```bash
|
||
git clone https://github.com/ainergiz/notebooklm-superskill.git
|
||
cd notebooklm-superskill
|
||
```
|
||
|
||
2. 运行任意脚本（虚拟环境会自动配置）：
|
||
```bash
|
||
python scripts/run.py auth_manager.py setup
|
||
```
|
||
|
||
## 快速开始
|
||
|
||
### 1. 身份认证（仅需一次）
|
||
|
||
```bash
|
||
python scripts/run.py auth_manager.py setup
|
||
```
|
||
|
||
浏览器窗口打开后，登录你的 Google 账号，会话将保存供后续使用。
|
||
|
||
### 2. 生成内容
|
||
|
||
```bash
|
||
# 幻灯片
|
||
python scripts/run.py generate_slides.py --notebook-url URL --audience technical
|
||
|
||
# 音频播客
|
||
python scripts/run.py generate_audio.py --notebook-url URL --format deep-dive
|
||
|
||
# 信息图
|
||
python scripts/run.py generate_infographic.py --notebook-url URL --orientation landscape
|
||
|
||
# 视频
|
||
python scripts/run.py generate_video.py --notebook-url URL --format explainer
|
||
```
|
||
|
||
## 参数说明
|
||
|
||
### 幻灯片生成
|
||
|
||
| 参数 | 可选值 | 默认值 |
|
||
|------|--------|--------|
|
||
| `--audience` | technical, investor, customer, executive, beginner | technical |
|
||
| `--audiences` | 逗号分隔的列表 | - |
|
||
| `--format` | detailed, presenter | detailed |
|
||
| `--length` | short, default, long | default |
|
||
| `--source` | 文件路径 | - |
|
||
| `--prompt` | 自定义文本 | - |
|
||
|
||
### 音频生成
|
||
|
||
| 参数 | 可选值 | 默认值 |
|
||
|------|--------|--------|
|
||
| `--format` | deep-dive, brief, critique, debate | deep-dive |
|
||
| `--language` | en-US, es-ES, fr-FR 等 | en-US |
|
||
| `--prompt` | 自定义文本 | - |
|
||
|
||
### 信息图生成
|
||
|
||
| 参数 | 可选值 | 默认值 |
|
||
|------|--------|--------|
|
||
| `--orientation` | square, portrait, landscape | landscape |
|
||
| `--detail` | concise, standard, detailed | standard |
|
||
| `--prompt` | 自定义文本 | - |
|
||
|
||
### 视频生成
|
||
|
||
| 参数 | 可选值 | 默认值 |
|
||
|------|--------|--------|
|
||
| `--format` | brief, explainer | brief |
|
||
| `--theme` | retro-90s, futuristic, corporate, minimal | corporate |
|
||
| `--custom-theme` | 自定义描述 | - |
|
||
| `--prompt` | 自定义文本 | - |
|
||
|
||
## 通用参数
|
||
|
||
所有脚本均支持：
|
||
- `--output DIR` - 输出目录
|
||
- `--headless` - 无界面运行浏览器
|
||
- `--help` - 显示帮助信息
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
notebooklm-superskill/
|
||
├── SKILL.md # Claude Code 技能文件
|
||
├── scripts/
|
||
│ ├── run.py # 通用入口（处理虚拟环境）
|
||
│ ├── auth_manager.py # 身份认证
|
||
│ ├── generate_slides.py
|
||
│ ├── generate_audio.py
|
||
│ ├── generate_infographic.py
|
||
│ └── generate_video.py
|
||
└── data/ # 运行时数据（已加入 .gitignore）
|
||
└── browser_state/ # Cookie、配置文件
|
||
```
|
||
|
||
## 工作原理
|
||
|
||
1. **浏览器自动化** - 使用 Patchright（Playwright 的分支）配合真实 Chrome，确保稳定性
|
||
2. **反检测机制** - 持久化浏览器配置、Cookie 注入、模拟人类操作行为
|
||
3. **产物监控** - 通过检测加载动画来判断内容生成是否完成
|
||
4. **下载处理** - 通过 Playwright 的下载处理器捕获下载内容
|
||
|
||
## 环境要求
|
||
|
||
- Python 3.8+
|
||
- 拥有 NotebookLM 访问权限的 Google 账号
|
||
- Chrome 浏览器（由 Patchright 自动安装）
|
||
|
||
## 常见问题
|
||
|
||
### 认证过期
|
||
|
||
```bash
|
||
python scripts/run.py auth_manager.py reauth
|
||
```
|
||
|
||
### 生成超时
|
||
|
||
音频和视频生成可能需要 5-15 分钟。脚本内置了超时时间：
|
||
- 幻灯片/信息图：3 分钟
|
||
- 音频：10 分钟
|
||
- 视频：15 分钟
|
||
|
||
### 浏览器问题
|
||
|
||
```bash
|
||
# 为 Patchright 重新安装 Chrome
|
||
python -m patchright install chrome
|
||
```
|
||
|
||
## 许可证
|
||
|
||
MIT |