# 旧库迁入

分三个阶段，把原来的 Obsidian 笔记库渐进地迁入 FLO.W：两个库并行、旧库放进 FLO.W、逐篇整理。

Canonical: https://21obsidian.com/docs/vault-migration
Markdown: https://21obsidian.com/docs/vault-migration.mdx
Site index for AI: https://21obsidian.com/llms.txt









<img alt="执行迁移前，请务必、一定、肯定、确定已经备份好笔记库" src={__img0} placeholder="blur" />

**迁移前请务必先备份笔记库**，包括原来的笔记库和 FLO.W 笔记库。最简单的做法是把整个笔记库文件夹复制一份，放到别的位置保存，迁移中出现问题时，可以用备份恢复。

FLO.W 需要作为一个独立的笔记库使用，不能放进你原来的笔记库或它的子文件夹里。FLO.W Core 要从笔记库的根目录找到主页、笔记、任务等预设文件夹，放进子文件夹后，自动路由就无法正常工作。反过来，把原来的笔记放进 FLO.W 是可以的。

## 迁移的三个阶段 {#stages}

迁移不需要一次完成，可以跟着使用节奏，分三个阶段慢慢推进：

1. **两个库并行**：在 FLO.W 里记录新内容，先熟悉它的规则
2. **把旧库放进 FLO.W**：在一个库里同时查看新旧内容
3. **逐篇整理，清空旧库**：把旧笔记整理成 FLO.W 的笔记、任务和项目

不论在哪个阶段，**都建议先小范围验证**：先拿一个文件夹或几篇笔记试一试，确认链接、附件和属性都正常，再处理剩下的内容。

不必走完三个阶段，停在任何一个阶段都可以，比如一直保持两个库并行，也没有问题。

## 阶段一：两个库并行 {#parallel}

FLO.W Obsidian 解压后是一个独立的笔记库。点击 Obsidian 左下角的笔记库名字，可以在两个库之间切换。

也可以让两个库同时打开：点击左下角的笔记库名字，选择「管理仓库…」，在弹出的窗口中打开另一个库，它会在新窗口里打开，两个窗口可以并排使用。

这个阶段，新内容都在 FLO.W 里记录，旧笔记需要时回原来的库查看。

用了一段时间后，如果你希望在一个库里搜索旧笔记，或者想在新笔记里链接到旧笔记，就可以进入下一个阶段。

## 阶段二：把旧库放进 FLO.W {#whole-vault}

<img alt="原来的笔记库放进 FLO.W Obsidian 文件夹" src={__img1} placeholder="blur" />

1. 备份原来的笔记库和 FLO.W 笔记库
2. 把原来的笔记库文件夹整个复制到 FLO.W Obsidian 文件夹的根目录。不要把里面的子文件夹拆出来单独复制，否则名字是「笔记」「任务」的文件夹会和 FLO.W 的预设文件夹冲突，一不小心就会覆盖 FLO.W 的文件夹，或者混进里面
3. 原来笔记库文件夹的名字，不能和根目录已有的文件夹重复：主页、笔记、任务、项目、领域、信息、工具、Inbox
4. 在 Obsidian 里打开 FLO.W Obsidian 这个文件夹本身，不要打开它的上一层
5. 打开几篇旧笔记抽查，看双链、图片和附件是否正常。有问题就删掉复制进来的这个文件夹，原来的笔记库不受影响，处理好后再复制

放好之后，FLO.W Obsidian 文件夹里的结构是这样的：

```text
FLO.W Obsidian  ← 在 Obsidian 里直接打开这一层
├─ 主页
├─ 笔记
├─ 任务
├─ 项目
├─ 领域
├─ 信息
├─ 工具
├─ Inbox
└─ 旧的笔记库 XX  ← 原来的笔记库，整个放在这里
```

不一定要新建分区。如果迁入了几个笔记库，或者还有从其他软件导出的内容，可以为每个来源新建一个分区，分别放进去，在文件列表里一眼就能分清，参见 [新建分区](/docs/file-directory#create-section)。

<img alt="不同来源的旧内容各放一个自定义分区" src={__img2} placeholder="blur" />

复制进来之后，需要注意这几点：

* **原来笔记里的内链有可能失效**，比如附件放在原来的笔记库以外、和 FLO.W 有同名的笔记，或者用了插件特有的链接写法，所以复制进来后要先抽查几篇
* 用到插件的笔记，要在 FLO.W 里装好对应的插件才能正常显示
* 原来笔记库里的 `.obsidian` 文件夹不会生效，原来的插件、主题和设置，需要在 FLO.W 里重新安装和配置。不要用原来的 `.obsidian` 覆盖 FLO.W 的配置，也不要删除 FLO.W「工具」文件夹里的文件
* **同名笔记会让双链指错**。如果原来的库里有和 FLO.W 同名的笔记，`[[笔记名]]` 可能会打开另一篇，复制前先检查一下同名文件，把其中一篇改名

## 阶段三：逐篇整理，清空旧库 {#one-by-one}

**建议在熟悉 FLO.W 的运行逻辑之后，再进入这个阶段。** 先弄清楚笔记、任务、项目各自放什么，以及笔记类型、状态和关联的用法，整理时才不会放错位置。

同样先从几篇笔记开始，确认属性和链接都正常后再继续。用到哪篇旧笔记，就趁这个时候把它整理进 FLO.W。在 Obsidian 的文件列表里，把它拖进 FLO.W 对应的文件夹，自动路由会按文件夹写入笔记属性：

* 拖进「笔记」下的类型文件夹，比如「笔记/Ref」，写入 `FLO.W: Note` 和对应的笔记类型
* 拖进「任务」或「项目」，写入对应的类型，状态为 `Doing`；已经完成的，拖进它们下面的「已完成」
* 笔记原有的其他属性会保留，但原来的状态会按文件夹改写，比如状态是「完成」的笔记拖进「任务」，会变成 `Doing`
* 其他笔记里指向它的双链，会自动更新到新位置

<img alt="旧笔记拖进「任务」后的笔记属性" src={__img3} placeholder="blur" />

整理好的笔记，可以再 [关联](/docs/relation-resolution) 到对应的领域或项目。领域不能通过拖动创建，需要在 FLO.W 面板「动作 → 新建」中点击 [创建领域](/docs/area-management#create-area)。

不常打开的旧笔记，可以等用到时再整理，不必专门腾出时间一次处理完。旧文件夹清空后把它删掉，如果为它建过分区，也一起删掉，迁移就完成了。