KechuAI

Deta Surf 开源：把网页、YouTube 与 PDF 放进本地 AI 笔记本

开源
AI笔记
本地优先
Electron
BYOK
2026/10/22
·

阅读时间: 大约 9 分钟

Deta Surf 开源：把网页、YouTube 与 PDF 放进本地 AI 笔记本

Smart Note 示例：通过 @-mention 引入素材后直接生成回答（官方 README 截图）

Deta Surf 是柏林团队 Deta 推出的”智能笔记本”：在一个界面里收藏网页、YouTube 视频、PDF 与本地文件，直接对这些素材提问、生成笔记，目标是减少”开窗口、切标签、滚动、复制粘贴”的上下文切换。产品 2024 年底以闭包 Beta 亮相，仓库 deta/surf 于 2025 年 10 月开源（Apache-2.0，Deta 名称与 Logo 不在协议内）。本文基于开源仓库、docs 与官网 FAQ 做梳理。

一、定位：笔记本，而不是”AI 浏览器”

官网 FAQ 明确把自己和市面上的”AI Browser”区分开：浏览器是消费工具，AI 浏览器常在消费意图上加自动化点击与聊天框；Surf 以个人笔记本为原型，把网页当作思考过程中的材料，AI 只是手段而非目的。技术上它是 Electron 应用（内嵌 Chromium），源码主要用 Svelte、TypeScript 与 Rust 编写，支持 macOS（Apple Silicon/Intel）、Windows x64 与 Linux AppImage。

GitHub 访问当日约 3.6k stars、253 forks、33 个开放 Issue，最新发布为 1.4.7-beta.0（2026-04-29），整体仍处 Beta。

二、本地优先的媒体库：SFFS 与嵌入

Surf 的底座是一个住在本机的多媒体库，由 Rust 编写的 SFFS（Surf Flat File System） 以开放透明格式存储。每加入一项素材，Surf 会创建本地文件、数据库记录，以及（有文本表示时的）一条向量嵌入。支持的素材类型：

  • 文件：PDF（全文嵌入）、图片（自动 OCR）；
  • 网页：YouTube 视频、Tweets、Reddit 帖子、文章/博客、Notion 文档、Google Docs、Slack 消息；
  • 自建：在 Surf 内直接写笔记或生成内容。

素材可组织进 Notebooks，带文本表示的内容支持离线查看。官方强调：数据全部落在本机，用户可以直接打开 Surf 数据目录自行搬运或删除；只有使用托管模型的智能功能时，“在上下文中”的页面才会离开设备，接本地模型则全程不出机。

三、Smart Notes：@-mention、引用与联网搜索

Smart Notes 把富文本编辑器和 AI 写作合在一起，上下文来源可以是单个标签页、单份素材、整个 Notebook 或网页：

  • @-mention：输入 @ 搜索库里的标签页、笔记、PDF、Notebook 并引入上下文；
  • Web search 工具：提问里带 “search” 可触发联网检索，结果回到笔记；
  • 引用（Citations）：生成内容附带深链引用——网页跳到具体章节、YouTube 跳到时间戳、PDF 跳到对应页，点击引用可回到出处；
  • 编辑器支持 / 菜单插入标题、列表、代码块，可粘贴外部图片/表格/数据让模型理解。

四、Surflets：不写代码生成可交互小应用

Surflet 示例：一句话生成柏林气温曲线图，App/Code 可切换（官方 README 截图）

Surflet 是笔记里的小应用：折线图、可交互物理演示、小游戏等，用自然语言生成。它能在本地持久化状态（待办清单、游戏最高分），并且以 HTML 文件形式存在本机，可以用任意文本编辑器直接改。这是它与普通”AI 生成一张图”的区别：产物是可运行、可改源码的小程序。

五、模型策略：BYOK、自定义端点与本地模型

自定义模型配置：OpenAI 兼容端点、Model ID、上下文长度（官方 README 截图）

Surf 不绑定单一厂商：内置 OpenAI、Anthropic 的 BYOK 配置；也可添加任意 OpenAI 兼容 chat completions 端点，文档给出的常见接法包括本地 Ollama（http://localhost:11434/v1/chat/completions）、OpenRouter、Hugging Face（经 Together 等 Inference Provider）。每个模型可配置 Provider URL、Model ID、API Key、上下文长度，并标注是否支持视觉（Vision）与 JSON 输出；界面可在多次查询间随时切换模型。

六、安全与开源版口径

  • 隔离沙箱：FAQ 称网页中的不可信内容运行在隔离沙箱中；
  • 开源版无签名、无自动更新：INSTALL 文档明确开源 release 未做代码签名，macOS 需右键打开/安全设置放行，Windows Defender 会提示”仍要运行”；
  • AI 能力要自备 key 或本地模型：闭包托管版曾内置 AI、代码签名与自动更新，开源版移除了这些；从托管版迁移不丢本地数据，但 AI 需重新配置；
  • Beta 是一次重建：Alpha 时期的实验功能（多桌面、Vision、live contexts、“go wild”模式等）当前缺失，官方称 Vision 等热门功能在 roadmap 上、会逐步回归；
  • 无公开检索准确率基准：官方没有给出嵌入检索命中率、问答正确率或延迟对比，素材问答质量依赖用户自选模型与嵌入配置。

七、优势与局限

优势：

  1. 本地优先 + 开放格式：文件、数据库、嵌入都在本机，可导出可搬迁，不被云库锁定；
  2. 素材覆盖面广：YouTube 时间戳、PDF 页码、网页章节级引用，比纯剪贴板式笔记更可溯源；
  3. 模型开放：BYOK + OpenAI 兼容端点 + 本地 Ollama，避免厂商绑定；
  4. Surflets 产物为本地 HTML，可二次编辑，不是一次性展示。

局限：

  1. Beta 重建期功能缺口明显，Alpha 演示里的能力部分暂不可用；
  2. 开源版无签名/无自动更新，普通用户安装会遇到系统安全警告；
  3. 无量化评测，问答与检索质量没有官方基准背书；
  4. Electron 体积与内存开销官方在 FAQ 中承认存在，只是论证对”需要浏览能力”的应用必要；
  5. 内置托管 AI 体验已被剥离，开箱即用程度低于闭包 Beta 宣传。

八、适合谁

  • 习惯本地积累素材、希望对 YouTube/PDF/网页统一提问并保留出处链接的研究者；
  • 想跑本地模型、要求资料不出本机的隐私敏感用户；
  • 需要在笔记里直接生成可交互图表/小工具并能改 HTML 的人。

追求开箱即用、托管同步与官方内置模型的用户，宜等待其正式版或比较 NotebookLM、Obsidian 插件生态。

参考来源