okooooooo/edgeever
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
4dfa1546d77dad3047375786d5ca2201bfb5145c
edgeever/README.zh-TW.md
T

28 KiB
Raw Blame History

EdgeEver Logo EdgeEver

開源、原生支援 AI、可自由部署的自行託管知識庫與 Evernote（印象筆記）替代方案

GitHub Stars GitHub Forks Docker Pulls Product Hunt Featured｜HelloGitHub 贊助與支持

简体中文 | 繁體中文 | English | 日本語 | Polski

WeChat 微信交流群  |  🌐 線上展示  |  📱 用戶端下載  |  核心特性與場景

EdgeEver 是一款現代化的開源筆記與個人知識庫工作區。它為你找回經典 Evernote 的三欄高效體驗，同時具備完全開放的資料架構與原生 AI Agent 聯動能力，讓個人知識沉澱更輕量、更自由。

💡 終身免伺服器，100% 免費 EdgeEver 可以免費執行在 Cloudflare 配額內，無需購買或維護伺服器；希望使用 VPS、NAS 或家用伺服器的使用者，也可以透過 Docker 部署同一套應用程式。

⭐ 如果 EdgeEver 對你有幫助，歡迎點個 Star。你的支持會幫助更多人發現這個專案。

為什麼做 EdgeEver

很多長期使用 Evernote 的使用者，核心需求只是一個可靠、開放、回應迅速的個人知識庫。然而，當下的主流方案都各有痛點：

  • 印象筆記 / Evernote：陪伴了作者近 10 年、感情最深的筆記產品。然而隨著它演進為全功能商業套件，廣告與附加功能漸多，系統開銷也隨之走高；加之免費版配額收緊、高級 AI 訂閱昂貴，且難以靈活接入現代自託管與私有 AI 工作流。
  • Obsidian：Markdown 開放，核心閉源；官方同步收費，第三方同步繁瑣；純本地檔案依賴遍歷掃描，當筆記累積到數千上萬條或載入複雜外掛後，冷啟動與全庫檢索明顯卡頓遲緩；圖片與附件與文字混存，儲存庫體積極易膨脹導致行動端同步緩慢，且刪除筆記後殘留附件難清理；對於「隨時隨地隨手記」的輕量場景來說偏重。
  • Memos / Flomo 等輕量筆記：雖然簡單好用，但時間軸卡片版面與習慣了經典「三欄工作流程」的使用者有著天然的互動習慣差異。
  • 思源筆記等區塊級知識庫：功能深厚且支援開源自託管，但全盤的「區塊級（Block）」架構使得日常隨手記錄與連續排版書寫的心智負擔偏重；且缺少零伺服器成本的 Serverless 部署型態，多端同步主要依賴官方付費訂閱，或需額外付費解鎖 S3/WebDAV 同步特性並自備儲存。

EdgeEver 恰好填補了這一空白：全端開源，雲端同步與自行託管都可自行部署；同時保留經典三欄版面與流暢排版，萬條筆記常駐依然輕盈絲滑，原生支援接入 AI Agent，部署維護零門檻、零費用。

線上展示

公開展示環境會在每天凌晨 3:00（北京時間）自動重設並還原範例筆記，請不要儲存私密內容。

用戶端下載

下載 macOS 用戶端   下載 Windows 用戶端   下載 Linux x86_64 AppImage 預覽版   從 Google Play 下載 Android 用戶端   從 App Store 下載 iOS 用戶端

iOS 用戶端需要使用非中國大陸區 Apple ID 下載。

核心特性與場景

從跨渠道內容捕獲到深度知識表達與業務協同，EdgeEver 為個人與團隊提供了高效流暢的端到端工作流：

