二、 依賴庫配置¶
適用人群
本頁面適用於需要了解軟體依賴構成,或現場無法使用軟體內建部署工具的使用者。普通使用者請直接使用軟體內建的"環境部署"模組(推薦)。
1. 安裝 Python 3.12(必裝前置)¶
本軟體推薦使用 Python 3.12 系列 環境。
Ubuntu 24.04.4 LTS 自帶 Python 3.12 系列,此係統下可直接跳過本節。
1.1 下載 Python 3.12¶
建議從 Python 官方網站下載最新的 3.12 穩定版:
- 官方下載頁面:Python 全版本列表
- 推薦下載項:尋找頁面中 3.12 系列相關的
Windows installer (64-bit),如 Python 3.12.4 。

1.2 關鍵安裝步驟¶
1.2.1 啟動安裝¶
- 執行下載的
.exe安裝程式。 - 重點(必選):在安裝首介面勾選 "Add Python.exe to PATH"。
如果不勾選此項,你將無法在終端直接使用 python 命令。
- 點選 "Install Now" 或根據需要選擇自定義安裝。

1.2.2 禁用路徑長度限制(可選)¶
安裝結束時,如果介面出現 "Disable path length limit" 選項,建議點選。這可以避免在處理深度學習模型等深層檔案路徑時出錯。

1.3 環境驗證¶
安裝完成後,請開啟命令列(CMD 或 PowerShell),輸入以下命令檢查:
2. 核心依賴庫¶
為了支援 YOLO 視覺偵測、影象處理及資料分析功能,軟體需要配置專用的 Python 依賴庫。本軟體內建了環境一鍵部署工具,支援線上和離線兩種模式。
2.1 核心依賴庫列表¶
- OpenCV (opencv-python):影象處理與相機驅動。
- Pillow (PIL):基礎影象操作與格式轉換。
- NumPy:矩陣運算與視覺資料處理。
- Scikit-learn:演算法模型評估與資料預處理。
- Tqdm:訓練及處理過程的進度條顯示。
3. 線上部署(推薦)¶
如果您當前處於有網路連線的環境,這是最快捷的配置方式。
開啟軟體:進入主介面,選擇側邊欄的环境部署。

- 映象選擇:預設
华为云镜像。 - 安裝:單獨點選每一個小卡片並等待進度條結束即可。
-
驗證:
4. 離線部署(針對生產現場)¶
針對無法連線網際網路的工業現場,請按照以下步驟使用預下載的離線包。
4.1 執行離線安裝¶
- 在軟體的 "環境部署" 介面中,選擇 "離線安裝 (Offline Install)"。
- 定位資源:在彈出的目錄視窗中,選擇軟體自帶的離線包資料夾。

最後一鍵部署:點選"安裝選中檔案"。軟體將呼叫內建指令,從本地路徑安裝 whl 檔案,無需聯網。
