feat(ai): enforce direct image edit contract

2026-07-20 17:52:59 +08:00
parent 61db0f4ed6
commit 2a2cbad7bd
11 changed files with 382 additions and 94 deletions
@@ -3,7 +3,7 @@ id: T-678
 title: 自定义网关图片模型锁定 OpenAI 图片编辑接口并支持多图输入
 phase: 7
 deps: [T-677]
-status: TODO
+status: DONE
 created: 2026-07-20
 ---

@@ -88,4 +88,8 @@ git diff --check

 ## 执行记录

-（做完在这里写：改了什么文件、跑了什么验证命令及结果、官方接口契约核实来源与日期、遇到的阻塞和关键决策。）
+- 2026-07-20 完成：保留全局 `API_TYPES`，新增按图片类别的 OpenAI 图片编辑接口校验；存量 `chat` / `auto` 图片模型仍可载入、查看和保存，但设置页标示为不支持，②预检及 direct 生图会在发请求前用中文拦截。
+- direct 封面请求统一使用 `/v1/images/edits` multipart；`_image_edit_body()` 支持有序多图，重复 `image[]` 字段的第一张为主体图，并固定 `n=1`。响应解析收敛到 `data[].b64_json` / `data[].url`；cmhub 保持独立的宽松解析函数，默认网关行为未改变。
+- 图片模型按钮改为「检查图片配置」，worker 只调用本地字段、接口类型、URL 和超时检查，不发送空图片请求；文字模型继续走既有连接测试。
+- 文档同步：`docs/cmhub-integration-design.md`、`docs/routes.md`、`docs/api.md`。接口契约于 2026-07-20 参考 [OpenAI Images API 文档](https://platform.openai.com/docs/guides/image-generation)：图片编辑使用 multipart 图片输入，图片结果使用 base64 或 URL 表达；本项目固定采用 `image[]`、`n=1` 和标准 `data` 结果字段，不适配服务商私有响应。
+- 验证通过：`py -3.10 -m unittest tests.test_ai tests.test_appconfig tests.test_gui`（287 passed）；`py -3.10 -m unittest discover -s tests`（643 passed）；`py -3.10 -m ruff check app tests main.py`；`py -3.10 -m compileall app main.py`；`git diff --check`。本任务未改 CDP，未作线上蝦皮实跑。