- 重构更新器,移除状态缓存,优化检查流程,改为每次启动时重新检测。 - 优化预览版提示逻辑和界面样式,增加版本号和提示信息的视觉区分。 - 移除`useElectronAPI` Hook,简化 Electron API 访问,直接使用 `window.electronAPI`。 - 调整 Release Notes 生成逻辑,修复检出代码问题,获取完整 git 历史和所有 tags。 - 优化版本忽略功能,`useUpdater`改为单例模式,支持预览版过滤。 - 移除build:parallel脚本中的build:desktop-only任务。 docs(dev): 更新桌面端自动更新系统设计文档 - 新增系统设计文档,描述自动更新系统的架构和界面布局。 - 补充 electron-updater 版本号说明,推荐使用 SemVer 2.0.0 标准。
6.0 KiB
6.0 KiB
开发任务清单
按功能模块和优先级组织的开发任务列表。
🚨 高优先级任务
导入导出架构后续优化 (来自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_VERSIONIPC处理器 - 添加向后兼容性处理(迁移旧数据)
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- 将showprop 改为modelValueHistoryDrawer.vue- 将showprop 改为modelValueModelManager.vue- 将showprop 改为modelValueTemplateManager.vue- 将showprop 改为modelValueApp.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%
🎯 下一步行动
本周重点
- 完成
ModelManager.vue的v-if="show"修复 - 开始组件标准化重构的第一批任务
- 解决 App.vue 类型错误
本月目标
- 完成组件标准化重构的核心任务
- 完善Web架构的剩余工作
- 创建基础的用户和开发者文档
创建时间: 2025-07-01
最后更新: 2025-07-01
维护者: AI Assistant