linshen
71600b5081
## 核心架构重构 - 创建IImportExportable接口，定义统一的导入导出规范 - 新增ImportExportError错误类，提供专门的错误处理 - 将导入导出逻辑从集中式DataManager分散到各个服务 - DataManager职责精简：从375行减至67行(-308行)，仅负责协调 ## 存储键架构优化 - 移动storage-keys.ts从ui包到core包，实现统一管理 - 修复存储键双重用途问题：物理存储键vs逻辑JSON导出键 - PreferenceService添加'pref:'前缀处理物理存储 - 解决数据导出不完整的关键架构缺陷 ## 服务层改造 ### ModelManager - 实现IImportExportable接口(+209行,-153行) - 添加exportData/importData/validateData方法 - 保持向后兼容的数据格式 ### TemplateManager - 实现分布式导入导出逻辑 - 移除过度设计的configurable storageKey - 统一使用PreferenceService管理用户偏好 ### HistoryManager - 添加完整的导入导出实现 - 支持数据验证和错误处理 ### PreferenceService - 实现统一的用户设置导入导出 - 处理存储键前缀转换逻辑 - 支持builtin-template-language等核心设置 ## Electron桌面端更新 - main.js: 新增148行IPC处理逻辑 - preload.js: 新增177行API暴露 - 更新所有service proxy类支持新接口 - 保持IPC通信的类型安全 ## 测试体系完善 - 新增各服务专门的import-export.test.ts文件 - 创建data/import-export-integration.test.ts集成测试 - 建立AI自动化测试框架验证存储键一致性 - 更新现有测试适配新架构 ## 文档与架构说明 - 创建import-export-interface-design.md设计文档 - 添加storage-key-architecture.md架构说明 - 建立AI自动化测试文档体系 - 更新workspace文档记录重构过程 BREAKING CHANGE: 导入导出接口从集中式DataManager重构为分布式服务实现， 各服务现在必须实现IImportExportable接口，存储键架构发生变化
项目文档索引
欢迎来到Prompt Optimizer项目文档！本文档采用分级分类的组织方式，便于不同角色的用户快速找到所需信息。
📚 文档分类
👥 用户文档
面向最终用户的使用指南、部署说明和常见问题
- 桌面版用户手册
- Web版使用指南
- 部署指南（Vercel等）
- 常见问题解答
👨💻 开发者文档
面向开发者的技术文档、API参考和故障排查
- 技术开发指南
- 项目结构说明
- API文档
- 架构设计
- 故障排查清单
📋 项目管理文档
面向项目管理的需求文档、状态跟踪和规划
- 产品需求文档
- 项目状态和进度
- 版本管理策略
- 功能规划
📦 开发过程归档
按功能点归档的开发记录，用于跟踪和排错
- 101-singleton-refactor - 单例模式重构 ✅
- 102-web-architecture-refactor - Web架构重构 ✅
- 103-desktop-architecture - 桌面端架构 🔄
- 104-test-panel-refactor - 测试面板重构 📋
- 105-output-display-v2 - 输出显示v2 📋
- 106-template-management - 模板管理功能 🔄
🛠️ 开发工作区
当前开发阶段的临时文档和开发笔记
- 开发笔记和临时记录
- 待办事项
- 实验性设计
🚀 快速导航
我是用户
我是开发者
我是项目管理者
📖 重要文档
核心文档
专项文档
📋 使用指南
新成员入职
日常开发
项目管理
🔄 文档维护
维护原则
- 分类明确：按目标受众和用途分类存放
- 及时更新：代码变更时同步更新相关文档
- 定期整理：定期清理过期内容，整理工作区文档
- 交叉引用：在相关文档间建立引用关系
文档规范
- 使用Markdown格式
- 统一的标题层级结构
- 代码示例使用语法高亮
- 文档末尾标注更新时间
归档流程
- 新功能开发：在archives/中创建新的功能点目录（从107开始编号）
- 重要经验：及时从workspace/转移到archives/对应功能点
- 通用指南：从临时记录整理为正式的developer/文档
文档重构完成时间：2025-07-01 下一次整理计划：根据开发进度定期更新