功能
重要性 9.18
洞察度 8.00
Responses API 补齐 custom 工具、加密推理回放与模型校验
值得精读，尤其是三类人：维护 OpenAI 兼容入口的工程师（应重点看 `responses_adapters.py` 的 shim 设计与 `serving_responses.py` 的 `_validate_model` / `effective_tool_choice` / `_terminal_stream_event` 三处入口校验）、做推理/回放功能的工程师（看 `encode_reasoning_state` 的「编码非加密」定位与 `msg_store` 的 `_response_input_history` 结构）、以及 gpt-oss / Harmony 相关开发者（看 `harmony_utils.py` 的 channel↔phase 双向映射）。建议重点关注的设计决策：① 用「单字符串属性的 function 工具」承载 custom 工具，并用增量反转义保持 delta 与终值一致；② 具名 tool_choice 与 required 共享一条强制解析路径，未声明的名字在生成前 400 而非生成后丢弃；③ 用「缓冲到 phase 可知」换 added/done/final 三处 phase 一致；④ 主动把 `compact`、真 grammar 强制、真加密列为 out of scope 而不是半实现。阅读时建议优先补看 PR body 的症状表与 issue 里 JustinTong0323 的验证记录，再对照 diff 验证每条症状的落点。