docs(tasks): harden direct suite release semantics

This commit is contained in:
chengma
2026-07-20 17:35:54 +08:00
parent 34c7a2e148
commit 61db0f4ed6
5 changed files with 20 additions and 11 deletions
+4 -1
View File
@@ -39,6 +39,8 @@ T-677 恢复了⑤的自定义网关(`ai.backend=direct`)。图片模型的
### 3. 配置、预检与回归
- 使用图片模型前,预检同时检查启用状态、`images_edits` 接口类型、URL、模型名、密钥和超时;错误只给中文可操作说明,不暴露密钥、完整上游 URL 或原始响应体。
- 图片模型的⑤「测试」入口改为「检查图片配置」:只执行本地字段、接口类型、URL 格式和超时校验,**不**向 `/images/edits` 发送没有 `image[]` 的 JSON `ping` 请求,也不伪造成功。原因是图片编辑端点要求 multipart 图片,真实请求可能产生服务商费用。
- 用户需要验证图片模型实际可用性时,必须通过②或⑥的正常生成确认流程完成;确认框继续如实提示「自定义网关不计点数,实际费用以服务商为准」。不得在“检查图片配置”中隐式发起可能计费的生成请求。
- ②已有的重试、并发、日志、“自定义网关不计点数”口径不变;本任务不改变默认网关及其 cmhub 生图路径。
- 在执行记录中记录 OpenAI 官方文档核实日期、`image[]` 字段、标准响应字段和支持的尺寸范围;外部兼容服务若不满足该契约,第一版明确不支持,不做自动探测或私有适配。
@@ -48,6 +50,7 @@ T-677 恢复了⑤的自定义网关(`ai.backend=direct`)。图片模型的
- [ ] `category=image` 仅在 `api_type=images_edits` 时可提交图片生成;存量 `chat` / `auto` 图片模型保留且不被静默改写。
- [ ] multipart 使用有序重复 `image[]` 字段;单图与多图均有字段、顺序与首图主体的单元测试。
- [ ] 图片响应仅接受 `data[].b64_json` / `data[].url`;非标准响应有可读中文错误,非法 URL 不会下载。
- [ ] ⑤图片模型的「检查图片配置」不发送网络生图请求,旧 `test_ai_model()` 的 JSON ping 不会被用于 `images_edits` 模型;文字模型既有测试行为不回归。
- [ ] ②单图生成的结果、重试、并发、日志和不计点数口径不回归。
- [ ] ⑤的图片模型限制和②预检均为中文,不泄露密钥、完整上游 URL 或原始响应体。
- [ ] 默认网关的生文、生图、图片理解、异步 submit/poll、幂等键、计费与③更新蝦皮不受影响。
@@ -56,7 +59,7 @@ T-677 恢复了⑤的自定义网关(`ai.backend=direct`)。图片模型的
- `tests/test_ai.py`:文字 `chat` / `auto` 回归、图片 `images_edits` 单图与多图 `image[]` 请求、`n=1`、标准响应和非法/非标准响应错误路径。
- `tests/test_appconfig.py`:按类别的可用性校验、存量 `chat` / `auto` 图片模型不被改写、文字模型保存与加载不回归。
- `tests/test_gui.py`:⑤按类别显示接口类型、②预检拦截不可用图片模型且文案中文。
- `tests/test_gui.py`:⑤按类别显示接口类型、图片模型检查不发网络请求、②预检拦截不可用图片模型且文案中文。
- 更新 `docs/cmhub-integration-design.md`、`docs/routes.md`、`docs/api.md`,标明图片编辑的固定契约和 T-679 的依赖关系。
## 验证