@kmlckj/licos-ai-cli 0.0.36 → 0.0.39

package/lib/__templates__/agent/pyproject.toml

@@ -4,7 +4,7 @@ version = "0.1.0"
 description = "LICOS LangGraph agent project"
 requires-python = ">=3.12"
 dependencies = [
-    "licos-agent-runtime>=0.2.10",
+    "licos-agent-runtime>=0.2.11",
 ]
 
 [tool.uv]

package/lib/__templates__/agent/requirements.txt

@@ -1 +1 @@
-licos-agent-runtime>=0.2.10
+licos-agent-runtime>=0.2.11

package/lib/__templates__/expo/AGENTS.md

@@ -25,6 +25,7 @@
 |   ├── src/
 │   │   └── index.ts            # 服务端入口文件
 |   └── package.json            # 服务端 package.json
+├── assets/                      # Web 部署可通过 /assets/* 访问的静态资源
 ├── package.json
 ├── .licosproj                   # 预置脚手架脚本（禁止修改）
 └── .licos                       # 配置文件（禁止修改）
@@ -238,6 +239,11 @@ cd server && pnpm add --registry=https://registry.npmmirror.com axios cors
 
 ## Expo 开发规范
 
+### 静态资源
+
+- `client/assets/` 用于 Expo/React Native import 和 bundle 资源。
+- 项目根 `assets/` 用于 Web 部署时按 URL 访问的公开静态资源，服务端会映射到 `/assets/*`；H5 页面应优先用相对路径 `assets/name.ext`，避免部署子路径资源 404。开发预览中的跨端资源仍优先通过 `client/assets/` import。
+
 ### 路径别名
 
 Expo 配置了 `@/` 路径别名指向 `client/` 目录：

package/lib/__templates__/expo/server/src/index.ts

@@ -16,6 +16,13 @@ app.get('/api/v1/health', (req, res) => {
   res.status(200).json({ status: 'ok' });
 });
 
