castella-packaging

castella-packaging 技能賦予 AI 代理將純 Python Castella UI 專案轉換為生產級可發佈格式的能力。對於希望在不要求終端用戶手動管理 Python 環境的情況下，發佈桌面或跨平台應用程式的開發者來說，此技能至關重要。它作為強大打包工具的介面，主要透過 'ux' 簡化工作流程，同時為特殊編譯需求提供 PyInstaller 和 Nuitka 的彈性。

• 使用 'ux' 工具進行簡化打包，利用 'uv' 建立 macOS、Linux 和 Windows 平台的隔離式、零依賴可執行二進位檔案。

• 原生 macOS 應用程式包生成，支援程式碼簽章、DMG 建立以及 Apple notarization 服務等關鍵安全與發佈步驟。

• 支援主要架構 (darwin-x86_64, darwin-aarch64, linux-x86_64, linux-aarch64, windows-x86_64) 的交叉編譯。

• 透過 'pyproject.toml' 進行配置管理，開發者可定義進入點、包含資源，並自訂平台特定的元資料，如 bundle identifier 和圖示。

• 支援替代的編譯策略，包括用於單檔案建構的 PyInstaller，以及將 Python 程式碼編譯為優化原生二進位檔的 Nuitka。

• 此技能適用於自動化 CI/CD 管道或互動式開發工作階段，當使用者要求進行 'bundle'、'executable' 或 'distributable' 時觸發。

• 主要輸入包含專案路徑與目標平台/格式；輸出通常是指定目錄下生成的二進位成品。

• 使用者應確保環境已配置 'uv' 及必要的開發依賴項。針對複雜的 macOS 發佈流程，需具備有效的開發者憑證以順利完成 notarization。

• 限制條件包括平台特定的編譯限制（例如，交叉編譯至 macOS 需要特定的主機配置），以及需要一致的依賴管理，以確保打包後的應用程式能正確反映程式碼庫的當前狀態。