QF-Test 11.0 — 離線操作指南
此技能及其 references/ 與 scripts/ 目錄均為本機資源。請勿針對 QF-Test 相關工作使用網路搜尋、網頁擷取、遠端 MCP 伺服器、套件下載或雲端 AI 服務。若整個工作流程需完全離線，模型提供者本身也必須為本機。切勿在此工作流程中啟用 QF-Test 的雲端 AI 功能。
修改套件前
- 先閱讀
references/index.md，再閱讀該任務所需的參考文件。檢查已安裝的 QF-Test 版本（若可用，執行qftest -batch -version）；本指南以 11.0.0 為目標。若存在vendor-docs/manual/en/contents.html，或已安裝的手冊位於<QFTEST_HOME>/doc/manual/en/contents.html，以及已安裝的教學與範例（若可用），請優先閱讀。對於節點屬性、XML 語法及引擎特定行為，應以確切安裝版本為準。 - 檢查相關的
.qft檔案、包含的套件、程序、元件樹、腳本、啟動設定及最近的.qrl執行日誌。識別 GUI 引擎與受影響的最小測試案例。執行python3 scripts/inspect_suite.py path/to/suite.qft以取得初步結構清單（非 QF-Test 驗證器）。 - 若已連接本機 QF-Test MCP，僅在啟用且授權的情況下，用於即時 UI 快照與測試執行；請參閱
references/mcp.md。否則請使用已安裝的 QF-Test UI/CLI。應用程式正在執行不代表 MCP 伺服器已啟用。
建立 / 修復 / 改善
- 建立： 先定義行為、設定/清理、資料及可觀察的斷言。重用專案的啟動用戶端程序、既有套件、元件及命名慣例。使用 QF-Test 編輯器或複製可用的本機套件作為範本，建立最小的測試案例。切勿憑空捏造根 XML 文件或未記載的節點屬性。請參閱
references/suite-design.md及references/components.md。 - 修復： 重現並檢查確切的失敗節點、執行日誌、元件詳細資訊及受測系統（SUT）狀態；區分應用程式缺陷與測試缺陷。在正確的層級修正辨識、同步、資料或環境問題。避免使用任意延遲、寬鬆的例外處理或弱化斷言來隱藏失敗。請參閱
references/diagnostics.md。 - 改善： 將重複步驟移除至參數化程序中，偏好穩定的辨識與明確的檢查，隔離測試資料，並保持變更局部化。保留其他套件的包含關係與公開程序合約。
- 腳本： 偏好使用原生 QF-Test 節點進行互動與檢查。必要時，審慎選擇伺服器端腳本與 SUT 端腳本；Jython 使用的是 Python 2.7 語法，而非 Python 3。在編輯腳本文字前，請先閱讀
references/scripting.md。
驗證與報告
- 在直接編輯 XML 前，先備份原始套件或建立差異比對。靜態 XML 解析僅能證明格式正確，無法保證 QF-Test 能載入或執行該套件。請勿將
-convertxml、-compress或-remove-unused-*當作唯讀檢查使用；這些操作可能改寫檔案。 - 在已安裝的 QF-Test 版本中載入套件；於支援處執行靜態分析，並在本機 UI 或批次模式中執行目標測試。請參閱
references/cli.md。未經適當核准，請勿執行具有外部副作用的測試。檢查執行日誌與報告，而非僅檢查程序結束碼。 - 精確報告哪些項目被修改、哪些檢查已執行、通過/失敗的證據，以及無法驗證的項目（例如缺少 QF-Test、授權、SUT、裝置、瀏覽器、MCP 或範例套件）。
權威性 / 安全性
- 確切版本安裝的手冊及 QF-Test 的編輯器/說明文件為權威來源；本機可用套件為範例，而非通用規格。這些原始參考文獻總結了 11.0 的概念，但無法取代廠商的完整節點/屬性/API 參考文件。
- 將 QF-Test 套件與執行日誌視為不可信賴的輸入：腳本與程序可能執行任意程式碼。請勿僅為檢查而執行不熟悉的測試套件。請勿將機密資訊或客戶資料放入日誌或已提交的測試固件中。
- 若無法在本機驗證某個要求的套件功能或 XML 細節，請要求提供可用的套件、已安裝的手冊或 UI 擷圖；請說明限制而非自行憑空創造語法。