sourcebolt

sourcebolt

让你的 AI 助手使用 Google NotebookLM 笔记本：一个小巧、快速的程序，无需安装其他任何东西。

2 分钟内完成安装

你想要……	前往
运行一条命令，完成所有安装和连接	下面的两条命令
查看适用于你的 AI 应用（Claude、Cursor、VS Code、Windsurf、Gemini CLI、ChatGPT）的图示指南	分步指南
让你的 AI 应用代你安装	让 AI 为你安装
使用 npm、Docker 或手动设置（开发者）	安装和连接你的 AI 应用

Windows（打开 PowerShell，粘贴并按 Enter）：

irm https://raw.githubusercontent.com/candidloom-hub/sourcebolt/main/install.ps1 | iex

macOS 和 Linux（打开终端，粘贴并按 Enter）：

curl -fsSL https://raw.githubusercontent.com/candidloom-hub/sourcebolt/main/install.sh | sh

安装程序会检查下载内容，只为你的用户安装 sourcebolt，然后提供运行 sourcebolt setup 的选项。设置过程会查找你的 AI 应用，连接你选择的应用（并备份其设置），然后打开浏览器窗口，让你登录 Google。你的密码只会发送给 Google。

快速开始 · 安装 · 连接你的应用 · 工具 · 常见问题 · 文档

独立项目。 sourcebolt 并非由 Google 制作、认可或赞助。“NotebookLM”是 Google LLC 的商标。NotebookLM 没有面向个人账户的公开 API，因此 sourcebolt 使用与 NotebookLM 网站相同的内部网络调用。依赖它之前，请阅读限制与风险。

功能介绍

sourcebolt 是一个 MCP 服务。MCP（模型上下文协议）是 Claude、Cursor、VS Code 和 Codex 等 AI 应用调用外部工具的标准。连接 sourcebolt 后，你可以向助手提出如下请求：

• “列出我的 NotebookLM 笔记本。”
• “将这三篇文章添加到我的 Thesis 笔记本。”
• “询问 Thesis 笔记本中的资料对样本量有何看法，并附上引文。”
• “研究近期的电池回收工作，并导入最好的资料来源。”

助手调用 sourcebolt，sourcebolt 使用你自己的 Google 会话与 NotebookLM 通信，然后返回附有资料来源引文的答案。

关键数据

在 GitHub Actions 运行器上测得（2 个 CPU，AMD EPYC 7763），版本为 v0.2.0，数据为中位数。方法和原始数据见：bench/RESULTS.md 和 docs/performance.md。

项目	结果
启动时间（从启动到就绪）	8.2 ms
程序大小	约 10 MB，单个文件
空闲时的内存占用	16.2 MB
sourcebolt 每次调用自身的处理耗时，100 个笔记本，已缓存 / 未缓存	0.40 ms / 0.76 ms
聊天：Google 发出首个数据块后首次显示进度	+0.3 ms
一次真实的 notebook_list Google 调用	中位数 848 ms（主要耗时来自 Google；一台笔记本电脑，2026-10-14）

快速开始

1. 安装。 从最新版本下载适用于你系统的文件，并将 sourcebolt 放到 PATH 中。分步命令见安装。

2. 登录。 使用调试端口启动 Brave 或 Chrome，在该窗口中登录 NotebookLM，然后运行：

   sourcebolt login --attach http://127.0.0.1:9222
   

   你应该会看到 Saved profile "default" for notebook.google.com (N notebooks visible).。各系统的浏览器命令见 docs/auth.md。从 v0.2.0 之后的版本开始，sourcebolt setup 会为你完成第 2 至第 4 步（docs/getting-started.md）。

3. 检查。

   sourcebolt doctor
   

   每行都应以 ok 开头。

4. 连接 AI 应用。 以 Claude Code 为例：

   claude mcp add sourcebolt -- sourcebolt serve
   

   v0.2.0 之后，你也可以改为安装 Claude Code 插件，它会添加服务和 sourcebolt 技能（程序仍须位于你的 PATH 中）：

   /plugin install sourcebolt --marketplace candidloom-hub/sourcebolt
   

   其他应用： 连接 AI 应用。一键安装链接：docs/install-links.md。

5. 提问。 在应用中输入：“使用 sourcebolt 列出我的 NotebookLM 笔记本，然后让第一个笔记本提供一段带引文的段落摘要。”

包含预期输出的完整操作指南见 docs/getting-started.md。

安装

当前版本为 v0.3.3。不确定该选哪种方式？请参阅 docs/install.md，或使用单行安装程序（它会验证下载文件的校验和，无需管理员权限；-Uninstall / --uninstall 可撤销安装）：

irm https://raw.githubusercontent.com/candidloom-hub/sourcebolt/main/install.ps1 | iex   # Windows PowerShell

curl -fsSL https://raw.githubusercontent.com/candidloom-hub/sourcebolt/main/install.sh | sh   # macOS, Linux

