EdgeEver

EdgeEver: A self-hosted, Cloudflare-native Evernote alternative.

EdgeEver：基于 Cloudflare 全家桶自托管的开源『印象笔记』。

EdgeEver 是一个开源、自托管、Cloudflare-native 的现代笔记工作区。它保留经典印象笔记的三栏体验，同时提供清晰的数据模型、REST API、OpenAPI schema 和 MCP endpoint。

在线演示

• Demo 地址：https://demo.edgeever.org
• 演示账号：ee-demo
• 演示密码：demo#dZ6Q29Zjfor%

公开演示环境可能会被重置，请不要保存私密内容。

功能

• 三栏布局：笔记本树、笔记列表、主编辑区。
• 无限级嵌套笔记本。
• TipTap 富文本编辑，服务端保存结构化 JSON、Markdown 和纯文本。
• 图片粘贴上传到 R2，D1 保存资源元数据。
• 图片自动压缩，GIF 会尝试转 animated WebP。
• 附件入口，可查看资源列表和总存储占用。
• 多选合并笔记，原笔记软删除，资源关联迁移到新笔记。
• 多选移动笔记，笔记本支持拖拽排序和调整层级。
• PWA 可安装，支持静态应用壳离线打开和自动更新。
• 已有笔记支持离线编辑草稿和本地同步队列。
• 单用户登录，密码使用 PBKDF2-SHA256 hash。
• REST API-first，支持 API Token、OpenAPI 和 MCP。

TODO

EdgeEver 会参考印象笔记的整体交互语言，但不逐项复刻它的全部功能。

• 完成 PC 与移动端交互审计，标记已完成、需微调、缺失和暂不做项。
• 收敛移动端首页：笔记本下拉、搜索、快捷入口、卡片流和底部导航。
• 打磨移动端选择模式：长按进入选择、多选、移动、删除、更多操作和底部 Sheet。
• 打磨 PC 三栏体验：列表宽度、右键菜单、键盘多选、拖拽移动和笔记本树导航。
• 收敛编辑器体验：保存状态、完成按钮、笔记本切换、更多操作、图片上传状态和快捷键。
• 建立每轮发布检查：bun run typecheck、git diff --check、bun run build，必要时补浏览器截图验收。

技术栈

• 前端：Vite、React、Tailwind CSS、TipTap、TanStack Query、Dexie。
• 后端：Cloudflare Workers、Hono。
• 存储：Cloudflare D1、Cloudflare R2。
• 工具链：Bun、Wrangler、TypeScript。

快速开始

安装依赖：

bun install

应用本地 D1 迁移：

bun run db:migrate:local

启动本地开发：

bun run dev

常用检查：

bun run typecheck
bun run build

部署

最简单的方式是点击上方 Deploy to Cloudflare 按钮，根据 Cloudflare 向导完成授权和部署。

如果使用 CLI 部署：

cp .env.local.example .env.local
bunx wrangler d1 create edgeever
bunx wrangler r2 bucket create edgeever-resources
bun run auth:hash -- <你的密码>
bun run deploy

把 D1 创建命令返回的 database_id 和密码 hash 填入本机 .env.local。

目录结构

apps/web       Vite + React 前端
apps/api       Cloudflare Worker + Hono API
packages/shared 共享类型、schema 和内容转换
migrations     D1 数据库迁移
wrangler.toml  Cloudflare Workers 配置

内容格式

EdgeEver 同时保存三种内容形态：

content_json      TipTap/ProseMirror 文档，编辑器权威格式
content_markdown  API、Agent、导入导出使用
content_text      搜索、摘要和索引使用

API 文档

OpenAPI schema：

https://你的域名/api/openapi.json

仓库内文件：docs/openapi.json。

MCP

先在 EdgeEver 左侧 设置 里创建 API Token，然后按客户端支持的方式接入。

Remote MCP / Streamable HTTP：

https://你的域名/mcp
Authorization: Bearer <api-token>

stdio MCP 示例：

{
  "mcpServers": {
    "edgeever": {
      "command": "bun",
      "args": ["/你的/edgeever/绝对路径/scripts/edgeever-mcp-stdio.mjs"],
      "env": {
        "EDGEEVER_URL": "https://你的域名",
        "EDGEEVER_TOKEN": "<api-token>"
      }
    }
  }
}

说明：

• command 需要本机已安装 Bun。
• args 改成你本机 EdgeEver 仓库里的绝对路径。
• EDGEEVER_TOKEN 来自 EdgeEver 左侧 设置。
• 只读 Agent 建议 scopes：read:notebooks、read:memos、read:tags；需要写入再加 write:memos。

开发者工具

CLI 不是 EdgeEver 面向 Agent 的主入口，只作为自托管场景下的调试、批处理、备份和迁移工具使用。

EDGEEVER_URL=https://你的域名 \
EDGEEVER_TOKEN=<api-token> \
bun run cli -- search edgeever

也可以保存为本机 profile，配置文件默认写入 ~/.edgeever/config.json：

bun run cli -- profile set prod --url https://你的域名 --token <api-token>
bun run cli -- --profile prod notebooks
bun run cli -- --profile prod search edgeever
bun run cli -- --profile prod export <memo-id> --format markdown --out ./memo.md