Files
Genarrative/docs
lhk229 b1ef45fbd2 统一三协议工具调用归一,禁止静默丢弃
非流式 DTO 为兼容流式分片改成可选字段后,filter_map 会把缺 id / name /
function 的工具调用逐个丢掉;响应同时带解说文本时整个响应被当作普通文本
回复成功返回,带 tool_choice=required 的请求随后退化为格式修复循环,审计
里看不出成因在解析层。Responses 与 Anthropic 的提取有同类缺陷。

把策略收进单一入口 normalize_tool_calls:协议层只做字段映射,识别为工具
调用后字段不全一律返回 Deserialize;arguments 缺省或空白归一为空对象,
非空则必须是完整 JSON。流式收尾改为委派同一入口,行为不变。

顺带修正两处口径不一致:Chat 缺 arguments 从空串改为空对象,Responses
缺 arguments 从整条丢弃改为空对象(零参函数合法)。非流式 arguments 半截
JSON 由此改为显式失败,上游 max_tokens 截断会命中。

补 9 个非流式用例,含缺 id 且有正文不得退化成纯文本回复的回归锁,以及三
协议同一缺失形状必须同类报错的一致性用例。
2026-07-27 05:59:28 +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。历史文件不做无关批量重命名;本次涉及的旧文档可直接删除或在当前入口中取消引用。