Files
prompt-optimizer/docs/developer/todo.md
T
linshen 1a55a5e719 feat(server): 集成 MCP 服务器
本次提交主要集成了 MCP 服务器,为系统增加了用户提示词优化工具,并通过优化部署流程,提升了整体易用性。

具体变更内容包括:

* **功能增强:**
    * 集成 MCP 服务器,提供用户和系统提示词优化工具,支持 stdio 和 HTTP 两种传输方式,并集成了 Claude Desktop。
    * 实现基于会话的 HTTP 传输,允许多客户端连接,并为每个会话创建独立的 MCP 服务器实例,确保会话间的隔离性。

* **部署优化:**
    * 将 MCP 服务器端口变更为与 Web 界面共享 80 端口,通过路径区分,简化了 Docker 部署配置,降低了部署复杂度。
    * 优化 Docker 部署流程,使用 Supervisor 进行进程管理,并改进模板参数(使用枚举类型 + 默认值),同时提供了包含 MCP 服务器使用说明的 Docker 部署文档。

* **代码优化与重构:**
    * 优化模型选择逻辑,提高模型选择的准确性。
    * 优化日志记录功能,支持更灵活的日志级别设置,并添加了详细的错误提示和调试信息,方便问题排查。
    * 重构代码,分离构建和启动入口,优化环境变量加载和模型初始化逻辑,提高了代码的可维护性和可扩展性,并解决了构建副作用问题。

* **文档更新:**
    * 更新工具描述和使用说明,提供了用户和系统提示词工具的具体示例,并补充了迭代提示词工具的改进需求描述和使用场景。
    * 更新 Docker 部署方案,包含了 `docker-compose.yml`、`Dockerfile` 和 `env.local.example` 配置示例,并更新了 README 文档以明确连接方式。
    * 更新 `nginx.conf`,使用环境变量 `NGINX_PORT`,修改 `start-services.sh`,增加 nginx 配置处理,更新 `supervisord.conf`,调整 MCP 服务器启动方式,优化 `Dockerfile`,安装额外依赖并调整工作目录,调整环境变量加载机制,使用 `preload-env.cjs`。

* **其他:**
    * 提供快速开始指南、环境变量配置和问题排除等文档,更新了相关文档链接和获取帮助指引,并完成了基础测试用例和开发/设计文档。

本次更新旨在提升用户在提示词优化方面的能力,并简化部署流程,提高系统的整体可用性和可维护性。
2025-07-27 00:31:23 +08:00

4.9 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_VERSION IPC处理器
  • 添加向后兼容性处理(迁移旧数据)

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

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

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

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

MCP Server 模块后续优化 (来自120归档)

目标: 完善 MCP Server 模块的生产就绪性 来源: 120-mcp-server-module归档

1. 集成测试 - 中优先级

  • 测试与 Claude Desktop 的集成 - 需要真实环境 - 2-3小时
  • 验证在不同 MCP 客户端中的兼容性 - 1-2小时

2. 系统完善 - 中优先级

  • 完善错误处理和日志系统 - 提升用户体验 - 2-3小时
  • 编写使用文档和部署指南 - 便于其他开发者使用 - 2-3小时
  • 性能优化和稳定性测试 - 生产就绪 - 2-4小时

Desktop端功能稳定性修复

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

1. UI组件问题修复

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

2. 功能完整性验证

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

3. 错误处理改进

  • 添加更友好的错误提示界面
  • 改进错误恢复机制
  • 完善日志记录系统
  • 验证历史记录功能的正确性
  • 检查主题切换和语言切换功能

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界面

🔧 中优先级任务

MCP Server 模块后续工作 (来自120归档)

目标: 完善MCP Server模块的功能和稳定性 来源: 120-mcp-server-module归档

1. 集成测试

  • 测试与 Claude Desktop 的集成 - 中优先级 - 2小时
  • 测试与 MCP Inspector 的兼容性 - 中优先级 - 1小时

2. 功能完善

  • 完善错误处理和日志系统 - 高优先级 - 3小时
  • 添加更详细的调试信息输出 - 中优先级 - 1小时

3. 文档完善

  • 编写使用文档和部署指南 - 高优先级 - 3小时
  • 创建详细的API文档 - 中优先级 - 2小时

4. 性能优化

  • 性能优化和稳定性测试 - 中优先级 - 3小时
  • 内存使用优化 - 低优先级 - 2小时