docs: 补 T-622 UI/UX 优化项 + 效果图落地 P1-P4/P5

ui-ux-pro-max 校验后修订(桌面可迁移规则):
- P1 套图结构压成常驻 chips + 渐进披露,核心控制不再被折叠
- P2 下拉值内联前缀(平台/国家/语言/比例),无 label 也保留语义
- P3 引导文案移到卖点框下、11px #6b7280 提高对比度
- P4 商品ID 恢复 w140 + 等宽数字,避免截断
- P5 失败卡加简短原因;空态引导记为实现期
- P6 小控件命中区/accessibleName 记为实现期加固

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
chengma
2026-07-14 09:02:50 +08:00
co-authored by Claude Opus 4.8
parent fb4403228d
commit fb873aae90
2 changed files with 36 additions and 30 deletions
+13
View File
@@ -83,6 +83,19 @@ UI 已定稿:`docs/ui/tab6-suite-package-v1.svg`(本仓库家风:`#2b3a55`
- 结果卡片:单击预览大图;右键菜单 预览 / 复制路径 / 打开文件夹 / 重新生成该图 / 删除;`×` 删除该图(移废纸篓 + 「撤销」toast);失败卡片 `重试`(`retryAsset`,已有生成任务进行中则提示)。
- `⋯` 更多(`moreMenu`):删除全部(`confirmDeleteAll`,二次确认,移废纸篓)。
## UI/UX 优化项(ui-ux-pro-max 校验后修订,effect 图已落 P1–P4/P5)
> 桌面 PySide6,取可迁移规则(对比度/标签/反馈/层级/空错态/截断),触控类规则不适用。P1–P4 为前几轮「腾纵向空间」引入的回归,已在 `tab6-suite-package-v1.svg` 修正;P5/P6 为实现期加固。
- **P1 核心控制被折叠**(`visual-hierarchy`/`content-priority`/`progressive-disclosure`):卖点框加高曾把「套图结构配置」挤到滚动线下,而它决定生成张数(=按钮 N)。**方案(已落图)**:结构配置压成常驻 chips「白底1 场景2 卖点2 +类」,点分类再展开 −/+(渐进披露),常可见不折叠;卖点框回收到合理高度。
- **P2 去 4 个下拉 label 影响辨识**(`input-labels`/`truncation-strategy`):`1:1` 等脱离 label 难认。**方案(已落图)**:下拉值内联前缀「平台 Shopee / 国家 中国台湾 / 语言 繁体中文 / 比例 1:1」,无独立 label 行也保留语义;实现层另加 `setToolTip`。
- **P3 引导文案字号/对比不足**(`color-contrast` CRITICAL / `contrast-readability`):原 9.5px + `#8a92a0` 属 gray-on-gray。**方案(已落图)**:移到卖点框下方作 helper text,≥11px、`#6b7280`。
- **P4 商品ID 压到 60% 会截断**(`truncation-strategy`/`number-tabular`):Shopee itemid 常 11–13 位,w90 放不下。**方案(已落图)**:恢复到 w140 并用等宽数字;空间靠缩「账号」下拉腾出。
- **P5 空态与失败原因**(`empty-states`/`error-recovery`/`error-clarity`):结果区首次未生成需空态引导「还没有生成,点『生成套图』开始」;失败卡除「重试」外显示简短原因(效果图示「上游超时」,实现取上游 error_type/message 截断)。
- **P6 小控件命中区**(`no-precision-required`,桌面按 ≥24–28px):计数器 −/+、chip 的 ×、缩略图删除,**视觉可小、hit area 放大到 ≥24–28px**;图标按钮补 `accessibleName`/tooltip,Tab 顺序符合视觉顺序(`keyboard-nav`)。
已做对、保持不变:单一蓝色主 CTA(`primary-action`);状态不靠颜色单独表达(打勾/感叹号/转圈,`color-not-only`);生成⇄停止 toggle + 确认 + 撤销 + 重试反馈完整;家风一致、非 emoji 图标。
## 边界(不改什么)
- 不改动 `image_studio.py / image_studio_generation.py / image_studio_export.py` 的后端数据契约与异步生图协议(仅按需扩展字段)。