mirror of
https://github.com/Minidoracat/mcp-feedback-enhanced.git
synced 2025-07-27 02:22:26 +08:00
📝 更新 2.5.5 相關文檔
This commit is contained in:
Minidoracat
parent
5f951ddaba
commit
56f0938870
73
README.md
73
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)
|
||||
|
||||
@ -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)
|
||||
|
||||
@ -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 效率
|
||||
- <EFBFBD>️ **桌面應用 MCP 協議修復**: 修正桌面模式下 MCP 協議通訊污染問題
|
||||
- 📦 **打包流程修復**: 修正多平台桌面應用打包和發布問題
|
||||
- 🔧 **發布流程優化**: 改進自動化發布工作流程的穩定性
|
||||
- <EFBFBD> **AI 工作摘要 Markdown 增強**: 改進 Markdown 渲染效果和相容性
|
||||
- <EFBFBD> **會話歷史流程優化**: 改進會話保存和管理機制
|
||||
|
||||
## 🐛 常見問題
|
||||
|
||||
### 🌐 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)
|
||||
|
||||
@ -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
|
||||
|
||||
@ -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 - 桌面应用程序与性能优化
|
||||
|
||||
### 🌟 版本亮点
|
||||
|
||||
@ -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 - 桌面應用程式與效能優化
|
||||
|
||||
### 🌟 版本亮點
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user