精靈與啟動問題
上次更新：2026/10/14連接埠已被使用
可能的原因
另一個 QV2QS 實例或另一個應用程式正在使用相同的網路連接埠。主控台顯示 ERROR: Port [number] is already in use.
建議的行動
關閉其他應用程式，或使用 --port 指定不同的連接埠。使用 --port 0 讓系統自動選取可用的連接埠。
精靈在 Internet Explorer 中開啟或無法正確呈現
可能的原因
Internet Explorer 是機器上的預設瀏覽器。QV2QS 使用者介面需要現代瀏覽器，且無法在 Internet Explorer 中運作。
建議的行動
安裝 Google Chrome、Microsoft Edge 或 Mozilla Firefox。QV2QS 在啟動時偵測預設瀏覽器，並在有可用的瀏覽器時自動開啟支援的瀏覽器。如果找不到支援的瀏覽器，主控台會顯示下載連結。
在 Windows Server 2019 上，Internet Explorer 是唯一預設安裝的瀏覽器。請先安裝支援的瀏覽器，再以精靈模式執行 QV2QS。或者，使用命令列介面，它不需要瀏覽器。請參閱 引數參考 以取得 CLI 引數的完整清單。
轉換失敗或在精靈中產生非預期的結果
可能的原因
精靈會顯示摘要錯誤，但不會公開找出根本原因所需的完整診斷詳細資料。
建議的行動
從命令列重新執行相同的轉換，並啟用偵錯記錄。請執行下列動作：
- 在精靈中，導覽至檢閱步驟。
- 按一下複製命令以將完整的 CLI 命令複製到剪貼簿。
- 開啟終端機視窗並貼上已複製的指令。
- 將
--logLevel DEBUG附加到指令的末尾，然後按下 Enter 鍵。
主控台顯示詳細輸出，涵蓋每個轉換決策、雲端 API 呼叫，以及物件處理步驟。完整的偵錯日誌也會寫入到輸出目錄中的 logs/ 子資料夾。
複製的命令包含在精靈中設定的所有設定。附加 --logLevel DEBUG 是啟用完整診斷所需的唯一變更。
請參閱記錄與診斷以了解記錄檔格式和位置。
QV2QS 已停止
強制回應視窗出現在瀏覽器中
可能的原因
QV2QS 程序已關閉、崩潰或終止，而精靈仍在瀏覽器中開啟。使用者介面透過定期健康檢查監控後端服務，並在服務無法連線時顯示彈出視窗。
建議的行動
執行下列其中一個動作：
- 重新連線至目前的會話。複製在彈出視窗中顯示的指令，並在終端機中執行該指令。此命令包含
--port和--noBrowser，以重新連接到相同連接埠上的相同瀏覽器分頁。伺服器啟動後，在彈出視窗中點擊重新連線。精靈會繼續，所有先前輸入的設定都會保持不變。 - 關閉瀏覽器分頁。點擊 關閉視窗 在彈出視窗中。目前精靈工作階段中任何未儲存的設定都將遺失。
範例專案檔遺失或損毀
可能的原因
範例 QVW 檔案在 %TEMP%\QV2QS\examples\ 已被刪除、移動或在 QV2QS 外部修改。
建議的行動
從 %TEMP%\QV2QS\examples\ 刪除受影響的檔案，然後重新啟動 QV2QS。啟動時會自動提取一份全新的副本。若要保留範例檔案的永久副本，請在修改前將檔案複製到本機工作資料夾。請參閱範例專案。