安装
环境要求、基础安装，以及可选的编译强档扩展。
一个包搞定一切：magiclock CLI、主机 SDK（bootstrap()、open_model()）以及编译强档所需的构建工具。
环境要求
- Python 3.9–3.14，支持 macOS、Windows、Linux。
- 建议但不强制使用虚拟环境——包会装进执行
pip install的那个解释器里。 - 便捷档（加密代码与模型）不需要 C 编译器。编译强档需要，见下文。
安装
shell
pip install magiclock验证安装
shell
magiclock --version
magiclock --help编译强档扩展
magiclock build 会把你的应用编译成原生二进制（见编译强档）。它依赖基于 Nuitka 的构建后端，构建机上需要 C 工具链：
shell
pip install "magiclock[build]"| 平台 | 工具链 |
|---|---|
| macOS | Xcode Command Line Tools（xcode-select --install） |
| Linux | 发行版包管理器提供的 gcc/clang |
| Windows | MSVC Build Tools，或 MinGW-w64 |
只有执行 magiclock build 的那台机器需要 [build] 扩展和工具链——之后运行编译产物的机器不需要。
升级
shell
pip install --upgrade magiclock升级 CLI/SDK 版本不影响已经生成的加密产物和授权。
CI 与容器
安装步骤在任何地方都一样，包括容器或 CI 运行环境——安装本身不依赖图形界面。让 magiclock protect 无需打开浏览器的非交互式激活方式，见账号与激活。