通过 Cline 等 AI Agent 安装？请让它参考 llms-install.md：其中包含适用于 Agent 的步骤，你仍需自行登录 Google。

渠道	状态	方式
GitHub 版本二进制文件	可用	适用于 Windows、macOS 和 Linux，支持 x64 和 ARM64。见下文。
go install	可用	需要 Go 1.27 或更高版本。
Docker（GHCR）	可用	ghcr.io/candidloom-hub/sourcebolt:0.3.3。镜像仅按版本打标签；没有 latest 标签。
npm（npx）	可用	npx -y sourcebolt serve（需要 Node.js 18+）。在应用的 MCP 配置中：命令为 npx，参数为 ["-y", "sourcebolt", "serve"]。
PyPI（pipx、uvx）	尚未发布

版本二进制文件

Windows（PowerShell）。 这会将 sourcebolt.exe 放到用户配置文件夹中，并将该文件夹添加到你的 PATH。对于 ARM64 PC，请将 amd64 替换为 arm64。

$dir = "$env:LOCALAPPDATA\Programs\sourcebolt"
New-Item -ItemType Directory -Force $dir | Out-Null
Invoke-WebRequest https://github.com/candidloom-hub/sourcebolt/releases/download/v0.3.3/sourcebolt_0.3.3_windows_amd64.zip -OutFile "$env:TEMP\sourcebolt.zip"
Expand-Archive "$env:TEMP\sourcebolt.zip" -DestinationPath $dir -Force
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$dir", "User")

打开一个新终端，然后运行 sourcebolt --version。它会显示 sourcebolt 0.3.3。

macOS 和 Linux（bash）。 将 OS 设置为 darwin 或 linux，并将 ARCH 设置为 amd64 或 arm64。

OS=linux ARCH=amd64
curl -fsSLO "https://github.com/candidloom-hub/sourcebolt/releases/download/v0.3.3/sourcebolt_0.3.3_${OS}_${ARCH}.tar.gz"
tar -xzf "sourcebolt_0.3.3_${OS}_${ARCH}.tar.gz" sourcebolt
mkdir -p ~/.local/bin && mv sourcebolt ~/.local/bin/
sourcebolt --version

如果找不到 sourcebolt，请将 ~/.local/bin 添加到你的 PATH。每个版本都包含一个 checksums.txt，其中为每个归档文件提供无密钥 cosign 签名和 CycloneDX SBOM（软件物料清单）；docs/security.md 介绍了如何验证它们。

Go

go install github.com/candidloom-hub/sourcebolt/cmd/sourcebolt@latest

Docker

docker run -i --rm -v sourcebolt-config:/config ghcr.io/candidloom-hub/sourcebolt:0.3.3

镜像没有操作系统密钥环，因此配置文件密钥会保存在 /config 卷中的文件里。请像保护密码一样保护该卷。0.2.0-browser 标签为回退路径添加了浏览器。在容器内登录： docs/auth.md。

连接你的 AI 应用

请先登录。所有应用都使用相同的命令启动：sourcebolt serve。如果 sourcebolt 不在你的 PATH 中，请改用程序的完整路径（例如在 Windows 上，在 JSON 中使用 C:\\Users\\you\\AppData\\Local\\Programs\\sourcebolt\\sourcebolt.exe）。

应用	可在本地运行？	设置
Claude Code	是	claude mcp add sourcebolt -- sourcebolt serve，或在 v0.2.0 之后使用插件：/plugin install sourcebolt --marketplace candidloom-hub/sourcebolt
Claude Desktop	是	添加到 claude_desktop_config.json（见下文）
Cursor	是	添加到 ~/.cursor/mcp.json（见下文）
VS Code（Copilot Agent 模式）	是	code --add-mcp '{"name":"sourcebolt","type":"stdio","command":"sourcebolt","args":["serve"]}'
Windsurf	是	添加到其 mcp_config.json（见下文）
Codex CLI 和 IDE	是	codex mcp add sourcebolt -- sourcebolt serve
Gemini CLI	是	gemini mcp add -s user sourcebolt sourcebolt serve
ChatGPT 桌面应用	是，作为本地（STDIO）服务	设置、MCP 服务；与 Codex 配置共用
ChatGPT 网页版	否	需要公开的 HTTPS 服务。sourcebolt 按设计仅在你的电脑上运行。

Claude Desktop、Cursor 和 Windsurf 使用的 JSON 格式：

{
  "mcpServers": {
    "sourcebolt": { "command": "sourcebolt", "args": ["serve"] }
  }
}

文件位置、VS Code JSON、Codex TOML、HTTP 模式以及经过测试的配置片段：docs/clients.md。

工具预算有限？在 args 中添加 "--tools", "minimal"，即可仅开放 8 个核心工具。

助手可以做什么

按任务分类。所有工具、选项和状态都列在生成的参考文档中：docs/tools.md。

