Files
prompt-optimizer/docs
linshen 21368fa678 fix(conversation): 修复多轮对话历史记录恢复问题并全面优化版本管理
核心修复:
- 修复多轮对话模式下 V2 及以上迭代版本无法正确恢复的 bug
- 修复消息顺序优化后历史记录恢复时,部分消息错误回溯到原始 (V0) 状态的 bug
- 在 iterateMessage 中手动预计算版本号,确保快照中的 appliedVersion 与实际保存的版本号一致
- 重构 useConversationOptimization.ts 中 getMessageAppliedVersion 函数,统一版本语义,使用 record.version 属性而非数组索引进行匹配
- 修正优化快照 (conversationSnapshot) 构建逻辑,确保当前优化消息的 appliedVersion 和 content 始终准确无误
- 改进 conversation optimizer 中的版本匹配机制,使用修剪后的字符串比较防止错误版本不匹配

功能增强:
- 新增完整的 iterateMessage 方法,支持多轮对话的消息级迭代优化
- 传递完整上下文数据(messages、selectedMessageId)给底层服务
- 对比测试时分别维护 originalToolCalls 和 optimizedToolCalls,确保工具调用结果互不干扰
- 在 prompt optimizer 历史元数据中添加 conversationSnapshot 以支持准确的状态恢复
- 重构优化流程,optimizeMessage 现在强制重置状态,避免状态污染

UI 优化:
- 调整版本标签显示顺序为 v3 v2 v1 v0(最新版本在前,v0 固定在最后)
- 优化版本切换交互体验

国际化支持:
- 修复 prompt optimizer 中的硬编码中文字符串,替换为 i18n 键
- 为多轮对话优化添加缺失的 i18n 键

代码质量:
- 删除所有调试日志(console.log)
- 添加模板处理边界情况注释(Mustache 空数组 vs undefined)
- 更新 App.vue (Web 和 Extension) 的历史记录恢复逻辑,通过 record.version 精确查找版本,增强了对历史记录删除(导致版本数组稀疏)的健壮性
- 为对话优化功能暂存未跟踪的新文件
2025-11-16 15:42:18 +08:00
..
2025-10-19 14:50:56 +08:00

项目文档索引

欢迎来到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 - 模板管理功能 🔄

🛠️ 开发工作区

当前开发阶段的临时文档和开发笔记

  • 开发笔记和临时记录
  • 待办事项
  • 实验性设计

🚀 快速导航

我是用户

我是开发者

我是项目管理者

📖 重要文档

核心文档

专项文档

📋 使用指南

新成员入职

  1. 阅读项目总体介绍了解项目概况
  2. 查看项目结构了解代码组织
  3. 参考技术开发指南了解开发规范
  4. 根据角色查看对应的文档分类

日常开发

  1. 遵循技术开发指南中的开发规范
  2. 遇到问题查看故障排查
  3. 了解历史背景查看开发过程归档

项目管理

  1. 通过项目状态了解当前进度
  2. 查看产品需求文档了解功能规划

🔄 文档维护

维护原则

  1. 分类明确:按目标受众和用途分类存放
  2. 及时更新:代码变更时同步更新相关文档
  3. 定期整理:定期清理过期内容,整理工作区文档
  4. 交叉引用:在相关文档间建立引用关系

文档规范

  • 使用Markdown格式
  • 统一的标题层级结构
  • 代码示例使用语法高亮
  • 文档末尾标注更新时间

归档流程

  • 新功能开发:在archives/中创建新的功能点目录(从107开始编号)
  • 重要经验:及时从workspace/转移到archives/对应功能点
  • 通用指南:从临时记录整理为正式的developer/文档

文档重构完成时间:2025-07-01 下一次整理计划:根据开发进度定期更新