+const projectRoot =
+  path.basename(process.cwd()) === "server" ? path.resolve(process.cwd(), "..") : process.cwd();
+const assetsDir = path.resolve(projectRoot, "assets");
+if (fs.existsSync(assetsDir)) {
+  app.use("/assets", express.static(assetsDir));
+}
+
 const publicDir = path.resolve(process.cwd(), "public");
 if (fs.existsSync(publicDir)) {
   app.use(express.static(publicDir));

package/lib/__templates__/nextjs/AGENTS.md

@@ -12,6 +12,7 @@
 
 ```
 ├── public/                 # 静态资源
+├── assets/                 # 公开静态资源，自定义服务端映射到 /assets/*
 ├── scripts/                # 构建与启动脚本
 │   ├── build.sh            # 构建脚本
 │   ├── dev.sh              # 开发环境启动脚本
@@ -44,6 +45,11 @@
 
 ## 开发规范
 
+### 静态资源
+
+- 项目根 `assets/` 可放需要按 URL 访问的静态资源，自定义服务端会映射到 `/assets/*`。
+- 部署在子路径时不要硬编码 `/assets/...`，应结合 `basePath` 或相对路径生成可访问 URL。
+
 ### Hydration 问题防范
 
 1. 严禁在 JSX 渲染逻辑中直接使用 typeof window、Date.now()、Math.random() 等动态数据。**必须使用 'use client' 并配合 useEffect + useState 确保动态内容仅在客户端挂载后渲染**；同时严禁非法 HTML 嵌套（如 <p> 嵌套 <div>）。

package/lib/__templates__/nextjs/src/server.ts

@@ -1,4 +1,6 @@
-import { createServer } from 'http';
+import { createServer, type ServerResponse } from 'http';
+import { createReadStream, existsSync, statSync } from 'fs';
+import { extname, resolve, sep } from 'path';
 import { parse } from 'url';
 import next from 'next';
 
@@ -10,6 +12,90 @@ function isProdProjectEnv(value?: string): boolean {
 const dev = !isProdProjectEnv(process.env.LICOS_PROJECT_ENV);
 const hostname = process.env.HOSTNAME || 'localhost';
 const port = parseInt(process.env.PORT || '<%= port %>', 10);
+const projectAssetsDir = resolve(process.cwd(), 'assets');
+
+function normalizeBasePath(value?: string): string | undefined {
+  const trimmed = value?.trim();
+  if (!trimmed || trimmed === '/') return undefined;
+  return `/${trimmed.replace(/^\/+|\/+$/g, '')}`;
+}
+
+const basePath = normalizeBasePath(process.env.BASE_PATH);
+
+function getContentType(filePath: string): string {
+  const ext = extname(filePath).toLowerCase();
+  const types: Record<string, string> = {
+    '.avif': 'image/avif',
+    '.css': 'text/css; charset=utf-8',
+    '.gif': 'image/gif',
+    '.html': 'text/html; charset=utf-8',
+    '.ico': 'image/x-icon',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.js': 'text/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.map': 'application/json; charset=utf-8',
+    '.mp3': 'audio/mpeg',
+    '.mp4': 'video/mp4',
+    '.otf': 'font/otf',
+    '.png': 'image/png',
+    '.svg': 'image/svg+xml',
+    '.ttf': 'font/ttf',
+    '.txt': 'text/plain; charset=utf-8',
+    '.wasm': 'application/wasm',
+    '.webm': 'video/webm',
+    '.webp': 'image/webp',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.xml': 'application/xml; charset=utf-8',
+  };
+  return types[ext] || 'application/octet-stream';
+}
+
+function normalizeAssetPath(pathname: string): string | null {
+  if (pathname.startsWith('/assets/')) {
+    return pathname;
+  }
+  if (basePath && pathname.startsWith(`${basePath}/assets/`)) {
+    return pathname.slice(basePath.length);
+  }
+  return null;
+}
+
+function serveProjectAsset(pathname: string, res: ServerResponse): boolean {
+  const assetPath = normalizeAssetPath(pathname);
+  if (!assetPath || !existsSync(projectAssetsDir)) {
+    return false;
+  }
+
+  let decodedPath: string;
+  try {
+    decodedPath = decodeURIComponent(assetPath.replace(/^\/assets\/+/, ''));
+  } catch {
+    return false;
+  }
+
+  const filePath = resolve(projectAssetsDir, decodedPath);
+  if (filePath !== projectAssetsDir && !filePath.startsWith(`${projectAssetsDir}${sep}`)) {
+    res.statusCode = 403;
+    res.end('Forbidden');
+    return true;
+  }
+
+  try {
+    const stat = statSync(filePath);
+    if (!stat.isFile()) {
+      return false;
+    }
+    res.statusCode = 200;
+    res.setHeader('Content-Type', getContentType(filePath));
+    res.setHeader('Content-Length', stat.size);
+    createReadStream(filePath).pipe(res);
+    return true;
+  } catch {
+    return false;
+  }
+}
 
 // Create Next.js app
 const app = next({ dev, hostname, port });
@@ -19,6 +105,9 @@ app.prepare().then(() => {
   const server = createServer(async (req, res) => {
     try {
       const parsedUrl = parse(req.url!, true);
+      if (serveProjectAsset(parsedUrl.pathname || '', res)) {
+        return;
+      }
       await handle(req, res, parsedUrl);
     } catch (err) {
       console.error('Error occurred handling', req.url, err);

package/lib/__templates__/nuxt-vue/AGENTS.md

@@ -42,3 +42,4 @@
 ## 开发规范
 
 - 使用 Tailwind CSS 进行样式开发
+- 项目根 `assets/` 会通过 Nitro 映射到 `/assets/*`，需要按 URL 访问时使用 `useRuntimeConfig().public.baseURL` 派生路径，例如 `assetUrl('assets/logo.svg')`；业务 CSS 仍优先放到 `nuxt.config.ts` 的 `css` 数组或组件 `<style scoped>`。

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

@@ -145,6 +145,12 @@ export default defineNuxtConfig({
 
   // Security headers (Content Security Policy)
   nitro: {
+    publicAssets: [
+      {
+        baseURL: '/assets',
+        dir: resolve(__dirname, 'assets'),
+      },
+    ],
     routeRules: {
       '/**': {
         headers: {

package/lib/__templates__/taro/AGENTS.md

@@ -20,9 +20,15 @@ pnpm remove <package>        # 移除依赖
 - `src/` 下禁止直接使用 `process.env`，不要使用 `__PUBLIC_PATH__`。请求前缀使用全局 `PROJECT_DOMAIN`，构建平台判断使用全局 `LICOS_TARO_ENV`。
 - 不要在业务代码里使用裸标识符 `TARO_ENV`。如需展示文字 “TARO_ENV”，只作为普通中文/英文说明文本使用，不要把它当作变量读取。
 - Taro API 只允许单次导入，统一写 `import Taro, { useLoad } from '@tarojs/taro'`，不要同时写 `import { useLoad } from '@tarojs/taro'` 和 `import Taro from '@tarojs/taro'`。
+- React hooks 必须从 `react` 导入，例如 `import { useMemo, useState } from 'react'`；不要从 `@tarojs/taro` 导入 `useState`、`useEffect`、`useMemo`。
+- 不要重复导入同一个包。`@tarojs/taro`、`@tarojs/components`、`react`、`lucide-react-taro` 每个文件最多一个 import 语句。
 - 需要在 `src/` 展示构建环境或项目域名时，直接读取全局常量：`LICOS_TARO_ENV || 'unknown'`、`PROJECT_DOMAIN || ''`，不要写 `process.env.TARO_ENV` 或 `process.env.PROJECT_DOMAIN`。
 - 需要引用本地资源时使用 ESM import，例如 `import logoUrl from '@/assets/images/logo.svg'`，不要在 `src/` 中写 CommonJS `require(...)`。
+- 根目录 `assets/` 是 H5 公开静态目录，不是 `@/assets` 源码别名。放在根 `assets/images/foo.svg` 的文件必须用相对 URL `assets/images/foo.svg`，不要写 `import foo from '@/assets/images/foo.svg'`。只有文件真实存在于 `src/assets/...` 时，才允许从 `@/assets/...` 导入。
+- 不要使用浏览器 DOM 全局做资源探测。禁止 `window`、`document`、`new Image()`、`window.Image`、`globalThis.Image`；图片状态通过 Taro `<Image onLoad onError />` 或直接渲染处理。
 - 从第三方图标包导入前必须确认导出存在；不确定时优先使用已验证的 `Package`、`Globe`、`Cpu`、`Layers` 等基础图标，避免引入不存在的命名导出导致构建失败。
+- 禁止输出不完整模板字符串、占位引号或非法 TS 字符串，例如 `"""`、未闭合的引号、未转义的英文单引号。文案中包含引号时使用反引号或正确转义。
+- 创建或测试小程序时，必须替换默认 `src/pages/index/index.tsx` 为实际首页，或把 `src/app.config.ts` 的第一个页面改为实际入口；不要新增测试页后保留默认占位首页。
 
 正确示例：
 
@@ -53,6 +59,8 @@ export default function IndexPage() {
 
 ## 图片与视频资源使用规范
 
+项目根 `assets/` 是 H5 预览/部署的公开静态资源目录，服务端映射到 `/assets/*`。H5 页面按 URL 引用少量静态文件时优先使用相对路径 `assets/name.ext`，避免部署在 `/p/{projectId}/` 子路径时资源 404；大图片、视频和用户上传内容仍走对象存储。不要把根 `assets/` 文件当作 `src/assets` 导入。
+
 **强制规则**：图片、视频等静态资源必须通过 TOS 对象存储管理，代码中使用 TOS 返回的 URL 引用。
 
 1. **资源存储方式**：
@@ -205,7 +213,7 @@ CRITICAL：
 - 颜色、间距、圆角、边框、阴影、排版、flex/grid、宽高等常规样式必须收敛在 Tailwind 类名中。
 - 禁止使用 `w-[340px]`、`text-[14px]`、`p-[16px]` 这类带 `px` 的 Tailwind 任意值。
 - 禁止使用颜色不透明度简写，例如 `bg-primary/10`、`text-slate-500/70`、`border-white/20`；小程序端 opacity 容易丢失，必须拆成基础颜色类和 `bg-opacity-*` / `text-opacity-*` / `border-opacity-*`。
-- 禁止使用小数值类名，例如 `space-y-1.5`、`w-0.5`、`h-2.5`；统一改成整数刻度，例如 `space-y-2`、`w-1`、`h-3`。
+- 禁止使用小数值或斜杠分数类名，例如 `space-y-1.5`、`w-0.5`、`h-2.5`、`mt-0.5`、`h-3/5`；统一改成整数刻度，例如 `space-y-2`、`w-1`、`h-3`、`mt-1`。
 - 禁止使用 `peer-*`、`group-*`、`has-*`、复杂任意选择器和属性选择器类名；这些写法在小程序构建或上传时容易失败。
 - 禁止使用 `style={{ width: '200px' }}`、`fontSize: '14px'` 这类硬编码尺寸。
 - Taro 会通过 `pxtransform` 将尺寸转换为跨端单位（小程序 `rpx`、H5 `rem`），业务代码里直接写 `px` 容易导致不同端显示不一致。

package/lib/__templates__/taro/config/index.ts

@@ -12,6 +12,66 @@ import pkg from '../package.json';
 
 dotenv.config({ path: path.resolve(__dirname, '../.env.local') });
 
+const projectAssetsDir = path.resolve(__dirname, '../assets');
+const assetMimeTypes: Record<string, string> = {
+  '.avif': 'image/avif',
+  '.css': 'text/css; charset=utf-8',
+  '.gif': 'image/gif',
+  '.html': 'text/html; charset=utf-8',
+  '.ico': 'image/x-icon',
+  '.jpg': 'image/jpeg',
+  '.jpeg': 'image/jpeg',
+  '.js': 'text/javascript; charset=utf-8',
+  '.json': 'application/json; charset=utf-8',
+  '.mp3': 'audio/mpeg',
+  '.mp4': 'video/mp4',
+  '.otf': 'font/otf',
+  '.png': 'image/png',
+  '.svg': 'image/svg+xml',
+  '.ttf': 'font/ttf',
+  '.txt': 'text/plain; charset=utf-8',
+  '.wasm': 'application/wasm',
+  '.webm': 'video/webm',
+  '.webp': 'image/webp',
+  '.woff': 'font/woff',
+  '.woff2': 'font/woff2',
+};
+
+const createProjectAssetsStaticPlugin = () => ({
+  name: 'licos-project-assets-static',
+  configureServer(server) {
+    server.middlewares.use('/assets', (req, res, next) => {
+      if (!fs.existsSync(projectAssetsDir)) {
+        return next();
+      }
+      const requestPath = (req.url || '')
+        .split('?')[0]
+        .replace(/^\/assets\/?/, '')
+        .replace(/^\/+/, '');
+      let decodedPath = '';
+      try {
+        decodedPath = decodeURIComponent(requestPath);
+      } catch {
+        return next();
+      }
+      const filePath = path.resolve(projectAssetsDir, decodedPath);
+      if (filePath !== projectAssetsDir && !filePath.startsWith(`${projectAssetsDir}${path.sep}`)) {
+        res.statusCode = 403;
+        res.end('Forbidden');
+        return;
+      }
+      if (!fs.existsSync(filePath) || !fs.statSync(filePath).isFile()) {
+        return next();
+      }
+      res.setHeader(
+        'Content-Type',
+        assetMimeTypes[path.extname(filePath).toLowerCase()] || 'application/octet-stream',
+      );
+      fs.createReadStream(filePath).pipe(res);
+    });
+  },
+});
+
 const generateTTProjectConfig = (outputRoot: string) => {
   const config = {
     miniprogramRoot: './',
@@ -121,6 +181,7 @@ export default defineConfig<'vite'>(async (merge, _env) => {
             }
           },
         },
+        ...(isH5 ? [createProjectAssetsStaticPlugin()] : []),
         {
           name: 'hmr-config-plugin',
           config() {

package/lib/__templates__/taro/server/src/main.ts

@@ -28,6 +28,12 @@ async function bootstrap() {
   app.use(express.json({ limit: '50mb' }));
   app.use(express.urlencoded({ limit: '50mb', extended: true }));
 
+  const projectRoot = path.resolve(__dirname, '../..');
+  const assetsDir = path.join(projectRoot, 'assets');
+  if (fs.existsSync(assetsDir)) {
+    app.use('/assets', express.static(assetsDir));
+  }
+
   const staticDir = path.resolve(__dirname, '../../dist-web');
   const indexHtml = path.join(staticDir, 'index.html');
   if (fs.existsSync(indexHtml)) {

package/lib/__templates__/vite/AGENTS.md

@@ -21,6 +21,7 @@
 │   ├── index.css       # 全局样式
 │   ├── index.ts        # 客户端入口
 │   └── main.ts         # 主逻辑
+├── assets/             # 公开静态资源，运行时映射到 /assets/*
 ├── index.html          # 入口 HTML
 ├── package.json        # 项目依赖管理
 ├── tsconfig.json       # TypeScript 配置
@@ -41,3 +42,4 @@
 ## 开发规范
 
 - 使用 Tailwind CSS 进行样式开发
+- 项目根 `assets/` 可放需要按 URL 访问的静态资源；部署在子路径时必须通过 `import.meta.env.BASE_URL` 派生访问路径，例如 `assetUrl('assets/logo.svg')`。

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

@@ -14,5 +14,12 @@ pnpm vite build
 
 echo "Bundling server with tsup..."
 pnpm tsup server/server.ts --format cjs --platform node --target node20 --outDir dist-server --no-splitting --no-minify --external vite
+if [ -f dist-server/server.cjs ] && [ ! -f dist-server/server.js ]; then
+  mv dist-server/server.cjs dist-server/server.js
+fi
+if [ ! -f dist-server/server.js ]; then
+  echo "Build failed: dist-server/server.js was not generated"
+  exit 1
+fi
 
 echo "Build completed successfully!"

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

@@ -14,7 +14,15 @@ DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-$PORT}"
 start_service() {
     cd "${PROJECT_DIR}"
     echo "Starting express production server on port ${DEPLOY_RUN_PORT}..."
-    PORT=$DEPLOY_RUN_PORT node dist-server/server.js
+    SERVER_ENTRY="dist-server/server.js"
+    if [ ! -f "$SERVER_ENTRY" ] && [ -f "dist-server/server.cjs" ]; then
+        SERVER_ENTRY="dist-server/server.cjs"
+    fi
+    if [ ! -f "$SERVER_ENTRY" ]; then
+        echo "Server entry not found: dist-server/server.js"
+        exit 1
+    fi
+    PORT=$DEPLOY_RUN_PORT node "$SERVER_ENTRY"
 }
 
 echo "Starting express production server on port ${DEPLOY_RUN_PORT}..."

package/lib/__templates__/vite/server/vite.ts

@@ -13,6 +13,13 @@ function isProdProjectEnv(value?: string): boolean {
 
 const isDev = !isProdProjectEnv(process.env.LICOS_PROJECT_ENV);
 
+function mountProjectAssets(app: Application) {
+  const assetsPath = path.resolve(process.cwd(), 'assets');
+  if (fs.existsSync(assetsPath)) {
+    app.use('/assets', express.static(assetsPath));
+  }
+}
+
 /**
  * 集成 Vite 开发服务器（中间件模式）
  */
@@ -31,6 +38,8 @@ export async function setupViteMiddleware(app: Application) {
     appType: 'spa',
   });
 
