用途：notebooklm-py 为 Google NotebookLM 提供命令行访问，覆盖网页界面未开放的部分能力，适合自动化研究、批量导入资料与产物生成。
主要能力：创建笔记本；添加来源（URL、YouTube、PDF、音频、视频、图片、Google Docs、文本、Markdown、Word）；与内容对话并返回引用；生成播客、视频、幻灯片、信息图、报告、思维导图、数据表、测验、闪卡；下载多种格式；支持 JSON 输出、批量下载、来源全文提取与程序化分享。
安装与认证：uv tool install notebooklm-py；notebooklm login 完成 Google OAuth；notebooklm status 验证。常用命令：notebooklm create "Title"、notebooklm source add "https://..."、notebooklm ask "question"、notebooklm generate audio "instructions"、notebooklm artifact wait <artifact_id>、notebooklm download audio ./output.mp3。
并行与 CI：可用 NOTEBOOKLM_HOME 指定配置目录，NOTEBOOKLM_AUTH_JSON 内联认证；多智能体并发时用 -n <notebook_id> 或 --notebook 避免共享上下文冲突。
限制：非官方 API，依赖浏览器自动化，Google 变更内部实现时可能失效，与 Google 无关联；每个笔记本最多 50 个来源；生成接口受 Google 速率限制；OAuth 会话会过期需重新登录；聊天不支持流式返回；notebooklm use 写入共享上下文文件，并行场景需显式指定笔记本。生成类操作耗时较长，建议设置超时并处理重试。