归档

openspec/changes/archive/2026-02-21-icon-search-integration/proposal.md

@@ -0,0 +1,28 @@
+## Why
+
+现有的AI生成SVG图标方案不够直观，生成的图标与分类名称不匹配，影响用户体验。通过集成Iconify API检索真实图标库，可以提高图标的可视化质量和相关性。
+
+## What Changes
+
+- 新增图标搜索服务，集成Iconify API
+- 修改TransactionCategory.Icon字段，从存储SVG格式改为存储Iconify图标标识符（如"mdi:home"）
+- 新增TransactionCategory.IconKeywords字段，存储AI生成的搜索关键字（JSON数组）
+- 新增AI搜索关键字生成功能，根据分类名称生成英文搜索词
+- **BREAKING**: 移除现有的AI生成SVG图标逻辑，完全替换为Iconify检索方案
+- 新增API接口：搜索图标、生成搜索关键字、更新分类图标
+
+## Capabilities
+
+### New Capabilities
+- `icon-search`: 图标搜索与集成能力，包括Iconify API集成、AI生成搜索关键字、图标存储与检索
+
+### Modified Capabilities
+- `ai-category-icon-generation`: 修改图标生成方式，从AI生成SVG改为使用Iconify API检索和存储图标
+
+## Impact
+
+- **Entity层**: 修改TransactionCategory实体（Icon字段改为存储Iconify标识符，新增IconKeywords字段）
+- **Service层**: 新增IconSearchService（Iconify API集成、AI关键字生成）
+- **WebApi层**: 新增IconController（搜索图标、生成搜索关键字、更新分类图标）
+- **数据库**: 无需新增表，TransactionCategory表已有Icon字段，新增IconKeywords字段
+- **依赖**: 新增Iconify API依赖，无需额外的npm包（前端直接使用Iconify图标）