mcp-feedback-enhanced/RELEASE_NOTES/CHANGELOG.zh-CN.md

更新日志 (简体中文)

本文件记录了 MCP Feedback Enhanced 的所有版本更新内容。

[v2.5.6] - 2025-06-21 - 设置保存机制优化与界面美化

🌟 版本亮点

重构设置保存机制，解决语系切换保存问题，并为设置界面增加可视化图标，提升用户体验。

🚀 改进功能

• 🔨 设置保存机制重构: 完全移除 localStorage 依赖，改用统一的 FastAPI 后端保存机制
  • 解决语系切换时设置无法正确保存的问题
  • 移除防抖机制，确保设置即时保存
  • 提升设置保存的可靠性和一致性
• ✨ 设置界面美化: 为设置页签内的各功能区块新增对应图标
  • 提升界面视觉效果和用户体验
  • 更直观的功能识别

🛠️ 技术改进

• 📊 统一存储架构: 所有设置统一使用 JSON 文件存储，确保跨环境一致性
• 🔧 代码简化: 移除复杂的 localStorage 相关代码，降低维护成本

---

[v2.5.5] - 2025-06-21 - SSH 远程开发支持与稳定性增强

🌟 版本亮点

新增 SSH 远程开发环境支持，解决远程开发时无法访问 Web UI 的问题。同时改进 macOS 编译支持和桌面应用稳定性，提升开发者体验。

✨ 新功能

• 🌐 SSH 远程开发支持: 新增 MCP_WEB_HOST 环境变量，支持设置 Web 服务器主机绑定
  • 默认为 127.0.0.1 确保安全性
  • 可设置为 0.0.0.0 允许远程访问
  • 解决 Cursor SSH Remote 等远程开发环境的访问问题
• 🍎 macOS 编译支持增强: 新增 .cargo/config.toml 配置文件
  • 支持 Intel (x86_64) 和 Apple Silicon (aarch64) 架构
  • 解决 macOS 上 PyO3 undefined dynamic_lookup 编译问题
  • 遵循 PyO3 官方推荐的最佳实践

🚀 改进功能

• 📝 工具文档优化: 将 LLM 指令移至工具 docstring，提升 token 效率
• 🎨 用户配置简化: 移除复杂的 Cursor 规则配置
• 📊 AI 工作摘要 Markdown 增强: 改进 Markdown 渲染效果和兼容性
• 🔄 会话历史流程优化: 改进会话保存和管理机制

🐛 问题修复

• 🖥️ 桌面应用 MCP 协议修复: 修正桌面模式下 MCP 协议通信污染问题
• 📦 打包流程修复: 修正多平台桌面应用打包和发布问题
• 🔧 发布流程优化: 改进自动化发布工作流程的稳定性
• 🔥 移除 ESC 快捷键: 移除可能造成意外关闭的 ESC 快捷键功能

🛠️ 技术改进

• 🏗️ 构建系统增强: 改进跨平台编译配置和依赖管理
• 📚 文档自动化: 改进工具自我文档化，遵循 FastMCP 最佳实践
• 🔍 调试功能增强: 新增更详细的调试信息和错误处理

📋 使用说明

• SSH 远程开发: 在 MCP 配置中设置 "MCP_WEB_HOST": "0.0.0.0" 允许远程访问
• 本地开发: 保持默认 "MCP_WEB_HOST": "127.0.0.1" 确保安全性
• macOS 开发: 新的编译配置将自动生效，无需额外设置

---

[v2.5.0] - 2025-06-15 - 桌面应用程序与性能优化

🌟 版本亮点

全新推出跨平台桌面应用程序，支持 Windows、macOS、Linux 三大平台。同时大幅提升系统性能与稳定性，引入防抖/节流机制优化用户体验。

✨ 新功能

