TRAE-AI编程
OpenAI 升级到 GPT-5.4
当用户明确要求把既有集成升级到 GPT-5.4 时，使用本指南，并结合当前官方资料检查。默认目标模型字符串为 gpt-5.4。
升级原则
采用范围最小、能够保持既有行为的修改：先替换模型字符串，只调整与该调用直接相关的提示词，尽可能通过提示词解决行为差异。如果必须更换 API、重写参数、重新连接工具或大范围修改实现，应报告超出本指南范围的阻塞，而不是自行扩大任务。
升级流程
- 盘点模型使用点：查找模型字符串、客户端调用和承载提示词的文件。包括内联提示词、模板、YAML／JSON 配置、Markdown 文档，以及明显关联到某个调用的已保存提示词。
- 建立调用与提示词的对应关系：先找内联 system／developer 文本，再找相邻提示文件，最后检查共享模板。关系不明确时如实记录，不猜测。
- 识别来源家族：例如 GPT-4o／GPT-4.1、o1／o3／o4-mini、早期 GPT-5、后续 GPT-5.x，或混合、未知来源。
- 分类：仅替换模型字符串；替换模型字符串并轻量调整提示词；或不修改代码就无法完成。
- 检查无需实现改动的兼容性：确认现有宿主能否直接接受
gpt-5.4。长时间 Responses、工具密集型智能体如果重放 assistant 项、使用开场进度消息或多条 assistant 消息，还要检查phase是否已经保留并回传。依赖代码修改才能兼容时标记blocked；证据不足时标记unknown。 - 提出升级建议：默认替换为
gpt-5.4，保持干预小、行为稳定。 - 提交结构化结果：列出当前使用点、模型字符串建议、起始推理建议、提示词修改、必要时的 phase 评估、兼容检查、验证计划及正式上线时需重新核实的项目。
每个使用点都要给出起始 reasoning_effort_recommendation。代码仓库暴露现有推理设置时，除非来源模型指南另有说明，先保留该值。未暴露时，应按来源模型家族的官方建议给出起点，不能只返回 null；若来源本身不明，应明确尚缺哪项证据。
升级结果分类
model string only：仅替换模型字符串
适用于提示词已经简短、明确、任务边界清楚，且工作流不强依赖研究、工具、多智能体、批量完整性或长时程执行的情况，也不能有明确兼容阻塞。
将模型改为 gpt-5.4，保持提示词不变，用已有评测或实际抽查验证行为。
model string + light prompt rewrite：模型加轻量提示词修改
以下情况值得采用此分类：旧提示词用于弥补较弱的指令遵循；工作流需要更强持续执行；任务强调完整性、引用或验证；新模型过于冗长或完成度不足；研究流程需要应对稀疏或空检索；编程、工具、多智能体流程可保持现有 API 与工具定义。
将模型改为 gpt-5.4，只增加一两个针对具体问题的提示块，并参考GPT-5.4 提示实践选择最小改动。不要顺带清理整套提示词。
| 工作流 | 可优先检查的提示块 |
|---|---|
| 研究 | research_mode、citation_rules、empty_result_handling；宿主已有检索工具时再考虑 tool_persistence_rules |
| 有依赖或工具密集 | tool_persistence_rules、dependency_checks、verification_loop；只有检索真正独立时才加 parallel_tool_calling |
| 编程或终端 | terminal_tool_hygiene、verification_loop |
| 多智能体支持或分诊 | 至少检查 tool_persistence_rules、completeness_contract、verification_loop 中适用的一项 |
长任务、多条 assistant 消息或开场进度消息还需专门评估 phase。若必须改实现才能支持，应记录对应路径被阻塞。但不能仅因可见示例简短，就把已有工具型 Responses 流程判为不可升级；没有代码层证据时，优先考虑是否能轻量调整提示词。
blocked：需要范围外的实现改动
当升级需要更换 API、重写实现内部的参数或推理设置、修改工具定义／处理器／Schema，或者无法可靠识别关联提示词时，不应临时拼凑更广的改造。说明阻塞与超出范围的原因。
无需实现改动的兼容检查
依次确认：宿主能否接受模型字符串；提示词能否定位并编辑；依赖行为是否要求 API、参数或工具接线变化；修复是否只涉及提示词；能否局部定位修改而非全面清理；长时程或工具型 Responses 所需的 phase 是否已经保留。
模型字符串无法直接接受、修复需要实现变化，或 phase 缺失且需改代码时，返回 blocked。提示词不可定位时返回 unknown，除非用户补充位置。
使用工具、智能体或具有多个调用点本身不是阻塞。现有 API 与工具定义能保持时，应优先考虑模型加轻量提示词调整。
范围边界
本指南允许更新或建议模型字符串、更新直接相关的提示词、读取实现以定位这些修改、检查已有 phase 处理，以及记录兼容阻塞。
不包含将 Chat Completions 迁移到 Responses、更换 Responses 的 API 形式、重写参数结构、修改工具定义或结果处理、修改结构化输出接线、补建 phase 处理，也不包含业务逻辑、编排逻辑和 SDK 用法的改造。安全升级若依赖这些修改，应记录为后续实现任务。
验证计划
每个升级点使用已有评测或真实任务抽查。检查延迟、输出形状和质量是否符合预期；新增提示块是否实际解决了问题而非增加噪声。存在下游影响时，在完成前做一次针对性检查。
正式上线时重新核实
若发布指导更新，应以正式资料替换候选版本假设，重新确认默认目标字符串、提示块语义、研究与引用规则以及兼容要求；复跑同一组迁移场景，确认可行与阻塞的边界仍成立。
更多建议：