NotebookLM CLI

核心功能

NotebookLM CLI Wrapper 是 Google NotebookLM 服务的命令行封装工具，通过 Node.js 脚本桥接官方 CLI，提供完整的知识库工作流支持。核心能力覆盖：身份认证（login/status）、笔记本生命周期管理（list/use）、多源文档注入（支持 PDF/网页/YouTube/音频等）、结构化笔记与对话（ask 交互式查询）、Artifacts 生成（自动播客、简报、时间线等可下载资产）。

显著优势

• 原生集成 Google 生态：直接调用 Gemini 驱动的 NotebookLM 后端，研究质量与官方一致
• 批量自动化友好：CLI 形态适合脚本化 pipeline，支持 --json 机器可读输出
• 长时任务可控：通过 --exec-timeout 参数规避大文档处理超时风险
• 零本地存储负担：文档解析与向量化均在云端完成，本地仅传递指令

局限性与风险

• 环境依赖硬性：强制要求 Node.js 运行时及 notebooklm CLI 预装，非开箱即用
• 网络与地区限制：受 Google 服务可用区域制约，部分地区需代理
• Token 成本不透明：NotebookLM 免费 tier 有每日额度限制，超量后行为不可控
• 输出格式锁定：Artifacts 为 Google 预定义模板，自定义程度有限

适用人群

• 研究人员/分析师：需批量处理文献并生成结构化报告
• 内容创作者：快速将文档转化为播客/简报脚本
• 自动化工程师：将知识库问答嵌入 CI/CD 或数据 pipeline

安全提示

CLI 凭证存储于本地 ~/.config/notebooklm，需确保文件权限 600；共享环境使用务必配置独立 Google 账号。

核心用法

NotebookLM CLI Wrapper 是一个极简的命令行代理工具，通过 node {baseDir}/scripts/notebooklm.mjs 调用官方 NotebookLM CLI，实现完整的 AI 研究助手功能生态。用户需预先安装 NotebookLM CLI 并完成登录认证。

主要功能模块：

• 认证管理：login / status 处理会话状态
• 笔记本操作：list 查看所有笔记本，use <id> 切换上下文
• 智能问答：ask "问题" --notebook <id> 基于上传资料进行 RAG 对话
• 来源与笔记：管理 PDF、网页、Google Docs 等知识源，整理研究笔记
• 文稿生成：支持播客脚本、简报、FAQ 等结构化输出
• 分享协作：生成可共享链接，支持团队协作

调用示例：

node {baseDir}/scripts/notebooklm.mjs ask "总结核心要点" --notebook <id> --json

建议对耗时操作添加 --exec-timeout <seconds> 参数，并使用 --json 获取结构化输出便于程序解析。

显著优点

1. 架构极简：仅 26 行核心代码，使用 Node.js 原生 child_process.spawnSync 以 inherit 模式透传 IO，无参数注入风险
2. 零依赖安全：不引入任何 npm 包，完全依赖 Node.js 内置模块，杜绝供应链攻击
3. 功能完整：完整代理 NotebookLM 官方能力，涵盖 Google 系 AI 产品的核心研究场景
4. 透明可信：代码行为与声明完全一致，无隐藏网络请求、无敏感信息收集、无动态代码执行
5. 隐私合规：符合 GDPR 数据最小化原则，不直接处理用户数据，所有隐私敏感操作委托给官方 CLI

潜在缺点与局限性

• 前置依赖重：必须独立安装 NotebookLM CLI，无自动安装或检测机制，新手门槛较高
• 错误提示粗糙：直接透传 CLI 退出码，非零退出时缺乏友好的故障诊断指引
• 功能受限于上游：完全依赖官方 CLI 的版本能力，无法扩展或定制底层行为
• 无交互式体验：纯命令行透传，不支持进度可视化或流式输出优化
• T3 来源风险：个人开发者维护，长期更新稳定性需持续关注

适合人群

• 已熟悉 NotebookLM 生态、希望将能力集成到自动化工作流的技术用户
• 需要在 CI/CD 或服务器环境中批量调用 NotebookLM 的开发者
• 对供应链安全敏感、追求零依赖部署的安全意识用户
• 构建以 NotebookLM 为核心的研究自动化工具链的 AI 应用开发者

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 代码注入 | 极低 | spawnSync 使用参数数组而非字符串拼接，无注入路径 |

| 供应链攻击 | 极低 | 零第三方依赖，仅依赖 Node.js 运行时 |

| 网络窃密 | 低 | 不直接发起网络请求，但代理的 CLI 会连接 Google 服务 |

| 数据泄露 | 低 | 不本地存储敏感信息，数据留存政策取决于 NotebookLM 官方 |

| 服务中断 | 中 | 依赖上游 CLI 稳定性，个人维护的包装器更新可能滞后 |

建议缓解措施： 验证 NotebookLM CLI 官方来源、关注包装器版本更新、对生产环境使用进行额外安全审计。