📝 更新2.4.0相關文檔

This commit is contained in:
Minidoracat 2025-06-13 18:51:17 +08:00
parent 75d8e1f35c
commit 4eb528cb46
33 changed files with 605 additions and 116 deletions

144
README.md
View File

@ -8,34 +8,66 @@
## 🎯 Core Concept ## 🎯 Core Concept
This is an [MCP server](https://modelcontextprotocol.io/) that establishes **feedback-oriented development workflows**, perfectly adapting to local, **SSH Remote environments** (Cursor SSH Remote, VS Code Remote SSH), and **WSL (Windows Subsystem for Linux) environments**. By guiding AI to confirm with users rather than making speculative operations, it can consolidate multiple tool calls into a single feedback-oriented request, dramatically reducing platform costs and improving development efficiency. This is an [MCP server](https://modelcontextprotocol.io/) that establishes **feedback-oriented development workflows**, adopting a **pure Web UI architecture**, perfectly adapting to local, **SSH Remote environments** (Cursor SSH Remote, VS Code Remote SSH), and **WSL (Windows Subsystem for Linux) environments**. By guiding AI to confirm with users rather than making speculative operations, it can consolidate multiple tool calls into a single feedback-oriented request, dramatically reducing platform costs and improving development efficiency.
**🌐 Web-Only Architecture Advantages:**
- 🚀 **Simplified Deployment**: No GUI dependencies, lighter installation
- 🌍 **Cross-Platform Compatibility**: Supports all operating systems and environments
- 🔧 **Easy Maintenance**: Unified Web interface, reduced complexity
- 📦 **Compact Size**: Removed heavy GUI libraries, significantly smaller installation package
**Supported Platforms:** [Cursor](https://www.cursor.com) | [Cline](https://cline.bot) | [Windsurf](https://windsurf.com) | [Augment](https://www.augmentcode.com) | [Trae](https://www.trae.ai) **Supported Platforms:** [Cursor](https://www.cursor.com) | [Cline](https://cline.bot) | [Windsurf](https://windsurf.com) | [Augment](https://www.augmentcode.com) | [Trae](https://www.trae.ai)
### 🔄 Workflow ### 🔄 Workflow
1. **AI Call**`mcp-feedback-enhanced` 1. **AI Call**`mcp-feedback-enhanced` tool
2. **Environment Detection** → Auto-select appropriate interface 2. **Web UI Launch** → Auto-open browser interface (pure Web architecture)
3. **User Interaction** → Command execution, text feedback, image upload 3. **Smart Interaction** → Prompt selection, text input, image upload, auto-submit
4. **Feedback Delivery** → Information returns to AI 4. **Real-time Feedback** → WebSocket connection delivers information to AI instantly
5. **Process Continuation** → Adjust or end based on feedback 5. **Session Tracking** → Auto-record session history and statistics
6. **Process Continuation** → AI adjusts behavior or ends task based on feedback
## 🌟 Key Features ## 🌟 Key Features
### 🌐 Web UI Interface System ### 🌐 Pure Web UI Architecture System
- **Web UI**: Modern interface for all environments, brand new architecture - **Web-Only Design**: Completely removed desktop GUI dependencies, adopting pure Web interface
- **Universal Compatibility**: Supports local, SSH Remote, and WSL environments - **Universal Compatibility**: Supports local, SSH Remote, and WSL environments
- **Auto Adaptation**: Intelligent environment detection and optimal configuration - **Auto Adaptation**: Intelligent environment detection and optimal configuration
- **Lightweight Deployment**: No complex GUI environment configuration required
### 🎨 Modern Interface Design (v2.1.0) ### 📝 Smart Prompt Management System (v2.4.0 New Feature)
- **Modular Architecture**: Web UI adopts modular design - **CRUD Operations**: Create, edit, delete, and use common prompts
- **Centralized Management**: Reorganized folder structure for easier maintenance - **Usage Statistics**: Track usage frequency with intelligent sorting
- **Modern Themes**: Improved visual design and user experience - **Quick Application**: One-click selection and application of prompts
- **Responsive Layout**: Adapts to different screen sizes and window dimensions - **Auto-Submit Integration**: Support auto-submit marking and priority display
### ⏰ Auto-Timed Submit Feature (v2.4.0 New Feature)
- **Flexible Timing**: Configurable countdown timer from 1-86400 seconds
- **Visual Display**: Real-time countdown display and status indicators
- **Deep Integration**: Seamless integration with prompt management system
- **Complete Control**: Support pause, resume, and cancel operations
### 📊 Session Management & Tracking (v2.4.0 New Feature)
- **Real-time Status**: Current session status display in real-time
- **History Records**: Complete session history and statistical analysis
- **Data Statistics**: Today's session count and average duration statistics
- **Detail Management**: Session detail viewing and management functions
### 🔗 Connection Monitoring System (v2.4.0 New Feature)
- **Real-time Monitoring**: WebSocket connection status monitoring in real-time
- **Quality Indicators**: Latency measurement and connection quality indicators
- **Auto Reconnection**: Smart reconnection mechanism and error handling
- **Detailed Statistics**: Complete connection statistical information
### 🎨 Modern Interface Design
- **Modular Architecture**: JavaScript completely modularized refactoring
- **Responsive Design**: Adapts to different screen sizes and window dimensions
- **Unified Style**: Consistent design language and visual experience
- **Session Panel**: New left session management panel with collapse/expand support
### 🖼️ Image Support ### 🖼️ Image Support
- **Format Support**: PNG, JPG, JPEG, GIF, BMP, WebP - **Format Support**: PNG, JPG, JPEG, GIF, BMP, WebP
- **Upload Methods**: Drag & drop files + clipboard paste (Ctrl+V) - **Upload Methods**: Drag & drop files + clipboard paste (Ctrl+V)
- **Auto Processing**: Smart compression to ensure 1MB limit compliance - **Unlimited Upload**: Support image files of any size with automatic smart processing
### 🌏 Multi-language ### 🌏 Multi-language
- **Three Languages**: English, Traditional Chinese, Simplified Chinese - **Three Languages**: English, Traditional Chinese, Simplified Chinese
@ -55,20 +87,30 @@ This is an [MCP server](https://modelcontextprotocol.io/) that establishes **fee
- **MCP Integration Optimization**: Improved integration with MCP system for more stable connection experience - **MCP Integration Optimization**: Improved integration with MCP system for more stable connection experience
- **Detailed Documentation**: [SSH Remote Environment Usage Guide](docs/en/ssh-remote/browser-launch-issues.md) - **Detailed Documentation**: [SSH Remote Environment Usage Guide](docs/en/ssh-remote/browser-launch-issues.md)
- 🎯 **Auto-focus Input Box**: Automatically focus on feedback input box when window opens, improving user experience (Thanks @penn201500) - 🎯 **Auto-focus Input Box**: Automatically focus on feedback input box when window opens, improving user experience (Thanks @penn201500)
## 🌐 Interface Preview ## 🌐 Interface Preview
### Web UI Interface (Modern Version) ### Web UI Interface (v2.4.0 - Web-Only Architecture)
<div align="center"> <div align="center">
<img src="docs/en/images/web1.png" width="400" alt="Web UI Main Interface" /> <img src="docs/en/images/web1.jpeg" width="400" alt="Web UI Main Interface - Prompt Management & Auto-Submit" />
<img src="docs/en/images/web2.png" width="400" alt="Web UI Settings Interface" />
</div> </div>
*Web UI Interface - Modern architecture, suitable for all environments* <details>
<summary>📱 Click to view complete interface screenshots</summary>
<div align="center">
<img src="docs/en/images/web2.jpeg" width="800" alt="Web UI Complete Interface - Session Management & Settings" />
</div>
</details>
*Web UI Interface - Pure Web architecture, supporting prompt management, auto-submit, session tracking and other smart features*
**Keyboard Shortcuts** **Keyboard Shortcuts**
- `Ctrl+Enter` (Windows/Linux) / `Cmd+Enter` (macOS): Submit feedback (supports both main keyboard and numpad) - `Ctrl+Enter` (Windows/Linux) / `Cmd+Enter` (macOS): Submit feedback (supports both main keyboard and numpad)
- `Ctrl+V` (Windows/Linux) / `Cmd+V` (macOS): Directly paste clipboard images - `Ctrl+V` (Windows/Linux) / `Cmd+V` (macOS): Directly paste clipboard images
- `Ctrl+I` (Windows/Linux) / `Cmd+I` (macOS): Quick focus input box (Thanks @penn201500)
## 🚀 Quick Start ## 🚀 Quick Start
@ -157,33 +199,39 @@ uv sync
**Local Testing Methods** **Local Testing Methods**
```bash ```bash
# Method 1: Standard test (recommended) # Functional Testing
uv run python -m mcp_feedback_enhanced test uv run python -m mcp_feedback_enhanced test # Standard functional testing
uvx --with-editable . mcp-feedback-enhanced test --web # Web UI testing (continuous running)
# Method 2: Complete test suite (macOS and Windows dev environment) # Unit Testing
uvx --with-editable . mcp-feedback-enhanced test make test # Run all unit tests
make test-fast # Fast testing (skip slow tests)
make test-cov # Testing with coverage report
# Method 3: Interface testing # Code Quality Checks
uvx --with-editable . mcp-feedback-enhanced test --web # Test Web UI (auto continuous running) make check # Complete code quality checks
uvx --with-editable . mcp-feedback-enhanced test --enhanced # Enhanced test suite make quick-check # Quick check with auto-fix
``` ```
**Testing Descriptions** **Testing Descriptions**
- **Standard Test**: Complete functionality check, suitable for daily development verification - **Functional Testing**: Test complete MCP tool functionality workflow
- **Complete Test**: Deep testing of all components, suitable for pre-release verification - **Unit Testing**: Test individual module functionality
- **Web UI Test**: Start Web server and keep running for complete Web functionality testing - **Coverage Testing**: Generate HTML coverage report to `htmlcov/` directory
- **Enhanced Test**: Comprehensive test suite with advanced scenarios - **Quality Checks**: Include linting, formatting, type checking
## 🆕 Version History ## 🆕 Version History
📋 **Complete Version History:** [RELEASE_NOTES/CHANGELOG.en.md](RELEASE_NOTES/CHANGELOG.en.md) 📋 **Complete Version History:** [RELEASE_NOTES/CHANGELOG.en.md](RELEASE_NOTES/CHANGELOG.en.md)
### Latest Version Highlights (v2.3.0) ### Latest Version Highlights (v2.4.0)
- 🌐 **SSH Remote Environment Support**: Solved Cursor SSH Remote browser launch issues with clear usage guidance - 🏗️ **Web-Only Architecture Refactoring**: Completely removed PyQt6 GUI dependencies, transitioned to pure Web UI architecture, dramatically simplifying deployment
- 🛡️ **Error Message Improvements**: Provides more user-friendly error messages and solution suggestions when errors occur - 📝 **Smart Prompt Management**: Added complete prompt CRUD system with usage statistics and intelligent sorting
- 🧹 **Auto-cleanup Features**: Automatically cleans temporary files and expired sessions to keep the system tidy - ⏰ **Auto-Timed Submit**: Configurable countdown timer with deep integration with prompt management system
- 📊 **Memory Monitoring**: Monitors memory usage to prevent system resource shortage - 📊 **Session Management System**: Real-time session status, history records, and statistical analysis features
- 🔧 **Connection Stability**: Improved Web UI connection stability and error handling - 🔗 **Enhanced Connection Monitoring**: WebSocket connection status monitoring, latency measurement, and auto-reconnection
- 🎨 **Comprehensive UI/UX Optimization**: New session panel, responsive design, unified visual style
- 🌐 **Enhanced Multi-language System**: Optimized language switching mechanism, improved localization coverage
- 🛠️ **Technical Architecture Upgrade**: JavaScript modular refactoring, adopting modern development patterns
## 🐛 Common Issues ## 🐛 Common Issues
@ -201,6 +249,26 @@ A: Please confirm the MCP tool status shows green light. **Solution**: Toggle th
A: **Solution**: Completely close and restart VS Code or Cursor, then reopen the project. A: **Solution**: Completely close and restart VS Code or Cursor, then reopen the project.
### 🔧 General Issues ### 🔧 General Issues
**Q: How to use the legacy GUI interface?**
A: v2.4.0 has completely removed PyQt6 GUI dependencies and transitioned to a pure Web UI architecture. To use the legacy GUI, please specify v2.3.0 or earlier versions:
```bash
# Use v2.3.0 (last version supporting GUI)
uvx mcp-feedback-enhanced@2.3.0
# Or specify version in MCP configuration
{
"mcpServers": {
"mcp-feedback-enhanced": {
"command": "uvx",
"args": ["mcp-feedback-enhanced@2.3.0"],
"timeout": 600,
"autoApprove": ["interactive_feedback"]
}
}
}
```
**Note**: Legacy versions do not include v2.4.0 new features (prompt management, auto-submit, session management, etc.).
**Q: Getting "Unexpected token 'D'" error** **Q: Getting "Unexpected token 'D'" error**
A: Debug output interference. Set `MCP_DEBUG=false` or remove the environment variable. A: Debug output interference. Set `MCP_DEBUG=false` or remove the environment variable.
@ -211,7 +279,7 @@ A: Fixed in v2.0.3. Update to latest version: `uvx mcp-feedback-enhanced@latest`
A: Fixed in v2.1.1. Go to "⚙️ Settings" tab, check "Always show window at primary screen center" to resolve. Especially useful for T-shaped screen arrangements and other complex multi-monitor configurations. A: Fixed in v2.1.1. Go to "⚙️ Settings" tab, check "Always show window at primary screen center" to resolve. Especially useful for T-shaped screen arrangements and other complex multi-monitor configurations.
**Q: Image upload fails** **Q: Image upload fails**
A: Check file size (≤1MB) and format (PNG/JPG/GIF/BMP/WebP). A: Check file format (PNG/JPG/JPEG/GIF/BMP/WebP). System supports image files of any size.
**Q: Web UI won't start** **Q: Web UI won't start**
A: Check firewall settings or try using a different port. A: Check firewall settings or try using a different port.
@ -268,4 +336,4 @@ If you find this useful, please:
MIT License - see [LICENSE](LICENSE) file for details MIT License - see [LICENSE](LICENSE) file for details
--- ---
**🌟 Welcome to Star and share with more developers!** **🌟 Welcome to Star and share with more developers!**

View File

@ -8,34 +8,66 @@
## 🎯 核心概念 ## 🎯 核心概念
这是一个 [MCP 服务器](https://modelcontextprotocol.io/),建立**反馈导向的开发工作流程**,完美适配本地、**SSH Remote 环境**Cursor SSH Remote、VS Code Remote SSH**WSL (Windows Subsystem for Linux) 环境**。通过引导 AI 与用户确认而非进行推测性操作,可将多次工具调用合并为单次反馈导向请求,大幅节省平台成本并提升开发效率。 这是一个 [MCP 服务器](https://modelcontextprotocol.io/),建立**反馈导向的开发工作流程**,采用**纯 Web UI 架构**,完美适配本地、**SSH Remote 环境**Cursor SSH Remote、VS Code Remote SSH**WSL (Windows Subsystem for Linux) 环境**。通过引导 AI 与用户确认而非进行推测性操作,可将多次工具调用合并为单次反馈导向请求,大幅节省平台成本并提升开发效率。
**🌐 Web-Only 架构优势:**
- 🚀 **简化部署**:无需 GUI 依赖,安装更轻量
- 🌍 **跨平台兼容**:支持所有操作系统和环境
- 🔧 **维护简单**:统一的 Web 界面,降低复杂度
- 📦 **体积精简**:移除重型 GUI 库,安装包大幅缩小
**支持平台:** [Cursor](https://www.cursor.com) | [Cline](https://cline.bot) | [Windsurf](https://windsurf.com) | [Augment](https://www.augmentcode.com) | [Trae](https://www.trae.ai) **支持平台:** [Cursor](https://www.cursor.com) | [Cline](https://cline.bot) | [Windsurf](https://windsurf.com) | [Augment](https://www.augmentcode.com) | [Trae](https://www.trae.ai)
### 🔄 工作流程 ### 🔄 工作流程
1. **AI 调用**`mcp-feedback-enhanced` 1. **AI 调用**`mcp-feedback-enhanced` 工具
2. **环境检测** → 自动选择合适界面 2. **Web UI 启动** → 自动打开浏览器界面(纯 Web 架构)
3. **用户交互** → 命令执行、文字反馈、图片上传 3. **智能交互** → 提示词选择、文字输入、图片上传、自动提交
4. **反馈传递** → 信息返回 AI 4. **即时反馈** → WebSocket 连接即时传递信息给 AI
5. **流程继续** → 根据反馈调整或结束 5. **会话追踪** → 自动记录会话历史与统计
6. **流程继续** → AI 根据反馈调整行为或结束任务
## 🌟 主要功能 ## 🌟 主要功能
### 🌐 Web UI 界面系统 ### 🌐 纯 Web UI 架构系统
- **Web UI**:适用于所有环境的现代化界面,全新架构 - **Web-Only 设计**:完全移除桌面 GUI 依赖,采用纯 Web 界面
- **通用兼容性**支持本地、SSH Remote 和 WSL 环境 - **通用兼容性**支持本地、SSH Remote 和 WSL 环境
- **自动适配**:智能环境检测与最佳配置 - **自动适配**:智能环境检测与最佳配置
- **轻量部署**:无需复杂的 GUI 环境配置
### 🎨 现代化界面设计v2.1.0 ### 📝 智能提示词管理系统v2.4.0 新功能)
- **模块化架构**Web UI 采用模块化设计 - **CRUD 操作**:新增、编辑、删除、使用常用提示词
- **集中管理**:文件夹结构重新组织,维护更容易 - **使用统计**:追踪使用频率并智能排序
- **现代化主题**:改进的视觉设计和用户体验 - **快速应用**:一键选择和应用提示词
- **响应式布局**:适应不同屏幕尺寸和窗口大小 - **自动提交整合**:支持自动提交标记和优先显示
### ⏰ 自动定时提交功能v2.4.0 新功能)
- **弹性计时**:可设定 1-86400 秒的倒数计时器
- **视觉化显示**:即时倒数显示和状态指示
- **深度整合**:与提示词管理系统无缝配合
- **完整控制**:支持暂停、恢复、取消操作
### 📊 会话管理与追踪v2.4.0 新功能)
- **即时状态**:当前会话状态即时显示
- **历史记录**:完整的会话历史和统计分析
- **数据统计**:今日会话数量和平均时长统计
- **详情管理**:会话详情查看和管理功能
### 🔗 连接监控系统v2.4.0 新功能)
- **即时监控**WebSocket 连接状态即时监控
- **品质指示**:延迟测量和连接品质指示
- **自动重连**:智能重连机制和错误处理
- **详细统计**:完整的连接统计信息
### 🎨 现代化界面设计
- **模块化架构**JavaScript 完全模块化重构
- **响应式设计**:适配不同屏幕尺寸和窗口大小
- **统一风格**:一致的设计语言和视觉体验
- **会话面板**:新增左侧会话管理面板,支持收合/展开
### 🖼️ 图片支持 ### 🖼️ 图片支持
- **格式支持**PNG、JPG、JPEG、GIF、BMP、WebP - **格式支持**PNG、JPG、JPEG、GIF、BMP、WebP
- **上传方式**:拖拽文件 + 剪贴板粘贴Ctrl+V - **上传方式**:拖拽文件 + 剪贴板粘贴Ctrl+V
- **自动处理**:智能压缩确保符合 1MB 限制 - **无限制上传**:支持任意大小的图片文件,自动智能处理
### 🌏 多语言 ### 🌏 多语言
- **三语支持**:简体中文、英文、繁体中文 - **三语支持**:简体中文、英文、繁体中文
@ -57,17 +89,27 @@
## 🌐 界面预览 ## 🌐 界面预览
### Web UI 界面(现代版) ### Web UI 界面v2.4.0 - Web-Only 架构)
<div align="center"> <div align="center">
<img src="docs/zh-CN/images/web1.png" width="400" alt="Web UI 主界面" /> <img src="docs/zh-CN/images/web1.jpeg" width="400" alt="Web UI 主界面 - 提示词管理与自动提交" />
<img src="docs/zh-CN/images/web2.png" width="400" alt="Web UI 设置界面" />
</div> </div>
*Web UI 界面 - 现代化架构,适合所有环境* <details>
<summary>📱 点击查看完整界面截图</summary>
<div align="center">
<img src="docs/zh-CN/images/web2.jpeg" width="800" alt="Web UI 完整界面 - 会话管理与设置" />
</div>
</details>
*Web UI 界面 - 纯 Web 架构,支持提示词管理、自动提交、会话追踪等智能功能*
**快捷键支持** **快捷键支持**
- `Ctrl+Enter`Windows/Linux/ `Cmd+Enter`macOS提交反馈主键盘与数字键盘皆支持 - `Ctrl+Enter`Windows/Linux/ `Cmd+Enter`macOS提交反馈主键盘与数字键盘皆支持
- `Ctrl+V`Windows/Linux/ `Cmd+V`macOS直接粘贴剪贴板图片 - `Ctrl+V`Windows/Linux/ `Cmd+V`macOS直接粘贴剪贴板图片
- `Ctrl+I`Windows/Linux/ `Cmd+I`macOS快速聚焦输入框 (感谢 @penn201500)
## 🚀 快速开始 ## 🚀 快速开始
@ -141,7 +183,6 @@ uvx mcp-feedback-enhanced@latest version # 检查版本
# 界面测试 # 界面测试
uvx mcp-feedback-enhanced@latest test --web # 测试 Web UI (自动持续运行) uvx mcp-feedback-enhanced@latest test --web # 测试 Web UI (自动持续运行)
uvx mcp-feedback-enhanced@latest test --enhanced # 增强测试套件
# 调试模式 # 调试模式
MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test
@ -156,34 +197,39 @@ uv sync
**本地测试方式** **本地测试方式**
```bash ```bash
# 方式一:标准测试(推荐) # 功能测试
uv run python -m mcp_feedback_enhanced test uv run python -m mcp_feedback_enhanced test # 标准功能测试
uvx --with-editable . mcp-feedback-enhanced test --web # Web UI 测试 (持续运行)
# 方式二完整测试套件macOS 和 Windows 通用开发环境) # 单元测试
uvx --with-editable . mcp-feedback-enhanced test make test # 运行所有单元测试
make test-fast # 快速测试 (跳过慢速测试)
make test-cov # 测试并生成覆盖率报告
# 方式三:界面测试 # 代码质量检查
uvx --with-editable . mcp-feedback-enhanced test --web # 测试 Web UI (自动持续运行) make check # 完整代码质量检查
uvx --with-editable . mcp-feedback-enhanced test --enhanced # 增强测试套件 make quick-check # 快速检查并自动修复
``` ```
**测试说明** **测试说明**
- **标准测试**:执行完整的功能检查,适合日常开发验证 - **功能测试**:测试 MCP 工具的完整功能流程
- **完整测试**:包含所有组件的深度测试,适合发布前验证 - **单元测试**:测试各个模块的独立功能
- **Web UI 测试**:启动 Web 服务器并保持运行,便于完整测试 Web 功能 - **覆盖率测试**:生成 HTML 覆盖率报告到 `htmlcov/` 目录
- **增强测试**:完整的测试套件,包含进阶场景 - **质量检查**:包含 linting、格式化、类型检查
## 🆕 版本更新记录 ## 🆕 版本更新记录
📋 **完整版本更新记录:** [RELEASE_NOTES/CHANGELOG.zh-CN.md](RELEASE_NOTES/CHANGELOG.zh-CN.md) 📋 **完整版本更新记录:** [RELEASE_NOTES/CHANGELOG.zh-CN.md](RELEASE_NOTES/CHANGELOG.zh-CN.md)
### 最新版本亮点v2.3.0 ### 最新版本亮点v2.4.0
- 🌐 **SSH Remote 环境支持**: 解决 Cursor SSH Remote 无法启动浏览器的问题,提供清晰的使用指引 - 🏗️ **Web-Only 架构重构**: 完全移除 PyQt6 GUI 依赖,转为纯 Web UI 架构,大幅简化部署
- 🛡️ **错误提示改善**: 当发生错误时,提供更友善的错误信息和解决建议 - 📝 **智能提示词管理**: 新增完整的提示词 CRUD 系统,支持使用统计和智能排序
- 🧹 **自动清理功能**: 自动清理临时文件和过期会话,保持系统整洁 - ⏰ **自动定时提交**: 可设定倒数计时器,与提示词管理深度整合
- 📊 **内存监控**: 监控内存使用情况,防止系统资源不足 - 📊 **会话管理系统**: 即时会话状态、历史记录和统计分析功能
- 🔧 **连接稳定性**: 改善 Web UI 的连接稳定性和错误处理 - 🔗 **连接监控增强**: WebSocket 连接状态监控、延迟测量和自动重连
- 🎯 **自动聚焦输入框**: 反馈窗口开启时自动聚焦到输入框,提升用户体验 (感谢 @penn201500) - 🎨 **UI/UX 全面优化**: 新增会话面板、响应式设计、统一视觉风格
- 🌐 **多语言系统增强**: 优化语言切换机制,提升本地化覆盖率
- 🛠️ **技术架构升级**: JavaScript 模块化重构,采用现代化开发模式
## 🐛 常见问题 ## 🐛 常见问题
@ -201,6 +247,26 @@ A: 请确认 MCP 工具状态为绿灯。**解决方法**:反复开关 MCP 工
A: **解决方法**:完全关闭并重新启动 VS Code 或 Cursor重新打开项目。 A: **解决方法**:完全关闭并重新启动 VS Code 或 Cursor重新打开项目。
### 🔧 一般问题 ### 🔧 一般问题
**Q: 如何使用旧版 GUI 界面?**
A: v2.4.0 版本已完全移除 PyQt6 GUI 依赖,转为纯 Web UI 架构。如需使用旧版 GUI请指定 v2.3.0 或更早版本:
```bash
# 使用 v2.3.0(最后支持 GUI 的版本)
uvx mcp-feedback-enhanced@2.3.0
# 或在 MCP 配置中指定版本
{
"mcpServers": {
"mcp-feedback-enhanced": {
"command": "uvx",
"args": ["mcp-feedback-enhanced@2.3.0"],
"timeout": 600,
"autoApprove": ["interactive_feedback"]
}
}
}
```
**注意**:旧版本不包含 v2.4.0 的新功能(提示词管理、自动提交、会话管理等)。
**Q: 出现 "Unexpected token 'D'" 错误** **Q: 出现 "Unexpected token 'D'" 错误**
A: 调试输出干扰。设置 `MCP_DEBUG=false` 或移除该环境变量。 A: 调试输出干扰。设置 `MCP_DEBUG=false` 或移除该环境变量。
@ -211,7 +277,7 @@ A: 已在 v2.0.3 修复。更新到最新版本:`uvx mcp-feedback-enhanced@lat
A: 已在 v2.1.1 修复。进入「⚙️ 设置」标签页,勾选「总是在主屏幕中心显示窗口」即可解决。特别适用于 T 字型屏幕排列等复杂多屏幕配置。 A: 已在 v2.1.1 修复。进入「⚙️ 设置」标签页,勾选「总是在主屏幕中心显示窗口」即可解决。特别适用于 T 字型屏幕排列等复杂多屏幕配置。
**Q: 图片上传失败** **Q: 图片上传失败**
A: 检查文件大小≤1MB格式PNG/JPG/GIF/BMP/WebP A: 检查文件格式PNG/JPG/JPEG/GIF/BMP/WebP系统支持任意大小的图片文件。
**Q: Web UI 无法启动** **Q: Web UI 无法启动**
A: 检查防火墙设置或尝试使用不同的端口。 A: 检查防火墙设置或尝试使用不同的端口。
@ -268,4 +334,4 @@ A: 各种 AI 模型(包括 Gemini Pro 2.5、Claude 等)在图片解析上可
MIT 授权条款 - 详见 [LICENSE](LICENSE) 档案 MIT 授权条款 - 详见 [LICENSE](LICENSE) 档案
--- ---
**🌟 欢迎 Star 并分享给更多开发者!** **🌟 欢迎 Star 并分享给更多开发者!**

View File

@ -8,34 +8,66 @@
## 🎯 核心概念 ## 🎯 核心概念
這是一個 [MCP 伺服器](https://modelcontextprotocol.io/),建立**回饋導向的開發工作流程**,完美適配本地、**SSH 遠端開發環境**與 **WSL (Windows Subsystem for Linux) 環境**。透過引導 AI 與用戶確認而非進行推測性操作,可將多次工具調用合併為單次回饋導向請求,大幅節省平台成本並提升開發效率。 這是一個 [MCP 伺服器](https://modelcontextprotocol.io/),建立**回饋導向的開發工作流程**,採用**純 Web UI 架構**,完美適配本地、**SSH 遠端開發環境**與 **WSL (Windows Subsystem for Linux) 環境**。透過引導 AI 與用戶確認而非進行推測性操作,可將多次工具調用合併為單次回饋導向請求,大幅節省平台成本並提升開發效率。
**🌐 Web-Only 架構優勢:**
- 🚀 **簡化部署**:無需 GUI 依賴,安裝更輕量
- 🌍 **跨平台相容**:支援所有作業系統和環境
- 🔧 **維護簡單**:統一的 Web 介面,降低複雜度
- 📦 **體積精簡**:移除重型 GUI 庫,安裝包大幅縮小
**支援平台:** [Cursor](https://www.cursor.com) | [Cline](https://cline.bot) | [Windsurf](https://windsurf.com) | [Augment](https://www.augmentcode.com) | [Trae](https://www.trae.ai) **支援平台:** [Cursor](https://www.cursor.com) | [Cline](https://cline.bot) | [Windsurf](https://windsurf.com) | [Augment](https://www.augmentcode.com) | [Trae](https://www.trae.ai)
### 🔄 工作流程 ### 🔄 工作流程
1. **AI 調用**`mcp-feedback-enhanced` 1. **AI 調用**`mcp-feedback-enhanced` 工具
2. **環境檢測** → 自動選擇合適介面 2. **Web UI 啟動** → 自動開啟瀏覽器介面(純 Web 架構)
3. **用戶互動** → 命令執行、文字回饋、圖片上傳 3. **智能互動** → 提示詞選擇、文字輸入、圖片上傳、自動提交
4. **回饋傳遞** → 資訊返回 AI 4. **即時回饋** → WebSocket 連線即時傳遞資訊給 AI
5. **流程繼續** → 根據回饋調整或結束 5. **會話追蹤** → 自動記錄會話歷史與統計
6. **流程繼續** → AI 根據回饋調整行為或結束任務
## 🌟 主要功能 ## 🌟 主要功能
### 🌐 Web UI 介面系統 ### 🌐 純 Web UI 架構系統
- **Web UI**:適用於所有環境的現代化界面,全新架構 - **Web-Only 設計**:完全移除桌面 GUI 依賴,採用純 Web 介面
- **通用相容性**支援本地、SSH Remote 和 WSL 環境 - **通用相容性**支援本地、SSH Remote 和 WSL 環境
- **自動適配**:智能環境檢測與最佳配置 - **自動適配**:智能環境檢測與最佳配置
- **輕量部署**:無需複雜的 GUI 環境配置
### 🎨 現代化界面設計v2.1.0 ### 📝 智能提示詞管理系統v2.4.0 新功能)
- **模組化架構**Web UI 採用模組化設計 - **CRUD 操作**:新增、編輯、刪除、使用常用提示詞
- **集中管理**:資料夾結構重新組織,維護更容易 - **使用統計**:追蹤使用頻率並智能排序
- **現代化主題**:改進的視覺設計和用戶體驗 - **快速應用**:一鍵選擇和應用提示詞
- **響應式布局**:適應不同螢幕尺寸和視窗大小 - **自動提交整合**:支援自動提交標記和優先顯示
### ⏰ 自動定時提交功能v2.4.0 新功能)
- **彈性計時**:可設定 1-86400 秒的倒數計時器
- **視覺化顯示**:即時倒數顯示和狀態指示
- **深度整合**:與提示詞管理系統無縫配合
- **完整控制**:支援暫停、恢復、取消操作
### 📊 會話管理與追蹤v2.4.0 新功能)
- **即時狀態**:當前會話狀態即時顯示
- **歷史記錄**:完整的會話歷史和統計分析
- **數據統計**:今日會話數量和平均時長統計
- **詳情管理**:會話詳情查看和管理功能
### 🔗 連線監控系統v2.4.0 新功能)
- **即時監控**WebSocket 連線狀態即時監控
- **品質指示**:延遲測量和連線品質指示
- **自動重連**:智能重連機制和錯誤處理
- **詳細統計**:完整的連線統計資訊
### 🎨 現代化界面設計
- **模組化架構**JavaScript 完全模組化重構
- **響應式設計**:適配不同螢幕尺寸和視窗大小
- **統一風格**:一致的設計語言和視覺體驗
- **會話面板**:新增左側會話管理面板,支援收合/展開
### 🖼️ 圖片支援 ### 🖼️ 圖片支援
- **格式支援**PNG、JPG、JPEG、GIF、BMP、WebP - **格式支援**PNG、JPG、JPEG、GIF、BMP、WebP
- **上傳方式**:拖拽檔案 + 剪貼板粘貼Ctrl+V - **上傳方式**:拖拽檔案 + 剪貼板粘貼Ctrl+V
- **自動處理**:智能壓縮確保符合 1MB 限制 - **無限制上傳**:支援任意大小的圖片檔案,自動智能處理
### 🌏 多語言 ### 🌏 多語言
- **三語支援**:繁體中文、英文、簡體中文 - **三語支援**:繁體中文、英文、簡體中文
@ -57,17 +89,27 @@
## 🌐 介面預覽 ## 🌐 介面預覽
### Web UI 介面(現代版) ### Web UI 介面v2.4.0 - Web-Only 架構)
<div align="center"> <div align="center">
<img src="docs/zh-TW/images/web1.png" width="400" alt="Web UI 主介面" /> <img src="docs/zh-TW/images/web1.jpeg" width="400" alt="Web UI 主介面 - 提示詞管理與自動提交" />
<img src="docs/zh-TW/images/web2.png" width="400" alt="Web UI 設定介面" />
</div> </div>
*Web UI 介面 - 現代化架構,適合所有環境* <details>
<summary>📱 點擊查看完整介面截圖</summary>
<div align="center">
<img src="docs/zh-TW/images/web2.jpeg" width="800" alt="Web UI 完整介面 - 會話管理與設定" />
</div>
</details>
*Web UI 介面 - 純 Web 架構,支援提示詞管理、自動提交、會話追蹤等智能功能*
**快捷鍵支援** **快捷鍵支援**
- `Ctrl+Enter`Windows/Linux/ `Cmd+Enter`macOS提交回饋主鍵盤與數字鍵盤皆支援 - `Ctrl+Enter`Windows/Linux/ `Cmd+Enter`macOS提交回饋主鍵盤與數字鍵盤皆支援
- `Ctrl+V`Windows/Linux/ `Cmd+V`macOS直接粘貼剪貼板圖片 - `Ctrl+V`Windows/Linux/ `Cmd+V`macOS直接粘貼剪貼板圖片
- `Ctrl+I`Windows/Linux/ `Cmd+I`macOS快速聚焦輸入框 (感謝 @penn201500)
## 🚀 快速開始 ## 🚀 快速開始
@ -141,7 +183,6 @@ uvx mcp-feedback-enhanced@latest version # 檢查版本
# 介面測試 # 介面測試
uvx mcp-feedback-enhanced@latest test --web # 測試 Web UI (自動持續運行) uvx mcp-feedback-enhanced@latest test --web # 測試 Web UI (自動持續運行)
uvx mcp-feedback-enhanced@latest test --enhanced # 增強測試套件
# 調試模式 # 調試模式
MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test
@ -156,34 +197,40 @@ uv sync
**本地測試方式** **本地測試方式**
```bash ```bash
# 方式一:標準測試(推薦) # 功能測試
uv run python -m mcp_feedback_enhanced test uv run python -m mcp_feedback_enhanced test # 標準功能測試
uvx --with-editable . mcp-feedback-enhanced test --web # Web UI 測試 (持續運行)
# 方式二完整測試套件macOS 和 windows 通用開發環境) # 單元測試
uvx --with-editable . mcp-feedback-enhanced test make test # 運行所有單元測試
make test-fast # 快速測試 (跳過慢速測試)
make test-cov # 測試並生成覆蓋率報告
# 方式三:介面測試 # 代碼品質檢查
uvx --with-editable . mcp-feedback-enhanced test --web # 測試 Web UI (自動持續運行) make check # 完整代碼品質檢查
uvx --with-editable . mcp-feedback-enhanced test --enhanced # 增強測試套件 make quick-check # 快速檢查並自動修復
``` ```
**測試說明** **測試說明**
- **標準測試**:執行完整的功能檢查,適合日常開發驗證 - **功能測試**:測試 MCP 工具的完整功能流程
- **完整測試**:包含所有組件的深度測試,適合發布前驗證 - **單元測試**:測試各個模組的獨立功能
- **Web UI 測試**:啟動 Web 服務器並保持運行,便於完整測試 Web 功能 - **覆蓋率測試**:生成 HTML 覆蓋率報告到 `htmlcov/` 目錄
- **增強測試**:完整的測試套件,包含進階場景 - **品質檢查**:包含 linting、格式化、類型檢查
## 🆕 版本更新記錄 ## 🆕 版本更新記錄
📋 **完整版本更新記錄:** [RELEASE_NOTES/CHANGELOG.zh-TW.md](RELEASE_NOTES/CHANGELOG.zh-TW.md) 📋 **完整版本更新記錄:** [RELEASE_NOTES/CHANGELOG.zh-TW.md](RELEASE_NOTES/CHANGELOG.zh-TW.md)
### 最新版本亮點v2.3.0 ### 最新版本亮點v2.4.0
- 🌐 **SSH Remote 環境支援**: 解決 Cursor SSH Remote 無法啟動瀏覽器的問題,提供清晰的使用指引 - 🏗️ **Web-Only 架構重構**: 完全移除 PyQt6 GUI 依賴,轉為純 Web UI 架構,大幅簡化部署
- 🛡️ **錯誤提示改善**: 當發生錯誤時,提供更友善的錯誤訊息和解決建議 - 📝 **智能提示詞管理**: 新增完整的提示詞 CRUD 系統,支援使用統計和智能排序
- 🧹 **自動清理功能**: 自動清理臨時文件和過期會話,保持系統整潔 - ⏰ **自動定時提交**: 可設定倒數計時器,與提示詞管理深度整合
- 📊 **記憶體監控**: 監控記憶體使用情況,防止系統資源不足 - 📊 **會話管理系統**: 即時會話狀態、歷史記錄和統計分析功能
- 🔧 **連線穩定性**: 改善 Web UI 的連線穩定性和錯誤處理 - 🔗 **連線監控增強**: WebSocket 連線狀態監控、延遲測量和自動重連
- 🎯 **自動聚焦輸入框**: 回饋視窗開啟時自動聚焦到輸入框,提升用戶體驗 (感謝 @penn201500) - 🎨 **UI/UX 全面優化**: 新增會話面板、響應式設計、統一視覺風格
- 🌐 **多語言系統增強**: 優化語言切換機制,提升本地化覆蓋率
- 🛠️ **技術架構升級**: JavaScript 模組化重構,採用現代化開發模式
## 🐛 常見問題 ## 🐛 常見問題
@ -201,6 +248,26 @@ A: 請確認 MCP 工具狀態為綠燈。**解決方法**:反覆開關 MCP 工
A: **解決方法**:完全關閉並重新啟動 VS Code 或 Cursor重新開啟專案。 A: **解決方法**:完全關閉並重新啟動 VS Code 或 Cursor重新開啟專案。
### 🔧 一般問題 ### 🔧 一般問題
**Q: 如何使用舊版 GUI 介面?**
A: v2.4.0 版本已完全移除 PyQt6 GUI 依賴,轉為純 Web UI 架構。如需使用舊版 GUI請指定 v2.3.0 或更早版本:
```bash
# 使用 v2.3.0(最後支援 GUI 的版本)
uvx mcp-feedback-enhanced@2.3.0
# 或在 MCP 配置中指定版本
{
"mcpServers": {
"mcp-feedback-enhanced": {
"command": "uvx",
"args": ["mcp-feedback-enhanced@2.3.0"],
"timeout": 600,
"autoApprove": ["interactive_feedback"]
}
}
}
```
**注意**:舊版本不包含 v2.4.0 的新功能(提示詞管理、自動提交、會話管理等)。
**Q: 出現 "Unexpected token 'D'" 錯誤** **Q: 出現 "Unexpected token 'D'" 錯誤**
A: 調試輸出干擾。設置 `MCP_DEBUG=false` 或移除該環境變數。 A: 調試輸出干擾。設置 `MCP_DEBUG=false` 或移除該環境變數。
@ -211,7 +278,7 @@ A: 已在 v2.0.3 修復。更新到最新版本:`uvx mcp-feedback-enhanced@lat
A: 已在 v2.1.1 修復。進入「⚙️ 設定」分頁,勾選「總是在主螢幕中心顯示視窗」即可解決。特別適用於 T 字型螢幕排列等複雜多螢幕配置。 A: 已在 v2.1.1 修復。進入「⚙️ 設定」分頁,勾選「總是在主螢幕中心顯示視窗」即可解決。特別適用於 T 字型螢幕排列等複雜多螢幕配置。
**Q: 圖片上傳失敗** **Q: 圖片上傳失敗**
A: 檢查檔案大小≤1MB格式PNG/JPG/GIF/BMP/WebP A: 檢查檔案格式PNG/JPG/JPEG/GIF/BMP/WebP系統支援任意大小的圖片檔案。
**Q: Web UI 無法啟動** **Q: Web UI 無法啟動**
A: 檢查防火牆設定或嘗試使用不同的端口。 A: 檢查防火牆設定或嘗試使用不同的端口。
@ -268,4 +335,4 @@ A: 各種 AI 模型(包括 Gemini Pro 2.5、Claude 等)在圖片解析上可
MIT 授權條款 - 詳見 [LICENSE](LICENSE) 檔案 MIT 授權條款 - 詳見 [LICENSE](LICENSE) 檔案
--- ---
**🌟 歡迎 Star 並分享給更多開發者!** **🌟 歡迎 Star 並分享給更多開發者!**

View File

@ -2,6 +2,95 @@
This document records all version updates for **MCP Feedback Enhanced**. This document records all version updates for **MCP Feedback Enhanced**.
## [v2.4.0] - Web-Only Architecture Refactoring & Smart Feature Enhancement
### 🌟 Version Highlights
This version underwent major architectural refactoring, **completely removing PyQt6 GUI dependencies** and transitioning to a pure Web UI architecture, dramatically simplifying deployment and maintenance. Additionally, multiple smart features were added, including prompt management, auto-submit, session management, and more, comprehensively enhancing user experience and work efficiency.
### 🔄 Major Architectural Changes
- 🏗️ **Complete PyQt6 GUI Removal**: Thoroughly removed desktop application dependencies, simplifying installation and deployment processes
- 🌐 **Pure Web UI Architecture**: Unified use of Web interface, supporting all platforms and environments
- 📦 **Dramatically Simplified Dependencies**: Removed PyQt6, related GUI libraries and other heavy dependencies, significantly reducing installation package size
- 🚀 **Simpler Deployment**: No need to consider GUI environment configuration, suitable for all development environments
### ✨ Brand New Features
- 📝 **Smart Prompt Management System**:
- CRUD operations for common prompts (Create, Edit, Delete, Use)
- Usage frequency statistics and intelligent sorting
- Quick selection and one-click application functionality
- Support for auto-submit marking and priority display
- ⏰ **Auto-Timed Submit Feature**:
- Configurable countdown timer from 1-86400 seconds
- Visual countdown display and status indicators
- Deep integration with prompt management system
- Support for pause, resume, and cancel operations
- 📊 **Session Management & Tracking**:
- Real-time current session status display
- Session history records and statistical analysis
- Today's session count and average duration statistics
- Session detail viewing and management functions
- 🔗 **Connection Monitoring System**:
- Real-time WebSocket connection status monitoring
- Latency measurement and connection quality indicators
- Auto-reconnection mechanism and error handling
- Detailed connection statistical information
- ⌨️ **Enhanced Shortcuts**: Added Ctrl+I quick focus input box feature (Thanks @penn201500)
### 🚀 Feature Improvements
- 🎨 **Comprehensive UI/UX Optimization**:
- Added left session management panel with collapse/expand support
- Top connection status bar with real-time system status display
- Responsive design adapting to different screen sizes
- Unified design language and visual style
- 🌐 **Enhanced Multi-language System**:
- Optimized language switching mechanism with instant switching support
- Added extensive translation text, improving localization coverage
- Improved language selector UI with dropdown design
- Fixed display issues during language switching
- 🖼️ **Image Settings Integration**:
- Moved image settings from workspace to settings tab
- Unified settings management interface
- Improved organization and layout of setting items
- 📱 **Interface Layout Optimization**:
- Adjusted layout to accommodate multi-language display requirements
- Optimized button styles and spacing
- Improved visual design of form elements
- Enhanced accessibility and usability
### 🐛 Bug Fixes
- 🔧 **Session Management Fixes**:
- Fixed session statistics information not updating correctly
- Fixed session count calculation errors
- Improved session state tracking mechanism
- 🎯 **Prompt Feature Fixes**:
- Fixed common prompt management unable to correctly set auto-submit
- Improved prompt selection and application logic
- 🌐 **Localization Switch Fixes**:
- Fixed partial text not updating during language switching
- Improved multi-language text loading mechanism
- 🏗️ **Architecture Stability Fixes**:
- Fixed session management initialization issues
- Improved error handling and resource cleanup
- Optimized module loading order and dependencies
### 🛠️ Technical Improvements
- 📦 **Modular Architecture**:
- Complete JavaScript code modular refactoring
- Adopted ES6+ syntax and modern development patterns
- Clear module separation and responsibility division
- 📊 **Performance Enhancement**:
- Optimized WebSocket communication efficiency
- Improved frontend resource loading speed
- Reduced memory usage and CPU load
### 📚 Documentation Updates
- 📖 **Architecture Documentation Update**: Updated system architecture description to reflect Web-Only design
- 🔧 **Installation Guide Simplification**: Removed GUI-related installation steps and dependency descriptions
- 🖼️ **Screenshot Updates**: Updated all interface screenshots to showcase new Web UI design
- 📋 **Enhanced API Documentation**: Added API descriptions for new features like prompt management and auto-submit
---
## [v2.3.0] - System Stability & Resource Management Enhancement ## [v2.3.0] - System Stability & Resource Management Enhancement
### 🌟 Highlights ### 🌟 Highlights
@ -179,6 +268,13 @@ This version focuses on improving system stability and user experience, particul
| 📁 | File Structure | | 📁 | File Structure |
| ⌨️ | Shortcuts | | ⌨️ | Shortcuts |
| 🖼️ | Image Features | | 🖼️ | Image Features |
| 📝 | Prompt Management |
| ⏰ | Auto-Submit |
| 📊 | Session Management |
| 🔗 | Connection Monitoring |
| 🏗️ | Architecture Changes |
| 🛠️ | Technical Improvements |
| 📚 | Documentation Updates |
--- ---

View File

@ -2,6 +2,95 @@
本文件记录了 **MCP Feedback Enhanced** 的所有版本更新内容。 本文件记录了 **MCP Feedback Enhanced** 的所有版本更新内容。
## [v2.4.0] - 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] - 系统稳定性与资源管理增强 ## [v2.3.0] - 系统稳定性与资源管理增强
### 🌟 亮点 ### 🌟 亮点
@ -179,6 +268,13 @@
| 📁 | 文件结构 | | 📁 | 文件结构 |
| ⌨️ | 快捷键 | | ⌨️ | 快捷键 |
| 🖼️ | 图片功能 | | 🖼️ | 图片功能 |
| 📝 | 提示词管理 |
| ⏰ | 自动提交 |
| 📊 | 会话管理 |
| 🔗 | 连接监控 |
| 🏗️ | 架构变更 |
| 🛠️ | 技术改进 |
| 📚 | 文档更新 |
--- ---

View File

@ -2,6 +2,95 @@
本文件記錄了 **MCP Feedback Enhanced** 的所有版本更新內容。 本文件記錄了 **MCP Feedback Enhanced** 的所有版本更新內容。
## [v2.4.0] - 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] - 系統穩定性與資源管理增強 ## [v2.3.0] - 系統穩定性與資源管理增強
### 🌟 亮點 ### 🌟 亮點
@ -179,6 +268,13 @@
| 📁 | 檔案結構 | | 📁 | 檔案結構 |
| ⌨️ | 快捷鍵 | | ⌨️ | 快捷鍵 |
| 🖼️ | 圖片功能 | | 🖼️ | 圖片功能 |
| 📝 | 提示詞管理 |
| ⏰ | 自動提交 |
| 📊 | 會話管理 |
| 🔗 | 連線監控 |
| 🏗️ | 架構變更 |
| 🛠️ | 技術改進 |
| 📚 | 文檔更新 |
--- ---

Binary file not shown.

Before

Width:  |  Height:  |  Size: 52 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 55 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 117 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 61 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 28 KiB

BIN
docs/en/images/web1.jpeg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 116 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 74 KiB

BIN
docs/en/images/web2.jpeg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 191 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 72 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 54 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 53 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 117 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 61 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 28 KiB

BIN
docs/zh-CN/images/web1.jpeg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 105 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 115 KiB

BIN
docs/zh-CN/images/web2.jpeg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 180 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 88 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 54 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 53 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 117 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 61 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 28 KiB

BIN
docs/zh-TW/images/web1.jpeg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 106 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 115 KiB

BIN
docs/zh-TW/images/web2.jpeg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 181 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 88 KiB