Genarrative/docs/technical/SPACETIMEDB_CLOUD_CONFIG_REMOVAL_2026-05-02.md

SpacetimeDB 云端配置移除记录

日期：2026-05-02

1. 目标

当前项目不再使用旧云端 SpacetimeDB 目标，仓库内不再保留云端专用配置、脚本入口和文档默认口径。后续开发、迁移、Jenkins 流水线与后台验证均以本地或显式传入的 SpacetimeDB 服务为准。

2. 入口调整

1. 根工程后端单独启动入口统一为：

npm run api-server

2. 该入口读取 .env、.env.local 与当前进程环境中的 GENARRATIVE_SPACETIME_*，默认服务地址回落到 http://127.0.0.1:3101。
3. 已移除旧云端发布入口和脚本。SpacetimeDB 模块发布继续通过本地联调脚本、发布包 start.sh 或显式 spacetime publish --server <server-url> 执行。

3. 环境变量口径

api-server、迁移脚本和 Jenkins 部署脚本只使用以下运行变量：

GENARRATIVE_SPACETIME_SERVER_URL
GENARRATIVE_SPACETIME_DATABASE
GENARRATIVE_SPACETIME_TOKEN

旧云端专用变量不再作为兼容回退读取。需要连接其它 SpacetimeDB 服务时，必须显式设置 GENARRATIVE_SPACETIME_SERVER_URL 或在脚本参数中传入 --server-url。

4. 迁移脚本口径

1. scripts/spacetime-migration-common.mjs 默认 server 为本地 dev，解析到 http://127.0.0.1:3101。
2. 授权、撤销、导出等 CLI 调用会显式传 -s，避免落回机器上的 SpacetimeDB CLI 默认服务。
3. Jenkins 数据库导入导出流水线默认 SERVER=dev，需要操作其它目标时必须显式填写 SERVER_URL。

5. 后续约束

1. 新增 SpacetimeDB 运维脚本时，不允许把云端服务写成默认值。
2. 文档中的验证命令统一使用 npm run api-server。
3. 如果某次任务需要连接非本地 SpacetimeDB，必须在文档和验证记录中写清楚实际 SERVER_URL、数据库名和身份来源；除 CI/CD 脚本内部受控用法外，不再把 --root-dir 写入人工命令。