nlm-skill 是 Gemini Notebook（原 Google NotebookLM）CLI（命令名 nlm）与 MCP 服务器的专家指南技能，用于指导通过这两种接口操作 Gemini Notebook。
用途 该技能面向需要通过命令行或 MCP 工具访问 Gemini Notebook 的场景，提供工具检测、接口选择、认证、命令调用与工作流编排方面的指引。
工具检测与选择 使用前先确认哪些工具可用：检测 MCP 工具（名称可能是 mcp__gemini-notebook-mcp__、mcp__notebooklm_mcp__ 或 mcp_gemini_notebook_mcp_*），并检测是否可以运行 nlm 命令。选择逻辑为：用户明确指定 MCP 或 CLI 时按用户指定；需要 MCP 下载目录之外的工作区输出，或需要显式 --profile 而不切换默认账号时使用 CLI；否则若存在 MCP 工具则用 MCP，否则用 CLI。使用不熟悉的选项前，先阅读工具文档字符串或运行 nlm <command> --help。
主要能力
- 认证与多配置文件：nlm login 启动浏览器提取 cookies；nlm login --check 校验会话；支持命名配置文件（--profile）、配置文件列表/删除/重命名/切换，以及加密存储模式（nlm auth storage set protected/file）；nlm auth refresh 提供无人值守的无头刷新。CLI 内置三层自动认证恢复（CSRF 刷新、令牌重载、无头认证）与三次服务器错误重试。
- 笔记本管理：列表、创建、获取、AI 摘要描述、重命名、删除与查询问答。
- 来源管理：从 URL/网页、YouTube、粘贴文本、Google Drive 或本地文件添加来源，并可通过研究功能发现新来源。
- 内容生成（Studio）：生成音频/播客、报告、测验与闪卡、思维导图、幻灯片、信息图、视频和数据表。
- 用量与配额：nlm usage 或 MCP 的 usage_get 查询滚动窗口与每周配额、已用百分比与 UTC 重置时间，支持按配置文件单独查询。
使用方式 CLI 快速参考包括 nlm --help、nlm <command> --help、nlm --ai（AI 优化完整文档）、nlm --version、nlm usage（含 --json）。查询来源使用 nlm notebook query <nb-id> "question"；后续追问可用 --conversation-id，独立提问可用 --new-conversation；不要使用 nlm chat start（它是面向人类的交互式 REPL，AI 工具无法控制）。输出格式方面，默认输出简洁省 token，--quiet 便于管道获取 ID，仅在需要程序化解析字段时使用 --json。可用 nlm alias set <name> <uuid> 简化长 UUID，创建别名前先运行 nlm alias list 检查冲突。
适用场景 覆盖首次使用 NotebookLM、向笔记本添加各类内容、查询配额、从来源生成内容、围绕文档进行改写/评审/改进、基于限定公开 X 研究、构建含嵌入元素的课程式交互报告、就来源提问、查看或导出历史对话、检查生成状态以及清理管理等。
限制与注意事项
- 删除不可逆：执行任何删除命令前必须向用户请求明确确认，并说明将删除的内容与永久数据丢失风险。
- 生成与删除需审批：studio_create 与删除操作强制 --confirm/confirm=True；当前 MCP 批量 Studio 路径不强制其 confirm 参数，因此代理必须自行保留审批环节。
- 研究功能需要目标：须传 --notebook-id <id> 指定已有笔记本，或传 --title <title> 创建新笔记本。
- 区分网络故障与认证过期：auth_status="unverified" 表示探测结果不确定，应先检查连通性再要求重新登录。
- MCP 与 CLI 共享同一认证后端，任一认证对两者均有效；MCP 账户切换后在该服务器重启前对后续所有调用生效。
- 电影级视频始终需要引导（受配额限制）。
- 创建/启动命令会返回后续操作所需的 ID，需从输出中捕获。