在 Windows 11 與 Ubuntu Linux 24.04 上，使用 PyInstaller 把命令列程式打包成單一檔案的執行檔。src/main.py 會印出 Hello World 並等待按鍵；src/release.py 則把它打包成 model/release/main（Windows 為 main.exe），讓沒有安裝 Python 的使用者也能直接執行。
[資料夾結構]
- CLAUDE.md / AGENT.md：程式規格書（內容相同）。
- CHANGELOG.md：變更紀錄。
- copyright.txt：版權聲明。
- model/release/：打包步驟產生的執行檔。
- src/：main.py、release.py、啟動腳本與本說明文件。
- venv/：Python 虛擬環境，由步驟 1 建立。
[執行環境需求]
- 作業系統：Windows 11 或 Ubuntu Linux 24.04。
- Python 3 與 pip。
- Python 套件：pyinstaller，由步驟 1 自動安裝。
- 只有第一次下載 pyinstaller 時需要網路；不需要 GPU。
[操作步驟及說明]
步驟 1：建立虛擬環境
建立虛擬環境，並安裝 src/requirements.txt 裡的套件（pyinstaller）。
Windows 11：
src\01_venv_create.bat
Ubuntu Linux 24.04：
bash src/01_venv_create.sh
步驟 2：啟動虛擬環境
在目前的命令列視窗啟動虛擬環境。Linux 必須用 source 執行，啟動狀態才會在腳本結束後繼續保留。
Windows 11：
src\02_venv_activate.bat
Ubuntu Linux 24.04：
source src/02_venv_activate.sh
步驟 3：執行命令列程式
先用 Python 直接執行 src/main.py。程式會印出 Hello World 並等待按鍵——確認程式本身沒問題之後再進行打包。
Windows 11：
src\03_run.bat
Ubuntu Linux 24.04：
bash src/03_run.sh
步驟 4：打包成執行檔
透過啟動腳本執行 src/release.py，用 PyInstaller 進行打包。完成後會在 model/release/main（Windows 為 model/release/main.exe）產生單一檔案的執行檔，可以直接複製到沒有安裝 Python 的電腦上點兩下或用命令列執行。
Windows 11：
src\04_release.bat
Ubuntu Linux 24.04：
bash src/04_release.sh
步驟 5：移除虛擬環境
使用完畢後，刪除 venv/ 資料夾以釋放磁碟空間。需要時再重新執行步驟 1 即可。
Windows 11：
src\99_venv_clear.bat
Ubuntu Linux 24.04：
bash src/99_venv_clear.sh
[使用說明]
- 執行檔與作業系統綁定：在 Windows 打包出來的 exe 只能在 Windows 執行，Linux 版也只能在 Linux 執行——請在各個目標平台上分別打包。
- SDK 內附的 model/release/main.exe 是 2022 年的 Windows 舊版本；執行步驟 4 會用目前這台機器重新打包並覆蓋它。
- 單一檔案模式每次啟動時會先把內容解壓到暫存資料夾，所以第一次啟動會比直接執行 .py 檔慢一些。
- 剛打包好的 PyInstaller 執行檔偶爾會被防毒軟體誤判，這是這種打包格式常見的誤報。
這個 SDK 內建於 MYAI Studio 人工智慧開發工具。
單獨購買價格：5,000元，永久授權，單一 SDK 授權，單機授權，一次下載，無更新服務，一年電子郵件範例諮詢服務。如果是軟體客製化問題，請購買我們的客製化顧問服務點數。