+  mountProjectAssets(app);
+
   // 使用 Vite middleware
   app.use(vite.middlewares);
 
@@ -48,7 +57,8 @@ export function setupStaticServer(app: Application) {
     process.exit(1);
   }
 
-  // 1. 服务静态文件（如果存在对应文件则直接返回）
+  // 1. 服务项目根 assets/ 和构建产物静态文件（如果存在对应文件则直接返回）
+  mountProjectAssets(app);
   app.use(express.static(distPath));
 
   // 2. SPA fallback - 所有未处理的请求返回 index.html

package/lib/__templates__/workflow/pyproject.toml

@@ -4,7 +4,7 @@ version = "0.1.0"
 description = "LICOS LangGraph workflow project"
 requires-python = ">=3.12"
 dependencies = [
-    "licos-agent-runtime>=0.2.10",
+    "licos-agent-runtime>=0.2.11",
 ]
 
 [tool.uv]

package/lib/__templates__/workflow/requirements.txt

@@ -1 +1 @@
-licos-agent-runtime>=0.2.10
+licos-agent-runtime>=0.2.11

package/lib/cli.js

@@ -2109,7 +2109,7 @@ const EventBuilder = {
 };
 
 var name = "@kmlckj/licos-ai-cli";
-var version = "0.0.36";
+var version = "0.0.39";
 var description = "LICOS AI coding workspace CLI - project template engine and dev tools";
 var license = "MIT";
 var author = "kmlckj";

package/package.json

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