diff --git a/docs/REDISIGN_TODO.md b/docs/REDISIGN_TODO.md new file mode 100644 index 0000000..6a2f021 --- /dev/null +++ b/docs/REDISIGN_TODO.md @@ -0,0 +1,356 @@ +# UI 重新设计 - 组件迁移任务清单 + +本文档列出了需要从 emoji 迁移到 SVG 图标的所有组件和任务。 + +## 组件迁移优先级 + +### 🔴 高优先级(核心导航和常用功能) + +#### 1. GlobalSidebar.vue +**emoji 数量**: 4 +**图标映射**: +- ✍️ → `edit` +- 📊 → `analysis` +- 📝 → `article` +- ⚙️ → `settings` + +**任务**: +- [ ] 导入 IconLibrary +- [ ] 替换所有导航项图标 +- [ ] 优化激活状态样式 +- [ ] 添加 hover 反馈 + +--- + +#### 2. MainContent.vue +**emoji 数量**: 14 +**图标映射**: +- 📋 → `copy` +- 🗑️ → `trash` / `delete` +- 🧠 → `sparkles` (AI 思考) +- 🔍 → `search` (质检) +- ✅ → `check` +- ⚠️ → `warning` +- ❌ → `error` +- 📄 → `document` +- ✨ → `sparkles` + +**任务**: +- [ ] 替换工具栏按钮图标 +- [ ] 替换空状态图标 +- [ ] 替换状态指示器图标 +- [ ] 优化按钮样式统一 + +--- + +#### 3. DocumentsPanel.vue +**emoji 数量**: 3 +**图标映射**: +- 📂 → `folder` +- 💾 → `save` +- 📋 → `copy` + +**任务**: +- [ ] 更新头部图标 +- [ ] 更新工具栏按钮 +- [ ] 统一按钮样式 + +--- + +### 🟡 中优先级(面板和功能页) + +#### 4. AnalysisPanel.vue +**emoji 数量**: 9 +**图标映射**: +- 📊 → `chart` +- ✨ → `sparkles` +- 🔍 → `search` +- ✅ → `check` +- ⚠️ → `warning` + +**任务**: +- [ ] 导入 IconLibrary +- [ ] 替换所有图标 +- [ ] 更新空状态设计 + +--- + +#### 5. ArticleRewritePanel.vue +**emoji 数量**: 8 +**图标映射**: +- 📝 → `edit` +- 🔍 → `search` +- ✨ → `sparkles` +- ✅ → `check` + +**任务**: +- [ ] 替换流程步骤图标 +- [ ] 更新按钮图标 +- [ ] 优化加载状态 + +--- + +#### 6. MaterialsPanel.vue +**emoji 数量**: 3 +**图标映射**: +- 📚 → `folder` +- 📊 → `chart` +- ➕ → `add` + +**任务**: +- [ ] 更新头部和按钮图标 +- [ ] 优化卡片设计 + +--- + +#### 7. SettingsPanel.vue +**emoji 数量**: 3 +**图标映射**: +- ⚙️ → `settings` +- 📊 → `chart` +- 📚 → `folder` +- 💾 → `save` +- 📥 → `download` +- 📤 → `upload` (如果有) + +**任务**: +- [ ] 替换区块标题图标 +- [ ] 更新操作按钮图标 + +--- + +### 🟢 低优先级(次要功能) + +#### 8. ComparePanel.vue +**emoji 数量**: 9 +**图标映射**: +- ⚖️ → `compare` +- 📝 → `edit` + +**任务**: +- [ ] 替换对比工具图标 +- [ ] 优化差异显示 + +--- + +#### 9. ParadigmWriterPanel.vue +**emoji 数量**: 4 +**图标映射**: +- 📝 → `edit` +- ✨ → `sparkles` + +**任务**: +- [ ] 更新进度指示器 +- [ ] 优化章节卡片 + +--- + +#### 10. DiffAnnotationPanel.vue +**emoji 数量**: 2 +**图标映射**: +- 📝 → `edit` +- 🔍 → `search` + +**任务**: +- [ ] 更新工具栏图标 + +--- + +#### 11. ParadigmSelectorModal.vue +**emoji 数量**: 1 +**图标映射**: +- 根据具体内容确定 + +**任务**: +- [ ] 更新范式列表图标 + +--- + +#### 12. DocumentVersionPanel.vue +**emoji 数量**: 1 +**图标映射**: +- 根据具体内容确定 + +**任务**: +- [ ] 更新版本历史图标 + +--- + +## 通用样式任务 + +### 按钮组件统一 + +创建可复用的按钮组件: + +**文件**: `src/components/BaseButton.vue` + +**功能**: +- [ ] 支持图标 + 文字组合 +- [ ] 支持纯图标模式 +- [ ] 支持多种变体:primary, secondary, danger, ghost +- [ ] 支持多种尺寸:sm, md, lg +- [ ] 内置加载状态 + +**示例**: +```vue + + 保存文档 + + + +``` + +--- + +### 状态指示器组件 + +**文件**: `src/components/StatusBadge.vue` + +**功能**: +- [ ] 支持 info, success, warning, error 状态 +- [ ] 使用 SVG 图标而非 emoji +- [ ] 一致的样式和间距 + +--- + +### 空状态组件 + +**文件**: `src/components/EmptyState.vue` + +**功能**: +- [ ] 支持自定义图标和文字 +- [ ] 支持操作按钮 +- [ ] 统一的视觉风格 + +--- + +## 设计系统优化 + +### 颜色对比度检查 + +- [ ] 验证所有文本颜色符合 WCAG AA 标准 +- [ ] 确保深色模式下对比度足够 +- [ ] 优化边框和分隔线可见性 + +### 间距系统审查 + +- [ ] 统一使用 `var(--space-*)` 令牌 +- [ ] 确保组件间距一致 +- [ ] 优化移动端间距 + +### 字体规范化 + +- [ ] 统一使用设计令牌中的字号 +- [ ] 规范字重使用场景 +- [ ] 优化行高和字间距 + +--- + +## 测试清单 + +### 功能测试 + +- [ ] 所有图标正确显示 +- [ ] 所有按钮可点击且状态正确 +- [ ] hover 和 active 状态正常 +- [ ] 加载状态显示正确 + +### 视觉回归测试 + +- [ ] 对比迁移前后截图 +- [ ] 检查布局是否一致 +- [ ] 验证间距和对齐 +- [ ] 确认颜色使用正确 + +### 浏览器兼容性 + +- [ ] Chrome 测试 +- [ ] Firefox 测试 +- [ ] Safari 测试 +- [ ] Edge 测试 + +### 响应式测试 + +- [ ] 桌面端 (1920px+) +- [ ] 笔记本 (1280-1440px) +- [ ] 平板 (768-1024px) +- [ ] 移动端 (<768px) + +--- + +## 实施建议 + +### 分阶段迁移 + +**第 1 周**: 高优先级组件 +- GlobalSidebar.vue +- MainContent.vue +- DocumentsPanel.vue + +**第 2 周**: 中优先级组件 +- AnalysisPanel.vue +- ArticleRewritePanel.vue +- MaterialsPanel.vue +- SettingsPanel.vue + +**第 3 周**: 低优先级组件 +- 剩余所有组件 +- 通用组件开发 +- 设计系统优化 + +### 每日工作流程 + +1. 选择 1-2 个组件 +2. 按照 `COMPONENT_REDESIGN_EXAMPLES.md` 迁移 +3. 本地测试功能正常 +4. 提交代码并推送 +5. 更新本文档的完成状态 + +### 代码审查要点 + +- [ ] 图标使用符合规范 +- [ ] 间距使用设计令牌 +- [ ] 颜色使用设计令牌 +- [ ] hover/focus 状态完整 +- [ ] 可访问性(aria-label) +- [ ] 响应式适配 + +--- + +## 进度跟踪 + +| 组件 | emoji 数量 | 状态 | 负责人 | 完成日期 | +|------|-----------|------|--------|----------| +| GlobalSidebar.vue | 4 | ⏳ 待开始 | - | - | +| MainContent.vue | 14 | ⏳ 待开始 | - | - | +| DocumentsPanel.vue | 3 | ⏳ 待开始 | - | - | +| AnalysisPanel.vue | 9 | ⏳ 待开始 | - | - | +| ArticleRewritePanel.vue | 8 | ⏳ 待开始 | - | - | +| MaterialsPanel.vue | 3 | ⏳ 待开始 | - | - | +| SettingsPanel.vue | 3 | ⏳ 待开始 | - | - | +| ComparePanel.vue | 9 | ⏳ 待开始 | - | - | +| ParadigmWriterPanel.vue | 4 | ⏳ 待开始 | - | - | +| DiffAnnotationPanel.vue | 2 | ⏳ 待开始 | - | - | +| ParadigmSelectorModal.vue | 1 | ⏳ 待开始 | - | - | +| DocumentVersionPanel.vue | 1 | ⏳ 待开始 | - | - | + +**图例**: +- ⏳ 待开始 +- 🔄 进行中 +- ✅ 已完成 +- ❌ 有问题 + +--- + +## 参考资料 + +- [图标系统使用指南](./ICON_SYSTEM.md) +- [组件重设计示例](./COMPONENT_REDESIGN_EXAMPLES.md) +- [设计令牌系统](../src/styles/design-tokens.css) + +--- + +**最后更新**: 2026-01-12 +**总计组件**: 12 +**总计 emoji**: 61 处 +**预计工作量**: 2-3 周