suzmii
47b5a17f54
origin/master = e6933762d（落后 106 提交）；合并前本分支 HEAD = 1612ee944。
冲突只有 5 处，codex 区域 0 冲突。
M 桶（master 改过的文件 → 取 master 版本，不把我们的删除加回去）：
- agent/codex_app_server/**（mod.rs、model_catalog.rs、model_catalog/auth_handoff.rs、real_tests.rs）、
agent/codex_cli.rs、agent/codex_provider_proxy.rs、build_support/codex_bundle.rs 均与新 master 逐字节相同。
其中 real_tests.rs / codex_bundle.rs / direct_project_identity.rs 一并取 master 版本，清掉了本分支先前
在这几个文件里留下的多余 diff（口径：codex 区域一行不删不改）。
- 唯一保留的 codex 侧差异是 codex_app_server/mod.rs 的 1 行：resolve_direct_codex_project_authority
的 `pub(super)` → `pub(in crate::agent)`。挂载到 codex_provider 后 `pub(super)` 对兄弟模块
direct_tools_mcp.rs 不可见（E0603），这是收敛必需的适配，不是清理残留。
D 桶（master 未动过、我们删的死码 → 保留删除）：patchset.rs、git_inspect.rs、
process_session/{io,lifecycle,persistence,recovery}.rs、generation/pass_artifacts.rs、
agent/runtime_models.rs、debug.rs(+debug/debug_drafts.rs)、process_session/tests/owner_fixture_cleanup.rs 等。
⚠ 复核发现 D 清单里 3 个文件本轮被 master 改过（`git log a8ae81720..origin/master -- <path>` 非 0），逐条判定：
- repository_context.rs（ad0877219：should_ignore_directory 的 "exports" → ".export"）：该函数所在的
仓库扫描实现已在更早的退役批次（6d5436541）判为不可达并删除，全仓已无该符号 → 改动无处生效，保留删除。
- generation/pass_artifacts.rs（b04aceb57：黑板字符串去掉「发布包装：exports/README.md」）：内容已并入
project/memory.rs（fbea59251），全仓已无该字符串 → 无需承接，保留删除。
- generation/draft_writer.rs（b04aceb57 −16：删掉 exports/README.md 写入）：属 legacy draft 生成链，
已在 22540a874 整体退役；全仓 grep 0 引用，恢复只会留下未挂载的孤立文件 → 保留删除。
G 桶（双方都改、我们那侧不改变行为 → 以 master 语义为准）：
- agent/generation/trace.rs：唯一冲突块里 master 只把 "exports/README.md" 从产物清单里删掉，而该函数
（append_local_artifact_write_step）已由我们在退役批次里整段删除 → 保留我们的删除。
- useGameDistributionPublishForm.ts：master 本轮删除该文件（b04aceb57），我们侧只有上一轮同步带来的错误
正文改动 → 取 master 语义（删除）。
其余文件由 git 自动合并。本提交不含新写的功能改动：收敛形态与残留清理见后续提交。
server-rs 工作区说明
更新时间：2026-05-15
server-rs/ 是当前唯一后端工作区，承载 Rust api-server、SpacetimeDB module、领域模块、平台副作用适配和共享契约。旧 server-node、Express、PostgreSQL、Go 服务端和 maincloud 口径均为历史残留，不再作为当前实现目标。
当前职责
crates/api-server：Axum HTTP / SSE / BFF 门面、鉴权、中间件、外部服务编排和 DTO 映射。crates/spacetime-module：SpacetimeDB 表、reducer、procedure、事务 adapter、row mapper 和迁移。crates/spacetime-client：后端访问 SpacetimeDB 的 typed facade。crates/module-*：领域模型、命令、应用规则、领域事件和领域错误。crates/platform-*：OSS、LLM、语音、认证等外部平台能力。crates/shared-contracts：前后端共享 DTO 与公开契约。crates/shared-kernel、crates/shared-logging、crates/tests-support：跨模块基础能力、日志和测试支撑。
开发规则
server-rs/Cargo.toml是 workspace 成员和依赖版本事实源；第三方依赖和 workspace 内 crate path 优先放在[workspace.dependencies]。module-*不直接依赖 Axum、SpacetimeDB table/reducer/procedure、reqwest、OSS、LLM、spacetime-client、tokio或文件系统。api-server不承接领域真相；发现领域规则时优先沉到对应module-*。- SpacetimeDB schema 变化必须同步
spacetime-module/src/migration.rs、生成绑定和当前后端架构文档的表目录。 - 人工命令、本地联调和文档示例不要使用
spacetime --root-dir。
常用命令
cargo check -p api-server --manifest-path server-rs/Cargo.toml
cargo test -p api-server --manifest-path server-rs/Cargo.toml
npm run check:server-rs-ddd
npm run check:spacetime-schema
npm run spacetime:generate
npm run dev:api-server
涉及 API smoke 时用 npm run dev:api-server 启动后端并检查 /healthz，不要使用旧 api-server:maincloud。
当前文档
- ../docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md：DDD 边界、API 分组、schema 变更规则和表目录。
- ../docs/【开发运维】本地开发验证与生产运维-2026-05-15.md：本地启动、检查、SpacetimeDB 操作和生产运维。