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

package/templates/apps/fullstack/eslint.config.js

@@ -3,7 +3,6 @@ import antfu from '@antfu/eslint-config'
 export default antfu({
   formatters: true,
   ignores: [
-    '**/.svelte-kit/**',
     '**/build/**',
     '**/dist/**',
     '**/src/lib/paraglide/**',

package/templates/apps/fullstack/package.json.hbs

@@ -9,7 +9,10 @@
     "i18n:compile": "pnpm --filter {{fullstack.sharedPackageName}} paraglide:compile{{#each fullstack.frontendApps}} && pnpm --filter {{packageName}} paraglide:compile{{/each}}",
     "postinstall": "pnpm i18n:compile",
     "dev": "pnpm --filter {{fullstack.contractPackageName}} build && pnpm i18n:compile && pnpm --parallel --filter {{fullstack.servPackageName}}{{#each fullstack.frontendApps}} --filter {{packageName}}{{/each}} dev",
+    "compile": "pnpm typecheck && pnpm build",
     "build": "pnpm --filter {{fullstack.contractPackageName}} build && pnpm i18n:compile && pnpm -r --if-present build",
+    "package": "pnpm build{{#if fullstack.frontends.web}} && pnpm --filter {{projectName}}-web package{{/if}}{{#if fullstack.frontends.app}} && pnpm --filter {{projectName}}-app package{{/if}}{{#if fullstack.frontends.desktop}} && pnpm --filter {{projectName}}-desktop package{{/if}}",
+    "deploy": "pnpm package",
     "typecheck": "pnpm --filter {{fullstack.contractPackageName}} build && pnpm i18n:compile && pnpm -r --if-present typecheck",
     "lint": "pnpm -r --if-present lint",
     "test": "pnpm --filter {{fullstack.contractPackageName}} build && pnpm i18n:compile && pnpm -r --if-present test",
@@ -21,22 +24,20 @@
     "{{fullstack.sharedPackageName}}": "workspace:*"
   },
   "devDependencies": {
-    "@antfu/eslint-config": "{{fullstack.versions.antfuEslintConfig}}",
-    "@playwright/test": "{{fullstack.versions.playwright}}",
-    "@sveltejs/adapter-auto": "{{fullstack.versions.adapterAuto}}",
-    "@sveltejs/kit": "{{fullstack.versions.svelteKit}}",
-    "@sveltejs/vite-plugin-svelte": "{{fullstack.versions.sveltePlugin}}",
-    "@types/node": "{{fullstack.versions.nodeTypes}}",
-    "eslint": "{{fullstack.versions.eslint}}",
-    "eslint-plugin-format": "{{fullstack.versions.eslintPluginFormat}}",
-    "eslint-plugin-svelte": "{{fullstack.versions.eslintPluginSvelte}}",
-    "rimraf": "{{fullstack.versions.rimraf}}",
-    "svelte": "{{fullstack.versions.svelte}}",
-    "svelte-check": "{{fullstack.versions.svelteCheck}}",
-    "svelte-eslint-parser": "{{fullstack.versions.svelteEslintParser}}",
-    "tsup": "{{fullstack.versions.tsup}}",
-    "typescript": "{{fullstack.versions.typescript}}",
-    "vite": "{{fullstack.versions.vite}}",
-    "vitest": "{{fullstack.versions.vitest}}"
+    "@antfu/eslint-config": "{{fullstack.packageSpecifiers.antfuEslintConfig}}",
+    "@playwright/test": "{{fullstack.packageSpecifiers.playwright}}",
+    "@sveltejs/vite-plugin-svelte": "{{fullstack.packageSpecifiers.sveltePlugin}}",
+    "@types/node": "{{fullstack.packageSpecifiers.nodeTypes}}",
+    "eslint": "{{fullstack.packageSpecifiers.eslint}}",
+    "eslint-plugin-format": "{{fullstack.packageSpecifiers.eslintPluginFormat}}",
+    "eslint-plugin-svelte": "{{fullstack.packageSpecifiers.eslintPluginSvelte}}",
+    "rimraf": "{{fullstack.packageSpecifiers.rimraf}}",
+    "svelte": "{{fullstack.packageSpecifiers.svelte}}",
+    "svelte-check": "{{fullstack.packageSpecifiers.svelteCheck}}",
+    "svelte-eslint-parser": "{{fullstack.packageSpecifiers.svelteEslintParser}}",
+    "tsup": "{{fullstack.packageSpecifiers.tsup}}",
+    "typescript": "{{fullstack.packageSpecifiers.typescript}}",
+    "vite": "{{fullstack.packageSpecifiers.vite}}",
+    "vitest": "{{fullstack.packageSpecifiers.vitest}}"
   }
 }

package/templates/apps/fullstack/packages/{{projectName}}-contract/package.json.hbs

@@ -20,8 +20,8 @@
     "clean": "rimraf dist .turbo"
   },
   "dependencies": {
-    "@h-ai/api-contract": "{{fullstack.versions.apiContract}}",
-    "@h-ai/core": "{{fullstack.versions.core}}",
-    "zod": "{{fullstack.versions.zod}}"
+    "@h-ai/api-contract": "{{haiPackageSpecifier}}",
+    "@h-ai/core": "{{haiPackageSpecifier}}",
+    "zod": "{{fullstack.packageSpecifiers.zod}}"
   }
 }

