notebooklm

name	notebooklm
description	通过 notebooklm-py CLI 操作 Google NotebookLM。Use when: 用户请求创建笔记本、添加资料、 生成播客/视频/测验、下载产物、或进行研究。Produces: CLI 命令执行结果、生成的媒体文件。
license	MIT
default_language	zh
cli_package	notebooklm-py
min_version	0.3.1
github_url	https://github.com/teng-lin/notebooklm-py
github_hash	bbc037eec48810f3b7eefc6b695a34870db11515

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 参数）

---

Pre-flight Check（首次使用或版本检查时展开）

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

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

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

快速检查脚本：

~/.config/opencode/skills/notebooklm/scripts/check-update.sh

如果升级发现新版本：

1. 运行 Read patterns/changelog-sync.md 获取同步指令
2. 按指令更新本 Skill 的命令映射

---

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

常见错误处理

认证失败

notebooklm auth check --test
# 如果失败，运行:
notebooklm login

Rate Limiting

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

RPC 错误

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

---

Memory（版本追踪）

本 Skill 会追踪 CLI 版本变化。查看：

• memory/version-history.md - 已同步的版本记录
• memory/user-preferences.md - 用户偏好设置
• evolution.json - 生命周期管理元数据

---

Validation Checklist

执行完成前验证：

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