@h-ai/cli 0.1.0-alpha.20 → 0.1.0-alpha.21

package/templates/apps/mobile-app/messages/zh-CN.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://inlang.com/schema/inlang-message-format",
+  "app_title": "移动工作台",
+  "app_description": "基于 hai Agent Framework + Capacitor + Svelte 5 构建的移动应用",
+  "boot_failed_title": "启动失败",
+  "common_retry": "重试",
+  "common_refresh": "刷新",
+  "common_enabled": "已启用",
+  "common_disabled": "未启用",
+  "nav_home": "工作台",
+  "nav_tasks": "任务",
+  "nav_profile": "我的",
+  "hero_eyebrow": "Mobile Workspace",
+  "hero_title": "真正可用的移动端起点",
+  "hero_subtitle": "Capacitor 原生能力、安全 Token 存储、统一 API Client 与 @h-ai/ui 移动组件已经接好。",
+  "feature_native_title": "原生能力",
+  "feature_native_desc": "状态栏、安全区与设备信息就绪，可继续接入推送、相机等插件。",
+  "feature_api_title": "统一 API",
+  "feature_api_desc": "通过 PUBLIC_API_BASE 连接服务端，Token 在原生端走安全存储。",
+  "status_title": "运行状态",
+  "status_api_label": "API 地址",
+  "status_runtime_label": "运行环境",
+  "status_runtime_native": "原生 App",
+  "status_runtime_web": "浏览器预览",
+  "status_token_label": "Token 存储",
+  "status_token_native": "安全存储",
+  "status_token_memory": "内存存储",
+  "tasks_title": "今日任务",
+  "tasks_sync": "同步后端接口",
+  "tasks_polish": "打磨移动端体验",
+  "tasks_release": "准备原生打包",
+  "profile_title": "应用设置",
+  "profile_language": "语言跟随 Paraglide",
+  "profile_theme": "主题跟随 @h-ai/ui",
+  "profile_secure": "敏感 Token 不落 localStorage"
+}

package/templates/apps/mobile-app/src/App.svelte.hbs