package/templates/apps/fullstack/packages/{{projectName}}-serv/README.md.hbs

@@ -4,9 +4,12 @@
 
 ## 骨架说明
 
-- `src/server-app.ts`：服务装配入口，挂载健康检查、OpenAPI、docs 与 procedures。
+- `config/_core.yml`：应用元信息（名称 / 版本 / 环境 / 语言），启动时由 `core.config` 加载。
+- `config/_serv.yml`：服务端运行时设置（CORS 来源等）。
+- `src/index.ts`：进程入口，先 `core.init({ configDir: './config' })` 加载配置再启动监听。
+- `src/app-server.ts`：服务装配入口，挂载健康检查、OpenAPI、docs 与 procedures；应用名称 / 版本与 CORS 来源均取自上述配置。
 - `src/server/procedures/app-procedures.ts`：app 领域 procedures，对应 contract 中的 `app.info` / `app.echo` 路由。
-- `tests/server-app.test.ts`：通过 `ServerApp.request()` 验证健康检查与业务路由。
+- `tests/app-server.test.ts`：通过 `ServerApp.request()` 验证健康检查与业务路由。
 
 ## 开发
 

package/templates/apps/fullstack/packages/{{projectName}}-serv/config/_core.yml.hbs

@@ -0,0 +1,14 @@
+# =============================================================================
+# {{fullstack.servPackageName}} - 应用配置
+# =============================================================================
+#
+# 后端服务的应用级配置，由 core.config 在启动时加载。
+# 敏感信息请通过环境变量注入。
+# =============================================================================
+
+name: {{fullstack.servPackageName}}
+version: 0.1.0
+env: ${HAI_ENV:development}
+debug: ${HAI_DEBUG:false}
+
+defaultLocale: {{fullstack.i18n.baseLocale}}

package/templates/apps/fullstack/packages/{{projectName}}-serv/config/_serv.yml.hbs

@@ -0,0 +1,13 @@
+# =============================================================================
+# {{fullstack.servPackageName}} - Serv / HTTP 入口配置
+# =============================================================================
+#
+# HTTP 路由路径（apiPrefix / health / openapi / docs）由共享 contract
+# 统一定义，作为前后端唯一事实来源，因此不在此重复声明。
+# 本文件仅声明服务端运行时设置。
+# =============================================================================
+
+# CORS 允许的来源。
+# 开发环境放开为 *，生产环境应收敛为前端域名（如 https://app.example.com）。
+cors:
+  origin: ${HAI_CORS_ORIGIN:*}

package/templates/apps/fullstack/packages/{{projectName}}-serv/package.json.hbs

@@ -22,8 +22,8 @@
     "start": "node dist/index.js"
   },
   "dependencies": {
-    "@h-ai/core": "{{fullstack.versions.core}}",
-    "@h-ai/serv": "{{fullstack.versions.serv}}",
+    "@h-ai/core": "{{haiPackageSpecifier}}",
+    "@h-ai/serv": "{{haiPackageSpecifier}}",
     "{{fullstack.contractPackageName}}": "workspace:*"
   }
 }

package/templates/apps/fullstack/packages/{{projectName}}-serv/src/{server-app.ts.hbs → app-server.ts.hbs}

