@kmlckj/licos-ai-cli 1.1.28 → 1.1.30

package/lib/__templates__/agent/pyproject.toml

@@ -5,7 +5,7 @@ description = "LICOS LangGraph agent project"
 requires-python = ">=3.12"
 dependencies = [
     "licos-agent-runtime>=0.2.28",
-    "licos-dev-sdk>=0.2.18",
+    "licos-dev-sdk>=0.2.19",
 ]
 
 [tool.uv]

package/lib/__templates__/expo/.licosproj/scripts/dev_run.sh

@@ -88,6 +88,26 @@ ensure_port() {
     fi
   fi
 }
+ensure_fixed_preview_port() {
+  local port_val=$1
+  if is_port_free "$port_val"; then
+    echo "预览端口未占用：$port_val"
+    return 0
+  fi
+
+  echo "预览端口已占用：$port_val，正在清理旧进程"
+  if ! command -v fuser >/dev/null 2>&1; then
+    echo "无法清理预览端口 $port_val：缺少 fuser。LICOS 预览不会切换到其他端口。"
+    exit 1
+  fi
+  fuser -k "${port_val}/tcp" 2>/dev/null || true
+  sleep 1
+  if ! is_port_free "$port_val"; then
+    echo "预览端口 $port_val 清理失败。LICOS 预览不会切换到其他端口。"
+    exit 1
+  fi
+  echo "预览端口已清理：$port_val"
+}
 configure_expo_env() {
   local web_url="${LICOS_PROJECT_DOMAIN_DEFAULT:-http://127.0.0.1:${SERVER_PORT}}"
   EXPO_PUBLIC_BACKEND_BASE_URL="${EXPO_PUBLIC_BACKEND_BASE_URL:-$web_url}"
@@ -181,7 +201,7 @@ check_command "bash"
 
 # 端口占用预检查与处理
 ensure_port SERVER_PORT "$SERVER_PORT"
-ensure_port EXPO_PORT "$EXPO_PORT"
+ensure_fixed_preview_port "$EXPO_PORT"
 configure_expo_env
 
 echo "==================== 启动 server 服务 ===================="

package/lib/__templates__/expo/pnpm-lock.yaml

@@ -266,8 +266,8 @@ importers:
   server:
     dependencies:
       '@kmlckj/licos-dev-sdk':
-        specifier: 0.2.15
-        version: 0.2.15
+        specifier: 0.2.16
+        version: 0.2.16
       '@kmlckj/licos-platform-sdk':
         specifier: 0.10.3
         version: 0.10.3
@@ -1324,8 +1324,8 @@ packages:
   '@jridgewell/trace-mapping@0.3.31':
     resolution: {integrity: sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==}
 
-  '@kmlckj/licos-dev-sdk@0.2.15':
-    resolution: {integrity: sha512-lrIa+onEVMDkXiMhtYgK01n5nrkKNC1gokABcuHvuurgu8CHmaAD9aZdoKTf/qSSYbhg0EYWIQ0ldO996kKlPw==}
+  '@kmlckj/licos-dev-sdk@0.2.16':
+    resolution: {integrity: sha512-F2nJH0ODLaNCyujaDflFm5iBL4YxJxnnWKC6Rvy6MXF8Z01yhvq1q0EUveF1LYzeaQH3yl6j1W50Gp8nBdSoRQ==}
     engines: {node: '>=18'}
 
   '@kmlckj/licos-platform-sdk@0.10.3':
@@ -7493,7 +7493,7 @@ snapshots:
       '@jridgewell/resolve-uri': 3.1.2
       '@jridgewell/sourcemap-codec': 1.5.5
 
-  '@kmlckj/licos-dev-sdk@0.2.15': {}
+  '@kmlckj/licos-dev-sdk@0.2.16': {}
 
   '@kmlckj/licos-platform-sdk@0.10.3':
     dependencies:

package/lib/__templates__/expo/server/package.json

@@ -10,7 +10,7 @@
     "lint": "tsc --noEmit"
   },
   "dependencies": {
-    "@kmlckj/licos-dev-sdk": "0.2.15",
+    "@kmlckj/licos-dev-sdk": "0.2.16",
     "@kmlckj/licos-platform-sdk": "0.10.3",
     "cors": "^2.8.5",
     "dayjs": "^1.11.19",

package/lib/__templates__/nextjs/package.json

@@ -14,7 +14,7 @@
     "ts-check": "tsc -p tsconfig.json"
   },
   "dependencies": {
-    "@kmlckj/licos-dev-sdk": "0.2.15",
+    "@kmlckj/licos-dev-sdk": "0.2.16",
     "@kmlckj/licos-platform-sdk": "0.10.3",
     "@aws-sdk/client-s3": "^3.958.0",
     "@aws-sdk/lib-storage": "^3.958.0",

package/lib/__templates__/nextjs/pnpm-lock.yaml

@@ -18,8 +18,8 @@ importers:
         specifier: ^5.2.2
         version: 5.4.0(react-hook-form@7.77.0(react@19.2.3))
       '@kmlckj/licos-dev-sdk':
-        specifier: 0.2.15
-        version: 0.2.15
+        specifier: 0.2.16
+        version: 0.2.16
       '@kmlckj/licos-platform-sdk':
         specifier: 0.10.3
         version: 0.10.3
@@ -1380,8 +1380,8 @@ packages:
   '@jridgewell/trace-mapping@0.3.31':
     resolution: {integrity: sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==}
 
-  '@kmlckj/licos-dev-sdk@0.2.15':
-    resolution: {integrity: sha512-lrIa+onEVMDkXiMhtYgK01n5nrkKNC1gokABcuHvuurgu8CHmaAD9aZdoKTf/qSSYbhg0EYWIQ0ldO996kKlPw==}
+  '@kmlckj/licos-dev-sdk@0.2.16':
+    resolution: {integrity: sha512-F2nJH0ODLaNCyujaDflFm5iBL4YxJxnnWKC6Rvy6MXF8Z01yhvq1q0EUveF1LYzeaQH3yl6j1W50Gp8nBdSoRQ==}
     engines: {node: '>=18'}
 
   '@kmlckj/licos-platform-sdk@0.10.3':
@@ -6707,7 +6707,7 @@ snapshots:
       '@jridgewell/resolve-uri': 3.1.2
       '@jridgewell/sourcemap-codec': 1.5.5
 
-  '@kmlckj/licos-dev-sdk@0.2.15': {}
+  '@kmlckj/licos-dev-sdk@0.2.16': {}
 
   '@kmlckj/licos-platform-sdk@0.10.3':
     dependencies:

package/lib/__templates__/nextjs/scripts/dev.sh

@@ -1,16 +1,13 @@
 #!/bin/bash
 set -Eeuo pipefail
 
-<% if (process.env.NODE_ENV === 'test') { %>
-# 测试环境：支持环境变量覆盖端口
-PORT="${PORT:-<%= port %>}"
+if [[ -n "${LICOS_RUN_PORT:-}" ]]; then
+  PORT="${LICOS_RUN_PORT}"
+elif [[ -z "${PORT:-}" ]]; then
+  PORT=<%= port %>
+fi
 PROJECT_DIR="${LICOS_PROJECT_PATH:-${LICOS_WORKSPACE_PATH:-$(pwd)}}"
-DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-${PORT}}"
-<% } else { %>
-PORT=<%= port %>
-PROJECT_DIR="${LICOS_PROJECT_PATH:-${LICOS_WORKSPACE_PATH:-$(pwd)}}"
-DEPLOY_RUN_PORT=<%= port %>
-<% } %>
+DEPLOY_RUN_PORT="${PORT}"
 
 cd "${PROJECT_DIR}"
 