• 🖥️ 桌面应用程序: 基于 Tauri 框架的原生桌面应用，支持 Windows x64、macOS (Intel/Apple Silicon)、Linux x64
• 📊 会话历史本地文件存储: 会话记录从 localStorage 改为服务器端本地文件保存，支持跨环境数据一致性
• 🔧 多平台构建支持: 完整的 CI/CD 流程，支持自动化多平台桌面应用构建
• 📝 桌面模式配置: 新增 MCP_DESKTOP_MODE 环境变量，支持桌面/Web 模式切换
• 📋 AI 工作摘要 Markdown 显示: 支持 Markdown 语法渲染，包含标题、粗体、代码区块、列表、链接等格式

🚀 改进功能

• ⚡ 性能大幅提升: 引入防抖/节流机制，减少不必要的渲染和网络请求
• 🌐 网络连接稳定性: 改进 WebSocket 重连机制，支持网络状态检测和智能重连
• 📊 会话历史存储改进: 从 localStorage 改为服务器端本地文件存储，提升跨环境一致性
• 🎨 UI 渲染优化: 优化会话管理、统计信息、状态指示器的渲染性能
• 📱 响应式改进: 调整心跳频率和超时阈值，减少系统负载
• 🔄 模块化增强: JavaScript 模块结构优化，支持更好的日志管理

🐛 问题修复

• 🌐 网络重连改进: 优化重连算法，采用指数退避策略和随机抖动
• 🖥️ 桌面模式适配: 修复桌面模式下浏览器自动开启的问题
• 📊 渲染性能修复: 解决重复渲染和不必要的状态更新问题

🛠️ 技术改进

• 🏗️ 构建流程优化: 新增 Makefile 桌面应用构建命令，支持 debug/release 模式
• 📦 依赖管理: 整合 Rust 工具链，支持跨平台编译和打包
• 🔍 开发工具增强: 新增环境检查、构建验证、清理工具
• 📚 文档完善: 新增桌面应用构建指南和工作流程说明
• 🔒 安全性增强: 引入 DOMPurify 进行 XSS 防护，确保内容安全

📋 使用说明

• 桌面模式: 在 MCP 配置中设定 "MCP_DESKTOP_MODE": "true" (参考 examples/mcp-config-desktop.json)
• Web 模式: 在 MCP 配置中设定 "MCP_DESKTOP_MODE": "false" (默认，参考 examples/mcp-config-web.json)
• 测试桌面模式: uvx mcp-feedback-enhanced@latest test --desktop
• 构建桌面应用: make build-desktop-release

---

[v2.4.3] - 2025-06-14 - 会话管理重构与音效通知

🌟 版本亮点

将会话管理从左侧边栏迁移到独立页签，解决浏览器兼容性问题。新增音效通知系统，支持自定义音效。

✨ 新功能

• 🔊 音效通知系统: 会话更新时播放音效提醒，支持内建音效和自定义音效上传
• 📚 会话历史管理: 本地保存会话记录，支持导出和清理功能
• 💾 输入框高度记忆: 自动保存和恢复文字输入框的高度设定
• 📋 一键复制: 项目路径和会话ID支持点击复制

🚀 改进功能

• 📋 会话管理重构: 从左侧边栏迁移到"会话管理"页签，解决小窗口下按钮无法点击的问题
• 🎨 界面布局优化: AI摘要区域自动扩展，提交按钮位置调整，移除多余描述文字
• 🌐 多语言增强: 新增tooltip和按钮的多语言支持

🐛 问题修复

• 修复当前会话详细信息按钮无反应问题
• 修复会话详情弹窗关闭延迟问题
• 修复音效通知语系初始化问题
• 修正自动提交处理逻辑

---

[v2.4.2] - Web-Only 架构重构与智能功能增强

🌟 版本亮点

本版本进行了重大架构重构，完全移除 PyQt6 GUI 依赖，转为纯 Web UI 架构，大幅简化部署和维护。同时新增多项智能功能，包括提示词管理、自动提交、会话管理等，全面提升用户体验和工作效率。

