WeKnora deployment source with the reviewed wiki identity, summary and recovery fixes

2026-09-22 16:19:06 +08:00
commit f7fc992f57
3929 changed files with 1006607 additions and 0 deletions
@@ -0,0 +1,14 @@
+# 旧系统迁移审计
+
+迁移前必须对旧 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，不覆盖已有租户数据。