📝 更新 README 文件,調整測試指令說明,刪除持久化模式相關內容,並新增本地測試方法與測試說明。更新主程式以改善 Web UI 測試提示,移除持久化模式選項。

This commit is contained in:
Minidoracat 2025-06-03 00:27:25 +08:00
parent a982de1aea
commit 0dffd053a3
7 changed files with 84 additions and 1151 deletions

View File

@ -57,9 +57,6 @@ pip install uv
# Quick test
uvx mcp-feedback-enhanced@latest test
# Interactive test
uvx mcp-feedback-enhanced@latest test --persistent
```
### 2. MCP Configuration
@ -122,8 +119,8 @@ For best results, add these rules to your AI assistant:
uvx mcp-feedback-enhanced@latest version # Check version
# Interface-specific testing
uvx mcp-feedback-enhanced@latest test --gui # Qt GUI only
uvx mcp-feedback-enhanced@latest test --web # Web UI only
uvx mcp-feedback-enhanced@latest test --gui # Quick test Qt GUI
uvx mcp-feedback-enhanced@latest test --web # Test Web UI (keeps running)
# Debug mode
MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test
@ -134,9 +131,27 @@ MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test
git clone https://github.com/Minidoracat/mcp-feedback-enhanced.git
cd mcp-feedback-enhanced
uv sync
uv run python -m mcp_feedback_enhanced test
```
**Local Testing Methods**
```bash
# Method 1: Standard test (recommended)
uv run python -m mcp_feedback_enhanced test
# Method 2: Complete test suite (macOS dev environment)
uvx --with-editable . mcp-feedback-enhanced test
# Method 3: Interface-specific testing
uvx --with-editable . mcp-feedback-enhanced test --gui # Quick test Qt GUI
uvx --with-editable . mcp-feedback-enhanced test --web # Test Web UI (keeps running)
```
**Testing Descriptions**
- **Standard Test**: Complete functionality check, suitable for daily development verification
- **Complete Test**: Deep testing of all components, suitable for pre-release verification
- **Qt GUI Test**: Quick launch and test of local graphical interface
- **Web UI Test**: Start Web server and keep running for complete Web functionality testing
## 🆕 Version Highlights
### v2.0.14 (Latest)

View File

@ -58,8 +58,6 @@ pip install uv
# 快速测试
uvx mcp-feedback-enhanced@latest test
# 可互动测试
uvx mcp-feedback-enhanced@latest test --persistent
```
### 2. 配置 MCP
@ -122,8 +120,8 @@ uvx mcp-feedback-enhanced@latest test --persistent
uvx mcp-feedback-enhanced@latest version # 检查版本
# 指定介面测试
uvx mcp-feedback-enhanced@latest test --gui # 测试 Qt GUI
uvx mcp-feedback-enhanced@latest test --web # 测试 Web UI
uvx mcp-feedback-enhanced@latest test --gui # 快速测试 Qt GUI
uvx mcp-feedback-enhanced@latest test --web # 测试 Web UI(保持运行)
# 调试模式
MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test
@ -134,9 +132,27 @@ MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test
git clone https://github.com/Minidoracat/mcp-feedback-enhanced.git
cd mcp-feedback-enhanced
uv sync
uv run python -m mcp_feedback_enhanced test
```
**本地测试方式**
```bash
# 方式一:标准测试(推荐)
uv run python -m mcp_feedback_enhanced test
# 方式二完整测试套件macOS 开发环境)
uvx --with-editable . mcp-feedback-enhanced test
# 方式三:指定介面测试
uvx --with-editable . mcp-feedback-enhanced test --gui # 快速测试 Qt GUI
uvx --with-editable . mcp-feedback-enhanced test --web # 测试 Web UI保持运行
```
**测试说明**
- **标准测试**:执行完整的功能检查,适合日常开发验证
- **完整测试**:包含所有组件的深度测试,适合发布前验证
- **Qt GUI 测试**:快速启动并测试本地图形界面
- **Web UI 测试**:启动 Web 服务器并保持运行,便于完整测试 Web 功能
## 🆕 版本亮点
### v2.0.14(最新)

View File

@ -57,9 +57,6 @@ pip install uv
# 快速測試
uvx mcp-feedback-enhanced@latest test
# 可互動測試
uvx mcp-feedback-enhanced@latest test --persistent
```
### 2. 配置 MCP
@ -122,8 +119,8 @@ uvx mcp-feedback-enhanced@latest test --persistent
uvx mcp-feedback-enhanced@latest version # 檢查版本
# 指定介面測試
uvx mcp-feedback-enhanced@latest test --gui # 測試 Qt GUI
uvx mcp-feedback-enhanced@latest test --web # 測試 Web UI
uvx mcp-feedback-enhanced@latest test --gui # 快速測試 Qt GUI
uvx mcp-feedback-enhanced@latest test --web # 測試 Web UI (自動持續運行)
# 調試模式
MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test
@ -134,9 +131,27 @@ MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test
git clone https://github.com/Minidoracat/mcp-feedback-enhanced.git
cd mcp-feedback-enhanced
uv sync
uv run python -m mcp_feedback_enhanced test
```
**本地測試方式**
```bash
# 方式一:標準測試(推薦)
uv run python -m mcp_feedback_enhanced test
# 方式二完整測試套件macOS 開發環境)
uvx --with-editable . mcp-feedback-enhanced test
# 方式三:指定介面測試
uvx --with-editable . mcp-feedback-enhanced test --gui # 快速測試 Qt GUI
uvx --with-editable . mcp-feedback-enhanced test --web # 測試 Web UI (自動持續運行)
```
**測試說明**
- **標準測試**:執行完整的功能檢查,適合日常開發驗證
- **完整測試**:包含所有組件的深度測試,適合發布前驗證
- **Qt GUI 測試**:快速啟動並測試本地圖形界面
- **Web UI 測試**:啟動 Web 服務器並保持運行,便於完整測試 Web 功能
## 🆕 版本亮點
### v2.0.14(最新)