全渠道剪藏與多媒體沉澱

  • 跨平台一鍵剪藏：瀏覽器外掛深度適配 小紅書畫廊、X (Twitter) 推文與引用、知乎問答、Reddit、GitHub 以及 Bilibili、YouTube、小宇宙等十餘個主流社群與影音平台；手機端透過系統分享一鍵轉存全網圖片與微信公眾號文章。
  • 微信聊天記錄完整歸檔：macOS 端支援在微信中將聊天記錄「轉發到其他應用 → EdgeEver」，一鍵整段匯入為結構化筆記，完整保留發言人、時間軸、引用回覆及微信表情，圖片自動內嵌，影片與檔案自動轉為筆記附件。詳見微信聊天記錄一鍵歸檔與整理。
  • 通用檔案附件與端側圖片壓縮：支援輕鬆上傳並插入 PDF、Office 文件、壓縮檔及影音等各種附件，分塊上傳與串流處理安全支援最大 1 GiB 附件；圖片上傳前在瀏覽器端靜默完成壓縮，常見截圖與大圖精簡 50%-90% 體積，載入更迅速、儲存更省心。

智慧視覺化與多維資料協作

  • 全類型視覺化圖表與專業資訊圖：告別外部繪圖軟體，借助伴隨式 AI 助手自然語言一句話產生可互動編輯的心智圖、流程圖與架構圖（詳見視覺化圖表筆記設計說明，原生支援 Mermaid 程式碼區塊繪製）；內建豐富模板庫，一鍵產生精美專業的全類型視覺化資訊圖（時間線、對比圖、象限矩陣等）。
  • AI 多維表格與線上收集表單：自然語言一句話按需建構任意業務場景多維表格（如專案管理、選題庫、人事資產等），自動推斷單選標籤、日期等欄位類型並預置真實範例資料；支援一鍵開啟無需登入的對外公開線上收集表單，使用者填報資料即時沉澱入庫。
  • 原生海報筆記與 AI 視覺排版：原生支援基於畫布的結構化海報筆記，內建豐富的圖文卡片模板與版式佈局；支援按兩下編輯文案、替換圖片與預留位置，支援一鍵自適應縮放；伴隨式 AI 助手與 ACP / MCP 協定可直接理解、產生並協同精修海報內容。
  • 雙視圖編輯、空間組織與知識庫公開發布：桌面端支援在富文字與 Markdown 原始碼檢視之間自由切換；經典三欄版面與可調節面板寬度、一鍵專注模式與無限層級筆記本，支援筆記批次合併/移動與拖放排序；提供自動版本回溯；除單篇筆記加密分享外，更支援將整個筆記本一鍵公開發布為帶目錄樹導覽的獨立知識庫網站，並提供存取密碼保護。

創作者排版與一鍵發布

  • 微信公眾號一鍵排版與複製：專為中文創作者設計，支援將筆記一鍵轉換為帶行內樣式的公眾號美化格式，一鍵複製內聯富文本到微信公眾號後台直接貼上發布，告別複雜的第三方排版工具。
  • 高質感長圖分享與多格式匯出：任意筆記均可一鍵分享為高質感長圖海報，內建多款質感主題、Monogram 字母頭像、自適應版式、自訂字型與卡片版式，優雅分發至社群平台；支援單篇筆記獨立便捷匯出為 Markdown、HTML 或 PDF。
  • AI RSS 智慧訂閱日報：內建官方 AI RSS 訂閱外掛，自動定時聚合產業資訊與部落格源，AI 過濾雜訊並產生結構嚴謹、重點清晰的精煉日報筆記。

原生 AI Agent 與開放生態

  • 原生 Agent 協定深度互聯（MCP & ACP）：內建 MCP（Model Context Protocol）協定，支援外部 AI Agent 直接讀取與整理筆記；桌面端支援透過 ACP（Agent Client Protocol）協定直接調用本機執行的 AI Agent（如 Codex、Antigravity、Claude Code、WorkBuddy 等）協同創作。
  • 接入自有模型與開放外掛 API：支援新增多個 OpenAI、Anthropic、Gemini 相容服務與第三方中轉平台，在伴侶側邊欄與編輯器中隨時對全文或選取範圍進行智慧摘要、重點擷取、文法校對、翻譯與續寫潤飾；提供豐富的外掛開發文件自由擴充功能。

