跳至主要内容

安裝 SDK

安裝最新的 Palette SDK。它會以容器形式在主機上執行。

必要條件​

若稍後要使用 DevKit Sync，還需要：

  • 執行與 Palette SDK 相容軟體的 DevKit。詳情請參閱相容性指南。
  • 位於同一個網路且允許 NFS 流量的主機與 DevKit。
  • DevKit IP 位址。

安裝​

安裝目前的 Palette SDK 3.0 發行通道：

host$sima-cli neat install sdk@release-3.0

首次安裝可能需要數分鐘，因為必須下載 Palette SDK 容器映像。下載完成後，安裝程式會開始設定 SDK，並詢問是否要與 Modalix DevKit 配對，以及是否要在 SDK 中安裝相容的 Model Compiler。

若選擇與 DevKit 配對，請在提示時輸入 DevKit IP 位址。設定流程會設定 SDK 工作區、啟動 SDK 容器並設定 DevKit Sync。若略過配對，系統仍會建立 SDK 工作區，之後也可以再進行配對。

release-3.0 套件會追蹤 3.0 系列最新的 Palette SDK 修補程式版本。目前版本為 Palette SDK 3.0.0.1，與 DevKit 軟體 3.0.0 相容。

設定期間，sima-cli 也會詢問是否要在 SDK 中安裝相容的 Model Compiler。若您會自行編譯或量化模型，請接受提示；不需要另外選擇版本。若只執行預先編譯的模型套件，則可略過。若要稍後安裝、固定特定修補版本或使用獨立主機，請參閱安裝 Model Compiler及相容性指南。

安裝特定 SDK 版本​

SDK 2.1.3.0 及更新版本可使用已發布的 v<version> 標籤安裝特定版本，包括較舊的修補程式版本。例如，在主機上執行：

host$sima-cli neat install sdk@v2.1.3.0

v 前綴不可省略。請勿使用 release-<full-version> 作為特定版本標籤。release-<series> 通道會追蹤該系列最新發布的版本。若選取相同的 SDK 套件，兩種方式都會執行相同的安裝與 SDK 設定步驟。

請在 SDK 版本中尋找已發布的標籤，並依照相容性指南選擇與 DevKit 軟體相容的版本。

傳統兩階段安裝

SDK 2.0.0、2.1.2.0 和 2.1.2.1 需要分別執行映像提取與設定命令。僅這些版本需要使用兩階段 SDK 安裝。

若要在安裝後變更 SDK 設定，請參閱設定 SDK。受限網路環境請參閱離線安裝。

访问 SDK​

設定成功後，可以從終端機、Chrome 瀏覽器或 VS Code 访问 SDK。

使用 SDK Shell​

使用下列命令開啟 Palette SDK shell：

host$sima-cli sdk neat

使用 Chrome 瀏覽器​

Neat Insight 由 SDK 內部提供，可從瀏覽器開啟。請在 SDK shell 中執行：

sdk$neat

neat 輸出的 Web Access 區段包含 Insight 與瀏覽器版 VS Code 的本機及遠端 URL。若瀏覽器在 SDK 主機上執行，請開啟本機 127.0.0.1 URL。從其他電腦存取時，請使用以 NFS_SERVER_HOST_IP 為基礎的遠端 URL。VS Code URL 會開啟設定的工作區；請使用 neat 針對已安裝伺服器顯示的登入資訊。請參閱 SDK 網頁存取與 Insight。

使用 VS Code​

在 SDK shell 中執行 neat，然後在 SDK 主機的瀏覽器中開啟 VS Code (local) URL。從其他電腦存取時，請使用 VS Code (remote)。若映像包含 code-server，neat 也會顯示 VS Code password：

VS Code (local)    https://127.0.0.1:10000/?folder=/workspace
VS Code password   <password shown by neat>

在 code-server 登入畫面輸入顯示的密碼。密碼不會包含在 URL 中。

舊版 OpenVSCode 映像改用含權杖的 URL；請開啟 neat 顯示的 URL。SDK 已在瀏覽器 Code UI 中預先安裝 Codex 與 Claude Code 擴充功能。

若偏好瀏覽器以外的方式，也可以使用原生 VS Code。使用 Dev Containers 將 VS Code 連線至 SDK 容器。

在 SDK 容器中執行一次 sima-cli login，讓 SDK 可以擷取預先建置模型等資產。

升級​

若要重新安裝或升級至目前的 SDK 套件，請從主機重新執行上述安裝命令：

host$sima-cli neat install sdk@release-3.0

若要更新現有 Palette SDK 容器內的 Neat 程式庫，請從容器 shell 執行 Neat CLI：

sdk$neat update

這會更新目前 Palette SDK 中已安裝的 Neat 程式庫元件。若需要容器層級變更，這無法取代完整的容器映像升級。

若稍後刪除或重新建立 Palette SDK 容器，請在新容器內再次執行 neat update。

解除安裝​

若要移除已安裝的 SDK 容器，請執行：

host$sima-cli sdk remove

後續步驟​

  • 要在 SDK 中編譯模型嗎？ 繼續前往完全在 SDK 中執行且不需要 DevKit 的編譯模型。
  • 要配對 DevKit 嗎？ 設定 DevKit Sync，以共用 SDK 工作區並在硬體上執行 dk 命令。