@@ -26,7 +23,8 @@ kill_port_if_listening() {
     sleep 1
     pids=$(ss -H -lntp 2>/dev/null | awk -v port="${DEPLOY_RUN_PORT}" '$4 ~ ":"port"$"' | grep -o 'pid=[0-9]*' | cut -d= -f2 | paste -sd' ' - || true)
     if [[ -n "${pids}" ]]; then
-      echo "Warning: port ${DEPLOY_RUN_PORT} still busy after SIGKILL, PIDs: ${pids}"
+      echo "Preview port ${DEPLOY_RUN_PORT} is still busy after cleanup, PIDs: ${pids}. Refusing to use another port."
+      exit 1
     else
       echo "Port ${DEPLOY_RUN_PORT} cleared."
     fi

package/lib/__templates__/nuxt-vue/nuxt.config.ts

@@ -1,180 +1,181 @@
-// https://nuxt.com/docs/api/configuration/nuxt-config
-import { fileURLToPath } from 'url';
-import { dirname, resolve } from 'path';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-function normalizeBaseURL(value?: string): string {
-  const trimmed = value?.trim();
-  if (!trimmed || trimmed === '/') return '/';
-  return `/${trimmed.replace(/^\/+|\/+$/g, '')}/`;
-}
-
-function parsePort(value?: string): number | undefined {
-  const port = Number.parseInt(value || '', 10);
-  return Number.isInteger(port) && port > 0 ? port : undefined;
-}
-
-function createPreviewHmrConfig() {
-  if (!process.env.LICOS_PREVIEW_BASE_PATH) {
-    return undefined;
-  }
-  const hmr: Record<string, unknown> = {
-    overlay: true,
-    path: process.env.LICOS_PREVIEW_HMR_PATH || '/hot/vite-hmr',
-    timeout: 30000,
-  };
-  if (process.env.LICOS_PREVIEW_HMR_HOST) {
-    hmr.host = process.env.LICOS_PREVIEW_HMR_HOST;
-  }
-  if (process.env.LICOS_PREVIEW_HMR_PROTOCOL) {
-    hmr.protocol = process.env.LICOS_PREVIEW_HMR_PROTOCOL;
-  }
-  const clientPort = parsePort(process.env.LICOS_PREVIEW_HMR_CLIENT_PORT);
-  if (clientPort) {
-    hmr.clientPort = clientPort;
-  }
-  return hmr;
-}
-
-function isProdProjectEnv(value?: string): boolean {
-  const normalized = value?.trim().toLowerCase();
-  return normalized === 'prod' || normalized === 'production' || normalized === 'release';
-}
-
-const isProd = isProdProjectEnv(process.env.LICOS_PROJECT_ENV);
-const deployBaseURL = process.env.NUXT_PUBLIC_BASE_URL || process.env.BASE_PATH;
-const shouldUseBaseURL = Boolean(deployBaseURL) || isProd;
-
-const publicBaseURL = shouldUseBaseURL ? normalizeBaseURL(deployBaseURL) : '/';
-const publicAssetCdnURL = publicBaseURL === '/' ? '' : publicBaseURL.replace(/\/$/, '');
-const previewHmrConfig = createPreviewHmrConfig();
-
-export default defineNuxtConfig({
-  compatibilityDate: '2025-07-15',
-  // Disable devtools in CI/test environments (prevents hanging in headless mode)
-  devtools: {
-    enabled: process.env.CI !== 'true' && !isProd,
-  },
-  telemetry: false,
-
-  // App head configuration
-  app: {
-    // The cluster ingress rewrites /p/{projectId}/... to backend /...
-    // Keep Nuxt's server asset route at /_nuxt and prefix browser URLs via cdnURL.
-    baseURL: '/',
-    buildAssetsDir: '/_nuxt/',
-    cdnURL: publicAssetCdnURL,
-    head: {
-      title: '新应用 | LICOS AI',
-      titleTemplate: '%s | LICOS AI',
-      meta: [
-        { charset: 'utf-8' },
-        { name: 'viewport', content: 'width=device-width, initial-scale=1' },
-        {
-          name: 'description',
-          content:
-            'LICOS AI是一款一站式云端 Vibe Coding 开发平台。通过对话轻松构建智能体、工作流和网站，实现从创意到上线的无缝衔接。',
-        },
-        {
-          name: 'keywords',
-          content:
-            'LICOS AI,LICOS AI,Vibe Coding,AI 编程,智能体搭建,工作流搭建,网站搭建,网站部署,全栈开发,AI 工程师',
-        },
-        { name: 'author', content: 'LICOS Team' },
-        { name: 'generator', content: 'LICOS AI' },
-        // Open Graph
-        { property: 'og:title', content: 'LICOS AI | 你的 AI 工程师已就位' },
-        {
-          property: 'og:description',
-          content:
-            '我正在使用LICOS AI Vibe Coding，让创意瞬间上线。告别拖拽，拥抱心流。',
-        },
-        { property: 'og:url', content: 'https://licos.ai' },
-        { property: 'og:site_name', content: 'LICOS AI' },
-        { property: 'og:locale', content: 'zh_CN' },
-        { property: 'og:type', content: 'website' },
-        // Robots
-        { name: 'robots', content: 'index, follow' },
-      ],
-      link: [{ rel: 'canonical', href: 'https://licos.ai' }],
-      htmlAttrs: {
-        lang: 'zh-CN',
-      },
-    },
-  },
-
-  // Nuxt modules
-  modules: ['@nuxt/image', '@nuxtjs/tailwindcss'],
-
-  // Global CSS
-  css: [resolve(__dirname, 'assets/css/main.css')],
-
-  runtimeConfig: {
-    public: {
-      baseURL: publicBaseURL,
-    },
-  },
-
-  // Development server configuration
-  devServer: {
-    port: parseInt(process.env.PORT || '<%= port %>', 10),
-    host: process.env.HOST || '0.0.0.0',
-  },
-
-  // TypeScript configuration
-  typescript: {
-    strict: false,
-    typeCheck: false,
-  },
-
-  // Vite configuration (similar to Next.js allowedDevOrigins)
-  vite: {
-    server: {
-      host: '0.0.0.0',
-      cors: {
-        origin: ['*.dev.licos.local'],
-        credentials: true,
-      },
-      hmr: previewHmrConfig || {
-        overlay: true,
-        path: '/hot/vite-hmr',
-        port: parseInt(process.env.HMR_PORT || '<%= hmrPort %>', 10),
-        clientPort: 443,
-        timeout: 30000,
-      },
-      // Fix EMFILE: too many open files error
-      // Exclude large directories from file watching to avoid exceeding system limits
-      watch: {
-        ignored: [
-          '**/node_modules/**',
-          '**/.nuxt/**',
-          '**/.output/**',
-          '**/dist/**',
-          '**/.git/**',
-          '**/coverage/**',
-          '**/.cache/**',
-        ],
-      },
-    },
-  },
-
-  // Security headers (Content Security Policy)
-  nitro: {
-    publicAssets: [
-      {
-        baseURL: '/assets',
-        dir: resolve(__dirname, 'assets'),
-      },
-    ],
-    routeRules: {
-      '/**': {
-        headers: {
-          'Content-Security-Policy':
-            "img-src 'self' data:;",
-        },
-      },
-    },
-  },
-});
+// https://nuxt.com/docs/api/configuration/nuxt-config
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+function normalizeBaseURL(value?: string): string {
+  const trimmed = value?.trim();
+  if (!trimmed || trimmed === '/') return '/';
+  return `/${trimmed.replace(/^\/+|\/+$/g, '')}/`;
+}
+
+function parsePort(value?: string): number | undefined {
+  const port = Number.parseInt(value || '', 10);
+  return Number.isInteger(port) && port > 0 ? port : undefined;
+}
+
+function createPreviewHmrConfig() {
+  if (!process.env.LICOS_PREVIEW_BASE_PATH) {
+    return undefined;
+  }
+  const hmr: Record<string, unknown> = {
+    overlay: true,
+    path: process.env.LICOS_PREVIEW_HMR_PATH || '/hot/vite-hmr',
+    timeout: 30000,
+  };
+  if (process.env.LICOS_PREVIEW_HMR_HOST) {
+    hmr.host = process.env.LICOS_PREVIEW_HMR_HOST;
+  }
+  if (process.env.LICOS_PREVIEW_HMR_PROTOCOL) {
+    hmr.protocol = process.env.LICOS_PREVIEW_HMR_PROTOCOL;
+  }
+  const clientPort = parsePort(process.env.LICOS_PREVIEW_HMR_CLIENT_PORT);
+  if (clientPort) {
+    hmr.clientPort = clientPort;
+  }
+  return hmr;
+}
+
+function isProdProjectEnv(value?: string): boolean {
+  const normalized = value?.trim().toLowerCase();
+  return normalized === 'prod' || normalized === 'production' || normalized === 'release';
+}
+
+const isProd = isProdProjectEnv(process.env.LICOS_PROJECT_ENV);
+const deployBaseURL = process.env.NUXT_PUBLIC_BASE_URL || process.env.BASE_PATH;
+const shouldUseBaseURL = Boolean(deployBaseURL) || isProd;
+
+const publicBaseURL = shouldUseBaseURL ? normalizeBaseURL(deployBaseURL) : '/';
+const publicAssetCdnURL = publicBaseURL === '/' ? '' : publicBaseURL.replace(/\/$/, '');
+const previewHmrConfig = createPreviewHmrConfig();
+
+export default defineNuxtConfig({
+  compatibilityDate: '2025-07-15',
+  // Disable devtools in CI/test environments (prevents hanging in headless mode)
+  devtools: {
+    enabled: process.env.CI !== 'true' && !isProd,
+  },
+  telemetry: false,
+
+  // App head configuration
+  app: {
+    // The cluster ingress rewrites /p/{projectId}/... to backend /...
+    // Keep Nuxt's server asset route at /_nuxt and prefix browser URLs via cdnURL.
+    baseURL: '/',
+    buildAssetsDir: '/_nuxt/',
+    cdnURL: publicAssetCdnURL,
+    head: {
+      title: '新应用 | LICOS AI',
+      titleTemplate: '%s | LICOS AI',
+      meta: [
+        { charset: 'utf-8' },
+        { name: 'viewport', content: 'width=device-width, initial-scale=1' },
+        {
+          name: 'description',
+          content:
+            'LICOS AI是一款一站式云端 Vibe Coding 开发平台。通过对话轻松构建智能体、工作流和网站，实现从创意到上线的无缝衔接。',
+        },
+        {
+          name: 'keywords',
+          content:
+            'LICOS AI,LICOS AI,Vibe Coding,AI 编程,智能体搭建,工作流搭建,网站搭建,网站部署,全栈开发,AI 工程师',
+        },
+        { name: 'author', content: 'LICOS Team' },
+        { name: 'generator', content: 'LICOS AI' },
+        // Open Graph
+        { property: 'og:title', content: 'LICOS AI | 你的 AI 工程师已就位' },
+        {
+          property: 'og:description',
+          content:
+            '我正在使用LICOS AI Vibe Coding，让创意瞬间上线。告别拖拽，拥抱心流。',
+        },
+        { property: 'og:url', content: 'https://licos.ai' },
+        { property: 'og:site_name', content: 'LICOS AI' },
+        { property: 'og:locale', content: 'zh_CN' },
+        { property: 'og:type', content: 'website' },
+        // Robots
+        { name: 'robots', content: 'index, follow' },
+      ],
+      link: [{ rel: 'canonical', href: 'https://licos.ai' }],
+      htmlAttrs: {
+        lang: 'zh-CN',
+      },
+    },
+  },
+
+  // Nuxt modules
+  modules: ['@nuxt/image', '@nuxtjs/tailwindcss'],
+
+  // Global CSS
+  css: [resolve(__dirname, 'assets/css/main.css')],
+
+  runtimeConfig: {
+    public: {
+      baseURL: publicBaseURL,
+    },
+  },
+
+  // Development server configuration
+  devServer: {
+    port: parseInt(process.env.PORT || '<%= port %>', 10),
+    host: process.env.HOST || '0.0.0.0',
+  },
+
+  // TypeScript configuration
+  typescript: {
+    strict: false,
+    typeCheck: false,
+  },
+
+  // Vite configuration (similar to Next.js allowedDevOrigins)
+  vite: {
+    server: {
+      host: '0.0.0.0',
+      strictPort: true,
+      cors: {
+        origin: ['*.dev.licos.local'],
+        credentials: true,
+      },
+      hmr: previewHmrConfig || {
+        overlay: true,
+        path: '/hot/vite-hmr',
+        port: parseInt(process.env.HMR_PORT || '<%= hmrPort %>', 10),
+        clientPort: 443,
+        timeout: 30000,
+      },
+      // Fix EMFILE: too many open files error
+      // Exclude large directories from file watching to avoid exceeding system limits
+      watch: {
+        ignored: [
+          '**/node_modules/**',
+          '**/.nuxt/**',
+          '**/.output/**',
+          '**/dist/**',
+          '**/.git/**',
+          '**/coverage/**',
+          '**/.cache/**',
+        ],
+      },
+    },
+  },
+
+  // Security headers (Content Security Policy)
+  nitro: {
+    publicAssets: [
+      {
+        baseURL: '/assets',
+        dir: resolve(__dirname, 'assets'),
+      },
+    ],
+    routeRules: {
+      '/**': {
+        headers: {
+          'Content-Security-Policy':
+            "img-src 'self' data:;",
+        },
+      },
+    },
+  },
+});

package/lib/__templates__/nuxt-vue/package.json

@@ -17,7 +17,7 @@
     "start": "bash ./scripts/start.sh"
   },
   "dependencies": {
-    "@kmlckj/licos-dev-sdk": "0.2.15",
+    "@kmlckj/licos-dev-sdk": "0.2.16",
     "@kmlckj/licos-platform-sdk": "0.10.3",
     "@nuxt/image": "2.0.0",
     "nuxt": "4.3.1",

package/lib/__templates__/nuxt-vue/pnpm-lock.yaml

@@ -13,8 +13,8 @@ importers:
   .:
     dependencies:
       '@kmlckj/licos-dev-sdk':
-        specifier: 0.2.15
-        version: 0.2.15
+        specifier: 0.2.16
+        version: 0.2.16
       '@kmlckj/licos-platform-sdk':
         specifier: 0.10.3
         version: 0.10.3
@@ -731,8 +731,8 @@ packages:
   '@jridgewell/trace-mapping@0.3.31':
     resolution: {integrity: sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==}
 
-  '@kmlckj/licos-dev-sdk@0.2.15':
-    resolution: {integrity: sha512-lrIa+onEVMDkXiMhtYgK01n5nrkKNC1gokABcuHvuurgu8CHmaAD9aZdoKTf/qSSYbhg0EYWIQ0ldO996kKlPw==}
+  '@kmlckj/licos-dev-sdk@0.2.16':
+    resolution: {integrity: sha512-F2nJH0ODLaNCyujaDflFm5iBL4YxJxnnWKC6Rvy6MXF8Z01yhvq1q0EUveF1LYzeaQH3yl6j1W50Gp8nBdSoRQ==}
     engines: {node: '>=18'}
 
   '@kmlckj/licos-platform-sdk@0.10.3':
@@ -4741,7 +4741,7 @@ snapshots:
       '@jridgewell/resolve-uri': 3.1.2
       '@jridgewell/sourcemap-codec': 1.5.5
 
-  '@kmlckj/licos-dev-sdk@0.2.15': {}
+  '@kmlckj/licos-dev-sdk@0.2.16': {}
 
   '@kmlckj/licos-platform-sdk@0.10.3':
     dependencies:

package/lib/__templates__/nuxt-vue/scripts/dev.sh

@@ -1,16 +1,13 @@
 #!/bin/bash
 set -Eeuo pipefail
 
-<% if (process.env.NODE_ENV === 'test') { %>
-# 测试环境：支持环境变量覆盖端口
-PORT="${PORT:-<%= port %>}"
+if [[ -n "${LICOS_RUN_PORT:-}" ]]; then
+  PORT="${LICOS_RUN_PORT}"
+elif [[ -z "${PORT:-}" ]]; then
+  PORT=<%= port %>
+fi
 PROJECT_DIR="${LICOS_PROJECT_PATH:-${LICOS_WORKSPACE_PATH:-$(pwd)}}"
-DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-${PORT}}"
-<% } else { %>
-PORT=<%= port %>
-PROJECT_DIR="${LICOS_PROJECT_PATH:-${LICOS_WORKSPACE_PATH:-$(pwd)}}"
-DEPLOY_RUN_PORT=<%= port %>
-<% } %>
+DEPLOY_RUN_PORT="${PORT}"
 
 cd "${PROJECT_DIR}"
 
