# 旧系统迁移审计

迁移前必须对旧 SQLite 做只读校验。执行：

```sh
LEGACY_DB_PATH="/Volumes/Extreme SSD/yawan-storage/yawan-workbench/server/data/workspace.db" \
  ./scripts/legacy_migration_audit.sh > /tmp/legacy-migration-audit.json
```

脚本只执行 `PRAGMA integrity_check`、文件哈希和业务表计数，不会修改源库，也不会写入 WeKnora。生产旧库当前盘点为 6 个用户、6 个知识库、62 个文件、215,587 个片段、63 个分类、15 个 Agent、9 个技能、39 个技能绑定、3 个画布、2 个任务。数字人和微信渠道为空；点数账户 3 个、交易 797 条。

首批导入顺序：用户/租户映射、知识库、分类、源文件；文件进入原生对象存储后，使用原生解析和索引流程重新生成分块、向量和图谱。旧 Agent、技能、画布和任务先导出为只读归档，待原生模块逐项映射后再导入。旧密码哈希和 API key 不迁移，用户需要重新设置凭据。

每批导入必须记录 `source_id -> native_id` 映射、成功/失败计数和可重试游标。验收通过前保留旧库和源文件的只读快照；回滚只删除本次导入批次的 native ID，不覆盖已有租户数据。