edgeever

EdgeEver 是一个现代化的开源笔记与知识库工作区，它重现了备受喜爱的 Evernote 风格三栏布局，同时提供开放的数据架构和无缝的 AI Agent 集成，实现完全自主掌控与智能生产力。 ## 为什么选择 EdgeEver 许多长期使用 Evernote 的用户只是想要一个可靠、开放且快速的个人知识库。现有的主流方案都存在取舍： - **Evernote**：充斥商业广告，数据导出繁琐，免费版受限，AI/MCP 功能昂贵。 - **Obsidian**：核心闭源，官方同步收费，对于轻量记录而言过于笨重。 - **Memos 与 Stream Notes**：社交时间线布局与结构化生产力不同。 - **SiYuan 与基于块的双链笔记**：细粒度的块级架构增加了认知负担，且缺乏真正的零成本无服务器方案。 **EdgeEver 填补了这一空白**：整个技术栈开源，包括同步与自托管。它保留三栏布局，在 10,000+ 笔记下依然丝滑流畅，并内置原生 AI Agent，支持零成本部署。 ## 功能特性 - **按你的方式部署**：可运行在 Cloudflare 的免费无服务器平台上，也可通过 Docker 部署在 VPS、NAS 或家庭服务器上。个人部署在 Cloudflare 上大约可容纳 150,000 条短笔记和 50,000 张图片；Docker 可按需扩展。 - **开放数据，无供应商锁定**：基于标准 SQLite 构建，提供完整的 REST API、MCP 和 CLI 访问。 - **无损 ZIP 备份与可移植性**：将完整资料库导出为干净的归档文件，包含 Markdown、Front Matter、嵌套文件夹、相对附件链接和版本历史。 - **原生 AI Agent 协同**：与 Model Context Protocol (MCP) 深度集成，允许 Claude Code、Codex、Antigravity 和 WorkBuddy 等 AI Agent 读取、整理和总结笔记，或与 Notion 和飞书多维表格同步。 - **自带 AI 模型**：连接 OpenAI、Anthropic 或 Gemini 兼容服务，实现智能摘要、要点提取、校对、翻译和文本续写。 - **丰富的插件 API**：通过 Plugin API 扩展 EdgeEver。 - **无限多设备同步**：没有商业设备数量限制或付费墙。可通过 Web、PWA 或浏览器在 PC、平板和手机之间同步。 - **经典三栏布局与专注模式**：笔记本树、笔记列表和宽敞的编辑器，并配有桌面专注模式。 - **轻量、持久的桌面性能**：切换笔记时不会将旧图片和文档保留在内存中。 - **无限嵌套笔记本**：以任意文件夹深度组织知识。 - **一键富文本复制，适用于新闻通讯与博客**：将笔记转换为带内联 CSS 的格式化富文本，适用于 Substack、Medium、WordPress 或新闻通讯编辑器。 - **无缝双视图编辑器**：在桌面端可在富文本编辑和 Markdown 源代码之间切换。 - **便捷的单笔记导出**：可导出为 Markdown、HTML 或 PDF。 - **原生 Mermaid 图表渲染**：直接在笔记中渲染流程图、时序图和思维导图。 - **可视化图表笔记**：直接在笔记中绘制思维导图、流程图和架构图，支持智能自动布局和矢量导出。 - **修订历史**：查看并恢复笔记的先前版本。 - **公开笔记分享**：公开分享笔记，并可选择自动生成访问密码。 - **移动端微信公众号文章剪藏**：从微信公众号文章中提取内容。 - **智能本地图片压缩**：客户端 WebP 压缩可将文件大小减少 50%-90%。 - **通用文件附件**：附加并预览 PDF、Office 文档、zip 文件、音频和视频；分块上传支持最大 1 GiB 的文件。 - **批量操作与灵活排序**：合并或移动多条笔记，并通过拖放重新排列笔记本。 - **离线草稿与队列**：离线起草和编辑；重新连接后更改会同步。 - **暴力破解登录防护**：服务端基于账户和 IP 的失败登录限流。 - **多租户账户隔离**：在单个实例上托管多个用户账户，空间严格隔离。 - **随处可用**：支持 Web、Android、macOS、Windows、Linux 和 iOS；Web Clipper 支持 Chrome、Edge 和 Firefox。 ## 部署 ### 方案 A：使用 AI Agent 部署（推荐） 将提示词复制到 AI Agent（如 Codex、Claude、Cursor、WorkBuddy、Antigravity 等）中，即可完全通过 GitHub 和 Cloudflare 部署 EdgeEver。Agent 会复刻仓库、创建 D1 和 R2 资源、创建 Worker、设置管理员密码并启用自动更新。 ### 方案 B：手动在线部署 通过 6 个网页步骤完成设置：复刻仓库、创建 Cloudflare 资源、导入并配置项目、选择管理员密码、构建并验证，以及启用自动更新。 ### 方案 C：在 VPS 或 NAS 上使用 Docker 使用 GitHub 托管的安装脚本： ```sh curl -fsSL https://edgeever.org/install.sh | bash ``` 该命令会拉取最新镜像、生成管理员密码、使用 Docker Compose 启动 EdgeEver，并安排每日自动更新。 ## 多账户登录 单个实例支持多账户登录。实例管理员可以创建、禁用或重置成员账户。每个成员都会获得完全隔离的个人工作区。 ## 浏览器 Web Clipper Web Clipper 已正式发布，适用于 Chrome、Microsoft Edge 和 Firefox。 ## 社区与反馈 - Bug、功能请求和部署问题：GitHub Issues - 代码贡献：阅读 Contribution Guide - 加入 EdgeEver Telegram 群组，讨论 AI Agent 应用和自动化工作流。 ## 插件与主题 Web 和桌面应用支持功能插件和自定义主题，可从官方市场、GitHub 或 Manifest URL 安装。开发者可以使用 `@edgeever/plugin-api` 扩展能力。 ## 技术栈 - Bun workspace monorepo，包含 Web、API、官方网站和共享类型包。 - 前端：Vite、React、React Router、TanStack Query、Tailwind CSS、shadcn/ui 和 Radix UI。 - 编辑器：TipTap / ProseMirror，支持 Markdown；PWA 使用 vite-plugin-pwa、Workbox 和 Dexie。 - Android 应用：Expo + React Native，使用 SQLite 本地存储和增量同步。 - iOS 应用：原生 SwiftUI（iOS 17+），打包 TipTap EditorBundle，使用 GRDB 本地镜像/发件箱。 - 原生桌面应用：Electron + Rust sidecar，用于高性能本地数据服务。 - Web clipper：Manifest V3、Mozilla Readability 和 Turndown。 - 后端：Hono/Zod 业务应用，提供 REST API 和 Remote MCP；Cloudflare 使用 Workers/D1/R2，而 Docker 使用 Bun/SQLite/本地文件或 S3。 - 官方网站：Astro 静态站点，可部署到 Cloudflare Pages。 ## 快速开始 ```sh bun install bun run dev ``` 本地开发会自动登录；全新数据库使用 `owner` / `edgeever-local-dev`。 ## 内容格式 EdgeEver 以三种形式存储笔记内容：`content_json`（TipTap/ProseMirror 文档）、`content_markdown`（API、Agent、导入和导出格式）以及 `content_text`（搜索、摘要和索引文本）。 ## MCP 在 Profile -> MCP settings 中创建 API token，并将其交给你的 AI Agent。Agent 可以在你的账户权限范围内安全管理你的知识库，支持文本笔记和图表笔记的完整 CRUD 能力，并可连接 Notion 数据库和飞书多维表格。 ## 图片压缩 图片压缩在上传前于 Web 客户端进行。PNG、JPEG、WebP 和 AVIF 文件在有益时会转换为 WebP，最长边限制为 2560px。 ## 高级对象存储 实例所有者可以在 Settings -> Advanced -> OSS object storage 下配置兼容 S3 的对象存储。 ## 迁移 提供针对 Evernote、flomo、Memos 和 Notion 的迁移指南。 ## Docker 部署 Docker 运行与 Cloudflare 相同的前端、API 路由、服务、身份验证、MCP 实现和迁移。容器使用 SQLite，并采用本地文件或兼容 S3 的附件存储，支持 `amd64` 和 `arm64`。 ## 同步时机 Web、PWA 和桌面端会在备忘录编辑停止 30 秒后上传，并在可见时每 5 分钟检查远程更改；聚焦和手动刷新仍然即时生效。 ## 致谢 EdgeEver 的笔记产品设计参考了 Evernote 等成熟笔记工具公开可用的产品体验。相关功能由 EdgeEver 独立设计和实现。