chore: remove maincloud configuration

docs/technical/SPACETIMEDB_JSON_STRING_MIGRATION_PROCEDURE_2026-04-27.md

@@ -13,7 +13,7 @@ SpacetimeDB reducer 必须保持确定性，不能访问文件系统和网络。
 
 procedure 不再访问 HTTP 文件桥，也不接收部署机本地文件路径。这样可以避开 SpacetimeDB 对 private/special-purpose 地址的 HTTP 访问限制，并避免把 private 表内容通过临时 HTTP 服务转发。
 
-SpacetimeDB Wasm 运行环境不支持 `std::time::SystemTime::now()`，procedure 或 reducer 内需要当前时间时必须使用 `ctx.timestamp`。如果共享 crate 同时服务前端/本地纯逻辑与 SpacetimeDB 模块，应提供 `*_at(now_ms)` 或显式时间参数版本，SpacetimeDB 模块只调用注入时间的函数，避免发布后在 maincloud 触发 `time not implemented on this platform` panic。
+SpacetimeDB Wasm 运行环境不支持 `std::time::SystemTime::now()`，procedure 或 reducer 内需要当前时间时必须使用 `ctx.timestamp`。如果共享 crate 同时服务前端/本地纯逻辑与 SpacetimeDB 模块，应提供 `*_at(now_ms)` 或显式时间参数版本，SpacetimeDB 模块只调用注入时间的函数，避免发布后触发 `time not implemented on this platform` panic。
 
 `spacetime login show --token` 输出的是 CLI 登录 token，不是 HTTP `/v1/database/.../call` 所需的数据库连接 token。导入脚本如果没有显式传 `--token`，会自动调用 `POST /v1/identity` 获取 Web API token；迁移时不要把 CLI token 传给 `--token`。
 
@@ -41,17 +41,13 @@ SpacetimeDB Wasm 运行环境不支持 `std::time::SystemTime::now()`，procedur
 
 运维流程：
 
-```bash
-npm run spacetime:publish:maincloud -- --database <database>
-# 控制台会输出：
-# [spacetime:maincloud] 迁移引导密钥: <本次发布随机密钥>
-```
+本地开发发布时，`npm run dev:rust` 会在发布模块前输出本次随机生成的迁移引导密钥。发布包部署时，`npm run deploy:rust:remote` 会把同一份密钥写入发布包根目录的 `migration-bootstrap-secret.txt`，目标服务器执行 `./start.sh` 发布 wasm 时也会再次显示该密钥。
 
 发布完成后，在同一台机器上用当前 `spacetime login` 身份授权操作员：
 
 ```bash
 node scripts/spacetime-authorize-migration-operator.mjs \
-  --server maincloud \
+  --server dev \
   --database xushi-p4wfr \
   --bootstrap-secret <本次发布随机密钥> \
   --operator-identity <identity-hex> \
@@ -62,7 +58,7 @@ node scripts/spacetime-authorize-migration-operator.mjs \
 
 ```bash
 node scripts/spacetime-revoke-migration-operator.mjs \
-  --server maincloud \
+  --server dev \
   --database xushi-p4wfr \
   --operator-identity <identity-hex>
 ```
@@ -71,9 +67,8 @@ node scripts/spacetime-revoke-migration-operator.mjs \
 
 ### 发布脚本密钥行为
 
-当前所有会构建或发布 `spacetime-module` 的脚本默认都会生成并显示迁移引导密钥：
+当前会构建或发布 `spacetime-module` 的脚本默认都会生成并显示迁移引导密钥：
 
-- `npm run spacetime:publish:maincloud`：在本机 `cargo build` 前生成密钥，控制台输出 `[spacetime:maincloud] 迁移引导密钥: ...`。
 - `npm run dev:rust`：在本地 `spacetime publish --module-path` 前生成密钥，控制台输出 `[dev:rust] 迁移引导密钥: ...`。
 - `npm run deploy:rust:remote`：在构建发布包 wasm 前生成密钥，控制台输出 `[deploy:rust] 迁移引导密钥: ...`，并把同一份密钥写入发布包根目录的 `migration-bootstrap-secret.txt`。服务器执行 `./start.sh` 发布 wasm 时也会再次显示该文件里的密钥。
 
@@ -145,11 +140,11 @@ Node 导入脚本默认在文件超过 `524288` bytes 时使用分片导入；
 
 ### 发布冲突自动迁移
 
-`npm run spacetime:publish:maincloud` 默认采用冲突感知发布：
+Ubuntu 发布包的 `start.sh` 默认采用冲突感知发布：
 
 1. 先不清库发布新 wasm。
 2. 如果发布成功，流程结束。
-3. 如果发布失败且输出可判定为 schema 冲突，脚本自动导出旧库迁移 JSON 到 `tmp/spacetime-migrations/maincloud/<database>/<timestamp>.json`。
+3. 如果发布失败且输出可判定为 schema 冲突，脚本自动导出旧库迁移 JSON 到 `database-migrations/<database>/<timestamp>.json` 或 `GENARRATIVE_SPACETIME_MIGRATION_DIR` 指定目录。
 4. 导出成功后执行清库发布新 wasm。
 5. 新 wasm 发布成功后，把第 3 步导出的 JSON 自动导入回灌。
 
@@ -159,15 +154,11 @@ SpacetimeDB 2.1 对 schema 冲突的报错文案可能不再包含 `schema confl
 
 任一阶段失败都会中止流程，并保留已经导出的迁移 JSON。非 schema 冲突的发布失败不会进入迁移流程。
 