View File

@ -28,9 +28,8 @@ def main():
# 測試命令
test_parser = subparsers.add_parser('test', help='執行測試')
test_parser.add_argument('--web', action='store_true', help='測試 Web UI')
test_parser.add_argument('--gui', action='store_true', help='測試 Qt GUI')
test_parser.add_argument('--persistent', action='store_true', help='持久化測試模式')
test_parser.add_argument('--web', action='store_true', help='測試 Web UI (自動持續運行)')
test_parser.add_argument('--gui', action='store_true', help='測試 Qt GUI (快速測試)')
# 版本命令
version_parser = subparsers.add_parser('version', help='顯示版本資訊')
@ -66,7 +65,11 @@ def run_tests(args):
success, session_info = test_web_ui()
if not success:
sys.exit(1)
if args.persistent and session_info:
# Web UI 測試自動啟用持續模式
if session_info:
print("📝 Web UI 測試完成,進入持續模式...")
print("💡 提示:服務器將持續運行,可在瀏覽器中測試互動功能")
print("💡 按 Ctrl+C 停止服務器")
interactive_demo(session_info)
elif args.gui:
print("🧪 執行 Qt GUI 測試...")
@ -108,10 +111,6 @@ def run_tests(args):
print("🎉 所有測試通過!")
# 如果是持久化模式且有會話資訊,進入互動模式
if args.persistent and session_info:
interactive_demo(session_info)
def show_version():
"""顯示版本資訊"""
from . import __version__, __author__

View File

@ -5,7 +5,7 @@ Qt GUI 測試模組
===============
用於測試 Interactive Feedback MCP Qt GUI 功能
包含完整的 GUI 功能測試支援持久化模式
包含完整的 GUI 功能測試
功能測試
- Qt GUI 界面啟動
@ -15,7 +15,7 @@ Qt GUI 測試模組
- 快捷鍵功能
使用方法
python -m mcp_feedback_enhanced.test_qt_gui [--persistent]
python -m mcp_feedback_enhanced.test_qt_gui
作者: Minidoracat
"""

View File

@ -1,21 +1,21 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
Web UI 測試模組
===============
Interactive Feedback MCP - Web UI 測試模組
========================================
用於測試 Interactive Feedback MCP Web UI 功能
包含完整的 Web UI 功能測試支援持久化模式
包含完整的 Web UI 功能測試
功能測試
- Web UI 服務器啟動
- 會話管理功能
- WebSocket 通訊
- 回饋提交功能
- 圖片上傳功能
- 多語言支援
- 命令執行功能
使用方法
python -m mcp_feedback_enhanced.test_web_ui [--persistent]
python -m mcp_feedback_enhanced.test_web_ui
作者: Minidoracat
"""
@ -271,7 +271,7 @@ def test_environment_web_ui_mode():
def interactive_demo(session_info):
"""Run interactive demo with the Web UI"""
debug_log(f"\n🌐 Web UI 持久化運行模式")
debug_log(f"\n🌐 Web UI 互動測試模式")
debug_log("=" * 50)
debug_log(f"服務器地址: http://{session_info['manager'].host}:{session_info['manager'].port}")
debug_log(f"測試會話: {session_info['url']}")
@ -308,13 +308,6 @@ if __name__ == "__main__":
debug_log("Interactive Feedback MCP - Web UI 測試")
debug_log("=" * 60)
# Check if user wants persistent mode
persistent_mode = len(sys.argv) > 1 and sys.argv[1] in ['--persistent', '-p', '--demo']
if not persistent_mode:
debug_log("💡 提示: 使用 'python test_web_ui.py --persistent' 啟動持久化測試模式")
debug_log()
# Test environment detection
env_test = test_environment_detection()
@ -346,14 +339,11 @@ if __name__ == "__main__":
debug_log(" - 自動瀏覽器啟動")
debug_log(" - 命令執行和即時輸出")
if persistent_mode and session_info:
interactive_demo(session_info)
else:
debug_log("\n✅ 測試完成 - 系統已準備就緒!")
if session_info:
debug_log(f"💡 您可以現在就在瀏覽器中測試: {session_info['url']}")
debug_log(" (服務器會繼續運行一小段時間)")
time.sleep(10) # Keep running for a short time for immediate testing
debug_log("\n✅ 測試完成 - 系統已準備就緒!")
if session_info:
debug_log(f"💡 您可以現在就在瀏覽器中測試: {session_info['url']}")
debug_log(" (服務器會繼續運行一小段時間)")
time.sleep(10) # Keep running for a short time for immediate testing
else:
debug_log("❌ 部分測試失敗,請檢查錯誤信息")
sys.exit(1)

1102
uv.lock generated

File diff suppressed because it is too large Load Diff