docs: refine README introduction, feature descriptions and localizations

This commit is contained in:
tianma-if committed 2026-07-25 01:33:16 +08:00
1 parent 263cd8b02b
commit bf564c7017
2 files changed
+54 -56

No files matched your search

+26 -28
View File
@@ -2,9 +2,9 @@
[简体中文](README.zh-CN.md) | English
> **EdgeEver: A serverless, 100% free, open-source, and AI-native self-hosted Evernote alternative on Cloudflare.**
> **EdgeEver: A serverless, 100% free, open-source, and AI-native self-hosted Evernote alternative.**
EdgeEver is an open-source, self-hosted, Cloudflare-native notes workspace. It keeps the classic Evernote-style three-pane experience while providing a clear data model, REST API, OpenAPI schema, Remote MCP endpoint, and native AI Agent integration.
EdgeEver is a modern, open-source notes workspace built for effortless knowledge management. It revives the beloved Evernote-style three-pane layout while offering an open data architecture and seamless AI Agent integration for complete ownership and smart productivity.
> 💡 **Serverless & 100% Free Forever**
> EdgeEver uses a pure Serverless architecture. **No server purchase or VPS rental is required**, and there is no need to configure Docker or SSL certificates. By running within Cloudflare's free quotas, personal use is **100% free with zero maintenance**.
@@ -13,16 +13,16 @@ EdgeEver is an open-source, self-hosted, Cloudflare-native notes workspace. It k
## Why EdgeEver
Many long-time **Evernote** users only need a **reliable, open, and responsive** personal knowledge base. However, existing mainstream solutions all have their pain points:
Many long-time **Evernote** users simply want a **reliable, open, and fast** personal knowledge base. However, existing mainstream solutions all present tradeoffs:
* **Evernote**: It has become increasingly bloated with commercial ads and unnecessary add-ons, leading to poor performance and high memory usage. It also locks down your data, making it hard to export. The Chinese version (Yinxiang) does not support MCP, while the international version supports MCP but requires a subscription starting at $15/month with strict usage limits.
* **Obsidian**: Although open and customizable, it is too heavy for quick, on-the-go captures (especially on mobile). Official sync costs $5/month, while third-party sync solutions require significant setup effort.
* **Memos & lightweight notes**: Though open and simple, their stream-based layouts differ significantly from the classic Evernote-style three-pane workflow.
* **Evernote**: It has grown increasingly bloated with commercial ads and unnecessary features, degrading performance. Data export is cumbersome, free tiers are heavily restricted, and AI/MCP features require costly subscriptions.
* **Obsidian**: Exceptionally powerful and open, yet feels a bit heavy for quick, friction-free captures on the go. Official sync is subscription-based, while third-party sync setups demand significant effort.
* **Memos & Stream Notes**: Clean and simple, but their social-timeline layouts differ fundamentally from the structured productivity of a classic three-pane workflow.
**EdgeEver is designed to fill this gap**: it retains the familiar classic three-pane note-taking experience, while providing fully open data models, REST API, native MCP support, and zero-cost self-hosted deployment.
**EdgeEver fills this gap**: It preserves the refined three-pane layout you know and love, while unlocking complete data ownership, native AI capabilities, and zero-cost self-hosted deployment.
> 💡 **My current best practice:**
> Use **EdgeEver** to quickly capture ideas and reminders as a raw "material library." When content needs structured organization, use **MCP** to let AI automatically organize and sync it into **Obsidian**, **Notion Database**, or **Feishu Bitable**.
> 💡 **Recommended Workflow:**
> Use **EdgeEver** as your central inbox to quickly capture ideas and notes on any device. When it's time to curate and publish, leverage **MCP** to let your AI assistant distill, tag, and sync them into **Obsidian**, **Notion**, or **Feishu Bitable**, or copy beautifully styled posts directly into **Substack**, **Medium**, or newsletters with a single click.
## Online Demo
@@ -32,25 +32,23 @@ The public demo resets every Monday at 1:00 AM (China Standard Time) and restore
## Features
- Serverless, 100% free, and zero maintenance: Built on Cloudflare's Serverless architecture, running entirely within free tiers. Store up to 150k notes and 50k images or other attachments without any hosting fees, while enjoying near-instant response times globally.
- Open data: notes are stored in Cloudflare D1, based on standard SQLite, and can be read and managed through REST API, MCP, and CLI without locking your data to a single notes product.
- EdgeEver ZIP import and export: one archive combines human-readable Markdown, Front Matter, nested notebook structure, and relative-path attachments with versioned structured data and revision history for complete recovery between EdgeEver instances.
- AI Agent friendly: built-in MCP support lets tools such as Codex, Claude Code, and Antigravity read, organize, and maintain notes, while enabling integrations with Notion databases and Feishu Bitable.
- Uncapped multi-device sync: self-hosted API means no restrictive commercial limits on the number of active login devices, supporting seamless synchronization across PC, tablet, and mobile (via PWA or browser).
- Three-pane layout: notebook tree, note list, and main editor, with a desktop focus mode that expands the selected note across the workspace.
- Unlimited nested notebooks.
- Rich text editing.
- Switch between Markdown source and rich text views on desktop.
- Mermaid diagrams rendered from standard fenced code blocks on the Web and native app, with editable source preserved across rich text and Markdown views.
- Note version history for reviewing previous content changes.
- Local browser-side image compression before upload, often reducing screenshots and large photos by about 50%-90%.
- Upload and insert general file attachments such as PDFs, office documents, archives, audio, and video into notes.
- Batch note merging.
- Batch note moving, notebook drag sorting, and hierarchy editing.
- Offline drafts and local sync queue for existing notes.
- Multi-user instances with isolated personal workspaces, owner-managed accounts, and PBKDF2-SHA256 password hashing.
- Chrome/Edge web clipper is officially published on the [Chrome Web Store](https://chromewebstore.google.com/detail/edgeever-web-clipper/gjadpfmanienmlofajibkfkkpfdkclgo).
- Support installing as a PWA app for a native-like experience on PC and mobile; the native mobile App (iOS / Android) is complete and under store review, with the Android APK available on the GitHub Releases page for immediate download.
- **Zero Server, Zero Ops, Truly Free**: Powered by Cloudflare Serverless. No cloud servers to rent or maintain. Free tiers easily accommodate up to 150k notes and 50k images with blazing-fast global edge delivery.
- **Open Data, No Vendor Lock-in**: Built on standard SQLite with complete REST API, MCP, and CLI access. Your knowledge is stored transparently and accessible anytime without being locked to a single app.
- **Lossless ZIP Backup & Portability**: Export your complete library as a clean archive containing Markdown, Front Matter, nested folders, relative attachment links, and version histories for instant restoration anywhere.
- **Native AI Agent Synergy**: Deep integration with Model Context Protocol (MCP) allows AI tools like Claude Code, Codex, and Antigravity to read, organize, and summarize your notes, or sync seamlessly with Notion and Feishu Bitable.
- **Unlimited Multi-Device Sync**: No commercial device caps or paywalls. Enjoy seamless synchronization across PC, tablet, and mobile via web, PWA, or browser.
- **Classic Three-Pane Layout & Focus Mode**: Clean navigation featuring notebook trees, note lists, and an expansive editor, with a desktop focus mode to eliminate distractions.
- **Unlimited Nested Notebooks**: Organize your knowledge with arbitrary folder depth.
- **One-Click Rich Copy for Newsletters & Blogs**: Designed for creators to convert notes into beautifully formatted rich text with inline CSS, ready to paste directly into Substack, Medium, WordPress, or newsletter editors without extra tools.
- **Seamless Dual-View Editor**: Switch effortlessly between intuitive rich text editing and Markdown source code on desktop.
- **Native Mermaid Diagram Rendering**: Render clear flowcharts, sequence diagrams, and mind maps directly in notes, preserving clean, editable source code across Markdown and rich text views.
- **Revision History**: Inspect and restore previous iterations of your notes with built-in version tracking.
- **Smart Local Image Compression**: Client-side WebP compression reduces file sizes by 50%-90% before uploading, saving storage and speeding up page loads without extra server costs.
- **Universal File Attachments**: Attach and preview PDFs, Office documents, zip files, audio, and video directly within notes.
- **Batch Operations & Flexible Sorting**: Easily merge or relocate multiple notes, with drag-and-drop notebook reordering.
- **Offline Drafts & Queueing**: Draft and edit uninterrupted while offline; changes automatically sync once reconnected.
- **Multi-Tenant Account Isolation**: Host multiple user accounts on a single instance with strictly partitioned spaces and clean admin account management.
- **Everywhere You Need It**: Chrome/Edge Web Clipper published on Chrome Web Store; installable as a PWA; native mobile apps (iOS/Android) arriving soon with Android APK downloadable on GitHub Releases.
## Deployment
+28 -28
View File
@@ -2,26 +2,27 @@
简体中文 | [English](README.md)
> **EdgeEver:无需服务器、0 费用、开源且原生支持 AI Agent 的自托管『印象笔记』替代品。**
> **EdgeEver:无需服务器、0 费用、开源且原生支持 AI 的自托管「印象笔记」替代方案。**
EdgeEver 是一款现代化的开源笔记工作区。它为你找回经典印象笔记的三栏高效体验,同时具备完全开放的数据架构与原生 AI Agent 联动能力,让个人知识沉淀更轻量、更自由。
EdgeEver 是一个开源、自托管、Cloudflare-native 的现代笔记工作区。它保留经典印象笔记的三栏体验,同时提供清晰的数据模型、REST API、OpenAPI schema 和 MCP endpoint,原生支持 AI Agent 接入。
> 💡 **终身免服务器,100% 免费**
> EdgeEver 采用纯 Serverless(无服务器)架构。自部署时**你不需要购买任何云服务器**,也**不需要折腾复杂的 Docker 或 SSL 证书**。直接运行在 Cloudflare 的免费额度内,个人日常使用 **完全免费,0 费用,0 运维**。
> EdgeEver 采用纯 Serverless(无服务器)架构。自部署时**无需购买云服务器**,也**无需配置复杂的 Docker 或 SSL 证书**。免费运行于 Cloudflare 配额之内,个人日常使用 **100% 免费,零费用、零运维**。
> ⭐ 如果 EdgeEver 对你有帮助,欢迎点个 Star。你的支持会帮助更多人发现这个项目。
## 为什么做 EdgeEver
很多长期使用**印象笔记**的用户,核心需求只是一个**可靠、开放、响应足够快**的个人知识库。然而,当下的主流方案都各有痛点:
很多长期使用**印象笔记**的用户,核心需求只是一个**可靠、开放、响应迅速**的个人知识库。然而,当下的主流方案都各有痛点:
* **印象笔记**:功能日益臃肿,商业化广告和附加功能不断增加,性能与内存占用差强人意;且数据封闭,很难直接导出,国内版更不支持 MCP 联动;国际版虽支持 MCP,但入门套餐每月需 15 美元且有严格的额度限制。
* **Obsidian**:虽然足够开放,但对于“随时随地随手记”的轻量场景来说太重了;且官方同步收费(每月 5 美元),第三方同步方案门槛和折腾成本较高。
* **Memos 等轻量笔记**:虽然足够开放好用,但其流式布局与经典印象笔记式的“三栏工作流”有着天然的交互差异。
* **印象笔记**:功能日益臃肿,商业广告与繁杂附加功能充斥,性能与内存占用居高不下;且数据相对封闭难以导出,免费版限制重重,支持 AI/MCP 的套餐订阅成本高昂。
* **Obsidian**:功能强大且高度开放,但对于“随时随地随手记”的轻量场景来说偏重;官方同步费用昂贵,第三方同步配置繁琐。
* **Memos 等轻量笔记**:虽然简单好用,但流式卡片布局与习惯了经典“三栏工作流”的用户有着天然的交互习惯差异。
**EdgeEver 旨在填补这个空白**:它保留了用户最熟悉的经典三栏笔记体验,同时提供完全开放的数据模型、REST API、MCP 原生支持以及零成本自托管部署。
**EdgeEver 恰好填补了这一空白**:在保留你最熟悉的经典三栏布局与流畅排版的同时,赋予数据完全的自由度,原生接入 AI Agent,且部署维护零门槛、零费用。
> 💡 **我目前研究的最佳实践是:**
> 用 **EdgeEver** 随手快速记录灵感与备忘,作为灵感的“原料库”;当需要进行结构化整理时,再通过 **MCP** 联动 AI,将内容自动同步并整合到 **Obsidian**、**Notion Database** 或**飞书多维表格**中。
> 💡 **最佳实践推荐:**
> 用 **EdgeEver** 随时捕捉灵感与备忘,作为知识的“原料库”;当需要结构化整理或创作发布时,既能通过 **MCP** 唤醒 AI 助手智能归纳并同步至 **Obsidian**、**Notion** 或**飞书多维表格**,也能一键将文章精美排版并复制到**微信公众号**直接发布。
## 在线演示
@@ -31,24 +32,23 @@ EdgeEver 是一个开源、自托管、Cloudflare-native 的现代笔记工作
## 功能
- 零服务器,零运维,终身完全免费:基于 Cloudflare 无服务器架构与免费级配额,短笔记可达 15 万条,200KB 图片约可存放 5 万张,彻底免去云服务器租用和维护成本,并带来全球秒开的极速响应。
- 数据完全开放:笔记内容存放在基于标准 SQLite 的 Cloudflare D1 中,可通过 REST API、MCP 和 CLI 按需读取与管理,不用担心被单一笔记产品绑定。
- EdgeEver ZIP 导入与导出:同一份档案既包含便于直接阅读和迁移的 Markdown、Front Matter、嵌套笔记本结构与相对路径附件,也包含用于 EdgeEver 实例间完整恢复的版本化结构数据和历史版本。
- AI Agent 友好:原生支持 MCP,可让 Codex、Claude Code、Antigravity 等工具读取、整理和维护笔记,并可借助 MCP 与 Notion Database、飞书多维表格进行联动。
- 多端无缝同步且不限设备数:基于自建的 API 个人独享数据,摆脱商业笔记平台对登录设备数量的强制限制(如免费版只允许登录 2 台设备等),支持 PC、平板与手机无缝多端同步。
- 三栏布局:笔记本树、笔记列表、主编辑区;桌面端支持专注模式,可让当前笔记铺满工作区。
- 无限级嵌套笔记本。
- 支持富文本编辑。
- 桌面端支持 Markdown 源码与富文本视图切换。
- Web 与原生 App 均支持渲染标准 Mermaid 围栏代码块,并在富文本与 Markdown 视图之间保留可编辑源码。
- 支持查看笔记历史版本,便于回溯内容变化。
- 笔记图片上传前支持 Web 端本地压缩,常见截图和大尺寸照片通常可减少约 50%-90% 体积,减少资源占用且不消耗 Cloudflare Images 额度。
- 多选合并笔记。
- 多选移动笔记,笔记本支持拖拽排序和调整层级。
- 已有笔记支持离线编辑草稿和本地同步队列。
- 支持单实例多账号,每个账号拥有隔离的个人笔记空间;管理员可创建、停用和重置成员账号,密码使用 PBKDF2-SHA256 hash。
- Chrome/Edge 网页裁剪插件已正式上架 [Chrome Web Store](https://chromewebstore.google.com/detail/edgeever-web-clipper/gjadpfmanienmlofajibkfkkpfdkclgo)。
- 支持安装为 PWA 应用,PC 和移动端均可流畅访问;原生移动端 App(iOS / Android)已开发完成并已提交上架审核,安卓用户可直接在 Release 页面下载 APK 抢先体验。
- **零服务器、零运维、真正免费**:基于 Cloudflare Serverless 架构,彻底告别服务器租用与运维烦恼。免费配额可轻松容纳 15 万条笔记与 5 万张图片,全球节点带来秒开体验。
- **数据开放,不设围墙**:基于标准 SQLite 存储,提供 REST API、MCP 与 CLI 接口。数据随时可读可导,不再担心被任何特定平台绑定。
- **无损 ZIP 打包与无缝迁移**:一键打包导出包含 Markdown、Front Matter、嵌套目录及附件的完整档案,同时保留历史版本与结构化数据,方便在不同实例间完整还原。
- **原生 AI Agent 智脑联动**:内置 MCP(Model Context Protocol)协议,支持 Claude Code、Codex、Antigravity 等 AI 助手直接读取与整理笔记,也可与 Notion Database、飞书多维表格轻松打通。
- **多端无缝同步,无设备限制**:自托管数据无商业限制,摆脱免费账号仅限 2 台设备的束缚,在 PC、平板与手机上随心同步。
- **经典三栏布局与专注模式**:笔记本树、笔记列表与编辑区一目了然;桌面端一键开启专注模式,让思绪尽情铺满屏幕。
- **无限层级笔记本**:轻松构建清晰的多级目录结构。
- **微信公众号一键排版与复制**:专为中文创作者设计,支持将笔记一键转换为带行内样式的公众号美化格式,直接复制粘贴至微信公众号后台,告别复杂的第三方排版工具。
- **优雅的双视图编辑**:桌面端支持在富文本与 Markdown 源码视图之间自由切换。
- **Mermaid 架构图与流程图渲染**:原生支持 Mermaid 代码块渲染,视图切换时完整保留可编辑源码,让绘制逻辑图表更直观。
- **笔记历史版本回溯**:自动记录修改历史,随时查阅与还原过往版本。
- **智能前端图片压缩**:图片上传前在浏览器端静默完成压缩,常见截图与大图精简 50%-90% 体积,加载更迅速、存储更省心。
- **通用文件附件支持**:支持轻松上传并插入 PDF、Office 文档、压缩包及音视频等各种附件。
- **高效多选与批量操作**:支持笔记批量合并、批量移动,以及笔记本拖拽排序与层级调整。
- **离线草稿与同步队列**:网络不稳定时自动保存离线草稿,恢复连线后自动入队同步。
- **多账号与个人空间隔离**:单实例支持创建多个独立账号,用户数据相互隔离,配备直观的管理员账号管理与安全加密机制。
- **全平台多端覆盖**:已上架 Chrome/Edge 网页裁剪插件;支持安装为 PWA 应用;原生移动端 App(iOS/Android)即将上线,Android APK 可在 Release 页面即刻下载体验。
## 部署