c086fb8656
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>
文档总览
docs/ 只把当前融合文档和仍在维护的专题文档作为实现依据。旧创作模板、旧创作入口及其专属服务文档仅保留为历史材料,不再要求继续实现或兼容。
必读入口
团队长期约定、决策、流程和排障摘要统一从 项目记忆入口 读取。代码、当前融合文档与项目记忆冲突时,以代码和最新融合文档为准。
当前专题
图片编辑器与 Agent
- 图片画布编辑器 MVP 接入方案
- 图片画布编辑器前端拆分计划
- 画布 Agent 对话面板
- 画布 Agent 会话消息存 OSS
- 图片画布撤销范围与操作提示方案
- 浏览器内 AI Web 工程沙箱预览
- AI Web 工程 Runner 安全模型
后端与公开数据
- 外部生成 Worker 化方案
- BgFilter 受限资源调度方案(同步内部 HTTP 原地等待版)
- 统一公开作品 Read Model 设计
- 外部 OpenAPI 与 API Key 接入方案
- SpacetimeDB 连接池取消安全
后台、宿主壳与运维
- Dashboard 运营看板方案
- 后台多账号与 Tab 访问权限
- 宿主壳能力统一协议
- Expo React Native 与 Tauri 宿主壳方案
- Pingora 独立网关试点
- 本地 SSH 服务器管理面板
测试与协作
历史文档边界
- 旧创作模板、旧创作入口、旧运行态和旧素材生成方案不再从本页索引,也不再作为修复目标。
maincloud、旧 Node/Express/PostgreSQL/Go 后端和人工spacetime --root-dir口径均已废弃。- 历史文档不得覆盖当前融合文档、代码契约或
docs/project-memory/shared-memory/decision-log.md中更新的决策。
命名规则
后续新增 Markdown 文档文件名使用 【标签名】中文标题-日期.md。历史文件不做无关批量重命名;本次涉及的旧文档可直接删除或在当前入口中取消引用。