Merge pull request #138 from DF-wu/main

[Doc] Localized and Enhancement. (Issue #135)

README.md

@@ -12,7 +12,7 @@ This is an [MCP server](https://modelcontextprotocol.io/) that establishes **fee
 
 **🌐 Dual Interface Architecture Advantages:**
 - 🖥️ **Desktop Application**: Native cross-platform desktop experience, supporting Windows, macOS, Linux
-- 🌐 **Web UI Interface**: No GUI dependencies required, suitable for remote and WSL environments
+- 🌐 **Web UI**: No GUI dependencies required, suitable for remote and WSL environments
 - 🔧 **Flexible Deployment**: Choose the most suitable interface mode based on environment requirements
 - 📦 **Unified Functionality**: Both interfaces provide exactly the same functional experience
 
@@ -122,7 +122,8 @@ pip install uv
       "env": {
         "MCP_DEBUG": "false",
         "MCP_WEB_HOST": "127.0.0.1",
-        "MCP_WEB_PORT": "8765"
+        "MCP_WEB_PORT": "8765",
+        "MCP_LANGUAGE": "en"
       },
       "autoApprove": ["interactive_feedback"]
     }
@@ -172,11 +173,25 @@ follow mcp-feedback-enhanced instructions
 | `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_LANGUAGE` | Force UI language | `zh-TW`/`zh-CN`/`en` | Auto-detect |
 
 **`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
 
+**`MCP_LANGUAGE` Explanation**:
+- Used to force the interface language, overriding automatic system detection
+- Supported language codes:
+  - `zh-TW`: Traditional Chinese
+  - `zh-CN`: Simplified Chinese
+  - `en`: English
+- Language detection priority:
+  1. User-saved language settings in the interface (highest priority)
+  2. `MCP_LANGUAGE` environment variable
+  3. System environment variables (LANG, LC_ALL, etc.)
+  4. System default language
+  5. Fallback to default language (Traditional Chinese)
+
 ### Testing Options
 ```bash
 # Version check
@@ -188,6 +203,11 @@ uvx mcp-feedback-enhanced@latest test --desktop # Test desktop application (v2.5
 
 # Debug mode
 MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test
+
+# Specify language for testing
+MCP_LANGUAGE=en uvx mcp-feedback-enhanced@latest test --web    # Force English interface
+MCP_LANGUAGE=zh-TW uvx mcp-feedback-enhanced@latest test --web  # Force Traditional Chinese
+MCP_LANGUAGE=zh-CN uvx mcp-feedback-enhanced@latest test --web  # Force Simplified Chinese
 ```
 
 ### Developer Installation

README.zh-CN.md

@@ -48,7 +48,7 @@
 - **响应式设计**：适配不同屏幕尺寸，模块化 JavaScript 架构
 - **音效通知**：内建多种音效、支持自定义音效上传、音量控制
 - **系统通知**（v2.6.0）：重要事件（如自动提交、会话超时等）的系统级即时提醒
-- **智能记忆**：输入框高度记忆、一键复制、设定持久化
+- **智能记忆**：输入框高度记忆、一键复制、设置持久化
 - **多语言支持**：简体中文、英文、繁体中文，即时切换
 
 ### 🖼️ 图片与媒体
@@ -122,7 +122,8 @@ pip install uv
       "env": {
         "MCP_DEBUG": "false",
         "MCP_WEB_HOST": "127.0.0.1",
-        "MCP_WEB_PORT": "8765"
+        "MCP_WEB_PORT": "8765",
+        "MCP_LANGUAGE": "zh-CN"
       },
       "autoApprove": ["interactive_feedback"]
     }
@@ -154,16 +155,16 @@ pip install uv
 - 桌面模式：[examples/mcp-config-desktop.json](examples/mcp-config-desktop.json)
 - Web 模式：[examples/mcp-config-web.json](examples/mcp-config-web.json)
 
-### 3. 设定提示工程
+### 3. 设置提示工程
 为了获得最佳效果，请在 AI 助手中添加以下规则：
 
 ```
 # MCP Interactive Feedback 规则
 
-注意根据mcp-feedback-enhanced工具的要求在任务完成前进行工具调用
+注意在任务完成前根据mcp-feedback-enhanced工具的要求进行工具调用
 ```
 
-## ⚙️ 进阶设定
+## ⚙️ 高级设置
 
 ### 环境变量
 | 变量 | 用途 | 值 | 默认 |
@@ -172,11 +173,25 @@ pip install uv
 | `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_LANGUAGE` | 强制指定界面语言 | `zh-TW`/`zh-CN`/`en` | 自动检测 |
 
 **`MCP_WEB_HOST` 说明**：
 - `127.0.0.1`（默认）：仅本地访问，安全性较高
 - `0.0.0.0`：允许远程访问，适用于 SSH 远程开发环境
 
+**`MCP_LANGUAGE` 说明**：
+- 用于强制指定界面语言，覆盖系统自动检测
+- 支持的语言代码：
+  - `zh-TW`：繁体中文
+  - `zh-CN`：简体中文
+  - `en`：英文
+- 语言检测优先顺序：
+  1. 用户在界面中保存的语言设置（最高优先级）
+  2. `MCP_LANGUAGE` 环境变量
+  3. 系统环境变量（LANG、LC_ALL 等）
+  4. 系统默认语言
+  5. 回退到默认语言（繁体中文）
+
 ### 测试选项
 ```bash
 # 版本查询
@@ -188,6 +203,11 @@ uvx mcp-feedback-enhanced@latest test --desktop # 测试桌面应用程序 (v2.5
 
 # 调试模式
 MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test
+
+# 指定语言测试
+MCP_LANGUAGE=en uvx mcp-feedback-enhanced@latest test --web    # 强制使用英文界面
+MCP_LANGUAGE=zh-TW uvx mcp-feedback-enhanced@latest test --web  # 强制使用繁体中文
+MCP_LANGUAGE=zh-CN uvx mcp-feedback-enhanced@latest test --web  # 强制使用简体中文
 ```
 
 ### 开发者安装

README.zh-TW.md

@@ -53,7 +53,7 @@
 
 ### 🖼️ 圖片與媒體
 - **全格式支援**：PNG、JPG、JPEG、GIF、BMP、WebP
-- **便捷上傳**：拖拽檔案、剪貼板粘貼（Ctrl+V）
+- **便捷上傳**：拖拽檔案、剪貼板貼上（Ctrl+V）
 - **無限制處理**：支援任意大小圖片，自動智能處理
 
 ## 🌐 介面預覽
@@ -85,7 +85,7 @@
 
 **快捷鍵支援**
 - `Ctrl+Enter`（Windows/Linux）/ `Cmd+Enter`（macOS）：提交回饋（主鍵盤與數字鍵盤皆支援）
-- `Ctrl+V`（Windows/Linux）/ `Cmd+V`（macOS）：直接粘貼剪貼板圖片
+- `Ctrl+V`（Windows/Linux）/ `Cmd+V`（macOS）：直接貼上剪貼板圖片
 - `Ctrl+I`（Windows/Linux）/ `Cmd+I`（macOS）：快速聚焦輸入框 (感謝 @penn201500)
 
 ## 🚀 快速開始
@@ -122,7 +122,8 @@ pip install uv
       "env": {
         "MCP_DEBUG": "false",
         "MCP_WEB_HOST": "127.0.0.1",
-        "MCP_WEB_PORT": "8765"
+        "MCP_WEB_PORT": "8765",
+        "MCP_LANGUAGE": "zh-TW"
       },
       "autoApprove": ["interactive_feedback"]
     }
@@ -160,23 +161,37 @@ pip install uv
 ```
 # MCP Interactive Feedback 規則
 
-註意根據mcp-feedback-enhanced 工具的要求在任務完成前進行工具調用
+注意在任務完成前根據mcp-feedback-enhanced工具的要求進行工具調用
 ```
 
 ## ⚙️ 進階設定
 
 ### 環境變數
-| 變數 | 用途 | 值 | 默認 |
+| 變數 | 用途 | 值 | 預設 |
 |------|------|-----|------|
 | `MCP_DEBUG` | 調試模式 | `true`/`false` | `false` |
 | `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_LANGUAGE` | 強制指定介面語言 | `zh-TW`/`zh-CN`/`en` | 自動偵測 |
 
 **`MCP_WEB_HOST` 說明**：
 - `127.0.0.1`（預設）：僅本地存取，安全性較高
 - `0.0.0.0`：允許遠端存取，適用於 SSH 遠端開發環境
 
+**`MCP_LANGUAGE` 說明**：
+- 用於強制指定介面語言，覆蓋系統自動偵測
+- 支援的語言代碼：
+  - `zh-TW`：繁體中文
+  - `zh-CN`：簡體中文  
+  - `en`：英文
+- 語言偵測優先順序：
+  1. 用戶在介面中保存的語言設定（最高優先級）
+  2. `MCP_LANGUAGE` 環境變數
+  3. 系統環境變數（LANG、LC_ALL 等）
+  4. 系統預設語言
+  5. 回退到預設語言（繁體中文）
+
 ### 測試選項
 ```bash
 # 版本查詢
@@ -188,6 +203,11 @@ uvx mcp-feedback-enhanced@latest test --desktop # 測試桌面應用程式 (v2.5
 
 # 調試模式
 MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test
+
+# 指定語言測試
+MCP_LANGUAGE=en uvx mcp-feedback-enhanced@latest test --web    # 強制使用英文介面
+MCP_LANGUAGE=zh-TW uvx mcp-feedback-enhanced@latest test --web  # 強制使用繁體中文
+MCP_LANGUAGE=zh-CN uvx mcp-feedback-enhanced@latest test --web  # 強制使用簡體中文
 ```
 
 ### 開發者安裝

src/mcp_feedback_enhanced/i18n.py

@@ -31,7 +31,7 @@ class I18nManager:
         self._current_language = None
         self._translations = {}
         self._supported_languages = ["zh-CN", "zh-TW", "en"]
-        self._fallback_language = "zh-CN"
+        self._fallback_language = "zh-TW"
         self._config_file = self._get_config_file_path()
         self._locales_dir = Path(__file__).parent / "web" / "locales"
 
@@ -139,7 +139,7 @@ class I18nManager:
 
     def get_current_language(self) -> str:
         """獲取當前語言"""
-        return self._current_language or "zh-CN"
+        return self._current_language or "zh-TW"
 
     def set_language(self, language: str) -> bool:
         """設定語言"""