# SpacetimeDB 云端配置移除记录

日期：`2026-05-02`

## 1. 目标

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

## 2. 入口调整

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

```bash
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 部署脚本只使用以下运行变量：

```text
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`、数据库名和 root-dir。