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 需要特定的主机配置），以及需要一致的依赖管理，以确保打包后的应用程序能正确反映代码库的当前状态。