2.6 KiB
2.6 KiB
Maincloud 残留引用移除策略
背景
项目后端、发布和本地联调已经切到 server-rs + Axum + SpacetimeDB 当前基线，并以本地或显式配置的 SpacetimeDB 服务为运行目标。历史上用于连接 SpacetimeDB Maincloud 的脚本、环境变量、测试名和文档口径已经不再代表当前工程约束。
决策
maincloud/Maincloud/MAINCLOUD相关命名、脚本、测试、环境变量、文档要求和启动命令全部视为历史残留。- 后续禁止新增、运行或引用
maincloud相关代码、测试、脚本、文档要求、环境变量和命令。 - 旧文档若要求执行
npm run api-server:maincloud、npm.cmd run api-server:maincloud或读取GENARRATIVE_SPACETIME_MAINCLOUD_*，一律以本策略和AGENTS.md最新约束为准，并在触碰该文档或代码时同步修正。 - 后端 API smoke 统一使用当前非 Maincloud 启动入口：
npm run api-server。服务就绪以GET /healthz返回成功为准。 - SpacetimeDB 运行目标必须来自本地开发服务、生产自托管服务，或显式
SERVER_URL配置；不得再回退到 Maincloud 默认值。
落地规则
- 修改后端代码后，按对应 DDD 文档执行定向测试；涉及 API smoke 时执行
npm run api-server并探测/healthz。 - 触碰历史脚本、测试支撑或文档时，优先删除或改名其中的
maincloud口径，改为当前本地或显式服务配置口径。 - 新增文档不得把
api-server:maincloud写成验收命令，也不得要求配置GENARRATIVE_SPACETIME_MAINCLOUD_*。 - 新增测试不得使用
DEFAULT_MAINCLOUD_*这类历史命名；测试辅助应使用通用api-server、healthz或明确的本地 SpacetimeDB 命名。 - 如需保留历史文档中的旧执行记录，只能作为归档事实存在，不得作为当前执行清单、验收命令或开发约束继续引用。
验证方式
常规检查：
rg -n "maincloud|Maincloud|MAINCLOUD|api-server:maincloud|GENARRATIVE_SPACETIME_MAINCLOUD" AGENTS.md docs .hermes package.json scripts server-rs -S
验收口径：
AGENTS.md、.hermes/shared-memory/和当前任务相关文档不得要求使用 Maincloud。- 活跃脚本、测试和配置不得依赖
GENARRATIVE_SPACETIME_MAINCLOUD_*。 - 后端启动和 smoke 以
npm run api-server与/healthz为准。