Spool

Spool

思簿 — 长期项目的上下文中枢。 标志：从上方俯视的线轴，线头正被拉出 — 观看它组装起来。

spoolapp.org · 下载 macOS 版 · 下载 Windows 版（v0.6.1）
_{网站通过交互式演示展示完整工作循环（English / 中文）——无需安装。
macOS：经过签名和 Apple 公证的 .dmg。Windows：x64 安装程序，目前尚未进行代码签名，仍为 v0.6.1，直到下一个版本发布。
免费、离线使用、无需账户。}

当你自然地产生一段信息时——AI 给出的好答案、埋在邮件中的决定、文档链接，或尚未成形的想法——Spool 都能让你轻松捕捉这段信息，将其归入两层 工作区 → 项目 结构，并按需将任意项目整理成可直接粘贴的简报——让你能立即重新进入项目，或向 AI 重新介绍项目情况。

为什么要做它

大模型不会记住你的项目。每次开启新对话，你都得重新解释背景。跨越多个 AI、多个标签页、多个邮件，历经多日，项目上下文会变得支离破碎——重新拼凑全靠记忆。

Spool 将“重新解释”压缩成“一次粘贴”。

核心循环

   Capture  ──▶  Project ──▶  Pack  ──▶  (paste, re-enter)
      ▲                                       │
      └───────────── days later ──────────────┘

• 捕捉 — 连按两次修饰键（macOS 上为 ⌥，Windows 上为 Ctrl），剪贴板中的内容就会写入当前项目。沿用你已有的 ⌘C / Ctrl+C 肌肉记忆。捕捉时无需做任何决定。确认浮层打开时，光标已经位于笔记框中——输入让你保存这段内容的想法并按 Enter，或点击任意位置跳过。你自己的笔记会比摘录保留得更久，而连接的 AI 会将其视为信号最强的一行。主窗口始终无需置于前台。
• 项目 — 由片段组成的只追加时间线。仅有两层：工作区（大主题）→ 项目（一项具体工作）。没有无限嵌套。打开时，信息流会显示最新区块——它们就是“你上次停下的位置”，无需手动维护状态笔记。
• 整理 — 单击即可将项目组装成可直接粘贴的 Markdown 简报。纯字符串组装，关键路径中不使用 AI，结果完全确定。

状态

v0.7.4 — 目前仅发布 macOS 版。Windows 仍为 v0.6.1，这是最后一个 附带 Windows 安装程序的版本；在 Windows 机器上完成检查后，下一个安装程序将基于当前版本构建。 更新内容：v0.7.4 · v0.7.3 · v0.7.2。

在 Windows 上，捕捉操作是连按两次 Ctrl，而不是 ⌥。未移植的是 macOS 特有的焦点处理和浏览器标签页标题捕捉功能，因此 Windows 捕捉记录的是源应用，而不是页面。Linux 尚未实现。

• 发行 — macOS：由 Developer ID 签名并经 Apple 公证的 .dmg，可直接从 Releases 获取。未上架 Mac App Store——沙盒机制与全局捕捉快捷键在结构上存在冲突。
• 发行 — Windows：v0.6.1，由 CI 构建的 x64 NSIS 安装程序，未经代码签名，因此 SmartScreen 会在安装前警告一次。
• 网站：spoolapp.org，提供英语和中文的交互式演示，展示捕捉 → 整理 → 重新介绍项目 → MCP。
• 尚无自动更新渠道：由于采用直接分发，新版本需要手动下载。

v0.5.0 新增内容

