常見問題

`deploy` 會發佈我的套件嗎？

不會。deploy 會建置一個 SPK，並安裝到你用 --host 指定的 NAS。CLI 沒有發佈、簽章或提交套件的指令。請見交付。

建置需要 NAS 嗎？

不需要。check、build、inspect 與 deploy --dry-run 都在你的電腦上執行。只有 deploy、status 與 logs 會連接 NAS。請見快速開始。

我該選哪個模板？

新 App 請選 native-go 搭配 Vue。要封裝容器請選 compose。請見開發者文件的表格。

SPK 有簽章嗎？

沒有。請用套件中心 > 手動安裝；安裝前 DSM 可能會提示這個 SPK 未簽章。請見交付。

`build` 因為缺少介面相依套件而失敗，該怎麼辦？

在 frontend/ 執行 npm install（有 package-lock.json 後改用 npm ci）。build 會執行介面建置，但不會安裝相依套件。請見快速開始。

如何變更 App 的 SDK 版本？

兩處都改成同一版本：在 backend/ 執行 go get github.com/synopackageland/syno-pkg-land-sdk@v<version>，在 frontend/ 執行 npm install --save-exact @synopackageland/sdk@<version>。兩者不同時 check 會以 SDK_VERSION_MISMATCH 失敗；CLI 的 minor 版本不同時則以 SDK_UNSUPPORTED 失敗。請安裝相同 minor 版本的 CLI。請見原生 App。

SDK repository 是 private。CLI 會在 Go 子行程的 GOPRIVATE、GONOPROXY 與 GONOSUMDB 中自動加入 github.com/synopackageland/*，並保留既有環境變數與 go env -w 設定。請讓 git 有 github.com 的憑證；可用 git ls-remote https://github.com/synopackageland/syno-pkg-land-sdk 驗證存取權限。若直接執行 go get，請為該指令設定 GOPRIVATE=github.com/synopackageland/*。

`deploy` 以 `DEPLOY_VERSION_INVALID` 失敗。

NAS 上已有相同的 version 且 build 相同或更高，或已有更高的 version（“Refusing downgrade”）。請提高 build，或提高 version。請見交付。

`status` 顯示 `needs-admin-approval`，是壞掉了嗎？

不是。delegate 與 root-ops 需要 DSM 管理員在 App 視窗中確認一次密碼。請見能力。

哪項能力讓使用者瀏覽自己的檔案？

files。App 透過已登入使用者的 DSM 工作階段操作，因此 File Station 會套用該使用者的權限。請見檔案。

我的 App 能在瀏覽器關閉後繼續工作嗎？

可以。要處理輸入的私有副本，請用 jobs。要把結果寫入使用者的資料夾，請用 delegate。請見背景工作與 Delegate。

`root-ops` 會讓我整個後端變成 root 嗎？

不會。後端仍是套件帳號。只有 root/ 內的固定腳本以 root 執行，而且只為管理員執行。請見 Root 操作。

解除安裝會刪除我 App 的資料嗎？

除非在解除安裝精靈中勾選「一併刪除上列 App 資料」，否則不會。請見資料與移除。

我可以在 ARM NAS 上執行嗎？

aarch64 可以。armv7 適用於 native-go 與 binary；其 executor、jobs 與 daemon 已建置，但尚未在 NAS 上驗證。請見平台與能力。

如何搭配 AI 助理？

用 init 建立的專案內含 AGENTS.md 與 CLAUDE.md。synopkgland skill list 會列出給助理使用的內建指引，synopkgland skill show <id> 會印出其中一頁。請見 CLI。

錯誤碼是什麼意思？

請到錯誤碼查詢。