---

name: notebooklm description: "与Google NotebookLM交互，使用Gemini基于来源的回答查询文档。每个问题打开一个新的浏览器会话，专门从你上传的文档中检索答案，然后关闭。" risk: unknown source: community date_added: "2026-02-27"

NotebookLM研究助手技能

与Google NotebookLM交互，使用Gemini基于来源的回答查询文档。每个问题打开一个新的浏览器会话，专门从你上传的文档中检索答案，然后关闭。

何时使用本技能

在用户以下情况时触发：

• 明确提到NotebookLM
• 分享NotebookLM URL（https://notebooklm.google.com/notebook/...）
• 要求查询他们的笔记本/文档
• 想要将文档添加到NotebookLM库
• 使用类似"问我的NotebookLM"、"检查我的文档"、"查询我的笔记本"的短语

关键：Add命令 - 智能发现

当用户想要添加笔记本但未提供详情时：

智能添加（推荐）：先查询笔记本以发现其内容：

# Step 1: Query the notebook about its content
python scripts/run.py ask_question.py --question "What is the content of this notebook? What topics are covered? Provide a complete overview briefly and concisely" --notebook-url "[URL]"

# Step 2: Use the discovered information to add it
python scripts/run.py notebook_manager.py add --url "[URL]" --name "[Based on content]" --description "[Based on content]" --topics "[Based on content]"

手动添加：如果用户提供了所有详情：

• --url - NotebookLM URL
• --name - 描述性名称
• --description - 笔记本包含的内容（必需！）
• --topics - 逗号分隔的主题（必需！）

永远不要猜测或使用通用描述！如果缺少详情，使用智能添加来发现它们。

关键：始终使用run.py包装器

永远不要直接调用脚本。始终使用 python scripts/run.py [script]：

# ✅ CORRECT - Always use run.py:
python scripts/run.py auth_manager.py status
python scripts/run.py notebook_manager.py list
python scripts/run.py ask_question.py --question "..."

# ❌ WRONG - Never call directly:
python scripts/auth_manager.py status  # Fails without venv!

run.py 包装器自动：

1. 如需创建 .venv
2. 安装所有依赖
3. 激活环境
4. 正确执行脚本

核心工作流

步骤1：检查认证状态

python scripts/run.py auth_manager.py status

如果未认证，继续设置。

步骤2：认证（一次性设置）

# Browser MUST be visible for manual Google login
python scripts/run.py auth_manager.py setup

重要：

• 浏览器对认证可见
• 浏览器窗口自动打开
• 用户必须手动登录Google
• 告诉用户："将打开一个浏览器窗口进行Google登录"

步骤3：管理笔记本库

# List all notebooks
python scripts/run.py notebook_manager.py list

# Add a notebook
python scripts/run.py notebook_manager.py add --url "URL" --name "名称" --description "描述" --topics "主题1,主题2"

# Remove a notebook
python scripts/run.py notebook_manager.py remove --name "名称"

步骤4：查询笔记本

# Ask a question (auto-selects best notebook)
python scripts/run.py ask_question.py --question "你的问题"

# Ask specific notebook
python scripts/run.py ask_question.py --question "你的问题" --notebook-url "URL"

# Ask with specific notebook name
python scripts/run.py ask_question.py --question "你的问题" --notebook-name "名称"

响应格式

查询结果包含：

• 来自文档的直接回答
• 来源引用（标注来自哪个文档）
• 相关上下文片段

注意事项

• 每次查询打开新的浏览器会话（无头模式）
• 回答仅基于上传的文档，不使用外部知识
• 需要有效的Google认证
• 笔记本URL必须是用户有权访问的
• 大型文档可能需要更长的处理时间

限制

• 仅在任务明确匹配上述范围时使用本技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少所需输入、权限、安全边界或成功标准，请停下来要求澄清。