linshen
acf592ab2c
- 添加模板管理故障排除清单，以帮助用户解决模板管理中遇到的常见问题。 - 统一服务注入逻辑，移除不必要的props定义，增强错误处理机制。 - 优化模板管理，统一服务注入与存储键管理。 - 更新 `TemplateSelect.vue`，移除 `services` prop，改用 `inject` 注入服务。 - 整合 `useTemplateManager`，统一模板选择保存逻辑及存储键管理。 - 新增 `storage-keys.ts`，集中管理存储键常量，避免重复定义，便于维护与遍历。 - 更新相关组件以适配新的模板管理方式，确保模板选择状态正确保存和恢复。 - 修正了模板类型错误的问题，确保在管理界面切换分类后添加的模板类型与当前显示的分类一致。 - 修复了模板管理器打开位置错误的问题，确保从不同入口打开模板管理器时，定位到正确的分类。 - 优化了模板保存和导入逻辑，增加了错误处理和提示。 - 确保所有异步模板操作都使用了 `await` 关键字，避免潜在的时序问题。 - 移除了 `usePromptOptimizer` 中 `selectedOptimizationMode` 的默认值，强制传入该参数。 - 优化了 `TemplateSelect` 组件中 `optimizationMode` prop 的处理，设为 `required`。
67 lines
2.2 KiB
Markdown
67 lines
2.2 KiB
Markdown
# 组件标准化重构
|
|
|
|
## 📋 功能概述
|
|
|
|
将项目中所有模态框/弹窗类组件的行为和API统一，使其完全符合"最佳实践范式"，提高代码一致性、可维护性和开发者体验。
|
|
|
|
## 🎯 目标
|
|
|
|
- 统一所有模态框组件的prop为`modelValue`
|
|
- 为所有模态框添加`Escape`键支持
|
|
- 建立统一的组件API规范
|
|
- 提高代码一致性和可维护性
|
|
|
|
## 📅 时间线
|
|
|
|
- **开始时间**: 2025-07-01
|
|
- **当前状态**: 🔄 进行中
|
|
- **预计完成**: 2025-07-15
|
|
|
|
## 🎯 涉及组件
|
|
|
|
| 组件 | 目标Prop | `Escape`键支持 | 状态 |
|
|
| :--- | :--- | :--- | :--- |
|
|
| **`FullscreenDialog.vue`** | ✅ `modelValue` | ✅ 已支持 | **最佳范式** |
|
|
| **`Modal.vue`** | ✅ `modelValue` | ⏳ **待实现** | `v-model`已规范 |
|
|
| **`DataManager.vue`** | ⏳ **`modelValue`** | ✅ 已支持 | `Esc`键已规范 |
|
|
| **`HistoryDrawer.vue`** | ⏳ **`modelValue`** | ✅ 已支持 | `Esc`键已规范 |
|
|
| **`ModelManager.vue`** | ⏳ **`modelValue`** | ⏳ **待实现** | **需要改进** |
|
|
| **`TemplateManager.vue`** | ⏳ **`modelValue`** | ⏳ **待实现** | **需要改进** |
|
|
|
|
## 📋 任务清单
|
|
|
|
### 1. 标准化Prop为 `modelValue`
|
|
- [ ] `DataManager.vue`
|
|
- [ ] `HistoryDrawer.vue`
|
|
- [ ] `ModelManager.vue`
|
|
- [ ] `TemplateManager.vue`
|
|
- [ ] **`App.vue`**: 更新所有对上述组件的调用，将 `v-model:show="..."` 修改为 `v-model="..."`
|
|
|
|
### 2. 补全 `Escape` 键支持
|
|
- [ ] `ModelManager.vue`
|
|
- [ ] `TemplateManager.vue`
|
|
- [ ] `Modal.vue` (基础组件)
|
|
|
|
### 3. 后续重构与优化
|
|
- [ ] 修复 `ModelManager.vue` 弹窗问题 (高优先级)
|
|
- [ ] 解决 TypeScript 类型错误 (中优先级)
|
|
- [ ] 修复 CSS 兼容性问题 (低优先级)
|
|
- [ ] 统一模态框（Modal）组件实现 (长期)
|
|
|
|
## 📚 相关文档
|
|
|
|
- [模态框最佳实践](./best-practices.md)
|
|
- [组件API规范](./api-specification.md)
|
|
- [实现指南](./implementation-guide.md)
|
|
|
|
## 🔗 关联功能
|
|
|
|
- [106-template-management](../106-template-management/) - 模板管理功能
|
|
- [102-web-architecture-refactor](../102-web-architecture-refactor/) - Web架构重构
|
|
|
|
---
|
|
|
|
**状态**: 🔄 进行中
|
|
**负责人**: AI Assistant
|
|
**最后更新**: 2025-07-01
|