本索引按功能特性对所有归档文档进行分类，帮助快速定位相关内容。
-
101-singleton-refactor - 单例模式重构
- 移除项目中的单例模式，改为依赖注入架构
- 提高代码的可测试性和可维护性
- 为后续架构重构奠定基础
-
102-web-architecture-refactor - Web架构重构
- 基于单例重构的基础，对Web应用和浏览器插件架构进行全面重构
- 采用统一的Composable架构
- 修复应用启动失败问题
-
103-desktop-architecture - 桌面端架构
- 桌面端（Electron）架构的设计和重构
- 确保与Web端架构的一致性
- 进程间通信优化
-
111-electron-preference-architecture - Electron偏好架构
- Electron PreferenceService架构重构
- 竞态条件修复
- 跨进程状态管理优化
-
121-context-editor-refactor - 上下文编辑器重构 🆕
- 清理和优化上下文编辑器相关组件结构
- 移除废弃组件（ConversationMessageEditor、ConversationSection）
- API清理：移除未使用的props传递，提升代码可维护性
- 零功能影响的维护性重构
-
106-template-management - 模板管理功能
- 模板的增删改查功能
- 异步操作优化
- 用户体验改进
-
107-component-standardization - 组件标准化重构
- 统一所有模态框/弹窗类组件的行为和API
- 建立统一的组件API规范
- 提高代码一致性和可维护性
-
104-test-panel-refactor - 测试面板重构 📋
- 测试面板功能重构和优化
- 用户体验改进
-
105-output-display-v2 - 输出显示v2 📋
- 输出显示功能的第二版设计
- 性能和用户体验优化
-
108-layout-system - 布局系统经验
- 动态Flex布局实现经验
- 响应式设计最佳实践
- 布局系统架构总结
-
109-theme-system - 主题系统开发
- 主题系统的设计和实现
- 动态主题切换功能
- 样式管理最佳实践
-
122-naive-ui-migration - Naive UI 迁移项目 🎨
- Element Plus → Naive UI 全面框架迁移
- 主题系统重大升级：1种→5种主题 (light, dark, blue, green, purple)
- 26个任务系统化评估，8个月成功迁移
- 跨平台兼容性保持：Web(100%) + Desktop(95%) + Extension(95%)
- 性能优化：构建体积减少、渲染性能提升
- 为UI框架迁移建立了完整的方法论和最佳实践
-
117-pinia-refactoring - Pinia 状态管理重构 🔄
- 引入 Pinia 状态管理库，构建 6+1 session store 架构
- 解决 session 存储竞态条件
- 移除废弃的
$services插件机制，统一服务访问方式 - Claude Code + Codex AI 联合审查确保代码质量
-
129-session-store-single-source-refactor - Session Store 单一真源架构重构 ⭐
- 实现单一真源（Single Source of Truth）原则
- 解决跨模式状态污染问题，修复 P0 Bug（测试结果不显示）
- 新增图像存储服务（ImageStorageService）使用独立 IndexedDB
- 优化代码分割，主 bundle 减少 57KB
- 拆分单体组件为细粒度工作区（Basic/Image 模式）
-
126-submode-persistence - 子模式持久化功能 💾
- 实现三大功能模式(基础/上下文/图像)的独立子模式状态持久化
- 解决状态隔离、跨页面同步和双层状态一致性问题
- 修复图像模式刷新后文件上传按钮不显示的bug
- 建立完整的状态管理最佳实践和设计模式
- 127-multi-turn-dialogue-mode-optimization - 多轮对话模式优化 💬
- 基于消息 ID 的稳定选择与映射（避免索引漂移）
- messageChainMap（消息 → 工作链）复用策略与自动应用
- 多轮对话（Pro-System / Conversation）体验与实施记录
- 128-context-ui-and-variable-system-refactor - 上下文 UI 改造与变量系统重构 🧩
- 子模式选择器/快捷操作栏布局调整
- 变量系统简化：移除会话变量，引入测试区临时变量
- 任务计划、设计与实施记录归档
- 110-desktop-indexeddb-fix - 桌面端IndexedDB修复
- 桌面端IndexedDB兼容性问题修复
- 数据存储稳定性改进
- 跨平台存储方案优化
-
112-desktop-ipc-fixes - 桌面端IPC修复合集
- 语言切换按钮显示"Object Promise"问题修复
- Vue响应式对象IPC序列化问题修复
- IPC架构分析与修复
- 跨环境异步接口统一
- preload.js架构规范化
-
115-ipc-serialization-fixes - IPC序列化修复与数据一致性 🔄
- Vue响应式对象IPC序列化统一处理
- safeSerialize函数实现
- 业务逻辑层数据一致性修复
- 模型数据丢失问题解决
- 双重保护机制建立
-
113-full-service-refactoring - 全面服务重构
- 服务层架构全面重构
- 依赖注入优化
- 服务接口标准化
-
114-desktop-file-storage - 桌面版文件存储实现 💾
- 实现FileStorageProvider替代内存存储
- 完整的数据持久化解决方案
- 高性能文件I/O和错误恢复机制
- 数据安全性增强：智能恢复机制、备份保护、原子性操作
-
116-desktop-packaging-optimization - 桌面应用打包优化 📦
- 从portable模式改为ZIP压缩包模式
- 解决存储路径检测问题
- 简化代码架构，提升用户体验
-
119-csp-safe-template-processing - CSP安全模板处理 🔒
- 解决浏览器扩展CSP限制导致的模板编译失败
- 实现环境自适应的模板处理机制
- 保持跨平台功能完整性和向后兼容
- 启动问题 → 102-web-architecture-refactor
- 显示异常 → 112-desktop-ipc-fixes
- 存储问题 → 110-desktop-indexeddb-fix, 114-desktop-file-storage, 116-desktop-packaging-optimization
- 数据一致性问题 → 114-desktop-file-storage, 115-ipc-serialization-fixes
- 序列化错误 → 112-desktop-ipc-fixes, 115-ipc-serialization-fixes
- 应用退出问题 → 114-desktop-file-storage
- 语言设置问题 → 112-desktop-ipc-fixes
- 布局问题 → 108-layout-system
- 主题问题 → 109-theme-system, 122-naive-ui-migration
- UI库迁移问题 → 122-naive-ui-migration
- 模板问题 → 106-template-management, 119-csp-safe-template-processing
- 组件问题 → 107-component-standardization, 121-context-editor-refactor
- CSP安全问题 → 119-csp-safe-template-processing
- 浏览器扩展问题 → 119-csp-safe-template-processing
- 代码清理和重构 → 121-context-editor-refactor
- 跨平台兼容性问题 → 122-naive-ui-migration
- 性能优化问题 → 122-naive-ui-migration
- 状态持久化问题 → 126-submode-persistence
- 状态同步问题 → 126-submode-persistence
- 刷新后状态丢失 → 126-submode-persistence
- Electron相关 → 103, 110, 111, 112, 114
- Vue/前端相关 → 102, 104, 105, 107, 108, 109, 121, 122, 126
- UI库相关 → 109, 122
- 浏览器扩展相关 → 119, 122
- 架构设计相关 → 101, 102, 103, 111, 113, 121, 126
- 服务层相关 → 101, 106, 113, 119
- IPC通信相关 → 103, 111, 112
- 模板系统相关 → 106, 119
- 组件重构相关 → 107, 121
- 主题系统相关 → 109, 122
- 性能优化相关 → 122
- 状态管理相关 → 126
- 项目初期架构 → 101, 102, 103
- 功能开发阶段 → 104, 105, 106, 107, 126
- 优化改进阶段 → 108, 109, 121, 122
- 问题修复阶段 → 110, 111, 112, 114, 119, 126
- 重构完善阶段 → 113, 121, 122
- 架构设计经验 → 101, 102, 103, 111, 121, 126
- 功能开发经验 → 106, 107, 126
- UI/UX设计经验 → 108, 109, 122
- UI框架迁移经验 → 122
- 问题排查经验 → 110, 112, 114, 119, 126
- 重构实践经验 → 101, 113, 121, 122
- 性能优化经验 → 122
- 状态管理经验 → 126
- 了解架构 → 101 → 102 → 103
- 学习功能开发 → 106 → 107
- 掌握系统优化 → 108 → 109 → 122
- 学习问题排查 → 110 → 112 → 114
- UI框架迁移 → 122 (完整方法论和最佳实践)
- 确定问题类型 → 查看"按问题类型查找"
- 找到相关文档 → 阅读README了解概况
- 深入技术细节 → 查看experience.md和troubleshooting.md
- 应用解决方案 → 参考implementation.md
- 选择感兴趣的领域 → 查看"按技术栈查找"
- 按时间顺序阅读 → 了解演进过程
- 提取关键经验 → 重点关注experience.md
- 建立知识体系 → 整合相关经验
💡 提示: 每个文档都包含完整的背景、实现和经验总结，建议根据实际需求选择性阅读。