notebooklm-studio

NotebookLM Studio

概述

当用户希望 Codex 将文件、URL、YouTube 链接、笔记、转录文本、类似 Drive 的来源或研究材料转换为 NotebookLM 笔记本和 NotebookLM Studio 输出时，使用此技能。目标是让 Codex 充当操作人员：准备来源、创建或复用笔记本、生成可用的官方产物、下载输出，并清楚说明限制。

此技能在可用时依赖来自 notebooklm-py 的 notebooklm CLI。该 CLI 并非官方工具，且使用未公开的 NotebookLM 接口，因此每个工作流都必须先探查环境，再假设其可运行。

操作规则

1. 仅导入用户拥有、提供或获准使用的来源。不得绕过付费墙、DRM、私人访问控制或版权限制。
2. 优先使用 NotebookLM 官方输出，而非本地重建。如果 CLI 或账户方案未提供某种输出，则创建基于来源的备用内容，并标明其为衍生产物。
3. 保持产物可追溯：返回已知的笔记本标题和 ID、来源数量、生成的产物名称、本地下载路径，以及任何失败或跳过的输出。
4. 如需了解当前的功能可用性、限制和导出格式，请加载 references/notebooklm-capabilities.md。
5. 如需准确的 CLI 命令和支持的自动化标志，请加载 references/notebooklm-py-cli.md。
6. 如需处理混合来源和“任意来源”请求，请加载 references/source-ingestion.md。
7. 如需了解输出映射和备用方案的选择，请加载 references/artifact-strategy.md。

首次初始化

当新用户要求初始化、设置或开始使用此技能时，应尽可能自动完成设置。除非出错，否则不要要求用户手动配置软件包路径、文件夹、配置文件或命令。

1. 运行引导检查：

python scripts/bootstrap_notebooklm.py --json --print-guide

2. 如果缺少 notebooklm，请征求用户同意以安装依赖项，然后运行：

python scripts/bootstrap_notebooklm.py --install --print-guide

3. 如果缺少身份验证或身份验证已过期，请让用户完成 Google 登录步骤，然后运行：

python scripts/bootstrap_notebooklm.py --login --auth-test --print-guide

登录浏览器是手动操作的界限：Codex 可以启动浏览器，但用户必须选择 Google 账户、完成任何 MFA 验证并授予访问权限。登录完成后，Codex 应再次运行环境检查，并告知用户 NotebookLM 是否已就绪。

4. 初始化后立即回复一份简洁而完整的指南。优先使用 bootstrap_notebooklm.py --print-guide 生成的指南；如需更完整的教程，请加载 references/quickstart-guide.md。

5. 如果用户需要本地控制室 UI，请从当前项目／工作区启动仪表板：

python scripts/dashboard_server.py --host 127.0.0.1 --port 8765 --profile default --out-dir ./notebooklm_outputs/dashboard

然后向用户提供本地 URL。如果端口 8765 已被占用，请选择下一个可用的本地端口，并告知用户实际 URL。

标准工作流

1. 仅在必要时确认交付要求：受众、语言、产物类型、输出文件夹，以及是创建新笔记本还是复用现有笔记本。
2. 运行环境检查：

python scripts/validate_environment.py --json

如果缺少 notebooklm，请说明 NotebookLM 自动化需要 notebooklm-py 和 Google 身份验证。安装软件包或打开浏览器登录前，请先征求用户同意。

3. 上传前创建来源清单：

python scripts/source_manifest.py --output /tmp/notebooklm-sources.json SOURCE...

检查有关不支持的扩展名、文件过大、来源过多、文件缺失、付费墙 URL，或缺少可用字幕的 YouTube 视频等警告。

4. 使用优化后的产物流程创建试运行计划：

python scripts/artifact_pipeline.py plan --notebook-title "Project Title" --source SOURCE --artifact audio --artifact video --artifact mind-map --artifact slide-deck --download --out-dir ./outputs

5. 仅当计划无误且身份验证已就绪后再运行：

python scripts/artifact_pipeline.py run --notebook-title "Project Title" --source SOURCE --artifact audio --artifact video --artifact mind-map --artifact slide-deck --download --out-dir ./outputs --status-file ./outputs/notebooklm-jobs.json

6. 验证输出：列出产物、检查本地文件是否存在、检查文件大小，并总结生成的内容。

优化后的制品流水线

