安裝
環境需求、基礎安裝，以及可選的編譯強檔擴充套件。
一個套件就搞定所有需求：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 不需要開啟瀏覽器的非互動式啟用方式，見帳號與啟用。