创建 Nimi App
当你需要一个 Nimi App 开发仓库时，使用 @nimiplatform/app-tools。CLI 会创建 scaffold 输入和本地检查；它不会授予公开准入、权限、registry 可见性、release descriptor，或 installed-app update truth。
创建 Scaffold
pnpm dlx --package @nimiplatform/app-tools nimi-app create --dir my-nimi-app --profile standalone
cd my-nimi-app
pnpm install
pnpm run initstandalone 是外部开发者仓库 profile。它会创建一个 candidate app repository，拥有自己的 .nimi/** host truth surface 和 submitted manifest input。只有当某个 monorepo app slice 有已准入的 workspace 理由时，才使用 workspace-app 并放在 apps/<app>/ 下。
本地运行和检查
pnpm dev:shell
pnpm run validate
pnpm run local-audit
pnpm run doctorpnpm dev:shell 会启动生成的 Tauri shell。App 像正式分发的 App 一样，通过 in-app Runtime account login 认证。尚未准入的本地 App 必须使用 Developer Mode 和 Runtime developer registration gate。Scaffold 不会创建独立的 developer session，也不会绕过 Runtime account custody。
如果你只需要验证 SDK 是否能调用 Runtime-backed 文本生成，先读 第一次 AI 调用。
如果你要接入共享 UI、auth、shell、telemetry 或 model configuration，先读 在 App 中使用 Kit。
Scaffold 拥有什么
| 文件或命令 | 含义 |
|---|---|
nimi.app.yaml | 开发者提交的 manifest input，不是 admitted descriptor truth |
pnpm run init | 显式 scaffold activation 和 .nimi/{config,contracts,methodology} projection |
pnpm run doctor | Scaffold state、dependency alignment、managed glue 和 projection drift 检查 |
pnpm run update | 刷新 scaffold-managed glue，同时保留 app-owned product code |
pnpm run local-audit | 本地 pre-submission evidence，不是 platform admission |
Reference App
apps/tester/ 是 Nimi Lab developer reference app。它展示 Runtime authenticated shell、Kit workbench surfaces、AI capability lanes、app-owned history storage 和 local acceptance checks。把它当作 SDK、Kit、app-tools 与 Runtime auth integration 的参考，不要把它当成 platform admission truth。 阅读路径见 把 Tester 当作 Reference App 使用。