MCP/mcp-feedback-enhanced
1
0
Fork 0
mirror of https://github.com/Minidoracat/mcp-feedback-enhanced.git synced 2025-07-27 02:22:26 +08:00
Code Issues Packages Projects Releases Wiki Activity

📝 更新 2.5.0 相關文檔

Browse Source
This commit is contained in:
Minidoracat 2025-06-15 18:04:06 +08:00
parent 3ed1150642
commit ff5a6c317d
15 changed files with 868 additions and 335 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
Makefile
View File

@ -3,7 +3,7 @@
# Compatible with Windows PowerShell and Unix systems # Compatible with Windows PowerShell and Unix systems
# 兼容 Windows PowerShell 和 Unix 系統 # 兼容 Windows PowerShell 和 Unix 系統
.PHONY: help install install-dev install-hooks lint format type-check test clean pre-commit-run pre-commit-all update-deps check-rust build-desktop build-desktop-release test-desktop clean-desktop build-all test-all .PHONY: help install install-dev install-hooks lint format type-check test clean pre-commit-run pre-commit-all update-deps check-rust build-desktop build-desktop-release test-desktop clean-desktop build-all test-all test-func test-web test-desktop-func
# 預設目標 - 顯示幫助訊息 # 預設目標 - 顯示幫助訊息
help: ## Show this help message help: ## Show this help message
@ -26,6 +26,9 @@ help: ## Show this help message
@echo " test Run tests" @echo " test Run tests"
@echo " test-cov Run tests with coverage" @echo " test-cov Run tests with coverage"
@echo " test-fast Run tests without slow tests" @echo " test-fast Run tests without slow tests"
@echo " test-func Run functional tests (standard)"
@echo " test-web Run Web UI tests (continuous)"
@echo " test-desktop-func Run desktop application functional tests"
@echo " clean Clean up cache and temporary files" @echo " clean Clean up cache and temporary files"
@echo " ps-clean PowerShell version of clean (Windows)" @echo " ps-clean PowerShell version of clean (Windows)"
@echo " update-deps Update dependencies" @echo " update-deps Update dependencies"
@ -96,6 +99,16 @@ test-cov: ## Run tests with coverage
test-fast: ## Run tests without slow tests test-fast: ## Run tests without slow tests
uv run pytest -m "not slow" uv run pytest -m "not slow"
# 功能測試命令
test-func: ## Run functional tests (standard)
uv run python -m mcp_feedback_enhanced test
test-web: ## Run Web UI tests (continuous)
uvx --no-cache --with-editable . mcp-feedback-enhanced test --web
test-desktop-func: ## Run desktop application functional tests
uvx --no-cache --with-editable . mcp-feedback-enhanced test --desktop
# 維護相關命令 # 維護相關命令
clean: ## Clean up cache and temporary files clean: ## Clean up cache and temporary files
@echo "Cleaning up..." @echo "Cleaning up..."
@ -179,5 +192,5 @@ build-all: clean build-desktop-release build ## Build complete package with desk
@echo "🎉 Complete build finished!" @echo "🎉 Complete build finished!"
# 測試所有功能 # 測試所有功能
test-all: test test-desktop ## Run all tests including desktop test-all: test test-func test-desktop ## Run all tests including desktop and functional tests
@echo "✅ All tests completed!" @echo "✅ All tests completed!"

281
README.md
View File

