Deta Surf：本地优先的 AI 笔记本

项目简介

Deta Surf 是一个 AI 笔记本，把电脑里的文件和网页直接拉进你的思考流里。它面向需要同时做研究和思考的人，减少手动搜索、开窗口切标签、滚动、复制粘贴到文档编辑器里的琐碎工作。

Surf 主要用 Svelte、TypeScript 和 Rust 编写，运行在 macOS、Windows 与 Linux 上，数据以开放格式保存在本地，并且完全开源。

主要功能

多媒体库与 Notebook

把几乎所有媒体存进电脑上的私有库，格式开放透明，并按 Notebook 组织：

• 支持本地文件、网页站点与链接（YouTube、推文等），也可以直接在 Surf 里新建媒体
• 大量内容可离线打开使用
• 整个库可以作为 Surf 的 AI 功能的数据来源

这个库建立在一个名为 SFFS（Surf Flat File System）的本地存储引擎上。

智能笔记（Smart Notes）

不必开一堆窗口、反复点击滚动、把内容复制粘贴进文档或聊天框，就能跨资料探索和思考：

• 用 @ 提及任意标签页、网站或库中资源，并自动生成内容
• 触发网页搜索做调研，把结果带回笔记中
• 内置引用，深度链接回原始出处，可以是网页的某一节、视频的某个时间点或 PDF 的某一页
• 用 Surflets 不写代码生成交互式应用
• 粘贴图片、表格或来自其他应用的数据，Surf 能理解并纳入笔记
• 支持富文本格式、代码块、待办列表等

标签页、分屏与侧边栏

Surf 围绕标签页、分屏视图和侧边栏构建：本地笔记、文件或网页都能开在标签页里；分屏可以并排查看和操作多个资源；侧边栏用于快速访问 Notebook 和笔记。

Surflets（应用生成）

Surf 可以编写交互式小程序，帮助你借助代码来可视化、理解或探索概念与数据。

AI 模型选择

笔记和 Surflets 由你自己选择的大语言模型驱动：

• 为常用模型自带 API Key
• 添加云端模型
• 使用本地语言模型

安装与使用

详细的安装说明见仓库中的 INSTALL.md；如果需要从源码构建或在本地开发，见 CONTRIBUTING.md。也可以访问官网 https://deta.surf 了解。

上手可以试试这几件事：

• YouTube 笔记：打开一个 YouTube 视频并向它提问
• PDF 笔记：打开一份 PDF 并向它提问
• 创建 applet：使用「app generation」工具，让它生成一个应用
• 会搜索网页的笔记：使用「web search」工具，在提问中包含「search」

常用快捷键见 SHORTCUTS.md。

注意事项

• 项目采用 Apache 2.0 许可证，但存在例外：针对 @ghostery/adblocker-electron 包的补丁采用 MPL-2.0，与上游项目保持一致；部分文件可能带有覆盖默认许可的独立许可证头。Deta 名称与 logo 不在 Apache 2.0 许可范围内。
• 安全问题的报告方式见 https://github.com/deta/surf/security/policy。

---

本作品整理自 GitHub 开源项目 deta/surf，原作者 @deta，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。