| 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 命令，
实现"对话式研究 → 多模态内容生成"的完整工作流。
核心理念：
- 版本同步优先 - 每次使用前检查 CLI 更新
- 渐进式披露 - 按需加载具体命令模式
- 中文默认 - 所有生成内容默认使用中文
Context
当前版本: v0.3.1 (2026-01-23)
主要特性:
- 80+ 语言支持（全局设置）
- 分享 API（编程式权限管理）
- 部分 ID 匹配（简化操作）
- 自动重试（--retry 参数）
Pre-flight Check（首次使用或版本检查时展开）
pipx upgrade notebooklm-py
notebooklm --version
notebooklm auth check --test
快速检查脚本：
~/.config/opencode/skills/notebooklm/scripts/check-update.sh
如果升级发现新版本：
- 运行
Read patterns/changelog-sync.md 获取同步指令
- 按指令更新本 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（执行策略）
- 版本检查优先 - 每次操作前运行
pipx upgrade notebooklm-py
- 一次一事 - 创建 → 添加资料 → 等待处理 → 生成 → 下载
- 每步验证 - 确认上一步成功再进行下一步
- 语言默认中文 - 生成音频/视频时始终使用
--language zh
- 智能风格选择 - 根据场景自动推荐视频风格
- 部分 ID 匹配 - 支持使用 ID 前缀（如
abc 匹配 abc123...）
Error Handling
常见错误处理
认证失败
notebooklm auth check --test
notebooklm login
Rate Limiting
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
执行完成前验证：
