@h-ai/cli 0.1.0-alpha9 → 1.0.0-beta.2

package/templates/base/eslint.config.js.hbs

@@ -0,0 +1,34 @@
+/**
+ * ESLint 配置
+ *
+ * @see https://github.com/antfu/eslint-config
+ */
+
+import antfu, { GLOB_SRC } from '@antfu/eslint-config'
+import { haiQualityConfig } from './eslint-rules.js'
+
+export default antfu({
+  // unused-imports 使用 TS 规则，JS 同样使用 TS parser 以保持 scope 契约一致。
+  typescript: { files: [GLOB_SRC] },
+  formatters: true,
+  ignores: [
+{{#unless isSvelteOnlyApp}}
+    '**/.svelte-kit/**',
+{{/unless}}
+    '**/build/**',
+    '**/dist/**',
+    '**/*.d.ts',
+    '**/project.inlang/**',
+    '**/paraglide/**',
+    '**/.agents/**',
+    '**/.claude/**',
+    '**/.github/**',
+    '**/AGENTS.md',
+    '**/CLAUDE.md',
+    '**/README.md',
+    '**/opencode.json',
+    '**/package.json',
+    '**/pnpm-workspace.yaml',
+  ],
+  svelte: true,
+}, haiQualityConfig)

package/templates/base/hai.json.hbs

@@ -0,0 +1,4 @@
+{
+  "build": { "images": [{ "name": "web", "dockerfile": "images/web.Dockerfile", "containerPort": {{#if isSvelteOnlyApp}}8080{{else}}3000{{/if}} }]{{#if isCapacitorApp}}, "app": ["."]{{/if}} }{{#if features.deploy}},
+  "deploy": {{{deploymentConfig}}}{{/if}}
+}

package/templates/base/images/web/nginx.conf.hbs

@@ -0,0 +1,24 @@
+{{! @skipIfEmpty }}
+{{#if isSvelteOnlyApp}}
+server {
+  listen 8080;
+  server_name _;
+  root /usr/share/nginx/html;
+
+  location / {
+    try_files $uri $uri/ /index.html;
+  }
+
+  location = /runtime-config.js {
+    alias /tmp/hai-runtime-config/runtime-config.js;
+    add_header Cache-Control "no-store";
+    default_type application/javascript;
+  }
+
+  location = /health {
+    access_log off;
+    add_header Content-Type text/plain;
+    return 200 'ok';
+  }
+}
+{{/if}}

package/templates/base/images/web.Dockerfile.hbs

@@ -0,0 +1,72 @@
+{{#if isSvelteOnlyApp}}
+FROM node:24.22.1-bookworm-slim AS build
+
+ENV PNPM_HOME=/pnpm
+ENV PATH=$PNPM_HOME:$PATH
+ENV CI=true
+ENV ONNXRUNTIME_NODE_INSTALL_CUDA=skip
+WORKDIR /workspace
+
+RUN corepack enable && corepack prepare pnpm@12.11.2 --activate && pnpm config set store-dir /pnpm/store
+COPY pnpm-lock.yaml pnpm-workspace.yaml ./
+COPY images/dependencies/ ./
+RUN --mount=type=cache,id={{projectName}}-pnpm,target=/pnpm/store pnpm fetch --ignore-scripts
+COPY . .
+RUN --mount=type=cache,id={{projectName}}-pnpm,target=/pnpm/store pnpm install --offline --frozen-lockfile --ignore-scripts
+ARG HAI_BUILD_ID=
+ARG HAI_BUILD_COMMIT=unknown
+ARG PUBLIC_BASE_PATH=
+RUN HAI_BUILD_ID="$HAI_BUILD_ID" HAI_BUILD_COMMIT="$HAI_BUILD_COMMIT" PUBLIC_BASE_PATH="$PUBLIC_BASE_PATH" pnpm compile
+
+FROM nginxinc/nginx-unprivileged:1.29.8-alpine AS runtime
+
+COPY --chmod=755 images/web/19-runtime-config.sh /docker-entrypoint.d/19-hai-runtime-config.sh
+COPY images/web/nginx.conf /etc/nginx/conf.d/default.conf
+COPY --from=build /workspace/dist /usr/share/nginx/html
+
+EXPOSE 8080
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
+  CMD wget -q -O /dev/null http://127.0.0.1:8080/health || exit 1
+{{else}}
+FROM node:24.22.1-bookworm-slim AS build
+ARG SQLITE_PREBUILD_MIRROR=
+ENV npm_config_better_sqlite3_binary_host_mirror=$SQLITE_PREBUILD_MIRROR
+
+ENV PNPM_HOME=/pnpm
+ENV PATH=$PNPM_HOME:$PATH
+ENV CI=true
+ENV ONNXRUNTIME_NODE_INSTALL_CUDA=skip
+WORKDIR /workspace
+
+RUN corepack enable && corepack prepare pnpm@12.11.2 --activate && pnpm config set store-dir /pnpm/store
+COPY pnpm-lock.yaml pnpm-workspace.yaml ./
+COPY images/dependencies/ ./
+RUN --mount=type=cache,id={{projectName}}-pnpm,target=/pnpm/store pnpm fetch --ignore-scripts
+COPY . .
+RUN --mount=type=cache,id={{projectName}}-pnpm,target=/pnpm/store pnpm install --offline --frozen-lockfile --ignore-scripts
+ARG HAI_BUILD_ID=
+ARG HAI_BUILD_COMMIT=unknown
+ARG PUBLIC_BASE_PATH=
+RUN HAI_BUILD_ID="$HAI_BUILD_ID" HAI_BUILD_COMMIT="$HAI_BUILD_COMMIT" PUBLIC_BASE_PATH="$PUBLIC_BASE_PATH" pnpm compile
+RUN --mount=type=cache,id={{projectName}}-sqlite,target=/root/.npm/_prebuilds if [ -d node_modules/better-sqlite3 ]; then cd node_modules/better-sqlite3; for attempt in 1 2 3; do node -e "require('node:child_process').execFileSync(process.execPath,[require.resolve('prebuild-install/bin.js'),'--verbose'],{stdio:'inherit'})" && break; [ "$attempt" = 3 ] && exit 1; sleep 3; done; fi
+RUN --mount=type=cache,id={{projectName}}-pnpm,target=/pnpm/store --mount=type=cache,id={{projectName}}-sqlite,target=/root/.npm/_prebuilds pnpm pm deploy --filter {{projectName}} --prod /prod/app
+
+FROM node:24.22.1-bookworm-slim AS runtime-base
+
+ARG PUBLIC_BASE_PATH=
+ENV PUBLIC_BASE_PATH=$PUBLIC_BASE_PATH
+ENV NODE_ENV=production
+ENV HOST=0.0.0.0
+ENV PORT=3000
+WORKDIR /app
+
+COPY --from=build --chown=node:node /prod/app ./
+RUN mkdir -p /app/data && chown node:node /app/data
+
+USER node
+EXPOSE 3000
+HEALTHCHECK --interval=30s --timeout=5s --start-period=15s --retries=3 \
+  CMD node -e "fetch('http://127.0.0.1:'+process.env.PORT+(process.env.PUBLIC_BASE_PATH||'')+'/').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"
+CMD ["node", "build"]
+
+{{/if}}

package/templates/base/package.json.hbs

@@ -1,67 +1,143 @@
 {
+  "engines": { "node": "^22.23.4 || ^24.22.1 || ^26.12.1" },
   "name": "{{projectName}}",
-  "version": "0.1.0-alpha9",
+  "version": "1.0.0-beta.2",
   "private": true,
+  "packageManager": "pnpm@12.11.2",
+  "description": "{{#if_eq appType 'admin'}}Enterprise management system built with hai Agent Framework{{/if_eq}}{{#if_eq appType 'website'}}Enterprise website built with hai Agent Framework{{/if_eq}}{{#if_eq appType 'h5'}}Mobile H5 app built with hai Agent Framework{{/if_eq}}{{#if_eq appType 'api'}}REST API service built with hai Agent Framework{{/if_eq}}{{#if_eq appType 'mobile-app'}}Mobile app built with hai Agent Framework{{/if_eq}}",
+  "keywords": ["hai", {{#unless isSvelteOnlyApp}}"sveltekit", {{/unless}}"svelte5", "{{appType}}"],
   "license": "Apache-2.0",
   "type": "module",
+{{#unless isSvelteOnlyApp}}
+  "files": [
+    "build",
+    "config",
+    "data",
+    "package.json"
+  ],
+{{/unless}}
   "scripts": {
+{{#if hasI18n}}
+    "paraglide:compile": "paraglide-js compile --project ./project.inlang --outdir ./src/lib/paraglide",
+{{/if}}
     "dev": "vite dev",
-    "build": "vite build",
+    "dev:test": "vite dev --mode test",
+    "dev:prod": "vite dev --mode prod",
+    "compile": "{{#if hasI18n}}pnpm paraglide:compile && {{/if}}vite build",
+    "build": "hai build",
+{{#if features.deploy}}
+    "deploy": "hai deploy",
+{{/if}}
+{{#unless isSvelteOnlyApp}}
+    "start": "node --env-file=.env --env-file=.env.prod --env-file-if-exists=.env.local build/index.js",
+    "start:test": "node --env-file=.env --env-file=.env.test --env-file-if-exists=.env.local build/index.js",
+    "start:prod": "pnpm start",
+{{/unless}}
     "preview": "vite preview",
-    "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+    "check": "pnpm typecheck",
+    "typecheck": "{{#if hasI18n}}pnpm paraglide:compile && {{/if}}{{#if isSvelteOnlyApp}}svelte-check --tsconfig ./tsconfig.json{{else}}svelte-kit sync && svelte-check --tsconfig ./tsconfig.json{{/if}}",
     "lint": "eslint .",
-    "test": "vitest run",
-    "test:e2e": "playwright test"
+    "lint:fix": "eslint . --fix",
+    "test": "{{#if hasI18n}}pnpm paraglide:compile && {{/if}}vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "node scripts/run-e2e.mjs",
+    "clean": "{{#if isSvelteOnlyApp}}rimraf dist build android ios .turbo src/lib/paraglide{{else}}rimraf .svelte-kit build .turbo{{/if}}"{{#if isCapacitorApp}},
+    "cap:add:android": "cap add android",
+    "cap:add:ios": "cap add ios",
+    "cap:sync": "pnpm compile && cap sync",
+    "cap:sync:android": "pnpm compile && cap sync android",
+    "cap:sync:ios": "pnpm compile && cap sync ios",
+    "cap:android": "cap open android",
+    "cap:ios": "cap open ios",
+    "cap:run:android": "cap run android",
+    "cap:run:ios": "cap run ios",
+    "cap:build:android:debug": "pnpm compile && cap sync android && cd android && gradlew.bat assembleDebug",
+    "cap:build:android:release": "pnpm compile && cap sync android && cap build android --androidreleasetype APK",
+    "cap:build:ios": "pnpm compile && cap sync ios && cap build ios"{{/if}}
   },
   "dependencies": {
-    "@h-ai/core": "^0.1.0-alpha9",
-    "@h-ai/kit": "^0.1.0-alpha9"{{#if hasUi}},
-    "@h-ai/ui": "^0.1.0-alpha9"{{/if}}{{#if features.db}},
-    "@h-ai/reldb": "^0.1.0-alpha9"{{/if}}{{#if features.cache}},
-    "@h-ai/cache": "^0.1.0-alpha9"{{/if}}{{#if features.iam}},
-    "@h-ai/iam": "^0.1.0-alpha9"{{/if}}{{#if features.crypto}},
-    "@h-ai/crypto": "^0.1.0-alpha9"{{/if}}{{#if features.storage}},
-    "@h-ai/storage": "^0.1.0-alpha9"{{/if}}{{#if features.ai}},
-    "@h-ai/ai": "^0.1.0-alpha9"{{/if}}{{#if features.audit}},
-    "@h-ai/audit": "^0.1.0-alpha9"{{/if}}{{#if features.reach}},
-    "@h-ai/reach": "^0.1.0-alpha9"{{/if}}{{#if features.payment}},
-    "@h-ai/payment": "^0.1.0-alpha9"{{/if}}{{#if features.vecdb}},
-    "@h-ai/vecdb": "^0.1.0-alpha9"{{/if}}{{#if features.datapipe}},
-    "@h-ai/datapipe": "^0.1.0-alpha9"{{/if}}{{#if features.scheduler}},
-    "@h-ai/scheduler": "^0.1.0-alpha9"{{/if}}{{#if features.deploy}},
-    "@h-ai/deploy": "^0.1.0-alpha9"{{/if}}{{#if features.api-client}},
-    "@h-ai/api-client": "^0.1.0-alpha9"{{/if}}{{#if features.capacitor}},
-    "@h-ai/capacitor": "^0.1.0-alpha9"{{/if}}{{#if isCapacitorApp}},
-    "@h-ai/api-client": "^0.1.0-alpha9",
-    "@h-ai/capacitor": "^0.1.0-alpha9"{{/if}},
-    "zod": "^3.23.0"
+    "pino-pretty": "{{versions.pinoPretty}}",
+  {{#if isSvelteOnlyApp}}
+    "@h-ai/api-client": "{{haiPackageSpecifier}}",
+    "@h-ai/capacitor": "{{haiPackageSpecifier}}",
+{{#if features.crypto}}
+    "@h-ai/crypto": "{{haiPackageSpecifier}}",
+{{/if}}
+    "@h-ai/ui": "{{haiPackageSpecifier}}"
+  {{else}}
+    "@h-ai/core": "{{haiPackageSpecifier}}",
+    "@h-ai/kit": "{{haiPackageSpecifier}}"{{#if hasUi}},
+    "@h-ai/ui": "{{haiPackageSpecifier}}"{{/if}}{{#if features.db}},
+    "@h-ai/reldb": "{{haiPackageSpecifier}}"{{/if}}{{#if features.cache}},
+    "@h-ai/cache": "{{haiPackageSpecifier}}"{{/if}}{{#if features.iam}},
+    "@h-ai/iam": "{{haiPackageSpecifier}}"{{/if}}{{#if features.crypto}},
+    "@h-ai/crypto": "{{haiPackageSpecifier}}"{{/if}}{{#if features.storage}},
+    "@h-ai/storage": "{{haiPackageSpecifier}}"{{/if}}{{#if features.ai}},
+    "@h-ai/ai": "{{haiPackageSpecifier}}"{{/if}}{{#if features.audit}},
+    "@h-ai/audit": "{{haiPackageSpecifier}}"{{/if}}{{#if features.reach}},
+    "@h-ai/reach": "{{haiPackageSpecifier}}"{{/if}}{{#if features.feedback}},
+    "@h-ai/feedback": "{{haiPackageSpecifier}}"{{/if}}{{#if features.payment}},
+    "@h-ai/payment": "{{haiPackageSpecifier}}"{{/if}}{{#if features.vecdb}},
+    "@h-ai/vecdb": "{{haiPackageSpecifier}}"{{/if}}{{#if features.datapipe}},
+    "@h-ai/datapipe": "{{haiPackageSpecifier}}"{{/if}}{{#if features.scheduler}},
+    "@h-ai/scheduler": "{{haiPackageSpecifier}}"{{/if}}{{#if features.api-client}},
+    "@h-ai/api-client": "{{haiPackageSpecifier}}"{{/if}}{{#if features.capacitor}},
+    "@h-ai/capacitor": "{{haiPackageSpecifier}}"{{/if}}{{#if isCapacitorApp}}{{#unless features.api-client}},
+    "@h-ai/api-client": "{{haiPackageSpecifier}}"{{/unless}}{{#unless features.capacitor}},
+    "@h-ai/capacitor": "{{haiPackageSpecifier}}"{{/unless}}{{/if}},
+    "sm-crypto": "0.5.7",
+    "zod": "{{versions.zod}}"
+{{/if}}
   },
   "devDependencies": {
-    "@playwright/test": "^1.50.0",
+{{#if features.deploy}}
+    "@h-ai/deploy": "{{haiPackageSpecifier}}",
+{{/if}}
+    "@h-ai/cli": "{{haiPackageSpecifier}}",
+{{#if isSvelteOnlyApp}}
+    "@h-ai/core": "{{haiPackageSpecifier}}",
+{{/if}}
+    "@antfu/eslint-config": "{{versions.antfuEslintConfig}}",
+    "@playwright/test": "{{versions.playwright}}",
 {{#if isCapacitorApp}}
-    "@capacitor/cli": "^7.0.0",
-    "@capacitor/core": "^7.0.0",
-    "@capacitor/android": "^7.0.0",
-    "@capacitor/preferences": "^7.0.0",
-    "@sveltejs/adapter-static": "^3.0.0",
+    "@aparajita/capacitor-secure-storage": "{{versions.capacitorSecureStorage}}",
+    "@capacitor/app": "{{versions.capacitorApp}}",
+    "@capacitor/camera": "{{versions.capacitorCamera}}",
+    "@capacitor/cli": "{{versions.capacitorCli}}",
+    "@capacitor/core": "{{versions.capacitorCore}}",
+    "@capacitor/android": "{{versions.capacitorAndroid}}",
+    "@capacitor/device": "{{versions.capacitorDevice}}",
+    "@capacitor/ios": "{{versions.capacitorIos}}",
+    "@capacitor/preferences": "{{versions.capacitorPreferences}}",
+    "@capacitor/push-notifications": "{{versions.capacitorPushNotifications}}",
+    "@capacitor/status-bar": "{{versions.capacitorStatusBar}}",
 {{else}}
-    "@sveltejs/adapter-auto": "^3.0.0",
+    "@sveltejs/adapter-node": "{{versions.svelteAdapterNode}}",
+{{#if_eq appType 'website'}}
+    "@sveltejs/adapter-static": "{{versions.svelteAdapterStatic}}",
+{{/if_eq}}
 {{/if}}
-    "@sveltejs/kit": "^2.0.0",
-    "@sveltejs/vite-plugin-svelte": "^4.0.0",
-    "@types/node": "^22.0.0",
-    "rimraf": "^6.0.0",
-    "svelte": "^5.0.0",
-    "svelte-check": "^4.0.0",
-    "typescript": "^5.7.0",
-    "vite": "^6.0.0",
-    "vitest": "^2.0.0"{{#if hasUi}},
-    "@tailwindcss/vite": "^4.0.0",
-    "tailwindcss": "^4.0.0",
-    "daisyui": "^5.0.0",
-    "@iconify-json/tabler": "^1.2.0",
-    "@iconify/tailwind4": "^1.0.0"{{/if}}{{#if hasI18n}},
-    "@inlang/paraglide-js": "^2.0.0",
-    "@inlang/plugin-message-format": "^5.0.0"{{/if}}
+{{#unless isSvelteOnlyApp}}
+    "@sveltejs/kit": "{{versions.svelteKit}}",
+{{/unless}}
+    "@sveltejs/vite-plugin-svelte": "{{versions.sveltePlugin}}",
+    "@types/node": "{{versions.nodeTypes}}",
+    "eslint": "{{versions.eslint}}",
+    "eslint-plugin-format": "{{versions.eslintPluginFormat}}",
+    "eslint-plugin-svelte": "{{versions.eslintPluginSvelte}}",
+    "rimraf": "{{versions.rimraf}}",
+    "svelte": "{{versions.svelte}}",
+    "svelte-check": "{{versions.svelteCheck}}",
+    "svelte-eslint-parser": "{{versions.svelteEslintParser}}",
+    "typescript": "{{versions.typescript}}",
+    "vite": "{{versions.vite}}",
+    "vitest": "{{versions.vitest}}"{{#if hasUi}},
+    "@tailwindcss/vite": "{{versions.tailwindcssVite}}",
+    "tailwindcss": "{{versions.tailwindcss}}",
+    "daisyui": "{{versions.daisyui}}",
+    "@iconify-json/tabler": "{{versions.iconifyJsonTabler}}",
+    "@iconify/tailwind4": "{{versions.iconifyTailwind}}"{{/if}}{{#if hasI18n}},
+    "@inlang/paraglide-js": "{{versions.inlangParaglide}}",
+    "@inlang/plugin-message-format": "{{versions.inlangMessageFormat}}"{{/if}}
   }
 }

package/templates/base/playwright.config.ts

@@ -1,16 +1,44 @@
 import process from 'node:process'
 import { defineConfig } from '@playwright/test'
+import { createE2eNotificationEnv, createE2eServerEnv, createE2eTransportRing } from './scripts/e2e-env.js'
 
-const baseURL = process.env.BASE_URL || 'http://localhost:4173'
+const DEFAULT_BASE_URL = 'http://localhost:4173'
+const baseURL = process.env.BASE_URL || DEFAULT_BASE_URL
+const previewHost = resolveHostFromBaseUrl(baseURL, 'localhost')
+const previewPort = resolvePortFromBaseUrl(baseURL, '4173')
+
+function resolveHostFromBaseUrl(urlString: string, fallbackHost: string): string {
+  try {
+    const url = new URL(urlString)
+    return url.hostname || fallbackHost
+  }
+  catch {
+    return fallbackHost
+  }
+}
+
+function resolvePortFromBaseUrl(urlString: string, fallbackPort: string): string {
+  try {
+    const url = new URL(urlString)
+    if (url.port) {
+      return url.port
+    }
+
+    return url.protocol === 'https:' ? '443' : '80'
+  }
+  catch {
+    return fallbackPort
+  }
+}
 
 /**
  * Playwright E2E 测试配置
  */
 export default defineConfig({
   testDir: './e2e',
-  fullyParallel: false,
+  fullyParallel: true,
   forbidOnly: !!process.env.CI,
-  retries: process.env.CI ? 2 : 0,
+  retries: 0,
   workers: 2,
   reporter: 'list',
   timeout: 30_000,
@@ -18,13 +46,23 @@ export default defineConfig({
   use: {
     baseURL,
     channel: 'chrome',
-    trace: 'on-first-retry',
+    trace: 'retain-on-failure',
     screenshot: 'only-on-failure',
   },
 
   webServer: {
-    command: 'pnpm build && pnpm preview --port 4173 --strictPort',
-    env: { HAI_E2E: '1' },
+    command: `pnpm build && pnpm preview --host ${previewHost} --port ${previewPort} --strictPort`,
+    env: createE2eServerEnv({
+      ...createE2eNotificationEnv(),
+      HAI_CORE_ENV: 'test',
+      BASE_URL: baseURL,
+      PUBLIC_API_BASE: process.env.PUBLIC_API_BASE || '',
+      HAI_DB: JSON.stringify({ type: 'sqlite', database: `${process.env.HAI_E2E_DATA_ROOT}/app.db` }),
+      HAI_CACHE: JSON.stringify({ type: 'memory' }),
+      HAI_STORAGE: JSON.stringify({ type: 'local', root: `${process.env.HAI_E2E_DATA_ROOT}/uploads` }),
+      HAI_VECDB: JSON.stringify({ type: 'lancedb', path: `${process.env.HAI_E2E_DATA_ROOT}/vecdb` }),
+      HAI_CRYPTO_TRANSPORT_SERVERKEYRING: createE2eTransportRing(),
+    }),
     url: baseURL,
     reuseExistingServer: false,
     timeout: 180_000,

package/templates/base/pnpm-workspace.yaml.hbs

@@ -0,0 +1,40 @@
+{{! @skipIfEmpty }}
+{{#if useCatalogProtocol}}
+shellEmulator: true
+
+trustPolicy: no-downgrade
+# 上游构建工具仍要求 4.x；4.0.3 tarball 已核对原 lockfile 的 SHA-512。
+trustPolicyExclude:
+  - chokidar@4.0.3
+
+# pnpm 12 配置；原生依赖仅运行明确列出的安装脚本。
+nodeLinker: hoisted
+allowBuilds:
+  cpu-features: true
+  onnxruntime-node: true
+  protobufjs: true
+  ssh2: true
+  vue-demi: true
+  better-sqlite3: true
+  esbuild: true
+  core-js: false
+
+overrides:
+  "@ai-sdk/provider-utils@>=4.0.0 <4.0.33": 4.0.57
+  cookie@<0.7.0: 0.7.2
+  esbuild@<0.28.1: 0.28.2
+  katex@<0.18.2: 0.18.10
+  sharp@<0.35.5: 0.35.5
+  tinypool@<2.1.2: 2.2.0
+  '@qdrant/js-client-rest>undici': 7.30.0
+  xcode>uuid: 11.1.1
+  "@types/node": "{{versions.nodeTypes}}"
+
+packages:
+  - .
+
+catalog:
+{{#each haiCatalogPackages}}
+  '{{@key}}': {{this}}
+{{/each}}
+{{/if}}

package/templates/base/src/app.css.hbs

@@ -0,0 +1,40 @@
+{{! @skipIfEmpty }}
+{{#if hasUi}}
+/* ─── Tailwind CSS v4 ─── */
+@import 'tailwindcss';
+
+/* ─── @h-ai/ui 共享样式 ─── */
+@import '@h-ai/ui/styles/global.css';
+@import '@h-ai/ui/styles/theme.css';
+@import '@h-ai/ui/styles/design-tokens.css';
+@import '@h-ai/ui/styles/mobile.css';
+
+/* ─── 扫描 @h-ai/ui 组件中使用的 Tailwind 类名 ─── */
+@source "../node_modules/@h-ai/ui/dist/**/*.{svelte,js,ts}";
+@source "../../../node_modules/@h-ai/ui/dist/**/*.{svelte,js,ts}";
+
+/* ─── DaisyUI 主题 ─── */
+@plugin "daisyui" {
+  themes:
+    light --default,
+    dark --prefersdark,
+    cupcake,
+    emerald,
+    corporate,
+    nord,
+    lofi,
+    winter,
+    dracula,
+    night,
+    dim,
+    business,
+    sunset,
+    luxury,
+    coffee;
+}
+
+/* ─── 图标 ─── */
+@plugin "@iconify/tailwind4" {
+  prefixes: tabler;
+}
+{{/if}}

package/templates/base/src/app.d.ts.hbs

@@ -1,7 +1,19 @@
+{{! @skipIfEmpty }}
+{{#unless isSvelteOnlyApp}}
 /// <reference types="@sveltejs/kit" />
-
+{{#if hasUi}}
+import '@h-ai/ui/auto-import'
+{{/if}}
 declare global {
+{{#if_eq appType 'website'}}
+  /** 编译期静态展示开关，不包含私有运行环境。 */
+  const __HAI_BUILD_STATIC__: boolean
+{{/if_eq}}
   namespace App {
+    interface PageData {
+      /** 经服务端 core 解析后可公开的应用配置 */
+      appConfig: Pick<import('@h-ai/core').CoreConfig, 'name' | 'version' | 'env' | 'defaultLocale'>
+    }
     interface Locals {
       /** 请求 ID */
       requestId: string
@@ -16,3 +28,4 @@ declare global {
 }
 
 export {}
+{{/unless}}

package/templates/base/src/app.html.hbs

@@ -1,6 +1,12 @@
+{{! @skipIfEmpty }}
+{{#unless isSvelteOnlyApp}}
 <!doctype html>
 {{#if hasI18n}}
+{{#if isCapacitorApp}}
+<html lang="{{defaultLocale}}">
+{{else}}
 <html lang="%lang%">
+{{/if}}
 {{else}}
 <html lang="{{defaultLocale}}">
 {{/if}}
@@ -8,9 +14,16 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <link rel="icon" href="%sveltekit.assets%/favicon.png" />
+    <script>
+      ;(function () {
+        const theme = localStorage.getItem('theme') || 'light'
+        document.documentElement.setAttribute('data-theme', theme)
+      })()
+    </script>
     %sveltekit.head%
   </head>
   <body data-sveltekit-preload-data="hover">
     <div style="display: contents">%sveltekit.body%</div>
   </body>
 </html>
+{{/unless}}