cmshoppe/docs/tasks/T-609.md

---
id: T-609
title: AI工场终选区改为主图与详情图双单行轨道
phase: 7
deps: [T-608]
status: DONE
created: 2026-07-11
---

## 问题 / 背景

⑥AI工场的「终选与排序」当前使用“主图列 + 详情图列 + 导出列”的横向三栏布局。主图、详情图各自的 `QListWidget` 保持默认列表展示，终选槽会纵向占用较大高度；在主图与详情图数量增多时，底部区域挤占照片池和生成设置的可见空间，也不符合 `docs/ui/tab6-ai-studio-v3.svg` 中“主图、详情图各一条横向排序轨道”的工作流表达。

运营在终选阶段的主要动作是：从照片池拖入、查看顺序、拖动重排和导出。主图（最多 9 张）与详情图（最多 12 张）应各自保持独立顺序，但应在同一终选区内以两条清晰、紧凑的横向轨道展示。

本任务目标：**把终选区改为主图一行、详情图一行的横向轨道，固定并压缩其垂直高度，将释放的空间交给上方照片池与生成设置区域，同时不改变终选数据和拖拽排序语义。**

## 方案

### 1. 终选区改为双单行轨道

修改 `app/gui/tabs/image_studio.py` 的终选区布局：

- 外层从横向三栏布局改为纵向结构：顶部为「终选与排序」标题与简短提示，下方依次为「主图终选」和「详情图终选」两条横向轨道。
- 每条轨道左侧保留固定宽度的中文类型/数量 label，例如 `主图 5/9`、`详情 3/12`；中间为对应的终选列表；右侧保留导出状态与「导出到文件夹」按钮，纵向跨两条轨道。
- `ImageStudioSelectionList` 明确设置为图标视图、从左到右流向、不换行、固定 item/grid 尺寸；不足数量仍显示稳定的「空位」槽，不因文字、状态或缩略图变化导致跳动。
- 主图轨道缩略图约 48px，详情图约 36~40px；在 1280px 宽的常用窗口下，9 个主图槽和 12 个详情图槽均应优先完整可见。更窄窗口允许轨道本身横向滚动，不得换为多行、重叠或压缩文字。
- 保持现有拖入、落在已占槽时插入顺延、同轨道拖动排序、Delete 移出终选和双击预览行为；主图、详情图仍为两套互不混淆的排序序列。

### 2. 将释放的垂直空间让给上方工作区

- 终选区设为稳定的紧凑高度目标约 150~170px，避免 `QListWidget` 按纵向内容撑高底部。
- 保留根布局中上方 `main_splitter` 的 stretch 行为，让终选区压缩后释放的高度自动增加到上方工作区，优先扩大照片池可见区域；不额外创建浮动卡片或滚动嵌套。
- 导出区域改为紧凑、可扫读的右侧区域：保留部分导出提示、主图/详情图计数和导出按钮；不因布局改动隐藏现有导出冲突处理语义。
- 在 1280×820 和较窄窗口验证：两条终选轨道、导出按钮、照片池和生成设置均不重叠；窄窗口下列表能独立横向滚动，页面整体不出现不可达控件。

### 3. 不改变业务数据与导出语义

- 继续使用已有 `image_studio_selections` 数据、`main` / `detail` 两类 selection、顺序字段、拖拽处理和导出服务。
- 不修改项目、资产、任务、终选 SQLite schema，不迁移历史数据。
- 不改变照片池、生成、原图下载队列、cmhub、蝦皮 CDP、导出文件名或覆盖/新建目录确认逻辑。
- 所有新增或调整的用户可见文案保持中文。

## 验收要点

- 「终选与排序」内主图与详情图分别只显示一条横向轨道，不再是左右分栏的两个纵向列表。
- 主图最多 9 个槽、详情图最多 12 个槽；空位、缩略图、顺序标识和比例警示在单行内稳定显示。
- 在 1280×820 下，两条轨道与导出区域均完整可见，终选区高度约 150~170px；释放出的高度由上方照片池/生成设置区域获得。
- 在窄窗口下，单条终选轨道使用自身横向滚动，不换行、不重叠、不挤压为不可读文字。
- 从照片池拖到主图/详情图、拖动重排、插入顺延、删除移出、双击预览和状态禁用逻辑保持原行为；两类终选顺序写入 SQLite 后重启仍正确。
- 导出按钮、部分导出提示、终选数量和导出冲突处理仍可用，且不被终选轨道遮挡。
- 不改 SQLite schema、图片文件、cmhub、生图、原图下载、导出服务、CDP 或①至⑤模块。

## 测试要求

更新或新增 `tests/test_gui.py`：

- 覆盖终选区结构为标题 + 主图单行轨道 + 详情图单行轨道 + 导出区，不再依赖左右分栏。
- 覆盖主图 9 槽、详情图 12 槽的固定数量、图标尺寸、单行/不换行和稳定 grid 尺寸。
- 覆盖已有的拖入、插入顺延、同轨重排、Delete 移出和持久化顺序在新布局下仍正确。
- 覆盖 1280×820 与较窄宽度下的尺寸约束：终选区不异常撑高、控件不重叠，窄宽时横向滚动可用。
- 覆盖运行中禁用与导出按钮/提示仍可访问。

验证命令：

```bash
python -m ruff check app tests main.py
py -3.10 -m compileall app main.py
py -3.10 -m unittest discover -s tests
git diff --check
```

人工验收建议：

- 准备主图 9 张、详情图 12 张的项目，在 1280×820 下确认两条轨道的槽位、顺序、导出区域和照片池可见面积。
- 缩窄窗口后分别横向滚动主图和详情图轨道，验证不换行、不遮挡，并验证拖入、排序、删除和导出。

## 边界（不改什么）

- 不新增终选类型、批量导出模式、拖拽跨类型自动转换或本地图片导入。
- 不修改 `app/image_studio.py`、`app/image_studio_export.py`、SQLite schema 或历史终选记录。
- 不调整原图区、照片池缩略图尺寸、原图下载并发/重试或生成参数。
- 不改①至⑤模块、cmhub 协议、蝦皮 CDP 流程和登录策略。

## 执行记录

- 2026-07-11：将 AI工场终选区改为标题行 + 主图单行轨道 + 详情图单行轨道；右侧导出状态和导出按钮跨两条轨道，终选区高度限制为 150~170px，释放的高度由上方工作区获得。
- 2026-07-11：终选列表明确使用图标模式、从左到右、不换行、固定 grid 和独立横向滚动；主图 9 槽使用 48px 缩略图，详情图 12 槽使用 38px 缩略图。空位保留可落入语义并以虚线槽稳定显示。
- 2026-07-11：保留拖入、插入顺延、同轨重排、Delete 移出、双击预览、SQLite 顺序持久化和导出逻辑；新增动态终选计数提示与 GUI 布局回归测试。
- 2026-07-11：人工截图检查 1280×820 下双轨道、导出区与照片池无重叠。干净 worktree 验证通过：`python -m ruff check app tests main.py`、`py -3.10 -m compileall app main.py`、`py -3.10 -m unittest discover -s tests`（387 项）、`git diff --check`。主工作区另有未提交默认提示词文件变更，未纳入本任务修改。