AI-native knowledge base & Evernote/Obsidian alternative with instant sync & native MCP. Free on Cloudflare or self-hosted via Docker.
HTML ai-agentcloudflarecloudflare-d1cloudflare-r2cloudflare-workersdockerelectronevernoteevernote-alternativeknowledge-basemcpnote-takingobsidian-alternativeoffline-firstpersonal-knowledge-basepwaself-hostedsqlitetiptapweb-clipper
Limit Evernote import to ENEX
tianma8cc8704efc34
diff --git a/README.md b/README.mdindex 63106d4c..85299ea3 100644--- a/README.md+++ b/README.md@@ -171,7 +171,7 @@ bun run cli -- --profile prod search edgeeverbun run cli -- --profile prod export <memo-id> --format markdown --out ./memo.md```-自托管管理员或开发者从印象笔记迁移到 EdgeEver 时,可以按笔记本分别导出 `.notes` 或 `.enex` 文件,再使用 MCP 导入工具逐个笔记本确认结果。普通产品用户更适合使用应用内导入入口。详见:[从印象笔记迁移到 EdgeEver](docs/evernote-migration.md)。+从印象笔记迁移到 EdgeEver 时,请先准备开放、可读取的 ENEX 文件,再使用 PC 端应用内导入入口或命令行工具逐个笔记本确认导入结果。详见:[从印象笔记迁移到 EdgeEver](docs/evernote-migration.md)。## 图片压缩规则diff --git a/apps/web/src/components/EvernoteImportCard.tsx b/apps/web/src/components/EvernoteImportCard.tsxindex 1e12f39c..44f721ff 100644--- a/apps/web/src/components/EvernoteImportCard.tsx+++ b/apps/web/src/components/EvernoteImportCard.tsx@@ -48,7 +48,7 @@ export const EvernoteImportCard = () => {const parsed = await parseEvernoteExportFiles(files);if (parsed.length === 0) {- throw new Error("请选择 .notes 或 .enex 文件。");+ throw new Error("请选择 .enex 文件。");}setNotebooks(parsed);@@ -135,7 +135,7 @@ export const EvernoteImportCard = () => {导入印象笔记</CardTitle><CardDescription className="text-xs leading-4">- 按笔记本选择 .notes 或 .enex 文件,EdgeEver 会逐个笔记本导入并保留原始创建、修改时间。+ 按笔记本选择 .enex 文件,EdgeEver 会逐个笔记本导入并保留原始创建、修改时间。</CardDescription></CardHeader><CardContent className="space-y-4 p-4 pt-0">@@ -153,7 +153,7 @@ export const EvernoteImportCard = () => {ref={inputRef}className="hidden"type="file"- accept=".notes,.enex"+ accept=".enex"multipleonChange={(event) => void handleFilesChange(event)}/>diff --git a/apps/web/src/lib/evernote-import.ts b/apps/web/src/lib/evernote-import.tsindex 726e9fab..21977cca 100644--- a/apps/web/src/lib/evernote-import.ts+++ b/apps/web/src/lib/evernote-import.ts@@ -33,7 +33,7 @@ export const parseEvernoteExportFiles = async (files: File[]): Promise<EvernoteIexport const isSupportedEvernoteExportFile = (file: File) => {const normalized = file.name.toLowerCase();- return normalized.endsWith(".notes") || normalized.endsWith(".enex");+ return normalized.endsWith(".enex");};const parseEvernoteXml = (xml: string, fileName: string): EvernoteImportNote[] => {@@ -123,11 +123,11 @@ const evernoteContentToMarkdown = (content: string) => {const assertReadableEvernoteXml = (xml: string, fileName: string) => {if (/encoding\s*=\s*["']base64:aes["']/i.test(xml)) {- throw new Error(`${fileName} 是加密 .notes 文件,EdgeEver 不能直接读取其中内容。请改用未加密导出、HTML 导出,或先转换为可读的 ENEX/Markdown。`);+ throw new Error(`${fileName} 不是 EdgeEver 支持的 ENEX 文件。请先导出或转换为 .enex 后再导入。`);}- if (!/<en-export[\s>]/i.test(xml) || !/<note[\s>]/i.test(xml)) {- throw new Error(`${fileName} 看起来不是可读取的印象笔记 XML 导出文件。`);+ if (!fileName.toLowerCase().endsWith(".enex") || !/<en-export[\s>]/i.test(xml) || !/<note[\s>]/i.test(xml)) {+ throw new Error(`${fileName} 看起来不是可读取的 ENEX 文件。`);}};@@ -164,6 +164,6 @@ const enexDateToIso = (value: string) => {const notebookNameFromFile = (fileName: string) =>fileName- .replace(/\.(notes|enex)$/i, "")+ .replace(/\.enex$/i, "").trim().slice(0, 80) || "Evernote Import";diff --git a/docs/evernote-migration.md b/docs/evernote-migration.mdindex 460a313e..0d7659a4 100644--- a/docs/evernote-migration.md+++ b/docs/evernote-migration.md@@ -1,128 +1,89 @@# 从印象笔记迁移到 EdgeEver-本文档说明如何把印象笔记笔记按笔记本逐个迁移到 EdgeEver。迁移工具通过 EdgeEver MCP 写入数据,适合需要可检查、可暂停、可回滚节奏的迁移场景。+EdgeEver 的印象笔记导入功能只支持开放、可读取的 ENEX 文件。EdgeEver 不直接支持印象笔记新版客户端导出的 `.notes` 文件。-普通产品用户可以直接在 EdgeEver Web 应用的 PC 端设置页中导入,不需要克隆 EdgeEver 源码仓库。仓库内脚本主要面向自托管管理员、开发者和需要命令行批处理的高级用户。+这样做是为了降低迁移风险:ENEX 是可解析的 XML 格式,可以读取标题、正文、标签、创建时间和修改时间;新版 `.notes` 可能包含加密内容,EdgeEver 无法可靠验证其中数据。-## 迁移前准备+## 准备 ENEX 文件-如果你是普通产品用户,请在电脑浏览器中打开 EdgeEver,进入左侧“个人中心 / 我的”,使用“导入印象笔记”入口。移动端不开放该入口,因为 `.notes` 文件通常较大,且逐笔记本确认更适合 PC 操作。+如果你的印象笔记客户端仍能直接导出 ENEX,可以按笔记本分别导出 `.enex` 文件。-1. 在 EdgeEver 左侧设置里创建一个 API Token。-2. Token 至少需要这些 scopes:- - `read:notebooks`- - `write:notebooks`- - `write:memos`-3. 在印象笔记客户端中按笔记本分别导出 `.notes` 文件。如果你的客户端仍支持 `.enex`,也可以使用 `.enex`。-4. 把所有 `.notes` 或 `.enex` 文件放到同一个目录,文件名会作为 EdgeEver 笔记本名称,例如:+如果客户端只能导出 `.notes`,可以参考第三方命令行工具 `evernote-backup` 先导出 ENEX:-```text-evernote-export/- 工作项目.notes- 学习资料.notes- 生活记录.notes+```sh+pipx install evernote-backup+evernote-backup init-db --backend china+evernote-backup sync+evernote-backup export ./edgeever-import```-建议一次只迁移一个账号的数据。迁移前保留原始 `.notes` / `.enex` 文件,不要在导入完成前删除印象笔记中的原笔记。+说明:++- `--backend china` 用于连接印象笔记中国版。+- `sync` 会把账号里的笔记同步到本地数据库。+- `export ./edgeever-import` 会导出 ENEX 文件。+- `evernote-backup` 默认会按笔记本导出,一个笔记本对应一个 `.enex` 文件。++请把生成的 `.enex` 文件放在一个容易找到的目录中。文件名会作为 EdgeEver 导入时的目标笔记本名称。## 在 Web 应用中导入1. 在电脑浏览器中打开 EdgeEver。2. 进入左侧“个人中心 / 我的”。3. 找到“导入印象笔记”。-4. 选择一个或多个 `.notes` / `.enex` 文件。+4. 选择一个或多个 `.enex` 文件。5. 检查导入计划中的笔记本数量和笔记数量。6. 点击“开始导入”。7. 每导完一个笔记本,先在 EdgeEver 中检查结果,再点击“确认结果,继续下一个”。-Web 导入会强制校验时间字段:如果导出文件中某条笔记缺少合法的创建时间或更新时间,导入会停止;如果 EdgeEver 创建后的 `createdAt` 或 `updatedAt` 与印象笔记原始时间不一致,导入也会停止并显示对应笔记标题。+移动端不开放导入入口。ENEX 文件通常较大,逐笔记本确认也更适合 PC 操作。-## 使用命令行脚本+## 时间校验-命令行脚本适合自托管管理员或开发者批量处理迁移。普通产品用户优先使用上面的 Web 导入入口。+EdgeEver 会强制保留印象笔记原始创建时间和修改时间:-本节命令需要在 EdgeEver 项目源码目录中运行,并且本机已经安装 Bun。这是当前自托管/开发者迁移工具的要求,不是长期面向普通用户的理想交互。+- 如果 ENEX 中某条笔记缺少合法的创建时间或修改时间,导入会停止。+- 如果 EdgeEver 创建后的 `createdAt` 或 `updatedAt` 与 ENEX 原始时间不一致,导入会停止并显示对应笔记标题。-可以直接使用环境变量:+## 命令行导入-```sh-EDGEEVER_URL=https://你的域名 \-EDGEEVER_TOKEN=<api-token> \-bun run import:evernote -- --input ./evernote-export --dry-run-```+仓库内也提供命令行脚本,主要面向自托管管理员、开发者和需要批处理的高级用户。普通产品用户优先使用 Web 导入入口。-也可以先保存为本机 profile:+先配置 EdgeEver 连接:```shbun run cli -- profile set prod --url https://你的域名 --token <api-token>-bun run import:evernote -- --profile prod --input ./evernote-export --dry-run```-## 先生成导入计划--正式导入前先 dry-run:--```sh-bun run import:evernote -- --profile prod --input ./evernote-export --dry-run-```--检查输出里的笔记本数量、笔记数量和导出文件路径是否符合预期。如果发现笔记本名称不对,先修改导出文件名再重新 dry-run。--如果 dry-run 提示 `encoding="base64:aes"`,说明这个 `.notes` 文件是印象笔记加密导出文件,EdgeEver 不能直接读取其中内容。此时不要正式导入,改用未加密导出、HTML 导出,或使用可信的备份/转换工具先转换为可读的 ENEX/Markdown,并确认转换结果仍保留原始创建时间和更新时间。+API Token 至少需要这些 scopes:-## 正式导入+- `read:notebooks`+- `write:notebooks`+- `write:memos`-确认计划无误后执行:+先生成导入计划:```sh-bun run import:evernote -- --profile prod --input ./evernote-export+bun run import:evernote -- --profile prod --input ./edgeever-import --dry-run```-导入流程会按文件名排序逐个处理笔记本:--1. 如果 EdgeEver 已有同名根笔记本,工具会复用它。-2. 如果没有同名根笔记本,工具会创建新笔记本。-3. 工具逐条创建笔记,并保留标题、Markdown 内容、标签、创建时间和更新时间。-4. 每导完一个笔记本,工具会输出本次创建条数和该笔记本的计数变化。-5. 你需要打开 EdgeEver 检查结果,然后在终端输入 `yes` 才会继续下一个笔记本。--如果检查结果不符合预期,不要输入 `yes`。工具会停止,已经导入的笔记会保留在 EdgeEver 中,方便你先检查或手动清理。--迁移工具会强制校验时间字段:如果导出文件中某条笔记缺少合法的创建时间或更新时间,导入会停止;如果 EdgeEver 创建后的 `createdAt` 或 `updatedAt` 与印象笔记原始时间不一致,导入也会停止并显示对应笔记标题。--## 无人值守导入--如果已经在测试环境验证过,也可以跳过每个笔记本后的确认:+确认计划无误后正式导入:```sh-bun run import:evernote -- --profile prod --input ./evernote-export --yes+bun run import:evernote -- --profile prod --input ./edgeever-import```-不建议第一次迁移时使用 `--yes`。--## 附件和图片说明--当前迁移工具主要迁移笔记文本内容、标题、标签和时间。印象笔记导出文件中的图片和附件会被转换成 `evernote-resource:<hash>` 形式的占位链接,便于后续定位原始资源。--建议处理方式:--1. 先完成文本迁移,确认笔记数量和主要内容无误。-2. 保留原始 `.notes` / `.enex` 文件作为附件来源。-3. 对重要笔记中的图片或附件,后续可通过 EdgeEver 的资源上传能力补传到对应笔记。+命令行脚本也会按 ENEX 文件逐个笔记本导入,每导完一个笔记本后等待确认。## 常见问题-### 导入中断了怎么办?--重新运行同一条命令即可。工具会复用同名根笔记本,但不会自动去重已经导入过的笔记。为了避免重复,建议先在 EdgeEver 中检查最后一个已导入笔记本,必要时手动清理后再继续。--### 为什么要求一个笔记本一个导出文件?+### EdgeEver 为什么不直接支持 `.notes`?-印象笔记导出文件本身不稳定携带原始笔记本层级。用“一个笔记本一个导出文件”的方式,可以让文件名成为明确的目标笔记本名称,也方便每导完一个笔记本后人工确认。+印象笔记新版 `.notes` 文件可能包含 `encoding="base64:aes"` 加密内容。EdgeEver 无法可靠读取和校验这类文件,因此产品层面只承诺支持 ENEX。-### 能保留印象笔记的创建和更新时间吗?+### 附件和图片会怎样?-必须保留。迁移工具会读取导出文件中的 `created` 和 `updated` 字段,并通过 EdgeEver MCP 写入 `createdAt` 和 `updatedAt`。工具还会在每条笔记创建后校验 EdgeEver 返回的时间;只要创建时间或更新时间不一致,就会停止导入,避免继续写入有问题的数据。+当前导入主要迁移文本内容、标题、标签和时间。ENEX 中的图片和附件会被转换成 `evernote-resource:<hash>` 形式的占位链接,便于后续定位原始资源。### 笔记格式会完全一致吗?diff --git a/scripts/import-evernote-enex-via-mcp.mjs b/scripts/import-evernote-enex-via-mcp.mjsindex 3a84c514..f6a34c12 100644--- a/scripts/import-evernote-enex-via-mcp.mjs+++ b/scripts/import-evernote-enex-via-mcp.mjs@@ -2,7 +2,7 @@import { createInterface } from "node:readline/promises";import { stdin as input, stdout as output } from "node:process";-import { readdir, readFile } from "node:fs/promises";+import { readdir, readFile, stat } from "node:fs/promises";import { basename, extname, join } from "node:path";import { homedir } from "node:os";import { XMLParser } from "fast-xml-parser";@@ -12,7 +12,7 @@ const CONFIG_PATH = process.env.EDGEEVER_CONFIG || join(homedir(), ".edgeever",const DEFAULT_URL = "http://127.0.0.1:8787";const options = parseOptions(process.argv.slice(2));-const usage = `Import Evernote ENEX/NOTES files into EdgeEver through MCP.+const usage = `Import Evernote ENEX files into EdgeEver through MCP.Usage:EDGEEVER_URL=https://your.edgeever.host EDGEEVER_TOKEN=... \\@@ -21,7 +21,7 @@ Usage:bun scripts/import-evernote-enex-via-mcp.mjs --profile prod --input ./evernote-export --dry-runOptions:- --input <path> ENEX/NOTES file or a directory containing one export file per notebook.+ --input <path> ENEX file or a directory containing one ENEX file per notebook.--profile <name> Read URL and token from ~/.edgeever/config.json.--dry-run Parse and print the plan without writing to EdgeEver.--yes Import all notebooks without interactive confirmations.@@ -51,7 +51,7 @@ async function main() {const notebooks = await readEnexNotebooks(inputPath);if (notebooks.length === 0) {- throw new Error(`No .enex or .notes files found: ${inputPath}`);+ throw new Error(`No .enex files found: ${inputPath}`);}printPlan(notebooks);@@ -140,8 +140,8 @@ async function listEnexFiles(path) {return [path];}- if (path.toLowerCase().endsWith(".notes")) {- return [path];+ if ((await stat(path)).isFile()) {+ throw new Error(`${path} is not an .enex file.`);}const entries = await readdir(path, { withFileTypes: true });@@ -170,13 +170,13 @@ async function parseEnex(filePath) {function isSupportedExportFile(filePath) {const normalized = filePath.toLowerCase();- return normalized.endsWith(".enex") || normalized.endsWith(".notes");+ return normalized.endsWith(".enex");}function assertReadableEvernoteXml(xml, filePath) {if (/encoding\s*=\s*["']base64:aes["']/i.test(xml)) {throw new Error(- `${filePath} is an encrypted .notes export (encoding="base64:aes"). EdgeEver cannot import encrypted NOTES files because Yinxiang has not published the decryption key. Export an unencrypted NOTES/ENEX file, export HTML, or use a trusted backup/export tool that can produce ENEX/Markdown with original timestamps.`+ `${filePath} is not a supported ENEX file. Export or convert your notes to .enex before importing.`);}