Surf 是什么？
Surf 是一款用于将文件、PDF 和网页整合到一个本地资料库中，并从该资料库生成 AI 撰写笔记的桌面应用。 其 GitHub 项目介绍 将其描述为"个人 AI 笔记本。整理文件与网页，并从中生成笔记。开源、本地与开放数据、开放模型选择（包括本地模型）"。根据其 GitHub 主题标签和 README 致谢信息，该应用主要使用 Svelte、TypeScript 和 Rust 构建，并以基于 Electron 的桌面应用形式发布。
- 核心功能：一个名为"Notebooks"的本地资料库，保存文件、PDF 和已保存的网页，并配有一个可引用资料库中任何内容的 AI 笔记撰写层
- 存储方式：一个名为 SFFS（Surf Flat File System）的本地开放格式存储引擎——根据 Deta 的文档说明，数据以透明、非专有格式保存在你自己的设备上
- 模型层：不内置本地推理引擎——Surf 连接的是你自行配置的模型，可以是通过自己 API 密钥使用的云端提供商，也可以是任何 OpenAI 兼容端点，包括本地运行的服务器
- 开发者：Deta，此前以 Deta Space 和 Deta Drive 闻名的同一团队；GitHub 上列出的组织名称为"deta"
- 规范仓库：github.com/deta/surf——Surf 开源代码、发布版本和问题跟踪的当前活跃维护主页
Surf 的项目历史与版本里程碑
Surf 的 GitHub 仓库创建于 2025 年 10 月 20 日。两天后发布了首个标记版本，此后项目持续发布了多个小版本更新——尽管该应用已成为 Deta 的主要公开发布渠道，但所有版本目前仍带有 -beta.0 后缀标记。
- 11.1.0-beta.0 — 2025年10月22日：首个标记版本发布
Why it matters: 这是开源仓库上最早的版本标记，距仓库本身创建仅两天。 - 21.3.0-beta.0 — 2025年11月5日：笔记本编辑器与意图分类修复
Why it matters: 根据官方发布说明，此版本增加了在创建时查看和取消笔记本编辑器的功能，并修复了 Surf 误判用户请求意图的问题。 - 31.4.0-beta.0 — 2025年11月20日：重新设计的笔记本内容视图
Why it matters: 根据官方更新日志，此版本为笔记本内的资源添加了搜索和延迟加载功能，是对大型资料库加载方式的一次性能导向的重构。 - 41.4.7-beta.0 — 2026年4月29日：最新的标记版本
Why it matters: 截至本评测撰写时，这是[官方 GitHub Releases 页面](https://github.com/deta/surf/releases)上能找到的最新版本标记——由于仓库在标记版本之间仍持续收到提交，请直接查看该页面以获取本评测发布日期之后的任何更新。
用 Surf 能做什么？
Surf 的功能集中在把文件、PDF 和网页内容汇入一个本地资料库，然后利用 AI 撰写笔记、回答问题，并从这个资料库中构建小型工具。以下是根据 Surf 官方 GitHub README 和文档整理的各功能实际作用。
- 多媒体资料库（"Notebooks"）——将本地文件、PDF、网页、YouTube 视频和社交媒体帖子保存到一个私密的本地资料库中，按 Notebook 分类整理，其中大部分内容保存后即可离线使用
- 智能笔记（Smart Notes）——撰写可以
@提及任何已保存资源或已打开标签页的笔记，可在笔记内触发网络搜索，并获得能深度链接回原始来源、特定网页片段或视频时间戳的引用 - Surflets（应用生成）——无需编写代码，即可在笔记内生成用于可视化或探索数据的小型交互式应用
- 标签页、分屏视图和侧边栏——在标签页中打开本地笔记、文件或网页，并排查看多个资源，并通过常驻侧边栏在各个 Notebook 之间导航
- 模型选择——可为 OpenAI 或 Anthropic 自带 API 密钥，也可添加任意 OpenAI 兼容模型端点作为自定义模型，本地运行的服务器（Ollama 及同类工具）正是通过这种方式接入的
- 开放的本地数据——SFFS 存储引擎以开放格式将你的资料库保存在本地设备上，根据 Deta 的文档说明，资料库的大部分内容即使离线也可访问
使用示例：三种使用 Surf 的方式
以下是基于上文所述 Surf 已有功能构建的具体工作流程，而非假设性的使用场景。
在同一篇笔记中，就一份 PDF 和一段 YouTube 视频提问
把一份 PDF 和一段相关的 YouTube 视频保存到同一个 Notebook 中，然后新建一篇智能笔记并 @提及 这两者。提出一个横跨两者的问题——Surf 会提取相关片段，并注明所引用的 PDF 页码和视频时间戳，而无需你手动逐一查阅每个来源。
连接本地模型，实现完全在设备端生成笔记
用 Ollama 等工具在本地运行一个模型，然后在 Surf 的设置中添加一个自定义模型，指向该服务器的 OpenAI 兼容端点（通常为 http://localhost:11434/v1）。连接完成后，Surf 的笔记生成和聊天功能就会调用你的本地模型，而不是云端 API。
从笔记中快速生成一个交互式工具
在针对某个数据集或一组已保存文章撰写智能笔记时，使用应用生成工具并描述你想要的内容（例如"一个比较这三个数字的小图表"）。Surf 会生成一个 Surflet——一个小型交互式应用——全程无需你编写任何代码。
下载适用于 macOS、Windows 和 Linux 的 Surf
Surf 支持 macOS（Apple Silicon 和 Intel）、Windows 和 Linux，可直接从 GitHub Releases 下载。以下链接指向 GitHub 上的最新版本重定向地址，参考官方安装指南——请始终在 Releases 页面核实具体文件名，因为它会随版本号变化。
平台 | 下载 |
|---|---|
| macOS（Apple Silicon） | Surf-x.y.z.arm64.dmg |
| macOS（Intel） | Surf-x.y.z.x64.dmg |
| Windows（x64） | Surf-x.y.z-setup.exe |
| Linux（x64 AppImage） | Surf-x.y.z.x86_64.AppImage |
Surf 的开源构建版本目前未经代码签名，因此 macOS 会提示"无法打开 Surf，因为 Apple 无法检查其是否包含恶意软件"（右键点击该应用并选择"打开"一次即可绕过），Windows Defender 也可能显示"Windows 已保护你的电脑"提示（选择"更多信息"，然后选择"仍要运行"）。这两种警告均已在官方安装指南中说明，对于未签名的开源版本来说是预期内的情况，并不代表下载文件被篡改——请始终直接从官方 GitHub Releases 页面下载。
Surf 的价格：真的免费吗？
是的——开源版本的 Surf 没有付费层级。 应用代码采用 Apache License 2.0 许可证，有两个明确记录的例外：针对 @ghostery/adblocker-electron 软件包的补丁采用 Mozilla Public License 2.0 许可证，以与该软件包自身的上游许可证保持一致；另有少数文件可能带有各自的许可证头，覆盖默认许可证。根据 README 的许可证部分说明，Deta 的名称和标志明确不在 Apache 2.0 授权范围内。
- 开源应用本身不设订阅费、付费层级，也不施加任何使用限制
- 安装和运行该应用无需账户或注册
- 通过 Surf 使用云端模型（OpenAI、Anthropic）仍需支付该提供商收取的 API 使用费用——Surf 不额外加价
- 通过自定义端点（例如 Ollama）运行本地模型没有单次调用成本，只需承担自己的硬件和电费开支
本地模型支持："混合"模式究竟意味着什么
Surf 的本地模型支持是真实存在的，但其运作方式与 Jan 或 GPT4All 这类内置自有推理引擎的应用不同。 Surf 完全不内置任何引擎——无论是本地模型还是云端模型，接入方式都相同：都是你在"偏好设置 → AI"中配置的一个 OpenAI 兼容端点。
内置本地引擎
- Surf 的实际做法:
- 无——Surf 不在进程内运行推理
云端模型
- Surf 的实际做法:
- 在"偏好设置 → AI"中配置，自带 OpenAI 或 Anthropic API 密钥
本地模型
- Surf 的实际做法:
- 添加一个指向任意 OpenAI 兼容端点的自定义模型，例如位于
http://localhost:11434/v1的本地 Ollama 服务器
数据存储
- Surf 的实际做法:
- 无论连接哪种模型，始终保存在本地——你的资料库（SFFS）都保留在你自己的设备上
这一区别对专门为离线使用而选择 Surf 的用户很重要：单独安装 Surf 并不会自动提供一个可用的本地模型。你需要另外安装并运行一个本地模型服务器（Ollama 是最常见的选择），然后让 Surf 指向它。一旦连接完成，你发给该模型的笔记和聊天请求就不会离开你的设备——但这一设置步骤需要你自己完成，并非自动进行。
谁适合使用 Surf？
Surf 是否适合你，取决于"在文件、PDF 和网页之上建立一个统一本地资料库，并叠加 AI 笔记功能"是否正是你想要的工作方式，以及你是否愿意自行连接模型。
适合使用 Surf 的情况
- 你经常需要同时研究 PDF、网页和视频等多种资料，并希望 AI 笔记能附带准确引用原始来源
- 你希望笔记和文件以开放格式存储在本地，而不是被锁定在专有云端格式中
- 你愿意为云端模型自带 API 密钥，或者已经在运行 Ollama 等 Surf 可以连接的本地模型服务器
- 你希望无需编写代码，就能直接从笔记生成小型交互式工具（Surflets）
- 你希望底层应用是开源、可自托管的，而不是一个闭源二进制文件
建议观望或另作选择的情况
- 你想要一款从首次启动起就内置模型、可完全离线使用的应用——Surf 需要你另行设置本地或云端模型连接
- 你不太能接受首次启动时出现未签名二进制文件的安全警告——请在继续之前确认自己信任下载来源
- 你只需要一个简单的书签或笔记工具，不需要 AI 功能——Surf 的核心价值在于 AI 笔记层，如果这不是你所需要的，反而会增加不必要的复杂度
- 你需要有服务等级协议（SLA）保障的官方厂商支持——Surf 的支持渠道是 GitHub Issues 和 Discord，属于典型的开源项目模式，而非商业厂商支持
Surf 与其他自托管笔记及知识管理应用对比
Surf 是众多将个人知识管理与 AI 结合、把数据存储在本地并允许你自行选择模型的自托管工具之一。以下是它与该领域其他选项的对比情况——完整目录请参见本地 LLM 软件目录。
- Karakeep——一款带有 AI 自动标签功能的自托管书签管理工具；其功能范围比 Surf 更窄（专注于书签，而非通用的文件/PDF/网页资料库），但如果书签整理是你的主要需求，它是很好的选择。参见 Karakeep 评测。
- Blinko——一款带有 RAG 搜索功能的自托管 AI 笔记应用，可对你自己的笔记进行检索；其"基于自有内容的 AI"理念更接近 Surf，但构建围绕的是笔记而非文件/PDF/网页混合资料库。参见 Blinko 评测。
- Khoj——一款自托管的"第二大脑"应用，可对你的文档、笔记以及（可选的）在线内容建立索引，用于 AI 搜索和对话；其覆盖的来源类型广度与 Surf 相当，但采用不同的 UI 模式（以对话为先，而非以笔记本为先）。参见 Khoj 评测。
评估 Surf 时的常见误区
关于 Surf 的大多数困惑，都源于它的名称、它与 Deta 早期产品的关系，或是误以为它像某些竞品一样内置了本地模型。
误区一：把这个 Surf 与 steel-dev/surf.new 混淆
"Surf"是一个常见的项目名称。本评测涵盖的是 github.com/deta/surf，即 Deta 团队开发的个人 AI 笔记本应用。它与 steel-dev/surf.new 是不同的项目，后者是一个无关的浏览器自动化演示项目，不涉及本地模型——下载前请务必核实 GitHub 组织名称（deta）。
误区二：以为 Surf 开箱即用地运行本地模型
Surf 不内置推理引擎。所谓的本地模型支持，是指将一个单独运行的 OpenAI 兼容服务器（最常见的是 Ollama）作为自定义模型连接进来——这并非安装后自动完成的。
误区三：以为开源应用与早期的"托管版 Surf"完全相同
Deta 此前运营过一个闭源、经过代码签名的"托管版 Surf"，内置 AI、自动更新和扩展功能。目前 github.com/deta/surf 上的开源版本是一个独立、持续开发的代码库；根据安装指南，数据可以迁移过来，但两者并非同一个构建版本。
误区四：把未签名二进制文件的安全警告当作恶意软件的迹象
开源构建版本未经代码签名，因此 macOS Gatekeeper 和 Windows Defender 都会在首次启动时显示标准警告。这是本版本已记录且预期内的行为，而非下载文件被篡改的证据——请始终只从官方 GitHub Releases 页面下载。
常见问题
Surf 是什么？
Surf（deta.surf，源代码见 github.com/deta/surf）是 Deta 推出的一款免费开源桌面应用，可将你的文件、PDF 和网页整合到本地资料库中，并从中生成 AI 撰写的笔记。
Surf 免费吗？
是的，开源版本免费。它采用 Apache License 2.0 许可证（另含一个采用 MPL-2.0 许可证的小型广告拦截补丁，以及少数带有各自许可证头的文件），没有付费层级。通过自己的 API 密钥连接云端模型仍需支付该提供商收取的费用——Surf 本身不额外收费。
Surf 是否在本地运行 AI 模型？
Surf 可以使用本地运行的模型，但它并不内置自己的推理引擎。你需要在"偏好设置 → AI"中添加一个自定义的、OpenAI 兼容的端点（例如本地的 Ollama 服务器）来连接本地模型——这一设置步骤需要你自己完成，并非自动进行。
Surf 使用什么许可证？
核心代码库采用 Apache License 2.0 许可证，详见 GitHub LICENSE 文件。README 中记录了两个例外：内置广告拦截软件包的补丁采用 Mozilla Public License 2.0 许可证，部分文件可能带有各自的许可证头。Deta 的名称和标志明确不在 Apache 2.0 授权范围内。
Surf 支持哪些平台？
macOS（Apple Silicon 和 Intel 构建版本）、Windows，以及 Linux（x64 AppImage），均可直接从 GitHub Releases 下载。
这是否和 steel-dev/surf.new 是同一个 Surf？
不是。本评测涵盖的是 github.com/deta/surf，即 Deta 团队开发的个人 AI 笔记本。steel-dev/surf.new 是一个独立、无关的浏览器自动化项目，只是恰好同名——下载前请核实 GitHub 组织名称。
为什么打开 Surf 时电脑会显示安全警告？
开源构建版本目前未经代码签名，因此 macOS 和 Windows 在首次启动时都会显示标准的未签名应用警告。根据 Surf 官方安装指南，这是预期内的行为，并不代表下载文件被篡改。
Surf 与早期的"托管版 Surf"产品有何不同？
Deta 此前发布过一个闭源、经过代码签名的"托管版 Surf"，内置 AI、自动更新和浏览器扩展功能。目前的 github.com/deta/surf 版本是其开源继任者；根据安装指南，如果你迁移，数据会保留下来，但这是一个不同的代码库和构建版本。
谁开发了 Surf？
Surf 由 Deta 开发。GitHub 上列出的托管组织为"deta"，即此前以 Deta Space 和 Deta Drive 等产品闻名的同一团队。
Surf 何时首次发布？
Surf 的 GitHub 仓库创建于 2025 年 10 月 20 日，首个标记版本（1.1.0-beta.0）于 2025 年 10 月 22 日发布。本评测能核实到的最新标记版本是 1.4.7-beta.0（2026 年 4 月 29 日）——如需了解此后发布的任何更新，请查看官方 Releases 页面。