todo.md

开发任务清单

按功能模块和优先级组织的开发任务列表。

🚨 高优先级任务

导入导出架构后续优化 (来自117归档)

目标: 完善导入导出架构的细节优化 来源: 117-import-export-architecture-refactor归档

1. 代码质量提升

• 添加ESLint规则检测存储键魔法字符串 - 低影响 - 1小时
• 创建TypeScript类型约束存储键使用 - 低影响 - 30分钟

2. 测试体系完善

• AI测试系统测试项补充 - 低优先级 - 1小时
• 存储键架构重构后续优化 - 中优先级 - 1-2小时

版本更新系统后续优化 (来自118归档)

目标: 完善版本更新系统的细节优化 来源: 118-desktop-auto-update-system归档

1. 后端忽略版本存储结构修复 - 高优先级

• 修改存储结构从单一字符串改为对象结构 - 2-3小时
• 更新 PREFERENCE_KEYS 常量定义
• 修改 update-available 事件处理逻辑
• 修改 UPDATE_IGNORE_VERSION IPC处理器
• 添加向后兼容性处理（迁移旧数据）

2. 前端忽略版本状态管理修复 - 高优先级

• 修改 ignoreUpdate 函数支持版本类型参数 - 1-2小时
• 添加对应状态重置逻辑
• 修改 handleIgnoreStableUpdate 和 handleIgnorePrereleaseUpdate
• 确保 hasUpdate 状态正确重新计算

3. UI逻辑优化 - 中优先级

• 创建 calculateHasUpdate 函数，根据用户偏好计算更新状态 - 1小时
• 忽略按钮显示条件优化，只在真正有更新时显示 - 30分钟
• 异常处理保护，确保设置修改有完整的异常保护 - 30分钟

Desktop端功能稳定性修复

目标: 修复Desktop环境下的剩余bug，提升用户体验

1. UI组件问题修复

• 修复TemplateSelect组件缺少"optimizationMode" prop的警告
• 检查并修复其他组件的必需prop问题
• 验证所有Desktop功能的正常运行

2. 功能完整性验证

• 测试模板管理功能在Desktop环境下的完整性
• 测试模型配置功能的稳定性
• 验证历史记录功能的正确性
• 检查主题切换和语言切换功能

3. 错误处理改进

• 添加更友好的错误提示界面
• 改进错误恢复机制
• 完善日志记录系统

组件标准化重构

目标: 统一所有模态框/弹窗类组件的行为和API

1. 标准化Prop为 modelValue

• DataManager.vue - 将 show prop 改为 modelValue
• HistoryDrawer.vue - 将 show prop 改为 modelValue
• ModelManager.vue - 将 show prop 改为 modelValue
• TemplateManager.vue - 将 show prop 改为 modelValue
• App.vue - 更新所有组件调用，将 v-model:show 改为 v-model

2. 补全 Escape 键支持

• ModelManager.vue - 添加ESC键关闭功能
• TemplateManager.vue - 添加ESC键关闭功能
• Modal.vue - 添加ESC键关闭功能（基础组件）

3. 修复关键Bug

• ModelManager.vue - 添加 v-if="show" 指令修复启动显示问题
• 解决 TypeScript 类型错误
• 为相关对象创建明确的 TypeScript 接口

Web架构完善

目标: 完成Composable架构重构的剩余工作

• 解决 App.vue 中的类型错误
• 深入研究 DataManager 类型定义和实现
• 调整 AppServices 接口或服务实现
• 添加错误处理UI界面

🔧 中优先级任务

文档完善

• 创建Web版用户指南
• 创建开发者快速开始指南
• 创建常见问题解答文档
• 创建核心API文档
• 创建架构概览文档

桌面端架构优化

• 实施高层服务代理IPC模型重构
• 清理 core 包中的 Electron 特定逻辑
• 改造 main.js 为服务提供者
• 实现主进程存储方案
• 重构 IPC 通信协议

CSS兼容性改进

• 添加标准 line-clamp 属性
• 提高浏览器兼容性
• 优化主题系统样式

📋 低优先级任务

长期重构计划

• 创建可复用的 BaseModal.vue 组件
• 将通用模态框逻辑抽象到基础组件
• 通过插槽方式实现内容定制
• 创建贡献指南
• 创建设计模式文档

测试和质量

• 创建测试指南
• 完善单元测试覆盖率
• 创建发布流程文档
• 创建代码规范文档

性能优化

• 优化应用启动时间
• 减少包体积
• 添加启动画面
• 优化错误处理和用户提示

Composables 单例问题排查

• 问题描述: 部分 composables 可能存在多实例问题，导致状态不同步
• 已修复: useUpdater.ts - 改为单例模式解决了忽略功能UI不更新的问题
• 待排查:
  • useModals.ts - 模态框状态可能在多组件间不一致
  • useModelManager.ts - 模型选择状态可能不同步
  • usePromptOptimizer.ts - 优化状态可能不同步
• 判断标准: 如果 composable 的状态需要在多个组件间保持一致，应使用单例模式
• 优先级: 低（目前使用正常，说明影响不大）

🔄 定期维护任务

每周

• 检查workspace中的临时文档，及时转移重要内容
• 更新项目状态文档
• 清理过期的临时文档

每月

• 审查所有文档的时效性
• 更新归档索引
• 评估任务优先级调整

📊 任务状态追踪

组件标准化重构进度

• 总任务数: 11
• 已完成: 0
• 进行中: 11
• 完成率: 0%

Web架构完善进度

• 总任务数: 4
• 已完成: 0
• 进行中: 4
• 完成率: 0%

🎯 下一步行动

本周重点

1. 完成 ModelManager.vue 的 v-if="show" 修复
2. 开始组件标准化重构的第一批任务
3. 解决 App.vue 类型错误

本月目标

1. 完成组件标准化重构的核心任务
2. 完善Web架构的剩余工作
3. 创建基础的用户和开发者文档

---

创建时间: 2025-07-01
最后更新: 2025-07-01
维护者: AI Assistant