@h-ai/cli 0.1.0-alpha.65 → 0.1.0-alpha.67

package/dist/index.js

@@ -1,40 +1,42 @@
 #!/usr/bin/env node
-import { generateConfigFile, runtimeEnvironmentVariables, renderEnvironment, moduleEnvironmentVariables, parameterizeConfig } from './chunk-47V5OT22.js';
-import { cliM } from './chunk-IPG3QNYK.js';
+import { generateConfigFile, runtimeEnvironmentVariables, renderEnvironment, moduleEnvironmentVariables, parameterizeConfig } from './chunk-7DSURTJ4.js';
+import { cliM } from './chunk-AOQ4N657.js';
 import './chunk-2H7UOFLK.js';
-import process3 from 'process';
+import process4 from 'process';
 import { cac } from 'cac';
 import chalk from 'chalk';
-import path2, { resolve, join } from 'path';
+import path2, { resolve, join, dirname, relative } from 'path';
 import { fileURLToPath, pathToFileURL } from 'url';
 import { wrapAnsi } from 'fast-wrap-ansi';
 import fse from 'fs-extra';
 import Handlebars2 from 'handlebars';
-import { core } from '@h-ai/core';
 import ora from 'ora';
 import prompts from 'prompts';
 import { Buffer } from 'buffer';
-import { execSync, execFileSync } from 'child_process';
-import { randomBytes } from 'crypto';
-import { stringify, parseDocument } from 'yaml';
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { execSync, execFileSync, spawn } from 'child_process';
+import { randomBytes, createHash } from 'crypto';
+import { stringify, parseDocument, isScalar, isMap } from 'yaml';
+import { readFileSync, existsSync, mkdirSync, mkdtempSync, createReadStream, writeFileSync, renameSync, rmSync, readdirSync, copyFileSync } from 'fs';
 import { createRequire } from 'module';
