Files
Genarrative/docs
lhk229 57f355b7b6
Project CI / Repository checks (pull_request) Failing after 59s
Project CI / Backend tests (pull_request) Successful in 3m24s
Project CI / Frontend tests (pull_request) Successful in 3m47s
Project CI / Native shell tests (pull_request) Successful in 9m59s
修复分支审查发现的三处问题
一、流式工具槽位按 id 归位,消除终态载荷错位产生的重复调用

extract_responses_completed_tool_fragments 用 output[] 数组下标当槽位,而增量
路径用事件自带的 output_index。网关若在 completed 快照里省掉此前占用过某个
output_index 的 reasoning / message 条目,两者基准就错位,终态分片会落进一个
从未占用过的空槽位。空槽位上 merge_tool_identity 的 current 为 None、冲突检测
不触发,于是静默产出两条 id 完全相同的调用。

探针实测:output_index=1 的调用 + 只含一个 function_call 的 completed 载荷,
返回 Ok 且 tool_calls 为两条一模一样的 call_a/get_weather,零告警。

这说明 872a2f645 的身份冲突修复是不完整的——它只堵了「撞上已占用槽位」,没堵
「落进空槽位」。改为在 push_tool_fragment 里先按非空 id 归位到已有槽位:槽位只是
传输层归并键,真正的身份是 id。名字冲突仍由 merge_tool_identity 拦截,并进去之后
函数名不一致照常失败关闭。

下游影响:本仓库 agent_native_tools.rs:308 按 call id 唯一性校验,重复即报
CallIdentity 错误,所以现状是合法响应被误判成协议错误、空耗格式修复配额,不是
重复执行。但 platform-llm 是给 module-ai / module-story 等复用的基础 crate,
不能指望每个消费方自己去重,故在 crate 层修。

二、补回 check-native-shells 丢失的 App.tsx iframe 断言

85b9c2f19 合并 codex 时,check-native-shells.mjs 的 assertAiGameCreatorShell-
UserDevBoundary 双方独立重写产生冲突,当时判定「我方是上游的严格超集」并整段取
我方——这个判断是错的。上游有一条我方没有:App.tsx 全文不得直接出现 <iframe>,
预览必须委托给客户端工作台。我方版本只约束 DeveloperProjectPanels 自身的 iframe
数量与挂载位置,管不到外壳自己内嵌预览框。

补回该断言并反向验证:往 App.tsx 塞一个 iframe 后门禁确实报错,移除后通过。

三、流式工具校验失败分支落盘真实 attempt

stream_run 新增的四处工具调用后置校验失败分支(截断门禁、finish_tool_calls
失败、不完整终态拒绝、一致性断言)调用 log_llm_raw_failure 时把 attempt 硬编码成
字面量 1,同函数其余 12 处均传真实 attempt。重试后落盘日志全部标成第一次尝试,
排障时看不出真实次数。

隔离验证:停用按 id 归位后,两条新增用例转红;第三条(不同 id 的并行调用必须保持
两条)两边均绿,它守的是归并不得过头。

platform-llm 106 passed(原 103)。

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