chenjigang4167/testhub_platform

TestHub – AI 驅動的全端測試管理平台

這是什麼 – TestHub 是一個開源的 Web 應用程式，協助 QA 團隊規劃、撰寫、執行測試並產生報告。它在傳統的測試管理堆疊之上，加入了 AI 驅動的助手（需求到測試案例生成、整合式聊天機器人，以及讓語言模型驅動瀏覽器的 Browser-use 模式）。

核心功能

領域	TestHub 提供的功能
AI 輔助	• 上傳需求文件（PDF/Word/TXT），讓支援的 LLM（DeepSeek、OpenAI、Anthropic、Gemini 等）自動萃取業務需求並生成測試案例。 • 基於 Dify 的聊天機器人，提供隨選測試建議。 • Browser-use 模式：LLM 解析頁面結構（文字或視覺）並建立 Selenium/Playwright 腳本，以自動執行 UI 操作。
測試案例生命週期	依專案/版本建立、編輯、版本控制、封存、標記和組織案例。支援包含範本、檢查清單和狀態追蹤的多人審查。
API 測試	支援 HTTP 與 WebSocket、階層式請求集合、變數替換、斷言、排程執行、電子郵件/Webhook 通知、Allure 風格報告。
Web UI 自動化	Selenium 與 Playwright 後端、多瀏覽器（Chrome/Firefox/Edge）、元素庫、Page-Object Model、視覺化腳本編輯器、錄影/截圖、基於 cron 的排程，以及 AI 驅動的「智慧模式」。
行動裝置 (Android) 自動化	Airtest 影像辨識引擎、本機模擬器或遠端裝置處理、資源鎖定、元件庫、UI-Flow 編排、由 Celery 支援的非同步執行與即時 WebSocket 進度。
效能測試	基於 Locust 的負載測試任務，具備結果聚合與報告功能。
資料工廠	>50 種公用程式（隨機資料、編碼、加密、JSON 輔助工具、cron 運算式解析器等），可在 API 或 UI 測試中參考使用。
安全性與協作	JWT 雙重權杖與自動刷新、登出時黑名單、基於角色的權限、多專案隔離、統一通知（電子郵件、企業微信、DingTalk、Feishu）。

架構

• 後端：Django 4.2 + DRF、MySQL、Redis（Celery/WebSocket 可選）、JWT 認證、Celery + APScheduler 用於非同步任務、Channels/Daphne 用於 WebSocket、Allure 用於報告、LangChain-OpenAI 與 browser-use 用於 LLM 整合。
• 前端：Vue 3 + Vite、Element Plus UI 函式庫、Pinia store、Vue-Router、Axios、ECharts、Monaco 編輯器、i18n 支援。

開始使用（如 README 中所述）

1. 複製儲存庫並建立 Python 3.12 虛擬環境。
2. 從 requirements.txt 安裝 Python 相依套件。
3. 複製 .env.example 到 .env 並填入 MySQL、Redis、電子郵件和 LLM API 金鑰。
4. 建立 MySQL 資料庫，執行 Django 資料庫遷移，並建立超級使用者。
5. （選用）使用提供的的管理命令載入內建定位器策略和 Android 元件包。
6. 啟動服務：
   • python manage.py runserver（HTTP API）或 daphne … 以支援 WebSocket。
   • celery -A backend worker -l info 用於非同步任務。
   • python manage.py run_all_scheduled_tasks 用於 cron 任務。
7. 在另一個終端機中，建置前端：

   cd frontend
   npm install
   npm run dev   # 開發伺服器位於 http://localhost:3000
   

8. 存取 UI（http://localhost:3000）、API 文件（/api/docs/）和 Django 管理介面（/admin/）。

Docker 使用者可以執行 ./build-and-push.sh，接著執行 docker-compose up -d 以一鍵啟動全端堆疊。

適用對象

• 需要單一入口網站進行需求分析、測試案例撰寫、審查和執行的 QA 團隊。
• 希望透過 LLM 生成的案例或 AI 引導的 UI 自動化來增強手動測試的組織。
• 需要可擴充平台（Django 應用程式、Vue 元件）以插入自訂測試類型整合的開發人員。

授權 – GPL 3.0（請參閱 LICENSE）。

---

以上所有資訊均直接取自儲存庫的 README；未推斷任何額外功能。