Commit d784c99
committed
feat(favorite, ui): 完善收藏功能,引入独立标签管理、国际化支持及全面集成测试
本次更新全面增强收藏功能,引入独立的标签管理系统,完善了多语言支持,并对UI组件进行了优化。同时,新增了大量集成测试以确保功能的稳定性和数据完整性。
## 新增功能与优化
### 1. 独立标签管理系统
- **核心功能**:
- **独立标签库 (STORAGE_KEYS.TAGS)**: 实现标签的独立存储,不依赖收藏项,支持预先创建使用次数为0的标签。
- **标签CRUD操作**: 提供 `addTag()` (支持重复检测)、`renameTag()` (更新所有相关收藏和独立库)、`mergeTags()` (合并多个标签)、`deleteTag()` (从独立库和收藏中移除) 功能。
- **标签统计算法**: `getAllTags()` 方法返回独立标签库与收藏中使用标签的合集,并支持按使用次数降序排序。
- **导入导出优化**: 导出内容包含独立标签库,导入时自动重建,确保数据完整性。
- **类型转换工具 (TagTypeConverter)**: 解决API与UI格式不一致问题,提供 `toTagStatistics()`、`toAutoCompleteOptions()` 等转换方法,并支持多种排序。
- **错误处理增强**: 新增 `FavoriteTagError` 基类及 `FavoriteTagAlreadyExistsError`、`FavoriteTagNotFoundError` 等专用错误类型。
### 2. 标签管理器UI组件 (TagManager.vue)
- 提供完整的标签CRUD界面,包括数据表格展示、实时搜索、新增、重命名、合并、删除、分页功能。
- 技术栈:Naive UI (NDataTable, NModal, NPopconfirm),使用 `TagTypeConverter` 统一数据格式。
- 集成点:FavoriteManager.vue 中新增“标签管理”按钮以打开该对话框。
### 3. 智能标签建议 (useTagSuggestions)
- **智能自动完成**: 基于现有标签使用统计提供实时建议,热门标签优先,支持前缀匹配,并自动去重过滤。
- **API**: 提供 `loadTags()`、`filterTags()`、`getPopularTags()`、`getRecentTags()` 方法。
- 集成点:SaveFavoriteDialog.vue 中集成标签自动完成输入框。
### 4. 收藏功能国际化与UI优化
- **国际化覆盖 (中英繁)**:
- 新增 `favorites.dialog.*` (保存对话框)、`favorites.manager.*` (收藏管理器)、`favorites.manager.tagManager.*` (标签管理器)、`favorites.card.*` (收藏卡片) 等完整翻译键。
- 遵循翻译规范:使用全角标点、统一术语、简洁明了的提示信息。
- **UI组件优化**:
- **SaveFavoriteDialog.vue**:
- **标签自动完成集成**: 使用 `useTagSuggestions` 提供智能建议,支持回车添加,已选标签显示为可关闭 `Tag`,保存前自动注册标签到独立库。
- **智能预填充**: 根据模式(创建/保存/编辑)智能预填充标题和内容。
- **FavoriteManager.vue**:
- 新增“标签管理”按钮。
- 网格布局优化 (使用 `NGrid` 替代 `flex`)。
- 工具栏固定,响应式设计。
- 移除冗余视图切换,简化布局。
- **FavoriteCard.vue**:
- 卡片布局优化:使用 `NTag` 展示标签,显示元信息 (创建时间、使用次数、功能模式),操作按钮 (编辑、删除、应用),悬停效果。
- **用户体验提升**: 优化标签输入和管理流程,增强错误处理(如 `TAG_ALREADY_EXISTS` 静默忽略,其他错误显示友好提示)。
### 5. 分类管理架构优化与国际化
- **架构优化**:
- 分离关注点:默认分类创建从 Core 层移至 UI 层,Core 层不再硬编码分类名称,改为接受配置参数。
- 添加初始化标记防止重复创建默认分类。
- `deleteCategory` 现返回受影响的收藏数量。
- **国际化增强**:
- 新增 `useFavoriteInitializer` composable 管理国际化分类。
- 完善中英繁三语言的分类翻译。
- 优化默认分类配置 (新增“学习研究”和“日常助手”)。
- 统一错误信息为英文。
- **代码组织**:
- 测试文件迁移至标准目录 `packages/core/tests/`。
- 改进 `FavoriteManager` 组件生命周期管理,优化初始化流程。
### 6. 全面集成测试
- 新增 `integration.test.ts` (742行,20个集成测试),覆盖以下场景:
- CRUD 完整流程测试 (3个)。
- 历史记录转收藏测试 (5个,覆盖12种 PromptRecordType)。
- 标签和分类管理测试 (6个:重命名/合并/删除/排序/统计/级联)。
- 导入导出完整性测试 (2个)。
- 搜索和过滤功能测试 (4个)。
- `type-converter.test.ts` 包含16个测试,`tag-manager.test.ts` 包含23个测试。1 parent 5bf02fa commit d784c99
File tree
21 files changed
+3907
-163
lines changed- packages
- core
- src
- services/favorite
- tests/services/favorite
- ui/src
- components
- composables
- i18n/locales
21 files changed
+3907
-163
lines changed| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
147 | 147 | | |
148 | 148 | | |
149 | 149 | | |
| 150 | + | |
150 | 151 | | |
151 | 152 | | |
152 | 153 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
5 | 5 | | |
6 | 6 | | |
7 | 7 | | |
8 | | - | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
9 | 14 | | |
10 | 15 | | |
11 | 16 | | |
| |||
48 | 53 | | |
49 | 54 | | |
50 | 55 | | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
| 60 | + | |
| 61 | + | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
51 | 73 | | |
52 | 74 | | |
53 | 75 | | |
| |||
100 | 122 | | |
101 | 123 | | |
102 | 124 | | |
103 | | - | |
| 125 | + | |
104 | 126 | | |
105 | 127 | | |
106 | 128 | | |
| |||
134 | 156 | | |
135 | 157 | | |
136 | 158 | | |
| 159 | + | |
| 160 | + | |
| 161 | + | |
| 162 | + | |
137 | 163 | | |
138 | 164 | | |
139 | 165 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
11 | 11 | | |
12 | 12 | | |
13 | 13 | | |
14 | | - | |
| 14 | + | |
15 | 15 | | |
16 | 16 | | |
17 | 17 | | |
18 | 18 | | |
19 | 19 | | |
20 | 20 | | |
21 | | - | |
| 21 | + | |
22 | 22 | | |
23 | 23 | | |
24 | 24 | | |
25 | 25 | | |
26 | 26 | | |
27 | 27 | | |
28 | | - | |
| 28 | + | |
29 | 29 | | |
30 | 30 | | |
31 | 31 | | |
32 | 32 | | |
33 | 33 | | |
34 | 34 | | |
35 | | - | |
| 35 | + | |
36 | 36 | | |
37 | 37 | | |
38 | 38 | | |
39 | 39 | | |
40 | 40 | | |
41 | | - | |
42 | | - | |
| 41 | + | |
| 42 | + | |
43 | 43 | | |
44 | 44 | | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
| 55 | + | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
| 60 | + | |
| 61 | + | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
| 90 | + | |
| 91 | + | |
| 92 | + | |
| 93 | + | |
| 94 | + | |
45 | 95 | | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | 3 | | |
4 | | - | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
0 commit comments