diff --git a/docs/task/286-Admin-Client-AI规格解析等待时间调整.md b/docs/task/286-Admin-Client-AI规格解析等待时间调整.md new file mode 100644 index 0000000..be7d10e --- /dev/null +++ b/docs/task/286-Admin-Client-AI规格解析等待时间调整.md @@ -0,0 +1,50 @@ +# 286 Admin / Client:AI 规格解析等待时间调整为 66 / 132 秒 + +- 类型:需求 +- 父级大工单:#14 +- 所属 MVP / 版本:#199 / Admin AI规格批量匹配;#253 / 采购运行时 AI 规格纠偏闭环 +- 状态:已完成,待用户验收 +- 日期:2026-08-21 +- Gitea 工单:http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/286 + +## 背景与目标 + +用户要求将 Admin 调用 AI 的运行时规格解析等待时间调整为 66 秒,并将 Client 等待该 Admin 规格解析接口的上限调整为 132 秒。原值分别为 30 秒和 60 秒。 + +## 最终方案 + +- Admin 运行时规格解析在父请求上下文内创建 66 秒的 AI 子上下文;父请求提前取消时仍立即取消。 +- Client 仅将 `/spec-resolution` 的专用 HTTP 等待上限调整到 132 秒;登记、领取、提交等普通 Admin 请求超时不变。 +- Admin 新建 AI 服务商配置表单默认超时调整为 66 秒,输入范围仍是 1–120 秒。 +- 已存在的生产服务商配置不会被模板自动覆盖;部署时必须显式将当前启用 GPT-5.5 配置的 `timeout_seconds` 调整为 66。 + +## 改了哪些 + +- `admin/service/purchase_spec_resolution.go`:运行时 AI 子上下文从 30 秒调整为 66 秒。 +- `admin/service/purchase_spec_resolution_test.go`:更新 66 秒预算边界测试。 +- `admin/templates/ai/list.html`、`admin/ai_config_template_test.go`:调整并验证新建服务商默认超时为 66 秒。 +- `client/src/http_admin_gateway.py`、`client/test/test_http_admin_gateway.py`:将运行时规格解析 HTTP 超时从 60 秒调整为 132 秒并验证。 + +## 验收结果 + +| 验收标准 | 结果 | +|---|---| +| Admin 运行时 AI 上下文预算为 66 秒并继承取消 | 通过 | +| Client 专用规格解析 HTTP 超时为 132 秒 | 通过 | +| 普通 Admin 请求超时未改动 | 通过代码范围核对 | +| 新建服务商默认超时显示 66 秒,范围保持 1–120 秒 | 通过模板测试 | +| Admin 固定 Go 1.23.0 验证通过 | 通过 | + +## 测试 + +- 执行的命令: + - `C:/Python310/python.exe -m py_compile src/http_admin_gateway.py` + - `C:/Python310/python.exe -m unittest discover -s test -p 'test_http_admin_gateway.py'` + - `GOTOOLCHAIN=go1.23.0 go test ./service -run 'TestMatchPurchaseSpecWithRuntimeAI_限制66秒并继承更早取消' -count=1` + - `GOTOOLCHAIN=go1.23.0 go vet ./...; go build ./...; go test ./... -count=1` +- 结果:Client 16 项网关测试通过;Admin 定向和全量测试通过。 +- **没验证到的部分**:尚未部署生产,线上启用 GPT-5.5 配置仍为 30 秒;未执行真实设备或真实 GPT-5.5 的 66 / 132 秒端到端请求。 + +## 相关提交 + +- `dc808e2` feat: 调整 AI 规格解析等待时间 (#286)