wangmengguo NotebookLM Skill（Fusion Paradigm）
Philosophy
NotebookLM 是 Google 的 AI 研究助手。本 Skill 将自然语言意图转化为 CLI 命令， 实现"对话式研究 → 多模态内容生成"的完整工作流。
核心理念：
- 版本同步优先 - 每次使用前检查 CLI 更新
- 渐进式披露 - 按需加载具体命令模式
- 中文默认 - 所有生成内容默认使用中文
Context
当前版本: v0.3.1 (2026-01-23) 主要特性:
- 80+ 语言支持（全局设置）
- 分享 API（编程式权限管理）
- 部分 ID 匹配（简化操作）
- 自动重试（--retry 参数）
# 1. 检查并升级到最新版本
pipx upgrade notebooklm-py
# 2. 验证版本
notebooklm --version
# 期望: >= 0.3.1
# 3. 验证认证（如果需要）
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
# 使用 --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）
- 生成的文件已下载到指定位置
- 用户能够访问生成的内容