NotebookLM 源文档研究
在 Claude Code 中查询 NotebookLM，获得基于用户文档的可引用研究答案。
证据显示技能使用隔离虚拟环境、限制问题长度、对浏览器状态和认证文件设置权限，并为清理操作提供预览和确认；但会保存并注入 Google cookies，使用反检测浏览器访问外部服务，且可直接访问用户提供的 NotebookLM URL，缺少明确的数据流、域名限制、查询前逐次确认和恢复机制，因此扣分。
证据显示有统一 run.py 包装器、认证检查、超时、稳定文本轮询、资源清理和错误返回；但仅静态检查认证状态文件是否存在，依赖安装和浏览器选择存在不一致，NotebookLM 选择器易受界面变化影响，部分异常仅返回 None，缺少覆盖关键路径的可见测试，因此扣分。静态评估不超过10分。
证据显示触发词、命令、参数和本地 Claude Code 使用边界较清楚，并支持独立调用和内部静默回退；但中文语义触发和中文输出支持未说明，核心能力依赖 Google NotebookLM、Chrome、交互式 Google 登录及可达的海外服务，且对无活动 notebook 等边界主要依赖命令行提示，因此扣分。
证据显示文档分层清晰，包含快速参考、前置条件、参数、故障排查、限制、MIT 许可、作者和版本信息，并说明认证数据存储及 gitignore 约束；但维护责任、更新路径和变更记录在该技能文件中不完整，元数据 source 与仓库身份不一致，且部分安装、依赖和平台假设仍需用户自行判断，因此扣分。
证据显示核心流程能够围绕指定 notebook 提问，并提供文本或 JSON 结果、库管理和内部失败回退；但源文件没有证明实际可运行，引用格式要求主要停留在说明层面，脚本并未显式提取来源标题或生成 bibliography，且每次查询启动浏览器、受速率限制并需要人工认证，因此只能给出有限的直接效用分。静态评估不超过7分。
证据包含可审计的 Python 实现、参数定义、错误路径和数据目录说明，但没有在所审查材料中提供覆盖该技能关键路径的测试套件、CI 结果或第三方复现证据；README 的总体测试宣传不能替代本技能的路径覆盖，因此扣分。静态评估不超过5分。
- 认证状态包含 Google cookies 和浏览器配置文件；应明确告知用户其敏感性，并避免在不受信任的 notebook URL 上运行。
- “zero hallucination risk”和 Tier 1 引用保证属于未被本技能静态证据充分证明的强断言；结果仍需人工核验。
- Google NotebookLM、Chrome、Patchright 和选择器变化可能导致查询失败；核心服务在中国大陆网络环境中的可达性未被证明。
- cleanup 的 --force 会跳过确认并删除认证、会话及库数据；虽然属于显式参数，仍应强调不可恢复风险。
这个 Skill 能做什么，适合哪些场景？
这是 claude-blog 仓库中的 blog-notebooklm 技能，专门查询用户上传到 Google NotebookLM 的文档。它管理 NotebookLM 笔记本库、处理 Google 身份验证，并返回带来源信息的答案。该技能可通过 /blog notebooklm 独立调用，也可供 blog-write 和 blog-researcher 作为一级研究数据使用。未配置或认证失败时，内部调用会静默返回，让写作流程继续使用 WebSearch。
它通过 scripts/run.py 运行认证、提问和笔记本管理脚本，检查登录状态，按 URL、ID 或活动笔记本解析查询目标，并在 NotebookLM 中提交问题。每次问题会启动一次无头浏览器会话，从用户上传的文档中提取答案后关闭会话。它支持发现笔记本内容、添加和搜索笔记本、设置活动笔记本、删除笔记本、查看状态及清理浏览器状态；数据保存在技能目录的 library.json、auth_info.json 和 browser_state/ 中。
- 内容作者需要基于自己上传的报告、访谈或资料撰写文章，并希望获得带来源的研究回答。
- 营销团队在 blog-write 或 blog-researcher 流程中，需要把用户自有资料作为一级研究来源。
- 用户刚拿到一个 NotebookLM 链接，需要先发现其主题和内容，再将其加入笔记本库。
- 用户需要管理多个 NotebookLM 笔记本，按关键词搜索、切换活动笔记本或移除旧笔记本。
这个 Skill 有哪些优点和局限？
- 答案限定来自用户上传的文档，定位为 Tier 1 的用户自有一级资料研究。
- 支持 NotebookLM 发现、库管理、认证检查和直接查询。
- 可独立使用，也可供 blog-write 与 blog-researcher 内部调用。
- 内部认证缺失或查询失败时会静默回退，不阻塞写作流程。
- 依赖 Google 账号、NotebookLM 访问权限、Python 3.11+ 和 Google Chrome。
- 需要一次可见浏览器中的人工 Google 登录。
- 每次提问都会新建浏览器会话，没有会话持久化，并存在浏览器启动开销。
- 免费 Google 账号有每天 50 次查询限制，文档必须由用户手动上传。
- 仅适用于本地 Claude Code，不适用于 Web UI；独立安装路径未在来源中说明。
如何安装这个 Skill？
源码只说明它位于 skills/blog-notebooklm/SKILL.md，并未提供该技能的独立安装路径。它随 claude-blog 集合安装；README 提供的公开仓库安装方式包括：git clone https://github.com/AgriciDaniel/claude-blog，进入目录后检查并运行安装脚本，或使用 Claude Code 插件市场安装。安装集合后重启 Claude Code。
如何使用这个 Skill？
首次使用先运行 /blog notebooklm setup，并在打开的浏览器中登录 Google。之后可使用 /blog notebooklm ask <问题> 查询活动笔记本，/blog notebooklm discover <URL> 发现并登记笔记本，/blog notebooklm library list 查看库，/blog notebooklm library add <URL> 添加笔记本，/blog notebooklm status 检查认证状态，或 /blog notebooklm cleanup 清理浏览器状态。脚本调用必须使用 python3 scripts/run.py [script]，不能直接运行脚本。