testing

此測試技能是一套完整的工具集，旨在確保 DBHub MCP 伺服器的穩定性與效能。它為開發人員提供了一個結構化的環境，用於執行單元測試、整合測試以及針對特定環境的資料庫驗證。無論您是在新增功能、修補錯誤或是進行迴歸測試，此技能都能讓您針對包括 PostgreSQL、MySQL、MariaDB、SQL Server 和 SQLite 在內的多種資料庫後端驗證系統完整性。該技能透過 Testcontainers 處理容器化資料庫的複雜生命週期管理，確保測試是隔離、可複製且穩定的。它專為維護 DBHub 程式碼庫並需要確保資料庫連接、SQL 解析以及自定義工具處理器在各種配置下正確運作的工程師所設計。

• 使用 Vitest 執行單元與整合測試套件，支援指定測試檔案與名稱模式。

• 管理基於 Docker 的整合測試生命週期，特別針對 SQL Server、PostgreSQL、MySQL 和 MariaDB 容器。

• 提供調試功能，包括詳細的報告輸出與互動式觀察模式，以便即時獲取開發反饋。

• 利用共用測試套件進行跨不同資料庫驅動的架構操作、資料插入與儲存程序驗證。

• 促進針對 SSH 隧道、透過 TOML 進行的多來源配置以及工具層級執行限制等複雜場景的測試。

• 所有整合測試任務皆需要 Docker 正在執行且可存取。

• 整合測試必須遵循特定命名規則 (*integration.test.ts)，以便 Vitest 設定能正確分類。

• 如 SQL Server 等資料庫容器可能需要額外的系統資源 (4GB 以上 RAM) 及更長的啟動時間 (3-5 分鐘)。

• 使用 'pnpm test' 指令執行完整套件，或依專案 (unit vs. integration) 過濾以優化反覆開發期間的效能。

• 若測試失敗，請利用內建的故障排除文件來調查容器啟動問題、檢查洩漏的容器資源，或驗證 CI/CD 工作流程日誌。