spec.md 4.67 KB

UI一致性和布局优化规范

ADDED Requirements

Requirement: 款式设计页面应与图片生成页面保持结构一致

款式设计标签页的下半部分布局 SHALL 与图片生成标签页保持一致,确保用户在两个核心功能页面之间切换时获得连贯的体验。

Scenario: 用户在两个页面间切换

Given 用户打开应用程序 When 用户切换到"款式设计"标签页 Then 页面结构应与"图片生成"标签页相同 And "生成设置"、"生成按钮"、"结果展示"的排列顺序一致 And 两个页面的视觉风格和间距保持一致

Requirement: 珠宝元素选择应使用双列布局

为了提高空间利用率和表单紧凑性,珠宝元素选择区域 SHALL 采用每行两列的网格布局。

Scenario: 显示珠宝元素选择表单

Given 用户打开款式设计标签页 When 页面渲染珠宝元素选择区域 Then 每行应显示两个元素组(标签+下拉框+按钮) And 下拉框宽度应适中(不超过容器的40%) And 按钮尺寸应缩小至紧凑模式

Requirement: 文字行高应设置为18px

所有文本标签 SHALL 使用统一的行高以提升可读性。

Scenario: 渲染文本内容

Given 款式设计页面包含各种文本标签 When 页面渲染这些文本 Then 所有 QLabel 的 line-height 应为 18px And font-size 应为 14px

Requirement: 移除单个类别的恢复默认按钮

为了简化界面,每行的单独恢复按钮 SHALL 被移除,仅保留全局恢复按钮。

Scenario: 查看珠宝元素操作按钮

Given 用户查看珠宝元素选择的某一行 When 用户检查该行的操作按钮 Then 应只显示"添加"和"删除"按钮 And 不应显示单独的"恢复默认"按钮 And 全局"恢复所有默认词库"按钮应保留

Requirement: 预览图片应完整显示不被裁剪

生成结果的预览图片 SHALL 完整显示,保持宽高比且不被裁剪。

Scenario: 显示生成的预览图

Given 用户生成了一张珠宝图片 When 图片在结果预览区显示 Then 图片应完整可见 And 应保持原始宽高比 And 不应出现裁剪现象 And 图片应适应显示区域大小

MODIFIED Requirements

Requirement: 主石字段应拆分为形状和材质

原有的"主石"单一字段 SHALL 拆分为"主石形状"和"主石材质"两个独立字段,以降低选项数量和认知负担。

Scenario: 用户选择主石属性

Given 用户在款式设计页面选择主石 When 用户查看主石相关选项 Then 应显示两个独立的下拉框:"主石形状"和"主石材质" And "主石形状"包含: 圆形、方形、椭圆形、水滴形、心形等 And "主石材质"包含: 钻石、蓝宝石、红宝石、祖母绿等 And 选择后应正确组合到prompt中(如"圆形钻石")

Scenario: 数据迁移兼容性

Given 系统包含旧版的"主石"词库数据 When 应用升级并加载词库 Then 应自动拆分旧数据为形状和材质 Or 如果拆分失败,应使用默认词库

Requirement: 生成过程应使用非阻塞状态提示

原有的模态对话框 SHALL 替换为非阻塞的状态标签,允许用户在生成过程中执行其他操作。

Scenario: 用户点击生成按钮

Given 用户填写了款式设计表单 When 用户点击"生成珠宝图片"按钮 Then 应在状态标签显示"● 生成中..." And 生成按钮应禁用(防止重复点击) And 不应弹出模态对话框 And 用户应能切换到其他标签页

Scenario: 生成完成或失败

Given 图片生成完成(成功或失败) When 回调函数触发 Then 状态标签应更新为"● 就绪"或"● 失败" And 生成按钮应重新启用 And 成功时应显示非阻塞的信息提示 And 失败时应显示错误消息框

REMOVED Requirements

Requirement: 移除Prompt预览区

Prompt预览区域包含技术细节,SHALL NOT 向普通用户暴露。

Scenario: 查看款式设计页面

Given 用户打开款式设计标签页 When 用户查看页面内容 Then 不应显示"Prompt 预览"分组框 And 内部仍应保留 prompt_preview 变量用于生成逻辑 And 不应影响实际的prompt生成功能

Requirement: 移除模型选择器

模型选择器属于高级技术选项,SHALL NOT 暴露给普通用户。

Scenario: 查看生成设置

Given 用户查看款式设计的生成设置区域 When 用户检查可配置选项 Then 不应显示"模型"标签和下拉框 And 应使用硬编码的默认模型 "imagen-3.0-generate-002" And 用户仍可配置宽高比和图片尺寸