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

package/templates/apps/fullstack/apps/{{projectName}}-app/src/App.svelte.hbs

@@ -0,0 +1,59 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.app}}
+<script lang="ts">
+  import { useToastFeedback } from '@h-ai/ui/toast'
+  import type { ManagementApiOptions } from '{{fullstack.sharedPackageName}}'
+  import { capacitor, createCapacitorTokenStorage } from '@h-ai/capacitor'
+  import { core } from '@h-ai/core'
+  import { ToastContainer } from '@h-ai/ui/components/compounds/index'
+  import { Button, Spinner } from '@h-ai/ui/components/primitives/index'
+  import { onMount } from 'svelte'
+  import { AdminWorkspace, messages } from '{{fullstack.sharedPackageName}}'
+{{#if features.feedback}}
+  import { buildMetadata } from './build-metadata.js'
+{{/if}}
+  import { initCapacitor } from './lib/capacitor.js'
+  import { setLocale } from './lib/paraglide/runtime.js'
+
+  let apiOptions = $state<ManagementApiOptions | null>(null)
+  let startupFailed = $state(false)
+  function syncLocale(locale: string) {
+    setLocale(locale as Parameters<typeof setLocale>[0], { reload: false })
+  }
+  async function initialize() {
+    startupFailed = false
+    const result = await initCapacitor()
+    if (!result.success) {
+      startupFailed = true
+      return
+    }
+    apiOptions = {
+      clientName: '{{projectName}}-app',
+      terminalType: 'app',
+      ...(capacitor.isNative() ? { requireApiBase: true, tokenStorage: createCapacitorTokenStorage(), headers: { 'X-HAI-Token-Transport': 'body' } } : {}),
+    }
+  }
+  onMount(() => {
+    void initialize()
+    return () => {
+      void capacitor.close().then((closed) => {
+        if (!closed.success)
+          core.logger.warn('Native listener cleanup failed; retry on next initialization')
+      })
+    }
+  })
+  useToastFeedback(() => startupFailed ? messages.operation_failed() : '')
+</script>
+
+{#if startupFailed}
+  <div class="mx-auto flex min-h-dvh max-w-md flex-col justify-center gap-4 p-6">
+    <p class="text-sm text-base-content/60">{messages.operation_failed()}</p>
+    <ToastContainer />
+    <Button onclick={() => void initialize()}>{messages.home_refresh()}</Button>
+  </div>
+{:else if apiOptions}
+  <AdminWorkspace platform="app" {apiOptions}{{#if features.feedback}} {buildMetadata}{{/if}} onLocaleChange={syncLocale} />
+{:else}
+  <div class="flex min-h-dvh items-center justify-center"><Spinner /></div>
+{/if}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-app/src/app.css.hbs

@@ -0,0 +1,20 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.app}}
+@import 'tailwindcss';
+@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';
+@source "../node_modules/@h-ai/ui/dist/**/*.{svelte,js,ts}";
+@source "../../../node_modules/@h-ai/ui/dist/**/*.{svelte,js,ts}";
+@source "../../../packages/{{fullstack.sharedPackageName}}/src/**/*.{svelte,js,ts}";
+
+@plugin "daisyui" {
+  themes:
+    {{#each fullstack.theme.themes}}{{this}}{{#if_eq this ../fullstack.theme.defaultTheme}} --default{{/if_eq}}{{#unless @last}},
+    {{/unless}}{{/each}};
+}
+@plugin "@iconify/tailwind4" {
+  prefixes: tabler;
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-app/src/app.d.ts.hbs

@@ -0,0 +1,8 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.app}}
+/// <reference types="vite/client" />
+
+import '@h-ai/ui/auto-import'
+
+declare module '*.css'
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-app/src/build-metadata.ts.hbs

@@ -0,0 +1,9 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.app}}
+{{#if features.feedback}}
+/** 当前应用编译时烘焙的产物身份；运行时配置不能覆盖。 */
+declare const __HAI_BUILD_METADATA__: { appVersion: string, buildId: string, commit: string }
+
+export const buildMetadata = __HAI_BUILD_METADATA__
+{{/if}}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-app/src/lib/capacitor.ts.hbs

@@ -0,0 +1,19 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.app}}
+import type { HaiResult } from '@h-ai/core'
+import { capacitor } from '@h-ai/capacitor'
+
+export async function initCapacitor(): Promise<HaiResult<void>> {
+  const result = await capacitor.init()
+  if (!result.success)
+    return result
+
+  if (capacitor.isNative()) {
+    return capacitor.statusBar.configure({
+      style: 'dark',
+      overlay: true,
+    })
+  }
+  return result
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-app/src/main.ts.hbs

@@ -0,0 +1,21 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.app}}
+{{#if features.feedback}}
+import { saveCapacitorFeedbackFile } from '@h-ai/feedback/capacitor'
+import { configureFeedbackSaving } from '@h-ai/feedback/client'
+{{/if}}
+import { mount } from 'svelte'
+import App from './App.svelte'
+import './app.css'
+
+{{#if features.feedback}}
+configureFeedbackSaving(saveCapacitorFeedbackFile)
+{{/if}}
+const target = document.getElementById('app')
+if (!target)
+  throw new Error('Root element #app not found')
+
+const app = mount(App, { target })
+
+export default app
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-app/svelte.config.js.hbs

@@ -0,0 +1,16 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.app}}
+import { autoImportHaiUi } from '@h-ai/ui/auto-import'
+import { vitePreprocess } from '@sveltejs/vite-plugin-svelte'
+
+/** @type {import('@sveltejs/vite-plugin-svelte').SvelteConfig} */
+const config = {
+  preprocess: [autoImportHaiUi(), vitePreprocess()],
+  compilerOptions: {
+    // 使用 Svelte 5 Runes，和 @h-ai/ui 组件库保持一致。
+    runes: true,
+  },
+}
+
+export default config
+{{/if}}

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

@@ -0,0 +1,23 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.app}}
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "moduleDetection": "force",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "types": ["svelte", "vite/client", "node", "vitest/globals"],
+    "allowJs": true,
+    "checkJs": false,
+    "strict": true,
+    "noEmit": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*.ts", "src/**/*.svelte", "tests/**/*.ts", "vite.config.ts", "svelte.config.js", "capacitor.config.ts"],
+  "exclude": ["node_modules", "dist", "build", "android", "ios"]
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-app/vite.config.ts.hbs

@@ -0,0 +1,74 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.app}}
+import type { Plugin } from 'vite'
+import process from 'node:process'
+import { fileURLToPath } from 'node:url'
+import { core } from '@h-ai/core'
+import { haiOptimizeExclude, haiPrebundledDeps } from '@h-ai/ui/vite'
+import { paraglideVitePlugin } from '@inlang/paraglide-js'
+import { svelte } from '@sveltejs/vite-plugin-svelte'
+import tailwindcss from '@tailwindcss/vite'
+import { defineConfig } from 'vitest/config'
+import { resolveBuildMetadata } from '../../scripts/build-metadata.js'
+
+const envDir = fileURLToPath(new URL('../../', import.meta.url))
+
+export default defineConfig(({ mode, command }) => {
+  const envResult = command === 'build' || process.env.HAI_E2E === '1' ? { success: true as const, data: {} as Record<string, string> } : core.config.loadEnvFiles({ mode, envDir })
+  if (!envResult.success)
+    throw new Error(envResult.error.message)
+  const env = envResult.data
+  Object.assign(process.env, env)
+  const buildMetadata = resolveBuildMetadata(fileURLToPath(new URL('.', import.meta.url)))
+  const metadataAsset: Plugin = {
+    name: 'hai-build-metadata',
+    generateBundle() {
+      this.emitFile({ type: 'asset', fileName: 'build-metadata.json', source: JSON.stringify(buildMetadata) })
+    },
+  }
+  const target = (env.PUBLIC_API_BASE || process.env.SERVICE_BASE_URL || 'http://127.0.0.1:3000').replace(/\/api\/v1\/?$/, '')
+  const proxy = { '/api': { target, changeOrigin: true } }
+  return {
+    base: './',
+    envDir: false,
+    define: { __HAI_BUILD_METADATA__: JSON.stringify(buildMetadata) },
+    server: { proxy },
+    preview: { proxy },
+    build: {
+      rolldownOptions: {
+        output: {
+          codeSplitting: {
+            groups: [
+              { name: 'vendor-ui', test: /node_modules\/(?:@h-ai\/ui|bits-ui|svelte)\// },
+              { name: 'vendor-crypto', test: /node_modules\/(?:@h-ai\/(?:core|crypto)|sm-crypto(?:-v2)?)\// },
+              { name: 'vendor-api', test: /node_modules\/(?:@orpc\/|zod\/)/ },
+            ],
+          },
+        },
+      },
+    },
+    plugins: [
+      metadataAsset,
+      svelte(),
+      paraglideVitePlugin({
+        project: './project.inlang',
+        outdir: './src/lib/paraglide',
+        strategy: ['cookie', 'baseLocale'],
+      }),
+      tailwindcss(),
+    ],
+    optimizeDeps: {
+      exclude: [...haiOptimizeExclude],
+      include: [...haiPrebundledDeps],
+    },
+    envPrefix: ['VITE_', 'PUBLIC_'],
+    ssr: {
+      noExternal: ['@h-ai/ui', /{{fullstack.sharedPackageName}}/],
+    },
+    test: {
+      environment: 'node',
+      include: ['tests/**/*.test.ts'],
+    },
+  }
+})
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/.env.example.hbs

@@ -0,0 +1,6 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+# {{projectName}}-desktop — 环境变量
+
+PUBLIC_API_BASE=http://localhost:3000
+{{/if}}

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

@@ -0,0 +1,64 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+# {{projectName}}-desktop
+
+## 简介
+
+桌面端工程，参考 `apps/desktop-app` 使用 Tauri v2 + Svelte 5 + Vite，前端通过共享 contract 调用 `{{fullstack.servPackageName}}`。
+
+## 核心功能清单
+
+- Tauri v2 桌面壳与共享管理界面。
+- 运行时配置 API 地址，无需按环境重复打包。
+- 原生令牌仅存内存，重启后重新登录。
+
+## 使用入门
+
+### i18n 与 shared 协同
+
+- 本端页面文案：`messages/{locale}.json` + `project.inlang/settings.json`
+- 共享 Shell/主题/语言/API：`packages/{{fullstack.sharedPackageName}}`
+- 个人设置保存语言与风格偏好到 IAM 元数据，并同步 shared 和本端 Paraglide runtime
+
+原生 Tauri 使用内存 TokenStorage，不将凭证写入磁盘；重启后需要重新登录。浏览器预览使用 httpOnly refresh Cookie。两种方式均经共享加密 API 客户端。`src-tauri/tauri.conf.json` 的资源与网络白名单应与部署的 API 地址同步。
+
+自定义建议：桌面端菜单、状态、快捷操作文案放在本目录 `messages/`；跨端通用能力放到 shared。
+
+### 编译、打包与部署
+
+```bash
+# 仅前端开发，默认端口 {{fullstack.ports.desktop}}
+pnpm --filter {{projectName}}-desktop dev
+
+# Tauri 桌面开发
+pnpm --filter {{projectName}}-desktop tauri:dev
+
+# 编译 WebView 前端产物到 dist/
+pnpm --filter {{projectName}}-desktop build
+
+# 在工程根打包桌面安装包；在对应系统构建 windows / linux / macos
+pnpm build --target desktop --platform windows --arch x64
+```
+
+打包前需要安装 Rust 工具链和 Tauri 平台依赖。构建不读取 .env.prod/.env.local；启动已安装程序前设置进程 PUBLIC_API_BASE（HTTP(S)，不含凭据、查询和片段）。Rust 会在页面加载前注入公开地址，仅将该 Origin 加入 CSP；不需要为 test/prod 重打安装包。缺省连接 http://localhost:3000/api/v1。
+
+### IAM 认证配置
+
+服务端 `config/_iam.yml` 统一控制登录、注册、重置、协议与 `ui` 品牌。邮件/短信可用 `_reach.yml` 中的 Provider/标准模板或自定义发送回调。`AuthPanel` 使用安全公开配置及框架认证动作；无需在页面适配 Token、验证码倒计时和错误提示。Memory 仅用于本地开发和显式测试；生产环境即使只有一个实例，也须使用框架支持的共享数据库与 Redis，并按工程根 README 配置写入路由和传输会话。
+
+LDAP/Reach 均可选：基础认证无需安装。默认 LDAP 客户端需在 IAM 服务端 workspace 安装 ldapts，再配置 login.ldap 与连接信息。自定义 onOtpSendEmail/onOtpSendSms/onPasswordResetRequest 回调可独立于 Reach 使用，投递失败须拒绝 Promise；回调第三参数 context 提供 expiresAt/idempotencyKey，发送服务按稳定键持久化去重，异常/超时为结果未知且不自动重发。协议在 Modal 显示；LoginForm/RegisterForm 提供 header/extraFields/footer，AuthPanel 透传 loginHeader/loginFields/loginFooter 和 registerHeader/registerFields/registerFooter。配置及例子见生成项目的 hai-iam/hai-ui skills。
+
+协议支持配置中的 userAgreementMarkdown/privacyPolicyMarkdown 正文及 URL；同主题优先 Markdown，由安全渲染器在弹窗显示。
+
+完整契约见生成应用的 `.agents/skills/hai-iam/reference.md`。
+
+启用反馈时使用 SDK 原生保存对话框，Tauri dialog/fs 插件只允许选择路径后写入。CSP 允许图片和视频 blob 预览、沙箱回放，脚本和网络来源限制保持明确；Web 浏览器验证不代替系统 WebView/安装包验收。
+
+## 开发测试
+
+从工程根执行 `pnpm typecheck`、`pnpm lint`、`pnpm build`、`pnpm test` 和 `pnpm test:e2e`。浏览器预览通过后，原生壳仍需在对应系统或设备单独验收。
+
+## 许可证
+
+Apache-2.0
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/eslint.config.js.hbs

@@ -0,0 +1,20 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+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: ['**/build/**', '**/dist/**', '**/*.d.ts', '**/project.inlang/**', '**/src/lib/paraglide/**'],
+  svelte: true,
+}, haiQualityConfig, {
+  files: ['**/*.svelte'],
+  rules: {
+    'svelte/html-quotes': 'off',
+    'svelte/indent': 'off',
+    'perfectionist/sort-imports': 'off',
+  },
+})
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/index.html.hbs

