notebooklm-py集合管理指南跨Notebook组织资料的新能力实战【免费下载链接】notebooklm-pyUnofficial Python API and agentic skill for Google Gemini Notebook. Full programmatic access to NotebookLMs features—including capabilities the web UI doesnt expose—via Python, CLI, and AI agents like Claude Code, Codex, and OpenClaw.项目地址: https://gitcode.com/GitHub_Trending/no/notebooklm-pyNotebookLM 里的 notebook 越建越多找不到、理不清notebooklm-py 这个 Google Gemini Notebook原 NotebookLM的非官方 Python API 新加入了集合Collection管理能力你可以像创建播放列表一样把整个 notebook 分门别类地归入命名集合实现跨 notebook 的资料组织。本文用 CLI 和 Python 两种方式带你 10 分钟上手。什么是 NotebookLM 集合和 Label 有什么区别集合Collection是账号级别的分组它把整个 notebook归到一起类似音乐 App 的播放列表一个 notebook 可以同时属于多个集合集合本身不带父级 notebook。它容易和Label标签混淆两者定位完全不同对比项Collection 集合Label 标签作用层级账号级跨 notebooknotebook 内管理 source分组对象整个 notebook单个资料源是否需指定 notebook不需要需要-n/--notebook典型场景Q3 调研归拢 8 个 notebook把一个 notebook 里的资料按主题打标数据模型定义在 src/notebooklm/_types/collections.pyCollection就四个字段id、name、emoji、notebook_ids——简单直接多对多关系成员 notebook 不持有反向引用。快速上手集合管理的 7 个 CLI 命令notebooklm-py 通过notebooklm collection cmd分组命令管理集合完整列表见 docs/cli-reference.md命令作用示例list列出账号下所有集合notebooklm collection listnotebooks查看某集合的成员 notebooknotebooklm collection notebooks Research Q3create创建新集合notebooklm collection create Research Q3rename重命名集合notebooklm collection rename Research Q3 Research Q4add往集合加入 notebook支持一次加多个notebooklm collection add Research Q3 nb123 nb456remove把 notebook 移出集合notebooklm collection remove Research Q3 nb123delete删除集合需-y确认notebooklm collection delete Research Q3 -y三个新手友好细节值得留意id|name复合参数几乎所有命令都接受集合 ID、ID 前缀或精确名称名称重名会列出候选让你消歧不用去翻 ID。remove ≠ 删除remove只是把 notebook 移出该集合notebook 本身安然无恙还留在其他集合里。delete 只删分组delete永远不碰成员 notebook且需要-y显式确认。命令实现位于 src/notebooklm/cli/collection_cmd.py业务逻辑与传输解耦在 src/notebooklm/_app/collections.py支持--json输出便于脚本化。实战用 Python API 批量整理笔记本对脚本化场景client.collectionsCollectionsAPI提供更细粒度的控制API 全表见 docs/python-api.md方法说明list()列出全部集合含成员get(id)/get_or_none(id)按 ID 取集合缺失时抛异常或返回Nonenotebooks(id)展开成Notebook对象列表create(name)创建空集合rename(id, name)重命名保留原 emojiadd_notebooks(id, ids)追加成员已有的不会被覆盖remove_notebooks(id, ids)仅取消归属不删 notebookdelete(ids)批量删除集合幂等一个典型的整理流程参考 tests/e2e/test_collections.py 的真实用例from notebooklm import Collection # 建一个季度调研集合把 3 个 notebook 归进去 research await client.collections.create(Research Q3) await client.collections.add_notebooks(research.id, [nb1, nb2, nb3]) # 季度结束改名归档而不是删除 await client.collections.rename(research.id, Archive Q3)注意delete是幂等的对不存在的目标直接返回None批量清理很安全而add_notebooks/remove_notebooks对每个 ID 各发一次 RPC不跨 ID 原子大批量操作时建议在finally里兜底删除集合这也是官方 E2E 测试的清理纪律。常见问题与最佳实践集合和标签要一起用吗要。Label 管notebook 内资料怎么分主题Collection 管notebook 之间怎么归类两层组合起来就是完整的资料体系。可以嵌套或共享集合吗目前服务端不支持嵌套也不支持集合级共享需要协作时用 docs/python-api.md 里介绍的 notebook 级 Sharing 能力。删了集合notebook 会丢吗不会。三层操作remove / delete / 批量 delete都不触碰成员 notebook只有notebook delete才会删 notebook 本身。想验证线上行为集合的线格式曾出现过静默无效的坑并已在 PR #2009 中修正回归测试见 tests/e2e/test_collections.py可对照了解创建、成员增删、删除幂等性的预期行为。小结notebooklm-py 的集合管理让你第一次可以用代码给 NotebookLM 做账号级的资料架构CLI 的 7 个命令覆盖日常整理CollectionsAPI支撑批量与自动化。从collection create到add_notebooks几分钟就能把散落各处的 notebook 收成清晰的播放列表配合 Label 与 Sharing跨 notebook 组织资料从此有章可循。更多用法请查阅 docs/cli-reference.md 与 README.md。【免费下载链接】notebooklm-pyUnofficial Python API and agentic skill for Google Gemini Notebook. Full programmatic access to NotebookLMs features—including capabilities the web UI doesnt expose—via Python, CLI, and AI agents like Claude Code, Codex, and OpenClaw.项目地址: https://gitcode.com/GitHub_Trending/no/notebooklm-py创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
