diff --git a/README.md b/README.md index d4418eee..6a0b3b1f 100644 --- a/README.md +++ b/README.md @@ -216,6 +216,7 @@ EdgeEver avoids Worker-side image processing to reduce compute and image-process If you want to migrate notes from other platforms to EdgeEver, please refer to the following simple migration guides: - **Evernote Migration**: Please refer to [docs/evernote-migration-guide.md](docs/evernote-migration-guide.md) +- **flomo Migration**: Please refer to [docs/flomo-migration-guide.md](docs/flomo-migration-guide.md) - **Memos Migration**: Please refer to [docs/memos-migration-guide.md](docs/memos-migration-guide.md) - **Notion Migration**: Please refer to [docs/notion-migration-guide.md](docs/notion-migration-guide.md) diff --git a/apps/api/src/index.ts b/apps/api/src/index.ts index 4e3d6b6a..81d3233c 100644 --- a/apps/api/src/index.ts +++ b/apps/api/src/index.ts @@ -3055,7 +3055,7 @@ const handleMcpMessage = async (c: AppContext, payload: unknown): Promise !data.draft)).sort( - (a, b) => b.data.publishDate.getTime() - a.data.publishDate.getTime(), + (a, b) => Number(b.slug === "evernote-migration-guide") - Number(a.slug === "evernote-migration-guide") + || b.data.publishDate.getTime() - a.data.publishDate.getTime(), ); const locale = getSiteLocale(Astro.url.pathname); diff --git a/apps/site/src/pages/en/blog.astro b/apps/site/src/pages/en/blog.astro index ac72bf32..bbd13f1e 100644 --- a/apps/site/src/pages/en/blog.astro +++ b/apps/site/src/pages/en/blog.astro @@ -6,7 +6,8 @@ import { getFormattedDate } from "@/utils/all"; import { getLocalizedPath, getSiteLocale, siteCopy } from "@/i18n"; const entries = (await getCollection("blog_en", ({ data }) => !data.draft)).sort( - (a, b) => b.data.publishDate.getTime() - a.data.publishDate.getTime(), + (a, b) => Number(b.slug === "evernote-migration-guide") - Number(a.slug === "evernote-migration-guide") + || b.data.publishDate.getTime() - a.data.publishDate.getTime(), ); const locale = getSiteLocale(Astro.url.pathname); diff --git a/docs/flomo-migration-guide.en-US.md b/docs/flomo-migration-guide.en-US.md new file mode 100644 index 00000000..662d7e68 --- /dev/null +++ b/docs/flomo-migration-guide.en-US.md @@ -0,0 +1,23 @@ +# flomo Migration Guide + +[简体中文](flomo-migration-guide.md) | [English](flomo-migration-guide.en-US.md) + +The migration does not require flomo Max or flomo MCP. Export all notes as HTML with flomo's user-facing export, then let an AI Agent with the configured **EdgeEver MCP** import them idempotently. Give the export to an Agent that supports local files and MCP, then send one prompt. + +### Step 1: Export flomo + +In the flomo Web app or desktop client, click the small arrow next to your username and membership badge in the upper-left corner. Open **Settings → Account details** from the account menu, scroll the Account details pane to the very bottom, and download the full HTML export ZIP. Keep the ZIP directory structure unchanged. + +### Step 2: Configure EdgeEver MCP + +Generate a token with memo, notebook, and resource read/write permissions in **EdgeEver Settings → API & MCP authorization**. Click **Copy full MCP config** and configure it in Codex, Claude Code, Cursor, or another AI Agent. + +### Step 3: Import with one prompt + +Replace `/path/to/flomo-export.zip` with the real path, then send the entire prompt below to the Agent connected to EdgeEver MCP: + +```text +Using the configured EdgeEver MCP, migrate every note in `/path/to/flomo-export.zip` into the `flomo` notebook while preserving content, tags, creation times, images, and attachments. Verify completeness and report the result when finished. +``` + +Keep the original flomo ZIP until verification is complete. diff --git a/docs/flomo-migration-guide.md b/docs/flomo-migration-guide.md new file mode 100644 index 00000000..a5291636 --- /dev/null +++ b/docs/flomo-migration-guide.md @@ -0,0 +1,23 @@ +# flomo 笔记迁移指引 + +[简体中文](flomo-migration-guide.md) | [English](flomo-migration-guide.en-US.md) + +迁移不需要 flomo Max 或 flomo MCP。使用 flomo 面向所有用户提供的 HTML 全量导出,再由已经配置好的 **EdgeEver MCP** 幂等导入即可。整个迁移只需把导出文件交给支持本地文件与 MCP 的 AI Agent,然后发送一条 Prompt。 + +### 步骤 1:导出 flomo + +在 flomo 网页版或桌面客户端中,点击左上角用户名及会员标识右侧的小下拉箭头,在账户菜单中进入 **设置 → 账号详情**,然后滚动账号详情内容区到页面最下方,点击全局导出并下载 HTML 导出 ZIP。请勿修改或重新打包 ZIP 内的目录结构。 + +### 步骤 2:配置 EdgeEver MCP + +在 EdgeEver 的 **设置 → API & MCP 授权** 中生成具有笔记、笔记本和资源读写权限的 Token,点击 **复制完整 MCP 配置**,并将其配置到 Codex、Claude Code、Cursor 等 AI Agent 中。 + +### 步骤 3:发送一条 Prompt 完成导入 + +把下面的 `/path/to/flomo-export.zip` 替换成真实路径,然后将整段 Prompt 发送给已经连接 EdgeEver MCP 的 Agent: + +```text +请通过已配置的 EdgeEver MCP,将 `/path/to/flomo-export.zip` 中的全部笔记迁移到 `flomo` 笔记本,完整保留正文、标签、创建时间、图片和附件。迁移完成后校验完整性并报告结果。 +``` + +确认迁移完整前,请保留原始 flomo ZIP。