• Windows。 NSIS 安装程序；托盘图标在深色任务栏上也清晰可见；关闭窗口时会转到托盘，并在首次操作时告知用户；还提供与 macOS 相同的 MCP 接入方式。连续按两次 Ctrl 即可捕获内容，读取方式使用 Raw Input，而非键盘钩子——因此即使杀毒软件正在监视基于钩子的键盘记录程序，也能正常工作。两个平台默认都不会绑定组合键；如有需要，可在“设置”→“快捷键”中添加。
• 撤销功能涵盖你自己的写入。 你写入的内容块可以撤销；在空白编辑器中，⌘Z / Ctrl+Z 也表示“撤销我的上一个操作”，而不是毫无作用。
• 后续跟进是一列条目。 每行要么是常驻（无限期关注），要么是一次性（得到答复后关闭）。MCP 上的 AI 可以提议添加条目，也可以关闭已答复的条目；提议会留在审核界面等待处理，而常驻条目不能被关闭——没有这一区分，一次答复就可能悄无声息地关闭长期关注事项。
• 工作区可以嵌套；项目按字母顺序排序；左侧栏支持多选；整个工作区可以打包成真正的文件夹（包含 INDEX.md 和每个项目对应的一个 .md 文件，子工作区则作为子目录），供 AI 分块打开。内容不会为了符合预算而被摘要删减。
• 迁移到另一台设备。“设置”→“高级”→迁移到另一台设备可导出整个资料库，并将其导入其他设备。导入会合并内容，不会替换原有内容。
• 内容块溯源信息：来源 URL、获取日期、复核日期，并提前两个月、一个月和一周发送提醒。更正现在有了专用界面，且更正后的内容块会保留原始措辞。
• 捕获功能修复：输入内容会重新直接进入笔记框；浮层会根据屏幕的可用区域定位，因此菜单栏不再遮挡其顶部。

v0.4.0 新增内容

以下可选的外部 AI 路由不会向 Spool 添加任何密钥或账户：它们会调用你自行安装并登录的 CLI。（Spool 自身的 API 引擎于 v0.6.2 加入，是唯一会保存密钥的路由——请参阅API 引擎。）

• CLI 引擎槽位。 如果你已经安装并登录 Claude Code、Codex CLI 或 Gemini CLI，Spool 可以将其作为本地子进程运行，用来跟进你要求它关注的事项、撰写跨项目的每周回顾，或帮助起草值得跟进的内容。网络请求由该 CLI 使用你自己的账户配额发出——通过此路由，Spool 不会存储 API 密钥，其自身进程也不会发出 HTTP 请求。Gemini 不会运行跟进。
• 运行过程可见，记录如实呈现。 跟进会在右侧栏中运行；每周回顾有独立界面，这两项操作完成后都会留下记录。跟进目标草稿只会留在编辑器中，直到你保存或丢弃。CLI 提供中间进度时，界面会显示这些进度；任何会更改现有笔记的操作都不会被静默应用。
• 跟进。 你写下几行简单文字，说明要关注什么；引擎会严格按照这些内容搜索网络，并将找到的信息整理出来供你审核。如果没有新消息，它会保持静默——这是唯一会主动访问开放网络的操作，也是唯一启用了网络工具的操作。
• 淘汰与更正，而非覆盖。 你可以标记某个区块已不再有效，也可以指出旧区块中需要由新内容更正的那句话。已淘汰的区块会从信息包中移除，但仍保留在资料库中且可搜索；信息包会明确说明这些内容已被排除。仅追加日志绝不应静默覆盖事实。
• 注释注明撰写者。 AI 通过 MCP 写入的笔记会在信息包中显示为 ai note:，绝不会被误读为你自己的判断——这正是权威性标注的全部意义。
• AI 写入审核队列。 AI 将一段内容拆分到多个项目中，或提出更正时，结果会进入由你审批的队列，而不会直接进入时间线。
• 信息包只提供上下文。 三种“让 AI 做什么”的任务类型已移除——信息包现在只携带你的上下文和阅读说明；你可以在粘贴信息包的聊天中自行说明任务。

原始实施路线图的全部 12 个阶段已于 v0.3.0 完成：

阶段	功能
1	数据层（SQLite + 工作区 / 项目 / 区块 / 附件 + FTS5）
2	UI 骨架 + 项目视图
3	全局快捷键捕获
4	上下文打包器（核心功能）——纯函数，生成可直接粘贴的 Markdown
5	捕获强化：始终置顶的浮层窗口、双击 ⌥ 触发、可编辑的来源标记、自动检测浏览器标签页标题
6	区块工作台：文件 / 文件夹 / URL 附件、行内编辑、注释、智能截断、拖放添加附件
7	全文搜索：FTS5 trigram 分词器（适用于中文）+ 短查询 LIKE 回退、带上下文的三行摘要
8	截止日期、进行中 / 暂存 / 已完成状态、三区侧边栏（摘要 + 跨工作区重点 + 工作区树）、在工作区之间拖动、快捷键配置界面
9	项目完成 + 摘要视图（结论 · 置顶区块 · 文件和链接）
10	同一工作区内项目之间的 @ 提及引用
11	可选 AI 层 — 于 2026-07-09 移除：Spool 本身不内置任何 AI；协作通过下方的 MCP 服务完成
12	设置面板（快捷键、语言、MCP 连接、开机自启、清除数据）、统一的提示消息界面、长项目尾部窗口、打包

