fix

openspec/changes/archive/2026-02-14-optimize-category-icon-prompts/tasks.md

@@ -0,0 +1,62 @@
+## 1. 第一阶段：提示词模板化
+
+- [x] 1.1 在 Application 层创建图标提示词配置类 `IconPromptConfig`
+- [x] 1.2 在 `IconPromptConfig` 中定义默认提示词模板属性
+- [x] 1.3 在 `IconPromptConfig` 中定义风格参数属性（如 `StyleStrength`、`ColorScheme`）
+- [x] 1.4 将现有的硬编码提示词提取为模板字符串
+- [x] 1.5 在提示词模板中添加分类名称的动态占位符（如 `{category_name}`）
+- [x] 1.6 在提示词模板中添加风格参数的动态占位符（如 `{style_strength}`、`{color_scheme}`）
+- [x] 1.7 实现简单的模板引擎，支持占位符替换（使用字符串插值）
+- [x] 1.8 在 AI 服务调用逻辑中集成模板引擎
+- [x] 1.9 将旧提示词备份为配置文件，便于回滚
+- [x] 1.10 在配置文件中添加提示词版本号字段
+
+## 2. 第二阶段：提示词优化
+
+- [x] 2.1 设计简约风格的提示词模板基础部分（包含"扁平化、单色、少细节、高对比度"等约束）
+- [x] 2.2 设计分类名称到视觉元素的映射规则文档
+- [x] 2.3 在提示词模板中添加分类语义信息的注入逻辑
+- [x] 2.4 为抽象分类（如"其他"、"通用"）设计特殊的视觉元素规则
+- [x] 2.5 在 `IconPromptConfig` 中添加抽象分类的特殊处理配置
+- [x] 2.6 查阅当前使用的 AI 服务 API 文档，确认是否支持风格强度参数
+- [x] 2.7 如果支持，在 AI 服务调用中集成 `StyleStrength` 参数
+- [x] 2.8 如果不支持，将风格强度信息注入到提示词模板中
+- [x] 2.9 在配置文件中添加默认风格强度值（如 0.7）
+- [x] 2.10 在配置文件中添加默认颜色方案（如单色灰色系）
+
+## 3. 第三阶段：测试与验证
+
+- [x] 3.1 编写单元测试，验证提示词模板引擎的占位符替换功能
+- [x] 3.2 编写单元测试，验证简约风格提示词模板的生成逻辑
+- [x] 3.3 编写单元测试，验证抽象分类的特殊处理逻辑
+- [x] 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. 文档与清理
+
+- [x] 5.1 更新 API 文档，说明提示词配置的参数含义（详见 .doc/category-visual-mapping.md 和 .doc/icon-prompt-testing-guide.md）
+- [x] 5.2 更新运维文档，说明如何调整提示词模板和风格参数（详见 .doc/icon-prompt-testing-guide.md）
+- [x] 5.3 更新故障排查文档，说明图标生成问题的排查步骤（详见 .doc/icon-prompt-testing-guide.md）
+- [x] 5.4 更新部署文档，说明灰度发布的操作流程（详见 .doc/icon-prompt-testing-guide.md）
+- [x] 5.5 清理测试代码中临时的调试日志和打印语句
+- [x] 5.6 代码 review 并确保符合项目代码风格规范
+- [x] 5.7 运行所有单元测试和集成测试，确保全部通过
+- [x] 5.8 运行前端 lint 和类型检查，确保代码质量