@ -8,21 +8,21 @@
## 🎯 Core Concept ## 🎯 Core Concept
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. This is an [MCP server](https://modelcontextprotocol.io/) that establishes **feedback-oriented development workflows**, providing **Web UI and Desktop Application** dual interface options, 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:** **🌐 Dual Interface Architecture Advantages:**
- 🚀 **Simplified Deployment**: No GUI dependencies, lighter installation - 🖥️ **Desktop Application**: Native cross-platform desktop experience, supporting Windows, macOS, Linux
- 🌍 **Cross-Platform Compatibility**: Supports all operating systems and environments - 🌐 **Web UI Interface**: No GUI dependencies required, suitable for remote and WSL environments
- 🔧 **Easy Maintenance**: Unified Web interface, reduced complexity - 🔧 **Flexible Deployment**: Choose the most suitable interface mode based on environment requirements
- 📦 **Compact Size**: Removed heavy GUI libraries, significantly smaller installation package - 📦 **Unified Functionality**: Both interfaces provide exactly the same functional experience
**🔮 Future Plans:** We plan to reintroduce desktop applications after feature stabilization, currently focusing on Web UI feature enhancement and optimization. **🖥️ Desktop Application:** v2.5.0 introduces cross-platform desktop application support based on Tauri framework, supporting Windows, macOS, and Linux platforms with native desktop experience.
**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` tool 1. **AI Call** → `mcp-feedback-enhanced` tool
2. **Web UI Launch** → Auto-open browser interface (pure Web architecture) 2. **Interface Launch** → Auto-open desktop application or browser interface (based on configuration)
3. **Smart Interaction** → Prompt selection, text input, image upload, auto-submit 3. **Smart Interaction** → Prompt selection, text input, image upload, auto-submit
4. **Real-time Feedback** → WebSocket connection delivers information to AI instantly 4. **Real-time Feedback** → WebSocket connection delivers information to AI instantly
5. **Session Tracking** → Auto-record session history and statistics 5. **Session Tracking** → Auto-record session history and statistics
@ -30,85 +30,36 @@ This is an [MCP server](https://modelcontextprotocol.io/) that establishes **fee
## 🌟 Key Features ## 🌟 Key Features
### 🌐 Pure Web UI Architecture System ### 🖥️ Dual Interface Support
- **Web-Only Design**: Completely removed desktop GUI dependencies, adopting pure Web interface - **Desktop Application**: Cross-platform native application based on Tauri, supporting Windows, macOS, Linux
- **Universal Compatibility**: Supports local, SSH Remote, and WSL environments - **Web UI Interface**: Lightweight browser interface suitable for remote and WSL environments
- **Auto Adaptation**: Intelligent environment detection and optimal configuration - **Automatic Environment Detection**: Intelligently recognizes SSH Remote, WSL and other special environments
- **Lightweight Deployment**: No complex GUI environment configuration required - **Unified Feature Experience**: Both interfaces provide exactly the same functionality
### 📝 Smart Prompt Management System (v2.4.0 New Feature) ### 📝 Smart Workflow
- **CRUD Operations**: Create, edit, delete, and use common prompts - **Prompt Management**: CRUD operations for common prompts, usage statistics, intelligent sorting
- **Usage Statistics**: Track usage frequency with intelligent sorting - **Auto-Timed Submit**: 1-86400 second flexible timer, supports pause, resume, cancel
- **Quick Application**: One-click selection and application of prompts - **Session Management & Tracking**: Local file storage, privacy controls, history export, real-time statistics
- **Auto-Submit Integration**: Support auto-submit marking and priority display - **Connection Monitoring**: WebSocket status monitoring, auto-reconnection, quality indicators
- **AI Work Summary Markdown Display**: Support for rich Markdown syntax rendering including headers, bold text, code blocks, lists, links and other formats for enhanced content readability
### ⏰ Auto-Timed Submit Feature (v2.4.0 New Feature) ### 🎨 Modern Experience
- **Flexible Timing**: Configurable countdown timer from 1-86400 seconds - **Responsive Design**: Adapts to different screen sizes, modular JavaScript architecture
- **Visual Display**: Real-time countdown display and status indicators - **Audio Notifications**: Built-in multiple sound effects, custom audio upload support, volume control
- **Deep Integration**: Seamless integration with prompt management system - **Smart Memory**: Input box height memory, one-click copy, persistent settings
- **Complete Control**: Support pause, resume, and cancel operations - **Multi-language Support**: Traditional Chinese, English, Simplified Chinese, instant switching
### 📊 Session Management & Tracking (v2.4.3 Refactored & Enhanced) ### 🖼️ Images & Media
- **Dedicated Tab Design**: Migrated from sidebar to dedicated tab, resolving browser compatibility issues - **Full Format Support**: PNG, JPG, JPEG, GIF, BMP, WebP
- **Local History Storage**: Support for local session record storage with configurable retention periods - **Convenient Upload**: Drag & drop files, clipboard paste (Ctrl+V)
- **Privacy Control**: User message recording with three privacy level settings - **Unlimited Processing**: Support for any size images, automatic intelligent processing
- **Data Management**: Support for session history export and cleanup functionality
- **Real-time Statistics**: Today's session count and average duration statistics
### 🔗 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
### 🔊 Audio Notification System (v2.4.3 New Feature)
- **Smart Alerts**: Automatically play audio notifications when sessions update
- **Multiple Audio Options**: Built-in classic beep, notification ding, soft chime
- **Custom Audio**: Support uploading custom audio files (MP3, WAV, OGG formats)
- **Full Control**: Volume adjustment, test playback, and audio management features
### 🎨 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
- **Smart Layout**: AI summary auto-expansion, optimized submit button positioning
### 🖼️ Image Support
- **Format Support**: PNG, JPG, JPEG, GIF, BMP, WebP
- **Upload Methods**: Drag & drop files + clipboard paste (Ctrl+V)
- **Unlimited Upload**: Support image files of any size with automatic smart processing
### 💾 Smart Memory Features (v2.4.3 New Feature)
- **Input Height Memory**: Automatically save and restore textarea input height settings
- **One-Click Copy**: Project path and session ID support click-to-copy to clipboard
- **Settings Persistence**: All user preference settings automatically saved
### 🌏 Multi-language
- **Three Languages**: English, Traditional Chinese, Simplified Chinese
- **Smart Detection**: Auto-select based on system language
- **Live Switching**: Change language directly within interface
- **Complete Internationalization**: Includes multilingual support for tooltips and button hints
### ✨ WSL Environment Support (v2.2.5)
- **Auto Detection**: Intelligently identifies WSL (Windows Subsystem for Linux) environments
- **Browser Integration**: Automatically launches Windows browser in WSL environments
- **Multiple Launch Methods**: Supports `cmd.exe`, `powershell.exe`, `wslview` and other browser launch methods
- **Seamless Experience**: WSL users can directly use Web UI without additional configuration
### 🌐 SSH Remote Environment Support (v2.3.0 New Feature)
- **Smart Detection**: Automatically identifies SSH Remote environments (Cursor SSH Remote, VS Code Remote SSH, etc.)
- **Browser Launch Guidance**: Provides clear solutions when browser cannot launch automatically
- **Port Forwarding Support**: Complete port forwarding setup guidance and troubleshooting
- **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)
- 🎯 **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 (v2.4.0 - Web-Only Architecture) ### Web UI Interface (v2.5.0 - Desktop Application Support)
<div align="center"> <div align="center">
<img src="docs/en/images/web1.jpeg" width="400" alt="Web UI Main Interface - Prompt Management & Auto-Submit" /> <img src="docs/en/images/web1.jpeg" width="400" alt="Web UI Main Interface - Prompt Management & Auto Submit" />
</div> </div>
<details> <details>
@ -120,12 +71,20 @@ This is an [MCP server](https://modelcontextprotocol.io/) that establishes **fee
</details> </details>
*Web UI Interface - Pure Web architecture, supporting prompt management, auto-submit, session tracking and other smart features* *Web UI Interface - Supports desktop application and Web interface, providing prompt management, auto-submit, session tracking and other smart features*
**Keyboard Shortcuts** ### Desktop Application Interface (v2.5.0 New Feature)
- `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 <div align="center">
- `Ctrl+I` (Windows/Linux) / `Cmd+I` (macOS): Quick focus input box (Thanks @penn201500) <img src="docs/en/images/desktop1.png" width="600" alt="Desktop Application - Native Cross-platform Desktop Experience" />
</div>
*Desktop Application - Native cross-platform desktop application based on Tauri framework, supporting Windows, macOS, Linux with exactly the same functionality as Web UI*
**Shortcut Support**
- `Ctrl+Enter`（Windows/Linux）/ `Cmd+Enter`（macOS）：Submit feedback (both main keyboard and numeric keypad supported)
- `Ctrl+V`（Windows/Linux）/ `Cmd+V`（macOS）：Direct paste clipboard images
- `Ctrl+I`（Windows/Linux）/ `Cmd+I`（macOS）：Quick focus input box (Thanks @penn201500)
## 🚀 Quick Start ## 🚀 Quick Start
@ -138,7 +97,7 @@ pip install uv
uvx mcp-feedback-enhanced@latest test uvx mcp-feedback-enhanced@latest test
``` ```
### 2. MCP Configuration ### 2. Configure MCP
**Basic Configuration** (suitable for most users): **Basic Configuration** (suitable for most users):
```json ```json
{ {
@ -153,7 +112,7 @@ uvx mcp-feedback-enhanced@latest test
} }
``` ```
**Advanced Configuration** (custom environment needed): **Advanced Configuration** (requires custom environment):
```json ```json
{ {
"mcpServers": { "mcpServers": {
@ -171,17 +130,40 @@ uvx mcp-feedback-enhanced@latest test
} }
``` ```
**Desktop Application Configuration** (v2.5.0 new feature - using native desktop application):
```json
{
"mcpServers": {
"mcp-feedback-enhanced": {
"command": "uvx",
"args": ["mcp-feedback-enhanced@latest"],
"timeout": 600,
"env": {
"MCP_DESKTOP_MODE": "true",
"MCP_WEB_PORT": "8765",
"MCP_DEBUG": "false"
},
"autoApprove": ["interactive_feedback"]
}
}
}
```
**Configuration File Examples**:
- Desktop Mode: [examples/mcp-config-desktop.json](examples/mcp-config-desktop.json)
- Web Mode: [examples/mcp-config-web.json](examples/mcp-config-web.json)
### 3. Prompt Engineering Setup ### 3. Prompt Engineering Setup
For best results, add these rules to your AI assistant: For optimal results, add the following rules to your AI assistant:
``` ```
# MCP Interactive Feedback Rules # MCP Interactive Feedback Rules
1. During any process, task, or conversation, whether asking, responding, or completing stage tasks, must call MCP mcp-feedback-enhanced. 1. During any process, task, or conversation, whether asking, replying, or completing phased tasks, you must call MCP mcp-feedback-enhanced.
2. When receiving user feedback, if feedback content is not empty, must call MCP mcp-feedback-enhanced again and adjust behavior based on feedback. 2. Whenever user feedback is received, if the feedback content is not empty, you must call MCP mcp-feedback-enhanced again and adjust behavior based on the feedback content.
3. Only when user explicitly indicates "end" or "no more interaction needed" can you stop calling MCP mcp-feedback-enhanced, then the process is complete. 3. Only when the user explicitly indicates "end" or "no more interaction needed" can you stop calling MCP mcp-feedback-enhanced, and the process is considered complete.
4. Unless receiving end command, all steps must repeatedly call MCP mcp-feedback-enhanced. 4. Unless receiving termination instructions, all steps must repeatedly call MCP mcp-feedback-enhanced.
5. Before completing the task, use the MCP mcp-feedback-enhanced to ask the user for feedback. 5. Before completing tasks, you must use the MCP mcp-feedback-enhanced tool to ask users for feedback.
``` ```
## ⚙️ Advanced Settings ## ⚙️ Advanced Settings
@ -191,6 +173,7 @@ For best results, add these rules to your AI assistant:
|----------|---------|--------|---------| |----------|---------|--------|---------|
| `MCP_DEBUG` | Debug mode | `true`/`false` | `false` | | `MCP_DEBUG` | Debug mode | `true`/`false` | `false` |
| `MCP_WEB_PORT` | Web UI port | `1024-65535` | `8765` | | `MCP_WEB_PORT` | Web UI port | `1024-65535` | `8765` |
| `MCP_DESKTOP_MODE` | Desktop application mode | `true`/`false` | `false` |
### Testing Options ### Testing Options
```bash ```bash
@ -199,7 +182,7 @@ uvx mcp-feedback-enhanced@latest version # Check version
# Interface testing # Interface testing
uvx mcp-feedback-enhanced@latest test --web # Test Web UI (auto continuous running) uvx mcp-feedback-enhanced@latest test --web # Test Web UI (auto continuous running)
uvx mcp-feedback-enhanced@latest test --enhanced # Enhanced test suite uvx mcp-feedback-enhanced@latest test --desktop # Test desktop application (v2.5.0 new feature)
# Debug mode # Debug mode
MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test
@ -214,18 +197,30 @@ uv sync
**Local Testing Methods** **Local Testing Methods**
```bash ```bash
# Functional Testing # Functional testing
uv run python -m mcp_feedback_enhanced test # Standard functional testing make test-func # Standard functional testing
uvx --with-editable . mcp-feedback-enhanced test --web # Web UI testing (continuous running) make test-web # Web UI testing (continuous running)
make test-desktop-func # Desktop application functional testing
# Unit Testing # Or use direct commands
uv run python -m mcp_feedback_enhanced test # Standard functional testing
uvx --no-cache --with-editable . mcp-feedback-enhanced test --web # Web UI testing (continuous running)
uvx --no-cache --with-editable . mcp-feedback-enhanced test --desktop # Desktop application testing
# Desktop application build (v2.5.0 new feature)
make build-desktop # Build desktop application (debug mode)
make build-desktop-release # Build desktop application (release mode)
make test-desktop # Test desktop application
make clean-desktop # Clean desktop build artifacts
# Unit testing
make test # Run all unit tests make test # Run all unit tests
make test-fast # Fast testing (skip slow tests) make test-fast # Fast testing (skip slow tests)
make test-cov # Testing with coverage report make test-cov # Test and generate coverage report
# Code Quality Checks # Code quality checks
make check # Complete code quality checks make check # Complete code quality check
make quick-check # Quick check with auto-fix make quick-check # Quick check and auto-fix
``` ```
**Testing Descriptions** **Testing Descriptions**
@ -236,91 +231,95 @@ make quick-check # Quick check with auto-
## 🆕 Version History ## 🆕 Version History
📋 **Complete Version History:** [RELEASE_NOTES/CHANGELOG.en.md](RELEASE_NOTES/CHANGELOG.en.md) 📋 **Complete Version History:** [RELEASE_NOTES/CHANGELOG.md](RELEASE_NOTES/CHANGELOG.md)
### Latest Version Highlights (v2.4.3) ### Latest Version Highlights (v2.5.0)
- 📋 **Session Management Refactoring**: Migrated from sidebar to dedicated tab, resolving browser compatibility issues - 🖥️ **Desktop Application**: Brand new cross-platform desktop application supporting Windows, macOS, Linux
- 🔊 **Audio Notification System**: Session update audio alerts with built-in and custom audio support - 📋 **AI Work Summary Markdown Display**: Support for Markdown syntax rendering including headers, bold text, code blocks, lists, links and other formats
- 📚 **Enhanced Session History**: Local storage, privacy control, export and cleanup functionality - ⚡ **Significant Performance Enhancement**: Introduced debounce/throttle mechanisms to reduce unnecessary rendering and network requests
- 💾 **Smart Memory Features**: Input height memory, one-click copy, and other convenience features - 📊 **Session History Storage Improvement**: Migrated from localStorage to server-side local file storage
- 🎨 **Interface Layout Optimization**: AI summary auto-expansion, button repositioning, simplified design - 🌐 **Network Connection Stability**: Improved WebSocket reconnection mechanism with network status detection
- 🌐 **Multilingual Enhancement**: Complete internationalization support for tooltips and button hints - 🎨 **UI Rendering Optimization**: Optimized rendering performance for session management, statistics, and status indicators
- 🐛 **Bug Fixes**: Fixed session details button, modal close delay, and other user experience issues - 🛠️ **Build Process Optimization**: Added Makefile desktop application build commands and development tools
- 🛠️ **Technical Architecture Upgrade**: JavaScript modular refactoring, adopting modern development patterns - 📚 **Documentation Enhancement**: Added desktop application build guide and workflow documentation
## 🐛 Common Issues ## 🐛 Common Issues
### 🌐 SSH Remote Environment Issues ### 🌐 SSH Remote Environment Issues
**Q: Browser cannot launch in SSH Remote environment** **Q: Browser cannot launch in SSH Remote environment**
A: This is normal behavior. SSH Remote environments have no graphical interface, requiring manual opening in local browser. For detailed solutions, see: [SSH Remote Environment Usage Guide](docs/en/ssh-remote/browser-launch-issues.md) A: This is normal. SSH Remote environments have no graphical interface, requiring manual opening in local browser. For detailed solutions, refer to: [SSH Remote Environment Usage Guide](docs/en/ssh-remote/browser-launch-issues.md)
**Q: Why am I not receiving new MCP feedback?** **Q: Why am I not receiving new MCP feedback?**
A: There might be a WebSocket connection issue. **Solution**: Simply refresh the browser page. A: Likely a WebSocket connection issue. **Solution**: Directly refresh the browser page.
**Q: Why isn't MCP being called?** **Q: Why isn't MCP being called?**
A: Please confirm the MCP tool status shows green light. **Solution**: Toggle the MCP tool on/off repeatedly, wait a few seconds for system reconnection. A: Please confirm MCP tool status shows green light. **Solution**: Repeatedly toggle MCP tool on/off, wait a few seconds for system reconnection.
**Q: Augment cannot start MCP** **Q: Augment cannot start MCP**
A: **Solution**: Completely close and restart VS Code or Cursor, then reopen the project. A: **Solution**: Completely close and restart VS Code or Cursor, reopen the project.
### 🔧 General Issues ### 🔧 General Issues
**Q: How to use the legacy GUI interface?** **Q: How to use desktop application?**
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: A: v2.5.0 introduces cross-platform desktop application support. Set `"MCP_DESKTOP_MODE": "true"` in MCP configuration to enable:
```bash ```json
# Use v2.3.0 (last version supporting GUI)
uvx mcp-feedback-enhanced@2.3.0
# Or specify version in MCP configuration
{ {
"mcpServers": { "mcpServers": {
"mcp-feedback-enhanced": { "mcp-feedback-enhanced": {
"command": "uvx", "command": "uvx",
"args": ["mcp-feedback-enhanced@2.3.0"], "args": ["mcp-feedback-enhanced@latest"],
"timeout": 600, "timeout": 600,
"env": {
"MCP_DESKTOP_MODE": "true",
"MCP_WEB_PORT": "8765"
},
"autoApprove": ["interactive_feedback"] "autoApprove": ["interactive_feedback"]
} }
} }
} }
``` ```
**Note**: Legacy versions do not include v2.4.0 new features (prompt management, auto-submit, session management, etc.). **Configuration File Example**: [examples/mcp-config-desktop.json](examples/mcp-config-desktop.json)
**Q: Getting "Unexpected token 'D'" error** **Q: How to use legacy PyQt6 GUI interface?**
A: v2.4.0 completely removed PyQt6 GUI dependencies. To use legacy GUI, specify v2.3.0 or earlier: `uvx mcp-feedback-enhanced@2.3.0`
**Note**: Legacy versions don't include new features (prompt management, auto-submit, session management, desktop application, etc.).
**Q: "Unexpected token 'D'" error appears**
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.
**Q: Chinese character garbled text** **Q: Chinese character garbled text**
A: Fixed in v2.0.3. Update to latest version: `uvx mcp-feedback-enhanced@latest` A: Fixed in v2.0.3. Update to latest version: `uvx mcp-feedback-enhanced@latest`
**Q: Multi-screen window disappearing or positioning errors** **Q: Window disappears or positioning errors in multi-screen environment**
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 suitable for T-shaped screen arrangements and other complex multi-screen configurations.
**Q: Image upload fails** **Q: Image upload failure**
A: Check file format (PNG/JPG/JPEG/GIF/BMP/WebP). System supports image files of any size. A: Check file format (PNG/JPG/JPEG/GIF/BMP/WebP). System supports any size image files.
**Q: Web UI won't start** **Q: Web UI cannot start**
A: Check firewall settings or try using a different port. A: Check firewall settings or try using different ports.
**Q: UV Cache taking up too much disk space** **Q: UV Cache occupies too much disk space**
A: Due to frequent use of `uvx` commands, cache may accumulate to tens of GB. Regular cleanup is recommended: A: Due to frequent use of `uvx` commands, cache may accumulate to tens of GB. Regular cleanup recommended:
```bash ```bash
# Check cache size and detailed information # View cache size and detailed information
python scripts/cleanup_cache.py --size python scripts/cleanup_cache.py --size
# Preview cleanup content (without actually cleaning) # Preview cleanup content (no actual cleanup)
python scripts/cleanup_cache.py --dry-run python scripts/cleanup_cache.py --dry-run
# Execute standard cleanup # Execute standard cleanup
python scripts/cleanup_cache.py --clean python scripts/cleanup_cache.py --clean
# Force cleanup (attempts to close related processes, solves Windows file lock issues) # Force cleanup (attempts to close related programs, solving Windows file occupation issues)
python scripts/cleanup_cache.py --force python scripts/cleanup_cache.py --force
# Or use uv command directly # Or directly use uv command
uv cache clean uv cache clean
``` ```
For detailed instructions, see: [Cache Management Guide](docs/en/cache-management.md) For detailed instructions, refer to: [Cache Management Guide](docs/en/cache-management.md)
**Q: AI models cannot parse images** **Q: AI models cannot parse images**
A: Various AI models (including Gemini Pro 2.5, Claude, etc.) may have instability in image parsing, sometimes correctly identifying and sometimes unable to parse uploaded image content. This is a known limitation of AI visual understanding technology. Recommendations: A: Various AI models (including Gemini Pro 2.5, Claude, etc.) may have instability in image parsing, sometimes correctly recognizing and sometimes unable to parse uploaded image content. This is a known limitation of AI visual understanding technology. Recommendations:
1. Ensure good image quality (high contrast, clear text) 1. Ensure good image quality (high contrast, clear text)
2. Try uploading multiple times, retries usually succeed 2. Try uploading multiple times, retries usually succeed
3. If parsing continues to fail, try adjusting image size or format 3. If parsing continues to fail, try adjusting image size or format
@ -331,7 +330,7 @@ A: Various AI models (including Gemini Pro 2.5, Claude, etc.) may have instabili
**Fábio Ferreira** - [X @fabiomlferreira](https://x.com/fabiomlferreira) **Fábio Ferreira** - [X @fabiomlferreira](https://x.com/fabiomlferreira)
**Original Project:** [noopstudios/interactive-feedback-mcp](https://github.com/noopstudios/interactive-feedback-mcp) **Original Project:** [noopstudios/interactive-feedback-mcp](https://github.com/noopstudios/interactive-feedback-mcp)
If you find this useful, please: If you find it useful, please:
- ⭐ [Star the original project](https://github.com/noopstudios/interactive-feedback-mcp) - ⭐ [Star the original project](https://github.com/noopstudios/interactive-feedback-mcp)
- 📱 [Follow the original author](https://x.com/fabiomlferreira) - 📱 [Follow the original author](https://x.com/fabiomlferreira)
@ -348,7 +347,7 @@ If you find this useful, please:
## 📄 License ## 📄 License
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!**

194
README.zh-CN.md
View File

@ -8,21 +8,21 @@
## 🎯 核心概念 ## 🎯 核心概念
这是一个 [MCP 服务器](https://modelcontextprotocol.io/)，建立**反馈导向的开发工作流程**，采用**纯 Web UI 架构**，完美适配本地、**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 依赖，安装更轻量 - 🖥️ **桌面应用程序**：原生跨平台桌面体验，支持 Windows、macOS、Linux
- 🌍 **跨平台兼容**：支持所有操作系统和环境 - 🌐 **Web UI 界面**：无需 GUI 依赖，适合远程和 WSL 环境
- 🔧 **维护简单**：统一的 Web 界面，降低复杂度 - 🔧 **灵活部署**：根据环境需求选择最适合的界面模式
- 📦 **体积精简**：移除重型 GUI 库，安装包大幅缩小 - 📦 **统一功能**：两种界面提供完全相同的功能体验
**🔮 未来计划：** 我们计划在功能稳定后重新引入桌面版应用程序，目前专注于 Web UI 功能的完善和优化。 **🖥️ 桌面应用程序：** v2.5.0 新增跨平台桌面应用程序支持，基于 Tauri 框架，支持 Windows、macOS、Linux 三大平台，提供原生桌面体验。
**支持平台：** [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. **Web UI 启动** → 自动打开浏览器界面（纯 Web 架构） 2. **界面启动** → 自动打开桌面应用程序或浏览器界面（根据配置）
3. **智能交互** → 提示词选择、文字输入、图片上传、自动提交 3. **智能交互** → 提示词选择、文字输入、图片上传、自动提交
4. **即时反馈** → WebSocket 连接即时传递信息给 AI 4. **即时反馈** → WebSocket 连接即时传递信息给 AI
5. **会话追踪** → 自动记录会话历史与统计 5. **会话追踪** → 自动记录会话历史与统计
@ -30,81 +30,33 @@
## 🌟 主要功能 ## 🌟 主要功能
### 🌐 纯 Web UI 架构系统 ### 🖥️ 双重界面支持
- **Web-Only 设计**：完全移除桌面 GUI 依赖，采用纯 Web 界面 - **桌面应用程序**：基于 Tauri 的跨平台原生应用，支持 Windows、macOS、Linux
- **通用兼容性**：支持本地、SSH Remote 和 WSL 环境 - **Web UI 界面**：轻量级浏览器界面，适合远程和 WSL 环境
- **自动适配**：智能环境检测与最佳配置 - **环境自动检测**：智能识别 SSH Remote、WSL 等特殊环境
- **轻量部署**：无需复杂的 GUI 环境配置 - **统一功能体验**：两种界面提供完全相同的功能
### 📝 智能提示词管理系统（v2.4.0 新功能） ### 📝 智能工作流程
- **CRUD 操作**：新增、编辑、删除、使用常用提示词 - **提示词管理**：常用提示词的 CRUD 操作、使用统计、智能排序
- **使用统计**：追踪使用频率并智能排序 - **自动定时提交**：1-86400 秒弹性计时器，支持暂停、恢复、取消
- **快速应用**：一键选择和应用提示词 - **会话管理追踪**：本地文件存储、隐私控制、历史导出、即时统计
- **自动提交整合**：支持自动提交标记和优先显示 - **连接监控**：WebSocket 状态监控、自动重连、品质指示
- **AI 工作摘要 Markdown 显示**：支持丰富的 Markdown 语法渲染，包含标题、粗体、代码区块、列表、链接等格式，提升内容可读性
### ⏰ 自动定时提交功能（v2.4.0 新功能） ### 🎨 现代化体验
- **弹性计时**：可设定 1-86400 秒的倒数计时器 - **响应式设计**：适配不同屏幕尺寸，模块化 JavaScript 架构
- **视觉化显示**：即时倒数显示和状态指示 - **音效通知**：内建多种音效、支持自定义音效上传、音量控制
- **深度整合**：与提示词管理系统无缝配合 - **智能记忆**：输入框高度记忆、一键复制、设定持久化
- **完整控制**：支持暂停、恢复、取消操作 - **多语言支持**：简体中文、英文、繁体中文，即时切换
### 📊 会话管理与追踪（v2.4.3 重构增强） ### 🖼️ 图片与媒体
- **独立页签设计**：从左侧边栏迁移到专属页签，解决浏览器兼容性问题 - **全格式支持**：PNG、JPG、JPEG、GIF、BMP、WebP
- **本地历史保存**：支持会话记录本地保存，可设定保存期限 - **便捷上传**：拖拽文件、剪贴板粘贴（Ctrl+V）
- **隐私控制**：用户消息记录支持三种隐私等级设定 - **无限制处理**：支持任意大小图片，自动智能处理
- **数据管理**：支持会话历史导出和清理功能
- **实时统计**：今日会话数量和平均时长统计
### 🔗 连接监控系统（v2.4.0 新功能）
- **即时监控**：WebSocket 连接状态即时监控
- **品质指示**：延迟测量和连接品质指示
- **自动重连**：智能重连机制和错误处理
- **详细统计**：完整的连接统计信息
### 🔊 音效通知系统（v2.4.3 新功能）
- **智能提醒**：会话更新时自动播放音效通知
- **多种音效**：内建经典提示音、通知铃声、轻柔钟声
- **自定义音效**：支持上传 MP3、WAV、OGG 格式的自定义音效
- **完整控制**：音量调节、测试播放、音效管理功能
### 🎨 现代化界面设计
- **模块化架构**：JavaScript 完全模块化重构
- **响应式设计**：适配不同屏幕尺寸和窗口大小
- **统一风格**：一致的设计语言和视觉体验
- **智能布局**：AI 摘要区域自动扩展，提交按钮位置优化
### 🖼️ 图片支持
- **格式支持**：PNG、JPG、JPEG、GIF、BMP、WebP
- **上传方式**：拖拽文件 + 剪贴板粘贴（Ctrl+V）
- **无限制上传**：支持任意大小的图片文件，自动智能处理
### 💾 智能记忆功能（v2.4.3 新功能）
- **输入框高度记忆**：自动保存和恢复文字输入框的高度设定
- **一键复制**：项目路径和会话ID支持点击复制到剪贴板
- **设定持久化**：所有用户偏好设定自动保存
### 🌏 多语言
- **三语支持**：简体中文、英文、繁体中文
- **智能检测**：根据系统语言自动选择
- **即时切换**：界面内可直接切换语言
- **完整国际化**：包含 tooltip 和按钮提示的多语言支持
### ✨ WSL 环境支持（v2.2.5）
- **自动检测**：智能识别 WSL (Windows Subsystem for Linux) 环境
- **浏览器整合**：WSL 环境下自动启动 Windows 浏览器
- **多种启动方式**：支持 `cmd.exe`、`powershell.exe`、`wslview` 等多种浏览器启动方法
- **无缝体验**：WSL 用户可直接使用 Web UI，无需额外配置
### 🌐 SSH Remote 环境支持（v2.3.0 新功能）
- **智能检测**：自动识别 SSH Remote 环境（Cursor SSH Remote、VS Code Remote SSH 等）
- **浏览器启动指引**：当无法自动启动浏览器时，提供清晰的解决方案
- **端口转发支持**：完整的端口转发设置指引和故障排除
- **MCP 整合优化**：改善与 MCP 系统的整合，提供更稳定的连接体验
- **详细文档**：[SSH Remote 环境使用指南](docs/zh-CN/ssh-remote/browser-launch-issues.md)
## 🌐 界面预览 ## 🌐 界面预览
### Web UI 界面（v2.4.0 - Web-Only 架构） ### Web UI 界面（v2.5.0 - 支持桌面应用程序）
<div align="center"> <div align="center">
<img src="docs/zh-CN/images/web1.jpeg" width="400" alt="Web UI 主界面 - 提示词管理与自动提交" /> <img src="docs/zh-CN/images/web1.jpeg" width="400" alt="Web UI 主界面 - 提示词管理与自动提交" />
@ -119,7 +71,15 @@
</details> </details>
*Web UI 界面 - 纯 Web 架构，支持提示词管理、自动提交、会话追踪等智能功能* *Web UI 界面 - 支持桌面应用程序和 Web 界面，提供提示词管理、自动提交、会话追踪等智能功能*
### 桌面应用程序界面（v2.5.0 新功能）
<div align="center">
<img src="docs/zh-CN/images/desktop1.png" width="600" alt="桌面应用程序 - 原生跨平台桌面体验" />
</div>
*桌面应用程序 - 基于 Tauri 框架的原生跨平台桌面应用，支持 Windows、macOS、Linux，提供与 Web UI 完全相同的功能*
**快捷键支持** **快捷键支持**
- `Ctrl+Enter`（Windows/Linux）/ `Cmd+Enter`（macOS）：提交反馈（主键盘与数字键盘皆支持） - `Ctrl+Enter`（Windows/Linux）/ `Cmd+Enter`（macOS）：提交反馈（主键盘与数字键盘皆支持）
@ -170,6 +130,29 @@ uvx mcp-feedback-enhanced@latest test
} }
``` ```
**桌面应用程序配置**（v2.5.0 新功能 - 使用原生桌面应用程序）：
```json
{
"mcpServers": {
"mcp-feedback-enhanced": {
"command": "uvx",
"args": ["mcp-feedback-enhanced@latest"],
"timeout": 600,
"env": {
"MCP_DESKTOP_MODE": "true",
"MCP_WEB_PORT": "8765",
"MCP_DEBUG": "false"
},
"autoApprove": ["interactive_feedback"]
}
}
}
```
**配置文件示例**：
- 桌面模式：[examples/mcp-config-desktop.json](examples/mcp-config-desktop.json)
- Web 模式：[examples/mcp-config-web.json](examples/mcp-config-web.json)
### 3. 设定提示工程 ### 3. 设定提示工程
为了获得最佳效果，请在 AI 助手中添加以下规则： 为了获得最佳效果，请在 AI 助手中添加以下规则：
@ -190,6 +173,7 @@ uvx mcp-feedback-enhanced@latest test
|------|------|-----|------| |------|------|-----|------|
| `MCP_DEBUG` | 调试模式 | `true`/`false` | `false` | | `MCP_DEBUG` | 调试模式 | `true`/`false` | `false` |
| `MCP_WEB_PORT` | Web UI 端口 | `1024-65535` | `8765` | | `MCP_WEB_PORT` | Web UI 端口 | `1024-65535` | `8765` |
| `MCP_DESKTOP_MODE` | 桌面应用程序模式 | `true`/`false` | `false` |
### 测试选项 ### 测试选项
```bash ```bash
@ -198,6 +182,7 @@ 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 --desktop # 测试桌面应用程序 (v2.5.0 新功能)
# 调试模式 # 调试模式
MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test
@ -213,8 +198,20 @@ uv sync
**本地测试方式** **本地测试方式**
```bash ```bash
# 功能测试 # 功能测试
make test-func # 标准功能测试
make test-web # Web UI 测试 (持续运行)
make test-desktop-func # 桌面应用功能测试
# 或直接使用指令
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 测试 (持续运行) uvx --no-cache --with-editable . mcp-feedback-enhanced test --web # Web UI 测试 (持续运行)
uvx --no-cache --with-editable . mcp-feedback-enhanced test --desktop # 桌面应用测试
# 桌面应用构建 (v2.5.0 新功能)
make build-desktop # 构建桌面应用 (debug 模式)
make build-desktop-release # 构建桌面应用 (release 模式)
make test-desktop # 测试桌面应用
make clean-desktop # 清理桌面构建产物
# 单元测试 # 单元测试
make test # 运行所有单元测试 make test # 运行所有单元测试
@ -236,14 +233,15 @@ make quick-check # 快速检查并自动
📋 **完整版本更新记录：** [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.4.3） ### 最新版本亮点（v2.5.0）
- 📋 **会话管理重构**: 从左侧边栏迁移到独立页签，解决浏览器兼容性问题 - 🖥️ **桌面应用程序**: 全新跨平台桌面应用，支持 Windows、macOS、Linux
- 🔊 **音效通知系统**: 会话更新音效提醒，支持内建和自定义音效 - 📋 **AI 工作摘要 Markdown 显示**: 支持 Markdown 语法渲染，包含标题、粗体、代码区块、列表、链接等格式
- 📚 **会话历史增强**: 本地保存、隐私控制、导出清理功能 - ⚡ **性能大幅提升**: 引入防抖/节流机制，减少不必要的渲染和网络请求
- 💾 **智能记忆功能**: 输入框高度记忆、一键复制等便利功能 - 📊 **会话历史存储改进**: 从 localStorage 改为服务器端本地文件存储
- 🎨 **界面布局优化**: AI 摘要自动扩展、按钮位置调整、简化设计 - 🌐 **网络连接稳定性**: 改进 WebSocket 重连机制，支持网络状态检测
- 🌐 **多语言完善**: tooltip 和按钮提示的完整国际化支持 - 🎨 **UI 渲染优化**: 优化会话管理、统计信息、状态指示器的渲染性能
- 🐛 **问题修复**: 修复会话详情按钮、弹窗关闭延迟等用户体验问题 - 🛠️ **构建流程优化**: 新增 Makefile 桌面应用构建命令和开发工具
- 📚 **文档完善**: 新增桌面应用构建指南和工作流程说明
## 🐛 常见问题 ## 🐛 常见问题
@ -261,25 +259,29 @@ A: 请确认 MCP 工具状态为绿灯。**解决方法**：反复开关 MCP 工
A: **解决方法**：完全关闭并重新启动 VS Code 或 Cursor，重新打开项目。 A: **解决方法**：完全关闭并重新启动 VS Code 或 Cursor，重新打开项目。
### 🔧 一般问题 ### 🔧 一般问题
**Q: 如何使用旧版 GUI 界面？** **Q: 如何使用桌面应用程序？**
A: v2.4.0 版本已完全移除 PyQt6 GUI 依赖，转为纯 Web UI 架构。如需使用旧版 GUI，请指定 v2.3.0 或更早版本： A: v2.5.0 新增跨平台桌面应用程序支持。在 MCP 配置中设定 `"MCP_DESKTOP_MODE": "true"` 即可启用：
```bash ```json
# 使用 v2.3.0（最后支持 GUI 的版本）
uvx mcp-feedback-enhanced@2.3.0
# 或在 MCP 配置中指定版本
{ {
"mcpServers": { "mcpServers": {
"mcp-feedback-enhanced": { "mcp-feedback-enhanced": {
"command": "uvx", "command": "uvx",
"args": ["mcp-feedback-enhanced@2.3.0"], "args": ["mcp-feedback-enhanced@latest"],
"timeout": 600, "timeout": 600,
"env": {
"MCP_DESKTOP_MODE": "true",
"MCP_WEB_PORT": "8765"
},
"autoApprove": ["interactive_feedback"] "autoApprove": ["interactive_feedback"]
} }
} }
} }
``` ```
**注意**：旧版本不包含 v2.4.0 的新功能（提示词管理、自动提交、会话管理等）。 **配置文件示例**：[examples/mcp-config-desktop.json](examples/mcp-config-desktop.json)
**Q: 如何使用旧版 PyQt6 GUI 界面？**
A: v2.4.0 版本已完全移除 PyQt6 GUI 依赖。如需使用旧版 GUI，请指定 v2.3.0 或更早版本：`uvx mcp-feedback-enhanced@2.3.0`
**注意**：旧版本不包含新功能（提示词管理、自动提交、会话管理、桌面应用程序等）。
**Q: 出现 "Unexpected token 'D'" 错误** **Q: 出现 "Unexpected token 'D'" 错误**
A: 调试输出干扰。设置 `MCP_DEBUG=false` 或移除该环境变量。 A: 调试输出干扰。设置 `MCP_DEBUG=false` 或移除该环境变量。

194
README.zh-TW.md
View File

@ -8,21 +8,21 @@
## 🎯 核心概念 ## 🎯 核心概念
這是一個 [MCP 伺服器](https://modelcontextprotocol.io/)，建立**回饋導向的開發工作流程**，採用**純 Web UI 架構**，完美適配本地、**SSH 遠端開發環境**與 **WSL (Windows Subsystem for Linux) 環境**。透過引導 AI 與用戶確認而非進行推測性操作，可將多次工具調用合併為單次回饋導向請求，大幅節省平台成本並提升開發效率。 這是一個 [MCP 伺服器](https://modelcontextprotocol.io/)，建立**回饋導向的開發工作流程**，提供**Web UI 和桌面應用程式**雙重選擇，完美適配本地、**SSH 遠端開發環境**與 **WSL (Windows Subsystem for Linux) 環境**。透過引導 AI 與用戶確認而非進行推測性操作，可將多次工具調用合併為單次回饋導向請求，大幅節省平台成本並提升開發效率。
**🌐 Web-Only 架構優勢：** **🌐 雙重介面架構優勢：**
- 🚀 **簡化部署**：無需 GUI 依賴，安裝更輕量 - 🖥️ **桌面應用程式**：原生跨平台桌面體驗，支援 Windows、macOS、Linux
- 🌍 **跨平台相容**：支援所有作業系統和環境 - 🌐 **Web UI 介面**：無需 GUI 依賴，適合遠端和 WSL 環境
- 🔧 **維護簡單**：統一的 Web 介面，降低複雜度 - 🔧 **靈活部署**：根據環境需求選擇最適合的介面模式
- 📦 **體積精簡**：移除重型 GUI 庫，安裝包大幅縮小 - 📦 **統一功能**：兩種介面提供完全相同的功能體驗
**🔮 未來計劃：** 我們計劃在功能穩定後重新引入桌面版應用程式，目前專注於 Web UI 功能的完善和優化。 **🖥️ 桌面應用程式：** v2.5.0 新增跨平台桌面應用程式支援，基於 Tauri 框架，支援 Windows、macOS、Linux 三大平台，提供原生桌面體驗。
**支援平台：** [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. **Web UI 啟動** → 自動開啟瀏覽器介面（純 Web 架構） 2. **介面啟動** → 自動開啟桌面應用程式或瀏覽器介面（根據配置）
3. **智能互動** → 提示詞選擇、文字輸入、圖片上傳、自動提交 3. **智能互動** → 提示詞選擇、文字輸入、圖片上傳、自動提交
4. **即時回饋** → WebSocket 連線即時傳遞資訊給 AI 4. **即時回饋** → WebSocket 連線即時傳遞資訊給 AI
5. **會話追蹤** → 自動記錄會話歷史與統計 5. **會話追蹤** → 自動記錄會話歷史與統計
@ -30,81 +30,33 @@
## 🌟 主要功能 ## 🌟 主要功能
### 🌐 純 Web UI 架構系統 ### 🖥️ 雙重介面支援
- **Web-Only 設計**：完全移除桌面 GUI 依賴，採用純 Web 介面 - **桌面應用程式**：基於 Tauri 的跨平台原生應用，支援 Windows、macOS、Linux
- **通用相容性**：支援本地、SSH Remote 和 WSL 環境 - **Web UI 介面**：輕量級瀏覽器介面，適合遠端和 WSL 環境
- **自動適配**：智能環境檢測與最佳配置 - **環境自動檢測**：智能識別 SSH Remote、WSL 等特殊環境
- **輕量部署**：無需複雜的 GUI 環境配置 - **統一功能體驗**：兩種介面提供完全相同的功能
### 📝 智能提示詞管理系統（v2.4.0 新功能） ### 📝 智能工作流程
- **CRUD 操作**：新增、編輯、刪除、使用常用提示詞 - **提示詞管理**：常用提示詞的 CRUD 操作、使用統計、智能排序
- **使用統計**：追蹤使用頻率並智能排序 - **自動定時提交**：1-86400 秒彈性計時器，支援暫停、恢復、取消
- **快速應用**：一鍵選擇和應用提示詞 - **會話管理追蹤**：本地檔案存儲、隱私控制、歷史匯出、即時統計
- **自動提交整合**：支援自動提交標記和優先顯示 - **連線監控**：WebSocket 狀態監控、自動重連、品質指示
- **AI 工作摘要 Markdown 顯示**：支援豐富的 Markdown 語法渲染，包含標題、粗體、程式碼區塊、列表、連結等格式，提升內容可讀性
### ⏰ 自動定時提交功能（v2.4.0 新功能） ### 🎨 現代化體驗
- **彈性計時**：可設定 1-86400 秒的倒數計時器 - **響應式設計**：適配不同螢幕尺寸，模組化 JavaScript 架構
- **視覺化顯示**：即時倒數顯示和狀態指示 - **音效通知**：內建多種音效、支援自訂音效上傳、音量控制
- **深度整合**：與提示詞管理系統無縫配合 - **智能記憶**：輸入框高度記憶、一鍵複製、設定持久化
- **完整控制**：支援暫停、恢復、取消操作 - **多語言支援**：繁體中文、英文、簡體中文，即時切換
### 📊 會話管理與追蹤（v2.4.3 重構增強） ### 🖼️ 圖片與媒體
- **獨立頁籤設計**：從左側邊欄遷移到專屬頁籤，解決瀏覽器相容性問題 - **全格式支援**：PNG、JPG、JPEG、GIF、BMP、WebP
- **本地歷史保存**：支援會話記錄本地保存，可設定保存期限 - **便捷上傳**：拖拽檔案、剪貼板粘貼（Ctrl+V）
- **隱私控制**：用戶訊息記錄支援三種隱私等級設定 - **無限制處理**：支援任意大小圖片，自動智能處理
- **數據管理**：支援會話歷史匯出和清理功能
- **即時統計**：今日會話數量和平均時長統計
### 🔗 連線監控系統（v2.4.0 新功能）
- **即時監控**：WebSocket 連線狀態即時監控
- **品質指示**：延遲測量和連線品質指示
- **自動重連**：智能重連機制和錯誤處理
- **詳細統計**：完整的連線統計資訊
### 🔊 音效通知系統（v2.4.3 新功能）
- **智能提醒**：會話更新時自動播放音效通知
- **多種音效**：內建經典提示音、通知鈴聲、輕柔鐘聲
- **自訂音效**：支援上傳 MP3、WAV、OGG 格式的自訂音效
- **完整控制**：音量調節、測試播放、音效管理功能
### 🎨 現代化界面設計
- **模組化架構**：JavaScript 完全模組化重構
- **響應式設計**：適配不同螢幕尺寸和視窗大小
- **統一風格**：一致的設計語言和視覺體驗
- **智能佈局**：AI 摘要區域自動擴展，提交按鈕位置優化
### 🖼️ 圖片支援
- **格式支援**：PNG、JPG、JPEG、GIF、BMP、WebP
- **上傳方式**：拖拽檔案 + 剪貼板粘貼（Ctrl+V）
- **無限制上傳**：支援任意大小的圖片檔案，自動智能處理
### 💾 智能記憶功能（v2.4.3 新功能）
- **輸入框高度記憶**：自動保存和恢復文字輸入框的高度設定
- **一鍵複製**：專案路徑和會話ID支援點擊複製到剪貼板
- **設定持久化**：所有用戶偏好設定自動保存
### 🌏 多語言
- **三語支援**：繁體中文、英文、簡體中文
- **智能偵測**：根據系統語言自動選擇
- **即時切換**：介面內可直接切換語言
- **完整國際化**：包含 tooltip 和按鈕提示的多語言支援
### ✨ WSL 環境支援（v2.2.5）
- **自動檢測**：智能識別 WSL (Windows Subsystem for Linux) 環境
- **瀏覽器整合**：WSL 環境下自動啟動 Windows 瀏覽器
- **多種啟動方式**：支援 `cmd.exe`、`powershell.exe`、`wslview` 等多種瀏覽器啟動方法
- **無縫體驗**：WSL 用戶可直接使用 Web UI，無需額外配置
### 🌐 SSH Remote 環境支援（v2.3.0 新功能）
- **智能檢測**：自動識別 SSH Remote 環境（Cursor SSH Remote、VS Code Remote SSH 等）
- **瀏覽器啟動指引**：當無法自動啟動瀏覽器時，提供清晰的解決方案
- **端口轉發支援**：完整的端口轉發設定指引和故障排除
- **MCP 整合優化**：改善與 MCP 系統的整合，提供更穩定的連接體驗
- **詳細文檔**：[SSH Remote 環境使用指南](docs/zh-TW/ssh-remote/browser-launch-issues.md)
## 🌐 介面預覽 ## 🌐 介面預覽
### Web UI 介面（v2.4.0 - Web-Only 架構） ### Web UI 介面（v2.5.0 - 支援桌面應用程式）
<div align="center"> <div align="center">
<img src="docs/zh-TW/images/web1.jpeg" width="400" alt="Web UI 主介面 - 提示詞管理與自動提交" /> <img src="docs/zh-TW/images/web1.jpeg" width="400" alt="Web UI 主介面 - 提示詞管理與自動提交" />
@ -119,7 +71,15 @@
</details> </details>
*Web UI 介面 - 純 Web 架構，支援提示詞管理、自動提交、會話追蹤等智能功能* *Web UI 介面 - 支援桌面應用程式和 Web 介面，提供提示詞管理、自動提交、會話追蹤等智能功能*
### 桌面應用程式介面（v2.5.0 新功能）
<div align="center">
<img src="docs/zh-TW/images/desktop1.png" width="600" alt="桌面應用程式 - 原生跨平台桌面體驗" />
</div>
*桌面應用程式 - 基於 Tauri 框架的原生跨平台桌面應用，支援 Windows、macOS、Linux，提供與 Web UI 完全相同的功能*
**快捷鍵支援** **快捷鍵支援**
- `Ctrl+Enter`（Windows/Linux）/ `Cmd+Enter`（macOS）：提交回饋（主鍵盤與數字鍵盤皆支援） - `Ctrl+Enter`（Windows/Linux）/ `Cmd+Enter`（macOS）：提交回饋（主鍵盤與數字鍵盤皆支援）
@ -170,6 +130,29 @@ uvx mcp-feedback-enhanced@latest test
} }
``` ```
**桌面應用程式配置**（v2.5.0 新功能 - 使用原生桌面應用程式）：
```json
{
"mcpServers": {
"mcp-feedback-enhanced": {
"command": "uvx",
"args": ["mcp-feedback-enhanced@latest"],
"timeout": 600,
"env": {
"MCP_DESKTOP_MODE": "true",
"MCP_WEB_PORT": "8765",
"MCP_DEBUG": "false"
},
"autoApprove": ["interactive_feedback"]
}
}
}
```
**配置檔案範例**：
- 桌面模式：[examples/mcp-config-desktop.json](examples/mcp-config-desktop.json)
- Web 模式：[examples/mcp-config-web.json](examples/mcp-config-web.json)
### 3. 設定提示工程 ### 3. 設定提示工程
為了獲得最佳效果，請在 AI 助手中添加以下規則： 為了獲得最佳效果，請在 AI 助手中添加以下規則：
@ -190,6 +173,7 @@ uvx mcp-feedback-enhanced@latest test
|------|------|-----|------| |------|------|-----|------|
| `MCP_DEBUG` | 調試模式 | `true`/`false` | `false` | | `MCP_DEBUG` | 調試模式 | `true`/`false` | `false` |
| `MCP_WEB_PORT` | Web UI 端口 | `1024-65535` | `8765` | | `MCP_WEB_PORT` | Web UI 端口 | `1024-65535` | `8765` |
| `MCP_DESKTOP_MODE` | 桌面應用程式模式 | `true`/`false` | `false` |
### 測試選項 ### 測試選項
```bash ```bash
@ -198,6 +182,7 @@ 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 --desktop # 測試桌面應用程式 (v2.5.0 新功能)
# 調試模式 # 調試模式
MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test
@ -213,8 +198,20 @@ uv sync
**本地測試方式** **本地測試方式**
```bash ```bash
# 功能測試 # 功能測試
make test-func # 標準功能測試
make test-web # Web UI 測試 (持續運行)
make test-desktop-func # 桌面應用功能測試
# 或直接使用指令
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 測試 (持續運行) uvx --no-cache --with-editable . mcp-feedback-enhanced test --web # Web UI 測試 (持續運行)
uvx --no-cache --with-editable . mcp-feedback-enhanced test --desktop # 桌面應用測試
# 桌面應用構建 (v2.5.0 新功能)
make build-desktop # 構建桌面應用 (debug 模式)
make build-desktop-release # 構建桌面應用 (release 模式)
make test-desktop # 測試桌面應用
make clean-desktop # 清理桌面構建產物
# 單元測試 # 單元測試
make test # 運行所有單元測試 make test # 運行所有單元測試
@ -237,14 +234,15 @@ make quick-check # 快速檢查並自動
📋 **完整版本更新記錄：** [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.4.3） ### 最新版本亮點（v2.5.0）
- 📋 **會話管理重構**: 從左側邊欄遷移到獨立頁籤，解決瀏覽器相容性問題 - 🖥️ **桌面應用程式**: 全新跨平台桌面應用，支援 Windows、macOS、Linux
- 🔊 **音效通知系統**: 會話更新音效提醒，支援內建和自訂音效 - 📋 **AI 工作摘要 Markdown 顯示**: 支援 Markdown 語法渲染，包含標題、粗體、程式碼區塊、列表、連結等格式
- 📚 **會話歷史增強**: 本地保存、隱私控制、匯出清理功能 - ⚡ **效能大幅提升**: 引入防抖/節流機制，減少不必要的渲染和網路請求
- 💾 **智能記憶功能**: 輸入框高度記憶、一鍵複製等便利功能 - 📊 **會話歷史存儲改進**: 從 localStorage 改為伺服器端本地檔案存儲
- 🎨 **介面佈局優化**: AI 摘要自動擴展、按鈕位置調整、簡化設計 - 🌐 **網路連接穩定性**: 改進 WebSocket 重連機制，支援網路狀態檢測
- 🌐 **多語言完善**: tooltip 和按鈕提示的完整國際化支援 - 🎨 **UI 渲染優化**: 優化會話管理、統計資訊、狀態指示器的渲染效能
- 🐛 **問題修復**: 修復會話詳情按鈕、彈窗關閉延遲等用戶體驗問題 - 🛠️ **構建流程優化**: 新增 Makefile 桌面應用構建命令和開發工具
- 📚 **文檔完善**: 新增桌面應用構建指南和工作流程說明
## 🐛 常見問題 ## 🐛 常見問題
@ -262,25 +260,29 @@ A: 請確認 MCP 工具狀態為綠燈。**解決方法**：反覆開關 MCP 工
A: **解決方法**：完全關閉並重新啟動 VS Code 或 Cursor，重新開啟專案。 A: **解決方法**：完全關閉並重新啟動 VS Code 或 Cursor，重新開啟專案。
### 🔧 一般問題 ### 🔧 一般問題
**Q: 如何使用舊版 GUI 介面？** **Q: 如何使用桌面應用程式？**
A: v2.4.0 版本已完全移除 PyQt6 GUI 依賴，轉為純 Web UI 架構。如需使用舊版 GUI，請指定 v2.3.0 或更早版本： A: v2.5.0 新增跨平台桌面應用程式支援。在 MCP 配置中設定 `"MCP_DESKTOP_MODE": "true"` 即可啟用：
```bash ```json
# 使用 v2.3.0（最後支援 GUI 的版本）
uvx mcp-feedback-enhanced@2.3.0
# 或在 MCP 配置中指定版本
{ {
"mcpServers": { "mcpServers": {
"mcp-feedback-enhanced": { "mcp-feedback-enhanced": {
"command": "uvx", "command": "uvx",
"args": ["mcp-feedback-enhanced@2.3.0"], "args": ["mcp-feedback-enhanced@latest"],
"timeout": 600, "timeout": 600,
"env": {
"MCP_DESKTOP_MODE": "true",
"MCP_WEB_PORT": "8765"
},
"autoApprove": ["interactive_feedback"] "autoApprove": ["interactive_feedback"]
} }
} }
} }
``` ```
**注意**：舊版本不包含 v2.4.0 的新功能（提示詞管理、自動提交、會話管理等）。 **配置檔案範例**：[examples/mcp-config-desktop.json](examples/mcp-config-desktop.json)
**Q: 如何使用舊版 PyQt6 GUI 介面？**
A: v2.4.0 版本已完全移除 PyQt6 GUI 依賴。如需使用舊版 GUI，請指定 v2.3.0 或更早版本：`uvx mcp-feedback-enhanced@2.3.0`
**注意**：舊版本不包含新功能（提示詞管理、自動提交、會話管理、桌面應用程式等）。
**Q: 出現 "Unexpected token 'D'" 錯誤** **Q: 出現 "Unexpected token 'D'" 錯誤**
A: 調試輸出干擾。設置 `MCP_DEBUG=false` 或移除該環境變數。 A: 調試輸出干擾。設置 `MCP_DEBUG=false` 或移除該環境變數。

39
RELEASE_NOTES/CHANGELOG.en.md
View File

@ -2,6 +2,45 @@
This document records all version updates for **MCP Feedback Enhanced**. This document records all version updates for **MCP Feedback Enhanced**.
## [v2.5.0] - 2025-06-15 - Desktop Application & Performance Optimization
### 🌟 Version Highlights
Introducing cross-platform desktop application supporting Windows, macOS, and Linux. Significant performance improvements with debounce/throttle mechanisms and enhanced system stability.
### ✨ New Features
- 🖥️ **Desktop Application**: Native cross-platform desktop app based on Tauri framework, supporting Windows x64, macOS (Intel/Apple Silicon), Linux x64
- 📊 **Server-side Session History Storage**: Session records migrated from localStorage to server-side local file storage for improved data consistency and reliability
- 🔧 **Multi-platform Build Support**: Complete CI/CD pipeline supporting automated multi-platform desktop application builds
- 📝 **Desktop Mode Configuration**: Added `MCP_DESKTOP_MODE` environment variable for desktop/web mode switching
- 📋 **AI Work Summary Markdown Display**: Support for Markdown syntax rendering including headers, bold text, code blocks, lists, links and other formats
### 🚀 Improvements
- ⚡ **Significant Performance Enhancement**: Introduced debounce/throttle mechanisms to reduce unnecessary rendering and network requests
- 🌐 **Network Connection Stability**: Improved WebSocket reconnection mechanism with network status detection and intelligent reconnection
- 🎨 **UI Rendering Optimization**: Optimized rendering performance for session management, statistics, and status indicators
- 📱 **Responsive Improvements**: Adjusted heartbeat frequency and timeout thresholds to reduce system load
- 🔄 **Enhanced Modularity**: Optimized JavaScript module structure with better logging management
### 🐛 Bug Fixes
- 🌐 **Network Reconnection Improvements**: Optimized reconnection algorithm with exponential backoff strategy and random jitter
- 🖥️ **Desktop Mode Adaptation**: Fixed browser auto-launch issues in desktop mode
- 📊 **Rendering Performance Fixes**: Resolved duplicate rendering and unnecessary state update issues
### 🛠️ Technical Improvements
- 🏗️ **Build Process Optimization**: Added Makefile desktop application build commands supporting debug/release modes
- 📦 **Dependency Management**: Integrated Rust toolchain supporting cross-platform compilation and packaging
- 🔍 **Enhanced Development Tools**: Added environment checks, build validation, and cleanup tools
- 📚 **Documentation Enhancement**: Added desktop application build guide and workflow documentation
- 🔒 **Security Enhancement**: Introduced DOMPurify for XSS protection ensuring content security
### 📋 Usage Instructions
- **Desktop Mode**: Set `"MCP_DESKTOP_MODE": "true"` in MCP configuration (refer to `examples/mcp-config-desktop.json`)
- **Web Mode**: Set `"MCP_DESKTOP_MODE": "false"` in MCP configuration (default, refer to `examples/mcp-config-web.json`)
- **Test Desktop Mode**: `uvx mcp-feedback-enhanced@latest test --desktop`
- **Build Desktop Application**: `make build-desktop-release`
---
## [v2.4.3] - 2025-06-14 - Session Management Refactoring & Audio Notifications ## [v2.4.3] - 2025-06-14 - Session Management Refactoring & Audio Notifications
### 🌟 Version Highlights ### 🌟 Version Highlights

344
RELEASE_NOTES/CHANGELOG.md Normal file
View File

@ -0,0 +1,344 @@
# Changelog (English)
This document records all version updates for **MCP Feedback Enhanced**.
## [v2.5.0] - 2025-06-15 - Desktop Application & Performance Optimization
### 🌟 Version Highlights
Introducing cross-platform desktop application supporting Windows, macOS, and Linux. Significant performance improvements with debounce/throttle mechanisms and enhanced system stability.
### ✨ New Features
- 🖥️ **Desktop Application**: Native cross-platform desktop app based on Tauri framework, supporting Windows x64, macOS (Intel/Apple Silicon), Linux x64
- 📊 **Server-side Session History Storage**: Session records migrated from localStorage to server-side local file storage for improved data consistency and reliability
- 🔧 **Multi-platform Build Support**: Complete CI/CD pipeline supporting automated multi-platform desktop application builds
- 📝 **Desktop Mode Configuration**: Added `MCP_DESKTOP_MODE` environment variable for desktop/web mode switching
- 📋 **AI Work Summary Markdown Display**: Support for Markdown syntax rendering including headers, bold text, code blocks, lists, links and other formats
### 🚀 Improvements
- ⚡ **Significant Performance Enhancement**: Introduced debounce/throttle mechanisms to reduce unnecessary rendering and network requests
- 🌐 **Network Connection Stability**: Improved WebSocket reconnection mechanism with network status detection and intelligent reconnection
- 🎨 **UI Rendering Optimization**: Optimized rendering performance for session management, statistics, and status indicators
- 📱 **Responsive Improvements**: Adjusted heartbeat frequency and timeout thresholds to reduce system load
- 🔄 **Enhanced Modularity**: Optimized JavaScript module structure with better logging management
### 🐛 Bug Fixes
- 🌐 **Network Reconnection Improvements**: Optimized reconnection algorithm with exponential backoff strategy and random jitter
- 🖥️ **Desktop Mode Adaptation**: Fixed browser auto-launch issues in desktop mode
- 📊 **Rendering Performance Fixes**: Resolved duplicate rendering and unnecessary state update issues
### 🛠️ Technical Improvements
- 🏗️ **Build Process Optimization**: Added Makefile desktop application build commands supporting debug/release modes
- 📦 **Dependency Management**: Integrated Rust toolchain supporting cross-platform compilation and packaging
- 🔍 **Enhanced Development Tools**: Added environment checks, build validation, and cleanup tools
- 📚 **Documentation Enhancement**: Added desktop application build guide and workflow documentation
- 🔒 **Security Enhancement**: Introduced DOMPurify for XSS protection ensuring content security
### 📋 Usage Instructions
- **Desktop Mode**: Set `"MCP_DESKTOP_MODE": "true"` in MCP configuration (refer to `examples/mcp-config-desktop.json`)
- **Web Mode**: Set `"MCP_DESKTOP_MODE": "false"` in MCP configuration (default, refer to `examples/mcp-config-web.json`)
- **Test Desktop Mode**: `uvx mcp-feedback-enhanced@latest test --desktop`
- **Build Desktop Application**: `make build-desktop-release`
---
## [v2.4.3] - 2025-06-14 - Session Management Refactoring & Audio Notifications
### 🌟 Version Highlights
Migrated session management from sidebar to dedicated tab, resolving browser compatibility issues. Added audio notification system with custom audio support.
### ✨ New Features
- 🔊 **Audio Notification System**: Play audio alerts for session updates, supports built-in and custom audio uploads
- 📚 **Session History Management**: Local session record storage with export and cleanup functionality
- 💾 **Input Height Memory**: Automatically save and restore textarea input height settings
- 📋 **One-Click Copy**: Project path and session ID support click-to-copy
### 🚀 Improvements
- 📋 **Session Management Refactoring**: Migrated from sidebar to "Session Management" tab, fixing button click issues in small windows
- 🎨 **Interface Layout Optimization**: AI summary auto-expansion, submit button repositioning, removed redundant descriptions
- 🌐 **Multilingual Enhancement**: Added tooltip and button multilingual support
### 🐛 Bug Fixes
- Fixed current session details button unresponsive issue
- Fixed session details modal close delay issue
- Fixed audio notification language initialization issue
- Corrected auto-submit processing logic
---
## [v2.4.2] - 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
### 🌟 Highlights
This version focuses on improving system stability and user experience, particularly solving the browser launch issue in Cursor SSH Remote environments.
### ✨ New Features
- 🌐 **SSH Remote Environment Support**: Solved Cursor SSH Remote browser launch issues with clear usage guidance
- 🛡️ **Error Message Improvements**: Provides more user-friendly error messages and solution suggestions when errors occur
- 🧹 **Auto-cleanup Features**: Automatically cleans temporary files and expired sessions to keep the system tidy
- 📊 **Memory Monitoring**: Monitors memory usage to prevent system resource shortage
### 🚀 Improvements
- 💾 **Resource Management Optimization**: Better system resource management for improved performance
- 🔧 **Enhanced Error Handling**: Provides clearer explanations and solutions when problems occur
- 🌐 **Connection Stability**: Improved Web UI connection stability
- 🖼️ **Image Upload Optimization**: Enhanced stability of image upload functionality
- 🎯 **Auto-focus Input Box**: Automatically focus on feedback input box when window opens, improving user experience (Thanks @penn201500)
### 🐛 Bug Fixes
- 🌐 **Connection Issues**: Fixed WebSocket connection related problems
- 🔄 **Session Management**: Fixed session state tracking issues
- 🖼️ **Image Processing**: Fixed event handling issues during image upload
---
## [v2.2.5] - WSL Environment Support & Cross-Platform Enhancement
### ✨ New Features
- 🐧 **WSL Environment Detection**: Automatically identifies WSL environments and provides specialized support logic
- 🌐 **Smart Browser Launching**: Automatically invokes Windows browser in WSL environments with multiple launch methods
- 🔧 **Cross-Platform Testing Enhancement**: Test functionality integrates WSL detection for improved test coverage
### 🚀 Improvements
- 🎯 **Environment Detection Optimization**: Improved remote environment detection logic, WSL no longer misidentified as remote environment
- 📊 **System Information Enhancement**: System information tool now displays WSL environment status
- 🧪 **Testing Experience Improvement**: Test mode automatically attempts browser launching for better testing experience
---
## [v2.2.4] - GUI Experience Optimization & Bug Fixes
### 🐛 Bug Fixes
- 🖼️ **Image Duplicate Paste Fix**: Fixed the issue where Ctrl+V image pasting in GUI would create duplicate images
- 🌐 **Localization Switch Fix**: Fixed image settings area text not translating correctly when switching languages
- 📝 **Font Readability Improvement**: Adjusted font sizes in image settings area for better readability
---
## [v2.2.3] - Timeout Control & Image Settings Enhancement
### ✨ New Features
- ⏰ **User Timeout Control**: Added customizable timeout settings with flexible range from 30 seconds to 2 hours
- ⏱️ **Countdown Timer**: Real-time countdown timer display at the top of the interface for visual time reminders
- 🖼️ **Image Size Limits**: Added image upload size limit settings (unlimited/1MB/3MB/5MB)
- 🔧 **Base64 Compatibility Mode**: Added Base64 detail mode to improve image recognition compatibility with AI models
- 🧹 **UV Cache Management Tool**: Added `cleanup_cache.py` script to help manage and clean UV cache space
### 🚀 Improvements
- 📚 **Documentation Structure Optimization**: Reorganized documentation directory structure, moved images to `docs/{language}/images/` paths
- 📖 **Cache Management Guide**: Added detailed UV Cache management guide with automated cleanup solutions
- 🎯 **Smart Compatibility Hints**: Automatically display Base64 compatibility mode suggestions when image upload fails
### 🐛 Bug Fixes
- 🛡️ **Timeout Handling Optimization**: Improved coordination between user-defined timeout and MCP system timeout
- 🖥️ **Interface Auto-close**: Fixed interface auto-close and resource cleanup logic after timeout
- 📱 **Responsive Layout**: Optimized timeout control component display on small screen devices
---
## [v2.2.2] - Timeout Auto-cleanup Fix
### 🐛 Bug Fixes
- 🔄 **Timeout Auto-cleanup**: Fixed GUI/Web UI not automatically closing after MCP session timeout (default 600 seconds)
- 🛡️ **Resource Management Optimization**: Improved timeout handling mechanism to ensure proper cleanup and closure of all UI resources on timeout
- ⚡ **Enhanced Timeout Detection**: Strengthened timeout detection logic to correctly handle timeout events in various scenarios
---
## [v2.2.1] - Window Optimization & Unified Settings Interface
### 🚀 Improvements
- 🖥️ **Window Size Constraint Removal**: Removed GUI main window minimum size limit from 1000×800 to 400×300
- 💾 **Real-time Window State Saving**: Implemented real-time saving mechanism for window size and position changes
- ⚙️ **Unified Settings Interface Optimization**: Improved GUI settings page configuration saving logic to avoid setting conflicts
### 🐛 Bug Fixes
- 🔧 **Window Size Constraint**: Fixed GUI window unable to resize to small dimensions issue
- 🛡️ **Setting Conflicts**: Fixed potential configuration conflicts during settings save operations
---
## [v2.2.0] - Layout & Settings UI Enhancements
### ✨ New Features
- 🎨 **Horizontal Layout Mode**: GUI & Web UI combined mode adds left-right layout option for summary and feedback
### 🚀 Improvements
- 🎨 **Improved Settings Interface**: Optimized the settings page for both GUI and Web UI
- ⌨️ **GUI Shortcut Enhancement**: Submit feedback shortcut now fully supports numeric keypad Enter key
### 🐛 Bug Fixes
- 🔧 **Image Duplication Fix**: Resolved Web UI image pasting duplication issue
---
## [v2.1.1] - Window Positioning Optimization
### ✨ New Features
- 🖥️ **Smart Window Positioning**: Added "Always show window at primary screen center" setting option
- 🌐 **Multi-Monitor Support**: Perfect solution for complex multi-monitor setups like T-shaped screen arrangements
- 💾 **Position Memory**: Auto-save and restore window position with intelligent visibility detection
---
## [v2.1.0] - Complete Refactored Version
### 🎨 Major Refactoring
- 🏗️ **Complete Refactoring**: GUI and Web UI adopt modular architecture
- 📁 **Centralized Management**: Reorganized folder structure, improved maintainability
- 🖥️ **Interface Optimization**: Modern design and improved user experience
### ✨ New Features
- 🍎 **macOS Interface Optimization**: Specialized improvements for macOS user experience
- ⚙️ **Feature Enhancement**: New settings options and auto-close page functionality
- ℹ️ **About Page**: Added about page with version info, project links, and acknowledgments
---
## [v2.0.14] - Shortcut & Image Feature Enhancement
### 🚀 Improvements
- ⌨️ **Enhanced Shortcuts**: Ctrl+Enter supports numeric keypad
- 🖼️ **Smart Image Pasting**: Ctrl+V directly pastes clipboard images
---
## [v2.0.9] - Multi-language Architecture Refactor
### 🔄 Refactoring
- 🌏 **Multi-language Architecture Refactor**: Support for dynamic loading
- 📁 **Modularized Language Files**: Modular organization of language files
---
## [v2.0.3] - Encoding Issues Fix
### 🐛 Critical Fixes
- 🛡️ **Complete Chinese Character Encoding Fix**: Resolved all Chinese display related issues
- 🔧 **JSON Parsing Error Fix**: Fixed data parsing errors
---
## [v2.0.0] - Web UI Support
### 🌟 Major Features
- ✅ **Added Web UI Support**: Support for remote environments
- ✅ **Auto Environment Detection**: Automatically choose appropriate interface
- ✅ **WebSocket Real-time Communication**: Real-time bidirectional communication
---
## Legend
| Icon | Meaning |
|------|---------|
| 🌟 | Version Highlights |
| ✨ | New Features |
| 🚀 | Improvements |
| 🐛 | Bug Fixes |
| 🔄 | Refactoring Changes |
| 🎨 | UI Optimization |
| ⚙️ | Settings Related |
| 🖥️ | Window Related |
| 🌐 | Multi-language/Network Related |
| 📁 | File Structure |
| ⌨️ | Shortcuts |
| 🖼️ | Image Features |
| 📝 | Prompt Management |
| ⏰ | Auto-Submit |
| 📊 | Session Management |
| 🔗 | Connection Monitoring |
| 🏗️ | Architecture Changes |
| 🛠️ | Technical Improvements |
| 📚 | Documentation Updates |
---
**Full Project Info:** [GitHub - mcp-feedback-enhanced](https://github.com/Minidoracat/mcp-feedback-enhanced)

40
RELEASE_NOTES/CHANGELOG.zh-CN.md
View File

@ -2,6 +2,46 @@
本文件记录了 **MCP Feedback Enhanced** 的所有版本更新内容。 本文件记录了 **MCP Feedback Enhanced** 的所有版本更新内容。
## [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 - 会话管理重构与音效通知 ## [v2.4.3] - 2025-06-14 - 会话管理重构与音效通知
### 🌟 版本亮点 ### 🌟 版本亮点

40
RELEASE_NOTES/CHANGELOG.zh-TW.md
View File

@ -2,6 +2,46 @@
本文件記錄了 **MCP Feedback Enhanced** 的所有版本更新內容。 本文件記錄了 **MCP Feedback Enhanced** 的所有版本更新內容。
## [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 - 會話管理重構與音效通知 ## [v2.4.3] - 2025-06-14 - 會話管理重構與音效通知
### 🌟 版本亮點 ### 🌟 版本亮點

BIN
docs/en/images/desktop1.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 99 KiB

BIN
docs/en/images/web1.jpeg
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 116 KiB

After

Width:  |  Height:  |  Size: 184 KiB

BIN
docs/zh-CN/images/desktop1.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 117 KiB

BIN
docs/zh-CN/images/web1.jpeg
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 105 KiB

After

Width:  |  Height:  |  Size: 173 KiB

BIN
docs/zh-TW/images/desktop1.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 118 KiB

BIN
docs/zh-TW/images/web1.jpeg
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 106 KiB

After

Width:  |  Height:  |  Size: 174 KiB

54
issues/combinedSummaryContent-markdown-support.md Normal file
View File

@ -0,0 +1,54 @@
# combinedSummaryContent Markdown 語法顯示功能實作
## 任務概述
為 mcp-feedback-enhanced 專案中的 combinedSummaryContent 區域實現 Markdown 語法顯示功能，將純文字顯示改為支援 Markdown 渲染。
## 技術方案
- **選用庫**：marked.js（輕量級、高性能）
- **引入方式**：CDN 直接引用
- **安全處理**：配合 DOMPurify 進行 HTML 清理
- **樣式策略**：保持原生 Markdown 樣式
## 實作計劃
### 階段 1：環境準備和依賴引入 ✅
- 修改 feedback.html 模板添加 marked.js CDN 引用
- 驗證庫載入
### 階段 2：核心功能實作
- 修改 ui-manager.js 中的 updateAISummaryContent 函數
- 實現 Markdown 解析和渲染
- 添加安全性處理
### 階段 3：樣式優化
- 調整 CSS 樣式確保 Markdown 內容正確顯示
- 優化行間距和視覺效果
### 階段 4：測試內容和功能驗證
- 建立包含多種 Markdown 語法的測試內容
- 驗證功能正確性
### 階段 5：相容性確保
- 確保向後相容性
- 添加錯誤處理機制
## 目標元素
```html
<div id="combinedSummaryContent" class="text-input"
style="min-height: 200px; white-space: pre-wrap !important; cursor: text; padding: 12px; line-height: 1.6; word-wrap: break-word; overflow-wrap: break-word;"
data-dynamic-content="aiSummary">
```
## 測試內容範例
將包含以下 Markdown 語法：
- 標題（# ## ###）
- 粗體和斜體（**bold** *italic*）
- 程式碼區塊（```code```）
- 列表（- 項目）
- 連結（[text](url)）
## 預期結果
- 保持現有 CSS 樣式和響應式設計
- 與現有 data-dynamic-content="aiSummary" 機制相容
- 使用原生 Markdown 樣式渲染
- 不影響現有功能