如何将 Heptabase 数据一键导入 Flexnote

更换笔记工具时，真正的成本往往不在学习新界面，而在历史数据能否完整迁移。 若用户已在 Heptabase 中积累大量卡片、白板、PDF 高亮、日记与标签，并用于文献整理或长期研究，从空白工作区重新开始通常并不可行。

Flexnote 现已支持直接读取本机 Heptabase 数据（hepta.db 或 Backup），并按空间完成一键导入。 用户可为每个 Heptabase 空间创建对应的 Flexnote 工作空间，也可将所选内容写入当前工作空间；再次导入时可选择跳过或覆盖。 导入过程仅读取源数据，不会修改、删除或移动原有 Heptabase 文件。

支持导入的内容范围

本功能并非仅复制正文文本。Flexnote 会扫描本机 Heptabase 数据，并按内容类型进行结构化转换。当前主要支持以下内容：

导入前须知：主要转换规则

需基于本机数据库，而非仅依赖导出 JSON

当前版本支持从本机 hepta.db 或 Backup 目录导入。若仅持有 all-data.json 等导出文件、且缺少对应数据库，则暂无法完整还原白板结构与附件路径。 桌面端将尽可能自动检测本机 Heptabase；若未能识别，亦可手动选择 Backup 目录。

白板按结构转换，而非截图迁移

白板上的卡片实例、分组（Section）、文本元素、媒体、PDF、脑图节点与连线均按类型转换。 连线将尽可能保留路径类型、箭头、颜色，以及连线上的富文本标签。 由于 Heptabase 与 Flexnote 的画布模型并不完全一致，对于复杂嵌套分组、特定颜色语义或特殊节点，建议导入后抽检常用白板。

PDF 高亮与笔记高亮分别映射

PDF 中的文本高亮与区域高亮将导入至 PDF 阅读器，颜色与位置尽可能对齐原文；卡片正文中的高亮标记将转换为 Flexnote 的笔记高亮，并保留关联笔记。导入完成后，建议核对若干含高亮的 PDF 与笔记，确认显示效果与跳转是否符合预期。

卡片高度沿用 Heptabase 记录尺寸

两款产品在内容边距与默认字号上存在差异。为降低白板上卡片重叠的风险， 导入时将沿用 Heptabase 记录的卡片高度，并关闭自动高度。 导入完成后，用户仍可在 Flexnote 中手动调整，或重新开启高度自适应。

操作步骤

第一步：打开导入入口并检测本机 Heptabase

在 Flexnote 侧栏打开导入窗口，选择「Heptabase」。 桌面端将尝试读取本机数据；检测成功后会显示版本号，以及各空间的笔记、白板、日记与标签数量。 若未能自动识别，可点击「选择 Backup」指定目录，或执行「重新检测」。

第二步：选择空间与写入目标

勾选待导入的 Heptabase 空间，并选择写入目标：

• 为每个空间新建工作空间：最接近原有空间结构，适用于完整迁移。若免费版仅支持单个工作空间，需升级后再按空间分别导入。
• 导入到当前工作空间：将所选空间内容写入当前已打开的工作空间，适用于单课题迁移或小规模验证。

第三步：开始导入并核验结果

点击开始导入后将显示进度。完成后会汇总新建的笔记、日记、白板、PDF、高亮、脑图、属性、视图与附件数量。 建议随后核验：常用白板、含双链或 mention 的笔记、含高亮的 PDF，以及带标签的日记。

二次导入与去重策略

默认情况下不会重复创建已导入对象。Flexnote 会记录源对象与目标对象的对应关系。再次导入同一批内容时，可选择：

• 跳过已有：保留用户已在 Flexnote 中修改过的版本，仅补充尚未导入的内容，适用于日常增量迁移。
• 覆盖更新：以 Heptabase 当前内容更新已有项，并同步白板上的新增内容。使用前请确认 Flexnote 中不存在仅存在于本地、且需保留的重要修改。

建议的迁移流程

1. 备份 Heptabase 数据（或确认 Backup 可用），并备份 Flexnote 数据；
2. 优先选择同时包含笔记、白板与 PDF 的较小空间进行试导入；
3. 核验白板布局、连线标签、PDF 高亮颜色，以及卡片 mention / 双链；
4. 确认无误后，再导入其余空间；
5. 后续增量导入优先使用「跳过已有」；确需以 Heptabase 为准同步时，再选择「覆盖更新」。

导入功能旨在降低数据迁移成本，并不要求用户立即中断既有工作方式。 用户可先迁移正在推进的课题白板，在 Flexnote 中继续使用本地优先白板、多媒体标注与一次性买断方案； 亦可在完成完整迁移后，将 Heptabase 作为只读归档保留一段时间。 建议先以真实业务数据的小规模样本完成验证，再决定后续迁移范围。