🔄 重大架构变更

• 🏗️ 完全移除 PyQt6 GUI: 彻底移除桌面应用程序依赖，简化安装和部署流程
• 🌐 纯 Web UI 架构: 统一使用 Web 界面，支持所有平台和环境
• 📦 依赖大幅简化: 移除 PyQt6、相关 GUI 库等重型依赖，安装包体积显著减小
• 🚀 部署更简单: 无需考虑 GUI 环境配置，适用于所有开发环境

✨ 全新功能

• 📝 智能提示词管理系统:
  • 常用提示词的 CRUD 操作（新增、编辑、删除、使用）
  • 使用频率统计和智能排序
  • 快速选择和一键应用功能
  • 支持自动提交标记和优先显示
• ⏰ 自动定时提交功能:
  • 可设定 1-86400 秒的倒数计时器
  • 可视化倒数显示和状态指示
  • 与提示词管理系统深度整合
  • 支持暂停、恢复、取消操作
• 📊 会话管理与追踪:
  • 当前会话状态即时显示
  • 会话历史记录和统计分析
  • 今日会话数量和平均时长统计
  • 会话详情查看和管理功能
• 🔗 连接监控系统:
  • WebSocket 连接状态即时监控
  • 延迟测量和连接品质指示
  • 自动重连机制和错误处理
  • 详细的连接统计信息
• ⌨️ 快捷键增强: 新增 Ctrl+I 快速聚焦输入框功能 (感谢 @penn201500)

🚀 功能改进

• 🎨 UI/UX 全面优化:
  • 新增左侧会话管理面板，支持收合/展开
  • 顶部连接状态栏，即时显示系统状态
  • 响应式设计，适配不同屏幕尺寸
  • 统一的设计语言和视觉风格
• 🌐 多语言系统增强:
  • 优化语言切换机制，支持即时切换
  • 新增大量翻译文本，提升本地化覆盖率
  • 改进语言选择器 UI，使用下拉菜单设计
  • 修复语言切换时的显示问题
• 🖼️ 图片设置整合:
  • 将图片设置从工作区移至设置标签页
  • 统一的设置管理界面
  • 改进设置项目的组织和布局
• 📱 界面布局优化:
  • 调整版面配置，符合多语言显示需求
  • 优化按钮样式和间距
  • 改进表单元素的视觉设计
  • 增强可访问性和易用性

🐛 问题修复

• 🔧 会话管理修复:
  • 修复会话统计信息无法正确更新的问题
  • 修复会话数量计算错误
  • 改进会话状态追踪机制
• 🎯 提示词功能修复:
  • 修复常用提示词管理无法正确设置自动提交的问题
  • 改进提示词选择和应用逻辑
• 🌐 语系切换修复:
  • 修复语言切换时部分文字未更新的问题
  • 改进多语言文本的加载机制
• 🏗️ 架构稳定性修复:
  • 修复会话管理初始化问题
  • 改进错误处理和资源清理
  • 优化模块加载顺序和依赖关系

🛠️ 技术改进

• 📦 模块化架构:
  • JavaScript 代码完全模块化重构
  • 采用 ES6+ 语法和现代化开发模式
  • 清晰的模块分离和职责划分
• 📊 性能提升:
  • 优化 WebSocket 通信效率
  • 改进前端资源加载速度
  • 减少内存使用和 CPU 负载

📚 文档更新

• 📖 架构文档更新: 更新系统架构说明，反映 Web-Only 设计
• 🔧 安装指南简化: 移除 GUI 相关安装步骤和依赖说明
• 🖼️ 截图更新: 更新所有界面截图，展示新的 Web UI 设计
• 📋 API 文档增强: 新增提示词管理、自动提交等新功能的 API 说明

---

[v2.3.0] - 系统稳定性与资源管理增强

🌟 亮点

本版本专注于提升系统稳定性和使用体验，特别解决了 Cursor SSH Remote 环境下无法启动浏览器的问题。

