lhk229
2fab4db4cc
57f355b7b为修复终态载荷槽位错位引入了「按 id 归位」，但归位条件写成了无差别的 「同一个 id 落到两个槽位就合并」。注释里那句「只可能是上游用了不同的槽位基准」是个 不成立的穷尽性断言，代码照着它写，于是漏掉了第二种成因：上游自己重复使用 call id。 两种实测后果： - 同一个终态载荷内两条相同 call_id、相同函数名、不同参数：被并成一条，后到的参数 覆盖先到的，静默丢掉一次调用。修复前流式返回两条（与非流式一致，由调用方的 call id 唯一性校验拒绝），修复后变成一条且参数是后到的那份——用「调用方拒绝」 换来了「平台静默挑一份参数」，这个交换是亏的。 - 两次 output_item.added 用同一个 call_id：第二次被重绑到第一个槽位，它自己的参数 事件随后落到一个没有身份的空槽位上，最终报 Err(Deserialize("缺少 id：slot=1")) ——失败关闭但完全指错方向，排查的人会去查为什么没 id，而那个槽位没 id 恰恰是被 重绑逻辑拿走的。 改判据：ToolCallFragment 新增 from_terminal_snapshot，只有终态快照 （response.completed / incomplete 载荷）的分片允许按 id 重绑，因为只有它是对**已宣告 调用的重述**；增量宣告（output_item.added / content_block_start / Chat delta）永远是新 调用，绝不重绑。快照内部自身重复的 id 另行排除。 不用「是否跨事件」当判据：那只能挡住同事件形态，挡不住上面第二种跨事件形态。 平台层不承担 call id 唯一性判定。重复 id 原样透传，与非流式一致，由调用方统一拒绝 ——重复 id 是内容层问题，透传下去调用方的格式修复循环才拿得到 call id、函数名和原始 参数把响应回灌给模型重写，在平台层报错会把这三样一起丢掉。与非流式半截 JSON 透传 同一条理由。 隔离验证两级：去掉 from_terminal_snapshot 门槛，跨事件用例转红；再去掉同事件重复 排除（回到57f355b7b状态），两条用例都转红。 platform-llm 109 passed（原 106）。新增同事件重复 id、跨事件重复 id 两条流式用例， 外加一条非流式同构载荷用例锁住两条路径的契约一致。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
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 操作和生产运维。