-```bash
-npm run spacetime:publish:maincloud -- --database xushi-p4wfr
-```
-
 可选参数：
 
-- `--no-migrate-on-conflict`：禁用冲突自动迁移，只保留原始发布失败。
-- `--migration-dir <dir>`：指定迁移 JSON 输出目录。
-- `--clear-database`：显式清库发布；该模式代表人工确认清库，不触发自动迁移。
+- `GENARRATIVE_SPACETIME_MIGRATE_ON_CONFLICT=false`：禁用冲突自动迁移，只保留原始发布失败。
+- `GENARRATIVE_SPACETIME_MIGRATION_DIR=<dir>`：指定迁移 JSON 输出目录。
+- `./start.sh --clear-database`：显式清库发布；该模式代表人工确认清库，不触发自动迁移。
 
 冲突自动迁移需要发布脚本本次生成的 `GENARRATIVE_SPACETIME_MIGRATION_BOOTSTRAP_SECRET`。因此不要和 `--no-migration-bootstrap-secret` 同时使用。
 
@@ -237,7 +228,7 @@ node scripts/spacetime-export-migration-json.mjs \
 
 ```bash
 node scripts/spacetime-authorize-migration-operator.mjs \
-  --server maincloud \
+  --server dev \
   --database xushi-p4wfr \
   --bootstrap-secret <服务器目标库发布时输出的随机密钥> \
   --operator-identity <服务器 spacetime login show 中的 identity> \
@@ -248,7 +239,7 @@ node scripts/spacetime-authorize-migration-operator.mjs \
 
 ```bash
 node scripts/spacetime-import-migration-json.mjs \
-  --server maincloud \
+  --server dev \
   --database xushi-p4wfr \
   --bootstrap-secret <服务器目标库发布时输出的随机密钥> \
   --in tmp/spacetime-migrations/source-2026-04-27.json
@@ -258,7 +249,7 @@ node scripts/spacetime-import-migration-json.mjs \
 
 ```bash
 node scripts/spacetime-import-migration-json.mjs \
-  --server maincloud \
+  --server dev \
   --database xushi-p4wfr \
   --bootstrap-secret <服务器目标库发布时输出的随机密钥> \
   --in tmp/spacetime-migrations/source-2026-04-27.json \
@@ -298,7 +289,7 @@ node scripts/spacetime-export-migration-json.mjs \
   --include ai_task,ai_task_stage,ai_text_chunk,ai_result_reference
 ```
 
-`--server` 支持 `dev`、`local`、`maincloud`，也可以直接传 SpacetimeDB 服务器 URL。导出、授权、撤销默认走 `spacetime call`，使用当前机器的 CLI 登录态；导入默认走 Web API request body，避免大 JSON 触发命令行长度限制。数据库名可通过 `--database`、`GENARRATIVE_SPACETIME_MAINCLOUD_DATABASE` 或 `GENARRATIVE_SPACETIME_DATABASE` 提供。
+`--server` 支持 `dev`、`local`，也可以直接传 SpacetimeDB 服务器 URL。导出、授权、撤销默认走 `spacetime call`，使用当前机器的 CLI 登录态；导入默认走 Web API request body，避免大 JSON 触发命令行长度限制。数据库名可通过 `--database` 或 `GENARRATIVE_SPACETIME_DATABASE` 提供。
 
 授权脚本额外支持：
 
@@ -319,7 +310,7 @@ node scripts/spacetime-export-migration-json.mjs \
 - 拼图：`puzzle_agent_session`、`puzzle_agent_message`、`puzzle_work_profile`、`puzzle_runtime_run`
 - 大鱼：`big_fish_creation_session`、`big_fish_agent_message`、`big_fish_asset_slot`
 
-`big_fish_runtime_run` 当前运行态已由前端本地运行服务承接，不再加入迁移白名单；但 maincloud 旧库仍可能存在该表。为避免热升级被 “Removing the table big_fish_runtime_run requires a manual migration” 阻断，模块发布期可以保留兼容空壳表，后续确认旧数据可丢弃后再走正式删除表迁移。
+`big_fish_runtime_run` 当前运行态已由前端本地运行服务承接，不再加入迁移白名单；但旧库仍可能存在该表。为避免热升级被 “Removing the table big_fish_runtime_run requires a manual migration” 阻断，模块发布期可以保留兼容空壳表，后续确认旧数据可丢弃后再走正式删除表迁移。
 
 后续新增 SpacetimeDB 表时，必须同步把表加入迁移白名单与本文档。