@@ -0,0 +1,162 @@
+<script lang='ts'>
+  import { applyTheme, getSavedTheme, setGlobalLocale } from '@h-ai/ui'
+  import { onMount } from 'svelte'
+  import { closeApi, initApi, resolveApiBase, usesNativeTokenStorage } from './lib/api.js'
+  import { initCapacitor, isNativeApp } from './lib/capacitor.js'
+  import * as m from './lib/paraglide/messages.js'
+  import { getLocale } from './lib/paraglide/runtime.js'
+
+  type TabId = 'home' | 'tasks' | 'profile'
+
+  let booting = $state(true)
+  let bootError = $state<string | null>(null)
+  let activeTab = $state<TabId>('home')
+  let nativeRuntime = $state(false)
+  let nativeTokenStorage = $state(false)
+
+  const navItems = $derived([
+    { id: 'home', label: m.nav_home(), iconClass: 'icon-[tabler--layout-dashboard]' },
+    { id: 'tasks', label: m.nav_tasks(), iconClass: 'icon-[tabler--checkbox]' },
+    { id: 'profile', label: m.nav_profile(), iconClass: 'icon-[tabler--user-circle]' },
+  ])
+
+  async function bootstrap(): Promise<void> {
+    try {
+      applyTheme(getSavedTheme(), false)
+      setGlobalLocale(getLocale())
+      await initCapacitor()
+      await initApi()
+      nativeRuntime = await isNativeApp()
+      nativeTokenStorage = await usesNativeTokenStorage()
+    }
+    catch (error) {
+      bootError = error instanceof Error ? error.message : String(error)
+    }
+    finally {
+      booting = false
+    }
+  }
+
+  function handleTabChange(id: string): void {
+    if (id === 'home' || id === 'tasks' || id === 'profile')
+      activeTab = id
+  }
+
+  onMount(() => {
+    void bootstrap()
+
+    return () => {
+      void closeApi()
+    }
+  })
+</script>
+
+{#if booting}
+  <div class='hai-mobile-viewport'>
+    <div class='hai-mobile-shell max-w-lg'>
+      <div class='flex min-h-screen items-center justify-center'>
+        <span class='loading loading-spinner loading-lg'></span>
+      </div>
+    </div>
+  </div>
+{:else if bootError}
+  <div class='hai-mobile-viewport'>
+    <div class='hai-mobile-shell max-w-lg'>
+      <div class='flex min-h-screen flex-col items-center justify-center gap-3 p-6 text-center'>
+        <span class='icon-[tabler--alert-triangle] text-error text-4xl'></span>
+        <h1 class='text-lg font-bold'>{m.boot_failed_title()}</h1>
+        <p class='text-base-content/60 text-sm'>{bootError}</p>
+        <Button variant='primary' size='sm' onclick={() => location.reload()}>{m.common_retry()}</Button>
+      </div>
+    </div>
+  </div>
+{:else}
+  <div class='hai-mobile-viewport'>
+    <div class='hai-mobile-shell max-w-lg'>
+      <AppBar title={m.app_title()} safeArea fixed={false} class='bg-base-100/95 backdrop-blur border-base-content/8' />
+
+      <main class='hai-mobile-main'>
+        {#if activeTab === 'home'}
+          <section class='space-y-4 p-4 pb-6'>
+            <div class='bg-primary text-primary-content rounded-2xl p-5 shadow-sm'>
+              <p class='text-sm opacity-75'>{m.hero_eyebrow()}</p>
+              <h1 class='mt-1 text-2xl font-bold'>{m.hero_title()}</h1>
+              <p class='mt-2 text-sm opacity-80'>{m.hero_subtitle()}</p>
+            </div>
+
+            <div class='grid grid-cols-2 gap-3'>
+              <Card padding='sm' shadow='sm'>
+                <div class='flex flex-col gap-2'>
+                  <span class='icon-[tabler--device-mobile-code] text-primary text-2xl'></span>
+                  <span class='text-sm font-medium'>{m.feature_native_title()}</span>
+                  <span class='text-base-content/60 text-xs'>{m.feature_native_desc()}</span>
+                </div>
+              </Card>
+              <Card padding='sm' shadow='sm'>
+                <div class='flex flex-col gap-2'>
+                  <span class='icon-[tabler--api-app] text-primary text-2xl'></span>
+                  <span class='text-sm font-medium'>{m.feature_api_title()}</span>
+                  <span class='text-base-content/60 text-xs'>{m.feature_api_desc()}</span>
+                </div>
+              </Card>
+            </div>
+
+            <Card title={m.status_title()} shadow='sm'>
+              <div class='grid grid-cols-2 gap-3 text-sm'>
+                <div>
+                  <p class='text-base-content/50'>{m.status_api_label()}</p>
+                  <p class='font-medium break-all'>{resolveApiBase()}</p>
+                </div>
+                <div>
+                  <p class='text-base-content/50'>{m.status_runtime_label()}</p>
+                  <Badge variant={nativeRuntime ? 'success' : 'warning'} size='sm'>
+                    {nativeRuntime ? m.status_runtime_native() : m.status_runtime_web()}
+                  </Badge>
+                </div>
+                <div class='col-span-2'>
+                  <p class='text-base-content/50'>{m.status_token_label()}</p>
+                  <p class='font-medium'>{nativeTokenStorage ? m.status_token_native() : m.status_token_memory()}</p>
+                </div>
+              </div>
+            </Card>
+          </section>
+        {:else if activeTab === 'tasks'}
+          <section class='space-y-4 p-4 pb-6'>
+            <Card title={m.tasks_title()} shadow='sm'>
+              <div class='space-y-3'>
+                {#each [m.tasks_sync(), m.tasks_polish(), m.tasks_release()] as task (task)}
+                  <div class='bg-base-200 rounded-xl flex items-center gap-3 p-3'>
+                    <span class='icon-[tabler--circle-check] text-success text-xl'></span>
+                    <span class='text-sm font-medium'>{task}</span>
+                  </div>
+                {/each}
+              </div>
+            </Card>
+          </section>
+        {:else}
+          <section class='space-y-4 p-4 pb-6'>
+            <Card title={m.profile_title()} shadow='sm'>
+              <div class='space-y-3 text-sm'>
+                <div class='bg-base-200 rounded-xl p-3'>{m.profile_language()}</div>
+                <div class='bg-base-200 rounded-xl p-3'>{m.profile_theme()}</div>
+                <div class='bg-base-200 rounded-xl p-3'>{m.profile_secure()}</div>
+              </div>
+            </Card>
+          </section>
+        {/if}
+      </main>
+
+      <BottomNav
+        items={navItems}
+        active={activeTab}
+        onchange={handleTabChange}
+        safeArea
+        centered
+        maxWidth='lg'
+        class='border-base-content/8 shadow-[0_-12px_32px_rgba(15,23,42,0.08)]'
+      />
+    </div>
+  </div>
+{/if}
+
+<ToastContainer />

package/templates/apps/mobile-app/src/lib/api.ts.hbs

@@ -0,0 +1,54 @@
+/**
+ * {{projectName}} — API 客户端初始化。
+ * Web 预览仅使用内存 TokenStore；原生端使用 Capacitor 安全存储。
+ */
+import { apiClient } from '@h-ai/api-client'
+import { createCapacitorTokenStorage } from '@h-ai/capacitor'
+
+const DEFAULT_API_BASE = 'http://localhost:3000/api/v1'
+
+let initialized = false
+
+export function resolveApiBase(): string {
+  return import.meta.env.PUBLIC_API_BASE ?? DEFAULT_API_BASE
+}
+
+export async function usesNativeTokenStorage(): Promise<boolean> {
+  const { Capacitor } = await import('@capacitor/core')
+  return Capacitor.isNativePlatform()
+}
+
+async function createTokenStorage() {
+  if (await usesNativeTokenStorage())
+    return createCapacitorTokenStorage()
+
+  return apiClient.tokenStorage.memory()
+}
+
+export async function initApi(): Promise<void> {
+  if (initialized)
+    return
+
+  const initResult = await apiClient.init({
+    baseUrl: resolveApiBase(),
+    auth: {
+      storage: await createTokenStorage(),
+      refreshPath: '/auth/refresh',
+    },
+  })
+
+  if (!initResult.success)
+    throw new Error(initResult.error.message)
+
+  initialized = true
+}
+
+export async function closeApi(): Promise<void> {
+  if (!initialized)
+    return
+
+  await apiClient.close()
+  initialized = false
+}
+
+export { apiClient }

package/templates/apps/{android-app → mobile-app}/src/lib/capacitor.ts

@@ -1,13 +1,12 @@
 /**
- * Capacitor 初始化
- *
- * 在应用启动时调用，配置状态栏等原生能力。
+ * Capacitor 初始化。
  */
 import { capacitor } from '@h-ai/capacitor'
 
-/**
- * 初始化 Capacitor 原生能力
- */
+export async function isNativeApp(): Promise<boolean> {
+  return capacitor.isNative()
+}
+
 export async function initCapacitor(): Promise<void> {
   await capacitor.init()
 

package/templates/apps/mobile-app/src/main.ts.hbs

@@ -0,0 +1,11 @@
+import { mount } from 'svelte'
+import App from './App.svelte'
+import './app.css'
+
+const target = document.getElementById('app')
+if (!target)
+  throw new Error('Root element #app not found')
+
+const app = mount(App, { target })
+
+export default app

package/templates/base/.gitignore.hbs

@@ -0,0 +1,16 @@
+node_modules
+{{#unless isSvelteOnlyApp}}
+.svelte-kit
+{{/unless}}
+build
+dist
+android
+ios
+.env
+.env.*
+!.env.example
+*.log
+.DS_Store
+test-results/
+playwright-report/
+data/

package/templates/base/{eslint.config.js → eslint.config.js.hbs}

@@ -9,8 +9,11 @@ import antfu from '@antfu/eslint-config'
 export default antfu({
   formatters: true,
   ignores: [
+{{#unless isSvelteOnlyApp}}
     '**/.svelte-kit/**',
+{{/unless}}
     '**/build/**',
+    '**/dist/**',
     '**/*.d.ts',
     '**/project.inlang/**',
     '**/paraglide/**',
@@ -29,4 +32,4 @@ export default antfu({
     'no-console': 'error',
     'ts/no-explicit-any': 'error',
   },
-})
+})

package/templates/base/package.json.hbs

@@ -1,9 +1,9 @@
 {
   "name": "{{projectName}}",
-  "version": "0.1.0-alpha.20",
+  "version": "0.1.0-alpha.21",
   "private": true,
-  "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 'android-app'}}Android app built with hai Agent Framework{{/if_eq}}",
-  "keywords": ["hai", "sveltekit", "svelte5", "{{appType}}"],
+  "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",
   "scripts": {
@@ -11,54 +11,72 @@
     "paraglide:compile": "paraglide-js compile --project ./project.inlang --outdir ./src/lib/paraglide",
 {{/if}}
     "dev": "vite dev",
-    "build": "vite build",
+    "build": "{{#if hasI18n}}pnpm paraglide:compile && {{/if}}vite build",
     "preview": "vite preview",
-    "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
-    "typecheck": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+    "check": "{{#if hasI18n}}pnpm paraglide:compile && {{/if}}{{#if isSvelteOnlyApp}}svelte-check --tsconfig ./tsconfig.json{{else}}svelte-kit sync && svelte-check --tsconfig ./tsconfig.json{{/if}}",
+    "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": "{{#if hasI18n}}pnpm paraglide:compile && {{/if}}vitest run",
     "test:watch": "vitest",
     "test:e2e": "playwright test",
-    "clean": "rimraf .svelte-kit build .turbo"
+    "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 build && cap sync",
+    "cap:sync:android": "pnpm build && cap sync android",
+    "cap:sync:ios": "pnpm build && 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 build && cap sync android && cd android && gradlew.bat assembleDebug",
+    "cap:build:android:release": "pnpm build && cap sync android && cap build android --androidreleasetype APK",
+    "cap:build:ios": "pnpm build && cap sync ios && cap build ios"{{/if}}
   },
   "dependencies": {
-    "@h-ai/core": "^0.1.0-alpha.20",
-    "@h-ai/kit": "^0.1.0-alpha.20"{{#if hasUi}},
-    "@h-ai/ui": "^0.1.0-alpha.20"{{/if}}{{#if features.db}},
-    "@h-ai/reldb": "^0.1.0-alpha.20"{{/if}}{{#if features.cache}},
-    "@h-ai/cache": "^0.1.0-alpha.20"{{/if}}{{#if features.iam}},
-    "@h-ai/iam": "^0.1.0-alpha.20"{{/if}}{{#if features.crypto}},
-    "@h-ai/crypto": "^0.1.0-alpha.20"{{/if}}{{#if features.storage}},
-    "@h-ai/storage": "^0.1.0-alpha.20"{{/if}}{{#if features.ai}},
-    "@h-ai/ai": "^0.1.0-alpha.20"{{/if}}{{#if features.audit}},
-    "@h-ai/audit": "^0.1.0-alpha.20"{{/if}}{{#if features.reach}},
-    "@h-ai/reach": "^0.1.0-alpha.20"{{/if}}{{#if features.payment}},
-    "@h-ai/payment": "^0.1.0-alpha.20"{{/if}}{{#if features.vecdb}},
-    "@h-ai/vecdb": "^0.1.0-alpha.20"{{/if}}{{#if features.datapipe}},
-    "@h-ai/datapipe": "^0.1.0-alpha.20"{{/if}}{{#if features.scheduler}},
-    "@h-ai/scheduler": "^0.1.0-alpha.20"{{/if}}{{#if features.deploy}},
-    "@h-ai/deploy": "^0.1.0-alpha.20"{{/if}}{{#if features.api-client}},
-    "@h-ai/api-client": "^0.1.0-alpha.20"{{/if}}{{#if features.capacitor}},
-    "@h-ai/capacitor": "^0.1.0-alpha.20"{{/if}}{{#if isCapacitorApp}}{{#unless features.api-client}},
-    "@h-ai/api-client": "^0.1.0-alpha.20"{{/unless}}{{#unless features.capacitor}},
-    "@h-ai/capacitor": "^0.1.0-alpha.20"{{/unless}}{{/if}},
+  {{#if isSvelteOnlyApp}}
+    "@h-ai/api-client": "{{haiPackageSpecifier}}",
+    "@h-ai/capacitor": "{{haiPackageSpecifier}}",
+    "@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.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.deploy}},
+    "@h-ai/deploy": "{{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}},
     "zod": "^4.4.3"
+{{/if}}
   },
   "devDependencies": {
     "@antfu/eslint-config": "^9.0.0",
     "@playwright/test": "^1.60.0",
 {{#if isCapacitorApp}}
-  "@aparajita/capacitor-secure-storage": "^8.0.0",
+    "@aparajita/capacitor-secure-storage": "^8.0.0",
     "@capacitor/app": "^8.0.1",
-    "@capacitor/camera": "^8.0.2",
+    "@capacitor/camera": "^8.0.1",
     "@capacitor/cli": "^8.3.4",
     "@capacitor/core": "^8.3.4",
     "@capacitor/android": "^8.3.4",
     "@capacitor/device": "^8.0.1",
+    "@capacitor/ios": "^8.3.4",
     "@capacitor/preferences": "^8.0.1",
-    "@capacitor/push-notifications": "^8.0.2",
+    "@capacitor/push-notifications": "^8.0.1",
     "@capacitor/status-bar": "^8.0.1",
-    "@sveltejs/adapter-static": "^3.0.10",
 {{else}}
 {{#if_eq appType 'api'}}
     "@sveltejs/adapter-node": "^5.5.4",
@@ -66,13 +84,14 @@
     "@sveltejs/adapter-auto": "^7.0.1",
 {{/if_eq}}
 {{/if}}
+{{#unless isSvelteOnlyApp}}
     "@sveltejs/kit": "^2.61.1",
+{{/unless}}
     "@sveltejs/vite-plugin-svelte": "^7.1.2",
     "@types/node": "^25.9.1",
     "eslint": "^10.4.0",
     "eslint-plugin-format": "^2.0.1",
     "eslint-plugin-svelte": "^3.17.1",
-    "pino-pretty": "^13.1.3",
     "rimraf": "^6.1.3",
     "svelte": "^5.55.9",
     "svelte-check": "^4.4.8",

package/templates/base/playwright.config.ts

@@ -1,7 +1,34 @@
 import process from 'node:process'
 import { defineConfig } from '@playwright/test'
 
-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 测试配置
@@ -23,8 +50,8 @@ export default defineConfig({
   },
 
   webServer: {
-    command: 'pnpm build && pnpm preview --port 4173 --strictPort',
-    env: { HAI_E2E: '1' },
+    command: `pnpm build && pnpm preview --host ${previewHost} --port ${previewPort} --strictPort`,
+    env: { HAI_E2E: '1', BASE_URL: baseURL },
     url: baseURL,
     reuseExistingServer: false,
     timeout: 180_000,

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

@@ -0,0 +1,14 @@
+{{! @skipIfEmpty }}
+{{#if useCatalogProtocol}}
+shellEmulator: true
+
+trustPolicy: no-downgrade
+
+packages:
+  - .
+
+catalog:
+{{#each haiCatalogPackages}}
+  '{{@key}}': {{this}}
+{{/each}}
+{{/if}}

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

@@ -1,3 +1,5 @@
+{{! @skipIfEmpty }}
+{{#unless isSvelteOnlyApp}}
 /// <reference types="@sveltejs/kit" />
 {{#if hasUi}}
 import '@h-ai/ui/auto-import'
@@ -18,3 +20,4 @@ declare global {
 }
 
 export {}
+{{/unless}}

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

@@ -1,3 +1,5 @@
+{{! @skipIfEmpty }}
+{{#unless isSvelteOnlyApp}}
 <!doctype html>
 {{#if hasI18n}}
 {{#if isCapacitorApp}}
@@ -24,3 +26,4 @@
     <div style="display: contents">%sveltekit.body%</div>
   </body>
 </html>
+{{/unless}}

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

@@ -1,10 +1,13 @@
 /**
  * Svelte 配置
  */
+{{#unless isSvelteOnlyApp}}
 import process from 'node:process'
+{{/unless}}
 {{#if hasUi}}
 import { autoImportHaiUi } from '@h-ai/ui/auto-import'
 {{/if}}
+{{#unless isSvelteOnlyApp}}
 {{#if isCapacitorApp}}
 import adapter from '@sveltejs/adapter-static'
 {{else}}
@@ -14,8 +17,46 @@ import adapter from '@sveltejs/adapter-node'
 import adapter from '@sveltejs/adapter-auto'
 {{/if_eq}}
 {{/if}}
+{{/unless}}
 import { vitePreprocess } from '@sveltejs/vite-plugin-svelte'
 
+{{#if isSvelteOnlyApp}}
+/** @type {import('@sveltejs/vite-plugin-svelte').SvelteConfig} */
+const config = {
+  preprocess: [{{#if hasUi}}autoImportHaiUi(), {{/if}}vitePreprocess()],
+  compilerOptions: {
+    runes: true,
+  },
+}
+{{else}}
+const DEFAULT_E2E_ORIGINS = ['http://localhost:4173', 'http://127.0.0.1:4173']
+
+function resolveTrustedOrigins() {
+  if (process.env.HAI_E2E !== '1')
+    return []
+
+  const rawBaseUrl = process.env.BASE_URL ?? DEFAULT_E2E_ORIGINS[0]
+
+  try {
+    const url = new URL(rawBaseUrl)
+    const origins = new Set([url.origin])
+
+    if (url.hostname === 'localhost') {
+      url.hostname = '127.0.0.1'
+      origins.add(url.origin)
+    }
+    else if (url.hostname === '127.0.0.1') {
+      url.hostname = 'localhost'
+      origins.add(url.origin)
+    }
+
+    return [...origins]
+  }
+  catch {
+    return DEFAULT_E2E_ORIGINS
+  }
+}
+
 /** @type {import('@sveltejs/kit').Config} */
 const config = {
   preprocess: [{{#if hasUi}}autoImportHaiUi(), {{/if}}vitePreprocess()],
@@ -33,9 +74,7 @@ const config = {
     adapter: adapter(),
 {{/if}}
     csrf: {
-      trustedOrigins: process.env.HAI_E2E === '1'
-        ? ['http://localhost:4173', 'http://127.0.0.1:4173']
-        : [],
+      trustedOrigins: resolveTrustedOrigins(),
     },
     alias: {
       $components: './src/lib/components',
@@ -44,5 +83,6 @@ const config = {
     },
   },
 }
+{{/if}}
 
 export default config

package/templates/base/tests/scaffold.test.ts.hbs

@@ -20,10 +20,17 @@ describe('generated scaffold', () => {
     expect(pkg.scripts['test:e2e']).toBeDefined()
   })
 
+{{#if isSvelteOnlyApp}}
+  it('renders the Vite app shell entry', async () => {
+    const indexHtml = await readFile(join(rootDir, 'index.html'), 'utf-8')
+    expect(indexHtml).toContain('<div id="app"></div>')
+  })
+{{else}}
   it('renders the app shell locale marker', async () => {
     const appHtml = await readFile(join(rootDir, 'src/app.html'), 'utf-8')
     expect(appHtml).toContain('lang="{{#if hasI18n}}{{#if isCapacitorApp}}{{defaultLocale}}{{else}}%lang%{{/if}}{{else}}{{defaultLocale}}{{/if}}"')
   })
+{{/if}}
 {{#unless isCapacitorApp}}
 
   it('ships an application config loaded at startup', async () => {