4.0 KiB
4.0 KiB
1. 第一阶段：提示词模板化
- 1.1 在 Application 层创建图标提示词配置类
IconPromptConfig - 1.2 在
IconPromptConfig中定义默认提示词模板属性 - 1.3 在
IconPromptConfig中定义风格参数属性（如StyleStrength、ColorScheme） - 1.4 将现有的硬编码提示词提取为模板字符串
- 1.5 在提示词模板中添加分类名称的动态占位符（如
{category_name}） - 1.6 在提示词模板中添加风格参数的动态占位符（如
{style_strength}、{color_scheme}） - 1.7 实现简单的模板引擎，支持占位符替换（使用字符串插值）
- 1.8 在 AI 服务调用逻辑中集成模板引擎
- 1.9 将旧提示词备份为配置文件，便于回滚
- 1.10 在配置文件中添加提示词版本号字段
2. 第二阶段：提示词优化
- 2.1 设计简约风格的提示词模板基础部分（包含"扁平化、单色、少细节、高对比度"等约束）
- 2.2 设计分类名称到视觉元素的映射规则文档
- 2.3 在提示词模板中添加分类语义信息的注入逻辑
- 2.4 为抽象分类（如"其他"、"通用"）设计特殊的视觉元素规则
- 2.5 在
IconPromptConfig中添加抽象分类的特殊处理配置 - 2.6 查阅当前使用的 AI 服务 API 文档，确认是否支持风格强度参数
- 2.7 如果支持，在 AI 服务调用中集成
StyleStrength参数 - 2.8 如果不支持，将风格强度信息注入到提示词模板中
- 2.9 在配置文件中添加默认风格强度值（如 0.7）
- 2.10 在配置文件中添加默认颜色方案（如单色灰色系）
3. 第三阶段：测试与验证
- 3.1 编写单元测试，验证提示词模板引擎的占位符替换功能
- 3.2 编写单元测试，验证简约风格提示词模板的生成逻辑
- 3.3 编写单元测试，验证抽象分类的特殊处理逻辑
- 3.4 编写单元测试，验证风格强度参数的注入逻辑
- 3.5 在测试环境使用现有分类名称批量生成新图标
- 3.6 对比新旧图标的可识别性，记录差异
- 3.7 编写集成测试，验证相同分类生成一致图标的场景
- 3.8 编写集成测试，验证不同分类生成区分明显图标的场景
- 3.9 邀请部分用户进行 A/B 测试，收集对新图标的反馈
- 3.10 根据测试结果微调提示词模板和风格参数
4. 第四阶段：灰度发布
- 4.1 在测试环境完整验证新提示词模板的生成效果
- 4.2 在配置文件中添加灰度发布开关（如
EnableNewPrompt: true/false） - 4.3 在配置文件中添加灰度比例配置（如
GrayScaleRatio: 0.1） - 4.4 修改图标生成逻辑，根据灰度比例决定使用新提示词还是旧提示词
- 4.5 部署灰度版本到生产环境（10% 用户使用新提示词）
- 4.6 监控图标生成成功率，记录生成失败的分类
- 4.7 监控用户反馈，记录对新图标的评价
- 4.8 如无异常，逐步扩大灰度比例（20% → 50% → 100%）
- 4.9 在灰度过程中，如果出现用户体验下降，立即回滚到旧提示词
- 4.10 记录每次提示词迭代的版本号、时间戳和变更内容
5. 文档与清理
- 5.1 更新 API 文档，说明提示词配置的参数含义（详见 .doc/category-visual-mapping.md 和 .doc/icon-prompt-testing-guide.md）
- 5.2 更新运维文档，说明如何调整提示词模板和风格参数（详见 .doc/icon-prompt-testing-guide.md）
- 5.3 更新故障排查文档，说明图标生成问题的排查步骤（详见 .doc/icon-prompt-testing-guide.md）
- 5.4 更新部署文档，说明灰度发布的操作流程（详见 .doc/icon-prompt-testing-guide.md）
- 5.5 清理测试代码中临时的调试日志和打印语句
- 5.6 代码 review 并确保符合项目代码风格规范
- 5.7 运行所有单元测试和集成测试，确保全部通过
- 5.8 运行前端 lint 和类型检查，确保代码质量