@@ -1,9 +1,21 @@
+import { core } from '@h-ai/core'
 import { serv } from '@h-ai/serv'
 import { APP_HTTP_ROUTES, ENABLED_FRONTENDS, {{fullstack.contractExportName}} } from '{{fullstack.contractPackageName}}'
 import { createServerProcedures } from './server/procedures/index.js'
 
 const STARTED_AT = new Date().toISOString()
 
+/** `_core.yml` 中的应用元信息（由 core.config 加载，未初始化时回退到默认值）。 */
+interface AppCoreConfig {
+  name?: string
+  version?: string
+}
+
+/** `_serv.yml` 中的服务端运行时设置。 */
+interface AppServConfig {
+  cors?: { origin?: string }
+}
+
 /** 应用侧最小 HTTP App 抽象；不把底层 Hono 类型暴露给项目代码。 */
 export interface ServerApp {
   readonly fetch: (request: Request) => Response | Promise<Response>
@@ -12,12 +24,20 @@ export interface ServerApp {
 
 /** 创建后端 HTTP App；与 @h-ai/serv 的 createApp 返回语义保持一致。 */
 export function createServerApp(): ServerApp {
+  // 配置来自 config/_core.yml 与 config/_serv.yml。
+  // 单元测试可不初始化 core，此时回退到内置默认值。
+  const coreConfig = core.config.get<AppCoreConfig>('core')
+  const servConfig = core.config.get<AppServConfig>('serv')
+  const appName = coreConfig?.name ?? '{{fullstack.servPackageName}}'
+  const appVersion = coreConfig?.version ?? '0.1.0'
+  const corsOrigin = servConfig?.cors?.origin ?? '*'
+
   return serv.createApp({
     contract: {{fullstack.contractExportName}},
     procedures: createServerProcedures({
       app: {
-        name: '{{fullstack.servPackageName}}',
-        version: '0.1.0',
+        name: appName,
+        version: appVersion,
         startedAt: STARTED_AT,
         frontends: [...ENABLED_FRONTENDS],
       },
@@ -34,7 +54,7 @@ export function createServerApp(): ServerApp {
     },
     middlewares: [{
       middleware: serv.cors({
-        origin: '*',
+        origin: corsOrigin,
         allowedHeaders: ['Authorization', 'Content-Type', 'X-Requested-With'],
       }),
     }],

package/templates/apps/fullstack/packages/{{projectName}}-serv/src/index.ts.hbs

@@ -1,7 +1,10 @@
 import process from 'node:process'
 import { core } from '@h-ai/core'
 import { serv } from '@h-ai/serv'
-import { createServerApp } from './server-app.js'
+import { createServerApp } from './app-server.js'
+
+// 加载 config/ 下的 _core.yml / _serv.yml 等配置文件（约定优于配置）
+core.init({ configDir: './config', logging: { level: 'info' } })
 
 const app = createServerApp()
 const port = process.env.PORT ? Number(process.env.PORT) : 3000

package/templates/apps/fullstack/packages/{{projectName}}-serv/tests/{server-app.test.ts.hbs → app-server.test.ts.hbs}

@@ -1,6 +1,6 @@
 import { APP_API_ROUTES } from '{{fullstack.contractPackageName}}'
 import { describe, expect, it } from 'vitest'
-import { createServerApp } from '../src/server-app.js'
+import { createServerApp } from '../src/app-server.js'
 
 describe('{{fullstack.servPackageName}}', () => {
   it('returns health status', async () => {

package/templates/apps/fullstack/packages/{{projectName}}-shared/package.json.hbs

@@ -29,16 +29,17 @@
     "clean": "rimraf .turbo src/lib/paraglide"
   },
   "dependencies": {
-    "@h-ai/api-client": "{{fullstack.versions.apiClient}}",
-    "@h-ai/ui": "{{fullstack.versions.ui}}",
+    "@h-ai/api-client": "{{haiPackageSpecifier}}",
+    "@h-ai/ui": "{{haiPackageSpecifier}}",
     "{{fullstack.contractPackageName}}": "workspace:*"
   },
   "devDependencies": {
-    "@inlang/paraglide-js": "{{fullstack.versions.inlangParaglide}}",
-    "@inlang/plugin-message-format": "{{fullstack.versions.inlangMessageFormat}}",
-    "svelte": "{{fullstack.versions.svelte}}",
-    "svelte-check": "{{fullstack.versions.svelteCheck}}",
-    "typescript": "{{fullstack.versions.typescript}}",
-    "vitest": "{{fullstack.versions.vitest}}"
+    "@inlang/paraglide-js": "{{fullstack.packageSpecifiers.inlangParaglide}}",
+    "@inlang/plugin-message-format": "{{fullstack.packageSpecifiers.inlangMessageFormat}}",
+    "svelte": "{{fullstack.packageSpecifiers.svelte}}",
+    "svelte-check": "{{fullstack.packageSpecifiers.svelteCheck}}",
+    "typescript": "{{fullstack.packageSpecifiers.typescript}}",
+    "vite": "{{fullstack.packageSpecifiers.vite}}",
+    "vitest": "{{fullstack.packageSpecifiers.vitest}}"
   }
 }

package/templates/apps/fullstack/packages/{{projectName}}-shared/src/index.ts.hbs

@@ -1,7 +1,7 @@
 export { default as AppShell } from './lib/components/AppShell.svelte'
 export { default as LanguageSwitcher } from './lib/components/LanguageSwitcher.svelte'
 export { default as ThemeSwitcher } from './lib/components/ThemeSwitcher.svelte'
-export { AVAILABLE_THEMES, themeStore } from './lib/stores/theme.svelte.js'
+export { AVAILABLE_THEMES, themeStore } from './lib/stores/theme-store.svelte.js'
 export type { AppInfo, FetchAppInfoOptions } from './lib/api/api-client.js'
 export { fetchAppInfo } from './lib/api/api-client.js'
 export * as messages from './lib/paraglide/messages.js'

package/templates/apps/fullstack/packages/{{projectName}}-shared/src/lib/api/api-client.ts.hbs

@@ -14,7 +14,7 @@ export interface FetchAppInfoOptions {
 
 export async function fetchAppInfo(options: FetchAppInfoOptions = {}): Promise<AppInfo> {
   const fetchFn = options.fetchFn ?? fetch
-  const baseUrl = options.baseUrl ?? DEFAULT_API_ORIGIN
+  const baseUrl = options.baseUrl ?? resolveDefaultApiOrigin()
   const clientName = options.clientName ?? '{{projectName}}-shared'
 
   const client = apiClient.create({{fullstack.contractExportName}})
@@ -37,6 +37,10 @@ export async function fetchAppInfo(options: FetchAppInfoOptions = {}): Promise<A
   }
 }
 
+function resolveDefaultApiOrigin(): string {
+  return import.meta.env.PUBLIC_API_BASE ?? DEFAULT_API_ORIGIN
+}
+
 function normalizeApiBaseUrl(value: string): string {
   const trimmed = trimTrailingSlash(value)
   return trimmed.endsWith(APP_HTTP_ROUTES.apiPrefix)

package/templates/apps/fullstack/packages/{{projectName}}-shared/src/lib/components/ThemeSwitcher.svelte.hbs

@@ -1,6 +1,6 @@
 <script lang="ts">
   import * as m from '../paraglide/messages.js'
-  import { AVAILABLE_THEMES, themeStore } from '../stores/theme.svelte.js'
+  import { AVAILABLE_THEMES, themeStore } from '../stores/theme-store.svelte.js'
 
   function handleChange(event: Event) {
     const target = event.target as HTMLSelectElement

package/templates/apps/fullstack/packages/{{projectName}}-shared/tsconfig.json.hbs

@@ -9,7 +9,7 @@
     "noEmit": true,
     "skipLibCheck": true,
     "strict": true,
-    "types": ["svelte"],
+    "types": ["svelte", "vite/client"],
     "verbatimModuleSyntax": true
   },
   "include": ["src/**/*", "src/**/*.svelte"],

package/templates/apps/fullstack/playwright.config.ts.hbs

@@ -1,6 +1,39 @@
 import process from 'node:process'
 import { defineConfig } from '@playwright/test'
 
+const defaultBaseURL = '{{#if fullstack.e2eFrontend}}http://127.0.0.1:{{fullstack.e2eFrontend.port}}{{else}}http://127.0.0.1:3000{{/if}}'
+const defaultServiceBaseURL = 'http://127.0.0.1:3000'
+const baseURL = process.env.BASE_URL || defaultBaseURL
+const frontendHost = resolveHostFromBaseUrl(baseURL, '127.0.0.1')
+const frontendPort = resolvePortFromBaseUrl(baseURL, '{{#if fullstack.e2eFrontend}}{{fullstack.e2eFrontend.port}}{{else}}3000{{/if}}')
+const serviceBaseURL = process.env.SERVICE_BASE_URL || defaultServiceBaseURL
+const serviceHost = resolveHostFromBaseUrl(serviceBaseURL, '127.0.0.1')
+const servicePort = resolvePortFromBaseUrl(serviceBaseURL, '3000')
+
+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
+  }
+}
+
 export default defineConfig({
   testDir: './e2e',
   fullyParallel: false,
@@ -10,7 +43,7 @@ export default defineConfig({
   reporter: 'list',
   timeout: 30_000,
   use: {
-    baseURL: '{{#if fullstack.e2eFrontend}}http://127.0.0.1:{{fullstack.e2eFrontend.port}}{{else}}http://127.0.0.1:3000{{/if}}',
+    baseURL,
     channel: 'chrome',
     trace: 'on-first-retry',
     screenshot: 'only-on-failure',
@@ -19,14 +52,18 @@ export default defineConfig({
     {
       name: '{{fullstack.servPackageName}}',
       command: 'pnpm --filter {{fullstack.servPackageName}} start',
-      url: 'http://127.0.0.1:3000/health',
+      env: {
+        HOST: serviceHost,
+        PORT: servicePort,
+      },
+      url: `${serviceBaseURL}/health`,
       reuseExistingServer: false,
       timeout: 120_000,
     }{{#if fullstack.e2eFrontend}},
     {
       name: '{{fullstack.e2eFrontend.packageName}}',
-      command: 'pnpm --filter {{fullstack.e2eFrontend.packageName}} preview',
-      url: 'http://127.0.0.1:{{fullstack.e2eFrontend.port}}',
+      command: `pnpm --filter {{fullstack.e2eFrontend.packageName}} exec vite preview --host ${frontendHost} --port ${frontendPort} --strictPort`,
+      url: baseURL,
       reuseExistingServer: false,
       timeout: 120_000,
     }{{/if}},

package/templates/apps/fullstack/pnpm-workspace.yaml.hbs

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

package/templates/apps/h5/messages/en-US.json

@@ -4,6 +4,8 @@
   "nav_home": "Home",
   "nav_discover": "Discover",
   "nav_profile": "Profile",
+  "page_home_title": "Home",
+  "page_home_desc": "Welcome to H5 App",
   "page_home_search": "Search...",
   "page_home_feature1": "Feature 1",
   "page_home_feature2": "Feature 2",
@@ -14,6 +16,7 @@
   "page_discover_title": "Discover",
   "page_discover_desc": "Explore more content.",
   "page_profile_title": "Profile",
+  "page_profile_desc": "Manage your personal information",
   "page_profile_username": "Username",
   "page_profile_login_hint": "Tap to login",
   "page_profile_info": "Personal Info",

package/templates/apps/h5/messages/zh-CN.json

@@ -4,6 +4,8 @@
   "nav_home": "首页",
   "nav_discover": "发现",
   "nav_profile": "我的",
+  "page_home_title": "首页",
+  "page_home_desc": "欢迎使用 H5 应用",
   "page_home_search": "搜索...",
   "page_home_feature1": "功能一",
   "page_home_feature2": "功能二",
@@ -14,6 +16,7 @@
   "page_discover_title": "发现",
   "page_discover_desc": "探索更多精彩内容。",
   "page_profile_title": "我的",
+  "page_profile_desc": "管理您的个人信息",
   "page_profile_username": "用户名",
   "page_profile_login_hint": "点击登录",
   "page_profile_info": "个人信息",

package/templates/apps/h5/src/routes/+layout.svelte.hbs

@@ -1,22 +1,38 @@
 {{!-- H5 应用根布局 --}}
-<script lang="ts">
+<script lang='ts'>
   /**
    * H5 应用根布局
    */
   import type { Snippet } from 'svelte'
-  import '../app.css'
 {{#if hasI18n}}
   import { browser } from '$app/environment'
-  import { setGlobalLocale } from '@h-ai/ui'
-  import { getLocale } from '$lib/paraglide/runtime.js'
+{{/if}}
+  import { resolve } from '$app/paths'
+  import { page } from '$app/state'
+{{#if hasI18n}}
   import * as m from '$lib/paraglide/messages'
+  import { getLocale } from '$lib/paraglide/runtime.js'
+  import { setGlobalLocale } from '@h-ai/ui'
 {{/if}}
+  import '../app.css'
 
   interface Props {
     children: Snippet
   }
 
-  let { children }: Props = $props()
+  const { children }: Props = $props()
+
+  const navItems = [
+{{#if hasI18n}}
+    { path: '/', label: m.nav_home(), icon: 'icon-[tabler--home]' },
+    { path: '/discover', label: m.nav_discover(), icon: 'icon-[tabler--compass]' },
+    { path: '/profile', label: m.nav_profile(), icon: 'icon-[tabler--user]' },
+{{else}}
+    { path: '/', label: '首页', icon: 'icon-[tabler--home]' },
+    { path: '/discover', label: '发现', icon: 'icon-[tabler--compass]' },
+    { path: '/profile', label: '我的', icon: 'icon-[tabler--user]' },
+{{/if}}
+  ] as const
 {{#if hasI18n}}
 
   if (browser) {
@@ -26,32 +42,17 @@
 {{/if}}
 </script>
 
-<div class="min-h-screen flex flex-col bg-base-200">
-  <main class="flex-1 pb-16">
+<div class='min-h-screen flex flex-col bg-base-200'>
+  <main class='flex-1 pb-16'>
     {@render children()}
   </main>
 
-  <nav class="btm-nav btm-nav-sm">
-    <a href="/" class="text-primary">
-{{#if hasI18n}}
-      <span class="btm-nav-label">{m.nav_home()}</span>
-{{else}}
-      <span class="btm-nav-label">首页</span>
-{{/if}}
-    </a>
-    <a href="/discover">
-{{#if hasI18n}}
-      <span class="btm-nav-label">{m.nav_discover()}</span>
-{{else}}
-      <span class="btm-nav-label">发现</span>
-{{/if}}
-    </a>
-    <a href="/profile">
-{{#if hasI18n}}
-      <span class="btm-nav-label">{m.nav_profile()}</span>
-{{else}}
-      <span class="btm-nav-label">我的</span>
-{{/if}}
-    </a>
+  <nav class='btm-nav btm-nav-sm'>
+    {#each navItems as item (item.path)}
+      <a href={resolve(item.path, {})} class:active={page.url.pathname === item.path} class:text-primary={page.url.pathname === item.path}>
+        <span class='{item.icon} size-5'></span>
+        <span class='btm-nav-label'>{item.label}</span>
+      </a>
+    {/each}
   </nav>
 </div>

package/templates/apps/h5/src/routes/+page.svelte.hbs

@@ -1,11 +1,12 @@
 {{!-- H5 首页 --}}
-<script lang="ts">
+<script lang='ts'>
   /**
    * H5 首页
    */
 {{#if hasI18n}}
   import * as m from '$lib/paraglide/messages'
 {{/if}}
+  import { Card } from '@h-ai/ui'
 </script>
 
 <svelte:head>
@@ -16,12 +17,22 @@
 {{/if}}
 </svelte:head>
 
-<section class="p-4">
+<section class='p-4 space-y-4'>
 {{#if hasI18n}}
-  <h1 class="text-2xl font-bold mb-4">{m.page_home_title()}</h1>
-  <p class="text-gray-600">{m.page_home_desc()}</p>
+  <h1 class='text-2xl font-black tracking-tight'>{m.page_home_title()}</h1>
+  <Card shadow='sm' class='bg-base-100'>
+    <div class='flex items-center gap-3'>
+      <span class='icon-[tabler--home] size-8 text-primary'></span>
+      <p class='text-base-content/70'>{m.page_home_desc()}</p>
+    </div>
+  </Card>
 {{else}}
-  <h1 class="text-2xl font-bold mb-4">首页</h1>
-  <p class="text-gray-600">欢迎使用 H5 应用</p>
+  <h1 class='text-2xl font-black tracking-tight'>首页</h1>
+  <Card shadow='sm' class='bg-base-100'>
+    <div class='flex items-center gap-3'>
+      <span class='icon-[tabler--home] size-8 text-primary'></span>
+      <p class='text-base-content/70'>欢迎使用 H5 应用</p>
+    </div>
+  </Card>
 {{/if}}
 </section>

package/templates/apps/h5/src/routes/discover/+page.svelte.hbs

@@ -1,11 +1,12 @@
 {{!-- 发现页面 --}}
-<script lang="ts">
+<script lang='ts'>
   /**
    * 发现页面
    */
 {{#if hasI18n}}
   import * as m from '$lib/paraglide/messages'
 {{/if}}
+  import { Card } from '@h-ai/ui'
 </script>
 
 <svelte:head>
@@ -16,12 +17,22 @@
 {{/if}}
 </svelte:head>
 
-<section class="p-4">
+<section class='p-4 space-y-4'>
 {{#if hasI18n}}
-  <h1 class="text-2xl font-bold mb-4">{m.page_discover_title()}</h1>
-  <p class="text-gray-600">{m.page_discover_desc()}</p>
+  <h1 class='text-2xl font-black tracking-tight'>{m.page_discover_title()}</h1>
+  <Card shadow='sm' class='bg-base-100'>
+    <div class='flex items-center gap-3'>
+      <span class='icon-[tabler--compass] size-8 text-primary'></span>
+      <p class='text-base-content/70'>{m.page_discover_desc()}</p>
+    </div>
+  </Card>
 {{else}}
-  <h1 class="text-2xl font-bold mb-4">发现</h1>
-  <p class="text-gray-600">探索更多精彩内容</p>
+  <h1 class='text-2xl font-black tracking-tight'>发现</h1>
+  <Card shadow='sm' class='bg-base-100'>
+    <div class='flex items-center gap-3'>
+      <span class='icon-[tabler--compass] size-8 text-primary'></span>
+      <p class='text-base-content/70'>探索更多精彩内容</p>
+    </div>
+  </Card>
 {{/if}}
 </section>

package/templates/apps/h5/src/routes/profile/+page.svelte.hbs

@@ -1,11 +1,12 @@
 {{!-- 个人中心页面 --}}
-<script lang="ts">
+<script lang='ts'>
   /**
    * 个人中心页面
    */
 {{#if hasI18n}}
   import * as m from '$lib/paraglide/messages'
 {{/if}}
+  import { Card } from '@h-ai/ui'
 </script>
 
 <svelte:head>
@@ -16,12 +17,22 @@
 {{/if}}
 </svelte:head>
 
-<section class="p-4">
+<section class='p-4 space-y-4'>
 {{#if hasI18n}}
-  <h1 class="text-2xl font-bold mb-4">{m.page_profile_title()}</h1>
-  <p class="text-gray-600">{m.page_profile_desc()}</p>
+  <h1 class='text-2xl font-black tracking-tight'>{m.page_profile_title()}</h1>
+  <Card shadow='sm' class='bg-base-100'>
+    <div class='flex items-center gap-3'>
+      <span class='icon-[tabler--user] size-8 text-primary'></span>
+      <p class='text-base-content/70'>{m.page_profile_desc()}</p>
+    </div>
+  </Card>
 {{else}}
-  <h1 class="text-2xl font-bold mb-4">我的</h1>
-  <p class="text-gray-600">管理您的个人信息</p>
+  <h1 class='text-2xl font-black tracking-tight'>我的</h1>
+  <Card shadow='sm' class='bg-base-100'>
+    <div class='flex items-center gap-3'>
+      <span class='icon-[tabler--user] size-8 text-primary'></span>
+      <p class='text-base-content/70'>管理您的个人信息</p>
+    </div>
+  </Card>
 {{/if}}
 </section>

package/templates/apps/mobile-app/.env.hbs

@@ -0,0 +1,3 @@
+# {{projectName}} — 环境变量
+# Android 模拟器使用 10.0.2.2 访问宿主机；真机请改为局域网 IP。
+PUBLIC_API_BASE=http://10.0.2.2:3000/api/v1

package/templates/apps/{android-app → mobile-app}/capacitor.config.ts.hbs

@@ -3,10 +3,10 @@ import type { CapacitorConfig } from '@capacitor/cli'
 const config: CapacitorConfig = {
   appId: 'com.hai.{{projectName}}',
   appName: '{{projectName}}',
-  webDir: 'build',
+  webDir: 'dist',
   server: {
     androidScheme: 'https',
   },
 }
 
-export default config
+export default config