開放架構、全端體驗與安全基座

  • 自由部署與資料無圍牆：既可免費執行於 Cloudflare Serverless（個人免費額度約容納 15 萬條短筆記與 5 萬張圖片），也可透過 Docker 部署到 VPS、NAS 或家用伺服器（輕鬆承載百萬級筆記與海量圖片）；基於標準 SQLite 儲存，提供 REST API、CLI 介面與無損 ZIP 完整檔案匯出匯入，資料完全自主不設圍牆。
  • 全平台涵蓋與穩定安全：官方涵蓋 Web、Android、macOS、Windows、Linux 及 iOS（網頁擷取擴充功能支援 Chrome、Edge 和 Firefox），自託管多端同步無裝置數量限制；桌面端輕快省記憶體，支援離線草稿與同步佇列、伺服端防暴力破解限流保護，以及多帳號空間資料隔離。

👉 查看全部 14 個實機展示與操作效果：完整場景與最佳實踐指南

部署

Cloudflare 是建議的零伺服器部署方式；希望使用 VPS、NAS 或家用伺服器的使用者也可以選擇 Docker。

Cloudflare 線上部署可以選擇以下兩種方式之一：

方案一：交給 AI Agent 部署（建議）

將下方提示詞直接複製傳送給 AI Agent（如 Codex、Claude、Cursor、WorkBuddy、Antigravity、OpenClaw、Hermes Agent 等）。執行過程中，如需存取 GitHub 或 Cloudflare，請確認權限範圍並依提示完成授權。

請全程透過 GitHub 和 Cloudflare 線上部署 EdgeEver：
1. Fork https://github.com/tianma-if/edgeever。
2. 在 Cloudflare 中建立 D1 `edgeever` 與 R2 `edgeever-resources`。
3. 在 Workers & Pages 中從 Fork 的 `main` 分支建立名為 `edgeever` 的 Worker。
   使用儲存庫根目錄，保留 Cloudflare Workers Builds 的預設部署指令，確認其 API Token
   具備 D1 讀取及編輯權限，然後儲存並部署。
4. Worker 建立後，設定執行時 Secret `EDGE_EVER_AUTH_PASSWORD`，值為使用者指定的密碼
   （建議至少 32 個字元）。管理員使用者名稱預設為 `admin`；如需自訂，請在再次建置前
   設定 Workers Builds 建置變數 `EDGE_EVER_AUTH_USERNAME`。
5. 再次建置，驗證 `/api/health` 和 `/api/openapi.json`，再用該管理員
   使用者名稱和密碼驗證登入。
6. 啟用並手動執行一次名為 `Update deployed EdgeEver` 的 GitHub Actions 工作流程，
   以便後續自動同步正式版本，持續獲得 EdgeEver 的功能更新與問題修復。

詳細約定與要求請查看：AI Agent 線上部署約定。

方案二：手動線上部署

只需在網頁端完成 6 步設定：

  1. Fork 儲存庫：在 GitHub 點選右上角 Fork，將專案 Fork 到您的個人帳戶下。
  2. 建立 Cloudflare 資源：建立 D1 edgeever 與 R2 edgeever-resources。
  3. 匯入並設定專案：在 Cloudflare Workers & Pages 中從 Fork 的 main 分支建立名為 edgeever 的 Worker。使用儲存庫根目錄，保留由 Cloudflare 線上執行的 Workers Builds 預設部署指令，並確認其 API Token 具備 D1 讀取及編輯權限。binding 由部署指令產生，不要修改 Fork 中的檔案。
  4. 準備管理員密碼：準備管理員登入密碼，建議至少 32 個字元。Worker 建立後，將它儲存為執行時 Secret EDGE_EVER_AUTH_PASSWORD。
  5. 首次建置與驗證：儲存並部署會建立 Worker 並啟動建置。如因缺少管理員 Secret 而失敗，新增步驟 4 的執行時 Secret 後重試。管理員使用者名稱預設為 admin；如需使用其他名稱，請在重試建置前設定 Workers Builds 建置變數 EDGE_EVER_AUTH_USERNAME。部署完成後造訪 /api/health，確認回傳 200，再用設定的管理員使用者名稱和密碼登入。
  6. 啟用自動更新：進入 Fork 的 Actions 分頁，點選 I understand my workflows, go ahead and enable them，然後手動執行一次 Update deployed EdgeEver，確保後續能夠自動獲得正式版本的功能更新與修復。