+import { core } from '@h-ai/core';
 
 var CAMEL_CASE_SEPARATOR_REGEX = /[-_\s]+(.)?/g;
 var LEADING_CHAR_REGEX = /^./;
 function writeCliMessage(message) {
-  process3.stdout.write(`${message}
+  process4.stdout.write(`${message}
 `);
 }
 function writeCliError(message, error) {
-  process3.stderr.write(`${message}
+  process4.stderr.write(`${message}
 `);
+  if (error && typeof error === "object" && "error" in error)
+    error = error.error;
   if (error !== void 0)
-    process3.stderr.write(`${error instanceof Error ? error.message : String(error)}
+    process4.stderr.write(`${error instanceof Error ? error.message : String(error)}
 `);
 }
 function formatPromptDescription(description) {
-  return wrapAnsi(description, Math.max(1, (process3.stdout.columns || 80) - 32), { hard: true });
+  return wrapAnsi(description, Math.max(1, (process4.stdout.columns || 80) - 32), { hard: true });
 }
 function toCamelCase(str) {
   return str.replace(CAMEL_CASE_SEPARATOR_REGEX, (_, c) => c ? c.toUpperCase() : "").replace(LEADING_CHAR_REGEX, (c) => c.toLowerCase());
@@ -133,56 +135,56 @@ var CAPACITOR_SKIPPED_SERVER_FILES = /* @__PURE__ */ new Set([
   "src/lib/server/init.ts"
 ]);
 var VERSIONS = {
-  antfuEslintConfig: "^9.5.1",
-  capacitorSecureStorage: "^8.0.1",
+  antfuEslintConfig: "9.5.1",
+  capacitorSecureStorage: "8.0.1",
   // UI / Icon
-  bitsUi: "^2.19.5",
-  iconifyJsonTabler: "^1.2.42",
-  iconifyTailwind: "^1.2.3",
+  bitsUi: "2.19.5",
+  iconifyJsonTabler: "1.2.42",
+  iconifyTailwind: "1.2.3",
   // Capacitor
-  capacitorAndroid: "^8.5.3",
-  capacitorApp: "^8.1.2",
-  capacitorCamera: "^8.2.5",
-  capacitorCli: "^8.5.3",
-  capacitorCore: "^8.5.3",
-  capacitorDevice: "^8.0.3",
-  capacitorIos: "^8.5.3",
-  capacitorPreferences: "^8.0.1",
-  capacitorPushNotifications: "^8.1.3",
-  capacitorStatusBar: "^8.0.4",
+  capacitorAndroid: "8.5.3",
+  capacitorApp: "8.1.2",
+  capacitorCamera: "8.2.5",
+  capacitorCli: "8.5.3",
+  capacitorCore: "8.5.3",
+  capacitorDevice: "8.0.3",
+  capacitorIos: "8.5.3",
+  capacitorPreferences: "8.0.1",
+  capacitorPushNotifications: "8.1.3",
+  capacitorStatusBar: "8.0.4",
   // Tailwind / DaisyUI
-  daisyui: "^5.7.47",
-  tailwindcss: "^4.3.3",
-  tailwindcssVite: "^4.3.3",
+  daisyui: "5.7.47",
+  tailwindcss: "4.3.3",
+  tailwindcssVite: "4.3.3",
   // i18n
-  inlangParaglide: "^2.27.0",
-  inlangMessageFormat: "^4.5.0",
+  inlangParaglide: "2.27.0",
+  inlangMessageFormat: "4.5.0",
   // Svelte / Vite
-  svelte: "^5.57.2",
-  svelteKit: "^2.70.3",
-  svelteAdapterNode: "^5.5.7",
-  svelteCheck: "^4.7.6",
-  sveltePlugin: "^7.3.1",
+  svelte: "5.57.2",
+  svelteKit: "2.70.3",
+  svelteAdapterNode: "5.5.7",
+  svelteCheck: "4.7.6",
+  sveltePlugin: "7.3.1",
   // Build / Test
-  vite: "^8.3.4",
-  vitest: "^4.1.11",
-  tsup: "^8.5.1",
-  rimraf: "^6.1.3",
+  vite: "8.3.4",
+  vitest: "4.1.11",
+  tsup: "8.5.1",
+  rimraf: "6.1.3",
   // ESLint
-  eslint: "^10.12.0",
-  eslintPluginFormat: "^2.0.1",
-  eslintPluginSvelte: "^3.23.1",
-  svelteEslintParser: "^1.9.0",
+  eslint: "10.12.0",
+  eslintPluginFormat: "2.0.1",
+  eslintPluginSvelte: "3.23.1",
+  svelteEslintParser: "1.9.0",
   // Node / TS
-  nodeTypes: "^26.6.5",
+  nodeTypes: "26.6.5",
   // Svelte / ESLint / tsup 继续使用稳定的 JavaScript 编译 API。
-  typescript: "^6.0.3",
+  typescript: "6.0.3",
   // E2E
-  playwright: "^1.64.0",
+  playwright: "1.64.0",
   // Validation
-  zod: "^4.6.5",
+  zod: "4.6.5",
   // Tauri
-  tauriCli: "^2.12.1"
+  tauriCli: "2.12.1"
 };
 var FRONTEND_PORTS_DEFAULT = {
   web: 4173,
@@ -208,6 +210,7 @@ var HAI_CATALOG_PACKAGE_NAMES = [
   "@h-ai/audit",
   "@h-ai/cache",
   "@h-ai/capacitor",
+  "@h-ai/cli",
   "@h-ai/core",
   "@h-ai/crypto",
   "@h-ai/datapipe",
@@ -388,6 +391,7 @@ function buildFullstackPackageSpecifiers(useCatalogProtocol) {
 function buildApiWorkspaceCatalogPackages(featureMap) {
   const packageNames = [
     ...API_WORKSPACE_EXTERNAL_CATALOG_PACKAGE_NAMES,
+    "@h-ai/cli",
     "@h-ai/api-client",
     "@h-ai/api-contract",
     "@h-ai/core",
@@ -422,7 +426,7 @@ function buildApiWorkspaceCatalogPackages(featureMap) {
   return pickCatalogPackages(packageNames, FULLSTACK_CATALOG_PACKAGES);
 }
 function buildAppHaiCatalogPackages(options) {
-  const packageNames = [];
+  const packageNames = ["@h-ai/cli"];
   if (options.isSvelteOnlyApp) {
     packageNames.push("@h-ai/api-client", "@h-ai/api-contract", "@h-ai/capacitor", "@h-ai/ui");
     return pickCatalogPackages(packageNames, HAI_CATALOG_PACKAGES);
@@ -469,6 +473,7 @@ function buildAppHaiCatalogPackages(options) {
 function buildFullstackCatalogPackages(frontends, deploy = false) {
   const packageNames = [
     ...FULLSTACK_ROOT_CATALOG_PACKAGE_NAMES,
+    "@h-ai/cli",
     ...FULLSTACK_CONTRACT_CATALOG_PACKAGE_NAMES,
     ...FULLSTACK_SERV_CATALOG_PACKAGE_NAMES,
     ...FULLSTACK_SHARED_CATALOG_PACKAGE_NAMES
@@ -577,6 +582,7 @@ function buildTemplateContext(options) {
   for (const f of options.features) {
     featureMap[f] = true;
   }
+  featureMap.deploy = options.deploy !== false;
   if (options.appType === "fullstack") {
     for (const feature of ["iam", "db", "cache", "crypto", "storage", "audit"]) featureMap[feature] = true;
   }
@@ -772,6 +778,14 @@ async function generateFromTemplates(projectPath, context) {
     }
   }
   await renderDynamicFiles(root, projectPath, context);
+  await fse.copy(path2.join(root, "shared", "run-e2e.mjs"), path2.join(projectPath, "scripts", "run-e2e.mjs"));
+  await fse.ensureDir(path2.join(projectPath, "images", "dependencies"));
+  await fse.writeFile(path2.join(projectPath, "images", "dependencies", ".gitkeep"), "");
+  await fse.copy(path2.join(root, "shared", ".gitattributes"), path2.join(projectPath, ".gitattributes"));
+  if (context.isSvelteOnlyApp) {
+    await fse.copy(path2.join(root, "shared", "vite-runtime-config.ts"), path2.join(projectPath, "scripts", "vite-runtime-config.ts"));
+    await fse.copy(path2.join(root, "shared", "container-runtime-config.sh"), path2.join(projectPath, "images", "web", "19-runtime-config.sh"));
+  }
   if (context.isSvelteOnlyApp || context.appType === "fullstack") {
     const navigationDir = context.appType === "fullstack" ? path2.join(projectPath, "packages", `${context.projectName}-shared`, "src", "lib", "navigation") : path2.join(projectPath, "src", "lib", "navigation");
     await fse.copy(path2.join(root, "shared", "hash-router.svelte.ts"), path2.join(navigationDir, "hash-router.svelte.ts"));
@@ -1053,7 +1067,6 @@ var SELECTABLE_FEATURES = [
   "vecdb",
   "datapipe",
   "scheduler",
-  "deploy",
   "api-client",
   "capacitor"
 ];
@@ -1126,13 +1139,14 @@ async function createProject(options) {
       name: resolvedOptions.name,
       appType: resolvedOptions.appType,
       features: resolvedOptions.features,
+      deploy: resolvedOptions.deploy,
       frontends: resolvedOptions.frontends,
       moduleConfigs: resolvedOptions.moduleConfigs,
       packageManager: resolvedOptions.packageManager
     });
     await generateFromTemplates(projectPath, context);
     {
-      const { generateConfigFile: generateConfigFile2, generateEnvExample } = await import('./cli-config-templates-SJ2MBIR7.js');
+      const { generateConfigFile: generateConfigFile2, generateEnvExample } = await import('./cli-config-templates-6AHNUGBN.js');
       const configs = resolvedOptions.moduleConfigs;
       const isApiWorkspace = resolvedOptions.appType === "api";
       const isFullstack = resolvedOptions.appType === "fullstack";
@@ -1206,7 +1220,7 @@ HAI_ADMIN_DEFAULT_PASSWORD=${password}
         await writeFile(path2.join(envDirectory, ".env.local"), "# \u672C\u673A\u79C1\u6709\u914D\u7F6E\uFF0C\u4E0D\u63D0\u4EA4 Git\uFF1B\u8986\u76D6\u516C\u5171\u57FA\u7840\u548C\u73AF\u5883\u914D\u7F6E\u3002\n");
       }
     }
-    const { generateSkillFiles } = await import('./cli-skill-templates-A5VIR5J6.js');
+    const { generateSkillFiles } = await import('./cli-skill-templates-FC3QRKDO.js');
     await generateSkillFiles(
       projectPath,
       resolvedOptions.features,
@@ -1217,7 +1231,7 @@ HAI_ADMIN_DEFAULT_PASSWORD=${password}
     const readmeContent = resolvedOptions.appType === "fullstack" ? generateFullstackReadme(resolvedOptions.name, resolvedOptions.packageManager, resolvedOptions.frontends) : resolvedOptions.appType === "api" ? generateApiWorkspaceReadme(resolvedOptions.name, resolvedOptions.packageManager) : generateReadme(resolvedOptions.name, appTypeLabel, resolvedOptions.packageManager, resolvedOptions.appType);
     await writeFile(
       path2.join(projectPath, "README.md"),
-      readmeContent
+      resolvedOptions.deploy === false ? readmeContent.replace(/### 构建与部署[\s\S]*?(?=\n#{2,3} |$)/, "### \u6784\u5EFA\n\npnpm build\npnpm build --target docker\n\n\u672C\u9879\u76EE\u521B\u5EFA\u65F6\u5173\u95ED\u4E86\u90E8\u7F72\u5DE5\u5177\u3002\n") : readmeContent
     );
     spinner.succeed();
     if (resolvedOptions.git) {
@@ -1253,7 +1267,7 @@ async function resolveOptions(options) {
   writeCliMessage("");
   const onCancel = () => {
     writeCliMessage(chalk.red("\n\u5DF2\u53D6\u6D88"));
-    process3.exit(1);
+    process4.exit(1);
   };
   let projectName = options.name;
   if (!projectName && useDefaults) {
@@ -1319,7 +1333,7 @@ async function resolveOptions(options) {
   let selectedFeatures = [];
   const appTypeDefaults = APP_TYPES[selectedAppType].defaultFeatures;
   if (selectedAppType === "fullstack") {
-    selectedFeatures = resolveFeatureDependencies([...appTypeDefaults, ...options.features?.includes("deploy") ? ["deploy"] : []]);
+    selectedFeatures = resolveFeatureDependencies(appTypeDefaults);
   } else if (selectedTemplate === "custom" && !options.features && useDefaults) {
     selectedFeatures = resolveFeatureDependencies(appTypeDefaults);
   } else if (selectedTemplate === "custom" && !options.features) {
@@ -1346,6 +1360,9 @@ async function resolveOptions(options) {
     const merged = /* @__PURE__ */ new Set([...templateFeatures, ...appTypeDefaults]);
     selectedFeatures = resolveFeatureDependencies(Array.from(merged));
   }
+  selectedFeatures = selectedFeatures.filter((feature) => feature !== "deploy");
+  if (options.deploy !== false)
+    selectedFeatures.push("deploy");
   const moduleConfigs = selectedAppType === "fullstack" ? { ...buildDefaultModuleConfigs(selectedFeatures, projectName), ...options.moduleConfigs } : options.moduleConfigs ?? (useDefaults ? buildDefaultModuleConfigs(selectedFeatures, projectName) : await promptModuleConfigs(selectedFeatures, projectName));
   let addExamples = options.examples;
   if (addExamples === void 0 && useDefaults) {
@@ -1427,6 +1444,7 @@ async function resolveOptions(options) {
     frontends: selectedFrontends,
     template: selectedTemplate ?? "default",
     features: selectedFeatures,
+    deploy: options.deploy !== false,
     moduleConfigs,
     examples: addExamples ?? true,
     install: install ?? true,
@@ -1509,7 +1527,7 @@ async function promptModuleConfigs(features, projectName) {
   const configs = {};
   const onCancel = () => {
     writeCliMessage(chalk.red("\n\u5DF2\u53D6\u6D88"));
-    process3.exit(1);
+    process4.exit(1);
   };
   writeCliMessage("");
   writeCliMessage(chalk.bold("  \u2699 \u6A21\u5757\u914D\u7F6E"));
@@ -1723,24 +1741,20 @@ function normalizeChildOutput(output) {
   return "";
 }
 function generateAiDevelopmentReadme() {
-  return `## AI \u8F85\u52A9\u5F00\u53D1
+  return `### AI \u8F85\u52A9\u5F00\u53D1
 
 \u4ECE\u672C\u9879\u76EE\u6839\u76EE\u5F55\u6253\u5F00\u6240\u7528\u7F16\u7801\u5DE5\u5177\uFF0C\u5148\u8BFB\u53D6 [AGENTS.md](./AGENTS.md)\u3002Claude Code \u901A\u8FC7 [CLAUDE.md](./CLAUDE.md) \u52A0\u8F7D\u9879\u76EE\u89C4\u5219\uFF1BGitHub Copilot \u4F7F\u7528 [.github/copilot-instructions.md](./.github/copilot-instructions.md)\uFF0COpenCode \u4F7F\u7528 AGENTS.md \u548C [opencode.json](./opencode.json)\u3002
 
-\u4E1A\u52A1\u4EE5\u7528\u6237\u5F53\u524D\u660E\u786E\u8981\u6C42\u53CA\u5176\u6307\u5B9A\u7684\u9700\u6C42/\u8BBE\u8BA1\u6587\u6863\u4E3A\u51C6\u3002\u6A21\u677F AGENTS\u3001README\u3001skills\u3001\u751F\u6210\u4EE3\u7801\u4E0E\u6D4B\u8BD5\u4E2D\u7684\u89D2\u8272/\u6743\u9650\u3001\u6D41\u7A0B\u3001\u9650\u989D\u548C\u67B6\u6784\u662F\u53EF\u8C03\u6574\u7684\u521D\u59CB\u65B9\u6848\uFF1B\u5BA1\u67E5\u5C06\u5DEE\u5F02\u5217\u4E3A\u6A21\u677F\u9002\u914D\u9879\uFF0C\u5B9E\u65BD\u6309\u6388\u6743\u540C\u6B65\u51B2\u7A81\u4EE3\u7801\u3001\u6D4B\u8BD5\u4E0E\u8FC7\u671F\u89C4\u5219\uFF0C\u4E0D\u8981\u6C42\u628A\u9700\u6C42\u6539\u56DE\u6A21\u677F\u3002\u6846\u67B6 API \u4EE5\u5F53\u524D\u5B89\u88C5\u7248\u672C\u516C\u5F00\u5951\u7EA6\u4E3A\u51C6\uFF0C\u670D\u52A1\u7AEF\u6388\u6743\u3001\u8D44\u6E90\u9694\u79BB\u3001\u8F93\u5165\u6821\u9A8C\u548C\u51ED\u636E\u4FDD\u62A4\u4ECD\u9700\u843D\u5B9E\u3002
-
-Codex\u3001Cursor\u3001Copilot\u3001OpenCode \u4ECE .agents/skills/ \u53D1\u73B0\u5171\u4EAB\u6280\u80FD\uFF1BClaude Code \u901A\u8FC7 CLAUDE.md \u5F15\u7528 AGENTS.md\uFF0C\u5E76\u6309\u9879\u76EE\u6307\u5F15\u8BFB\u53D6 .agents/skills/ \u7684\u540C\u4E00\u4EFD\u6B63\u6587\u3002\u9700\u6C42\u6216\u8BBE\u8BA1\u6587\u6863\u5728\u751F\u6210\u524D\u4F7F\u7528 [\u6587\u6863\u5BA1\u67E5 Skill](./.agents/skills/hai-spec-review/SKILL.md) \u4E25\u683C\u68C0\u67E5\u5B8C\u5907\u6027\u3001\u6B67\u4E49\u3001\u6280\u672F\u6B63\u786E\u6027\u548C\u547D\u540D\u4E00\u81F4\u6027\uFF0C\u95EE\u9898\u89E3\u51B3\u540E\u518D\u751F\u6210\u3002\u666E\u901A\u65B0\u589E\u3001\u4FEE\u6539\u3001\u4FEE\u590D\u4EFB\u52A1\u4F7F\u7528 [\u5E94\u7528\u5F00\u53D1 Skill](./.agents/skills/hai-app-create/SKILL.md) \u548C [\u5F00\u53D1\u89C4\u8303\u4E0E\u6846\u67B6\u80FD\u529B\u8DEF\u7531](./.agents/skills/hai-app-create/development.md)\uFF1B\u5177\u4F53\u6A21\u5757\u518D\u6309\u9700\u8BFB\u53D6\uFF0C\u4E0D\u80FD\u628A Skill \u5DF2\u4EA4\u4ED8\u5F53\u6210\u4F9D\u8D56\u5DF2\u5B89\u88C5\u6216\u914D\u7F6E\u5DF2\u542F\u7528\u3002
-
-\u6839\u636E\u6587\u6863\u89C4\u5212\u3001\u5B9E\u65BD\u3001\u8FD4\u4FEE\u6216\u6309\u5DF2\u63D0\u4EA4\u6587\u6863\u5DEE\u5F02\u540C\u6B65\u5B9E\u73B0\u65F6\uFF0C\u4F7F\u7528 [\u6587\u6863\u5B9E\u65BD Skill](./.agents/skills/hai-spec-implement/SKILL.md)\uFF1A\u7EF4\u62A4 docs/task-list.md \u4E0E docs/tasks/\uFF0C\u8BB0\u5F55\u5DF2\u9A8C\u6536\u6587\u6863\u548C\u5B9E\u73B0\u7684 Git SHA\uFF0C\u6BD4\u8F83\u56FA\u5B9A\u76EE\u6807\u7248\u672C\u540E\u66F4\u65B0\u539F\u4EFB\u52A1\u6216\u65B0\u5EFA\u4EFB\u52A1\uFF0C\u6BCF\u9879\u72EC\u7ACB\u5206\u652F TDD\u3001\u9A8C\u8BC1\u5E76\u672C\u5730\u5408\u5E76\uFF1B\u5168\u90E8\u5DEE\u5F02\u4E0E\u6574\u4F53\u9A8C\u6536\u901A\u8FC7\u540E\u624D\u63A8\u8FDB\u57FA\u7EBF\u3002\u8FD4\u4FEE\u6CBF\u7528\u539F\u4EFB\u52A1\u4E0E\u5206\u652F\u3002\u4EC5\u89C4\u5212\u4E0D\u5F00\u59CB\u5B9E\u73B0\uFF0C\u6307\u5B9A\u4EFB\u52A1\u5148\u6838\u9A8C\u4F9D\u8D56\u3002
+\u751F\u6210\u7684\u9875\u9762\u548C\u4E1A\u52A1\u89C4\u5219\u662F\u8D77\u70B9\uFF0C\u53EF\u4EE5\u6309\u9700\u6C42\u8C03\u6574\u3002\u628A\u529F\u80FD\u3001\u6743\u9650\u548C\u9A8C\u6536\u6761\u4EF6\u544A\u8BC9 AI\uFF0C\u518D\u8BA9\u5B83\u8BFB\u53D6\u5BF9\u5E94\u6280\u80FD\u4E0E\u5F53\u524D\u5B89\u88C5\u7248\u672C\u7684 API\u3002
 
-\u4F18\u5148\u590D\u7528\u9002\u7528\u7684 hai-framework \u516C\u5F00 API \u4E0E\u5DF2\u6709\u4E1A\u52A1\u5B9E\u73B0\u3002\u5B8C\u6210\u65F6\u8BF4\u660E\u590D\u7528\u7684\u80FD\u529B\u3001\u76F8\u5173\u80FD\u529B\u672A\u91C7\u7528\u7684\u539F\u56E0\uFF0C\u4EE5\u53CA\u5B89\u5168\u8FB9\u754C\u548C\u7C7B\u578B\u3001\u914D\u7F6E\u3001\u6587\u6848\u3001\u8C03\u7528\u65B9\u7684\u540C\u6B65\u60C5\u51B5\u3002\u8D28\u91CF\u9A8C\u8BC1\u6309\u5F53\u524D package.json \u6267\u884C typecheck \u2192 lint \u2192 build \u2192 test\uFF1BUI\u3001\u8DEF\u7531\u4E0E\u7AEF\u5230\u7AEF\u6D41\u7A0B\u53E6\u8FD0\u884C test:e2e\uFF0C\u672A\u8FD0\u884C\u9879\u8BF4\u660E\u539F\u56E0\u3002\u5B89\u5168\u4E0E\u8D28\u91CF\u89C4\u5219\u65E2\u8981\u6309\u89C4\u8303\u5BA1\u67E5\uFF0C\u4E5F\u8981\u8FD0\u884C\u95E8\u7981\u9A8C\u8BC1\u3002
+\u666E\u901A\u529F\u80FD\u5F00\u53D1\u4F7F\u7528 [\u5E94\u7528\u5F00\u53D1 Skill](./.agents/skills/hai-app-create/SKILL.md)\u3002\u9700\u6C42\u6587\u6863\u8F83\u591A\u65F6\uFF0C\u5148\u7528 [\u6587\u6863\u5BA1\u67E5 Skill](./.agents/skills/hai-spec-review/SKILL.md) \u627E\u51FA\u7F3A\u5931\u548C\u77DB\u76FE\uFF0C\u518D\u7528 [\u6587\u6863\u5B9E\u65BD Skill](./.agents/skills/hai-spec-implement/SKILL.md) \u7EF4\u62A4 docs/task-list.md \u4E0E docs/tasks/\uFF0C\u9010\u9879\u5B9E\u73B0\u3001\u6D4B\u8BD5\u548C\u4EA4\u4ED8\u3002
 
-\u5DF2\u6709 hai \u9879\u76EE\u53EF\u8FD0\u884C hai init \u8865\u9F50\u7F3A\u5931\u7684 AI \u652F\u6301\u6587\u4EF6\u4E0E\u53C2\u8003\u8D44\u6E90\uFF1B\u5DF2\u6709 AGENTS.md\u3001Skill \u548C\u81EA\u5B9A\u4E49\u89C4\u5219\u4F1A\u4FDD\u7559\uFF0C\u5347\u7EA7\u65F6\u9700\u5C06\u4E0A\u8FF0\u9700\u6C42\u4F18\u5148\u89C4\u5219\u3001\u666E\u901A\u5F00\u53D1\u5165\u53E3\u4E0E\u89C4\u8303\u663E\u5F0F\u5408\u5E76\u5230\u65E7\u6307\u5F15\uFF0C\u5E76\u4FEE\u6B63\u5DF2\u88AB\u9700\u6C42\u66FF\u4EE3\u7684\u6A21\u677F\u7EA6\u675F\u3002
+\u5DF2\u6709\u9879\u76EE\u53EF\u8FD0\u884C hai init \u8865\u9F50\u7F3A\u5931\u7684 AI \u5165\u53E3\uFF1B\u5B83\u4FDD\u7559\u5DF2\u6709\u81EA\u5B9A\u4E49\u5185\u5BB9\u3002\u5347\u7EA7\u6846\u67B6\u4F7F\u7528 [\u6846\u67B6\u5347\u7EA7 Skill](./.agents/skills/hai-framework-sync/SKILL.md)\uFF0C\u540C\u65F6\u6838\u5BF9\u4F9D\u8D56\u3001\u914D\u7F6E\u3001\u4EE3\u7801\u548C\u6280\u80FD\u3002
 
 `;
 }
 function generateEnvironmentReadme() {
-  return `## \u5206\u73AF\u5883\u914D\u7F6E
+  return `### \u5206\u73AF\u5883\u914D\u7F6E
 
 \u8FD0\u884C\u53C2\u6570\u5728 \`.env.example\` \u4E2D\u9010\u9879\u8BF4\u660E\u7528\u9014\u3001\u679A\u4E3E\u548C\u8303\u56F4\u3002\`.env\` \u4E3A\u516C\u5171\u57FA\u7840\uFF0C\`.env.dev\` / \`.env.test\` / \`.env.prod\` \u4E3A\u73AF\u5883\u8986\u76D6\uFF0C\u5747\u63D0\u4EA4 Git\uFF1B\`.env.local\` \u4E3A\u672C\u673A\u79C1\u6709\u8986\u76D6\uFF0C\u4E0D\u63D0\u4EA4 Git\u3002\u4F18\u5148\u7EA7\u4E3A\u8FDB\u7A0B\u73AF\u5883 > \`.env.local\` > \u73AF\u5883\u6587\u4EF6 > \`.env\`\u3002YAML \u663E\u5F0F\u5F15\u7528 \`HAI_<\u914D\u7F6E\u540D>_<\u8DEF\u5F84>\` \u5E76\u4FDD\u7559\u672C\u5730\u56DE\u9000\uFF0CcamelCase \u4E0D\u62C6\u8BCD\u3002\u5B8C\u6574\u547D\u4EE4\u3001\u52A0\u8F7D\u4F18\u5148\u7EA7\u548C Provider \u5207\u6362\u89C1 [\u73AF\u5883\u914D\u7F6E](.agents/skills/hai-app-create/development.md#\u73AF\u5883\u914D\u7F6E)\u3002
 
@@ -1749,40 +1763,63 @@ function generateEnvironmentReadme() {
 | \u5F00\u53D1 / \u6D4B\u8BD5\u6A21\u5F0F / \u751F\u4EA7\u6A21\u5F0F\u9884\u89C8 | \`pnpm dev\` / \`dev:test\` / \`dev:prod\` |
 | \u7C7B\u578B\u68C0\u67E5\uFF08check \u4E3A\u522B\u540D\uFF09 | \`pnpm typecheck\` |
 | \u68C0\u67E5 / \u81EA\u52A8\u4FEE\u590D\u683C\u5F0F | \`pnpm lint\` / \`lint:fix\` |
-| \u6784\u5EFA / \u751F\u4EA7\u6A21\u5F0F\u6784\u5EFA | \`pnpm build\` / \`build:prod\` |
+| \u6E90\u7801\u6784\u5EFA / \u955C\u50CF\u6784\u5EFA | \`pnpm build\` / \`pnpm build --target docker\` |
 | \u5355\u5143\u6D4B\u8BD5 / \u76D1\u542C / \u6D4F\u89C8\u5668\u9A8C\u6536 | \`pnpm test\` / \`test:watch\` / \`test:e2e\` |
 | Node \u670D\u52A1\u6309\u73AF\u5883\u542F\u52A8\uFF08\u6784\u5EFA\u540E\uFF09 | \`pnpm start\` / \`start:test\` / \`start:prod\` |
 
 Vite \u5BA2\u6237\u7AEF\u4F7F\u7528 \`preview\` \u9884\u89C8\u9759\u6001\u4EA7\u7269\uFF0CNode \u670D\u52A1\u4F7F\u7528 \`start\`\uFF1B\u7EAF contract/shared \u5E93\u53EA\u63D0\u4F9B\u9002\u7528\u7684\u6784\u5EFA\u548C\u8D28\u91CF\u547D\u4EE4\u3002API workspace \u7684\u73AF\u5883\u6587\u4EF6\u4F4D\u4E8E \`apps/<name>-service\`\uFF0Cfullstack \u4F4D\u4E8E\u5DE5\u7A0B\u6839\u3002`;
 }
+function generateBuildDeploymentReadme(pm, appDir) {
+  return `### \u6784\u5EFA\u4E0E\u90E8\u7F72
+
+\u521B\u5EFA\u65F6\u9ED8\u8BA4\u5305\u542B\u90E8\u7F72\u5DE5\u5177\uFF1B\u4E0D\u9700\u8981\u65F6\u4F7F\u7528 hai create --no-deploy\u3002
+\u6BCF\u4E2A\u955C\u50CF\u5BF9\u5E94 images/ \u4E2D\u4E00\u4E2A Dockerfile\uFF0Chai.build.json \u7528 dockerfile \u6307\u5B9A\u6587\u4EF6\u3002
+\u4E0B\u8F7D\u3001\u5B89\u88C5\u548C\u6574\u7406\u751F\u4EA7\u4F9D\u8D56\u590D\u7528\u540C\u4E00\u4EFD\u5305\u7F13\u5B58\u4E0E SQLite \u9A71\u52A8\u7F13\u5B58\uFF0C\u907F\u514D\u91CD\u590D\u4E0B\u8F7D\u3002
+\u9ED8\u8BA4\u5BB9\u5668\u7528\u4E8E CPU \u8FD0\u884C\u6216\u8FDE\u63A5\u8FDC\u7A0B AI \u670D\u52A1\uFF0C\u4E0D\u989D\u5916\u4E0B\u8F7D GPU \u8FD0\u884C\u5E93\uFF1B\u9700\u8981\u4F7F\u7528\u90E8\u7F72\u673A\u5668\u4E0A\u7684 GPU \u65F6\uFF0C\u81EA\u884C\u5B9A\u5236\u955C\u50CF\u548C\u5BB9\u5668\u8FD0\u884C\u53C2\u6570\u3002
+
+\`\`\`sh
+${pm} build
+${pm} build --target docker
+# \u6784\u5EFA\u548C\u90E8\u7F72\u4E00\u6B21\u5B8C\u6210
+${pm} exec hai deploy ${appDir} --env test --build
+# \u590D\u7528\u5DF2\u6709\u955C\u50CF\uFF1B\u53EA\u751F\u6210\u5B8C\u6574\u79BB\u7EBF\u5305\u53CA\u8DE8\u5E73\u53F0\u90E8\u7F72\u811A\u672C
+${pm} exec hai deploy ${appDir} --env prod --bundle-only
+# \u53EA\u66F4\u65B0\u524D\u7AEF\uFF08\u5DE5\u7A0B\u5B58\u5728 web \u955C\u50CF\u65F6\uFF09
+${pm} build --target docker --images web
+${pm} exec hai deploy ${appDir} --env prod --services web
+\`\`\`
+
+\u6784\u5EFA\u4E0D\u8BFB\u53D6\u90E8\u7F72\u73AF\u5883\uFF1B\u4EA7\u7269\u4F4D\u4E8E .hai/build/docker/<buildId>\uFF0C\u7528 --artifact-dir \u7CBE\u786E\u9009\u62E9\u3002
+\u5E94\u7528\u6839 package.json.version \u9A71\u52A8\u7248\u672C\uFF0C\u540C\u7248\u672C\u5141\u8BB8\u91CD\u65B0\u6784\u5EFA\u548C\u53D1\u5E03\uFF1B\u6E05\u5355\u8BB0\u5F55\u72EC\u7ACB\u6784\u5EFA\u7F16\u53F7\u4E0E\u6821\u9A8C\u548C\u3002
+\u5B8C\u6574\u79BB\u7EBF\u5305\u81EA\u52A8\u643A\u5E26\u81EA\u5EFA\u4E2D\u95F4\u4EF6\u955C\u50CF\uFF1B\u51C6\u5907\u4E2D\u95F4\u4EF6\u955C\u50CF\u9700\u8981\u6784\u5EFA\u673A\u6709\u53EF\u7528 Podman/Docker\uFF0C\u7F3A\u955C\u50CF\u65F6\u5728\u6253\u5305\u9636\u6BB5\u62C9\u53D6\u3002
+\u670D\u52A1\u5668\u9700\u8981 Linux\u3001Docker/Podman\u3001Docker Compose v2 \u6216 podman-compose 1.6.0 \u53CA\u4EE5\u4E0A\u3001sh\u3001tar\u3001sha256sum\u3001awk\u3001curl\uFF0C\u542F\u52A8\u9636\u6BB5\u4E0D\u8054\u7F51\u62C9\u53D6\u3002
+tar \u65C1\u7684\u90E8\u7F72\u76EE\u5F55\u63D0\u4F9B deploy.ps1\uFF08Windows\uFF09\u548C deploy.sh\uFF08Linux/macOS\uFF09\uFF0C\u6309\u5DF2\u4FDD\u5B58\u7684 SSH \u53C2\u6570\u4E0A\u4F20\u3001\u5BFC\u5165\u3001\u542F\u52A8\u5E76\u9A8C\u8BC1 HTTP\u3002
+\u5B8C\u5168\u9694\u79BB\u65F6\u624B\u5DE5\u642C\u8FD0 tar\uFF0C\u72EC\u7ACB\u76EE\u5F55\u89E3\u5305\u540E\u6267\u884C sh apply.sh\uFF0C\u6216\u4F20\u5165\u90E8\u7F72\u76EE\u5F55\u8986\u76D6\u9ED8\u8BA4\u4F4D\u7F6E\u3002
+\u90E8\u5206\u66F4\u65B0\u8981\u6C42\u5DF2\u6709\u6210\u529F\u7684\u5B8C\u6574\u90E8\u7F72\uFF0C\u4FDD\u7559\u672A\u9009\u670D\u52A1\u53CA\u6570\u636E\u5377\uFF1B\u5931\u8D25\u8FD4\u56DE\u975E\u96F6\u9000\u51FA\u7801\uFF0C\u5DF2\u6709\u90E8\u7F72\u5C1D\u8BD5\u6062\u590D\u9009\u4E2D\u670D\u52A1\u3002
+\u4E2D\u95F4\u4EF6\u8FDE\u63A5\u9F50\u5168\u65F6\u4F7F\u7528 --skip-middleware \u8DF3\u8FC7\u914D\u7F6E\u5411\u5BFC\u3002\u5305\u4E2D\u5305\u542B\u79C1\u6709\u914D\u7F6E\uFF0C\u4E0D\u63D0\u4EA4 Git\u3002
+`;
+}
 function generateReadme(name, appTypeLabel, pm, appType) {
   const install = getInstallCommand(pm);
-  const isStaticImage = appType === "mobile-app";
-  const containerPort = isStaticImage ? 8080 : 3e3;
-  const runtimeOptions = isStaticImage ? "" : ` --env-file .env --mount type=bind,source=/absolute/path/to/config,target=/app/config,readonly --mount type=volume,source=${name}-data,target=/app/data`;
-  const embeddedDataBuild = isStaticImage ? "" : `
-# \u5E26 data/ \u521D\u59CB\u6570\u636E\u6784\u5EFA\uFF08\u4E8C\u9009\u4E00\uFF09
-${getRunCommand(pm, "docker:build:data")}
-${getRunCommand(pm, "podman:build:data")}`;
-  const runtimeNotes = isStaticImage ? "- \u8BE5\u6A21\u677F\u751F\u6210\u9759\u6001 Web \u955C\u50CF\uFF0C\u4E0D\u5305\u542B\u53EF\u5199\u6570\u636E\u5E93\u76EE\u5F55\u3002" : `\u4EE5\u4E0A\u4E09\u4E2A\u8FD0\u884C\u65F6\u53C2\u6570\u5747\u53EF\u6309\u9700\u5220\u9664\uFF1A
-
-| \u53C2\u6570 | \u7528\u9014 | \u53EF\u9009\u6027 |
-| --- | --- | --- |
-| \`--env-file .env\` | \u6279\u91CF\u4F20\u5165\u73AF\u5883\u53D8\u91CF\uFF1B\u4E5F\u53EF\u6539\u7528\u591A\u4E2A \`-e NAME=value\`\u3002 | \u53EF\u9009\uFF1B\u5220\u9664\u540E\u4F7F\u7528\u955C\u50CF\u548C YAML \u9ED8\u8BA4\u503C\u3002 |
-| \`--mount type=bind,...target=/app/config,readonly\` | \u7528\u5BBF\u4E3B\u673A\u914D\u7F6E\u76EE\u5F55\u8986\u76D6\u955C\u50CF\u5185 \`/app/config\`\uFF1B\u5FC5\u987B\u628A \`source\` \u6539\u6210\u771F\u5B9E\u7EDD\u5BF9\u8DEF\u5F84\uFF0C\`readonly\` \u9632\u6B62\u5BB9\u5668\u4FEE\u6539\u914D\u7F6E\u3002 | \u53EF\u9009\uFF1B\u5220\u9664\u540E\u4F7F\u7528\u955C\u50CF\u81EA\u5E26\u914D\u7F6E\u3002 |
-| \`--mount type=volume,...target=/app/data\` | \u521B\u5EFA\u6216\u590D\u7528 named volume\uFF0C\u6301\u4E45\u5316 SQLite \u548C\u672C\u5730\u5B58\u50A8\u3002 | \u53EF\u9009\u4F46\u751F\u4EA7\u73AF\u5883\u5EFA\u8BAE\u4FDD\u7559\uFF1B\u5220\u9664\u540E\u6570\u636E\u53EA\u5199\u5165\u5BB9\u5668\u5C42\uFF0C\u4F7F\u7528 \`--rm\` \u5220\u9664\u5BB9\u5668\u65F6\u4F1A\u4E22\u5931\u3002 |
-
-- \u5E26\u6570\u636E\u6784\u5EFA\u4F1A\u628A\u5F53\u524D \`data/\`\uFF08\u4F8B\u5982\u9884\u7F6E SQLite \u6587\u4EF6\uFF09\u56FA\u5316\u4E3A\u955C\u50CF\u521D\u59CB\u5FEB\u7167\uFF1B\u8FD0\u884C\u540E\u4EA7\u751F\u7684\u65B0\u6570\u636E\u4ECD\u5E94\u5199\u5165 \`/app/data\` volume\u3002`;
-  const testPath = isStaticImage ? "/health" : "/";
   return `# ${name}
 
+## \u7B80\u4ECB
+
 \u57FA\u4E8E hai Agent Framework \u6784\u5EFA\u7684${appTypeLabel}\u5E94\u7528\u3002
 
-## \u9875\u9762\u5E03\u5C40\u4E0E\u8DEF\u7531
+## \u6838\u5FC3\u529F\u80FD\u6E05\u5355
+
+- \u5F00\u53D1\u670D\u52A1\u5668\u3001\u6E90\u7801\u7F16\u8BD1\u4E0E\u6D4F\u89C8\u5668\u6D4B\u8BD5\u3002
+- \u6309\u6240\u9009\u6A21\u5757\u63D0\u4F9B\u9875\u9762\u548C\u670D\u52A1\u914D\u7F6E\u3002
+- \u72EC\u7ACB Dockerfile \u4E0E\u955C\u50CF\u5F52\u6863\uFF0C\u4FBF\u4E8E\u4EA4\u4ED8\u3002
+
+## \u4F7F\u7528\u5165\u95E8
+
+### \u9875\u9762\u5E03\u5C40\u4E0E\u8DEF\u7531
 
 \u9875\u9762\u7EDF\u4E00\u7EE7\u627F\u6839\u5E03\u5C40\u7684 header/footer\u3002${appType === "mobile-app" ? "\u9875\u9762\u653E src/lib/pages/**/*.svelte\uFF0Chash \u8DEF\u7531\u81EA\u52A8\u53D1\u73B0\uFF0C\u5237\u65B0\u4E0E\u524D\u8FDB\u540E\u9000\u6062\u590D\u5F53\u524D\u9875\u3002" : "\u4F7F\u7528 SvelteKit \u81EA\u52A8\u6587\u4EF6\u8DEF\u7531\uFF0C\u65B0\u589E +page.svelte \u65E0\u9700\u7EF4\u62A4\u8DEF\u7531\u8868\uFF1B\u5237\u65B0\u5B9A\u4F4D\u4E0E\u670D\u52A1\u7AEF\u9274\u6743\u4FDD\u6301\u4E00\u81F4\u3002"}
 
-## \u5F00\u53D1
+### \u5F00\u53D1
 
 \`\`\`bash
 ${install}
@@ -1791,57 +1828,57 @@ ${getRunCommand(pm, "dev")}
 
 ${generateEnvironmentReadme()}
 
-## \u6784\u5EFA
+### \u6784\u5EFA
 
 \`\`\`bash
 ${getRunCommand(pm, "build")}
-${getRunCommand(pm, "i18n:compile")}
+${getRunCommand(pm, "paraglide:compile")}
 ${getRunCommand(pm, "preview")}
 \`\`\`
 
-## \u5BB9\u5668\u8FD0\u884C
+${generateBuildDeploymentReadme(pm, `.`)}
 
-### \u6784\u5EFA\u955C\u50CF
+${generateAiDevelopmentReadme()}### \u6587\u6863
 
-\`\`\`bash
-# \u666E\u901A\u6784\u5EFA\uFF08\u4E8C\u9009\u4E00\uFF09
-${getRunCommand(pm, "docker:build")}
-${getRunCommand(pm, "podman:build")}${embeddedDataBuild}
-\`\`\`
-
-### \u8FD0\u884C\u955C\u50CF
-
-\`\`\`bash
-# Docker\uFF1B\u4F7F\u7528 Podman \u65F6\u5C06 docker \u66FF\u6362\u4E3A podman
-docker run --rm -d --name ${name} -p ${containerPort}:${containerPort}${runtimeOptions} ${name}:latest
-\`\`\`
+- [hai Agent Framework](https://github.com/hai-series/hai-framework)
+- [Svelte 5](https://svelte.dev/)
 
-### \u6D4B\u8BD5\u955C\u50CF
+## \u5F00\u53D1\u6D4B\u8BD5
 
-\`\`\`bash
-curl --fail http://127.0.0.1:${containerPort}${testPath}
-docker stop ${name}
+\`\`\`sh
+${getRunCommand(pm, "typecheck")}
+${getRunCommand(pm, "lint")}
+${getRunCommand(pm, "build")}
+${getRunCommand(pm, "test")}
+${getRunCommand(pm, "test:e2e")}
 \`\`\`
 
-${runtimeNotes}
-
-${generateAiDevelopmentReadme()}## \u6587\u6863
+## \u8BB8\u53EF\u8BC1
 
-- [hai Agent Framework](https://github.com/hai-series/hai-framework)
-- [Svelte 5](https://svelte.dev/)
+Apache-2.0
 `;
 }
 function generateApiWorkspaceReadme(name, pm) {
   return `# ${name}
 
-\u57FA\u4E8E hai Agent Framework \u6784\u5EFA\u7684 typed API workspace\u3002
+## \u7B80\u4ECB
+
+\u540E\u7AEF API \u5DE5\u7A0B\uFF0C\u63A5\u53E3\u5B9A\u4E49\u4E0E\u670D\u52A1\u5B9E\u73B0\u5206\u5305\u7EF4\u62A4\uFF0C\u5BA2\u6237\u7AEF\u53EF\u590D\u7528\u540C\u4E00\u4EFD\u63A5\u53E3\u7C7B\u578B\u3002
+
+## \u6838\u5FC3\u529F\u80FD\u6E05\u5355
 
-## \u5DE5\u7A0B\u7ED3\u6784
+- \u5171\u4EAB contract\u3001\u8F93\u5165\u8F93\u51FA\u6821\u9A8C\u4E0E\u670D\u52A1 procedures\u3002
+- \u6A21\u5757\u914D\u7F6E\u3001\u5065\u5EB7\u68C0\u67E5\u548C HTTP \u670D\u52A1\u3002
+- \u72EC\u7ACB\u955C\u50CF\u6784\u5EFA\u4E0E\u79BB\u7EBF\u4EA4\u4ED8\u3002
+
+## \u4F7F\u7528\u5165\u95E8
+
+### \u5DE5\u7A0B\u7ED3\u6784
 
 - \`apps/${name}-contract\`\uFF1A\u5171\u4EAB API contract\u3001Zod schema \u4E0E\u7C7B\u578B
 - \`apps/${name}-service\`\uFF1A\u540E\u7AEF API service\uFF0C\u57FA\u4E8E \`@h-ai/serv\` \u66B4\u9732 HTTP \u5E94\u7528
 
-## \u5F00\u53D1
+### \u5F00\u53D1
 
 \`\`\`bash
 ${pm} install
@@ -1850,96 +1887,55 @@ ${pm} dev
 
 ${generateEnvironmentReadme()}
 
-## \u8D28\u91CF\u95E8\u7981
-
-\`\`\`bash
-${pm} typecheck
-${pm} lint
-${pm} build
-${pm} test
-${pm} test:e2e
-\`\`\`
-
-## \u5BB9\u5668\u8FD0\u884C
-
-### \u6784\u5EFA\u955C\u50CF
-
-\`\`\`bash
-# \u666E\u901A\u6784\u5EFA\uFF08\u4E8C\u9009\u4E00\uFF09
-${pm} docker:build
-${pm} podman:build
-
-# \u5C06 apps/${name}-service/data \u4F5C\u4E3A\u955C\u50CF\u521D\u59CB\u6570\u636E\u6784\u5EFA\uFF08\u4E8C\u9009\u4E00\uFF09
-${pm} docker:build:data
-${pm} podman:build:data
-\`\`\`
-
-### \u8FD0\u884C\u955C\u50CF
-
-\`\`\`bash
-# \u4F7F\u7528 Podman \u65F6\u5C06 docker \u66FF\u6362\u4E3A podman
-docker run --rm -d --name ${name} -p 3000:3000 --env-file .env \\
-  --mount type=bind,source=/absolute/path/to/config,target=/app/config,readonly \\
-  --mount type=volume,source=${name}-data,target=/app/data \\
-  ${name}:latest
-\`\`\`
-
-### \u6D4B\u8BD5\u955C\u50CF
-
-\`\`\`bash
-curl --fail http://127.0.0.1:3000/health
-curl --fail http://127.0.0.1:3000/ready
-curl --fail --request POST http://127.0.0.1:3000/api/v1/app/info \\
-  --header "Content-Type: application/json" --data '{}'
-docker stop ${name}
-\`\`\`
-
-- \u914D\u7F6E\u9ED8\u8BA4\u6765\u81EA \`apps/${name}-service/config\`\uFF1B\u8FD0\u884C\u65F6\u53EF\u53EA\u8BFB\u6302\u8F7D\u5230 \`/app/config\` \u8986\u76D6\uFF0C\u5E76\u7528 YAML \u7684 \`\${ENV_NAME:default}\` \u5360\u4F4D\u7B26\u63A5\u6536\u73AF\u5883\u53D8\u91CF\u3002
-- \u5E26\u6570\u636E\u6784\u5EFA\u4F1A\u628A \`apps/${name}-service/data\` \u56FA\u5316\u4E3A\u955C\u50CF\u521D\u59CB\u6570\u636E\uFF1B\u751F\u4EA7\u5199\u5165\u4ECD\u5EFA\u8BAE\u4F7F\u7528 \`/app/data\` volume\u3002
-
-\u4EE5\u4E0A\u4E09\u4E2A\u8FD0\u884C\u65F6\u53C2\u6570\u5747\u53EF\u6309\u9700\u5220\u9664\uFF1A
 
-| \u53C2\u6570 | \u7528\u9014 | \u53EF\u9009\u6027 |
-| --- | --- | --- |
-| \`--env-file .env\` | \u6279\u91CF\u4F20\u5165\u73AF\u5883\u53D8\u91CF\uFF1B\u4E5F\u53EF\u6539\u7528\u591A\u4E2A \`-e NAME=value\`\u3002 | \u53EF\u9009\uFF1B\u5220\u9664\u540E\u4F7F\u7528\u955C\u50CF\u548C YAML \u9ED8\u8BA4\u503C\u3002 |
-| \`--mount type=bind,...target=/app/config,readonly\` | \u7528\u5BBF\u4E3B\u673A\u914D\u7F6E\u76EE\u5F55\u8986\u76D6\u955C\u50CF\u5185 \`/app/config\`\uFF1B\u5FC5\u987B\u628A \`source\` \u6539\u6210\u771F\u5B9E\u7EDD\u5BF9\u8DEF\u5F84\uFF0C\`readonly\` \u9632\u6B62\u5BB9\u5668\u4FEE\u6539\u914D\u7F6E\u3002 | \u53EF\u9009\uFF1B\u5220\u9664\u540E\u4F7F\u7528\u955C\u50CF\u81EA\u5E26\u914D\u7F6E\u3002 |
-| \`--mount type=volume,...target=/app/data\` | \u521B\u5EFA\u6216\u590D\u7528 named volume\uFF0C\u6301\u4E45\u5316 SQLite \u548C\u672C\u5730\u5B58\u50A8\u3002 | \u53EF\u9009\u4F46\u751F\u4EA7\u73AF\u5883\u5EFA\u8BAE\u4FDD\u7559\uFF1B\u5220\u9664\u540E\u6570\u636E\u53EA\u5199\u5165\u5BB9\u5668\u5C42\uFF0C\u4F7F\u7528 \`--rm\` \u5220\u9664\u5BB9\u5668\u65F6\u4F1A\u4E22\u5931\u3002 |
+${generateBuildDeploymentReadme(pm, `apps/${name}-service`)}
 
-## \u6269\u5C55\u5EFA\u8BAE
+### \u6269\u5C55\u5EFA\u8BAE
 
 - \u5728 \`${name}-contract\` \u4E2D\u7EF4\u62A4\u5E94\u7528\u7EA7 contract\uFF0C\u524D\u540E\u7AEF\u5171\u7528\u540C\u4E00\u4EFD\u7C7B\u578B\u4E0E\u8DEF\u5F84\u5B9A\u4E49\u3002
 - \u5728 \`${name}-service\` \u4E2D\u6269\u5C55 procedures\u3001\u6A21\u5757\u521D\u59CB\u5316\u4E0E\u914D\u7F6E\u3002
 - \u9700\u8981 IAM / storage / ai \u65F6\uFF0C\u4F18\u5148\u590D\u7528 \`@h-ai/api-contract\` \u4E0E \`@h-ai/serv/features/*\`\u3002
 
-${generateAiDevelopmentReadme()}## \u6587\u6863
+${generateAiDevelopmentReadme()}### \u6587\u6863
 
 - [hai Agent Framework](https://github.com/hai-series/hai-framework)
 - [@h-ai/serv](./.agents/skills/hai-serv/SKILL.md)
 - [@h-ai/api-contract](./.agents/skills/hai-api-contract/SKILL.md)
 - [@h-ai/api-client](./.agents/skills/hai-api-client/SKILL.md)
+
+## \u5F00\u53D1\u6D4B\u8BD5
+
+\`\`\`bash
+${pm} typecheck
+${pm} lint
+${pm} build
+${pm} test
+${pm} test:e2e
+\`\`\`
+
+## \u8BB8\u53EF\u8BC1
+
+Apache-2.0
 `;
 }
 function generateFullstackReadme(name, pm, frontends) {
   const enabledFrontends = frontends.map((target) => FRONTEND_TARGETS[target].name).join(" / ");
-  const webBuildCommands = frontends.includes("web") ? `
-# Web \u9759\u6001\u955C\u50CF\uFF08\u4E8C\u9009\u4E00\uFF09
-${pm} docker:build:web
-${pm} podman:build:web` : "";
-  const webRunCommand = frontends.includes("web") ? `
-
-# Web\uFF1BPUBLIC_API_BASE \u5728\u5BB9\u5668\u542F\u52A8\u65F6\u6CE8\u5165\uFF0C\u4E0D\u9700\u8981\u91CD\u65B0\u6784\u5EFA\u955C\u50CF
-docker run --rm -d --name ${name}-web -p 8080:8080 \\
-  -e PUBLIC_API_BASE=https://api.example.com \\
-  ${name}-web:latest` : "";
-  const webTestCommands = frontends.includes("web") ? `curl --fail http://127.0.0.1:8080/health
-curl --fail http://127.0.0.1:8080/runtime-config.js
-` : "";
-  const containerNames = frontends.includes("web") ? `${name} ${name}-web` : name;
   return `# ${name}
 
-\u57FA\u4E8E hai Agent Framework \u6784\u5EFA\u7684\u524D\u540E\u7AEF\u5206\u79BB\u591A\u5305\u5DE5\u7A0B\u3002
+## \u7B80\u4ECB
 
-## \u5DE5\u7A0B\u7ED3\u6784
+\u524D\u540E\u7AEF\u5206\u79BB\u5DE5\u7A0B\uFF0CAPI \u4E0E Web\u3001\u79FB\u52A8\u7AEF\u3001\u684C\u9762\u7AEF\u5171\u4EAB\u63A5\u53E3\u7C7B\u578B\u548C\u7BA1\u7406\u754C\u9762\uFF0C\u53EF\u6309\u5B9E\u9645\u4E1A\u52A1\u8C03\u6574\u3002
+
+## \u6838\u5FC3\u529F\u80FD\u6E05\u5355
+
+- API \u670D\u52A1\u3001\u5171\u4EAB\u754C\u9762\u4E0E\u6309\u9700\u751F\u6210\u7684\u5BA2\u6237\u7AEF\u3002
+- \u7528\u6237\u7BA1\u7406\u3001\u89D2\u8272\u3001\u5BA1\u8BA1\u548C\u4E2A\u4EBA\u8BBE\u7F6E\u793A\u4F8B\u3002
+- \u767B\u5F55\u3001\u4E3B\u9898\u3001\u8BED\u8A00\u3001\u65B0\u624B\u5F15\u5BFC\u548C\u5E2E\u52A9\u4E2D\u5FC3\u3002
+- API/Web \u72EC\u7ACB Dockerfile \u4E0E\u955C\u50CF\u5F52\u6863\u3002
+
+## \u4F7F\u7528\u5165\u95E8
+
+### \u5DE5\u7A0B\u7ED3\u6784
 
 - \`packages/${name}-contract\`\uFF1A\u524D\u540E\u7AEF\u5171\u4EAB API \u5951\u7EA6\u3001Zod Schema \u4E0E\u7C7B\u578B
 - \`packages/${name}-serv\`\uFF1A\u540E\u7AEF API Service\uFF08\u901A\u8FC7 \`@h-ai/serv\` \u66B4\u9732\u6700\u5C0F HTTP App \u62BD\u8C61\uFF0C\u4E0D\u76F4\u63A5\u66B4\u9732 Hono\uFF09
@@ -1951,11 +1947,11 @@ curl --fail http://127.0.0.1:8080/runtime-config.js
 
 \u5DF2\u542F\u7528\u524D\u7AEF\uFF1A${enabledFrontends || "Web / App / Desktop"}
 
-## \u9875\u9762\u5E03\u5C40\u4E0E\u8DEF\u7531
+### \u9875\u9762\u5E03\u5C40\u4E0E\u8DEF\u7531
 
 Web/App/Desktop \u5171\u4EAB AppShell \u7684 header/footer\u3002\u65B0\u589E\u9875\u9762\u653E shared/src/lib/pages/**/*.svelte\uFF0C\u7531 HashRouter \u81EA\u52A8\u53D1\u73B0\u5E76\u6309\u9700\u52A0\u8F7D\uFF1B\u83DC\u5355\u53EA\u7EF4\u62A4\u5165\u53E3\u3002\u5730\u5740\u4F7F\u7528 #/\u9875\u9762\u8DEF\u5F84\uFF0C\u652F\u6301\u5237\u65B0\u3001\u67E5\u8BE2\u4E32\u4E0E\u6D4F\u89C8\u5668\u524D\u8FDB\u540E\u9000\uFF1BAPI \u6743\u9650\u4ECD\u7531\u670D\u52A1\u7AEF\u6821\u9A8C\u3002
 
-## \u9ED8\u8BA4\u7BA1\u7406\u529F\u80FD
+### \u9ED8\u8BA4\u7BA1\u7406\u529F\u80FD
 
 \u4EE5\u4E0B\u63CF\u8FF0\u53EF\u8FD0\u884C\u793A\u4F8B\u7684\u521D\u59CB\u4E1A\u52A1\uFF0C\u53EF\u6309\u5B9E\u9645\u9700\u6C42\u8C03\u6574\u6216\u79FB\u9664\uFF0C\u5E76\u540C\u6B65\u4EE3\u7801\u3001\u6570\u636E\u3001\u9274\u6743\u3001\u754C\u9762\u3001\u6D4B\u8BD5\u548C\u6587\u6863\u3002
 
@@ -1969,7 +1965,7 @@ CLI \u5DF2\u5728\u6839\u76EE\u5F55\u751F\u6210 \`.env.local\`\uFF0C\u5176\u4E2D
 
 \u5E94\u7528\u663E\u793A\u540D\u79F0\u3001\u7248\u672C\u3001\u73AF\u5883\u3001\u9ED8\u8BA4\u8BED\u8A00\u548C\u65E5\u5FD7\u8BBE\u7F6E\u6765\u81EA\u540E\u7AEF \`config/_core.yml\`\uFF0C\u524D\u7AEF\u901A\u8FC7 \`app.info\` \u83B7\u53D6\u5B89\u5168\u5143\u4FE1\u606F\u3002\u9ED8\u8BA4 SQLite\u3001\u672C\u5730\u5B58\u50A8\u4E0E\u5185\u5B58\u7F13\u5B58\u9002\u5408\u5355\u5B9E\u4F8B\uFF0C\u7BA1\u7406\u5199\u5165\u4EC5\u652F\u6301\u5355\u5199\u5B9E\u4F8B\uFF1B\u591A\u5B9E\u4F8B\u8BFB\u53D6\u53EF\u4F7F\u7528\u5171\u4EAB\u6570\u636E\u5E93\u3001Redis cache \u548C S3 \u5B58\u50A8\uFF0C\u4F46\u7BA1\u7406\u5199\u8BF7\u6C42\u987B\u7EDF\u4E00\u8DEF\u7531\u5230\u540C\u4E00\u5199\u5B9E\u4F8B\u3002\u53E6\u9700\u4F1A\u8BDD\u7C98\u6027\u8DEF\u7531\u4F7F\u8BF7\u6C42\u547D\u4E2D\u540C\u4E00\u8FDB\u7A0B\u5185\u4F20\u8F93\u79C1\u94A5\uFF0C\u670D\u52A1\u91CD\u542F\u540E\u5BA2\u6237\u7AEF\u91CD\u65B0\u534F\u5546\u3002\u751F\u4EA7\u9700\u663E\u5F0F\u914D\u7F6E\u5141\u8BB8\u7684 CORS Origin\u3002\u4E1A\u52A1\u63D0\u4EA4\u540E\u7684\u5BA1\u8BA1\u5199\u5165\u91C7\u7528\u6700\u5927\u52AA\u529B\uFF0C\u5931\u8D25\u8BB0\u5F55\u7ED3\u6784\u5316\u9519\u8BEF\u65E5\u5FD7\uFF0C\u4FDD\u7559\u5DF2\u5B8C\u6210\u4E1A\u52A1\u7684\u539F\u59CB\u7ED3\u679C\u3002
 
-## \u914D\u7F6E\u6269\u5C55
+### \u914D\u7F6E\u6269\u5C55
 
 \u670D\u52A1\u7AEF \`packages/${name}-serv/config/\` \u59CB\u7EC8\u4FDD\u7559 core\u3001serv\u3001db\u3001cache\u3001iam\u3001storage\u3001audit\u3001reach\u3001ai\u3001vecdb\u3001payment\u3001scheduler\u3001deploy \u5171 13 \u4EFD YAML\u3002\u5DF2\u7528\u6A21\u5757\u4FDD\u7559\u5DE5\u4F5C\u9ED8\u8BA4\u503C\uFF0C\u672A\u542F\u7528\u6A21\u5757\u6574\u4EFD\u6CE8\u91CA\uFF0C\u53EF\u9009\u5B57\u6BB5\u548C\u66FF\u4EE3 Provider \u6309\u5757\u6CE8\u91CA\uFF1B\u6839 \`.env.example\` \u4E5F\u4FDD\u7559\u672A\u542F\u7528\u6A21\u5757\u7684\u51ED\u636E\u793A\u4F8B\u3002Reach \u9ED8\u8BA4\u4E3A\u5F00\u53D1\u63A7\u5236\u53F0\u901A\u77E5\uFF0C\u751F\u4EA7\u6309 \`_reach.yml\` \u6CE8\u91CA\u66FF\u6362\u4E3A SMTP\u3001\u77ED\u4FE1\u6216 API Provider\uFF0C\u5E76\u4FDD\u6301\u540D\u79F0\u552F\u4E00\u3002
 
@@ -1981,79 +1977,23 @@ CLI \u5DF2\u5728\u6839\u76EE\u5F55\u751F\u6210 \`.env.local\`\uFF0C\u5176\u4E2D
 
 ${generateEnvironmentReadme()}
 
-## \u5F00\u53D1\u3001\u7F16\u8BD1\u4E0E\u6253\u5305
+### \u5F00\u53D1\u4E0E\u6784\u5EFA
 
 \`\`\`bash
 ${pm} install
 ${pm} dev
-
-# \u4E00\u952E\u7F16\u8BD1\uFF1A\u7C7B\u578B\u68C0\u67E5 + \u5168\u5DE5\u4F5C\u533A\u6784\u5EFA
-${pm} compile
-
-# \u4E00\u952E\u6253\u5305\uFF1AWeb build\u3001App Capacitor sync\u3001Desktop Tauri build\uFF08\u6309\u542F\u7528\u524D\u7AEF\u6267\u884C\uFF09
-${pm} package
-
-# \u90E8\u7F72\u5165\u53E3\uFF1A\u9ED8\u8BA4\u6267\u884C package\uFF0C\u53EF\u66FF\u6362\u4E3A\u56E2\u961F\u81EA\u5DF1\u7684 CI/CD \u53D1\u5E03\u811A\u672C
-${pm} deploy
-\`\`\`
-
-## \u5BB9\u5668\u8FD0\u884C
-
-\u9ED8\u8BA4\u955C\u50CF\u76F4\u63A5\u8FD0\u884C API Service\uFF0C\u5916\u90E8\u7AEF\u53E3\u4E3A 3000\u3002
-
-### \u6784\u5EFA\u955C\u50CF
-
-\`\`\`bash
-# Service \u666E\u901A\u6784\u5EFA\uFF08\u4E8C\u9009\u4E00\uFF09
-${pm} docker:build
-${pm} podman:build
-
-# \u5C06 packages/${name}-serv/data \u4F5C\u4E3A\u955C\u50CF\u521D\u59CB\u6570\u636E\u6784\u5EFA\uFF08\u4E8C\u9009\u4E00\uFF09
-${pm} docker:build:data
-${pm} podman:build:data
-${webBuildCommands}
-\`\`\`
-
-### \u8FD0\u884C\u955C\u50CF
-
-\`\`\`bash
-# Service\uFF1B\u4F7F\u7528 Podman \u65F6\u5C06 docker \u66FF\u6362\u4E3A podman
-docker run --rm -d --name ${name} -p 3000:3000 --env-file .env --env-file .env.prod --env-file .env.local \\
-  --mount type=bind,source=/absolute/path/to/config,target=/app/config,readonly \\
-  --mount type=volume,source=${name}-data,target=/app/data \\
-  ${name}:latest
-${webRunCommand}
-\`\`\`
-
-### \u6D4B\u8BD5\u955C\u50CF
-
-\`\`\`bash
-curl --fail http://127.0.0.1:3000/health
-curl --fail http://127.0.0.1:3000/ready
-${webTestCommands}docker stop ${containerNames}
+${pm} typecheck
+${pm} build
+${pm} test
+${pm} test:e2e
+${frontends.includes("desktop") ? `${pm} build --target desktop --platform windows # Windows \u4E3B\u673A\uFF1BLinux/macOS \u5728\u5BF9\u5E94\u4E3B\u673A\u6784\u5EFA` : ""}
 \`\`\`
 
-- \u4E0A\u4F8B\u6309\u516C\u5171\u57FA\u7840\u3001\u751F\u4EA7\u73AF\u5883\u3001\u672C\u673A\u79C1\u6709\u6587\u4EF6\u7684\u987A\u5E8F\u6CE8\u5165\u53D8\u91CF\uFF1B\u8FD0\u884C\u524D\u5728\u76EE\u6807\u673A\u5668\u521B\u5EFA \`.env.local\` \u5E76\u8BBE\u7F6E\u81EA\u5DF1\u7684\u7BA1\u7406\u5458\u5BC6\u7801\u3002\u90E8\u7F72\u5E73\u53F0\u4E5F\u53EF\u76F4\u63A5\u6CE8\u5165\u540C\u540D\u53D8\u91CF\u3002
-- \u914D\u7F6E\u9ED8\u8BA4\u6765\u81EA \`packages/${name}-serv/config\`\uFF0C\u4E5F\u53EF\u6302\u8F7D\u5230 \`/app/config\`\uFF1BYAML \u4E2D\u7684 \`\${ENV_NAME:default}\` \u53EF\u7531 \`--env-file\` \u6216 \`-e\` \u6CE8\u5165\u3002
-- \u5E26\u6570\u636E\u6784\u5EFA\u4F1A\u628A \`packages/${name}-serv/data\` \u56FA\u5316\u4E3A\u955C\u50CF\u521D\u59CB\u6570\u636E\uFF1B\u6301\u4E45\u5316\u5199\u5165\u4ECD\u5E94\u4F7F\u7528 volume\u3002
-- Service \u7531 \`@h-ai/serv\` \u76F4\u63A5\u5BF9\u5916\u76D1\u542C\uFF0C\u4E0D\u989D\u5916\u542F\u52A8 Web \u8F6C\u53D1\u5C42\u3002
-${frontends.includes("web") ? `- Web \u4F7F\u7528\u72EC\u7ACB\u9759\u6001\u955C\u50CF\u5E76\u652F\u6301\u4E00\u6B21\u6784\u5EFA\u3001\u591A\u73AF\u5883\u90E8\u7F72\uFF1B\u6784\u5EFA\u53EA\u9700\u8FD0\u884C \`${pm} docker:build:web\`\uFF0C\u542F\u52A8\u5BB9\u5668\u65F6\u901A\u8FC7 \`-e PUBLIC_API_BASE=https://api.example.com\` \u6307\u5411 Service \u5BF9\u5916\u5730\u5740\u3002\u672A\u8BBE\u7F6E\u65F6\u9ED8\u8BA4\u4F7F\u7528 Web \u9875\u9762\u81EA\u8EAB origin\u3002` : ""}
-
-\u4EE5\u4E0A\u4E09\u4E2A Service \u8FD0\u884C\u65F6\u53C2\u6570\u5747\u53EF\u6309\u9700\u5220\u9664\uFF1A
+Tauri \u9700\u8981\u76EE\u6807\u7CFB\u7EDF\u7684 Rust target\u3001SDK \u548C\u6253\u5305\u5DE5\u5177\u3002\u6D4B\u8BD5\u4EA7\u751F\u7684\u4E34\u65F6\u5DE5\u7A0B\u3001\u622A\u56FE\u3001\u62A5\u544A\u3001\u5BB9\u5668\u3001\u955C\u50CF\u4E0E\u8FDB\u7A0B\u5E94\u5728 finally/teardown \u4E2D\u81EA\u52A8\u6E05\u7406\uFF0C\u5931\u8D25\u4E5F\u6267\u884C\u3002
 
-| \u53C2\u6570 | \u7528\u9014 | \u53EF\u9009\u6027 |
-| --- | --- | --- |
-| \`--env-file .env\` | \u6279\u91CF\u4F20\u5165\u73AF\u5883\u53D8\u91CF\uFF1B\u4E5F\u53EF\u6539\u7528\u591A\u4E2A \`-e NAME=value\`\u3002 | \u53EF\u9009\uFF1B\u5220\u9664\u540E\u4F7F\u7528\u955C\u50CF\u548C YAML \u9ED8\u8BA4\u503C\u3002 |
-| \`--mount type=bind,...target=/app/config,readonly\` | \u7528\u5BBF\u4E3B\u673A\u914D\u7F6E\u76EE\u5F55\u8986\u76D6\u955C\u50CF\u5185 \`/app/config\`\uFF1B\u5FC5\u987B\u628A \`source\` \u6539\u6210\u771F\u5B9E\u7EDD\u5BF9\u8DEF\u5F84\uFF0C\`readonly\` \u9632\u6B62\u5BB9\u5668\u4FEE\u6539\u914D\u7F6E\u3002 | \u53EF\u9009\uFF1B\u5220\u9664\u540E\u4F7F\u7528\u955C\u50CF\u81EA\u5E26\u914D\u7F6E\u3002 |
-| \`--mount type=volume,...target=/app/data\` | \u521B\u5EFA\u6216\u590D\u7528 named volume\uFF0C\u6301\u4E45\u5316 SQLite \u548C\u672C\u5730\u5B58\u50A8\u3002 | \u53EF\u9009\u4F46\u751F\u4EA7\u73AF\u5883\u5EFA\u8BAE\u4FDD\u7559\uFF1B\u5220\u9664\u540E\u6570\u636E\u53EA\u5199\u5165\u5BB9\u5668\u5C42\uFF0C\u4F7F\u7528 \`--rm\` \u5220\u9664\u5BB9\u5668\u65F6\u4F1A\u4E22\u5931\u3002 |
+${generateBuildDeploymentReadme(pm, `packages/${name}-serv`)}
 
-\u524D\u7AEF\u5355\u72EC\u4EA4\u4ED8\u547D\u4EE4\uFF1A
-
-- Web\uFF1A\`${pm} --filter ${name}-web build\` / \`${pm} --filter ${name}-web package\`
-- App\uFF1A\`${pm} --filter ${name}-app package\`\uFF0CAndroid/iOS \u53EF\u7528 \`cap:build:android:debug\` / \`cap:build:android:release\` / \`cap:build:ios\`
-- Desktop\uFF1A\`${pm} --filter ${name}-desktop tauri:dev\` / \`${pm} --filter ${name}-desktop package\`
-
-## i18n \u4E0E shared \u534F\u540C
+### i18n \u4E0E shared \u534F\u540C
 
 - shared\uFF1A\`packages/${name}-shared/project.inlang\` + \`messages/\`\uFF0C\u53EA\u653E\u8DE8\u7AEF\u5171\u4EAB\u7EC4\u4EF6\u6587\u6848\u3002
 - web/app/desktop\uFF1A\u6BCF\u4E2A\u5E94\u7528\u90FD\u6709\u81EA\u5DF1\u7684 \`project.inlang\` + \`messages/\`\uFF0C\u7528\u4E8E\u672C\u7AEF\u9875\u9762\u4E0E\u4EA7\u54C1\u6587\u6848\u3002
@@ -2061,13 +2001,20 @@ ${frontends.includes("web") ? `- Web \u4F7F\u7528\u72EC\u7ACB\u9759\u6001\u955C\
 - \u65B0\u589E locale \u65F6\uFF0Cshared \u4E0E\u6240\u6709\u542F\u7528\u524D\u7AEF\u7684 \`locales\` \u5FC5\u987B\u540C\u6B65\uFF1B\u8BED\u8A00\u5207\u6362\u5668\u4F1A\u540C\u65F6\u66F4\u65B0 shared runtime \u4E0E\u5BBF\u4E3B\u5E94\u7528 runtime\u3002
 - \`${pm} i18n:compile\` \u4F1A\u7EDF\u4E00\u7F16\u8BD1 shared \u4E0E\u6BCF\u4E2A\u542F\u7528\u524D\u7AEF\u7684 Paraglide \u8F93\u51FA\uFF1B\u5404\u524D\u7AEF\u4E5F\u53EF\u5355\u72EC\u8FD0\u884C \`${pm} --filter ${name}-web paraglide:compile\` \u7B49\u547D\u4EE4\u3002
 
-## \u81EA\u5B9A\u4E49\u5EFA\u8BAE
+### \u81EA\u5B9A\u4E49\u5EFA\u8BAE
 
 - \u6539\u5168\u5C40 Shell/\u4E3B\u9898/\u8BED\u8A00\u5207\u6362\uFF1A\u7F16\u8F91 \`packages/${name}-shared\`\u3002
-- \u6539\u67D0\u4E2A\u524D\u7AEF\u9875\u9762\u548C\u6587\u6848\uFF1A\u7F16\u8F91\u5BF9\u5E94 \`apps/${name}-*/src/routes\` \u4E0E \`apps/${name}-*/messages\`\u3002
+- \u6539\u67D0\u4E2A\u524D\u7AEF\u9875\u9762\u548C\u6587\u6848\uFF1A\u7F16\u8F91\u5171\u4EAB \`packages/${name}-shared/src/lib/pages\`\u3001\u672C\u7AEF\u5165\u53E3\u4E0E \`apps/${name}-*/messages\`\u3002
 - \u6539\u4E3B\u9898\u5217\u8868\uFF1A\u8C03\u6574\u811A\u624B\u67B6\u914D\u7F6E\u4E2D\u7684 \`fullstack.theme.themes\`\uFF0C\u6216\u76F4\u63A5\u7F16\u8F91\u5404\u7AEF \`src/app.css\` \u7684 daisyUI \`themes\`\u3002
 
-## \u8D28\u91CF\u95E8\u7981
+
+${generateAiDevelopmentReadme()}### \u6587\u6863
+
+- [hai Agent Framework](https://github.com/hai-series/hai-framework)
+- [@h-ai/serv](./.agents/skills/hai-serv/SKILL.md)
+- [@h-ai/ui](./.agents/skills/hai-ui/SKILL.md)
+
+## \u5F00\u53D1\u6D4B\u8BD5
 
 \`\`\`bash
 ${pm} typecheck
@@ -2077,11 +2024,9 @@ ${pm} test
 ${pm} test:e2e
 \`\`\`
 
-${generateAiDevelopmentReadme()}## \u6587\u6863
+## \u8BB8\u53EF\u8BC1
 
-- [hai Agent Framework](https://github.com/hai-series/hai-framework)
-- [@h-ai/serv](./.agents/skills/hai-serv/SKILL.md)
-- [@h-ai/ui](./.agents/skills/hai-ui/SKILL.md)
+Apache-2.0
 `;
 }
 function printCompletionMessage(options) {
@@ -2165,7 +2110,7 @@ async function addModule(options) {
   try {
     const project = await detectProject(cwd);
     if (!project) {
-      core.logger.error(chalk.red("\u672A\u68C0\u6D4B\u5230\u9879\u76EE\uFF08\u627E\u4E0D\u5230 package.json\uFF09"));
+      writeCliError(chalk.red("\u672A\u68C0\u6D4B\u5230\u9879\u76EE\uFF08\u627E\u4E0D\u5230 package.json\uFF09"));
       return;
     }
     let moduleName = options.module;
@@ -2176,7 +2121,7 @@ async function addModule(options) {
         value: key
       }));
       if (choices.length === 0) {
-        core.logger.info(chalk.green("\u6240\u6709\u6A21\u5757\u5DF2\u5B89\u88C5\uFF01"));
+        writeCliMessage(chalk.green("\u6240\u6709\u6A21\u5757\u5DF2\u5B89\u88C5\uFF01"));
         return;
       }
       const { selected } = await prompts({
@@ -2191,11 +2136,11 @@ async function addModule(options) {
     }
     const moduleDef = MODULE_MAP[moduleName];
     if (!moduleDef) {
-      core.logger.error(chalk.red(`\u672A\u77E5\u6A21\u5757: ${moduleName}`));
-      core.logger.info(`\u53EF\u7528\u6A21\u5757: ${Object.keys(MODULE_MAP).join(", ")}`);
+      writeCliError(chalk.red(`\u672A\u77E5\u6A21\u5757: ${moduleName}`));
+      writeCliMessage(`\u53EF\u7528\u6A21\u5757: ${Object.keys(MODULE_MAP).join(", ")}`);
       return;
     }
-    const { generateProjectAiSupport, resolveSkillNamesForPackages } = await import('./cli-skill-templates-A5VIR5J6.js');
+    const { generateProjectAiSupport, resolveSkillNamesForPackages } = await import('./cli-skill-templates-FC3QRKDO.js');
     if (moduleDef.packages.every((p) => project.haiPackages.includes(p))) {
       const generatedFiles2 = await generateProjectAiSupport(
         cwd,
@@ -2206,12 +2151,12 @@ async function addModule(options) {
         }
       );
       if (generatedFiles2.length > 0) {
-        core.logger.info(chalk.yellow(`\u6A21\u5757 ${moduleName} \u5DF2\u5B89\u88C5\uFF0C\u5DF2\u8865\u5168 AI \u652F\u6301\u6587\u4EF6`));
+        writeCliMessage(chalk.yellow(`\u6A21\u5757 ${moduleName} \u5DF2\u5B89\u88C5\uFF0C\u5DF2\u8865\u5168 AI \u652F\u6301\u6587\u4EF6`));
         for (const generatedFile of generatedFiles2) {
-          core.logger.info(chalk.gray(`  + ${generatedFile} (AI support)`));
+          writeCliMessage(chalk.gray(`  + ${generatedFile} (AI support)`));
         }
       } else {
-        core.logger.info(chalk.yellow(`\u6A21\u5757 ${moduleName} \u5DF2\u5B89\u88C5`));
+        writeCliMessage(chalk.yellow(`\u6A21\u5757 ${moduleName} \u5DF2\u5B89\u88C5`));
       }
       return;
     }
@@ -2234,7 +2179,10 @@ async function addModule(options) {
     const existingHaiSpecifier = Object.entries(pkg.dependencies).find(([pkgName]) => pkgName.startsWith("@h-ai/"))?.[1];
     const depVersion = existingHaiSpecifier === "catalog:" ? "catalog:" : getCliVersion();
     for (const pkgName of allPackages) {
-      if (!pkg.dependencies[pkgName]) {
+      if (pkgName === "@h-ai/deploy") {
+        pkg.devDependencies ??= {};
+        pkg.devDependencies[pkgName] ??= depVersion;
+      } else if (!pkg.dependencies[pkgName]) {
         pkg.dependencies[pkgName] = depVersion;
       }
     }
@@ -2249,7 +2197,7 @@ async function addModule(options) {
         await writeFile(configPath, content);
         spinner.succeed();
       } else {
-        core.logger.info(chalk.gray(`\u914D\u7F6E\u6587\u4EF6\u5DF2\u5B58\u5728: config/_${moduleDef.configKey}.yml`));
+        writeCliMessage(chalk.gray(`\u914D\u7F6E\u6587\u4EF6\u5DF2\u5B58\u5728: config/_${moduleDef.configKey}.yml`));
       }
     }
     if (moduleDef.deps) {
@@ -2260,7 +2208,7 @@ async function addModule(options) {
           if (!await fileExists(depConfigPath)) {
             const content = generateConfigFile(depDef.configKey);
             await writeFile(depConfigPath, content);
-            core.logger.info(chalk.gray(`  + config/_${depDef.configKey}.yml (\u4F9D\u8D56)`));
+            writeCliMessage(chalk.gray(`  + config/_${depDef.configKey}.yml (\u4F9D\u8D56)`));
           }
         }
       }
@@ -2276,7 +2224,7 @@ async function addModule(options) {
     );
     if (generatedFiles.length > 0) {
       for (const generatedFile of generatedFiles) {
-        core.logger.info(chalk.gray(`  + ${generatedFile} (AI support)`));
+        writeCliMessage(chalk.gray(`  + ${generatedFile} (AI support)`));
       }
     }
     const doInstall = options.install !== false;
@@ -2287,20 +2235,217 @@ async function addModule(options) {
       execSync2(`${pm} install`, { cwd, stdio: "ignore" });
       spinner.succeed();
     }
-    core.logger.info("");
-    core.logger.info(chalk.green(`\u2714 \u6A21\u5757 ${moduleName} \u6DFB\u52A0\u6210\u529F\uFF01`));
-    core.logger.info("");
-    core.logger.info("\u5DF2\u6DFB\u52A0\u7684\u5305:");
+    writeCliMessage("");
+    writeCliMessage(chalk.green(`\u2714 \u6A21\u5757 ${moduleName} \u6DFB\u52A0\u6210\u529F\uFF01`));
+    writeCliMessage("");
+    writeCliMessage("\u5DF2\u6DFB\u52A0\u7684\u5305:");
     for (const pkg2 of allPackages) {
-      core.logger.info(chalk.cyan(`  ${pkg2}`));
+      writeCliMessage(chalk.cyan(`  ${pkg2}`));
     }
-    core.logger.info("");
+    writeCliMessage("");
   } catch (error) {
     spinner.fail();
-    core.logger.error(chalk.red("\u6DFB\u52A0\u6A21\u5757\u5931\u8D25:"), { error });
+    writeCliError(chalk.red("\u6DFB\u52A0\u6A21\u5757\u5931\u8D25:"), { error });
     throw error;
   }
 }
+async function run(command, args, cwd, quiet = false) {
+  await new Promise((resolve3, reject) => {
+    const env = Object.fromEntries(Object.entries(process4.env).filter(([key]) => !/^(?:HAI_|PUBLIC_|VITE_)/.test(key)));
+    env.NODE_ENV = "production";
+    if (env.CI === "1" || env.CI === "0")
+      env.CI = env.CI === "1" ? "true" : "false";
+    const child = spawn(command, args, { cwd, env, windowsHide: true, stdio: quiet ? "ignore" : "inherit", shell: false });
+    child.once("error", reject);
+    child.once("exit", (code) => code === 0 ? resolve3() : reject(new Error(cliM("cli_build_failed", { params: { command, code: String(code) } }))));
+  });
+}
+async function pnpm(args, cwd) {
+  const entry = process4.env.npm_execpath;
+  if (entry && /(?:^|[/\\])pnpm(?:-native)?(?:\.exe|\.[cm]?js)?$/i.test(entry))
+    return /\.[cm]?js$/i.test(entry) ? run(process4.execPath, [entry, ...args], cwd) : run(entry, args, cwd);
+  if (process4.platform === "win32") {
+    const directories = (process4.env.PATH ?? "").split(";");
+    for (const directory of directories) {
+      const executable = join(directory, "pnpm.exe");
+      if (existsSync(executable))
+        return run(executable, args, cwd);
+      for (const relative2 of ["node_modules/pnpm/bin/pnpm.cjs", "pnpm.cjs"]) {
+        const candidate = join(directory, relative2);
+        if (existsSync(candidate))
+          return run(process4.execPath, [candidate, ...args], cwd);
+      }
+    }
+    throw new Error(cliM("cli_build_use_pnpm"));
+  }
+  return run("pnpm", args, cwd);
+}
+async function buildCommand(options) {
+  const cwd = resolve(options.cwd ?? process4.cwd());
+  const target = options.target ?? "compile";
+  if (!["compile", "docker", "desktop"].includes(target))
+    throw new Error(cliM("cli_build_target_invalid"));
+  if (target !== "docker" && (options.images !== void 0 || options.runtime !== void 0 || options.network !== void 0 || options.sqlitePrebuildMirror !== void 0 || options.httpProxy === false) || target !== "desktop" && (options.platform !== void 0 || options.arch !== void 0)) {
+    throw new Error(cliM("cli_build_options_invalid"));
+  }
+  if (target === "compile") {
+    await pnpm(["run", "compile"], cwd);
+    return;
+  }
+  const metadata = JSON.parse(readFileSync(join(cwd, "package.json"), "utf8"));
+  const appVersion = metadata.version;
+  if (typeof appVersion !== "string" || appVersion.length > 80 || !/^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-[0-9a-z-]+(?:\.[0-9a-z-]+)*)?(?:\+[0-9a-z-]+(?:\.[0-9a-z-]+)*)?$/i.test(appVersion))
+    throw new Error(cliM("cli_build_version_invalid"));
+  const config = JSON.parse(readFileSync(join(cwd, "hai.build.json"), "utf8"));
+  if (target === "desktop") {
+    const platforms = { win32: "windows", linux: "linux", darwin: "macos" };
+    const host = platforms[process4.platform];
+    const platform = options.platform ?? host;
+    const arch = options.arch ?? process4.arch;
+    if (!platform || platform !== host || !["x64", "arm64"].includes(arch))
+      throw new Error(cliM("cli_build_native_host"));
+    if (!config.desktop?.length)
+      throw new Error(cliM("cli_build_desktop_missing"));
+    const rustTarget = `${arch === "x64" ? "x86_64" : "aarch64"}-${platform === "windows" ? "pc-windows-msvc" : platform === "macos" ? "apple-darwin" : "unknown-linux-gnu"}`;
+    const bundles = platform === "windows" ? "nsis" : platform === "macos" ? "app,dmg" : "deb,appimage";
+    for (const directory of config.desktop)
+      await pnpm(["exec", "tauri", "build", "--target", rustTarget, "--bundles", bundles, "--config", JSON.stringify({ version: appVersion })], resolve(cwd, directory));
+    writeCliMessage(cliM("cli_build_native_ready", { params: { target: rustTarget } }));
+    return;
+  }
+  if (!Array.isArray(config.images) || !config.images.length || config.images.some((image) => !image || typeof image !== "object") || config.images.filter((image) => image.name === "app").length !== 1 || config.images.length > 2 || new Set(config.images.map((image) => image.name)).size !== config.images.length || config.images.some((image) => !["app", "web"].includes(image.name) || typeof image.dockerfile !== "string" || !image.dockerfile || "target" in image || image.containerPort !== void 0 && (!Number.isInteger(image.containerPort) || image.containerPort < 1 || image.containerPort > 65535))) {
+    throw new Error(cliM("cli_build_images_missing"));
+  }
+  const selected = options.images?.split(",").map((name) => name.trim());
+  if (selected && (selected.some((name) => !config.images.some((image) => image.name === name)) || new Set(selected).size !== selected.length))
+    throw new Error(cliM("cli_build_selection_invalid"));
+  const images = config.images.filter((image) => !selected || selected.includes(image.name));
+  for (const image of images) {
+    if (!existsSync(resolve(cwd, image.dockerfile)))
+      throw new Error(cliM("cli_build_dockerfile_missing", { params: { path: image.dockerfile } }));
+  }
+  const candidates = options.runtime && options.runtime !== "auto" ? [options.runtime] : ["podman", "docker"];
+  if (candidates.some((runtime2) => !["podman", "docker"].includes(runtime2)))
+    throw new Error(cliM("cli_build_runtime_missing"));
+  let runtime;
+  for (const candidate of candidates) {
+    try {
+      await run(candidate, ["version"], cwd, true);
+      runtime = candidate;
+      break;
+    } catch {
+    }
+  }
+  if (!runtime)
+    throw new Error(cliM("cli_build_runtime_missing"));
+  if (options.sqlitePrebuildMirror) {
+    const url = new URL(options.sqlitePrebuildMirror);
+    if (!["http:", "https:"].includes(url.protocol) || url.username || url.password || url.search || url.hash)
+      throw new Error(cliM("cli_build_mirror_invalid"));
+  }
+  const buildId = `${appVersion}-${Date.now()}-${randomBytes(3).toString("hex")}`;
+  const artifact = { version: 3, appVersion, buildId, partial: images.length !== config.images.length, hasWeb: config.images.some((image) => image.name === "web"), images: [] };
+  for (const image of config.images) {
+    if (image.containerPort !== void 0)
+      artifact[image.name === "app" ? "appContainerPort" : "webContainerPort"] = image.containerPort;
+  }
+  const parent = join(cwd, ".hai/build/docker");
+  mkdirSync(parent, { recursive: true });
+  const staging = mkdtempSync(join(parent, ".building-"));
+  const built = [];
+  try {
+    for (const context of new Set(images.map((image) => resolve(cwd, image.context ?? "."))))
+      prepareDependencyInputs(context);
+    for (const image of images) {
+      if (!["app", "web"].includes(image.name))
+        throw new Error(cliM("cli_build_images_missing"));
+      const context = resolve(cwd, image.context ?? ".");
+      const imageRef = `localhost/hai-${basenameSafe(cwd)}-${image.name}:${buildId.toLowerCase().replaceAll("+", "_")}`;
+      const args = ["build", "-f", resolve(cwd, image.dockerfile), "-t", imageRef];
+      if (options.network !== void 0)
+        args.push("--network", options.network);
+      const ignore = `${resolve(cwd, image.dockerfile)}.dockerignore`;
+      if (runtime === "podman" && existsSync(ignore))
+        args.push("--ignorefile", ignore);
+      if (runtime === "podman") {
+        args.push("--format", "docker", "--jobs", "1", ...options.httpProxy === false ? ["--http-proxy=false"] : []);
+        if (options.httpProxy !== false) {
+          for (const key of ["HTTP_PROXY", "HTTPS_PROXY", "FTP_PROXY", "NO_PROXY", "http_proxy", "https_proxy", "ftp_proxy", "no_proxy"]) {
+            if (process4.env[key])
+              args.push("--build-arg", `${key}=${process4.env[key]}`);
+          }
+        }
+      }
+      if (options.sqlitePrebuildMirror)
+        args.push("--build-arg", `SQLITE_PREBUILD_MIRROR=${options.sqlitePrebuildMirror}`);
+      built.push(imageRef);
+      await run(runtime, [...args, context], cwd);
+      const file = `${image.name}-${appVersion}.tar`;
+      await run(runtime, ["save", ...runtime === "podman" ? ["--format", "docker-archive"] : [], "-o", join(staging, file), imageRef], cwd);
+      const hash = createHash("sha256");
+      for await (const chunk of createReadStream(join(staging, file)))
+        hash.update(chunk);
+      artifact.images.push({ name: image.name, file, imageRef, sha256: hash.digest("hex"), ...image.containerPort ? { containerPort: image.containerPort } : {} });
+    }
+    const output = join(parent, buildId);
+    writeFileSync(join(staging, "manifest.json"), `${JSON.stringify(artifact, null, 2)}
+`);
+    renameSync(staging, output);
+    writeFileSync(join(parent, `latest-${buildId}`), `${buildId}
+`);
+    renameSync(join(parent, `latest-${buildId}`), join(parent, "latest"));
+    writeCliMessage(cliM("cli_build_ready", { params: { path: output, runtime } }));
+  } catch (error) {
+    for (const imageRef of built) {
+      try {
+        await run(runtime, ["image", "rm", imageRef], cwd, true);
+      } catch {
+      }
+    }
+    throw error;
+  } finally {
+    rmSync(staging, { recursive: true, force: true });
+  }
+}
+function prepareDependencyInputs(cwd) {
+  const destination = join(cwd, "images", "dependencies");
+  mkdirSync(destination, { recursive: true });
+  const tracking = join(destination, ".managed.json");
+  const previous = existsSync(tracking) ? JSON.parse(readFileSync(tracking, "utf8")) : [];
+  const files = [];
+  const walk = (directory) => {
+    for (const entry of readdirSync(directory, { withFileTypes: true })) {
+      const source = join(directory, entry.name);
+      if (source === destination || ["node_modules", ".git", ".hai", ".turbo", ".svelte-kit", ".pnpm-store", ".cache", "dist", "build", "data", "tmp", "test-results", "playwright-report"].includes(entry.name))
+        continue;
+      if (entry.isDirectory()) {
+        walk(source);
+        continue;
+      }
+      if (!entry.isFile() || !(entry.name === "package.json" || entry.name === ".pnpmfile.cjs" || /\.(?:tgz|patch)$/.test(entry.name)))
+        continue;
+      const file = relative(cwd, source);
+      mkdirSync(dirname(join(destination, file)), { recursive: true });
+      const target = join(destination, file);
+      if (!existsSync(target) || !readFileSync(source).equals(readFileSync(target)))
+        copyFileSync(source, target);
+      files.push(file);
+    }
+  };
+  walk(cwd);
+  for (const file of previous) {
+    const target = resolve(destination, file);
+    if (!files.includes(file) && !relative(destination, target).startsWith(".."))
+      rmSync(target, { force: true });
+  }
+  const content = `${JSON.stringify(files)}
+`;
+  if (!existsSync(tracking) || readFileSync(tracking, "utf8") !== content)
+    writeFileSync(tracking, content);
+}
+function basenameSafe(directory) {
+  return directory.slice(dirname(directory).length + 1).toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/^-+/, "") || "app";
+}
 function displayDeployValue(name, value) {
   if (/PASSWORD|SECRET|TOKEN|APIKEY|PRIVATEKEY|ACCESSKEY|AUTHORIZATION/i.test(name.replace(/[^a-z0-9]/gi, "")) || /(?:^|_)PASS$/i.test(name) || value.includes("PRIVATE KEY"))
     return cliM("cli_deploy_secret");
@@ -2421,10 +2566,10 @@ function ensureConfigNode(appDir, requirement, backend) {
   if (document.errors.length)
     throw new Error(cliM("cli_deploy_invalid_value"));
   if (requirement.configPath.length && !document.hasIn(requirement.configPath))
-    document.setIn(requirement.configPath, requirement.configName === "reach" ? { name: requirement.config.name ?? requirement.service, type: backend } : {});
+    document.setIn(requirement.configPath, document.createNode(requirement.configName === "reach" ? { name: requirement.config.name ?? requirement.service, type: backend } : {}));
   if (requirement.service === "ldap") {
     if (!document.hasIn(["login"]))
-      document.setIn(["login"], {});
+      document.set("login", document.createNode({}));
     if (!document.hasIn(["login", "ldap"]))
       document.setIn(["login", "ldap"], `\${HAI_IAM_LOGIN_LDAP:false}`);
   }
@@ -2447,7 +2592,7 @@ async function configureDeployMiddleware(module, scan, environment, config, yes
     const current = choices.find((item) => item.backend === requirement.backend);
     if (!current)
       throw new Error(cliM("cli_deploy_cloud_unsupported", { params: { backend: requirement.backend } }));
-    core.logger.info(cliM("cli_deploy_middleware", { params: { service: requirement.service, backend: current.label, purpose: module.describeMiddlewareBackend(current), source: requirement.source } }));
+    writeCliMessage(cliM("cli_deploy_middleware", { params: { service: requirement.service, backend: current.label, purpose: module.describeMiddlewareBackend(current), source: requirement.source } }));
     const canKeep = canKeepMiddleware(requirement, current, environment);
     const mode = yes ? canKeep ? "keep" : "default" : await ask({
       type: "select",
@@ -2486,8 +2631,11 @@ async function configureDeployMiddleware(module, scan, environment, config, yes
       if (deployment.errors.length)
         throw new Error(cliM("cli_deploy_invalid_value"));
       if (!deployment.hasIn(["container", "s3Engine"])) {
-        if (!deployment.hasIn(["container"]))
-          deployment.setIn(["container"], {});
+        const node = deployment.get("container", true);
+        if (node === void 0 || isScalar(node) && node.value === null)
+          deployment.set("container", deployment.createNode({}));
+        else if (!isMap(node))
+          throw new Error(cliM("cli_deploy_yaml_node", { params: { path: deploymentFile, field: "container" } }));
         deployment.setIn(["container", "s3Engine"], `\${HAI_DEPLOY_CONTAINER_S3ENGINE:rustfs}`);
         writeFileSync(deploymentFile, deployment.toString());
       }
@@ -2501,9 +2649,10 @@ async function configureDeployMiddleware(module, scan, environment, config, yes
       for (const name of CLOUD_FIELDS[backend.provisioner]) {
         const key = `HAI_DEPLOY_SERVICES_${requirement.service.toUpperCase()}_${name.toUpperCase()}`;
         const initial = String(priorConfig[name] ?? environment.values[key] ?? "");
-        const value = yes ? initial : String(await ask({ type: /key|token|secret/i.test(name) ? "password" : "text", name: "value", message: key, initial, validate: (input) => Boolean(input) || cliM("cli_deploy_required") }));
+        const label = `${backend.label} \u2014 ${cliM(`cli_deploy_cloud_input_${name}`)}`;
+        const value = yes ? initial : String(await ask({ type: /key|token|secret/i.test(name) ? "password" : "text", name: "value", message: label, initial, validate: (input) => Boolean(input) || cliM("cli_deploy_required") }));
         if (!value)
-          throw new Error(`${key}: ${cliM("cli_deploy_required")}`);
+          throw new Error(`${label}: ${cliM("cli_deploy_required")}`);
         cloud[name] = value;
         updates[key] = value;
       }
@@ -2531,7 +2680,7 @@ async function configureDeployMiddleware(module, scan, environment, config, yes
     if (!saved.success)
       throw new Error(saved.error.message);
     for (const [name, value] of Object.entries(updates)) {
-      core.logger.info(cliM("cli_deploy_saved", { params: { name, value: displayDeployValue(name, value) } }));
+      writeCliMessage(cliM("cli_deploy_saved", { params: { name, value: displayDeployValue(name, value) } }));
     }
   }
   config.services = Object.keys(services).length ? services : void 0;
@@ -2542,15 +2691,21 @@ async function configureDeployMiddleware(module, scan, environment, config, yes
 function configObject(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
-async function configureDeployTarget(module, config, environment, nonInteractive) {
+async function configureDeployTarget(module, config, environment, nonInteractive, bundleOnly) {
+  if (bundleOnly) {
+    const existing = configObject(config.provider);
+    if (existing.type && existing.type !== "docker-ssh")
+      throw new Error(cliM("cli_deploy_bundle_provider"));
+    config.provider = { type: "docker-ssh", remote: { runtime: "auto" }, expose: { hostPort: 3e3 }, ...existing };
+  }
   const current = module.ProviderConfigSchema.safeParse(config.provider);
-  if (current.success) {
+  if (current.success && (bundleOnly || current.data.type !== "docker-ssh" || current.data.ssh)) {
     config.provider = current.data;
-    core.logger.info(cliM("cli_deploy_target_reused", { params: { target: current.data.type === "docker-ssh" ? `${current.data.ssh.username}@${current.data.ssh.host}:${current.data.ssh.port}` : "Vercel" } }));
+    writeCliMessage(cliM("cli_deploy_target_reused", { params: { target: current.data.type === "docker-ssh" ? current.data.ssh ? `${current.data.ssh.username}@${current.data.ssh.host}:${current.data.ssh.port}` : cliM("cli_deploy_bundle_local") : "Vercel" } }));
     return;
   }
   if (nonInteractive)
-    throw new Error(cliM("cli_deploy_target_missing", { params: { fields: current.error.issues.map((issue) => `provider.${issue.path.join(".")}`).join(", ") } }));
+    throw new Error(cliM("cli_deploy_target_missing", { params: { fields: current.success ? "provider.ssh" : current.error.issues.map((issue) => `provider.${issue.path.join(".")}`).join(", ") } }));
   const original = configObject(config.provider);
   const platform = await prompts({
     type: "select",
@@ -2565,9 +2720,9 @@ async function configureDeployTarget(module, config, environment, nonInteractive
     const answer = await prompts({
       type: options.secret ? "password" : "text",
       name: "value",
-      message: cliM("cli_deploy_target_field", { params: { name } }),
+      message: cliM(`cli_deploy_input${name.split("_").at(-1)}`),
       initial: options.secret ? void 0 : initial === void 0 ? "" : String(initial),
-      validate: (value) => options.port ? /^\d+$/.test(value) && Number(value) >= 1 && Number(value) <= 65535 || cliM("cli_deploy_invalid_value") : options.optional || !!value.trim() || cliM("cli_deploy_invalid_value")
+      validate: (value) => options.port ? /^\d+$/.test(value) && Number(value) >= 1 && Number(value) <= 65535 || cliM("cli_deploy_port_invalid") : options.optional || !!value.trim() || cliM("cli_deploy_invalid_value")
     });
     if (answer.value === void 0)
       throw new Error(cliM("cli_deploy_cancelled"));
@@ -2575,7 +2730,7 @@ async function configureDeployTarget(module, config, environment, nonInteractive
   };
   let provider;
   if (platform.value === "docker-ssh") {
-    core.logger.info(cliM("cli_deploy_target_ssh_hint"));
+    writeCliMessage(cliM("cli_deploy_target_ssh_hint"));
     const ssh = configObject(original.ssh);
     const remote = configObject(original.remote);
     const expose = configObject(original.expose);
@@ -2606,38 +2761,59 @@ async function configureDeployTarget(module, config, environment, nonInteractive
   if (!saved.success)
     throw new Error(saved.error.message);
   config.provider = validated.data;
-  core.logger.info(cliM("cli_deploy_target_saved"));
+  writeCliMessage(cliM("cli_deploy_target_saved"));
 }
 async function deployCommand(options) {
   const spinner = ora();
-  const cwd = options.cwd ?? process3.cwd();
+  const cwd = options.cwd ?? process4.cwd();
   let appDir = resolve(cwd, options.appDir ?? ".");
   let closeDeploy = null;
-  const originalEnv = { ...process3.env };
+  let restoreProjectLogger;
+  const originalEnv = { ...process4.env };
+  const previousLogLevel = core.logger.getLevel();
+  core.logger.setLevel("fatal");
   try {
+    if (options.runtime && !["auto", "podman", "docker"].includes(options.runtime))
+      throw new Error(cliM("cli_build_runtime_missing"));
+    if (options.artifactDir && options.build)
+      throw new Error(cliM("cli_deploy_build_artifact_conflict"));
+    if (!options.build && (options.network !== void 0 || options.sqlitePrebuildMirror !== void 0 || options.httpProxy === false))
+      throw new Error(cliM("cli_deploy_build_options_required"));
+    let selectedServices = options.services?.split(",").map((name) => name.trim());
+    if (selectedServices && (!selectedServices.length || selectedServices.some((name) => !/^[a-z][a-z0-9-]*$/.test(name)) || new Set(selectedServices).size !== selectedServices.length))
+      throw new Error(cliM("cli_build_selection_invalid"));
     let environmentName = options.env;
     if (!environmentName) {
-      if (!process3.stdin.isTTY)
+      if (!process4.stdin.isTTY)
         throw new Error(cliM("cli_deploy_environment_hint"));
       const answer = await prompts({ type: "text", name: "environment", message: cliM("cli_deploy_environment"), initial: "prod" });
       environmentName = answer.environment;
       if (!environmentName)
         throw new Error(cliM("cli_deploy_cancelled"));
     }
-    if (!options.yes && !process3.stdin.isTTY)
+    if (!options.yes && !process4.stdin.isTTY)
       throw new Error(cliM("cli_deploy_environment_hint"));
     let deployModule;
     try {
       const localRequire = createRequire(resolve(appDir, "package.json"));
+      try {
+        const { core: projectCore } = await import(pathToFileURL(localRequire.resolve("@h-ai/core")).href);
+        if (projectCore !== core) {
+          const level = projectCore.logger.getLevel();
+          projectCore.logger.setLevel("fatal");
+          restoreProjectLogger = () => projectCore.logger.setLevel(level);
+        }
+      } catch {
+      }
       let localModule;
       try {
         localModule = localRequire.resolve("@h-ai/deploy");
       } catch {
       }
-      deployModule = localModule ? await import(pathToFileURL(localModule).href) : await import('./src-6PPBKQ6Q.js');
+      deployModule = localModule ? await import(pathToFileURL(localModule).href) : await import('./src-2V6VP4I5.js');
     } catch {
-      core.logger.error(chalk.red(cliM("cli_deploy_module_missing")));
-      core.logger.info(chalk.cyan("  pnpm add @h-ai/deploy"));
+      writeCliError(chalk.red(cliM("cli_deploy_module_missing")));
+      writeCliMessage(chalk.cyan("  pnpm add -D @h-ai/deploy"));
       throw new Error(cliM("cli_deploy_module_missing"));
     }
     const { deploy } = deployModule;
@@ -2646,10 +2822,19 @@ async function deployCommand(options) {
       throw new Error(cliM("cli_deploy_scan_failed", { params: { message: scanResult.error.message } }));
     const scan = scanResult.data;
     appDir = scan.appDir ?? appDir;
+    let buildRoot = appDir;
+    while (!existsSync(resolve(buildRoot, "hai.build.json")) && dirname(buildRoot) !== buildRoot)
+      buildRoot = dirname(buildRoot);
+    const buildFile = resolve(buildRoot, "hai.build.json");
+    const buildConfig = existsSync(buildFile) ? JSON.parse(readFileSync(buildFile, "utf8")) : {};
+    const names = [...buildConfig.images?.map((image) => image.name) ?? ["app", "web"], ...(scan.middlewares ?? []).filter((item) => !["sqlite", "local", "memory", "disabled", "console", "lancedb"].includes(item.backend)).map((item) => item.service)];
+    const available = [...new Set(names)];
+    if (selectedServices?.some((name) => !available.includes(name)))
+      throw new Error(cliM("cli_deploy_services_invalid", { params: { services: available.join(", ") } }));
     const environment = deployModule.loadDeploymentEnvironment({ environment: environmentName, envDir: scan.envDir ?? appDir });
     if (!environment.success)
       throw new Error(environment.error.message);
-    Object.assign(process3.env, environment.data.values);
+    Object.assign(process4.env, environment.data.values);
     spinner.start(cliM("cli_deploy_load_credentials"));
     const credResult = deploy.credentials.load();
     if (!credResult.success) {
@@ -2660,17 +2845,59 @@ async function deployCommand(options) {
     const configPath = resolve(appDir, "config", "_deploy.yml");
     if (!existsSync(configPath)) {
       spinner.fail(chalk.red(cliM("cli_deploy_config_missing", { params: { path: configPath } })));
-      core.logger.info(chalk.cyan(cliM("cli_deploy_config_hint")));
+      writeCliMessage(chalk.cyan(cliM("cli_deploy_config_hint")));
       throw new Error(cliM("cli_deploy_config_missing", { params: { path: configPath } }));
     }
-    const loadedConfig = deployModule.loadDeploymentConfig("deploy", configPath, process3.env);
+    const loadedConfig = deployModule.loadDeploymentConfig("deploy", configPath, process4.env);
     if (!loadedConfig.success)
       throw new Error(loadedConfig.error.message);
     const deployConfig = loadedConfig.data;
     spinner.succeed(cliM("cli_deploy_config_loaded"));
-    await configureDeployTarget(deployModule, deployConfig, environment.data, options.yes);
+    if (!options.build && !selectedServices && configObject(deployConfig.provider).type === "docker-ssh") {
+      let artifactDirectory = options.artifactDir ? resolve(cwd, options.artifactDir) : resolve(buildRoot, ".hai/build/docker");
+      if (existsSync(resolve(artifactDirectory, "latest"))) {
+        const pointer = readFileSync(resolve(artifactDirectory, "latest"), "utf8").trim();
+        if (!/^[a-z0-9][\w.+-]*$/i.test(pointer))
+          throw new Error(cliM("cli_deploy_artifact_invalid"));
+        artifactDirectory = resolve(artifactDirectory, pointer);
+      }
+      if (existsSync(resolve(artifactDirectory, "manifest.json"))) {
+        try {
+          const artifact = await deployModule.readDeploymentArtifact(artifactDirectory);
+          if (artifact.partial)
+            selectedServices = artifact.images.map((image) => image.name);
+        } catch {
+          throw new Error(cliM("cli_deploy_artifact_invalid"));
+        }
+      }
+    }
+    await configureDeployTarget(deployModule, deployConfig, environment.data, options.yes, options.bundleOnly);
+    if (configObject(deployConfig.provider).type !== "docker-ssh" && (selectedServices || options.build))
+      throw new Error(cliM("cli_deploy_bundle_provider"));
+    if (!options.yes && !selectedServices && configObject(deployConfig.provider).type === "docker-ssh") {
+      if (existsSync(buildFile)) {
+        if (available.length > 1) {
+          const choice = await prompts({ type: "multiselect", name: "value", message: cliM("cli_deploy_choose_services"), choices: available.map((name) => ({ title: name, value: name, selected: true })), min: 1 });
+          if (!Array.isArray(choice.value) || choice.value.length === 0)
+            throw new Error(cliM("cli_deploy_cancelled"));
+          if (choice.value.length !== available.length)
+            selectedServices = choice.value;
+        }
+      }
+    }
     spinner.succeed(cliM("cli_deploy_scanned", { params: { name: scan.appName, sveltekit: String(scan.isSvelteKit), services: scan.requiredServices.join(", ") || cliM("cli_deploy_none") } }));
-    let skipMiddleware = options.skipMiddleware || options.skipProvision;
+    if (options.build) {
+      if (!existsSync(buildFile))
+        throw new Error(cliM("cli_build_images_missing"));
+      const imageNames = selectedServices?.filter((name) => ["app", "web"].includes(name));
+      if (!selectedServices || imageNames?.length) {
+        writeCliMessage(cliM("cli_deploy_build_started"));
+        await buildCommand({ cwd: buildRoot, target: "docker", images: imageNames?.join(","), runtime: options.runtime, network: options.network, sqlitePrebuildMirror: options.sqlitePrebuildMirror, httpProxy: options.httpProxy });
+      }
+    }
+    if (selectedServices)
+      writeCliMessage(cliM("cli_deploy_services", { params: { services: selectedServices.join(", ") } }));
+    let skipMiddleware = options.skipMiddleware || selectedServices?.every((name) => ["app", "web"].includes(name));
     if (!skipMiddleware && !options.yes && scan.requiredServices.length) {
       const action = await prompts({
         type: "select",
@@ -2683,23 +2910,23 @@ async function deployCommand(options) {
       skipMiddleware = action.value === "skip";
     }
     if (skipMiddleware)
-      core.logger.info(cliM("cli_deploy_middleware_skipped"));
-    const serviceModes = skipMiddleware ? Object.fromEntries(scan.requiredServices.map((service) => [service, "keep"])) : await configureDeployMiddleware(deployModule, scan, environment.data, deployConfig, options.yes);
+      writeCliMessage(cliM("cli_deploy_middleware_skipped"));
+    const serviceModes = skipMiddleware ? Object.fromEntries(scan.requiredServices.map((service) => [service, "keep"])) : await configureDeployMiddleware(deployModule, { ...scan, middlewares: scan.middlewares?.filter((item) => !selectedServices || selectedServices.includes(item.service)) }, environment.data, deployConfig, options.yes);
     if (skipMiddleware)
       deployConfig.services = void 0;
-    for (const key of Object.keys(process3.env)) {
+    for (const key of Object.keys(process4.env)) {
       if (originalEnv[key] === void 0)
-        delete process3.env[key];
+        delete process4.env[key];
     }
-    Object.assign(process3.env, originalEnv);
+    Object.assign(process4.env, originalEnv);
     const refreshed = deployModule.loadDeploymentEnvironment({ environment: environment.data.environment, envDir: environment.data.envDir });
     if (!refreshed.success)
       throw new Error(refreshed.error.message);
-    Object.assign(process3.env, refreshed.data.values);
+    Object.assign(process4.env, refreshed.data.values);
     spinner.start(cliM("cli_deploy_initializing"));
     const validatedConfig = deployModule.DeployConfigSchema.safeParse(deployConfig);
     if (!validatedConfig.success)
-      throw new Error(cliM("cli_deploy_init_failed", { params: { message: cliM("cli_deploy_invalid_value") } }));
+      throw new Error(cliM("cli_deploy_config_invalid", { params: { path: configPath, fields: validatedConfig.error.issues.map((issue) => issue.path.join(".")).join(", ") } }));
     const initResult = await deploy.init(validatedConfig.data);
     if (!initResult.success) {
       throw new Error(cliM("cli_deploy_init_failed", { params: { message: initResult.error.message } }));
@@ -2709,26 +2936,29 @@ async function deployCommand(options) {
     spinner.start(cliM("cli_deploy_deploying"));
     const deployResult = await deploy.deployApp(appDir, {
       projectName: options.projectName,
-      skipProvision: skipMiddleware,
-      skipBuild: options.skipBuild,
+      selectedServices,
+      runtime: options.runtime,
+      onProgress: (stage) => writeCliMessage(cliM(`cli_deploy_stage_${stage}`)),
+      skipMiddleware,
+      artifactDir: options.artifactDir ? resolve(cwd, options.artifactDir) : void 0,
+      bundleOnly: options.bundleOnly,
+      output: options.output ? resolve(cwd, options.output) : void 0,
       environment: environment.data.environment,
       envDir: environment.data.envDir,
       serviceModes
     });
     if (!deployResult.success) {
       if (deployResult.error.ext?.recovery) {
-        core.logger.warn(deployResult.error.suggestion ?? cliM("cli_deploy_command_failed"), {
-          recovery: deployResult.error.ext.recovery
-        });
+        writeCliMessage(deployResult.error.suggestion ?? cliM("cli_deploy_command_failed"));
       }
       throw new Error(cliM("cli_deploy_failed", { params: { message: deployResult.error.message } }));
     }
-    spinner.succeed(chalk.green(cliM("cli_deploy_success")));
-    for (const key of Object.keys(process3.env)) {
+    spinner.succeed(chalk.green(cliM(deployResult.data.status === "packaged" ? "cli_deploy_bundle_ready" : "cli_deploy_success")));
+    for (const key of Object.keys(process4.env)) {
       if (originalEnv[key] === void 0)
-        delete process3.env[key];
+        delete process4.env[key];
     }
-    Object.assign(process3.env, originalEnv);
+    Object.assign(process4.env, originalEnv);
     const completedEnvironment = deployModule.loadDeploymentEnvironment({ environment: environment.data.environment, envDir: environment.data.envDir });
     if (!completedEnvironment.success)
       throw new Error(completedEnvironment.error.message);
@@ -2737,33 +2967,40 @@ async function deployCommand(options) {
         continue;
       const value = completedEnvironment.data.values[requirement.envPrefix];
       if (value !== void 0)
-        core.logger.info(cliM("cli_deploy_saved", { params: { name: requirement.envPrefix, value: displayDeployValue(requirement.envPrefix, value) } }));
+        writeCliMessage(cliM("cli_deploy_saved", { params: { name: requirement.envPrefix, value: displayDeployValue(requirement.envPrefix, value) } }));
     }
-    core.logger.info("");
-    core.logger.info(chalk.cyan(cliM("cli_deploy_url", { params: { url: deployResult.data.url } })));
-    core.logger.info(chalk.gray(cliM("cli_deploy_id", { params: { id: deployResult.data.deploymentId } })));
+    writeCliMessage("");
+    if (deployResult.data.bundlePath)
+      writeCliMessage(cliM("cli_deploy_bundle_path", { params: { path: deployResult.data.bundlePath } }));
+    if (deployResult.data.status === "packaged")
+      writeCliMessage(deployResult.data.instructions ?? "");
+    else
+      writeCliMessage(chalk.cyan(cliM("cli_deploy_url", { params: { url: deployResult.data.url } })));
+    writeCliMessage(chalk.gray(cliM("cli_deploy_id", { params: { id: deployResult.data.deploymentId } })));
     if (deployResult.data.envVarsSet.length > 0) {
-      core.logger.info(chalk.gray(cliM("cli_deploy_env", { params: { names: deployResult.data.envVarsSet.join(", ") } })));
+      writeCliMessage(chalk.gray(cliM("cli_deploy_env", { params: { names: deployResult.data.envVarsSet.join(", ") } })));
     }
-    core.logger.info("");
+    writeCliMessage("");
   } catch (error) {
     spinner.fail(chalk.red(cliM("cli_deploy_command_failed")));
-    core.logger.error(error instanceof Error ? error.message : String(error));
+    writeCliError(error instanceof Error ? error.message : String(error));
     throw error;
   } finally {
     if (closeDeploy) {
       try {
         await closeDeploy();
       } catch (error) {
-        core.logger.error("Failed to close deploy module", { error });
-        process3.exitCode = 1;
+        writeCliError("Failed to close deploy module", error);
+        process4.exitCode = 1;
       }
     }
-    for (const key of Object.keys(process3.env)) {
+    for (const key of Object.keys(process4.env)) {
       if (originalEnv[key] === void 0)
-        delete process3.env[key];
+        delete process4.env[key];
     }
-    Object.assign(process3.env, originalEnv);
+    Object.assign(process4.env, originalEnv);
+    core.logger.setLevel(previousLogLevel);
+    restoreProjectLogger?.();
   }
 }
 var GENERATORS = {
@@ -2799,7 +3036,7 @@ async function generate(options) {
   try {
     const project = await detectProject(cwd);
     if (!project?.isHaiProject) {
-      core.logger.warn(chalk.yellow("\u8B66\u544A: \u5F53\u524D\u76EE\u5F55\u4E0D\u662F hai \u9879\u76EE"));
+      writeCliMessage(chalk.yellow("\u8B66\u544A: \u5F53\u524D\u76EE\u5F55\u4E0D\u662F hai \u9879\u76EE"));
     }
     const resolvedOptions = await resolveGenerateOptions(options);
     const generator = GENERATORS[resolvedOptions.type];
@@ -2826,8 +3063,8 @@ async function generate(options) {
       while (!await fse.pathExists(ancestor))
         ancestor = path2.dirname(ancestor);
       const realAncestor = await fse.realpath(ancestor);
-      const relative = path2.relative(realCwd, realAncestor);
-      if (relative === ".." || relative.startsWith(`..${path2.sep}`) || path2.isAbsolute(relative))
+      const relative2 = path2.relative(realCwd, realAncestor);
+      if (relative2 === ".." || relative2.startsWith(`..${path2.sep}`) || path2.isAbsolute(relative2))
         throw new Error(cliM("cli_generateOutsideWorkspace"));
     }
     for (const file of files) {
@@ -2835,17 +3072,17 @@ async function generate(options) {
       await fse.writeFile(file.path, file.content, { encoding: "utf-8", flag: resolvedOptions.force ? "w" : "wx" });
     }
     spinner.succeed();
-    core.logger.info("", {});
-    core.logger.info(chalk.green("\u2714 \u751F\u6210\u5B8C\u6210\uFF01"));
-    core.logger.info("", {});
-    core.logger.info("\u521B\u5EFA\u7684\u6587\u4EF6:");
+    writeCliMessage("");
+    writeCliMessage(chalk.green("\u2714 \u751F\u6210\u5B8C\u6210\uFF01"));
+    writeCliMessage("");
+    writeCliMessage("\u521B\u5EFA\u7684\u6587\u4EF6:");
     files.forEach((file) => {
-      core.logger.info(chalk.cyan(`  ${path2.relative(cwd, file.path)}`));
+      writeCliMessage(chalk.cyan(`  ${path2.relative(cwd, file.path)}`));
     });
-    core.logger.info("", {});
+    writeCliMessage("");
   } catch (error) {
     spinner.fail();
-    core.logger.error(chalk.red("\u751F\u6210\u5931\u8D25:"), { error });
+    writeCliError(chalk.red("\u751F\u6210\u5931\u8D25:"), { error });
     throw error;
   }
 }
@@ -3107,39 +3344,39 @@ async function initProject(options) {
     const { project, existing, missing } = result;
     spinner.succeed(`\u68C0\u6D4B\u5230\u9879\u76EE: ${chalk.cyan(project.name)}`);
     if (project.isHaiProject) {
-      const { generateProjectAiSupport, resolveSkillNamesForPackages } = await import('./cli-skill-templates-A5VIR5J6.js');
+      const { generateProjectAiSupport, resolveSkillNamesForPackages } = await import('./cli-skill-templates-FC3QRKDO.js');
       const generatedFiles = await generateProjectAiSupport(cwd, resolveSkillNamesForPackages(project.haiPackages), {
         overwriteSkills: false,
         overwriteBridgeFiles: false
       });
       for (const generatedFile of generatedFiles) {
-        core.logger.info(chalk.gray(`  + ${generatedFile}`));
+        writeCliMessage(chalk.gray(`  + ${generatedFile}`));
       }
     }
-    core.logger.info("");
-    core.logger.info(chalk.bold("\u9879\u76EE\u72B6\u6001:"));
-    core.logger.info(`  \u540D\u79F0: ${chalk.cyan(project.name)}`);
-    core.logger.info(`  \u7248\u672C: ${project.version}`);
-    core.logger.info(`  \u5DF2\u5B89\u88C5\u6A21\u5757: ${project.haiPackages.length > 0 ? project.haiPackages.map((p) => chalk.cyan(p)).join(", ") : chalk.gray("\u65E0")}`);
-    core.logger.info("");
+    writeCliMessage("");
+    writeCliMessage(chalk.bold("\u9879\u76EE\u72B6\u6001:"));
+    writeCliMessage(`  \u540D\u79F0: ${chalk.cyan(project.name)}`);
+    writeCliMessage(`  \u7248\u672C: ${project.version}`);
+    writeCliMessage(`  \u5DF2\u5B89\u88C5\u6A21\u5757: ${project.haiPackages.length > 0 ? project.haiPackages.map((p) => chalk.cyan(p)).join(", ") : chalk.gray("\u65E0")}`);
+    writeCliMessage("");
     if (existing.length > 0) {
-      core.logger.info(chalk.bold("\u5DF2\u6709\u914D\u7F6E:"));
+      writeCliMessage(chalk.bold("\u5DF2\u6709\u914D\u7F6E:"));
       for (const key of existing) {
-        core.logger.info(chalk.green(`  \u2714 config/_${key}.yml`));
+        writeCliMessage(chalk.green(`  \u2714 config/_${key}.yml`));
       }
     }
     if (missing.length === 0 && !options.force) {
-      core.logger.info("");
-      core.logger.info(chalk.green("\u2714 \u6240\u6709\u914D\u7F6E\u6587\u4EF6\u5DF2\u5C31\u7EEA\uFF01"));
+      writeCliMessage("");
+      writeCliMessage(chalk.green("\u2714 \u6240\u6709\u914D\u7F6E\u6587\u4EF6\u5DF2\u5C31\u7EEA\uFF01"));
       return;
     }
     if (missing.length > 0) {
-      core.logger.info("");
-      core.logger.info(chalk.bold("\u7F3A\u5931\u914D\u7F6E:"));
+      writeCliMessage("");
+      writeCliMessage(chalk.bold("\u7F3A\u5931\u914D\u7F6E:"));
       for (const item of missing) {
-        core.logger.info(chalk.yellow(`  \u2718 config/_${item.configKey}.yml (${item.label})`));
+        writeCliMessage(chalk.yellow(`  \u2718 config/_${item.configKey}.yml (${item.label})`));
       }
-      core.logger.info("");
+      writeCliMessage("");
       spinner.start("\u751F\u6210\u7F3A\u5931\u914D\u7F6E\u6587\u4EF6...");
       let generated = 0;
       for (const item of missing) {
@@ -3151,7 +3388,7 @@ async function initProject(options) {
       spinner.succeed(`\u5DF2\u751F\u6210 ${generated} \u4E2A\u914D\u7F6E\u6587\u4EF6`);
     }
     if (options.force && existing.length > 0) {
-      core.logger.info("");
+      writeCliMessage("");
       spinner.start("\u5F3A\u5236\u91CD\u65B0\u751F\u6210\u6240\u6709\u914D\u7F6E\u6587\u4EF6...");
       let regenerated = 0;
       for (const pkg of project.haiPackages) {
@@ -3172,16 +3409,16 @@ async function initProject(options) {
       await writeFile(coreConfigPath, content);
       spinner.succeed();
     }
-    core.logger.info("");
-    core.logger.info(chalk.green("\u2714 \u9879\u76EE\u914D\u7F6E\u521D\u59CB\u5316\u5B8C\u6210\uFF01"));
-    core.logger.info("");
-    core.logger.info(chalk.gray("\u4E0B\u4E00\u6B65:"));
-    core.logger.info(chalk.gray("  1. \u7F16\u8F91 config/ \u4E2D\u7684\u914D\u7F6E\u6587\u4EF6"));
-    core.logger.info(chalk.gray("  2. \u8FD0\u884C pnpm dev \u542F\u52A8\u5F00\u53D1\u670D\u52A1"));
-    core.logger.info("");
+    writeCliMessage("");
+    writeCliMessage(chalk.green("\u2714 \u9879\u76EE\u914D\u7F6E\u521D\u59CB\u5316\u5B8C\u6210\uFF01"));
+    writeCliMessage("");
+    writeCliMessage(chalk.gray("\u4E0B\u4E00\u6B65:"));
+    writeCliMessage(chalk.gray("  1. \u7F16\u8F91 config/ \u4E2D\u7684\u914D\u7F6E\u6587\u4EF6"));
+    writeCliMessage(chalk.gray("  2. \u8FD0\u884C pnpm dev \u542F\u52A8\u5F00\u53D1\u670D\u52A1"));
+    writeCliMessage("");
   } catch (error) {
     spinner.fail();
-    core.logger.error(chalk.red("\u521D\u59CB\u5316\u5931\u8D25:"), { error });
+    writeCliError(chalk.red("\u521D\u59CB\u5316\u5931\u8D25:"), { error });
     throw error;
   }
 }
@@ -3189,9 +3426,9 @@ async function initProject(options) {
 // src/cli-main.ts
 var VERSION = getCliVersion();
 var cli = cac("hai");
-cli.option("-v, --verbose", "\u663E\u793A\u8BE6\u7EC6\u8F93\u51FA");
-cli.option("-C, --cwd <path>", "\u5DE5\u4F5C\u76EE\u5F55");
-cli.command("create [name]", "\u521B\u5EFA\u65B0\u7684 hai \u9879\u76EE").option("--type <type>", "\u5E94\u7528\u7C7B\u578B (admin, website, h5, api, mobile-app, fullstack)").option("--frontends <targets>", "\u524D\u540E\u7AEF\u5206\u79BB\u5DE5\u7A0B\u524D\u7AEF\u76EE\u6807 (\u9017\u53F7\u5206\u9694: web,app,miniapp,desktop)").option("-t, --template <template>", "\u9879\u76EE\u6A21\u677F (minimal, default, full, custom)").option("-f, --features <features>", "\u529F\u80FD\u5217\u8868 (\u9017\u53F7\u5206\u9694: iam,db,cache,ai,storage,crypto)").option("--examples", "\u6DFB\u52A0\u793A\u4F8B\u4EE3\u7801").option("--no-examples", "\u4E0D\u6DFB\u52A0\u793A\u4F8B\u4EE3\u7801").option("--no-install", "\u4E0D\u5B89\u88C5\u4F9D\u8D56").option("-p, --package-manager <pm>", "\u5305\u7BA1\u7406\u5668 (pnpm, npm, yarn)").option("--no-git", "\u4E0D\u521D\u59CB\u5316 Git").option("--git-remote <url>", "Git \u8FDC\u7A0B\u4ED3\u5E93\u5730\u5740").option("-y, --yes", "\u4F7F\u7528\u9ED8\u8BA4\u914D\u7F6E\uFF0C\u8DF3\u8FC7\u4EA4\u4E92").action(async (name, options) => {
+cli.option("-v, --verbose", cliM("cli_help_verbose"));
+cli.option("-C, --cwd <path>", cliM("cli_help_cwd"));
+cli.command("create [name]", cliM("cli_help_create")).option("--type <type>", cliM("cli_help_appType")).option("--frontends <targets>", cliM("cli_help_frontends")).option("-t, --template <template>", cliM("cli_help_template")).option("-f, --features <features>", cliM("cli_help_features")).option("--examples", cliM("cli_help_examples")).option("--no-examples", cliM("cli_help_noExamples")).option("--no-install", cliM("cli_help_noInstall")).option("--no-deploy", cliM("cli_help_noDeploy")).option("-p, --package-manager <pm>", cliM("cli_help_packageManager")).option("--no-git", cliM("cli_help_noGit")).option("--git-remote <url>", cliM("cli_help_gitRemote")).option("-y, --yes", cliM("cli_help_yes")).action(async (name, options) => {
   try {
     const features = typeof options.features === "string" ? options.features.split(",").map((f) => f.trim()) : void 0;
     const frontends = typeof options.frontends === "string" ? options.frontends.split(",").map((f) => f.trim()).filter(Boolean) : void 0;
@@ -3201,6 +3438,7 @@ cli.command("create [name]", "\u521B\u5EFA\u65B0\u7684 hai \u9879\u76EE").option
       frontends,
       template: options.template,
       features,
+      deploy: options.deploy,
       examples: options.examples,
       install: options.install,
       packageManager: options.packageManager,
@@ -3211,10 +3449,10 @@ cli.command("create [name]", "\u521B\u5EFA\u65B0\u7684 hai \u9879\u76EE").option
       cwd: options.cwd
     });
   } catch {
-    process3.exitCode = 1;
+    process4.exitCode = 1;
   }
 });
-cli.command("add [module]", "\u5411\u73B0\u6709\u9879\u76EE\u6DFB\u52A0\u6A21\u5757").option("--no-install", "\u4E0D\u5B89\u88C5\u4F9D\u8D56").action(async (module, options) => {
+cli.command("add [module]", cliM("cli_help_add")).option("--no-install", cliM("cli_help_noInstall")).action(async (module, options) => {
   try {
     await addModule({
       module,
@@ -3223,10 +3461,10 @@ cli.command("add [module]", "\u5411\u73B0\u6709\u9879\u76EE\u6DFB\u52A0\u6A21\u5
       cwd: options.cwd
     });
   } catch {
-    process3.exit(1);
+    process4.exit(1);
   }
 });
-cli.command("init", "\u521D\u59CB\u5316/\u6821\u9A8C\u9879\u76EE\u914D\u7F6E").option("-f, --force", "\u5F3A\u5236\u91CD\u65B0\u751F\u6210\u914D\u7F6E").action(async (options) => {
+cli.command("init", cliM("cli_help_init")).option("-f, --force", cliM("cli_help_forceConfig")).action(async (options) => {
   try {
     await initProject({
       force: options.force,
@@ -3234,10 +3472,10 @@ cli.command("init", "\u521D\u59CB\u5316/\u6821\u9A8C\u9879\u76EE\u914D\u7F6E").o
       cwd: options.cwd
     });
   } catch {
-    process3.exit(1);
+    process4.exit(1);
   }
 });
-cli.command("generate [type] [name]", "\u751F\u6210\u4EE3\u7801").alias("g").option("-o, --output <path>", "\u8F93\u51FA\u8DEF\u5F84").option("-f, --force", "\u8986\u76D6\u73B0\u6709\u6587\u4EF6").action(async (type, name, options) => {
+cli.command("generate [type] [name]", cliM("cli_help_generate")).alias("g").option("-o, --output <path>", cliM("cli_help_output")).option("-f, --force", cliM("cli_help_force")).action(async (type, name, options) => {
   try {
     await generate({
       type,
@@ -3248,10 +3486,18 @@ cli.command("generate [type] [name]", "\u751F\u6210\u4EE3\u7801").alias("g").opt
       cwd: options.cwd
     });
   } catch {
-    process3.exit(1);
+    process4.exit(1);
   }
 });
-cli.command("deploy [appDir]", "\u90E8\u7F72\u5E94\u7528\u5230\u4E91\u5E73\u53F0").option("--env <environment>", "\u90E8\u7F72\u73AF\u5883\uFF08test / prod \u7B49\uFF0C\u5FC5\u987B\u5B58\u5728\u5BF9\u5E94\u73AF\u5883\u6587\u4EF6\uFF09").option("--env-dir <path>", "\u73AF\u5883\u6587\u4EF6\u6240\u5728\u76EE\u5F55\uFF08\u9ED8\u8BA4\u81EA\u52A8\u67E5\u627E\uFF09").option("-y, --yes", "\u6309\u5F53\u524D\u540E\u7AEF\u9ED8\u8BA4\u914D\u7F6E\u90E8\u7F72\uFF0C\u76EE\u6807\u73AF\u5883\u5DF2\u6709\u5B8C\u6574\u914D\u7F6E\u65F6\u4FDD\u6301\u4E0D\u53D8").option("--project-name <name>", "\u9879\u76EE\u540D\u79F0\uFF08\u9ED8\u8BA4\u4F7F\u7528\u5E94\u7528\u76EE\u5F55\u540D\uFF09").option("--skip-provision", "\u914D\u7F6E\u5DF2\u5B8C\u5907\uFF0C\u8DF3\u8FC7\u4E2D\u95F4\u4EF6\u914D\u7F6E\u4E0E\u5F00\u901A\uFF0C\u76F4\u63A5\u90E8\u7F72").option("--skip-middleware", "\u914D\u7F6E\u5DF2\u5B8C\u5907\uFF0C\u8DF3\u8FC7\u5168\u90E8\u4E2D\u95F4\u4EF6\u5904\u7406\uFF0C\u76F4\u63A5\u90E8\u7F72").option("--skip-build", "\u8DF3\u8FC7\u6784\u5EFA").action(async (appDir, options) => {
+cli.command("build", cliM("cli_help_build")).option("--target <target>", cliM("cli_help_target")).option("--images <names>", cliM("cli_help_images")).option("--runtime <runtime>", cliM("cli_help_buildRuntime")).option("--network <network>", cliM("cli_help_buildNetwork")).option("--platform <platform>", cliM("cli_help_platform")).option("--arch <arch>", cliM("cli_help_arch")).option("--sqlite-prebuild-mirror <url>", cliM("cli_help_sqliteMirror")).option("--no-http-proxy", cliM("cli_help_noHttpProxy")).action(async (options) => {
+  try {
+    await buildCommand(options);
+  } catch (error) {
+    writeCliMessage(error instanceof Error ? error.message : String(error));
+    process4.exitCode = 1;
+  }
+});
+cli.command("deploy [appDir]", cliM("cli_help_deploy")).option("--env <environment>", cliM("cli_help_environment")).option("--env-dir <path>", cliM("cli_help_envDir")).option("-y, --yes", cliM("cli_help_deployYes")).option("--project-name <name>", cliM("cli_help_projectName")).option("--skip-middleware", cliM("cli_help_skipMiddleware")).option("--artifact-dir <path>", cliM("cli_help_artifactDir")).option("--services <names>", cliM("cli_help_services")).option("--build", cliM("cli_help_deployBuild")).option("--network <network>", cliM("cli_help_deployNetwork")).option("--sqlite-prebuild-mirror <url>", cliM("cli_help_deploySqliteMirror")).option("--no-http-proxy", cliM("cli_help_deployNoProxy")).option("--runtime <runtime>", cliM("cli_help_deployRuntime")).option("--bundle-only", cliM("cli_help_bundleOnly")).option("--output <path>", cliM("cli_help_bundleOutput")).action(async (appDir, options) => {
   try {
     await deployCommand({
       appDir,
@@ -3259,29 +3505,36 @@ cli.command("deploy [appDir]", "\u90E8\u7F72\u5E94\u7528\u5230\u4E91\u5E73\u53F0
       envDir: options.envDir,
       yes: options.yes,
       projectName: options.projectName,
-      skipProvision: options.skipProvision,
       skipMiddleware: options.skipMiddleware,
-      skipBuild: options.skipBuild,
+      artifactDir: options.artifactDir,
+      services: options.services,
+      build: options.build,
+      network: options.network,
+      sqlitePrebuildMirror: options.sqlitePrebuildMirror,
+      httpProxy: options.httpProxy,
+      runtime: options.runtime,
+      bundleOnly: options.bundleOnly,
+      output: options.output,
       verbose: options.verbose,
       cwd: options.cwd
     });
   } catch {
-    process3.exit(1);
+    process4.exitCode = 1;
   }
 });
-cli.command("g:page <name>", "\u751F\u6210\u9875\u9762").action(async (name, options) => {
+cli.command("g:page <name>", cliM("cli_help_generatePage")).action(async (name, options) => {
   await generate({ type: "page", name, cwd: options.cwd });
 });
-cli.command("g:component <name>", "\u751F\u6210\u7EC4\u4EF6").action(async (name, options) => {
+cli.command("g:component <name>", cliM("cli_help_generateComponent")).action(async (name, options) => {
   await generate({ type: "component", name, cwd: options.cwd });
 });
-cli.command("g:api <name>", "\u751F\u6210 API").action(async (name, options) => {
+cli.command("g:api <name>", cliM("cli_help_generateApi")).action(async (name, options) => {
   await generate({ type: "api", name, cwd: options.cwd });
 });
-cli.command("g:model <name>", "\u751F\u6210\u6570\u636E\u6A21\u578B").action(async (name, options) => {
+cli.command("g:model <name>", cliM("cli_help_generateModel")).action(async (name, options) => {
   await generate({ type: "model", name, cwd: options.cwd });
 });
-cli.version(VERSION);
+cli.version(VERSION, "-V, --version");
 cli.help();
 var parsed = cli.parse();
 if (!cli.matchedCommand && !parsed.options.help && !parsed.options.version) {