Platform SDK
單一套件 — @synopackageland/dev-sdk — 提供瀏覽器、伺服器與 Node 用戶端的執行時安全匯入。無額外 adapter 套件。
預期安裝：npm i @synopackageland/dev-sdk。公開 npm 可能尚未發佈。
進入點
| 匯入 | 使用時機 |
|---|---|
@synopackageland/dev-sdk/browser | 瀏覽器中的 Web UI — requireLogin、User Context、File API。 |
@synopackageland/dev-sdk/server | App 容器內的 HTTP 處理器。 |
@synopackageland/dev-sdk/node | Headless Client、worker 與代表 App User 的 CLI 工具。 |
何時需要
不需要 DSM 身分或 File API 的 App 可在執行時跳過 SDK，仍可用 Developer Kit 產生 Docker 型 SPK。需要平台能力的 Integrated App 安裝單一 SDK 套件並在 App Contract 宣告整合。
身分宣告
發行者宣告 integration.identity.mode: broker-managed。Developer Kit 產生 callback 路徑、Package 啟動器、Trusted App Entry 與執行時 bootstrap。v1 預設不要求 NAS 網域、OIDC issuer 或完整 redirect URI — 零設定入口使用使用者已開啟的 DSM URL。
框架範例（Express、Better Auth 等）示範如何用相同 verifier 驗證 User Context — 它們是範例，不是獨立發佈的外掛。
Developer Kit 與 Platform SDK
| 產品 | 時機 | 角色 |
|---|---|---|
Developer Kit (synopkgland) | 建置、驗證、部署、發佈 | Schema、CLI、分析器、SPK 產生器、repository publisher |
| Platform SDK | NAS 上的 App 執行時 | User Context、File API、共用錯誤 |
| Skill Pack | Agent 驅動撰寫 | 漸進式技能；權威仍在 schema 與測試 |