mirror of
https://github.com/Minidoracat/mcp-feedback-enhanced.git
synced 2025-07-27 10:42:25 +08:00
Merge pull request #23 from liby/docs/add-macos-keyboard-shortcuts
📝 Add macOS keyboard shortcuts support in README files
This commit is contained in:
Minidoracat
GitHub
commit
e1fef85f18
18
README.md
18
README.md
@ -2,8 +2,8 @@
|
||||
|
||||
**🌐 Language / 語言切換:** **English** | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md)
|
||||
|
||||
**Original Author:** [Fábio Ferreira](https://x.com/fabiomlferreira) | [Original Project](https://github.com/noopstudios/interactive-feedback-mcp) ⭐
|
||||
**Enhanced Fork:** [Minidoracat](https://github.com/Minidoracat)
|
||||
**Original Author:** [Fábio Ferreira](https://x.com/fabiomlferreira) | [Original Project](https://github.com/noopstudios/interactive-feedback-mcp) ⭐
|
||||
**Enhanced Fork:** [Minidoracat](https://github.com/Minidoracat)
|
||||
**UI Design Reference:** [sanshao85/mcp-feedback-collector](https://github.com/sanshao85/mcp-feedback-collector)
|
||||
|
||||
## 🎯 Core Concept
|
||||
@ -67,8 +67,8 @@ This is an [MCP server](https://modelcontextprotocol.io/) that establishes **fee
|
||||
*Web UI Interface - Brand new architecture, suitable for SSH Remote environments*
|
||||
|
||||
**Keyboard Shortcuts**
|
||||
- `Ctrl+Enter`: Submit feedback (supports both main keyboard and numpad)
|
||||
- `Ctrl+V`: Directly paste clipboard images
|
||||
- `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
|
||||
|
||||
## 🚀 Quick Start
|
||||
|
||||
@ -186,13 +186,13 @@ uvx --with-editable . mcp-feedback-enhanced test --web # Test Web UI (auto co
|
||||
|
||||
## 🐛 Common Issues
|
||||
|
||||
**Q: Getting "Unexpected token 'D'" error**
|
||||
**Q: Getting "Unexpected token 'D'" error**
|
||||
A: Debug output interference. Set `MCP_DEBUG=false` or remove the environment variable.
|
||||
|
||||
**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`
|
||||
|
||||
**Q: Image upload fails**
|
||||
**Q: Image upload fails**
|
||||
A: Check file size (≤1MB) and format (PNG/JPG/GIF/BMP/WebP).
|
||||
|
||||
**Q: Web UI won't start**
|
||||
@ -218,7 +218,7 @@ uv cache clean
|
||||
```
|
||||
For detailed instructions, see: [Cache Management Guide](docs/en/cache-management.md)
|
||||
|
||||
**Q: Gemini Pro 2.5 cannot parse images**
|
||||
**Q: Gemini Pro 2.5 cannot parse images**
|
||||
A: Known issue. Gemini Pro 2.5 may not correctly parse uploaded image content. Testing shows Claude-4-Sonnet can properly analyze images. Recommend using Claude models for better image understanding capabilities.
|
||||
|
||||
**Q: Multi-screen window positioning issues**
|
||||
@ -237,7 +237,7 @@ A: v2.2.5 has fixed this issue. WSL environments are now correctly identified an
|
||||
## 🙏 Acknowledgments
|
||||
|
||||
### 🌟 Support Original Author
|
||||
**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)
|
||||
|
||||
If you find this useful, please:
|
||||
|
||||
@ -2,8 +2,8 @@
|
||||
|
||||
**🌐 语言切换 / Language:** [English](README.md) | [繁體中文](README.zh-TW.md) | **简体中文**
|
||||
|
||||
**原作者：** [Fábio Ferreira](https://x.com/fabiomlferreira) | [原始项目](https://github.com/noopstudios/interactive-feedback-mcp) ⭐
|
||||
**分支版本：** [Minidoracat](https://github.com/Minidoracat)
|
||||
**原作者：** [Fábio Ferreira](https://x.com/fabiomlferreira) | [原始项目](https://github.com/noopstudios/interactive-feedback-mcp) ⭐
|
||||
**分支版本：** [Minidoracat](https://github.com/Minidoracat)
|
||||
**UI 设计参考：** [sanshao85/mcp-feedback-collector](https://github.com/sanshao85/mcp-feedback-collector)
|
||||
|
||||
## 🎯 核心概念
|
||||
@ -67,8 +67,8 @@
|
||||
*Web UI 界面 - 全新架构，适合 SSH Remote 环境*
|
||||
|
||||
**快捷键支持**
|
||||
- `Ctrl+Enter`：提交反馈（主键盘与数字键盘皆支持）
|
||||
- `Ctrl+V`：直接粘贴剪贴板图片
|
||||
- `Ctrl+Enter`（Windows/Linux）/ `Cmd+Enter`（macOS）：提交反馈（主键盘与数字键盘皆支持）
|
||||
- `Ctrl+V`（Windows/Linux）/ `Cmd+V`（macOS）：直接粘贴剪贴板图片
|
||||
|
||||
## 🚀 快速开始
|
||||
|
||||
@ -186,17 +186,17 @@ uvx --with-editable . mcp-feedback-enhanced test --web # 测试 Web UI (自
|
||||
|
||||
## 🐛 常见问题
|
||||
|
||||
**Q: 出现 "Unexpected token 'D'" 错误**
|
||||
**Q: 出现 "Unexpected token 'D'" 错误**
|
||||
A: 调试输出干扰。设置 `MCP_DEBUG=false` 或移除该环境变量。
|
||||
|
||||
**Q: 中文字符乱码**
|
||||
**Q: 中文字符乱码**
|
||||
A: 已在 v2.0.3 修复。更新到最新版本：`uvx mcp-feedback-enhanced@latest`
|
||||
|
||||
**Q: 图片上传失败**
|
||||
**Q: 图片上传失败**
|
||||
A: 检查文件大小（≤1MB）和格式（PNG/JPG/GIF/BMP/WebP）。
|
||||
|
||||
**Q: Web UI 无法启动**
|
||||
A: 设置 `FORCE_WEB=true` 或检查防火墙设定。
|
||||
A: 设置 `FORCE_WEB=true` 或检查火墙设定。
|
||||
|
||||
**Q: UV Cache 占用过多磁盘空间**
|
||||
A: 由于频繁使用 `uvx` 命令，cache 可能会累积到数十 GB。建议定期清理：
|
||||
@ -218,7 +218,7 @@ uv cache clean
|
||||
```
|
||||
详细说明请参考：[Cache 管理指南](docs/zh-CN/cache-management.md)
|
||||
|
||||
**Q: Gemini Pro 2.5 无法解析图片**
|
||||
**Q: Gemini Pro 2.5 无法解析图片**
|
||||
A: 已知问题，Gemini Pro 2.5 可能无法正确解析上传的图片内容。实测 Claude-4-Sonnet 可以正常解析图片。建议使用 Claude 模型获得更好的图片理解能力。
|
||||
|
||||
**Q: 多屏幕视窗定位问题**
|
||||
@ -237,7 +237,7 @@ A: v2.2.5 已修复此问题。WSL 环境现在会被正确识别并使用 Web U
|
||||
## 🙏 致谢
|
||||
|
||||
### 🌟 支持原作者
|
||||
**Fábio Ferreira** - [X @fabiomlferreira](https://x.com/fabiomlferreira)
|
||||
**Fábio Ferreira** - [X @fabiomlferreira](https://x.com/fabiomlferreira)
|
||||
**原始项目：** [noopstudios/interactive-feedback-mcp](https://github.com/noopstudios/interactive-feedback-mcp)
|
||||
|
||||
如果您觉得有用，请：
|
||||
|
||||
@ -2,8 +2,8 @@
|
||||
|
||||
**🌐 語言切換 / Language:** [English](README.md) | **繁體中文** | [简体中文](README.zh-CN.md)
|
||||
|
||||
**原作者：** [Fábio Ferreira](https://x.com/fabiomlferreira) | [原始專案](https://github.com/noopstudios/interactive-feedback-mcp) ⭐
|
||||
**分支版本：** [Minidoracat](https://github.com/Minidoracat)
|
||||
**原作者：** [Fábio Ferreira](https://x.com/fabiomlferreira) | [原始專案](https://github.com/noopstudios/interactive-feedback-mcp) ⭐
|
||||
**分支版本：** [Minidoracat](https://github.com/Minidoracat)
|
||||
**UI 設計參考：** [sanshao85/mcp-feedback-collector](https://github.com/sanshao85/mcp-feedback-collector)
|
||||
|
||||
## 🎯 核心概念
|
||||
@ -67,8 +67,8 @@
|
||||
*Web UI 介面 - 全新架構，適合 SSH Remote 環境*
|
||||
|
||||
**快捷鍵支援**
|
||||
- `Ctrl+Enter`：提交回饋（主鍵盤與數字鍵盤皆支援）
|
||||
- `Ctrl+V`：直接粘貼剪貼板圖片
|
||||
- `Ctrl+Enter`（Windows/Linux）/ `Cmd+Enter`（macOS）：提交回饋（主鍵盤與數字鍵盤皆支援）
|
||||
- `Ctrl+V`（Windows/Linux）/ `Cmd+V`（macOS）：直接粘貼剪貼板圖片
|
||||
|
||||
## 🚀 快速開始
|
||||
|
||||
@ -186,16 +186,16 @@ uvx --with-editable . mcp-feedback-enhanced test --web # 測試 Web UI (自
|
||||
|
||||
## 🐛 常見問題
|
||||
|
||||
**Q: 出現 "Unexpected token 'D'" 錯誤**
|
||||
**Q: 出現 "Unexpected token 'D'" 錯誤**
|
||||
A: 調試輸出干擾。設置 `MCP_DEBUG=false` 或移除該環境變數。
|
||||
|
||||
**Q: 中文字符亂碼**
|
||||
**Q: 中文字符亂碼**
|
||||
A: 已在 v2.0.3 修復。更新到最新版本：`uvx mcp-feedback-enhanced@latest`
|
||||
|
||||
**Q: 多螢幕環境下視窗消失或定位錯誤**
|
||||
**Q: 多螢幕環境下視窗消失或定位錯誤**
|
||||
A: 已在 v2.1.1 修復。進入「⚙️ 設定」分頁，勾選「總是在主螢幕中心顯示視窗」即可解決。特別適用於 T 字型螢幕排列等複雜多螢幕配置。
|
||||
|
||||
**Q: 圖片上傳失敗**
|
||||
**Q: 圖片上傳失敗**
|
||||
A: 檢查檔案大小（≤1MB）和格式（PNG/JPG/GIF/BMP/WebP）。
|
||||
|
||||
**Q: Web UI 無法啟動**
|
||||
@ -230,7 +230,7 @@ A: 各種 AI 模型（包括 Gemini Pro 2.5、Claude 等）在圖片解析上可
|
||||
## 🙏 致謝
|
||||
|
||||
### 🌟 支持原作者
|
||||
**Fábio Ferreira** - [X @fabiomlferreira](https://x.com/fabiomlferreira)
|
||||
**Fábio Ferreira** - [X @fabiomlferreira](https://x.com/fabiomlferreira)
|
||||
**原始專案：** [noopstudios/interactive-feedback-mcp](https://github.com/noopstudios/interactive-feedback-mcp)
|
||||
|
||||
如果您覺得有用，請：
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user