📖 包含具體參數與建置指令的詳細步驟，請查看 線上部署完整文件。

💡 網域與存取：實例部署完成後，可以直接使用 Cloudflare 預設分配的 *.workers.dev 網域存取，也可以在 Worker 設定中的 Settings → Domains & Routes 綁定自己的自訂網域。

💡 Cloudflare R2 開通：雖然 Cloudflare R2 儲存提供了足夠寬裕、在筆記場景中完全不會超量的免費儲存額度，但需先開通 R2 subscription 並綁定付款方式。Cloudflare 官方支援 銀聯（UnionPay）、Visa、Mastercard 等金融卡與信用卡，以及 PayPal、Apple Pay、Google Pay 等付款方式。

方案三：在 VPS 或 NAS 上使用 Docker

使用 GitHub 託管的安裝指令碼和官方 GHCR 映像：

curl -fsSL https://edgeever.org/install.sh | bash

此指令會自動拉取最新映像、產生管理員密碼，並使用 Docker Compose 啟動 EdgeEver。手動部署與設定說明見 Docker 部署文件。

安裝後預設每日自動更新。如需手動更新，請在部署伺服器上執行 ~/edgeever/update.sh。

多帳號登入與儲存用量

部署完成後，單一實例支援多帳號登入。

實例管理員可以在 個人中心 -> 帳號管理 中建立、停用成員帳號或重設密碼。每個成員擁有完全隔離的個人空間，包括筆記本、筆記、附件、回收筒、匯入匯出和 MCP Token 等。系統同時提供直觀的儲存用量面板，可即時掌握實例整體與各帳號的附件儲存占用明細。

瀏覽器網頁擷取擴充功能

為 Google Chrome 安裝 EdgeEver 網頁擷取擴充功能   為 Microsoft Edge 安裝 EdgeEver 網頁擷取擴充功能   為 Firefox 安裝 EdgeEver 網頁擷取擴充功能

  • 智慧內文擷取：自動擷取網頁文章正文並轉為純淨 Markdown，完整保留來源網址與擷取時間。
  • 選取與右鍵擷取：反白選取文字或右鍵任意圖片直接儲存為獨立筆記，無需抓取整頁多餘內容。
  • 社群與社群深度擷取：深度適配 X (Twitter)、小紅書、知乎、Reddit、GitHub、Bilibili、YouTube 等十餘個主流社群、技術社群與影音平台，一鍵結構化入庫。
  • 自託管隱私直連：擷取內容直傳個人自託管執行個體，不經過任何第三方伺服器轉發。

社群與回饋

  • Bug、功能建議和部署問題請優先提交 GitHub Issues，方便後續使用者檢索和重用解決方案。
  • 貢獻程式碼前請閱讀貢獻程式碼須知。如果您的 Fork 同時用於部署 EdgeEver，請將 main 分支僅用於部署；從官方 upstream/main 新建獨立分支，在該分支中同步上游、開發並提交 Pull Request，不要在部署用的 main 上開發或執行 Sync fork。

微信交流群

歡迎加入 EdgeEver AI 交流群，這裡聚集了大量 Vibe Coding 與 AI 玩家。一起交流前沿 AI 生產力與個人知識庫的最佳實踐。

掃描下方 QR Code 或加入微信 m1245207870（備註「EdgeEver 進群」），群主將手動邀請入群。

微信聯絡人 QR Code

外掛與主題

Web 與桌面版支援功能外掛與個人化主題，可從官方市集、GitHub 或 Manifest 網址一鍵安裝，並隨工作區跨端同步。開發者可使用 @edgeever/plugin-api 擴充功能，詳情參閱外掛開發文件與官方外掛市集上架政策。

