Files
Genarrative/docs
lhk229 2fab4db4cc
Project CI / Repository checks (pull_request) Failing after 10s
Project CI / Backend tests (pull_request) Failing after 10s
Project CI / Frontend tests (pull_request) Successful in 2m48s
Project CI / Native shell tests (pull_request) Successful in 9m31s
按 id 重绑收窄到终态快照分片
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>
2026-07-28 03:24:20 +00:00
..
2026-07-17 21:03:15 +08:00
2026-07-27 18:28:26 +08:00

文档总览

docs/ 只把当前融合文档和仍在维护的专题文档作为实现依据。旧创作模板、旧创作入口及其专属服务文档仅保留为历史材料,不再要求继续实现或兼容。

必读入口

  1. Agent 工作入口与执行准则
  2. 当前产品与工程约束
  3. server-rs 与 SpacetimeDB 数据契约
  4. 平台入口与玩法链路
  5. 本地开发验证与生产运维
  6. AI 游戏创作项目开发工作台 PRD

团队长期约定、决策、流程和排障摘要统一从 项目记忆入口 读取。代码、当前融合文档与项目记忆冲突时,以代码和最新融合文档为准。

当前专题

图片编辑器与 Agent

后端与公开数据

后台、宿主壳与运维

测试与协作

历史文档边界

  • 旧创作模板、旧创作入口、旧运行态和旧素材生成方案不再从本页索引,也不再作为修复目标。
  • maincloud、旧 Node/Express/PostgreSQL/Go 后端和人工 spacetime --root-dir 口径均已废弃。
  • 历史文档不得覆盖当前融合文档、代码契约或 docs/project-memory/shared-memory/decision-log.md 中更新的决策。

命名规则

后续新增 Markdown 文档文件名使用 【标签名】中文标题-日期.md。历史文件不做无关批量重命名;本次涉及的旧文档可直接删除或在当前入口中取消引用。