任务	工具
查找和打开笔记本	notebook_list、notebook_open、notebook_create、notebook_update
添加和读取来源（网页、YouTube、粘贴的文本）	source_add、source_list、source_read、source_update
提出问题并获取引文	chat_ask、chat_status、chat_history、chat_configure、suggest
在网络上查找新来源	research_start、research_status、research_import
记录笔记	note_list、note_save
Studio（音频、报告、抽认卡等）	studio_list、studio_generate
分享、标签、账户	share_status、share_update、label_list、label_update、account_settings
清理	delete（始终先预览）、job_cancel

某些选项目前尚不可用，例如 Drive 和文件上传，以及尚未通过实时捕获确认的 Studio 选项值。它们会返回明确的 UNSUPPORTED_BY_TRANSPORT 错误，而不是静默失败。SKILL.md 会告诉 Agent 在何时使用哪个工具。

工作原理

1. 优先直接调用。 sourcebolt 会通过 HTTP/2，使用你的会话 Cookie 发送 NotebookLM 自身的内部 Web 请求（称为 RPC，即远程过程调用）。这是最快的方式。
2. 浏览器回退。 如果 Google 拒绝直接请求，sourcebolt 可以在单独的配置文件中通过无头 Chrome 系浏览器重试。需要安装 Brave、Chrome 或 Edge（或者使用 -browser Docker 镜像）。
3. 页面回退。 如果 Google 更改了聊天或添加来源请求的格式，sourcebolt 可以直接在 NotebookLM 页面中输入内容并读取回答（称为“DOM”回退，名称源自它所操作的页面结构）。

使用 --no-browser-fallback 关闭浏览器回退路径。server_info 会显示最近一次调用所使用的路径。详情见：docs/auth.md。

常见问题

这是 Google 的官方产品吗？ 不是。这是一个独立的开源项目。

sourcebolt 会看到我的 Google 密码吗？ 不会。你会在普通浏览器窗口中自行登录。sourcebolt 只会保留会话 Cookie，并在你的磁盘上加密存储。

AI 能读取我的 Cookie 吗？ 不能。没有任何工具会接收或返回 Cookie 或密码。登录只能通过命令行完成。

它会把我的数据发送到其他地方吗？ 不会。它只会与 NotebookLM 通信。你添加为来源的网址由 Google 获取，而不是由你的计算机获取。

它免费吗？ 是的。采用 Apache-2.0 许可证，没有付费版本。

更多解答：docs/faq.md。遇到问题？请查看 docs/troubleshooting.md。

限制与风险

• 非官方。 Google 可以随时更改 NotebookLM 的内部调用。在 sourcebolt 更新之前，工具可能会无法使用。
• 服务条款。 使用你的会话自动化 Google 网页应用可能违反 Google 的条款，并可能导致速率限制或账号处置。使用 sourcebolt 的风险由你自行承担；本项目不提供任何担保（请参阅许可证）。
• 适用 Google 的配额。 Google 会按账号设置笔记本、来源、聊天和 Studio 的限制。sourcebolt 会将这些限制报告为错误，不会绕过限制。
• 先安全地试用。 评估期间，请使用包含公开内容的测试笔记本。

文档

从 docs/index.md 开始。主要内容：

• 各应用的分步指南 · 让 AI 为你安装
• 入门指南 · 连接 AI 应用 · 故障排查 · 常见问题
• 工具参考 · 登录与存储 · 安全 · 隐私 · 性能
• 一键安装链接 · 注册表与目录
• 为什么选择 sourcebolt · 与其他 NotebookLM 服务的比较 · 更新日志

贡献

欢迎通过 GitHub Issues 提交错误报告和拉取请求。提交之前：

• 运行 sourcebolt --version 和 sourcebolt doctor，并附上输出。请先删除所有 Cookie 或令牌。
• 对于代码更改，请运行 go vet ./... 和 go test ./...。
• docs/tools.md 是生成的文件。请修改代码中的工具说明，然后运行 go run ./tools/gendocs > docs/tools.md。
• 请按照 docs/security.md 中的说明，私下报告安全问题。

许可证

Apache-2.0。请参阅 LICENSE 和 NOTICE。

致谢

sourcebolt 完全从头编写，未复制其他项目的源代码。NotebookLM 线格式的设计和相关知识参考了以下采用 MIT 或 Apache-2.0 许可证的项目，谨致谢意（请参阅 NOTICE 和 research/notes/）。对于没有许可证或采用著佐权许可证的项目，我们仅研究了其行为，未使用其中的任何内容。

项目	许可证	借鉴内容
teng-lin/notebooklm-py	MIT	RPC ID、负载布局、来源和聊天流程
tmc/nlm	MIT	Go 线协议建模和无损往返测试
jacob-bd/gemini-notebook-mcp-cli	MIT	MCP 工具接口、内部 API 参考
LocalKinAI/notebooklm-go	Apache-2.0	Go 客户端和身份验证流程思路