Files
Genarrative/docs
lhk229 c086fb8656
Project CI / Frontend tests (pull_request) Failing after 24s
Project CI / Repository checks (pull_request) Failing after 42s
Project CI / Backend tests (pull_request) Successful in 3m15s
Project CI / Native shell tests (pull_request) Successful in 9m51s
Responses 终态快照同步修正流式回调
902f487ea 引入终态正文快照时,「累加非空」一支只覆盖 accumulation.text、不补
回调。这一支当初只顾着避免正文翻倍,漏了「增量拼接结果本来就可能不等于快照」
——而这恰恰是决定要覆盖的唯一理由,两件事是耦合的。结果是 LlmRunResponse.text
已经是完整值,调用方最后收到的累计正文却停在半截。

实际代价:按累计正文取值的抢救路径(单 Agent 流式在 stream_run 返回 Err 时用
最后一次回调的 accumulated_text 当回复)会拿到半截正文,而「incomplete 且带
工具调用」会被截断拒绝规则判为 Err,恰好走到那里——正是 incomplete 降级回复
该发挥作用的场景。持久化回复流与 UI 实时视图同样停在半截,但 ready 写入用的是
response.text 派生值且直接覆盖 accumulated_text,所以是窗口期问题,不会造成
finalization 冲突或 needs-reconciliation。

改为按「是否等于快照」判断,不一致就补发一次回调。增量字段分三种情形取值:
累加去空白后为空给整个快照(这一支不能并进 strip_prefix,纯空白累加值匹配不上
前缀会退化成空增量,反而让按增量累加的消费者丢内容);快照是增量的延长给后缀;
非前缀关系给空串靠 accumulated_text 纠正。最后一种下按 delta_text 累加的消费者
无法自愈,作为已知残留写进契约文档。

边界:只有「快照延长增量」与「快照与增量分叉」两种情形的回调行为改变,其余
四种(累加为空、完全一致、无快照、纯空白累加)维持字节级不变。不给 Responses
打开 emit_finish_only_delta——那会让每一条流都多一次终态回调,是另一个决定。
LlmStreamDelta 结构、App 侧消费点均未改动。

隔离验证两次:退掉 emit 条件里的 snapshot_corrected,分叉用例转红(前缀延长
那条靠 has_delta 仍绿,说明该标志只对分叉承重);整块回退成旧两支形态,两条
新增用例都转红、其余 101 条全绿,印证边界表里「不变的四行」确实没动。

platform-llm 103 passed(原 101)。新增前缀延长、非前缀分叉两条,并收紧既有的
不重复用例——改为断言回调次数与 (delta_text, accumulated_text) 二元组,原先只
断言累计正文序列,补不补这次回调都可能是绿的。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-27 13:01:30 +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。历史文件不做无关批量重命名;本次涉及的旧文档可直接删除或在当前入口中取消引用。