add import script from notion

2026-04-19 14:28:00 +02:00
parent bda23909bf
commit ef058765de
5 changed files with 605 additions and 0 deletions
@@ -393,3 +393,50 @@ python -m pytest
 - 全局搜索 name / note
 - 创建后的重定向行为
 - 关键页面结构和 UX 文案
+
+## 一次性 Notion 导入
+
+项目内附带了一个一次性迁移脚本：
+
+```bash
+python scripts/import_notion.py --dry-run
+python scripts/import_notion.py --apply
+```
+
+说明：
+
+- 这是一次性 migration / import 工具，不是长期同步功能
+- 运行时会交互要求输入：
+  - Notion API token
+  - Notion 页面完整 URL
+- `--dry-run` 只读取和解析，不写数据库
+- `--apply` 会真正写入当前 SQLite 数据库
+- 建议导入前先备份 `data/app.db`
+
+### 当前支持的 Notion 结构映射
+
+- `heading_2` -> `Box`
+- 某个 `heading_2` 下的一级 bullet -> `Item`
+- 如果一级 bullet 下还有二级 bullet：
+  - 一级 bullet -> 容器型 `Item`
+  - 二级 bullet -> `SubItem`
+
+当前最大只处理到这个层级：
+
+```text
+heading_2
+└── 一级 bullet
+    └── 二级 bullet
+```
+
+更深层级会在日志中提示，但不会继续扩展成无限树。
+
+### 这一版不导入图片
+
+这一版导入脚本：
+
+- 不下载图片
+- 不导入图片
+- 遇到图片或其他媒体 block 时会提示已跳过
+
+图片后续可以在应用里手动补录。