From 56f0938870d113b973bfb8f73974ff65a3fe627b Mon Sep 17 00:00:00 2001 From: Minidoracat Date: Sat, 21 Jun 2025 22:41:52 +0800 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20=E6=9B=B4=E6=96=B0=202.5.5=20?= =?UTF-8?q?=E7=9B=B8=E9=97=9C=E6=96=87=E6=AA=94?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 73 ++++++++++++++++++++++++-------- README.zh-CN.md | 71 ++++++++++++++++++++++++------- README.zh-TW.md | 69 +++++++++++++++++++++++------- RELEASE_NOTES/CHANGELOG.en.md | 39 +++++++++++++++++ RELEASE_NOTES/CHANGELOG.zh-CN.md | 39 +++++++++++++++++ RELEASE_NOTES/CHANGELOG.zh-TW.md | 39 +++++++++++++++++ 6 files changed, 282 insertions(+), 48 deletions(-) diff --git a/README.md b/README.md index 048c8a4..672c01f 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ ## 🎯 Core Concept -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. +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**, 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. **🌐 Dual Interface Architecture Advantages:** - 🖥️ **Desktop Application**: Native cross-platform desktop experience, supporting Windows, macOS, Linux @@ -92,9 +92,6 @@ This is an [MCP server](https://modelcontextprotocol.io/) that establishes **fee ```bash # Install uv (if not already installed) pip install uv - -# Quick test -uvx mcp-feedback-enhanced@latest test ``` ### 2. Configure MCP @@ -170,10 +167,14 @@ follow mcp-feedback-enhanced instructions | Variable | Purpose | Values | Default | |----------|---------|--------|---------| | `MCP_DEBUG` | Debug mode | `true`/`false` | `false` | -| `MCP_WEB_HOST` | Web UI host | IP address or hostname | `127.0.0.1` | +| `MCP_WEB_HOST` | Web UI host binding | IP address or hostname | `127.0.0.1` | | `MCP_WEB_PORT` | Web UI port | `1024-65535` | `8765` | | `MCP_DESKTOP_MODE` | Desktop application mode | `true`/`false` | `false` | +**`MCP_WEB_HOST` Explanation**: +- `127.0.0.1` (default): Local access only, higher security +- `0.0.0.0`: Allow remote access, suitable for SSH remote development environments + ### Testing Options ```bash # Version check @@ -230,23 +231,52 @@ make quick-check # Quick check and auto-f ## 🆕 Version History -📋 **Complete Version History:** [RELEASE_NOTES/CHANGELOG.md](RELEASE_NOTES/CHANGELOG.md) +📋 **Complete Version History:** [RELEASE_NOTES/CHANGELOG.en.md](RELEASE_NOTES/CHANGELOG.en.md) -### Latest Version Highlights (v2.5.0) -- 🖥️ **Desktop Application**: Brand new cross-platform desktop application supporting Windows, macOS, Linux -- 📋 **AI Work Summary Markdown Display**: Support for Markdown syntax rendering including headers, bold text, code blocks, lists, links and other formats -- ⚡ **Significant Performance Enhancement**: Introduced debounce/throttle mechanisms to reduce unnecessary rendering and network requests -- 📊 **Session History Storage Improvement**: Migrated from localStorage to server-side local file storage -- 🌐 **Network Connection Stability**: Improved WebSocket reconnection mechanism with network status detection -- 🎨 **UI Rendering Optimization**: Optimized rendering performance for session management, statistics, and status indicators -- 🛠️ **Build Process Optimization**: Added Makefile desktop application build commands and development tools -- 📚 **Documentation Enhancement**: Added desktop application build guide and workflow documentation +### Latest Version Highlights (v2.5.5) +- 🌐 **SSH Remote Development Support**: Added `MCP_WEB_HOST` environment variable, completely solving SSH remote development access issues +- 🍎 **Enhanced macOS Compilation Support**: Added PyO3 compilation configuration, supporting Intel and Apple Silicon architectures +- 📝 **Tool Documentation Optimization**: Moved LLM instructions to tool docstring, improving token efficiency +- 🖥️ **Desktop Application MCP Protocol Fix**: Fixed MCP protocol communication pollution issues in desktop mode +- 📦 **Packaging Process Fix**: Fixed multi-platform desktop application packaging and publishing issues +- 🔧 **Release Process Optimization**: Improved stability of automated release workflows +- 📊 **AI Work Summary Markdown Enhancement**: Improved Markdown rendering effects and compatibility +- 🔄 **Session History Process Optimization**: Improved session saving and management mechanisms ## 🐛 Common Issues ### 🌐 SSH Remote Environment Issues -**Q: Browser cannot launch in SSH Remote environment** -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: Browser cannot launch or access in SSH Remote environment** +A: Two solutions available: + +**Solution 1: Environment Variable Setting (v2.5.5 Recommended)** +Set `"MCP_WEB_HOST": "0.0.0.0"` in MCP configuration to allow remote access: +```json +{ + "mcpServers": { + "mcp-feedback-enhanced": { + "command": "uvx", + "args": ["mcp-feedback-enhanced@latest"], + "timeout": 600, + "env": { + "MCP_WEB_HOST": "0.0.0.0", + "MCP_WEB_PORT": "8765" + }, + "autoApprove": ["interactive_feedback"] + } + } +} +``` +Then open in local browser: `http://[remote-host-IP]:8765` + +**Solution 2: SSH Port Forwarding (Traditional Method)** +1. Use default configuration (`MCP_WEB_HOST`: `127.0.0.1`) +2. Set up SSH port forwarding: + - **VS Code Remote SSH**: Press `Ctrl+Shift+P` → "Forward a Port" → Enter `8765` + - **Cursor SSH Remote**: Manually add port forwarding rule (port 8765) +3. Open in local browser: `http://localhost:8765` + +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?** A: Likely a WebSocket connection issue. **Solution**: Directly refresh the browser page. @@ -340,6 +370,15 @@ If you find it useful, please: **penn201500** - [GitHub @penn201500](https://github.com/penn201500) - 🎯 Auto-focus input box feature ([PR #39](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/39)) +**leo108** - [GitHub @leo108](https://github.com/leo108) +- 🌐 SSH Remote Development Support (`MCP_WEB_HOST` environment variable) ([PR #113](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/113)) + +**Alsan** - [GitHub @Alsan](https://github.com/Alsan) +- 🍎 macOS PyO3 Compilation Configuration Support ([PR #93](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/93)) + +**fireinice** - [GitHub @fireinice](https://github.com/fireinice) +- 📝 Tool Documentation Optimization (LLM instructions moved to docstring) ([PR #105](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/105)) + ### Community Support - **Discord:** [https://discord.gg/Gur2V67](https://discord.gg/Gur2V67) - **Issues:** [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues) diff --git a/README.zh-CN.md b/README.zh-CN.md index 229b98d..2a076df 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -8,7 +8,7 @@ ## 🎯 核心概念 -这是一个 [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 远程开发环境**与 **WSL (Windows Subsystem for Linux) 环境**。通过引导 AI 与用户确认而非进行推测性操作，可将多次工具调用合并为单次反馈导向请求，大幅节省平台成本并提升开发效率。 **🌐 双重界面架构优势：** - 🖥️ **桌面应用程序**：原生跨平台桌面体验，支持 Windows、macOS、Linux @@ -92,9 +92,6 @@ ```bash # 安装 uv（如果尚未安装） pip install uv - -# 快速测试 -uvx mcp-feedback-enhanced@latest test ``` ### 2. 配置 MCP @@ -170,10 +167,14 @@ uvx mcp-feedback-enhanced@latest test | 变量 | 用途 | 值 | 默认 | |------|------|-----|------| | `MCP_DEBUG` | 调试模式 | `true`/`false` | `false` | -| `MCP_WEB_HOST` | Web UI 主机 | IP 地址或主机名 | `127.0.0.1` | +| `MCP_WEB_HOST` | Web UI 主机绑定 | IP 地址或主机名 | `127.0.0.1` | | `MCP_WEB_PORT` | Web UI 端口 | `1024-65535` | `8765` | | `MCP_DESKTOP_MODE` | 桌面应用程序模式 | `true`/`false` | `false` | +**`MCP_WEB_HOST` 说明**： +- `127.0.0.1`（默认）：仅本地访问，安全性较高 +- `0.0.0.0`：允许远程访问，适用于 SSH 远程开发环境 + ### 测试选项 ```bash # 版本查询 @@ -232,21 +233,50 @@ make quick-check # 快速检查并自动 📋 **完整版本更新记录：** [RELEASE_NOTES/CHANGELOG.zh-CN.md](RELEASE_NOTES/CHANGELOG.zh-CN.md) -### 最新版本亮点（v2.5.0） -- 🖥️ **桌面应用程序**: 全新跨平台桌面应用，支持 Windows、macOS、Linux -- 📋 **AI 工作摘要 Markdown 显示**: 支持 Markdown 语法渲染，包含标题、粗体、代码区块、列表、链接等格式 -- ⚡ **性能大幅提升**: 引入防抖/节流机制，减少不必要的渲染和网络请求 -- 📊 **会话历史存储改进**: 从 localStorage 改为服务器端本地文件存储 -- 🌐 **网络连接稳定性**: 改进 WebSocket 重连机制，支持网络状态检测 -- 🎨 **UI 渲染优化**: 优化会话管理、统计信息、状态指示器的渲染性能 -- 🛠️ **构建流程优化**: 新增 Makefile 桌面应用构建命令和开发工具 -- 📚 **文档完善**: 新增桌面应用构建指南和工作流程说明 +### 最新版本亮点（v2.5.5） +- 🌐 **SSH 远程开发支持**: 新增 `MCP_WEB_HOST` 环境变量，彻底解决 SSH 远程开发访问问题 +- 🍎 **macOS 编译支持增强**: 新增 PyO3 编译配置，支持 Intel 和 Apple Silicon 架构 +- 📝 **工具文档优化**: 将 LLM 指令移至工具 docstring，提升 token 效率 +- 🖥️ **桌面应用 MCP 协议修复**: 修正桌面模式下 MCP 协议通信污染问题 +- 📦 **打包流程修复**: 修正多平台桌面应用打包和发布问题 +- 🔧 **发布流程优化**: 改进自动化发布工作流程的稳定性 +- 📊 **AI 工作摘要 Markdown 增强**: 改进 Markdown 渲染效果和兼容性 +- 🔄 **会话历史流程优化**: 改进会话保存和管理机制 ## 🐛 常见问题 ### 🌐 SSH Remote 环境问题 -**Q: SSH Remote 环境下浏览器无法启动** -A: 这是正常现象。SSH Remote 环境没有图形界面，需要手动在本地浏览器打开。详细解决方案请参考：[SSH Remote 环境使用指南](docs/zh-CN/ssh-remote/browser-launch-issues.md) +**Q: SSH Remote 环境下浏览器无法启动或无法访问** +A: 提供两种解决方案： + +**方案一：环境变量设置（v2.5.5 推荐）** +在 MCP 配置中设置 `"MCP_WEB_HOST": "0.0.0.0"` 允许远程访问： +```json +{ + "mcpServers": { + "mcp-feedback-enhanced": { + "command": "uvx", + "args": ["mcp-feedback-enhanced@latest"], + "timeout": 600, + "env": { + "MCP_WEB_HOST": "0.0.0.0", + "MCP_WEB_PORT": "8765" + }, + "autoApprove": ["interactive_feedback"] + } + } +} +``` +然后在本地浏览器打开：`http://[远程主机IP]:8765` + +**方案二：SSH 端口转发（传统方法）** +1. 使用默认配置（`MCP_WEB_HOST`: `127.0.0.1`） +2. 设置 SSH 端口转发： + - **VS Code Remote SSH**: 按 `Ctrl+Shift+P` → "Forward a Port" → 输入 `8765` + - **Cursor SSH Remote**: 手动添加端口转发规则（端口 8765） +3. 在本地浏览器打开：`http://localhost:8765` + +详细解决方案请参考：[SSH Remote 环境使用指南](docs/zh-CN/ssh-remote/browser-launch-issues.md) **Q: 为什么没有接收到 MCP 新的反馈？** A: 可能是 WebSocket 连接问题。**解决方法**：直接重新刷新浏览器页面。 @@ -340,6 +370,15 @@ A: 各种 AI 模型（包括 Gemini Pro 2.5、Claude 等）在图片解析上可 **penn201500** - [GitHub @penn201500](https://github.com/penn201500) - 🎯 自动聚焦输入框功能 ([PR #39](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/39)) +**leo108** - [GitHub @leo108](https://github.com/leo108) +- 🌐 SSH 远程开发支持 (`MCP_WEB_HOST` 环境变量) ([PR #113](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/113)) + +**Alsan** - [GitHub @Alsan](https://github.com/Alsan) +- 🍎 macOS PyO3 编译配置支持 ([PR #93](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/93)) + +**fireinice** - [GitHub @fireinice](https://github.com/fireinice) +- 📝 工具文档优化 (LLM 指令移至 docstring) ([PR #105](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/105)) + ### 社群支援 - **Discord：** [https://discord.gg/Gur2V67](https://discord.gg/Gur2V67) - **Issues：** [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues) diff --git a/README.zh-TW.md b/README.zh-TW.md index ce8dfcb..c66390d 100644 --- a/README.zh-TW.md +++ b/README.zh-TW.md @@ -92,9 +92,6 @@ ```bash # 安裝 uv（如果尚未安裝） pip install uv - -# 快速測試 -uvx mcp-feedback-enhanced@latest test ``` ### 2. 配置 MCP @@ -170,10 +167,14 @@ uvx mcp-feedback-enhanced@latest test | 變數 | 用途 | 值 | 默認 | |------|------|-----|------| | `MCP_DEBUG` | 調試模式 | `true`/`false` | `false` | -| `MCP_WEB_HOST` | Web UI 主機 | IP 地址或主機名 | `127.0.0.1` | +| `MCP_WEB_HOST` | Web UI 主機綁定 | IP 地址或主機名 | `127.0.0.1` | | `MCP_WEB_PORT` | Web UI 端口 | `1024-65535` | `8765` | | `MCP_DESKTOP_MODE` | 桌面應用程式模式 | `true`/`false` | `false` | +**`MCP_WEB_HOST` 說明**： +- `127.0.0.1`（預設）：僅本地存取，安全性較高 +- `0.0.0.0`：允許遠端存取，適用於 SSH 遠端開發環境 + ### 測試選項 ```bash # 版本查詢 @@ -233,21 +234,50 @@ make quick-check # 快速檢查並自動 📋 **完整版本更新記錄：** [RELEASE_NOTES/CHANGELOG.zh-TW.md](RELEASE_NOTES/CHANGELOG.zh-TW.md) -### 最新版本亮點（v2.5.0） -- 🖥️ **桌面應用程式**: 全新跨平台桌面應用，支援 Windows、macOS、Linux -- 📋 **AI 工作摘要 Markdown 顯示**: 支援 Markdown 語法渲染，包含標題、粗體、程式碼區塊、列表、連結等格式 -- ⚡ **效能大幅提升**: 引入防抖/節流機制，減少不必要的渲染和網路請求 -- 📊 **會話歷史存儲改進**: 從 localStorage 改為伺服器端本地檔案存儲 -- 🌐 **網路連接穩定性**: 改進 WebSocket 重連機制，支援網路狀態檢測 -- 🎨 **UI 渲染優化**: 優化會話管理、統計資訊、狀態指示器的渲染效能 -- 🛠️ **構建流程優化**: 新增 Makefile 桌面應用構建命令和開發工具 -- 📚 **文檔完善**: 新增桌面應用構建指南和工作流程說明 +### 最新版本亮點（v2.5.5） +- 🌐 **SSH 遠端開發支援**: 新增 `MCP_WEB_HOST` 環境變數，徹底解決 SSH 遠端開發存取問題 +- 🍎 **macOS 編譯支援增強**: 新增 PyO3 編譯配置，支援 Intel 和 Apple Silicon 架構 +- 📝 **工具文檔優化**: 將 LLM 指令移至工具 docstring，提升 token 效率 +- �️ **桌面應用 MCP 協議修復**: 修正桌面模式下 MCP 協議通訊污染問題 +- 📦 **打包流程修復**: 修正多平台桌面應用打包和發布問題 +- 🔧 **發布流程優化**: 改進自動化發布工作流程的穩定性 +- � **AI 工作摘要 Markdown 增強**: 改進 Markdown 渲染效果和相容性 +- � **會話歷史流程優化**: 改進會話保存和管理機制 ## 🐛 常見問題 ### 🌐 SSH Remote 環境問題 -**Q: SSH Remote 環境下瀏覽器無法啟動** -A: 這是正常現象。SSH Remote 環境沒有圖形界面，需要手動在本地瀏覽器開啟。詳細解決方案請參考：[SSH Remote 環境使用指南](docs/zh-TW/ssh-remote/browser-launch-issues.md) +**Q: SSH Remote 環境下瀏覽器無法啟動或無法存取** +A: 提供兩種解決方案： + +**方案一：環境變數設定（v2.5.5 推薦）** +在 MCP 配置中設定 `"MCP_WEB_HOST": "0.0.0.0"` 允許遠端存取： +```json +{ + "mcpServers": { + "mcp-feedback-enhanced": { + "command": "uvx", + "args": ["mcp-feedback-enhanced@latest"], + "timeout": 600, + "env": { + "MCP_WEB_HOST": "0.0.0.0", + "MCP_WEB_PORT": "8765" + }, + "autoApprove": ["interactive_feedback"] + } + } +} +``` +然後在本地瀏覽器開啟：`http://[遠端主機IP]:8765` + +**方案二：SSH 端口轉發（傳統方法）** +1. 使用預設配置（`MCP_WEB_HOST`: `127.0.0.1`） +2. 設定 SSH 端口轉發： + - **VS Code Remote SSH**: 按 `Ctrl+Shift+P` → "Forward a Port" → 輸入 `8765` + - **Cursor SSH Remote**: 手動添加端口轉發規則（端口 8765） +3. 在本地瀏覽器開啟：`http://localhost:8765` + +詳細解決方案請參考：[SSH Remote 環境使用指南](docs/zh-TW/ssh-remote/browser-launch-issues.md) **Q: 為什麼沒有接收到 MCP 新的反饋？** A: 可能是 WebSocket 連接問題。**解決方法**：直接重新整理瀏覽器頁面。 @@ -341,6 +371,15 @@ A: 各種 AI 模型（包括 Gemini Pro 2.5、Claude 等）在圖片解析上可 **penn201500** - [GitHub @penn201500](https://github.com/penn201500) - 🎯 自動聚焦輸入框功能 ([PR #39](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/39)) +**leo108** - [GitHub @leo108](https://github.com/leo108) +- 🌐 SSH 遠端開發支援 (`MCP_WEB_HOST` 環境變數) ([PR #113](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/113)) + +**Alsan** - [GitHub @Alsan](https://github.com/Alsan) +- 🍎 macOS PyO3 編譯配置支援 ([PR #93](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/93)) + +**fireinice** - [GitHub @fireinice](https://github.com/fireinice) +- 📝 工具文檔優化 (LLM 指令移至 docstring) ([PR #105](https://github.com/Minidoracat/mcp-feedback-enhanced/pull/105)) + ### 社群支援 - **Discord：** [https://discord.gg/Gur2V67](https://discord.gg/Gur2V67) - **Issues：** [GitHub Issues](https://github.com/Minidoracat/mcp-feedback-enhanced/issues) diff --git a/RELEASE_NOTES/CHANGELOG.en.md b/RELEASE_NOTES/CHANGELOG.en.md index 4d88858..ffc8dde 100644 --- a/RELEASE_NOTES/CHANGELOG.en.md +++ b/RELEASE_NOTES/CHANGELOG.en.md @@ -2,6 +2,45 @@ This document records all version updates for **MCP Feedback Enhanced**. +## [v2.5.5] - 2025-06-21 - SSH Remote Development Support & Stability Enhancement + +### 🌟 Version Highlights +Added SSH remote development environment support, resolving Web UI access issues in remote development scenarios. Enhanced macOS compilation support and desktop application stability for improved developer experience. + +### ✨ New Features +- 🌐 **SSH Remote Development Support**: Added `MCP_WEB_HOST` environment variable for configuring web server host binding + - Defaults to `127.0.0.1` for security + - Can be set to `0.0.0.0` to allow remote access + - Resolves access issues in remote development environments like Cursor SSH Remote +- 🍎 **Enhanced macOS Compilation Support**: Added `.cargo/config.toml` configuration file + - Supports Intel (x86_64) and Apple Silicon (aarch64) architectures + - Resolves macOS PyO3 undefined dynamic_lookup compilation issues + - Follows PyO3 official recommended best practices + +### 🚀 Improvements +- 📝 **Tool Documentation Optimization**: Moved LLM instructions to tool docstring for improved token efficiency +- 🎨 **Simplified User Configuration**: Removed complex Cursor rules configuration +- 📊 **Enhanced AI Work Summary Markdown**: Improved Markdown rendering effects and compatibility +- 🔄 **Session History Process Optimization**: Enhanced session saving and management mechanisms + +### 🐛 Bug Fixes +- 🖥️ **Desktop Application MCP Protocol Fix**: Fixed MCP protocol communication pollution issues in desktop mode +- 📦 **Packaging Process Fix**: Fixed multi-platform desktop application packaging and publishing issues +- 🔧 **Release Process Optimization**: Improved stability of automated release workflows +- 🔥 **Removed ESC Shortcut**: Removed ESC shortcut functionality that could cause accidental closure + +### 🛠️ Technical Improvements +- 🏗️ **Enhanced Build System**: Improved cross-platform compilation configuration and dependency management +- 📚 **Documentation Automation**: Enhanced tool self-documentation following FastMCP best practices +- 🔍 **Enhanced Debugging Features**: Added more detailed debugging information and error handling + +### 📋 Usage Instructions +- **SSH Remote Development**: Set `"MCP_WEB_HOST": "0.0.0.0"` in MCP configuration to allow remote access +- **Local Development**: Keep default `"MCP_WEB_HOST": "127.0.0.1"` for security +- **macOS Development**: New compilation configuration will take effect automatically without additional setup + +--- + ## [v2.5.0] - 2025-06-15 - Desktop Application & Performance Optimization ### 🌟 Version Highlights diff --git a/RELEASE_NOTES/CHANGELOG.zh-CN.md b/RELEASE_NOTES/CHANGELOG.zh-CN.md index 3120a4d..30738fd 100644 --- a/RELEASE_NOTES/CHANGELOG.zh-CN.md +++ b/RELEASE_NOTES/CHANGELOG.zh-CN.md @@ -2,6 +2,45 @@ 本文件记录了 **MCP Feedback Enhanced** 的所有版本更新内容。 +## [v2.5.5] - 2025-06-21 - SSH 远程开发支持与稳定性增强 + +### 🌟 版本亮点 +新增 SSH 远程开发环境支持，解决远程开发时无法访问 Web UI 的问题。同时改进 macOS 编译支持和桌面应用稳定性，提升开发者体验。 + +### ✨ 新功能 +- 🌐 **SSH 远程开发支持**: 新增 `MCP_WEB_HOST` 环境变量，支持设置 Web 服务器主机绑定 + - 默认为 `127.0.0.1` 确保安全性 + - 可设置为 `0.0.0.0` 允许远程访问 + - 解决 Cursor SSH Remote 等远程开发环境的访问问题 +- 🍎 **macOS 编译支持增强**: 新增 `.cargo/config.toml` 配置文件 + - 支持 Intel (x86_64) 和 Apple Silicon (aarch64) 架构 + - 解决 macOS 上 PyO3 undefined dynamic_lookup 编译问题 + - 遵循 PyO3 官方推荐的最佳实践 + +### 🚀 改进功能 +- 📝 **工具文档优化**: 将 LLM 指令移至工具 docstring，提升 token 效率 +- 🎨 **用户配置简化**: 移除复杂的 Cursor 规则配置 +- 📊 **AI 工作摘要 Markdown 增强**: 改进 Markdown 渲染效果和兼容性 +- 🔄 **会话历史流程优化**: 改进会话保存和管理机制 + +### 🐛 问题修复 +- 🖥️ **桌面应用 MCP 协议修复**: 修正桌面模式下 MCP 协议通信污染问题 +- 📦 **打包流程修复**: 修正多平台桌面应用打包和发布问题 +- 🔧 **发布流程优化**: 改进自动化发布工作流程的稳定性 +- 🔥 **移除 ESC 快捷键**: 移除可能造成意外关闭的 ESC 快捷键功能 + +### 🛠️ 技术改进 +- 🏗️ **构建系统增强**: 改进跨平台编译配置和依赖管理 +- 📚 **文档自动化**: 改进工具自我文档化，遵循 FastMCP 最佳实践 +- 🔍 **调试功能增强**: 新增更详细的调试信息和错误处理 + +### 📋 使用说明 +- **SSH 远程开发**: 在 MCP 配置中设置 `"MCP_WEB_HOST": "0.0.0.0"` 允许远程访问 +- **本地开发**: 保持默认 `"MCP_WEB_HOST": "127.0.0.1"` 确保安全性 +- **macOS 开发**: 新的编译配置将自动生效，无需额外设置 + +--- + ## [v2.5.0] - 2025-06-15 - 桌面应用程序与性能优化 ### 🌟 版本亮点 diff --git a/RELEASE_NOTES/CHANGELOG.zh-TW.md b/RELEASE_NOTES/CHANGELOG.zh-TW.md index bdbb811..b80d4fd 100644 --- a/RELEASE_NOTES/CHANGELOG.zh-TW.md +++ b/RELEASE_NOTES/CHANGELOG.zh-TW.md @@ -2,6 +2,45 @@ 本文件記錄了 **MCP Feedback Enhanced** 的所有版本更新內容。 +## [v2.5.5] - 2025-06-21 - SSH 遠端開發支援與穩定性增強 + +### 🌟 版本亮點 +新增 SSH 遠端開發環境支援，解決遠端開發時無法存取 Web UI 的問題。同時改進 macOS 編譯支援和桌面應用穩定性，提升開發者體驗。 + +### ✨ 新功能 +- 🌐 **SSH 遠端開發支援**: 新增 `MCP_WEB_HOST` 環境變數，支援設定 Web 伺服器主機綁定 + - 預設為 `127.0.0.1` 確保安全性 + - 可設定為 `0.0.0.0` 允許遠端存取 + - 解決 Cursor SSH Remote 等遠端開發環境的存取問題 +- 🍎 **macOS 編譯支援增強**: 新增 `.cargo/config.toml` 配置檔案 + - 支援 Intel (x86_64) 和 Apple Silicon (aarch64) 架構 + - 解決 macOS 上 PyO3 undefined dynamic_lookup 編譯問題 + - 遵循 PyO3 官方推薦的最佳實踐 + +### 🚀 改進功能 +- 📝 **工具文檔優化**: 將 LLM 指令移至工具 docstring，提升 token 效率 +- 🎨 **使用者配置簡化**: 移除複雜的 Cursor 規則配置 +- 📊 **AI 工作摘要 Markdown 增強**: 改進 Markdown 渲染效果和相容性 +- 🔄 **會話歷史流程優化**: 改進會話保存和管理機制 + +### 🐛 問題修復 +- 🖥️ **桌面應用 MCP 協議修復**: 修正桌面模式下 MCP 協議通訊污染問題 +- 📦 **打包流程修復**: 修正多平台桌面應用打包和發布問題 +- 🔧 **發布流程優化**: 改進自動化發布工作流程的穩定性 +- 🔥 **移除 ESC 快捷鍵**: 移除可能造成意外關閉的 ESC 快捷鍵功能 + +### 🛠️ 技術改進 +- 🏗️ **構建系統增強**: 改進跨平台編譯配置和相依性管理 +- 📚 **文檔自動化**: 改進工具自我文檔化，遵循 FastMCP 最佳實踐 +- 🔍 **調試功能增強**: 新增更詳細的調試訊息和錯誤處理 + +### 📋 使用說明 +- **SSH 遠端開發**: 在 MCP 配置中設定 `"MCP_WEB_HOST": "0.0.0.0"` 允許遠端存取 +- **本地開發**: 保持預設 `"MCP_WEB_HOST": "127.0.0.1"` 確保安全性 +- **macOS 開發**: 新的編譯配置將自動生效，無需額外設定 + +--- + ## [v2.5.0] - 2025-06-15 - 桌面應用程式與效能優化 ### 🌟 版本亮點