Files
Genarrative/docs
lhk229 902f487ea9
Project CI / Frontend tests (pull_request) Failing after 23s
Project CI / Repository checks (pull_request) Failing after 46s
Project CI / Backend tests (pull_request) Successful in 2m55s
Project CI / Native shell tests (pull_request) Successful in 10m6s
Responses 终态事件恢复正文
response.completed / incomplete 分支只从终态载荷恢复工具调用,不恢复
message.content[].output_text,导致三种后果(均已实测复现):

- 纯文本的 completed-only 响应 -> EmptyResponse,上层白跑一轮重试或降级
- response.incomplete 携带的截断正文同样退化成 EmptyResponse,连降级
  回复都给不出来
- 「正文 + 工具调用」响应不报错,但模型的前置说明被静默丢掉,最隐蔽

有增量事件的正常流和非流式路径都不受影响。

归属:终态载荷成为「恢复源」是本分支 7c61e9a53 确立的,它加了
extract_responses_completed_tool_fragments 却没同步提取正文,且同一提交新增
的回归载荷里带着「我来查询。」而只断言 tool_calls,缺陷被自己的测试盖住;
fc53ee5c9 把 incomplete 并进同一分支时把这个不对称一起带了过去。更早的
9d684cb7b 虽然也没提正文,但那时终态载荷根本不是恢复源。

修法:ParsedStreamEvent 新增 text_snapshot,与 delta_text 分开——它不是增量,
按增量累加会让正文翻倍。终态分支把 response 反序列化成
ResponsesResponseEnvelope 后复用 extract_responses_text,不另写裸 JSON 提取器:
后者必然漏掉 reasoning / thinking 等隐藏 part 的过滤,会把思维链当正文吐出去。
反序列化失败按「没有快照」静默降级而非报错——兜底路径放过只是回到修复前行为,
与槽位缺失那类会造成静默错配的失败关闭口径不同。

累加时按状态分两条路:累加为空(只发终态事件的网关)把快照当成一次增量发出去,
否则 response.text 对了但调用方流式通道全程收不到文本(Responses 的
emit_finish_only_delta 为 false,只有 Chat 为真);累加非空则按权威值覆盖且不
补发回调,避免调用方侧翻倍。覆盖语义与 arguments_complete 一致。

隔离验证两次:把 text_snapshot 置 None,四条用例转红;把覆盖改成追加,
不重复用例转红。

platform-llm 95 passed(原 91)。新增 completed-only 纯文本、incomplete-only
纯文本、delta 与终态并存不重复、终态 reasoning part 不入正文四条,并收紧既有的
stream_run_recovers_responses_tool_calls_from_completed_event_only 断言正文。
前两条同时断言 on_delta 实际回调内容,只断言 response.text 抓不到流式通道那个坑。

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