cmshoppe/docs/tasks/T-595.md

---
id: T-595
title: AI工场端到端集成、真实只读验收与产品文档收口
phase: 7
deps: [T-593, T-594]
status: DONE
created: 2026-07-11
---

## 问题 / 背景

AI工场横跨 DB、CDP、远程图片、cmhub 异步生成、GUI 拖放和本地导出。各子任务通过后仍需端到端验收，确认跨模块状态恢复、cmhub 托管生成、部分导出和打包环境一致，并将提案文档升级为当前产品事实。自定义大模型后置到 T-596，不作为本轮依赖或验收条件。

## 方案

- 串起：新增/恢复项目 → 只读拉原图 → 单击进池 → 设源图 → 同提示词 N 张生成 → 重启续查 → 拖入终选排序 → 部分导出 → 打开目录。
- cmhub 托管来源完成 mock 全链和成本可控实测；只读 CDP 实跑不点击更新、不上传蝦皮。
- 验证程序强退/重启时 submitted/running job、下载中间态、终选和草稿提示词恢复。
- 核对 1180×760、960×640 和 Windows 缩放，生成 Playwright/Qt 截图与 `tab6-ai-studio-v3.svg` 对照。
- 更新 `docs/04-architecture.md`、`docs/routes.md`、`docs/api.md`、UI README、用户排障和打包说明；Obsidian 方案标记实现状态。
- 确认公开发行包不包含 data、真实 Key、测试图片或 direct 普通入口。
- 确认界面没有自定义 Provider、API Key 或生成来源切换入口；相关能力由后续 T-596 单独实现。

## 验收要点

- 完整闭环可由运营独立完成，所有失败均为中文且能继续/重试，不需要改 DB。
- 同项目多轮生成、多个项目切换和重启不串图、不重复扣费、不丢 task_id。
- 终选顺序与导出文件顺序一致；部分导出和已存在目录三选实测通过。
- cmhub 托管计费提示和授权边界准确；不存在 BYOK 或其他生成来源的可见入口。
- 现有五个 Tab、②生成、③更新、账号、设置、打包和全量单测不回归。
- 真实操作仅只读商品页和本地导出；CDP 自动回传不在本任务验收。

## 边界（不改什么）

- 不实现主图9张/详情图多媒体框自动回传蝦皮。
- 不加入本地图片导入、自动去重重生或自动动作词。
- 不实现 BYOK、自定义 Provider、API Key 或生成来源切换；这些内容后置到 T-596。
- 不以人工改 SQLite 作为验收步骤。

## 执行记录

- 2026-07-11：完成 AI工场端到端集成收口。
  - 新增 `tests/test_image_studio_e2e.py`：mock 串起项目创建、原主图 URL 同步、原图下载、cmhub 托管生图、终选排序和 JPEG 导出，验证文件顺序与导出结果。
  - 新增 `docs/ai-studio-e2e-checklist.md`：记录已实现闭环、自动化覆盖、人工真实只读验收步骤和发布检查；明确不包含 BYOK、自定义 Provider、自动上传蝦皮或本地图片导入。
  - 更新 `docs/api.md`：补充 `image_studio.py`、`image_studio_images.py`、`image_studio_generation.py`、`image_studio_export.py` 合约，并把 GUI 合约更新为 6 Tab 和 AI工场 worker。
  - 更新 `docs/README.md`、`docs/ui/README.md`，登记 AI工场验收文档和 6 Tab/主流水线事实。
  - 验证：主工作区 targeted 测试通过；因无关默认提示词脏文件仍会影响全量 unittest，已在干净 worktree 仅套用 T-595 diff 后运行 `python -m ruff check app tests main.py`、`py -3.10 -m compileall app main.py`、`py -3.10 -m unittest discover -s tests`（370 tests）和 `git diff --check`，全部通过。
  - 真实只读验收未执行：本轮没有使用本机真实已登录账号、真实商品 ID 或真实 cmhub Key；已在 `docs/ai-studio-e2e-checklist.md` 写明人工验收步骤，不伪造真实验收结果。