# WP-DEL 旧层删除与命名收口

日期：2026-05-01

## 目标

本轮 `WP-DEL` 只处理已被新主链完全替代的旧 HTTP contract、旧 route、旧前端 alias 和旧测试夹具，不新增业务能力，不恢复 `server-node` 兼容，不修改 SpacetimeDB 表结构。

## 已删除范围

1. Runtime Story 旧 HTTP DTO：
   - Rust `RuntimeStoryStateResolveRequest`
   - Rust/TS `RuntimeStoryBootstrapRequest/Response`
   - Rust/TS `RuntimeStoryActionResponse`
   - TS 泛型 `RuntimeActionRequest/Response`
   - 旧 `RuntimeStorySnapshotPayload` 只作为旧 HTTP 总入口快照结构删除；当前 story session scoped 写侧使用 `StoryRuntimeMutationResponse.projection`。
2. Runtime Story 前端旧命名：
   - `beginRpgRuntimeStorySession`
   - `resolveRpgRuntimeStoryAction`
   - `getRpgStoryRuntimeProjection`
   - `getRpgRuntimeActionSnapshot`
   - `rpgRuntimeStoryClient` 聚合对象
   - 其他 `Rpg*RuntimeStory*` alias 统一删除，前端只导出当前主链命名。
3. Custom World 旧非 runtime 前缀路由：
   - `POST /api/custom-world/entity`
   - `POST /api/custom-world/scene-npc`
   - `POST /api/custom-world/scene-image`
   - `POST /api/custom-world/cover-image`
   - `POST /api/custom-world/cover-upload`
   - 当前主链固定为 `/api/runtime/custom-world/*`。
4. Puzzle 旧本地下一关入口：
   - `POST /api/runtime/puzzle/runs/local-next-level`
   - Rust/TS `AdvanceLocalPuzzleNextLevelRequest`
   - API 层本地 next-level 拼装 helper 与对应旧测试。
5. `/generated-*` 资产直读代理：
   - `GET /generated-character-drafts/{*path}`
   - `GET /generated-characters/{*path}`
   - `GET /generated-animations/{*path}`
   - `GET /generated-big-fish-assets/{*path}`
   - `GET /generated-puzzle-assets/{*path}`
   - `GET /generated-custom-world-scenes/{*path}`
   - `GET /generated-custom-world-covers/{*path}`
   - `GET /generated-qwen-sprites/{*path}`
   - 旧 `api-server` 同源代理模块 `legacy_generated_assets.rs`
   - Vite 与发布静态服务器中的 `/generated-*` 直读转发配置。

## 保留边界

1. `/generated-*` 字符串仍可作为历史 DTO 与测试夹具里的 `legacyPublicPath` 标识，OSS object key 前缀和 `LegacyAssetPrefix` 继续保留；但浏览器、Vite、本地发布静态服务器和 `api-server` 不再提供 `/generated-*` 裸读入口。
2. 正式读取契约固定为 `asset_object`、`GET /api/assets/read-url`、`ResolvedAssetImage/useResolvedAssetReadUrl` 或业务投影里的签名读 URL 字段。
3. `RuntimeStoryActionRequest` 仍保留为 `module-runtime-story` 内部动作规则输入，不作为旧 HTTP route contract。
4. `RuntimeStoryViewModel`、`RuntimeStoryPresentation`、`RuntimeStoryPatch` 和 battle presentation 仍作为当前投影/表现构件保留，不再代表旧 `/api/runtime/story/*` 总入口响应。
5. 历史设计文档中对旧 route/DTO 的引用只作为时间点记录保留，不批量改写旧档案。

## 验收门禁

计划执行：

```powershell
cargo fmt --all --manifest-path server-rs\Cargo.toml
cargo fmt --all --check --manifest-path server-rs\Cargo.toml
npm.cmd run check:server-rs-ddd
cargo check --workspace --manifest-path server-rs\Cargo.toml
cargo test --workspace --exclude spacetime-module --manifest-path server-rs\Cargo.toml
npm.cmd run test -- src/services/rpg-runtime/rpgRuntimeStoryClient.test.ts src/hooks/rpg-runtime-story/runtimeStoryCoordinator.test.ts src/services/ai.test.ts src/services/puzzle-runtime
npm.cmd run check:encoding -- docs/technical/SERVER_RS_DDD_WP_DEL_CLEANUP_2026-05-01.md docs/technical/README.md docs/technical/SERVER_RS_DDD_G1_CONTRACT_AND_ROUTE_MATRIX_2026-04-29.md docs/technical/SERVER_RS_DDD_PARALLEL_TASKLIST_2026-04-29.md server-rs/crates/shared-contracts/README.md server-rs/crates/api-server/README.md server-rs/crates/module-puzzle/README.md
```

实际结果：

1. `cargo fmt --all --manifest-path server-rs\Cargo.toml`：通过。
2. `cargo fmt --all --check --manifest-path server-rs\Cargo.toml`：通过。
3. `npm.cmd run check:server-rs-ddd`：通过，15 个 module crate 边界检查通过。
4. `cargo check --workspace --manifest-path server-rs\Cargo.toml`：通过；仅保留既有 runtime chat prompt dead code warning。
5. `cargo test --workspace --exclude spacetime-module --manifest-path server-rs\Cargo.toml`：通过；`api-server` 207 个测试通过、4 个 live/外部依赖测试按既有条件忽略。
6. `npm.cmd run test -- src/services/rpg-runtime/rpgRuntimeStoryClient.test.ts src/hooks/rpg-runtime-story/runtimeStoryCoordinator.test.ts src/services/ai.test.ts src/services/puzzle-runtime`：通过，4 个测试文件 45 个用例通过。
7. `npm.cmd run check:encoding`：通过，全量 2816 个文件通过 UTF-8/乱码检查。
8. `npm.cmd run spacetime:generate -- --rust-only`：通过；SpacetimeDB CLI 在 Windows 长路径格式化阶段触发已知失败后，项目脚本使用短路径分批 `rustfmt` fallback 完成。
9. `cargo check -p spacetime-module --manifest-path server-rs\Cargo.toml`：通过。
10. `npm.cmd run api-server:maincloud`：通过；后端拉起后 `GET http://127.0.0.1:3100/healthz` 返回 `200 {"ok":true,"service":"genarrative-api-server"}`，随后已清理本次 smoke 进程并确认 3100 端口释放。启动期 Maincloud 订阅恢复出现两条 `503 Service Unavailable` 警告，不影响 healthz smoke。