Change: Add Style Designer Tab

Why

现有系统要求用户上传参考图片，对于珠宝设计场景门槛高且不够专业。添加款式设计页面，通过标准化元素表单组装 prompt，降低使用门槛并提供专业词库支持。

What Changes

• 新增"款式设计" Tab，位于"图片生成"和"历史记录"之间
• 提供 7 类珠宝元素表单（主石、金属、花头形式、戒臂结构、戒臂处理、特殊元素、辅石镶嵌）
• 纯中文提示词：配置、UI、Prompt 全部使用中文（Gemini 支持中文 prompt）
• 智能 prompt 组装逻辑，处理空值情况
• 配置文件管理词库（jewelry_library.json，纯中文数组）
• 每个选项支持扩充、删除、恢复默认
• 复用现有文生图 API
• 提供结果展示与下载

Impact

• Affected specs: style-designer-ui (新增)
• Affected code:
  • image_generator.py (主窗口 Tab 插入，新增 StyleDesignerTab 类)
  • 新增配置文件 jewelry_library.json

---

Detailed Context

Motivation

问题来源：

• 现有系统要求用户上传参考图片，对于珠宝设计场景门槛较高
• 用户可能不懂如何撰写专业的珠宝设计 prompt
• 缺少标准化的珠宝设计词汇库支持

当前痛点：

• 需要找到或准备参考图才能开始设计
• 自由文本输入容易产生不专业或不准确的描述
• 缺少珠宝领域的专业引导
• 词库需要灵活维护和扩展

为什么现在要做：

• 用户已明确提出需求，有实际使用场景
• 技术上可复用现有文生图 API，实现成本低
• 能显著降低珠宝设计的使用门槛
• 词库配置化使系统更灵活

Scope

In Scope

• 新增"款式设计" Tab 页面
• 7 类珠宝元素的表单输入：
  1. CENTER_STONE（主石）
  2. METAL（金属）
  3. HALO_STYLE（花头形式）
  4. SHANK_STRUCTURE（戒臂结构）
  5. SHANK_TREATMENT（戒臂处理）
  6. SPECIAL_MOTIFS（特殊元素）
  7. ACCENT_SETTING（辅石镶嵌）
• 中英文双语支持（界面中文，实际值英文）
• 智能 prompt 组装逻辑（处理空值情况）
• 配置文件管理词库（jewelry_library.json）
• UI 支持词库增删改：每个字段的词库可以添加、删除自定义项
• 恢复默认词库功能：一键重置为初始词库
• 复用现有文生图 API 生成图片
• 生成结果展示与下载

Out of Scope

• 款式设计历史记录独立管理（本期复用通用历史记录）
• 款式模板预设（本期仅支持自由组合）
• AI 辅助推荐合理搭配
• 词库云端同步

Stakeholders

• 用户：珠宝设计师、设计需求方
• 开发团队：负责实现与维护

Success Criteria

• 用户能在"款式设计" Tab 填写元素并生成珠宝图片
• 所有字段都是可选的，特别是主石可以为空
• Prompt 组装逻辑能智能处理空值
• 生成的图片质量符合珠宝设计需求
• 界面显示中文，但实际发送给 API 的是英文
• 用户可以在 UI 中为任意字段添加、删除词库项
• 词库修改后持久化到配置文件
• 用户可以一键恢复默认词库

Dependencies

• 现有 Gemini API 文生图功能
• 现有 UI 框架（PySide6）
• 现有配置文件管理机制

Timeline

不设定时间线，按任务优先级完成即可。

Alternatives Considered

方案 A：扩展现有"图片生成" Tab

拒绝理由：

• 珠宝设计是独立场景，混在一起会导致界面混乱
• 用户明确要求"新的页面"

方案 B：硬编码词库

拒绝理由：

• 用户要求支持词库的补充/删除
• 硬编码无法灵活扩展

方案 C：使用数据库管理词库

拒绝理由：

• 过度设计，配置文件已足够
• 增加部署复杂度

Risks

风险	影响	缓解措施
元素组合可能产生不合理描述	中	先验证常见组合，提供使用建议
词库配置文件格式错误	中	加载时校验，提供默认值兜底
兼容性破坏	无	新增功能，不影响现有页面
用户误删关键词库项	低	提供恢复默认词库功能

Open Questions

无待解决问题

---

提案人：Claude 创建日期：2025-12-10 状态：Draft