设计原则（不可妥协）

1. 捕获必须毫不费力——按一次键，不做任何选择。
2. 本地优先，默认私密——Spool 自身进程不会发起网络请求，而且其 CSP 从结构上禁止此类请求。内容只有通过你选择的移交流程才能到达其他程序：粘贴 Pack、启用 MCP 客户端、运行 CLI 操作，或开启 API 引擎。这些功能默认全都关闭，只有你主动启用才会开启；MCP 的写入功能还需要单独开启。开启 API 引擎时，请求由 Spool 启动的本地子进程（spool-ai）发出，使用你自己的密钥和配额——边界由进程决定，而非一句承诺。
3. 项目是日志，不是聊天——只追加、按时间排序、保持安静。
4. 检索是确定性的——打包和搜索绝不调用 AI 或网络。
5. AI 是图书管理员，不是作者——AI 通过 MCP 归档的任何内容都会注明归属、只追加，绝不会覆盖你手动撰写的内容。
6. 结构层级严格限定为两层——不支持无限嵌套。

完整的产品宪章、否决的想法和功能筛选标准见 PLAN_EN.md §2。

技术栈

• Tauri 2 桌面外壳，另有一个用于确认捕获的非激活式浮层窗口
• React 18 + TypeScript（严格模式），运行于 Vite（多页面构建）
• Tailwind CSS 用于布局；设计令牌定义在 CSS 变量中
• 使用 Zustand 管理状态
• 通过 tauri-plugin-sql 使用 SQLite，FTS5 搭配 trigram 分词器
• MCP 服务（spool --mcp，stdio，默认关闭）：AI 接口——28 个工具，其中 15 个用于读取（列出／搜索／去重／打包、压缩块的原文、块中的图片、关联文件夹的状态），另有 13 个需经同意并注明归属的写入工具。由 Spool 自行启动的 Follow Up 或 Weekly Review 运行可使用其中 26 个：除建议拆分项目和将关联文件夹标记为已同步之外的所有工具
• CLI 引擎槽位：claude、codex 或 gemini 作为本地子进程运行，用于 Follow Up、Weekly Review、后续目标草拟、压缩和过期检查——在磁盘上检测，不随应用打包，也不会获知任何密钥

从源代码构建

要求：Node 20+、Rust 工具链（stable）、Tauri 2 系统依赖项（请参阅对应操作系统的 Tauri 文档）。

npm install
npm run tauri dev     # dev with HMR
npm run tauri build   # production .dmg / installer
npm test              # vitest

在 macOS 上，双击 ⌥ 触发捕获需要 输入监控权限（系统设置 → 隐私与安全性）。Spool 会在启动时检查其状态，缺少权限时显示设置横幅；点击横幅中的捕获设置操作会触发 macOS 权限请求，授权后需重启 Spool 才会生效。辅助功能权限为可选，它有两项作用。第一，它让已被 Spool 捕获的双击操作独占生效：Spool 捕获时，会从事件流中删除第二次 ⌥ 按键，因此绑定了相同手势的其他应用（例如 Claude Desktop 的快速输入）也不会同时触发。第二，它使捕获提示框能够接收键盘输入，这样便可直接在笔记框中输入——macOS 只会将按键发送给当前活动应用，而 AXFrontmost 是唯一能立即激活应用、而非延迟激活的途径。没有辅助功能权限时，捕获仍然有效，但这些应用可能会同时触发，而且必须先点击笔记框才能输入。如果没有刚复制的内容，单纯双击不会被拦截，仍会原样传递给其他应用。用户绑定的捕获快捷键（设置 → 快捷键）无需这两项权限。首次从浏览器捕获时，macOS 会针对该浏览器提示一次 自动化权限——授予权限后，Spool 就能用当前标签页标题标记捕获内容，而不只是记录应用名称。

