feat(开发脚本): dev:all 支持 --clear-database 并提示本地库 schema 冲突

默认仍写死 --preserve-database（不改默认行为）；显式 --clear-database 时不再传它、逐字透传 dev.mjs 既有语义；根栈因 manual migration / Reordering table 失败时补一段可操作提示（打印库名与 data dir、两条出路、清库会丢数据的警告），提示文案抽成纯函数并补单测；文档补一句
2026-10-06 19:41:36 +08:00
parent 78c1f6ee13
commit bde909315e
3 changed files with 123 additions and 10 deletions
@@ -100,7 +100,7 @@ npm run dev
 npm run dev:all
 ```

-`npm run dev:all` 保持 `npm run dev` 的主站完整栈语义不变，使用 AGC 当前配套后端的数据库 `genarrative-game-creator-dev` 与 data dir `server-rs/.spacetimedb/ai-game-creator/data` 启动一份 SpacetimeDB、BgFilter worker、api-server、主站 Vite 和后台 Vite；待这五个服务就绪后，再启动 AGC Vite 与 Tauri。AGC 通过匹配的 `.app/dev-stack.json` 复用这份后端，且设置 `AGC_DEV_ADMIN_WEB=0`，因此一键入口只保留一份管理后台。该入口不接受覆盖 database 或 SpacetimeDB data dir 的参数；需要独立数据库时分别使用 `npm run dev` / `npm run agc`。
+`npm run dev:all` 保持 `npm run dev` 的主站完整栈语义不变，使用 AGC 当前配套后端的数据库 `genarrative-game-creator-dev` 与 data dir `server-rs/.spacetimedb/ai-game-creator/data` 启动一份 SpacetimeDB、BgFilter worker、api-server、主站 Vite 和后台 Vite；待这五个服务就绪后，再启动 AGC Vite 与 Tauri。AGC 通过匹配的 `.app/dev-stack.json` 复用这份后端，且设置 `AGC_DEV_ADMIN_WEB=0`，因此一键入口只保留一份管理后台。该入口不接受覆盖 database 或 SpacetimeDB data dir 的参数；需要独立数据库时分别使用 `npm run dev` / `npm run agc`。默认会**保留**这个本地库（等价于给根栈传 `--preserve-database`），因此当库内 schema 与源码不一致（SpacetimeDB 报 `needs manual migration` / `Reordering table …`）时 publish 会被拒、根栈随之退出——此时终端会补一段可操作提示（说明是本地 schema 冲突、打印目标库与 data dir），按提示用 `npm run dev:all -- --clear-database` 清掉该本地库重建，或先跑一次不带 `--preserve-database` 的 `npm run dev -- --database genarrative-game-creator-dev --spacetime-data-dir server-rs/.spacetimedb/ai-game-creator/data`；两种做法都会丢弃该本地库里的数据（仅本地开发数据）。

 一键入口由自身负责收束根 dev 栈与 AGC 客户端的进程树。AGC Vite marker 可访问后，终端会打印包含 SpacetimeDB、BgFilter worker、api-server、主站、后台、AGC Vite 和 Tauri 窗口的实际地址表；任一子进程异常退出都应停止另一侧并返回非零退出码。端口漂移和运行态地址仍以启动日志及 `.app/dev-stack.json` 为准。