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
Simplify Evernote guide source
tianma1da019ec54e2
diff --git a/README.md b/README.mdindex 85299ea3..6e2c7e48 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 时,请先准备开放、可读取的 ENEX 文件,再使用 PC 端应用内导入入口或命令行工具逐个笔记本确认导入结果。详见:[从印象笔记迁移到 EdgeEver](docs/evernote-migration.md)。+从印象笔记迁移到 EdgeEver 时,请先准备开放、可读取的 ENEX 文件,再使用 PC 端应用内“导入印象笔记”入口逐个笔记本确认导入结果。入口旁的“操作指引”会在新标签页打开迁移步骤。## 图片压缩规则diff --git a/apps/web/src/components/EvernoteImportGuidePane.tsx b/apps/web/src/components/EvernoteImportGuidePane.tsxindex 1d6174c2..bd1e1359 100644--- a/apps/web/src/components/EvernoteImportGuidePane.tsx+++ b/apps/web/src/components/EvernoteImportGuidePane.tsx@@ -1,6 +1,7 @@import { ChevronLeft, Download, HelpCircle, UploadCloud } from "lucide-react";import type { ReactNode } from "react";import { Button } from "@/components/ui/button";+import { EVERNOTE_MIGRATION_GUIDE, type MigrationGuideStep } from "@/lib/evernote-migration-guide";export const EvernoteImportGuidePane = ({ onClose }: { onClose: () => void }) => (<div className="flex h-full min-h-0 min-w-0 flex-col overflow-x-hidden bg-slate-50">@@ -9,8 +10,8 @@ export const EvernoteImportGuidePane = ({ onClose }: { onClose: () => void }) =><Buttonsize="icon"variant="ghost"- title="返回我的"- aria-label="返回我的"+ title="返回"+ aria-label="返回"onClick={onClose}className="h-9 w-9 rounded-lg hover:bg-slate-100">@@ -19,9 +20,9 @@ export const EvernoteImportGuidePane = ({ onClose }: { onClose: () => void }) =><div className="min-w-0"><h1 className="flex items-center gap-2 text-base font-bold leading-tight text-slate-900"><HelpCircle className="h-4 w-4 text-emerald-700" />- 印象笔记迁移指引+ {EVERNOTE_MIGRATION_GUIDE.title}</h1>- <p className="mt-0.5 truncate text-xs font-medium text-slate-400">先导出 ENEX,再回 EdgeEver 导入</p>+ <p className="mt-0.5 truncate text-xs font-medium text-slate-400">{EVERNOTE_MIGRATION_GUIDE.subtitle}</p></div></div></header>@@ -29,76 +30,57 @@ export const EvernoteImportGuidePane = ({ onClose }: { onClose: () => void }) =><main className="min-w-0 flex-1 overflow-x-hidden overflow-y-auto px-4 py-4 lg:px-6 lg:py-6"><article className="mx-auto grid w-full min-w-0 max-w-4xl gap-4"><section className="rounded-lg border border-emerald-100 bg-white p-5 shadow-none">- <h2 className="text-lg font-bold text-slate-950">最省事的迁移方式</h2>- <p className="mt-3 text-sm leading-6 text-slate-600">- EdgeEver 只导入 .enex 文件。先用 evernote-backup 从印象笔记导出 ENEX,再回到这里选择文件导入。- </p>+ <h2 className="text-lg font-bold text-slate-950">{EVERNOTE_MIGRATION_GUIDE.introTitle}</h2>+ {EVERNOTE_MIGRATION_GUIDE.intro.map((paragraph) => (+ <p key={paragraph} className="mt-3 text-sm leading-6 text-slate-600">+ {paragraph}+ </p>+ ))}</section>- <GuideStep- index="1"- icon={<Download className="h-4 w-4" />}- title="用 evernote-backup 导出 ENEX"- >- <p>在电脑终端执行下面几行命令:</p>- <GuideCode>{`pipx install evernote-backup-evernote-backup init-db --backend china-evernote-backup sync-evernote-backup export ./edgeever-import`}</GuideCode>- <p>完成后,当前目录会出现 <code>edgeever-import</code> 文件夹,里面是一批 .enex 文件。通常一个笔记本对应一个 .enex 文件。</p>- <p>只想导出部分笔记本时,可以在最后一行加上笔记本名:</p>- <GuideCode>{`evernote-backup export ./edgeever-import --notebook "工作项目"`}</GuideCode>- </GuideStep>-- <GuideStep- index="2"- icon={<UploadCloud className="h-4 w-4" />}- title="回到 EdgeEver 导入"- >- <ol className="list-decimal space-y-1 pl-5">- <li>回到“我的”页面里的“导入印象笔记”。</li>- <li>点击“选择文件”,选择 <code>edgeever-import</code> 里的 .enex 文件。</li>- <li>确认导入计划里的笔记本数量和笔记数量。</li>- <li>点击“开始导入”。</li>- <li>每导完一个笔记本,先检查结果,再点击“确认结果,继续下一个”。</li>- </ol>- </GuideStep>-- <GuideStep index="3" icon={<HelpCircle className="h-4 w-4" />} title="如果遇到问题">- <ul className="list-disc space-y-1 pl-5">- <li>EdgeEver 只支持 .enex,不支持印象笔记新版 .notes。</li>- <li>如果导入中断,先检查最后一个已导入的笔记本,避免重复导入。</li>- <li>EdgeEver 会校验原始创建时间和修改时间;时间不一致时会停止导入。</li>- <li>图片和附件当前会保留为资源占位链接,重要附件建议迁移后抽查。</li>- </ul>- </GuideStep>+ {EVERNOTE_MIGRATION_GUIDE.steps.map((step) => (+ <GuideStep key={`${step.index}-${step.title}`} step={step} />+ ))}</article></main></div>);-const GuideStep = ({- index,- icon,- title,- children,-}: {- index: string;- icon: ReactNode;- title: string;- children: ReactNode;-}) => (+const GuideStep = ({ step }: { step: MigrationGuideStep }) => (<section className="rounded-lg border border-slate-200 bg-white p-5 text-sm leading-6 text-slate-700 shadow-none"><div className="mb-3 flex items-center gap-3"><div className="flex h-8 w-8 shrink-0 items-center justify-center rounded-lg bg-emerald-50 text-emerald-700">- {icon}+ {getStepIcon(step.index)}</div><div className="min-w-0">- <div className="text-xs font-bold text-slate-400">步骤 {index}</div>- <h2 className="text-base font-bold text-slate-950">{title}</h2>+ <div className="text-xs font-bold text-slate-400">步骤 {step.index}</div>+ <h2 className="text-base font-bold text-slate-950">{step.title}</h2></div></div>- <div className="space-y-3">{children}</div>+ <div className="space-y-3">+ {step.paragraphs?.map((paragraph) => (+ <p key={paragraph}>+ <RichText text={paragraph} />+ </p>+ ))}++ {step.commands?.map((command) => (+ <div key={`${command.label}-${command.code}`} className="space-y-2">+ <div className="text-sm font-bold text-slate-900">{command.label}</div>+ <GuideCode>{command.code}</GuideCode>+ </div>+ ))}++ {step.list && (+ <ul className="list-disc space-y-1 pl-5">+ {step.list.map((item) => (+ <li key={item}>+ <RichText text={item} />+ </li>+ ))}+ </ul>+ )}+ </div></section>);@@ -107,3 +89,31 @@ const GuideCode = ({ children }: { children: string }) => (<code>{children}</code></pre>);++const RichText = ({ text }: { text: string }) => {+ const pieces = text.split(/(`[^`]+`)/g);++ return (+ <>+ {pieces.map((piece, index) =>+ piece.startsWith("`") && piece.endsWith("`") ? (+ <code key={`${piece}-${index}`}>{piece.slice(1, -1)}</code>+ ) : (+ <span key={`${piece}-${index}`}>{piece}</span>+ )+ )}+ </>+ );+};++const getStepIcon = (index: string): ReactNode => {+ if (index === "1" || index === "1.1") {+ return <Download className="h-4 w-4" />;+ }++ if (index === "2") {+ return <UploadCloud className="h-4 w-4" />;+ }++ return <HelpCircle className="h-4 w-4" />;+};diff --git a/apps/web/src/lib/evernote-migration-guide.ts b/apps/web/src/lib/evernote-migration-guide.tsnew file mode 100644index 00000000..00b8575a--- /dev/null+++ b/apps/web/src/lib/evernote-migration-guide.ts@@ -0,0 +1,91 @@+export type MigrationGuideCommand = {+ label: string;+ language: "sh" | "powershell";+ code: string;+};++export type MigrationGuideStep = {+ index: string;+ title: string;+ paragraphs?: string[];+ commands?: MigrationGuideCommand[];+ list?: string[];+};++export const EVERNOTE_MIGRATION_GUIDE = {+ title: "印象笔记迁移指引",+ subtitle: "先导出 ENEX,再回 EdgeEver 导入",+ introTitle: "最省事的迁移方式",+ intro: [+ "EdgeEver 只导入 .enex 文件。先用 evernote-backup 从印象笔记导出 ENEX,再回到这里选择文件导入。",+ ],+ steps: [+ {+ index: "1",+ title: "用 evernote-backup 导出 ENEX",+ paragraphs: ["根据你的电脑系统选择一组命令执行。"],+ commands: [+ {+ label: "macOS / Linux",+ language: "sh",+ code: `pipx install evernote-backup+evernote-backup init-db --backend china+evernote-backup sync+evernote-backup export ./edgeever-import`,+ },+ {+ label: "Windows PowerShell",+ language: "powershell",+ code: `py -m pip install --user pipx+py -m pipx ensurepath+pipx install evernote-backup+evernote-backup init-db --backend china+evernote-backup sync+evernote-backup export .\\edgeever-import`,+ },+ ],+ list: [+ "如果 Windows 执行 `py -m pipx ensurepath` 后提示修改了 PATH,请关闭并重新打开 PowerShell,再继续执行后面的命令。",+ "完成后,当前目录会出现 `edgeever-import` 文件夹,里面是一批 `.enex` 文件。通常一个笔记本对应一个 `.enex` 文件。",+ "只想导出部分笔记本时,可以在最后一行加上笔记本名。",+ ],+ },+ {+ index: "1.1",+ title: "只导出部分笔记本",+ commands: [+ {+ label: "macOS / Linux",+ language: "sh",+ code: `evernote-backup export ./edgeever-import --notebook "工作项目"`,+ },+ {+ label: "Windows PowerShell",+ language: "powershell",+ code: `evernote-backup export .\\edgeever-import --notebook "工作项目"`,+ },+ ],+ },+ {+ index: "2",+ title: "回到 EdgeEver 导入",+ list: [+ "回到“我的”页面里的“导入印象笔记”。",+ "点击“选择文件”,选择 `edgeever-import` 里的 `.enex` 文件。",+ "确认导入计划里的笔记本数量和笔记数量。",+ "点击“开始导入”。",+ "每导完一个笔记本,先检查结果,再点击“确认结果,继续下一个”。",+ ],+ },+ {+ index: "3",+ title: "如果遇到问题",+ list: [+ "EdgeEver 只支持 `.enex`,不支持印象笔记新版 `.notes`。",+ "如果导入中断,先检查最后一个已导入的笔记本,避免重复导入。",+ "EdgeEver 会校验原始创建时间和修改时间;时间不一致时会停止导入。",+ "图片和附件当前会保留为资源占位链接,重要附件建议迁移后抽查。",+ ],+ },+ ] satisfies MigrationGuideStep[],+};diff --git a/docs/evernote-migration.md b/docs/evernote-migration.mddeleted file mode 100644index 0d7659a4..00000000--- a/docs/evernote-migration.md+++ /dev/null@@ -1,90 +0,0 @@-# 从印象笔记迁移到 EdgeEver--EdgeEver 的印象笔记导入功能只支持开放、可读取的 ENEX 文件。EdgeEver 不直接支持印象笔记新版客户端导出的 `.notes` 文件。--这样做是为了降低迁移风险:ENEX 是可解析的 XML 格式,可以读取标题、正文、标签、创建时间和修改时间;新版 `.notes` 可能包含加密内容,EdgeEver 无法可靠验证其中数据。--## 准备 ENEX 文件--如果你的印象笔记客户端仍能直接导出 ENEX,可以按笔记本分别导出 `.enex` 文件。--如果客户端只能导出 `.notes`,可以参考第三方命令行工具 `evernote-backup` 先导出 ENEX:--```sh-pipx install evernote-backup-evernote-backup init-db --backend china-evernote-backup sync-evernote-backup export ./edgeever-import-```--说明:--- `--backend china` 用于连接印象笔记中国版。-- `sync` 会把账号里的笔记同步到本地数据库。-- `export ./edgeever-import` 会导出 ENEX 文件。-- `evernote-backup` 默认会按笔记本导出,一个笔记本对应一个 `.enex` 文件。--请把生成的 `.enex` 文件放在一个容易找到的目录中。文件名会作为 EdgeEver 导入时的目标笔记本名称。--## 在 Web 应用中导入--1. 在电脑浏览器中打开 EdgeEver。-2. 进入左侧“个人中心 / 我的”。-3. 找到“导入印象笔记”。-4. 选择一个或多个 `.enex` 文件。-5. 检查导入计划中的笔记本数量和笔记数量。-6. 点击“开始导入”。-7. 每导完一个笔记本,先在 EdgeEver 中检查结果,再点击“确认结果,继续下一个”。--移动端不开放导入入口。ENEX 文件通常较大,逐笔记本确认也更适合 PC 操作。--## 时间校验--EdgeEver 会强制保留印象笔记原始创建时间和修改时间:--- 如果 ENEX 中某条笔记缺少合法的创建时间或修改时间,导入会停止。-- 如果 EdgeEver 创建后的 `createdAt` 或 `updatedAt` 与 ENEX 原始时间不一致,导入会停止并显示对应笔记标题。--## 命令行导入--仓库内也提供命令行脚本,主要面向自托管管理员、开发者和需要批处理的高级用户。普通产品用户优先使用 Web 导入入口。--先配置 EdgeEver 连接:--```sh-bun run cli -- profile set prod --url https://你的域名 --token <api-token>-```--API Token 至少需要这些 scopes:--- `read:notebooks`-- `write:notebooks`-- `write:memos`--先生成导入计划:--```sh-bun run import:evernote -- --profile prod --input ./edgeever-import --dry-run-```--确认计划无误后正式导入:--```sh-bun run import:evernote -- --profile prod --input ./edgeever-import-```--命令行脚本也会按 ENEX 文件逐个笔记本导入,每导完一个笔记本后等待确认。--## 常见问题--### EdgeEver 为什么不直接支持 `.notes`?--印象笔记新版 `.notes` 文件可能包含 `encoding="base64:aes"` 加密内容。EdgeEver 无法可靠读取和校验这类文件,因此产品层面只承诺支持 ENEX。--### 附件和图片会怎样?--当前导入主要迁移文本内容、标题、标签和时间。ENEX 中的图片和附件会被转换成 `evernote-resource:<hash>` 形式的占位链接,便于后续定位原始资源。--### 笔记格式会完全一致吗?--不会完全一致。工具会把印象笔记的 XHTML 内容转换为 Markdown,再交给 EdgeEver 保存。常规标题、段落、列表、代码块、链接和待办项会尽量保留;复杂表格、加密块、特殊样式和附件需要迁移后抽查。