在 Windows 上无需授予任何权限。 双击 Ctrl 通过 Raw Input 读取，不需要权限，也不是键盘钩子。Windows 没有对应的标签页标题功能：捕获时会记录复制内容所来自的应用。

通过 MCP 使用 AI（可选，无需密钥或账号）

此方式不内置 AI——无需配置，也无需密钥：由你的客户端自带 AI。（Spool 确实有一种需要密钥的自有方式，但默认关闭，只有你主动启用后才会开启——请参阅API 引擎。）Spool 支持 Model Context Protocol：你自己的 AI 客户端（Claude Desktop、Codex——包括 ChatGPT 桌面应用中的 Codex 对话——Cursor，或其他支持 MCP 的工具）通过 stdio 连接到 spool --mcp，并直接处理你的项目。普通的 ChatGPT 对话在远程运行，无法访问本地 stdio 服务。

你无需使用这些功能，也能通过 AI 使用 Spool。 ⌘⇧P（Ctrl+Shift+P）会将项目打包成 Markdown，供你粘贴到浏览器标签页中——无需安装任何东西，也无需连接任何服务；即使跳过 MCP，你也不会失去任何功能。MCP 恰好多提供一项能力：AI 可以自行获取上下文，而不必等你粘贴内容；并且可以用自己的名称将结论写回来。

• 一键连接：设置 → MCP → 连接，会自动写入客户端配置（并创建备份）。重启客户端以加载设置；Spool 会另外显示该客户端是否已实际连接。
• 读取工具（14 个）：列出项目（附一行摘要和读取预算提示）、汇总各项目的近期动态、全文搜索、检测近似重复内容、分页读取内容块（包括已归档的内容块）、获取与 GUI 生成内容相同的确定性打包结果、只读的资料库健康检查、通过一次调用一轮问答了解“这个项目进展如何”、读取项目当前关注的事项、查看经过压缩的内容块的原始措辞、获取内容块中的图片（以图片形式传递），以及另外三个会返回简报和相应任务的工具——提炼一个项目、报告一个项目的健康状况、回顾所有项目这一周的进展。
• 写入工具（12 个，需另行单独授权）：创建项目、追加内容块（可注明其基于哪个内容块，或建议更正其中的某一点）、刷新项目的一行摘要、为内容块写入一句概述、为项目提出新的待跟进事项，以及关闭已答复的待跟进事项——持续有效的事项不能关闭。12 个工具中有 6 个在你于审核界面批准前不会进行任何更改：批量排入内容块、请求读取项目中已有的文件、提议附加你电脑上的文件、提议用新文件替换旧文件、提议用较新的内容块直接替换较旧的内容块，以及提议将项目拆分为子项目。每次 AI 写入都会带有强制来源标签（例如 Claude · MCP），并在 GUI 中显示独特徽标；AI 绝不能覆盖你手动撰写的摘要、归档你的任何内容块，也不能写出读起来像是你写的备注。
• AI 能否修改历史记录：AI 可以追加内容，也可以提议更正旧内容块中的某一点，或直接用较新的内容块替换旧内容块——由你批准或丢弃。将内容块标记为不再有效的权利只属于你。

连接后可以怎么说

你可以用日常语言与 AI 对话——无需工具名称或菜单，也无需粘贴任何内容来设置它。服务会在发给每个客户端的 initialize 指令中说明自身规则和你可能会用到的说法，因此刚连接的 AI 会先介绍它能用你的实际项目做什么。无论是否有人记得把这些信息交给它，这些内容都会发送过去。

使用你自己的 CLI 进行维护（v0.4.0，可选，无需密钥）

通过聊天客户端阅读内容只是其中一部分。另一部分是检查你离开期间发生了哪些变化——为此，Spool 可以调用你已有的编码 CLI。如果你的电脑上安装并登录了 claude（Claude Code）、codex（Codex CLI）或 gemini（Gemini CLI），Spool 就会检测到它，并提供以下操作：

操作	功能	是否访问网络
跟进	根据你写下的关注要点搜索新闻；发现内容会排入队列，供你审核	是
每周回顾	回顾所有项目，并将结果保存在专门的「每周回顾」屏幕中	否
起草跟进目标	为一个项目建议值得关注的要点；由你决定保留哪些	否
压缩	缩短项目资料包；保存任何内容前，你都可以检查改动	否
过时内容检查	查找被较新内容取代的旧区块——可检查单个项目，也可检查整个工作区；检查工作区时，还会指出看起来已经完成的项目——并由你决定如何处理每项内容	否

