Files
Genarrative/docs
lhk229 fc53ee5c9c
Project CI / Frontend tests (pull_request) Failing after 27s
Project CI / Repository checks (pull_request) Failing after 54s
Project CI / Backend tests (pull_request) Successful in 4m55s
Project CI / Native shell tests (pull_request) Failing after 8m17s
补齐 Responses 的 incomplete 终态
Responses 的整体收尾信号有两个,此前只处理了 completed,incomplete 落入
通配分支被整个忽略。真实端点抓包确认:撞到 max_output_tokens 时上游只发
response.incomplete、不发 completed,载荷与 completed 同构,带完整 output[],
item 标 status=incomplete,incomplete_details.reason 给出原因。

忽略它造成三件事:不终止读取循环,网关不主动关连接就等到调用方超时;流式
Responses 永远产生不出 incomplete 这个 finish_reason,上一轮加的截断拒绝规则
对它形同虚设;completed-only 型网关的工具调用被静默丢掉。

与 completed 合并到同一分支,只在 finish_reason 上区分。incomplete 由此自动
走 reject_incomplete_tool_calls:工具调用拒绝,正文按降级结果返回,与 Chat 的
length 口径一致。

三个用例的事件序列转录自真实抓包,退回通配分支时三条全部失败。
2026-07-27 08:51:53 +00:00
..
2026-07-17 21:03:15 +08:00
2026-07-18 21:17:35 +08:00
2026-07-21 11:20:56 +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。历史文件不做无关批量重命名;本次涉及的旧文档可直接删除或在当前入口中取消引用。