[3aKHP]

Grade: Hot-Fix

Summary

官方订阅后端返回 response.metadata 等新增 SSE 事件时，Responses 请求会被判为流畸形，导致已生成的文字或图片无法交付。本版让两种 Responses Profile 对未知事件限量记录后继续接收回复，并保留序号、终态、已知 delta、工具参数和最终输出校验。

目标版本为 1.16.3，发布范围为该生产阻断修复及其测试、文档、版本和发布说明。

• 上一 tag / main 基线：v1.16.2 / 710f09e022afd2ff41eaef5e607eab37d4e4950c
• 实现提交：9c65d62
• 最终候选 SHA：b74663e44e8070ce48df3993140b53326ca35753
• 实现范围的 Deep-CR trigger：false；发布准备差异只含版本号、CHANGELOG 及生成副本。

Release checklist

• pyproject.toml 版本冻结为 1.16.3
• CHANGELOG 新版本段、比较链接及 self-docs 副本已更新
• 发布说明包含「预置 Skill 变动」和已安装副本的更新入口
• 公开文档及旧事件拒绝策略说明已同步
• README 功能清单核对完成，本版修复既有 Responses 功能
• 实现独立 CR 完成：无 Blocking / Should-fix
• 独立发布专项 CR 完成
• Bot Review 完成并核对结论（PR 创建约 15 分钟后仍无评审记录，待确认）
• 特殊里程碑专项：不适用

Release CR

• 累计范围：v1.16.2..b74663e，两个提交。
• 实现独立 CR 已核对未知事件接收、日志去重与上限、载荷保护、终态输出及工具校验、Profile 字段改名和回放指纹、client fallback、测试与文档。
• 发布准备新增差异：版本号、用户发布说明、比较链接与 self-docs 生成副本。
• 独立发布专项 CR 已对固定候选完成：Blocking / Should-fix / Nits 均无；确认版本、CHANGELOG、比较链接、Skill 同步入口、前端版本来源、发行提取器及 Responses 原生回放边界。GitHub Bot Review 在 PR 创建约 15 分钟后仍无评审记录，结论待确认；维护者已人工审核并批准合并、tag 发布。

Test Plan

• Ruff、示例配置校验、ID 字面量检查、self-docs 同步检查、git diff --check
• 全量 Python：3098 passed（Python 3.12，pre-push hook）
• 前端类型检查、56 项前端测试、生产构建
• 定向验证：176 项 provider / streaming / HTTP Trace / history projection 测试
• 生产原始 SSE 离线回放及插入未来事件后的回放均通过，图片和用量提取正常
• 源码与安装版本元数据均为 1.16.3
• v1.16.3 发布说明提取通过
• GitHub CI：Python 3.11 / 3.12、前端构建、Windows configuration lifecycle 全部通过（run 38921344304）
• Windows 发行物、镜像及其 smoke 由获批 tag 触发的发行流水线执行；尚未部署生产。

Changelog

修复 Responses 后端新增元数据或进度事件时 LLM 调用失败的问题。未知事件限量记录后继续接收回复，终态输出和工具调用保持严格校验。

self-docs 同步 Responses 事件兼容策略。已安装副本可通过 Web Admin 或 scripts/sync_preset_skills.py 更新。

人工合并审核

• 最终候选 SHA 的 CI 与两轨评审通过
• 维护者已人工审核并批准候选 b74663e44e8070ce48df3993140b53326ca35753 合并及本版 tag 发布

合并后

• main 合并提交 98c20c579b907836d7e841c297affe747e202d5c 的 CI 全部通过
• 维护者已批准本版 tag 发布；v1.16.3 指向 main 合并提交 98c20c579b907836d7e841c297affe747e202d5c
• 创建并推送获批 tag；发行 workflow 38925088665 全部通过，GitHub Release、Windows ZIP 审计与 smoke、Docker smoke、镜像 revision/digest/版本别名与发布说明均已核对
• main 已通过 chore: back-merge v1.16.3 into dev #306 回灌 dev：合并提交 9b77d5315720a3a7474c85c84828cf75f383ce5a，开发版本 1.16.4-dev.0，合并后 CI 全部通过（run 38927260749）
• 已归档发布 changelog 草稿；回灌 CI 通过后已清理 hotfix 与 back-merge 短分支