mirror of
https://github.com/linshenkx/prompt-optimizer.git
synced 2026-05-10 15:49:18 +08:00
acf592ab2c
- 添加模板管理故障排除清单，以帮助用户解决模板管理中遇到的常见问题。 - 统一服务注入逻辑，移除不必要的props定义，增强错误处理机制。 - 优化模板管理，统一服务注入与存储键管理。 - 更新 `TemplateSelect.vue`，移除 `services` prop，改用 `inject` 注入服务。 - 整合 `useTemplateManager`，统一模板选择保存逻辑及存储键管理。 - 新增 `storage-keys.ts`，集中管理存储键常量，避免重复定义，便于维护与遍历。 - 更新相关组件以适配新的模板管理方式，确保模板选择状态正确保存和恢复。 - 修正了模板类型错误的问题，确保在管理界面切换分类后添加的模板类型与当前显示的分类一致。 - 修复了模板管理器打开位置错误的问题，确保从不同入口打开模板管理器时，定位到正确的分类。 - 优化了模板保存和导入逻辑，增加了错误处理和提示。 - 确保所有异步模板操作都使用了 `await` 关键字，避免潜在的时序问题。 - 移除了 `usePromptOptimizer` 中 `selectedOptimizationMode` 的默认值，强制传入该参数。 - 优化了 `TemplateSelect` 组件中 `optimizationMode` prop 的处理，设为 `required`。
1.4 KiB
1.4 KiB
故障排查指南
这里包含了开发过程中常见问题的排查清单和解决方案。
📋 排查清单
通用问题
- 通用排查清单 - UI模块文件级排查清单，按具体文件组织的问题排查指南
特定功能问题
- 模板管理问题 - 参见归档文档 106-template-management
🔍 问题分类
应用启动问题
- 应用无法启动
- 白屏问题
- 服务初始化失败
组件渲染问题
- 模态框显示异常
- 组件状态错误
- 响应式数据问题
异步操作问题
- API调用失败
- 异步方法缺少await
- 时序问题
架构相关问题
- 依赖注入问题
- Composable使用错误
- 服务层问题
📝 使用说明
- 定位问题类型：根据问题现象确定属于哪个分类
- 查看对应清单：找到相关的排查清单文档
- 按步骤排查：按照清单逐项检查
- 记录解决方案：解决问题后更新相关文档
🔄 文档维护
- 每次解决新问题后，考虑更新相关排查清单
- 定期审查排查清单的有效性
- 将常见问题的解决方案添加到清单中
📞 获取帮助
如果排查清单无法解决问题：
- 查看相关的归档文档中的经验总结
- 在项目仓库提交Issue
- 联系项目团队