CLI 參考
synopkgland 是 Developer Kit CLI（@synopackageland/cli）。Skill Pack 隨 CLI 出貨 — 不是獨立的 npm 套件。
預期安裝：npm i -g @synopackageland/cli。公開 npm 可能尚未發佈。
CLI 從目前工作目錄向上尋找 synology-app.yaml，或使用 --project <dir>。
| 指令 | 用途 |
|---|---|
init -t hello-web|hello-files|compose-import | 從範本建立最少 Compose 與 App Contract。 |
inspect | 從現有 Compose 列出已發佈連接埠、資料路徑與風險；建議 admin* 中繼資料。 |
dev | 以 mock Broker、假使用者與假檔案樹在本機執行 Compose。 |
validate | 檢查 schema、Compose 交叉參照、安全政策與相容性設定檔。 |
test | 執行 contract 測試與本機 Compose 就緒；部署後可選 --host 煙霧測試。 |
deploy --host <nas> | Inner Loop Deploy — 產生 thin SPK、DSM 授權、Local Attestation、Personal App。 |
info | 顯示 Package Identity、開發 vs 正式實例、DSM Open URL、就緒摘要。 |
log | 追蹤容器日誌；失敗時遮罩診斷資訊。 |
build-spk | 產生確定性的本機 thin SPK（非 Curated 版本）。 |
publish | 開啟或更新 Community Repository Pull Request；不簽署 Curated 版本。 |
典型流程
synopkgland init -t hello-web
synopkgland dev
synopkgland validate
synopkgland test
synopkgland deploy --host <nas>
synopkgland info
synopkgland log
synopkgland publish