欢迎来到 openJiuwen 社区
Hey @weixin_45837958 , 感谢你对社区的贡献.
机器人使用手册
有关指令的使用，可以点击 此处 查看详情。开发人员可以在每个PR或Issue下方评论特定指令来触发机器人任务。
联系指引
有疑问可以联系 SIG: sig-agent-core-java ,
维护者是： @shenwei21, @tianmingyong ,
审核者是： @foreach1991, @gcw_xJSJ32Ge, @jeffrey_qiao, @kangquansheng_makeIT, @xiongjie_makeit .
【功能&测试设计】0a683e15d8f34fae847b2242fd2c79b3.md
【自测结论】
新增UT用例 19 个， ST用例 8 个：其中Level0 用例 5 个、Level1 用例 3 个；新增及修改代码约 4366 行（新增 3566 行、删除
800 行）
测试方式：用 timeout-probe-agent（probe-agent jar）+ llm-stub-server（本机 stub，模拟各类超时场景）在 ECS 上端到端拉起完整调用链，SIT TC 通过 HTTP 发起对话请求，观察 wire 面返回的错误码、阶段字段（BEFORE_CONNECT / BEFORE_FIRST_SEGMENT / AFTER_FIRST_SEGMENT）、日志锚点。
覆盖的核心场景（15 条 TC）：连接超时独立触发、响应头等待超时（阻塞/流式两路）、首段后 stream_idle 超时独立于 header_wait、长回答不被全程硬顶截断、单次调用 per-call idle 覆盖不污染客户端配置、agent 级 idle 覆盖客户端级 idle、取消不误判为超时、range 校验拒绝非法配置、跨 client 子类统一超时语义、error details 四字段跨三阶段完整性。
模型调用超时分层（FEAT-058）交付总结
代码交付：代码变更约 4851 行，其中新增 4033 行、删除 818 行；core !400、runtime !227、测试仓 !766、!912 四条 PR
均已合入。
新增用例数：新增用例 27 个，其中 UT 19 个、ST 8 个（Level0 5 个、Level1 3 个）。
问题数：5 个（致命 0 个 / 严重 2 个 / 一般 2 个 / 提示 1 个）。5 个 issue 已清零。
兼容验证：未配置新超时项的任务与引入特性前逐字节一致（UT 与 ST
双层锚定）；连接建立/响应头等待/数据段空闲三层超时双栈统一语义，响应头到达即解除总计时、不设全程总时长硬顶；单次调用超
时参数仅覆盖数据段空闲层，不污染客户端级配置；上层主动取消不归类为超时失败。
Paired: GitHub #310 ↔ GitCode #171
🚀 背景描述
930 分支上,两条模型调用 HTTP 栈的超时均未按调用阶段分层,企业客户长任务场景暴露三类问题:
针对上述痛点引入:连接建立 / 响应头到达 / 数据段空闲三层独立计时,响应头到达即解除总计时,数据段空闲超时放宽,不设全程总时长硬顶,单次调用参数按层覆盖。
设计思路
按"痛点 → 机制"设计,两条 HTTP 栈同步改造,统一为同一套分层语义:
错误表面:连接超时、响应头到达前超时、数据段空闲超时三类失败可程序区分,携带三段阶段信息(连接建立前 / 首段数据到达前 / 首段数据到达后);上层主动取消不得归类为超时失败。
涉及到的对外API
模型客户端配置面增量演进:新增连接超时、数据段空闲超时独立配置项(未配置时有可解释默认值,非法值拒绝或回落默认);单次调用超时参数作用于相应超时层。不改既有配置项名称与语义。
与其他模块的相关性描述
测试设计与测试计划
其他信息
感谢您的贡献 🎉!