✨ 新功能

• 🌐 SSH Remote 环境支持: 解决 Cursor SSH Remote 无法启动浏览器的问题，提供清晰的使用指引
• 🛡️ 错误提示改善: 当发生错误时，提供更友善的错误信息和解决建议
• 🧹 自动清理功能: 自动清理临时文件和过期会话，保持系统整洁
• 📊 内存监控: 监控内存使用情况，防止系统资源不足

🚀 改进功能

• 💾 资源管理优化: 更好地管理系统资源，提升运行效率
• 🔧 错误处理增强: 遇到问题时提供更清楚的说明和解决方案
• 🌐 连接稳定性: 改善 Web UI 的连接稳定性
• 🖼️ 图片上传优化: 改善图片上传功能的稳定性
• 🎯 自动聚焦输入框: 反馈窗口开启时自动聚焦到输入框，提升用户体验 (感谢 @penn201500)

🐛 问题修复

• 🌐 连接问题: 修复 WebSocket 连接的相关问题
• 🔄 会话管理: 修复会话状态跟踪的问题
• 🖼️ 图片处理: 修复图片上传时的事件处理问题

---

[v2.2.5] - WSL 环境支持与跨平台增强

✨ 新功能

• 🐧 WSL 环境检测: 自动识别 WSL 环境，提供专门的支持逻辑
• 🌐 智能浏览器启动: WSL 环境下自动调用 Windows 浏览器，支持多种启动方式
• 🔧 跨平台测试增强: 测试功能整合 WSL 检测，提升测试覆盖率

🚀 改进功能

• 🎯 环境检测优化: 改进远程环境检测逻辑，WSL 不再被误判为远程环境
• 📊 系统信息增强: 系统信息工具新增 WSL 环境状态显示
• 🧪 测试体验提升: 测试模式下自动尝试启动浏览器，提供更好的测试体验

---

[v2.2.4] - GUI 体验优化与问题修复

🐛 问题修复

• 🖼️ 图片重复粘贴修复: 解决 GUI 界面中使用 Ctrl+V 复制粘贴图片时出现重复粘贴的问题
• 🌐 语系切换修复: 修复图片设定区域在语言切换时文字没有正确翻译的问题
• 📝 字体可读性改善: 调整图片设定区域的字体大小，提升文字可读性

---

[v2.2.3] - 超时控制与图片设置增强

✨ 新功能

• ⏰ 用户超时控制: 新增可自定义的超时设置功能，支持 30 秒至 2 小时的弹性设置
• ⏱️ 倒数计时器: 界面顶部显示实时倒数计时器，提供可视化的时间提醒
• 🖼️ 图片大小限制: 新增图片上传大小限制设置（无限制/1MB/3MB/5MB）
• 🔧 Base64 兼容模式: 新增 Base64 详细模式，提升部分 AI 模型的图片识别兼容性
• 🧹 UV Cache 管理工具: 新增 cleanup_cache.py 脚本，协助管理和清理 UV cache 空间

🚀 改进功能

• 📚 文档结构优化: 重新整理文档目录结构，将图片移至 docs/{语言}/images/ 路径
• 📖 Cache 管理指南: 新增详细的 UV Cache 管理指南，包含自动化清理方案
• 🎯 智能兼容性提示: 当图片上传失败时自动显示 Base64 兼容模式建议

🐛 问题修复

• 🛡️ 超时处理优化: 改进用户自定义超时与 MCP 系统超时的协调机制
• 🖥️ 界面自动关闭: 修复超时后界面自动关闭和资源清理逻辑
• 📱 响应式布局: 优化超时控制组件在小屏幕设备上的显示效果

---

[v2.2.2] - 超时自动清理修复

🐛 问题修复

