安裝與使用說明

1. Windows Installer

下載並執行 MangoThonny-Setup-v0.4.0.exe。安裝介面提供繁體中文。若希望建立桌面捷徑，請在安裝選項中勾選。

Installer SHA-256：

2. Portable

下載 MangoThonny-Portable-v0.4.0.zip 後解壓縮到可寫入的資料夾，再執行 MangoThonny.exe。若原生 launcher 無法使用，可改執行 MangoThonny.bat。

Portable SHA-256：

3. Interpreter 切換

• Host / CPython：使用 MangoThonny 內建 Python 執行桌面程式與 Host Student API。
• Raspberry Pi Pico / MicroPython：連接 Pico 系列裝置後，可切換到 MicroPython interpreter 執行板端程式。
• 正式版已驗證 Host → Pico → Host 來回切換。

4. MangoBox Host Student API

Host Python 建議使用 canonical import：

舊教材的 import mangox2 仍保留相容性。Pico W target 會依 Runtime identity 正確辨識，不需要使用另一套 Student API。

5. 支援硬體

• MangoX2 + Raspberry Pi Pico
• MangoX2 + Raspberry Pi Pico W
• MangoX2 + Raspberry Pi Pico 2 W
• MangoLite + Raspberry Pi Pico W
• MangoLite + Raspberry Pi Pico 2 W

6. 安裝版資料位置

Installer 模式將可寫資料與應用程式本體分離：

因此執行範例、Exporter、Python bytecode 與 mypy cache 不會污染安裝目錄。解除安裝時可依提示選擇是否保留使用者設定與學習資料。

7. Mango App Exporter

MangoThonny 已內建 Mango App Exporter，可將桌面 Python 專案封裝為可攜式 Windows 執行程式。建議先確認程式在 MangoThonny 的 Host / CPython 模式可以正常執行，再進行 Export。

正式版驗證

v0.4.0 已完成 Portable package verification、GUI、Host ↔ Pico 切換、Pico W identity / Host LED 實機 sanity、Installer、捷徑、資料隔離、保留資料解除安裝與刪除設定解除安裝驗證。