notebooklm-cli

name	notebooklm-cli
related_skills	["knowledge-extraction"]
description	子skill | NotebookLM CLI全功能指南 — Q&A知识提取、内容生成(报告/视频/音频/信息图/幻灯片)、文献检索。响应paper-pipeline的P1阶段调用。
version	1.0.0
allowed-tools	["terminal","file","web"]
license	MIT
author	Synthos
metadata	{"synthos":{"version":"3.5.0","author":"Synthos","signature":"action: str, params: dict -> result: dict"}}

IO_CONTRACT

• input: request: str, context: dict — 用户请求描述、上下文信息
• output: result: dict — 技能执行结果（结构因技能而异）

对应原则：P2（机械原子暴露输入输出规范）

NotebookLM CLI — 知识大脑

架构定位: NotebookLM = Synthos 的廉价知识大脑 (Tier 1)。详见 references/knowledge-brain-architecture.md。

核心原理（文言）

一问一收，不并投 — 每轮只问一个问题，用答案决定下一个。不一次全抛。

言不必行 — Q&A输出≠源代码执行结果。

节点有闸 — Gap门/假设门/方法门/实验门，每节点过闸才前进。

快速参考

功能	命令	参考
登录	notebooklm login	references/cli-cheatsheet.md
列表	notebooklm list	—
切换	notebooklm use <partial_id>	—
问答	notebooklm ask "问题"	逐问法见下。注意：回答需30-60s，超时设为≥90s
搜索	notebooklm source add-research "query"	导入网页源(非PDF)
上传	notebooklm source add file.pdf	v0.4.1+自动类型检测
PDF上传	source add "https://arxiv.org/pdf/{id}"	arXiv URL直传
清理	notebooklm source clean -n <id> -y	自动去重清理
删除	notebooklm source delete <id> -y	Owner项目有效
生成	notebooklm generate <type>	report/video/audio/slide-deck/infographic
下载	notebooklm download <type> <id>	语法因类型而异
状态	notebooklm artifact list	监控生成任务

逐问法（核心方法）

每轮一个问题，答案决定下一个。标准序列：Q1领域地图→Q2共同盲区→Q3形式化Gap→Q4科学假设→Q5技术方案→Q6实验设计。

详见 references/iterative-literature-first-paper-protocol.md。

三步确权法

1. 问状态 → 2. 问数值 → 3. 问来源

关键陷阱

• ⚠️ .ipynb文件上传400错误: NotebookLM不支持ipynb格式上传，返回400 Bad Request。解决方法：提取代码cell为文本文件后再上传或转markdown后用--type text模式
• ⚠️ symlink文件被拒绝: 默认拒绝symlink路径，需加 --follow-symlinks 参数
• ⚠️ ask超时: NotebookLM回答需30-60s，timeout至少设90s（默认可不够）
• ⚠️ 传入Markdown: source add "$(cat file.md)" --type text（非 file.md）
• ⚠️ YAML frontmatter导致---被click解析错误: 上传前剥离
• ⚠️ 无文本层PDF: 用 pdftotext pdf - | wc -c 检查，≈0则用arXiv URL直传
• ⚠️ 同一项目禁止并行ask(串话)
• ⚠️ Slide-deck下载认证失败: Gemini描述→python-pptx重建
• ⚠️ Shell参数限制: $(cat bigfile) 超80KB报错, 用Python subprocess
• ⚠️ source delete在Shared项目伪成功(仅Owner有效)
• ⚠️ PDF索引超时: 无可提取文本层, 预先pdftotext检查
• ⚠️ PDF源静默失败: notebooklm source add file.pdf 可能返回 status: error 且无stderr提示。检测方式: 立即 notebooklm source list，若状态为error则回退到 pdftotext file.pdf - 提取文本后以 --type text 上传
• ⚠️ Security Scan拦截混合语言Prompt: notebooklm ask 在Prompt含中文字符时可能触发confusable Unicode安全扫描（HIGH级别，tirith:confusable_text）。解决方式: 使用纯英文ASCII Prompt发送
• ⚠️ Source状态不一致: 刚上传的source可能 list 返回空列表（API缓存未刷新），重试2-3次后通常会恢复
• ⚠️ Google服务网络不可达: 在受限网络环境下（如无外网代理的服务器），notebooklm list 等命令会在 CSRF token 获取阶段抛出 httpx.ConnectTimeout。诊断方法：
  1. curl --connect-timeout 10 -s -o /dev/null -w "%{http_code}" https://notebooklm.google.com — 返回 000 说明不可达
  2. curl --connect-timeout 10 -s -o /dev/null -w "%{http_code}" https://httpbin.org/ip — 返回 200 说明其他互联网可达但 Google 被阻断
  3. 此时使用 Manual Fallback 方案代替 NotebookLM 执行 Layer B

完整陷阱列表见 references/notebooklm-cli-pitfalls.md。

Layer B 项目污染案例：references/project-isolation-case.md — 旧项目 source 残留导致审计报告错误的完整案例和验证清单。

Layer B 报告模板：references/layer-b-audit-template.md — 标准化 Layer B 审计报告格式。

Layer B 质检流程

Layer B 论文质量审计的完整工作流见 references/layer-b-audit-workflow.md。涵盖：项目创建→源上传（PDF/引用/质量报告）→纯英文ASCII Prompt发送→评分阈值判定→pipeline state cross-validation（检测false positive）→报告归档。

Fallback: Manual Layer B (当 NotebookLM 不可达时)

当 notebooklm list 或 notebooklm doctor 显示网络连通性故障（如 httpx.ConnectTimeout，curl 返回 000），且无法通过代理恢复对 notebooklm.google.com 的访问时：

1. 不要放弃 Layer B — 使用 paper 的全文进行人工质量评估
2. 获取文本：pdftotext <paper-dir>/paper.pdf - | head -c 50000 — 提取全部可读文本
3. 评估五个维度：
   • 原创性/重要性 — 检查 gap claim（ABSOLUTE WHITE 是否可信）、临床相关性
   • 方法学严谨性 — 检查 ODE/PINN 公式完整性、指标适当性、消融实验设计
   • 结果可信性/可复现性 — 检查是否提供完整参数、有无代码链接、有无置信区间
   • 文献引用质量 — 依赖 D8/D10a 扫描数据（非 NotebookLM 评估）
   • 写作/结构 — IMRaD 完整性、清晰度
4. 按 references/layer-b-audit-template.md 编写报告
5. 保存到 <paper-dir>/07-quality/layer-b-report.md
6. 阈值不变：≥0.85=T1, 0.75-0.84=T2, <0.75=不通过

详见 references/layer-b-manual-fallback.md。