技術棧

  • Bun workspace monorepo，包含 Web、API、官網與共享型別套件。
  • 前端：Vite、React、React Router、TanStack Query，UI 基於 Tailwind CSS、shadcn/ui、Radix UI。
  • 編輯器：TipTap / ProseMirror，支援 Markdown；PWA 使用 vite-plugin-pwa、Workbox、Dexie。
  • Android App：apps/mobile 中的 Expo + React Native，採用 SQLite 本機儲存與增量同步。
  • iOS App：apps/ios 中的原生 SwiftUI（iOS 17+），內建 TipTap EditorBundle、GRDB 本機鏡像／outbox，介面與 Android 殼層對齊。
  • 原生桌面版：Electron + Rust sidecar，兼顧跨平台一致體驗與高效能本機資料服務；基於 SQLite 支援離線編輯、連網後增量同步與本機備份。
  • 網頁擷取：Manifest V3、Mozilla Readability、Turndown，支援 Chrome、Microsoft Edge 與 Firefox。
  • 後端：一套基於 Hono/Zod 的業務應用，提供 REST API 與 Remote MCP；Cloudflare 使用 Workers/D1/R2，Docker 使用 Bun/SQLite/本機檔案或 S3。
  • 官網：Astro 靜態網站，位於 apps/site，可獨立建置並部署到 Cloudflare Pages。

快速開始

bun install
bun run dev

本機開發預設自動登入，首次帳號為 owner / edgeever-local-dev；測試登入頁可主動登出。

目錄結構

apps/web          Vite + React 前端、PWA、離線草稿與同步佇列
apps/extension    Chrome/Edge/Firefox Manifest V3 網頁擷取擴充功能
apps/api          Cloudflare Worker + Hono API、MCP endpoint
apps/mobile       Expo + React Native Android App
apps/ios          原生 SwiftUI iOS App（TipTap EditorBundle、GRDB）
apps/desktop      Electron 桌面版殼層、preload bridge 與原生打包設定
apps/site         Astro 官方網站，可獨立部署
packages/client   Web 與行動端共享的 API Client
packages/shared   共享型別、Zod schema、TipTap / Markdown 內容轉換
crates/desktop-sidecar
                   Rust sidecar，負責本機 SQLite、離線資料、備份與資源服務
scripts           Wrangler 封裝、密碼雜湊、CLI、MCP stdio bridge、Evernote ENEX 匯入
migrations        D1/SQLite 共用、只增不改的資料庫 migration
docs              架構、遷移與部署文件
.github/workflows Web、行動端、iOS、桌面版打包、部署與 Release 的 CI
wrangler.toml     Cloudflare Workers、Assets、D1、R2 設定

內容格式

EdgeEver 同時保存三種內容形態：

content_json      TipTap/ProseMirror 文件，編輯器權威格式
content_markdown  API、Agent、匯入匯出使用
content_text      搜尋、摘要和索引使用

請開啟 我的 -> 匯入與匯出，匯出或匯入 EdgeEver ZIP。壓縮檔中的 notes/ 目錄可直接作為 Markdown 閱讀和遷移，結構化資料則用於在 EdgeEver 實例之間完整還原；匯入時目標實例中的無關資料會保留，相同 EdgeEver ID 的內容會被覆蓋。

MCP

在 個人中心 -> API / MCP 中建立 API Token 並一鍵複製 Remote MCP 設定，即可讓 Claude Code、Cursor、Antigravity、OpenClaw 等 AI Agent 在帳號授權範圍內安全管理你的知識庫。系統支援文字筆記、圖表筆記（心智圖、流程圖與架構圖）、多維表格筆記與原生海報筆記的完整增刪改查，Agent 還可管理筆記本目錄、標籤、附件、歷史版本、筆記範本與 AI 指令。

