From cc80fd87322321da62c978cea9ae32818a730b47 Mon Sep 17 00:00:00 2001
From: Bryan Lee <38807139+liby@users.noreply.github.com>
Date: Thu, 5 Jun 2025 10:33:28 +0800
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20Add=20macOS=20keyboard=20shortcu?=
 =?UTF-8?q?ts=20support=20in=20README=20files?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md       | 18 +++++++++---------
 README.zh-CN.md | 20 ++++++++++----------
 README.zh-TW.md | 18 +++++++++---------
 3 files changed, 28 insertions(+), 28 deletions(-)

diff --git a/README.md b/README.md
index 0903d17..2b7795e 100644
--- a/README.md
+++ b/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:
diff --git a/README.zh-CN.md b/README.zh-CN.md
index ffb426a..e079282 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -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)
 
 如果您觉得有用，请：
diff --git a/README.zh-TW.md b/README.zh-TW.md
index 796bc99..6515cab 100644
--- a/README.zh-TW.md
+++ b/README.zh-TW.md
@@ -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)
 
 如果您覺得有用，請：