# Notebooklm

> 通过 notebooklm-py CLI 操作 Google NotebookLM。Use when: 用户请求创建笔记本、添加资料、 生成播客/视频/测验、下载产物、或进行研究。Produces: CLI 命令执行结果、生成的媒体文件。

- Skill: `wangmengguo/notebooklm` (Agent Skill, multi-file: 13 files)
- Install (CLI): `npx skillmds@latest add wangmengguo/notebooklm`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wangmengguo/notebooklm/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: wangmengguo (https://skillmd.com/u/wangmengguo)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wangmengguo/notebooklm

---


# NotebookLM Skill（Fusion Paradigm）

## Philosophy

> NotebookLM 是 Google 的 AI 研究助手。本 Skill 将自然语言意图转化为 CLI 命令，
> 实现"对话式研究 → 多模态内容生成"的完整工作流。

**核心理念**：
1. **版本同步优先** - 每次使用前检查 CLI 更新
2. **渐进式披露** - 按需加载具体命令模式
3. **中文默认** - 所有生成内容默认使用中文

---

## Context

**当前版本**: v0.3.1 (2026-01-23)
**主要特性**: 
- 80+ 语言支持（全局设置）
- 分享 API（编程式权限管理）
- 部分 ID 匹配（简化操作）
- 自动重试（--retry 参数）

---

<details>
<summary>Pre-flight Check（首次使用或版本检查时展开）</summary>

```bash
# 1. 检查并升级到最新版本
pipx upgrade notebooklm-py

# 2. 验证版本
notebooklm --version
# 期望: >= 0.3.1

# 3. 验证认证（如果需要）
notebooklm auth check --test
```

**快速检查脚本**：
```bash
~/.config/opencode/skills/notebooklm/scripts/check-update.sh
```

**如果升级发现新版本**：
1. 运行 `Read patterns/changelog-sync.md` 获取同步指令
2. 按指令更新本 Skill 的命令映射

</details>

---

## Routing Logic

根据用户意图，加载相应的 Pattern 文件：

### 1. 笔记本管理
```
用户说: "创建笔记本"、"列出笔记本"、"删除笔记本"
→ Read patterns/notebook-management.md
```

### 2. 资料管理
```
用户说: "添加资料"、"添加网页"、"添加 PDF"、"研究某主题"
→ Read patterns/source-management.md
```

### 3. 内容生成（音频/视频）
```
用户说: "生成播客"、"生成视频"、"生成音频"
→ Read patterns/generate-media.md
```

### 4. 内容生成（学习材料）
```
用户说: "生成测验"、"生成抽认卡"、"生成幻灯片"、"生成报告"
→ Read patterns/generate-study.md
```

### 5. 下载产物
```
用户说: "下载播客"、"下载视频"、"下载测验"
→ Read patterns/download-artifacts.md
```

### 6. 分享与协作
```
用户说: "分享笔记本"、"添加协作者"、"设置权限"
→ Read patterns/sharing.md
```

### 7. 语言设置
```
用户说: "设置语言"、"切换到英文"、"使用日语"
→ Read patterns/language-settings.md
```

---

## Quick Reference（常用命令速查）

### Session 管理
| 自然语言 | CLI 命令 |
|---------|---------|
| "登录" | `notebooklm login` |
| "列出笔记本" | `notebooklm list` |
| "创建笔记本" | `notebooklm create "名称"` |
| "切换到笔记本 X" | `notebooklm use <id>` |
| "查看状态" | `notebooklm status` |

### 快速生成（默认中文）
| 自然语言 | CLI 命令 |
|---------|---------|
| "生成播客" | `notebooklm generate audio --language zh --wait` |
| "生成视频" | `notebooklm generate video --language zh --wait` |
| "生成测验" | `notebooklm generate quiz --wait` |

### 快速下载
| 自然语言 | CLI 命令 |
|---------|---------|
| "下载播客" | `notebooklm download audio ./podcast.mp3` |
| "下载视频" | `notebooklm download video ./video.mp4` |

---

## Execution Strategy（执行策略）

1. **版本检查优先** - 每次操作前运行 `pipx upgrade notebooklm-py`
2. **一次一事** - 创建 → 添加资料 → 等待处理 → 生成 → 下载
3. **每步验证** - 确认上一步成功再进行下一步
4. **语言默认中文** - 生成音频/视频时始终使用 `--language zh`
5. **智能风格选择** - 根据场景自动推荐视频风格
6. **部分 ID 匹配** - 支持使用 ID 前缀（如 `abc` 匹配 `abc123...`）

---

## Error Handling

<details>
<summary>常见错误处理</summary>

### 认证失败
```bash
notebooklm auth check --test
# 如果失败，运行:
notebooklm login
```

### Rate Limiting
```bash
# 使用 --retry 参数自动重试
notebooklm generate audio --retry 3 --wait
```

### RPC 错误
- 检查 GitHub Issues 是否有 `rpc-breakage` 标签
- 升级到最新版本：`pipx upgrade notebooklm-py`

</details>

---

## Memory（版本追踪）

本 Skill 会追踪 CLI 版本变化。查看：
- `memory/version-history.md` - 已同步的版本记录
- `memory/user-preferences.md` - 用户偏好设置
- `evolution.json` - 生命周期管理元数据

---

## Validation Checklist

执行完成前验证：
- [ ] CLI 版本已是最新
- [ ] 命令执行成功（退出码 0）
- [ ] 生成的文件已下载到指定位置
- [ ] 用户能够访问生成的内容