有三个有意设计的措施，让你可以放心地启用这些功能：

• Spool 自身的进程不会变成网络客户端。 它会将 CLI 作为本地子进程启动；请求从 CLI 发出，使用你自己的登录凭据和配额。通过此方式不会存储、输入或使用 API 密钥。
• 你可以查看运行位置。 「跟进」显示在右侧栏；「每周回顾」有专门的屏幕，这两种操作的已完成运行记录都会保留。目标草稿只会留在编辑器中，直到你保存或丢弃；如果所选 CLI 提供进度信息，界面就会显示进度。任何可能更改现有笔记的内容都会作为提案供你批准，而不会直接修改。
• 只有「跟进」会使用网络工具，且仅针对你写下的要点。「每周回顾」和目标起草不会使用网络搜索工具；压缩和过时内容检查不会获得任何工具，也不会连接到 Spool——只输入一段文本，再输出一段文本。不过，这些操作仍会将所需的项目内容交给 CLI，因此这些内容可能会发送给其服务提供商。

这些操作需要 MCP 服务和 AI 写入权限，并且至少要安装并登录一个受支持的 CLI，同时需要设置每次运行的时间限制。如果有多个可用的 CLI，你可以选择使用哪个。Spool 会在界面中如实说明 Codex 的一项限制，而不会加以隐瞒：它内置的 shell 工具无法像 Claude Code 的那样移除，因此 Spool 会在只读沙箱中运行它。Gemini 可以执行这里的所有操作，但「跟进」除外。

除非你启用相关开关，否则不会有任何操作按计划运行。 有两个默认关闭的开关：在项目的跟进编辑器中启用每周自动搜索一次；在「过时内容」标签页中启用每月检查整个工作区的过时内容。只有在 Spool 处于打开状态时，这些操作才会运行，并使用为该操作设置的路由（此 CLI 或下方的 API 引擎）；结果会出现在手动运行时所在的位置——跟进发现会进入审核队列，过时内容检查结果会显示在其标签页中。

API 引擎（可选，默认关闭）

上面两种方式借用的是别人的连接——你的 MCP 客户端，或你已登录的 CLI。API 引擎是唯一一种由 Spool 自己持有密钥的方式。只有在设置 → AI 引擎 → API 密钥中粘贴密钥后，它才会启用；没有密钥时，这里不会运行任何内容，也不会存储任何内容。它能完成 CLI 方式的所有操作；两者都已连接时，每个操作的按钮旁边都会有自己的 本地 CLI / API 开关。

操作	功能
每周回顾	与 CLI 方式相同的跨项目回顾，内容保存在「每周回顾」屏幕中
跟进	使用提供商自带的网页搜索——OpenAI、Claude、Gemini、Kimi 和 Qwen 都支持；使用 DeepSeek、Zhipu GLM、OpenRouter 或自定义端点时，跟进仍使用 CLI 方式
起草跟进目标	在不使用网页的情况下，为一个项目建议值得关注的事项
压缩	缩短某个项目的资料包，并在保存任何内容之前并排显示更改对比
过期检查	查找已被较新内容取代的旧内容块——可以检查单个项目，也可以检查整个工作区；检查整个工作区时，还会建议看起来已完成的项目——并询问你如何处理每一项

启用之前，有几点值得了解：

• 使用你自己的密钥，费用由你承担。 你可以粘贴来自 OpenAI、Anthropic（Claude）、Google（Gemini）、DeepSeek、Moonshot（Kimi）、Alibaba（Qwen）、Zhipu（GLM）或 OpenRouter 的密钥——Spool 会在能够判断时根据密钥识别提供商；无法判断时会询问你，因为 DeepSeek、Qwen 和 Kimi 的密钥看起来相似——也可以提供任意 HTTPS 端点。每次运行都会产生费用，包括中途取消的运行——提供商仍会对已生成的内容收费。

