群晖 NoteStation 批量迁移到思源笔记完整教程：从 nsx 导出到 Markdown 导入

我有一台群晖NAS，在 NoteStation 中积累了大量笔记。近期希望将笔记迁移到思源笔记（SiYuan Note），利用 AI 辅助知识管理。

目前已知的开源方案是 Note-Station-to-markdown，可以将 NoteStation 的 nsx 导出文件转换为 Markdown 格式。但实测发现，思源笔记默认不支持目录导入，且转换后的图片附件路径需要重新整理。

本文记录完整的迁移解决方案，包含插件安装和附件目录结构整理。

登录群晖 DSM 的 Web 管理界面，打开 NoteStation 程序，直接导出为 nsx 文件。

注意事项： 必须通过 DSM Web 端进行导出。Windows 客户端导出功能存在缺陷，会导致部分笔记丢失。

转换脚本依赖 Python 3.10，版本过高会导致兼容性问题。

下载地址：

安装时记得勾选 "Add Python 3.10 to PATH"，不然命令行执行还得指定完整路径。

克隆或下载转换脚本：

复制代码

git clone https://github.com/Maboroshy/Note-Station-to-markdown.git

备用下载链接（Github 不可用时）：转化脚本

解压后在当前目录打开终端，执行：

bash 复制代码

py .\nsx2md.py 20260710_235436_25265_obear.nsx

参数说明：

复制代码

- `py`：Python 可执行程序（PATH 已配置时的简写形式）
- `nsx2md.py`：转换脚本入口
- `20260710_235436_25265_obear.nsx`：从 NoteStation 导出的 nsx 文件

跑完之后，当前目录下会生成多个以笔记本名称命名的文件夹，以及一个 assets 目录。

将所有笔记本文件夹移动至同一临时目录，供后续步骤使用。

思源笔记默认仅支持导入 xx.zip 和 xxx.sy.zip 格式，不支持目录导入。

需要从集市（插件市场）安装 "导入工具" 插件：

打开插件详情页，点击左侧"安装"按钮进行安装。

安装完成后，在集市中启用该插件。

思源笔记的工作空间结构如下：

复制代码

conf：工作空间配置
corrupted：损坏的数据文件
data：数据文件
history：文件历史
repo：数据仓库
temp：运行时临时文件
.lock：内核进程启动后锁定工作空间

笔记文件存储在 D:/SiYuan/data，assets 子目录存放图片和附件。

转换后的笔记中，图片路径为 assets/xxxxxxx.png。

尝试直接将 md 笔记和 assets 目录复制到 D:/SiYuan/data/assets 后，发现所有图片均无法显示。原因是思源笔记的图片引用路径需要与笔记文件保持相对关系。

解决方案：使用脚本工具整理目录结构，确保每个笔记的图片存放在该笔记同级的 assets 目录中。

我让 Hermes AI 助手帮忙处理目录整理，任务描述如下：

复制代码

任务：整理笔记
数据说明：
assets：图片和附件目录。其他同级目录为笔记文件夹。

任务要求：
1. 遍历每个笔记文件夹，按笔记名称建文件夹，把笔记移进去
2. 每个笔记里的图片 ![](assets/xxx.png)，把图片拷到笔记所在目录的assets下

处理完之后，每个笔记目录下包含独立的 assets 子目录。

在思源笔记中新建一个笔记本，右键 → 导入 → Markdown 文件夹。

选择整理好的目录进行导入。导入完成后，笔记以文档-子文档的形式嵌套排列。

全部笔记导入成功，文本和图片均可正常显示。

整个迁移流程分为五个步骤：

关键注意事项：