• 🔄 超时自动清理: 修复 GUI/Web UI 在 MCP session timeout (默认 600 秒) 后没有自动关闭的问题
• 🛡️ 资源管理优化: 改进超时处理机制，确保在超时时正确清理和关闭所有 UI 资源
• ⚡ 超时检测增强: 加强超时检测逻辑，确保在各种情况下都能正确处理超时事件

---

[v2.2.1] - 窗口优化与统一设置接口

🚀 改进功能

• 🖥️ 窗口大小限制解除: 解除 GUI 主窗口最小大小限制，从 1000×800 降至 400×300
• 💾 窗口状态实时保存: 实现窗口大小与位置的即时保存机制，支持防抖延迟
• ⚙️ 统一设置接口优化: 改进 GUI 设置版面的配置保存逻辑，避免设置冲突

🐛 问题修复

• 🔧 窗口大小限制: 解决 GUI 窗口无法调整至小尺寸的问题
• 🛡️ 设置冲突: 修复设置保存时可能出现的配置冲突问题

---

[v2.2.0] - 布局与设置界面优化

✨ 新功能

• 🎨 水平布局模式: GUI 与 Web UI 的合并模式新增摘要与反馈的左右布局选项

🚀 改进功能

• 🎨 设置界面改进: 优化了 GUI 与 Web UI 的设置页面，提升布局清晰度
• ⌨️ 快捷键完善: 提交反馈快捷键现已完整支持数字键盘的 Enter 键

🐛 问题修复

• 🔧 图片重复粘贴: 解决了在 Web UI 文字输入区使用 Ctrl+V 粘贴图片时的重复问题

---

[v2.1.1] - 窗口定位优化

✨ 新功能

• 🖥️ 智能窗口定位: 新增「总是在主屏幕中心显示窗口」设置选项
• 🌐 多屏幕支持: 完美解决 T 字型屏幕排列等复杂多屏幕环境的窗口定位问题
• 💾 位置记忆: 自动保存和恢复窗口位置，智能检测窗口可见性

---

[v2.1.0] - 全面重构版

🎨 重大重构

• 🏗️ 全面重构: GUI 和 Web UI 采用模块化架构
• 📁 集中管理: 重新组织文件夹结构，提升维护性
• 🖥️ 界面优化: 现代化设计和改进的用户体验

✨ 新功能

• 🍎 macOS 界面优化: 针对 macOS 用户体验进行专项改进
• ⚙️ 功能增强: 新增设置选项和自动关闭页面功能
• ℹ️ 关于页面: 新增关于页面，包含版本信息、项目链接和致谢内容

---

[v2.0.14] - 快捷键与图片功能增强

🚀 改进功能

• ⌨️ 增强快捷键: Ctrl+Enter 支持数字键盘
• 🖼️ 智能图片粘贴: Ctrl+V 直接粘贴剪贴板图片

---

[v2.0.9] - 多语言架构重构

🔄 重构

• 🌏 多语言架构重构: 支持动态载入
• 📁 语言文件模块化: 模块化组织语言文件

---

[v2.0.3] - 编码问题修复

🐛 重要修复

• 🛡️ 完全修复中文字符编码问题: 解决所有中文显示相关问题
• 🔧 解决 JSON 解析错误: 修复数据解析错误

---

[v2.0.0] - Web UI 支持

🌟 重大功能

• ✅ 新增 Web UI 支持: 支持远程环境使用
• ✅ 自动环境检测: 自动选择合适的界面
• ✅ WebSocket 即时通讯: 实现即时双向通讯

---

图例说明

图标	意义
🌟	版本亮点
✨	新功能
🚀	改进功能
🐛	问题修复
🔄	重构变更
🎨	界面优化
⚙️	设置相关
🖥️	窗口相关
🌐	多语言/网络相关
📁	文件结构
⌨️	快捷键
🖼️	图片功能
📝	提示词管理
⏰	自动提交
📊	会话管理
🔗	连接监控
🏗️	架构变更
🛠️	技术改进
📚	文档更新

---

完整项目信息： GitHub - mcp-feedback-enhanced