docs: 归档任务 #286

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)