@@ -0,0 +1,20 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+<!doctype html>
+<html lang="{{fullstack.i18n.baseLocale}}" data-theme="{{fullstack.theme.defaultTheme}}">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{html fullstack.appName}}</title>
+    <link
+      rel="icon"
+      type="image/svg+xml"
+      href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Crect width='32' height='32' rx='8' fill='%234438df'/%3E%3Cpath d='M10 8v16M22 8v16M10 16h12' fill='none' stroke='white' stroke-width='3'/%3E%3C/svg%3E"
+    />
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="./src/main.ts"></script>
+  </body>
+</html>
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/messages/en-US.json.hbs

@@ -0,0 +1,7 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+{
+  "$schema": "https://inlang.com/schema/inlang-message-format",
+  "page_title": "{name}"
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/messages/ja-JP.json.hbs

@@ -0,0 +1,7 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+{
+  "$schema": "https://inlang.com/schema/inlang-message-format",
+  "page_title": "{name}"
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/messages/zh-CN.json.hbs

@@ -0,0 +1,7 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+{
+  "$schema": "https://inlang.com/schema/inlang-message-format",
+  "page_title": "{name}"
+}
+{{/if}}

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

@@ -0,0 +1,66 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+{
+  "engines": { "node": "^22.23.4 || ^24.22.1 || ^26.12.1" },
+  "name": "{{projectName}}-desktop",
+  "type": "module",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "paraglide:compile": "paraglide-js compile --project ./project.inlang --outdir ./src/lib/paraglide",
+    "paraglide:watch": "paraglide-js compile --project ./project.inlang --outdir ./src/lib/paraglide --watch",
+    "dev:test": "vite --mode test",
+    "dev:prod": "vite --mode prod",
+    "dev": "vite dev --host 127.0.0.1 --port {{fullstack.ports.desktop}}",
+    "compile": "pnpm paraglide:compile && vite build",
+    "build": "pnpm compile",
+    "package": "pnpm tauri:build",
+    "preview": "vite preview --host 127.0.0.1 --port {{fullstack.ports.desktop}} --strictPort",
+    "check": "pnpm typecheck",
+    "typecheck": "pnpm paraglide:compile && svelte-check --tsconfig ./tsconfig.json",
+    "lint": "eslint src vite.config.ts svelte.config.js",
+    "lint:fix": "eslint src vite.config.ts svelte.config.js --fix",
+    "test": "pnpm paraglide:compile && vitest run --passWithNoTests",
+    "test:watch": "pnpm paraglide:compile && vitest",
+    "clean": "rimraf dist .turbo src-tauri/target src/lib/paraglide",
+    "tauri": "tauri",
+    "tauri:dev": "tauri dev",
+    "tauri:build": "tauri build"
+  },
+  "dependencies": {
+    "@h-ai/api-client": "{{haiPackageSpecifier}}",
+    {{#if features.feedback}}
+    "@h-ai/feedback": "{{haiPackageSpecifier}}",
+    {{/if}}
+    "@h-ai/ui": "{{haiPackageSpecifier}}",
+    {{#if features.feedback}}
+    "@tauri-apps/plugin-dialog": "{{fullstack.packageSpecifiers.tauriDialog}}",
+    "@tauri-apps/plugin-fs": "{{fullstack.packageSpecifiers.tauriFs}}",
+    {{/if}}
+    "{{fullstack.sharedPackageName}}": "workspace:*"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "{{fullstack.packageSpecifiers.antfuEslintConfig}}",
+    "@h-ai/core": "{{haiPackageSpecifier}}",
+    "@iconify-json/tabler": "{{fullstack.packageSpecifiers.iconifyJsonTabler}}",
+    "@iconify/tailwind4": "{{fullstack.packageSpecifiers.iconifyTailwind}}",
+    "@inlang/paraglide-js": "{{fullstack.packageSpecifiers.inlangParaglide}}",
+    "@inlang/plugin-message-format": "{{fullstack.packageSpecifiers.inlangMessageFormat}}",
+    "@sveltejs/vite-plugin-svelte": "{{fullstack.packageSpecifiers.sveltePlugin}}",
+    "@tailwindcss/vite": "{{fullstack.packageSpecifiers.tailwindcssVite}}",
+    "@tauri-apps/cli": "{{fullstack.packageSpecifiers.tauriCli}}",
+    "bits-ui": "{{fullstack.packageSpecifiers.bitsUi}}",
+    "daisyui": "{{fullstack.packageSpecifiers.daisyui}}",
+    "eslint": "{{fullstack.packageSpecifiers.eslint}}",
+    "eslint-plugin-format": "{{fullstack.packageSpecifiers.eslintPluginFormat}}",
+    "eslint-plugin-svelte": "{{fullstack.packageSpecifiers.eslintPluginSvelte}}",
+    "svelte": "{{fullstack.packageSpecifiers.svelte}}",
+    "svelte-check": "{{fullstack.packageSpecifiers.svelteCheck}}",
+    "svelte-eslint-parser": "{{fullstack.packageSpecifiers.svelteEslintParser}}",
+    "tailwindcss": "{{fullstack.packageSpecifiers.tailwindcss}}",
+    "typescript": "{{fullstack.packageSpecifiers.typescript}}",
+    "vite": "{{fullstack.packageSpecifiers.vite}}",
+    "vitest": "{{fullstack.packageSpecifiers.vitest}}"
+  }
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/project.inlang/settings.json.hbs

@@ -0,0 +1,17 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+{
+  "$schema": "https://inlang.com/schema/project-settings",
+  "baseLocale": "{{fullstack.i18n.baseLocale}}",
+  "locales": [
+    {{#each fullstack.i18n.locales}}"{{this}}"{{#unless @last}},{{/unless}}
+    {{/each}}
+  ],
+  "modules": [
+    "../../node_modules/@inlang/plugin-message-format/dist/index.js"
+  ],
+  "plugin.inlang.messageFormat": {
+    "pathPattern": "./messages/{locale}.json"
+  }
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/src/App.svelte.hbs

@@ -0,0 +1,25 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+<script lang="ts">
+  import type { ManagementApiOptions } from '{{fullstack.sharedPackageName}}'
+  import { apiClient } from '@h-ai/api-client'
+  import { AdminWorkspace } from '{{fullstack.sharedPackageName}}'
+{{#if features.feedback}}
+  import { buildMetadata } from './build-metadata.js'
+{{/if}}
+  import { setLocale } from './lib/paraglide/runtime.js'
+
+  const native = '__TAURI_INTERNALS__' in globalThis
+  const apiOptions: ManagementApiOptions = {
+    clientName: '{{projectName}}-desktop',
+      terminalType: 'desktop',
+    ...(native ? { requireApiBase: true, tokenStorage: apiClient.tokenStorage.memory(), headers: { 'X-HAI-Token-Transport': 'body' } } : {}),
+  }
+
+  function syncLocale(locale: string) {
+    setLocale(locale as Parameters<typeof setLocale>[0], { reload: false })
+  }
+</script>
+
+<AdminWorkspace platform="desktop" {apiOptions}{{#if features.feedback}} {buildMetadata}{{/if}} onLocaleChange={syncLocale} />
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/src/app.css.hbs

@@ -0,0 +1,18 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+@import 'tailwindcss';
+@import '@h-ai/ui/styles/global.css';
+@import '@h-ai/ui/styles/theme.css';
+@source "../node_modules/@h-ai/ui/dist/**/*.{svelte,js,ts}";
+@source "../../../node_modules/@h-ai/ui/dist/**/*.{svelte,js,ts}";
+@source "../../../packages/{{fullstack.sharedPackageName}}/src/**/*.{svelte,js,ts}";
+
+@plugin "daisyui" {
+  themes:
+    {{#each fullstack.theme.themes}}{{this}}{{#if_eq this ../fullstack.theme.defaultTheme}} --default{{/if_eq}}{{#unless @last}},
+    {{/unless}}{{/each}};
+}
+@plugin "@iconify/tailwind4" {
+  prefixes: tabler;
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/src/app.d.ts.hbs

@@ -0,0 +1,8 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+/// <reference types="vite/client" />
+
+import '@h-ai/ui/auto-import'
+
+declare module '*.css'
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/src/build-metadata.ts.hbs

@@ -0,0 +1,9 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+{{#if features.feedback}}
+/** 当前应用编译时烘焙的产物身份；运行时配置不能覆盖。 */
+declare const __HAI_BUILD_METADATA__: { appVersion: string, buildId: string, commit: string }
+
+export const buildMetadata = __HAI_BUILD_METADATA__
+{{/if}}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/src/main.ts.hbs

@@ -0,0 +1,20 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+{{#if features.feedback}}
+import { configureFeedbackSaving } from '@h-ai/feedback/client'
+import { saveTauriFeedbackFile } from '@h-ai/feedback/tauri'
+{{/if}}
+import { mount } from 'svelte'
+import App from './App.svelte'
+import './app.css'
+
+{{#if features.feedback}}
+configureFeedbackSaving(saveTauriFeedbackFile)
+{{/if}}
+const target = document.getElementById('app')
+if (!target) {
+  throw new Error('Root element #app not found')
+}
+
+export default mount(App, { target })
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/src-tauri/Cargo.toml.hbs

@@ -0,0 +1,33 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+[package]
+name = "{{fullstack.nativeAppIdSegment}}_desktop"
+version = "0.1.0"
+description = "{{projectName}} Desktop App"
+authors = ["hai"]
+edition = "2021"
+
+[lib]
+name = "{{fullstack.nativeAppIdSegment}}_desktop_lib"
+crate-type = ["staticlib", "cdylib", "rlib"]
+
+[profile.release]
+opt-level = "z"
+lto = true
+codegen-units = 1
+panic = "abort"
+strip = true
+
+[build-dependencies]
+tauri-build = { version = "2.7.2", features = [] }
+
+[dependencies]
+{{#if features.feedback}}
+tauri-plugin-dialog = "2"
+tauri-plugin-fs = "2"
+{{/if}}
+tauri = { version = "2.12.3", features = [] }
+tauri-plugin-shell = "2.5.0"
+serde = { version = "1.0.229", features = ["derive"] }
+serde_json = "1.0.152"
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/src-tauri/build.rs.hbs

@@ -0,0 +1,6 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+fn main() {
+    tauri_build::build()
+}
+{{/if}}

package/templates/apps/fullstack/apps/{{projectName}}-desktop/src-tauri/capabilities/default.json.hbs

@@ -0,0 +1,16 @@
+{{! @skipIfEmpty }}
+{{#if fullstack.frontends.desktop}}
+{
+  "identifier": "default",
+  "description": "{{projectName}} Desktop 默认权限",
+  "windows": ["main"],
+  "permissions": [
+    "core:default",
+{{#if features.feedback}}
+    "dialog:allow-save",
+    "fs:allow-write-file",
+{{/if}}
+    "shell:allow-open"
+  ]
+}
+{{/if}}