NotebookLM CLI

核心用法

NotebookLM CLI 是 Google 官方 NotebookLM 的终端封装工具，面向需要批量处理研究文档、自动化知识库管理的开发者与知识工作者。核心工作流为：认证 → 创建/选择笔记本 → 导入来源 → 对话查询 → 生成幻灯片/播客等产物。

显著优点

• 全功能覆盖：支持笔记本 CRUD、多源导入（URL/本地文本/Google Drive）、深度研究模式、多语言切换。
• 产物自动化：可生成幻灯片、播客脚本、简报、测验卡等，支持 --wait 阻塞等待生成完成，便于 CI/CD 集成。
• 协作友好：内置成员权限管理（editor/viewer）与公开分享控制。
• 输出结构化：全局 --json 标志，方便下游工具链解析。

潜在缺点与局限

• 外部依赖重：需 Node.js、uv 包管理器及 Google 账号授权，首次配置门槛较高。
• 网络与区域限制：NotebookLM 服务存在地理封锁，CLI 无法绕过。
• 异步等待痛点：研究任务与产物生成耗时不可控，需频繁使用 wait 子命令轮询。
• 产物格式受限：导出类型枚举固定（docs 等），深度自定义排版需二次加工。

适合人群

• 技术型研究员、咨询顾问、内容运营团队，需将 NotebookLM 纳入自动化脚本或数据管道。
• 不适合无 CLI 经验、追求即点即用 UI 的轻度用户。

常规风险

• Token 泄露：CLI 凭据默认存储于本地，共享环境需配置 TIANGONG_WORKSPACE_ROOT 隔离。
• 数据残留：delete 操作需显式 --yes，误删笔记本不可恢复。
• API 变动：Google 频繁迭代 NotebookLM 功能，CLI 封装可能滞后导致命令失效。

核心用法

NotebookLM Skill 是一个轻量级的 Node.js CLI 封装脚本，专为在当前工作区中便捷调用 Google NotebookLM 服务而设计。它允许用户通过简单的命令行指令完成笔记本管理、来源添加、AI 辅助问答、研究状态查询以及各类成品（如幻灯片、摘要报告）生成与下载等操作。核心命令包括notebooklm list（列出笔记本）、notebooklm ask（向指定笔记本提问）、notebooklm source add（添加网页或文本来源）以及notebooklm generate slide-deck（生成演示文稿）等，所有指令均通过安全透传方式调用底层服务。

显著优点

1. 高效自动化：将 NotebookLM 的复杂操作简化为命令行指令，尤其适合快速批量处理来源和生成内容。
2. 安全可靠：代码仅约60行，无任何第三方依赖，仅使用 Node.js 内置模块。命令调用采用child_process.spawnSync的数组参数模式，避免了命令注入风险，且无隐蔽网络请求或敏感数据收集行为。
3. 集成度高：作为 Google NotebookLM 官方服务的自动化封装，能直接利用其强大的 AI 理解、总结和生成能力，并支持 Google Drive 文档、网络链接等多种来源类型。
4. 透明可控：用户可完整掌握工作流程，从登录认证、来源刷新到成品导出，每一步都有明确的指令支持。

潜在缺点与局限性

1. 来源信誉较低：该 Skill 由个人开发者维护，代码无公开 GitHub 仓库和开源许可证，长期更新和安全性难以预期。
2. 功能依赖性强：高度依赖 Google NotebookLM 服务的后台可用性、API 稳定性及底层tiangong-workspace环境。任何一方的版本更新或服务变更都可能影响其正常运作。
3. 命令行门槛：纯 CLI 操作方式对不熟悉终端的用户有一定学习成本，初期使用可能不够直观。
4. 错误处理简单：作为轻量封装器，对网络超时、认证过期等异常情况的提示和处理可能不够细致，需要用户具备一定的排查能力。

适合的目标群体

• 研究人员与学生：需要快速消化大量文档、生成文献综述或简报的学术工作者。
• 知识工作者：产品经理、分析师等需要从海量报告中提炼关键信息的职场人士。
• 自动化流程爱好者：希望将 NotebookLM 能力集成到脚本或自动化工作流中的开发者。
• 笔记重度用户：习惯使用命令行工具进行知识管理和内容创作的极客人群。

使用风险提示

作为一个 T3 来源的个人项目，用户在使用前应明确以下几点常规风险：
1. 维护中断风险：由于缺少公开的社区或组织支持，如果开发者停止更新，Skill 可能因底层接口变动而失效。
2. 认证安全：首次使用时需通过notebooklm login完成 Google 账户认证，认证令牌存储在本地环境，用户应确保自身设备的安全性。
3. 超时设置：涉及网络请求或耗时研究操作时，务必使用--exec-timeout参数为进程设定合理的最大执行时间，否则命令可能挂起。