Skip to content

AI-native knowledge base & Evernote/Obsidian alternative with instant sync & native MCP. Free on Cloudflare or self-hosted via Docker.

Simplify Evernote guide source

tianma1da019ec54e2
diff --git a/README.md b/README.md
index 85299ea3..6e2c7e48 100644
--- a/README.md
+++ b/README.md
@@ -171,7 +171,7 @@ bun run cli -- --profile prod search edgeever
bun 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.tsx
index 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 }) =>
<Button
size="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.ts
new file mode 100644
index 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.md
deleted file mode 100644
index 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 保存。常规标题、段落、列表、代码块、链接和待办项会尽量保留;复杂表格、加密块、特殊样式和附件需要迁移后抽查。