💡 情境啟發： 讓 AI 真正成為你的知識管家與創作外腦——不僅能將方案秒級產生為可互動的心智圖、流程圖、架構圖與多維表格，還能為 AI Agent 提供私有脈絡。憑藉 EdgeEver 強大的富文字編輯與精美排版能力，AI 協同沉澱的不再是冰冷文字，而是結構工整、排版優雅、隨時可一鍵分發的高品質知識資產。

圖片壓縮規則

圖片壓縮僅在 Web 端上傳前執行，由設定頁的「壓縮筆記內圖片」開關控制。啟用後，瀏覽器會把 PNG、JPEG、WebP、AVIF 嘗試壓縮為 WebP，並將最長邊限制在 2560px 以內；如果壓縮結果不比原圖小，則保留原圖。

Cloudflare Worker 側執行圖片處理會消耗運算／圖片處理額度，因此 EdgeEver 將圖片壓縮放在 Web 用戶端完成；REST API 或 MCP 上傳入口會依用戶端提供的檔案內容直接入庫，不再由伺服端自動壓縮。

進階物件儲存與第三方圖床

  • OSS 物件儲存：實例 Owner 可在設定 → 進階設定 → OSS 物件儲存中設定相容 S3 API 的物件儲存。切換儲存不會遷移或影響既有附件。
  • 桌面端 PicGo 圖床：桌面端支援可選接入本機 PicGo 用戶端服務，在筆記中插入圖片時可直接上傳至 GitHub、SM.MS、又拍雲、七牛雲或自建圖床，進一步減少自託管實例的儲存開銷與頻寬占用。

匯入與遷移 (Migration)

若你想從其他筆記軟體遷移到 EdgeEver，請參考以下精簡遷移指引：

Docker 部署

Docker 與 Cloudflare 共用同一套前端、API 路由、業務服務、鑑權、MCP 實作和 migration。容器使用 SQLite，並支援本機檔案或 S3 相容附件儲存，提供 amd64 與 arm64 映像。詳見使用 Docker 部署 EdgeEver和自行託管與 Docker 架構。

同步時序

Web、PWA 與桌面版會在停止編輯 30 秒後上傳筆記，並在頁面可見時每 5 分鐘檢查雲端變更；視窗聚焦與手動重新整理仍會立即拉取。可在 apps/web/src/lib/workspace-refresh.ts 中調整 DEFERRED_MEMO_SYNC_DELAY_MS 和 BACKGROUND_WORKSPACE_REFRESH_INTERVAL_MS。

贊助與支持

EdgeEver 是免費開源專案。保持跨平台用戶端（macOS、Windows、Linux、iOS、Android）的持續演進、真機測試、憑證簽章以及多執行時期生態建設，都需要長期的精力與資源投入。

致謝

  • EdgeEver 的筆記產品設計也參考了 Evernote（印象筆記）、Notion 等成熟筆記工具的公開產品體驗。相關功能由 EdgeEver 獨立設計與實作。
  • 心智圖與視覺化圖表筆記的產品設計參考了 XMind 和 ProcessOn 等圖表工具的公開產品體驗。相關功能由 EdgeEver 獨立設計與實作。
  • EdgeEver 的海報設計工作台借鑑了向阳乔木（joeseesun）的 Qiaomu Design，並基於其 MIT 開源授權改編了範本與字型排版引擎。

商標與品牌使用

EdgeEver 名稱、Logo 及其他品牌識別用於識別官方專案。Fork 或修改版可以說明其「基於 EdgeEver」，但不得暗示官方身分或誤導使用者。開源授權不授予商標權利；其他使用須事先取得專案維護者的書面許可。

免責聲明

EdgeEver 是一款完全獨立的開源筆記軟體，由個人和社群自主開發維護。本專案與 Evernote®（印象筆記）及其關聯公司不存在任何商業合作、授權、贊助或隸屬關係。

EdgeEver 是自行託管軟體。除官方展示實例外，專案維護者不託管、控制或審核使用者內容。實例中儲存或展示的內容由使用者或實例營運者負責，不代表專案維護者的立場。

Reference in new issue View Git Blame Copy Permalink