对于多制品请求，优先使用 scripts/artifact_pipeline.py，而不是较旧的线性编排器。它通过在 NotebookLM 支持时使用 --no-wait 提交所请求的制品，再轮询共享任务表，避免出现“音频必须等视频完成后才能开始”的问题。制品完成后会立即下载；失败的制品不会阻碍其他无关输出。

对于“制作音频、视频、思维导图和幻灯片”之类的请求，请使用以下模式：

python scripts/artifact_pipeline.py run \
  --notebook-title "Research Pack" \
  --source ./report.pdf \
  --source https://example.com/article \
  --artifact audio \
  --artifact video \
  --artifact mind-map \
  --artifact slide-deck \
  --download \
  --download-slide-format both \
  --convert-mind-map-html \
  --status-file ./notebooklm_outputs/research-pack-jobs.json \
  --out-dir ./notebooklm_outputs

流水线应将每个制品报告为 planned、submitted、in_progress、completed、downloaded、failed、submit_failed、download_failed 或 timeout。不要让失败的视频阻碍音频、思维导图或幻灯片的交付。

本地仪表板

此技能包含一个便携式本地仪表板，位于 dashboard/ 下，由 scripts/dashboard_server.py 提供服务。用户要求可视化的 NotebookLM Studio 控制室、浏览笔记本、启动常见制品工作流、检查生成状态，或将已完成的输出交给 Codex 时，请使用它。

从用户当前项目文件夹启动，以便输出保存在该项目中：

python scripts/dashboard_server.py \
  --host 127.0.0.1 \
  --port 8765 \
  --profile default \
  --out-dir ./notebooklm_outputs/dashboard

仪表板功能：

• 列出笔记本、来源、NotebookLM 原生制品和最近生成的任务。
• 提供九种基于目标的工作流方案，以及九种 NotebookLM 原生 Studio 工具。
• 在后台提交真实的 NotebookLM CLI 任务，并下载已完成的制品。
• 写入交接文件，以及供 Codex 分析的纯文本 latest_agent_prompt.md。
• 提供手动复制提示词的备用方式：打开所选提示词面板，并在浏览器剪贴板访问受阻时提示用户按 Command+C / Command+V。

仪表板的安全性与便携性：

• 默认绑定到 127.0.0.1。除非用户明确了解网络暴露风险，否则不要绑定到 0.0.0.0。
• 将生成的输出保存在 --out-dir 指定的位置；默认目录为当前工作区的 notebooklm_outputs/dashboard。
• 将仪表板视为用户已授权的 NotebookLM 账号的操作界面，而不是公共服务。

思维导图可视化

NotebookLM 会将思维导图下载为 JSON。用户请求思维导图时，应将 JSON 视为官方标准制品，然后自动创建交互式本地 HTML 视图：

python scripts/mindmap_html.py ./notebooklm_outputs/mind-map.json -o ./notebooklm_outputs/mind-map.html

启用 --convert-mind-map-html 后，artifact_pipeline.py 会自动执行此操作，且该选项默认启用。请同时返回这两个文件：JSON 用于追溯，HTML 供人阅读。

制品默认值

使用以下制品名称搭配 scripts/nblm_orchestrator.py --artifact 和 notebooklm generate CLI：

• audio：音频概览／播客风格摘要。
• video：视频概览。
• cinematic-video：用户有权限时生成电影风格的视频概览。
• report：NotebookLM 报告；适当时使用 --report-format briefing-doc、study-guide、blog-post 或 custom。
• mind-map：思维导图制品。
• quiz：交互式测验。
• flashcards：闪卡组。
• slide-deck：NotebookLM 幻灯片。
• infographic：NotebookLM 信息图。
• data-table：结构化表格导出。

对于深度分析 JSON、编辑脚本、翻译后的简报或自定义表格等非 Studio 原生制品的请求，请使用 notebooklm ask --json 或生成的报告作为依据层，然后创建带引文的本地衍生制品，并标明其为衍生内容。

面向用户的结果约定

工作流结束后，回复中应说明：

• 使用或创建了哪个笔记本。
• 添加了哪些来源，跳过了哪些来源。
• 哪些输出是 NotebookLM 官方制品，哪些由 Codex 衍生生成。
• 本地制品路径；文件存在时使用绝对路径。
• 影响结果的任何账号套餐限制、年龄限制功能、身份验证失败或已知的 NotebookLM 不准确之处。

在制品已下载或已在 NotebookLM 中验证之前，不要声称该制品已生成。