• 请求由子进程发出，而不是由 Spool 发出。 Spool 自身的进程中仍没有 HTTP 客户端，你可以自行检查，而不必只听我们说：

  cd src-tauri && cargo tree -e normal | grep -iE "ureq|rustls|reqwest|hyper|openssl"   # prints nothing
  

  网络调用由随附的小型二进制程序 spool-ai 发出。Spool 会启动它，通过 stdin/stdout 与它通信，并在运行结束时让它退出。它会拒绝普通的 http://，而密钥只通过 stdin 传给它——绝不会放在命令行中，因为机器上的任何进程都可能读取命令行。

• 密钥的存储位置。 macOS：系统 Keychain。Windows：Spool 自己的数据目录中的 0600 文件。密钥绝不会写入 settings.json，也绝不会出现在日志或错误消息中。

• 未经你同意，不会向你的资料库写入任何内容。 压缩会先显示检查屏幕；过期检查会针对每一对内容，或它认为已完成的每个项目，分别让你作出决定；跟进结果会留在审核队列中等待处理。某个内容块压缩前的措辞会保留在资料库中，随时都能查看。

键盘快捷键

Spool 会使用与你的平台实际显示一致的修饰键：macOS 上为 ⌘，Windows 上为 Ctrl。

macOS	Windows	操作
双击 ⌥	双击 Ctrl	捕获剪贴板，然后直接输入以记下一条备注（系统全局）
⌘⇧F	Ctrl+Shift+F	全局搜索
⌘⇧P	Ctrl+Shift+P	打包当前项目
⌘N	Ctrl+N	在当前工作区中新建项目
⌘,	Ctrl+,	设置
⌘Z	Ctrl+Z	撤销上一个操作（在空白编辑框中）
@	@	在编辑框中提及另一个项目
Enter / Shift+Enter	Enter / Shift+Enter	发送 / 换行
Esc	Esc	关闭任意覆盖层、模态框或行内编辑

全局搜索快捷键可在设置 → 快捷键中重新绑定；也可以在那里录制可选的捕获快捷键（默认未绑定）。

项目结构

src-tauri/            # Tauri / Rust: capture, overlay window, system integration
src/
  overlay/            # the capture overlay window (separate Vite entry)
  components/         # Sidebar, ThreadView, Capture, Pack, Search, Settings, ui
  lib/                # core logic (capture, pack, search, db, i18n)
  hooks/              # React hooks
  stores/             # Zustand stores
  styles/             # design tokens + global styles
scripts/              # one-off generators (e.g. the amber-S app icon)
PLAN_EN.md            # the project blueprint and source of truth

PLAN_EN.md 定义了 Spool 是什么、不是什​​么、分阶段路线图，以及明确列出的非目标。在打开 PR 或提出功能建议前，请阅读 §2（产品章程）。

截图

使用一个纯粹为演示而构建的库拍摄——其中的项目和笔记都是虚构的，因此不会出现任何个人信息。

一个项目，五个片段。 一份课程参考、一条用作下一块标题的笔记、一段 AI 聊天解释、你的复习计划，以及一条由 AI 归档的结论——每条都保留了编号、时间、来源和作者。固定的项目栏位于左侧；AI 活动栏位于右侧。

捕获确认框将已保存的文本、其「学习 / 机器学习课程」目标位置、检测到的来源、活动笔记框以及撤销 / 重做功能集中在一个紧凑的浮层中。主窗口始终无需置于前台。

打包会将这五个块转换为可直接粘贴的 Markdown：范围控制始终可见，权威来源说明会解释如何阅读各个来源，AI 编写的内容也会保留标记。

已完成的项目，浓缩为你选定的结论，并提供一键重新打开的途径。

项目管理保持为列表，而不是另一棵树。 活跃工作按截止日期或创建日期排序，工作区和块数一目了然，已完成的工作则保留其结论。

通过 MCP，你自己的 AI 可以直接读取资料库——这次只读的 Codex CLI 运行查询了隔离的演示服务，并报告当前总数，无需打包或粘贴内容。

而当它归档内容时，会署上自己的名字。 块 5 会追加在用户的块 4 下方——绝不会覆盖它——并标记为 Claude · MCP，同时用 ↩ 行指向它所回应的确切片段。

许可证

尚未授权——在选定许可证之前，保留所有权利。

作者

Hanze Jin · @KIM-ocean-HZ