核心原则

<aside> ⚠️ 数据永不丢失 > 操作效率 > 功能实现

</aside>

1. 备份优先原则

• 任何批量操作前，必须自动备份
• 备份文件：~/notion_backup_{数据库名}_{日期}.json
• 备份后验证：检查记录数量、关键字段完整性

2. 增量更新原则（关键！）

<aside> 🚨 只添加新选项，禁止重建整个选项列表！

错误做法：重新创建 multi_select 的完整 options 数组 → 会导致已有标签丢失 正确做法：查询现有选项，追加新选项后再更新

</aside>

3. 单记录更新原则

• 优先使用单条记录 PATCH，而非批量重建
• 每次只更新一个字段，避免连锁反应

4. 危险操作清单（需二次确认）

• [ ] 删除字段
• [ ] 修改字段类型
• [ ] 重建选择/多选选项列表
• [ ] 批量更新多条记录

5. 数据恢复预案

1. 立即停止后续操作
2. 从备份文件恢复数据
3. 对比丢失前后的差异