@@ -26,7 +23,8 @@ kill_port_if_listening() {
     sleep 1
     pids=$(ss -H -lntp 2>/dev/null | awk -v port="${DEPLOY_RUN_PORT}" '$4 ~ ":"port"$"' | grep -o 'pid=[0-9]*' | cut -d= -f2 | paste -sd' ' - || true)
     if [[ -n "${pids}" ]]; then
-      echo "Warning: port ${DEPLOY_RUN_PORT} still busy after SIGKILL, PIDs: ${pids}"
+      echo "Preview port ${DEPLOY_RUN_PORT} is still busy after cleanup, PIDs: ${pids}. Refusing to use another port."
+      exit 1
     else
       echo "Port ${DEPLOY_RUN_PORT} cleared."
     fi

package/lib/__templates__/taro/.licosproj/scripts/dev_run.sh

@@ -43,7 +43,8 @@ kill_port_if_listening() {
     sleep 1
     pids=$(ss -H -lntp 2>/dev/null | awk -v port="${port}" '$4 ~ ":"port"$"' | grep -o 'pid=[0-9]*' | cut -d= -f2 | sort -u | paste -sd' ' - || true)
     if [[ -n "${pids}" ]]; then
-        echo "Warning: port ${port} still busy after cleanup, PIDs: ${pids}"
+        echo "Preview port ${port} is still busy after cleanup, PIDs: ${pids}. Refusing to use another port."
+        exit 1
     else
         echo "Port ${port} cleared."
     fi

package/lib/__templates__/taro/pnpm-lock.yaml

@@ -186,8 +186,8 @@ importers:
   server:
     dependencies:
       '@kmlckj/licos-dev-sdk':
-        specifier: 0.2.15
-        version: 0.2.15
+        specifier: 0.2.16
+        version: 0.2.16
       '@kmlckj/licos-platform-sdk':
         specifier: 0.10.3
         version: 0.10.3
@@ -2595,8 +2595,8 @@ packages:
   '@keyv/serialize@1.1.1':
     resolution: {integrity: sha512-dXn3FZhPv0US+7dtJsIi2R+c7qWYiReoEh5zUntWCf4oSpMNib8FDhSoed6m3QyZdx5hK7iLFkYk3rNxwt8vTA==}
 
-  '@kmlckj/licos-dev-sdk@0.2.15':
-    resolution: {integrity: sha512-lrIa+onEVMDkXiMhtYgK01n5nrkKNC1gokABcuHvuurgu8CHmaAD9aZdoKTf/qSSYbhg0EYWIQ0ldO996kKlPw==}
+  '@kmlckj/licos-dev-sdk@0.2.16':
+    resolution: {integrity: sha512-F2nJH0ODLaNCyujaDflFm5iBL4YxJxnnWKC6Rvy6MXF8Z01yhvq1q0EUveF1LYzeaQH3yl6j1W50Gp8nBdSoRQ==}
     engines: {node: '>=18'}
 
   '@kmlckj/licos-platform-sdk@0.10.3':
@@ -12400,7 +12400,7 @@ snapshots:
 
   '@keyv/serialize@1.1.1': {}
 
-  '@kmlckj/licos-dev-sdk@0.2.15': {}
+  '@kmlckj/licos-dev-sdk@0.2.16': {}
 
   '@kmlckj/licos-platform-sdk@0.10.3':
     dependencies:

package/lib/__templates__/taro/server/package.json

@@ -11,7 +11,7 @@
     "start:prod": "node dist/main"
   },
   "dependencies": {
-    "@kmlckj/licos-dev-sdk": "0.2.15",
+    "@kmlckj/licos-dev-sdk": "0.2.16",
     "@kmlckj/licos-platform-sdk": "0.10.3",
     "@nestjs/common": "^10.4.15",
     "@nestjs/core": "^10.4.15",

package/lib/__templates__/vite/package.json

@@ -14,7 +14,7 @@
     "ts-check": "tsc -p tsconfig.json"
   },
   "dependencies": {
-    "@kmlckj/licos-dev-sdk": "0.2.15",
+    "@kmlckj/licos-dev-sdk": "0.2.16",
     "@kmlckj/licos-platform-sdk": "0.10.3",
     "dotenv": "^17.2.3",
     "express": "^4.21.2"

package/lib/__templates__/vite/pnpm-lock.yaml

@@ -13,8 +13,8 @@ importers:
   .:
     dependencies:
       '@kmlckj/licos-dev-sdk':
-        specifier: 0.2.15
-        version: 0.2.15
+        specifier: 0.2.16
+        version: 0.2.16
       '@kmlckj/licos-platform-sdk':
         specifier: 0.10.3
         version: 0.10.3
@@ -291,8 +291,8 @@ packages:
   '@jridgewell/trace-mapping@0.3.31':
     resolution: {integrity: sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==}
 
-  '@kmlckj/licos-dev-sdk@0.2.15':
-    resolution: {integrity: sha512-lrIa+onEVMDkXiMhtYgK01n5nrkKNC1gokABcuHvuurgu8CHmaAD9aZdoKTf/qSSYbhg0EYWIQ0ldO996kKlPw==}
+  '@kmlckj/licos-dev-sdk@0.2.16':
+    resolution: {integrity: sha512-F2nJH0ODLaNCyujaDflFm5iBL4YxJxnnWKC6Rvy6MXF8Z01yhvq1q0EUveF1LYzeaQH3yl6j1W50Gp8nBdSoRQ==}
     engines: {node: '>=18'}
 
   '@kmlckj/licos-platform-sdk@0.10.3':
@@ -1723,7 +1723,7 @@ snapshots:
       '@jridgewell/resolve-uri': 3.1.2
       '@jridgewell/sourcemap-codec': 1.5.5
 
-  '@kmlckj/licos-dev-sdk@0.2.15': {}
+  '@kmlckj/licos-dev-sdk@0.2.16': {}
 
   '@kmlckj/licos-platform-sdk@0.10.3':
     dependencies:

package/lib/__templates__/vite/scripts/dev.sh

@@ -1,16 +1,13 @@
 #!/bin/bash
 set -Eeuo pipefail
 
-<% if (process.env.NODE_ENV === 'test') { %>
-# 测试环境：支持环境变量覆盖端口
-PORT="${PORT:-<%= port %>}"
+if [[ -n "${LICOS_RUN_PORT:-}" ]]; then
+  PORT="${LICOS_RUN_PORT}"
+elif [[ -z "${PORT:-}" ]]; then
+  PORT=<%= port %>
+fi
 PROJECT_DIR="${LICOS_PROJECT_PATH:-${LICOS_WORKSPACE_PATH:-$(pwd)}}"
-DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-${PORT}}"
-<% } else { %>
-PORT=<%= port %>
-PROJECT_DIR="${LICOS_PROJECT_PATH:-${LICOS_WORKSPACE_PATH:-$(pwd)}}"
-DEPLOY_RUN_PORT=<%= port %>
-<% } %>
+DEPLOY_RUN_PORT="${PORT}"
 
 cd "${PROJECT_DIR}"
 
@@ -26,7 +23,8 @@ kill_port_if_listening() {
     sleep 1
     pids=$(ss -H -lntp 2>/dev/null | awk -v port="${DEPLOY_RUN_PORT}" '$4 ~ ":"port"$"' | grep -o 'pid=[0-9]*' | cut -d= -f2 | paste -sd' ' - || true)
     if [[ -n "${pids}" ]]; then
-      echo "Warning: port ${DEPLOY_RUN_PORT} still busy after SIGKILL, PIDs: ${pids}"
+      echo "Preview port ${DEPLOY_RUN_PORT} is still busy after cleanup, PIDs: ${pids}. Refusing to use another port."
+      exit 1
     else
       echo "Port ${DEPLOY_RUN_PORT} cleared."
     fi

package/lib/__templates__/vite/vite.config.ts

@@ -1,64 +1,65 @@
-import { defineConfig } from 'vite';
-
-function normalizeBasePath(value?: string): string {
-  const trimmed = value?.trim();
-  if (!trimmed || trimmed === '/') return '/';
-  return `/${trimmed.replace(/^\/+|\/+$/g, '')}/`;
-}
-
-function isProdProjectEnv(value?: string): boolean {
-  const normalized = value?.trim().toLowerCase();
-  return normalized === 'prod' || normalized === 'production' || normalized === 'release';
-}
-
-const deployBasePath = process.env.VITE_BASE_PATH || process.env.BASE_PATH;
-const shouldUseBasePath = Boolean(deployBasePath) || isProdProjectEnv(process.env.LICOS_PROJECT_ENV);
-
-function parsePort(value?: string): number | undefined {
-  const port = Number.parseInt(value || '', 10);
-  return Number.isInteger(port) && port > 0 ? port : undefined;
-}
-
-function createPreviewHmrConfig() {
-  if (!process.env.LICOS_PREVIEW_BASE_PATH) {
-    return undefined;
-  }
-  const hmr: Record<string, unknown> = {
-    overlay: true,
-    path: process.env.LICOS_PREVIEW_HMR_PATH || '/hot/vite-hmr',
-    timeout: 30000,
-  };
-  if (process.env.LICOS_PREVIEW_HMR_HOST) {
-    hmr.host = process.env.LICOS_PREVIEW_HMR_HOST;
-  }
-  if (process.env.LICOS_PREVIEW_HMR_PROTOCOL) {
-    hmr.protocol = process.env.LICOS_PREVIEW_HMR_PROTOCOL;
-  }
-  const clientPort = parsePort(process.env.LICOS_PREVIEW_HMR_CLIENT_PORT);
-  if (clientPort) {
-    hmr.clientPort = clientPort;
-  }
-  return hmr;
-}
-
-const previewHmrConfig = createPreviewHmrConfig();
-
-export default defineConfig({
-  base: shouldUseBasePath ? normalizeBasePath(deployBasePath) : '/',
-  server: {
-    port: <%= port %>,
-    host: '0.0.0.0',
-    allowedHosts: true,
-    hmr: previewHmrConfig || {
-      overlay: true,
-      path: '/hot/vite-hmr',
-      port: <%= hmrPort %>,
-      clientPort: 443,
-      timeout: 30000,
-    },
-    watch: {
-      usePolling: true,
-      interval: 100,
-    }
-  },
-});
+import { defineConfig } from 'vite';
+
+function normalizeBasePath(value?: string): string {
+  const trimmed = value?.trim();
+  if (!trimmed || trimmed === '/') return '/';
+  return `/${trimmed.replace(/^\/+|\/+$/g, '')}/`;
+}
+
+function isProdProjectEnv(value?: string): boolean {
+  const normalized = value?.trim().toLowerCase();
+  return normalized === 'prod' || normalized === 'production' || normalized === 'release';
+}
+
+const deployBasePath = process.env.VITE_BASE_PATH || process.env.BASE_PATH;
+const shouldUseBasePath = Boolean(deployBasePath) || isProdProjectEnv(process.env.LICOS_PROJECT_ENV);
+
+function parsePort(value?: string): number | undefined {
+  const port = Number.parseInt(value || '', 10);
+  return Number.isInteger(port) && port > 0 ? port : undefined;
+}
+
+function createPreviewHmrConfig() {
+  if (!process.env.LICOS_PREVIEW_BASE_PATH) {
+    return undefined;
+  }
+  const hmr: Record<string, unknown> = {
+    overlay: true,
+    path: process.env.LICOS_PREVIEW_HMR_PATH || '/hot/vite-hmr',
+    timeout: 30000,
+  };
+  if (process.env.LICOS_PREVIEW_HMR_HOST) {
+    hmr.host = process.env.LICOS_PREVIEW_HMR_HOST;
+  }
+  if (process.env.LICOS_PREVIEW_HMR_PROTOCOL) {
+    hmr.protocol = process.env.LICOS_PREVIEW_HMR_PROTOCOL;
+  }
+  const clientPort = parsePort(process.env.LICOS_PREVIEW_HMR_CLIENT_PORT);
+  if (clientPort) {
+    hmr.clientPort = clientPort;
+  }
+  return hmr;
+}
+
+const previewHmrConfig = createPreviewHmrConfig();
+
+export default defineConfig({
+  base: shouldUseBasePath ? normalizeBasePath(deployBasePath) : '/',
+  server: {
+    port: parsePort(process.env.LICOS_RUN_PORT) || parsePort(process.env.PORT) || <%= port %>,
+    strictPort: true,
+    host: '0.0.0.0',
+    allowedHosts: true,
+    hmr: previewHmrConfig || {
+      overlay: true,
+      path: '/hot/vite-hmr',
+      port: <%= hmrPort %>,
+      clientPort: 443,
+      timeout: 30000,
+    },
+    watch: {
+      usePolling: true,
+      interval: 100,
+    }
+  },
+});

package/lib/__templates__/workflow/pyproject.toml

@@ -5,7 +5,7 @@ description = "LICOS LangGraph workflow project"
 requires-python = ">=3.12"
 dependencies = [
     "licos-agent-runtime>=0.2.28",
-    "licos-dev-sdk>=0.2.18",
+    "licos-dev-sdk>=0.2.19",
 ]
 
 [tool.uv]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kmlckj/licos-ai-cli",
-  "version": "1.1.28",
+  "version": "1.1.30",
   "description": "LICOS AI coding workspace CLI - project template engine and dev tools",
   "license": "MIT",
   "author": "kmlckj",