@kmlckj/licos-ai-cli 0.0.1

package/lib/__templates__/templates.json

@@ -0,0 +1,162 @@
+{
+  "$schema": "https://json-schema.org/draft-07/schema",
+  "templates": [
+    {
+      "name": "expo",
+      "description": "Expo template for React Native applications",
+      "location": "./expo",
+      "paramsSchema": {
+        "type": "object",
+        "properties": {
+          "appName": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[a-z0-9-]+$",
+            "description": "Application name (lowercase, alphanumeric and hyphens only)"
+          },
+          "port": {
+            "type": "number",
+            "default": 8081,
+            "minimum": 1024,
+            "maximum": 65535,
+            "description": "Metro bundler port"
+          }
+        },
+        "required": [],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "native-static",
+      "description": "Native Static（纯静态）：`licos init ${LICOS_WORKSPACE_PATH} --template native-static`\n- 适用：纯静态 HTML/CSS/JS 项目、静态网站\n- 使用 Python http.server 作为开发服务器\n- 不需要 Node.js 环境，适合简单静态内容",
+      "location": "./native-static",
+      "paramsSchema": {
+        "type": "object",
+        "properties": {},
+        "required": [],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "nextjs",
+      "description": "Next.js（复杂项目）：`licos init ${LICOS_WORKSPACE_PATH} --template nextjs`\n- 适用：全栈应用、复杂多页面等复杂项目\n- 使用默认nextjs项目规范\n    - **目录规范**： 默认开启src目录（打开--src-dir选项）：项目文件（如 app 目录、pages 目录、components 等）初始化到 src/ 目录下。\n    - **项目理解加速**：初始可以依赖项目下 `package.json` 文件理解项目类型，如果没有或无法理解退化成阅读其他文件。\n    - **UI设计与组件规范**：Next.js项目**必须默认**采用 shadcn/ui 风格和规范，`shadcn/ui`组件默认完整的预装在`src/components/ui/`目录下",
+      "location": "./nextjs",
+      "paramsSchema": {
+        "type": "object",
+        "properties": {
+          "appName": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[a-z0-9-]+$",
+            "description": "Application name (lowercase, alphanumeric and hyphens only)"
+          },
+          "port": {
+            "type": "number",
+            "default": 5000,
+            "minimum": 1024,
+            "maximum": 65535,
+            "description": "Development server port (for Next.js dev server)"
+          }
+        },
+        "required": [],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "nuxt-vue",
+      "description": "Nuxt.js（服务端 + Vue）：`licos init ${LICOS_WORKSPACE_PATH} --template nuxt-vue`\n- 适用：全栈应用、需要服务端接口能力的 Vue 项目\n- 特点：\n    - **服务端能力**：内置服务端 API 路由，可直接创建后端接口\n    - **Vue 3**：基于最新的 Vue 3 Composition API\n    - **Vite**：使用 Vite 作为构建工具，开发体验极佳\n    - **TypeScript**：完整的 TypeScript 支持\n    - **文件路由**：基于文件系统的自动路由\n    - **项目理解加速**：可依赖项目下 `package.json` 和 `nuxt.config.ts` 理解项目配置",
+      "location": "./nuxt-vue",
+      "paramsSchema": {
+        "type": "object",
+        "properties": {
+          "appName": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[a-z0-9-]+$",
+            "description": "Application name (lowercase, alphanumeric and hyphens only)"
+          },
+          "port": {
+            "type": "number",
+            "default": 5000,
+            "minimum": 1024,
+            "maximum": 65535,
+            "description": "Development server port (for Nuxt dev server)"
+          },
+          "hmrPort": {
+            "type": "number",
+            "default": 6000,
+            "minimum": 1024,
+            "maximum": 65535,
+            "description": "Hot Module Replacement (HMR) port"
+          }
+        },
+        "required": [],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "taro",
+      "description": "Taro（小程序 + H5）：`licos init ${LICOS_WORKSPACE_PATH} --template taro`\n- 适用：微信小程序、H5 跨端应用\n- 前后端分离架构：Taro 4 + NestJS\n- 支持微信小程序和 H5 双端构建\n- 使用 TailwindCSS + weapp-tailwindcss 实现跨端样式",
+      "location": "./taro",
+      "paramsSchema": {
+        "type": "object",
+        "properties": {
+          "appName": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[a-z0-9-]+$",
+            "description": "Application name (lowercase, alphanumeric and hyphens only)"
+          },
+          "port": {
+            "type": "number",
+            "default": 5000,
+            "minimum": 1024,
+            "maximum": 65535,
+            "description": "H5 development server port"
+          },
+          "serverPort": {
+            "type": "number",
+            "default": 3000,
+            "minimum": 1024,
+            "maximum": 65535,
+            "description": "NestJS backend server port"
+          }
+        },
+        "required": [],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "vite",
+      "description": "Vite（简单项目）：`licos init ${LICOS_WORKSPACE_PATH} --template vite`\n- 适用：轻量级 SPA、纯前端交互、仪表盘等轻量级项目。",
+      "location": "./vite",
+      "paramsSchema": {
+        "type": "object",
+        "properties": {
+          "appName": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[a-z0-9-]+$",
+            "description": "Application name (lowercase, alphanumeric and hyphens only)"
+          },
+          "port": {
+            "type": "number",
+            "default": 5000,
+            "minimum": 1024,
+            "maximum": 65535,
+            "description": "Development server port"
+          },
+          "hmrPort": {
+            "type": "number",
+            "default": 6000,
+            "minimum": 1024,
+            "maximum": 65535,
+            "description": "Development HMR server port"
+          }
+        },
+        "required": [],
+        "additionalProperties": false
+      }
+    }
+  ]
+}

package/lib/__templates__/vite/.licos

@@ -0,0 +1,12 @@
+[project]
+requires = ["nodejs-24"]
+
+[dev]
+build = ["bash", "./scripts/prepare.sh"]
+run = ["bash", "./scripts/dev.sh"]
+deps = ["git"] # -> apt install git
+
+[deploy]
+build = ["bash","./scripts/build.sh"]
+run = ["bash","./scripts/start.sh"]
+deps = ["git"] # -> apt install git

package/lib/__templates__/vite/AGENTS.md

@@ -0,0 +1,41 @@
+# 项目上下文
+
+## 技术栈
+
+- **核心**: Vite 7, TypeScript, Express
+- **UI**: Tailwind CSS
+
+## 目录结构
+
+```
+├── scripts/            # 构建与启动脚本
+│   ├── build.sh        # 构建脚本
+│   ├── dev.sh          # 开发环境启动脚本
+│   ├── prepare.sh      # 预处理脚本
+│   └── start.sh        # 生产环境启动脚本
+├── server/             # 服务端逻辑
+│   ├── routes/         # API 路由
+│   ├── server.ts       # Express 服务入口
+│   └── vite.ts         # Vite 中间件集成
+├── src/                # 前端源码
+│   ├── index.css       # 全局样式
+│   ├── index.ts        # 客户端入口
+│   └── main.ts         # 主逻辑
+├── index.html          # 入口 HTML
+├── package.json        # 项目依赖管理
+├── tsconfig.json       # TypeScript 配置
+└── vite.config.ts      # Vite 配置
+```
+
+## 包管理规范
+
+**仅允许使用 pnpm** 作为包管理器，**严禁使用 npm 或 yarn**。
+**常用命令**：
+- 安装依赖：`pnpm add <package>`
+- 安装开发依赖：`pnpm add -D <package>`
+- 安装所有依赖：`pnpm install`
+- 移除依赖：`pnpm remove <package>`
+
+## 开发规范
+
+- 使用 Tailwind CSS 进行样式开发

package/lib/__templates__/vite/README.md

@@ -0,0 +1,418 @@
+# <%= appName %>
+
+这是一个基于 Express + Vite + TypeScript + Tailwind CSS 的全栈 Web 应用项目，由LICOS CLI 创建。
+
+**核心特性：**
+- 🚀 前端：Vite + TypeScript + Tailwind CSS
+- 🔧 后端：Express + TypeScript，提供 RESTful API
+- 🔥 开发模式：Vite HMR + Express API，单进程启动
+- 📦 生产模式：Express 静态服务 + API，高性能部署
+
+## 快速开始
+
+### 启动开发服务器
+
+```bash
+licos dev
+```
+
+启动后，在浏览器中打开 [http://localhost:<%= port %>](http://localhost:<%= port %>) 查看应用。
+
+开发服务器支持热更新（HMR），修改代码后页面会自动刷新。
+
+### 构建生产版本
+
+```bash
+licos build
+```
+
+构建产物位于 `dist/` 目录，可直接部署到静态托管服务。
+
+### 预览生产版本
+
+```bash
+licos start
+```
+
+在本地启动一个静态服务器，预览生产构建的效果。
+
+## 项目结构
+
+```
+├── server/                # 后端服务器目录
+│   ├── index.ts          # express 服务器入口
+│   ├── routes/           # API 路由目录
+│   │   └── index.ts      # 路由定义
+│   └── vite.ts           # Vite 集成逻辑
+├── src/                   # 前端源码目录
+│   ├── index.ts          # 前端应用入口（初始化）
+│   ├── main.ts           # 前端主逻辑文件
+│   └── index.css         # 全局样式（包含 Tailwind 指令）
+├── index.html            # HTML 入口文件
+├── vite.config.ts        # Vite 配置
+├── tailwind.config.ts    # Tailwind CSS 配置
+└── tsconfig.json         # TypeScript 配置
+```
+
+**目录说明：**
+
+- **`server/`** - 后端服务器代码
+  - `server.ts` - 服务器主入口，负责创建和启动 Express 应用
+  - `routes/` - API 路由模块，支持按功能拆分路由
+  - `vite.ts` - Vite 开发服务器和静态文件服务集成
+
+- **`src/`** - 前端应用代码
+  - 所有前端相关代码都在这里
+
+**工作原理：**
+
+- **开发模式** (`licos dev`)：
+  - 运行 `server/server.ts` 启动 Express 服务器
+  - Vite 以 middleware 模式集成到 Express
+  - 前端支持 HMR（热模块替换）
+  - 后端 API 和前端在同一进程，端口 <%= port %>
+
+- **生产模式** (`licos start`)：
+  - `licos build` 构建前端 → `dist/` 目录
+  - `licos build` 构建后端 → `dist-server/index.js` (CommonJS 格式)
+  - 运行 `dist-server/index.js` 启动生产服务器
+  - Express 服务静态文件 + API 路由
+  - 单一 Node.js 进程，轻量高效
+
+## 核心开发规范
+
+### 1. 后端 API 开发
+
+**添加新的 API 路由**
+
+在 `server/routes/index.ts` 中添加路由：
+
+```typescript
+// GET 请求示例
+router.get('/api/users', (req, res) => {
+  res.json({
+    users: [
+      { id: 1, name: 'Alice' },
+      { id: 2, name: 'Bob' },
+    ],
+  });
+});
+
+// POST 请求示例
+router.post('/api/users', (req, res) => {
+  const userData = req.body;
+  // 处理业务逻辑
+  res.json({
+    success: true,
+    user: userData,
+  });
+});
+
+// 动态路由参数
+router.get('/api/users/:id', (req, res) => {
+  const userId = req.params.id;
+  res.json({
+    id: userId,
+    name: 'User ' + userId,
+  });
+});
+```
+
+**拆分路由模块**（推荐）
+
+当路由变多时，可以按功能拆分：
+
+```typescript
+// server/routes/users.ts
+import { Router } from 'express';
+
+const router = Router();
+
+router.get('/api/users', (req, res) => {
+  // 用户列表逻辑
+  res.json({ users: [] });
+});
+
+router.post('/api/users', (req, res) => {
+  // 创建用户逻辑
+  res.json({ success: true });
+});
+
+export default router;
+```
+
+然后在 `server/server.ts` 中注册：
+
+```typescript
+import usersRouter from './routes/users';
+
+// 注册路由
+app.use(usersRouter);
+```
+
+**前端调用 API**
+
+```typescript
+// GET 请求
+async function getUsers() {
+  const response = await fetch('/api/users');
+  const data = await response.json();
+  console.log(data);
+}
+
+// POST 请求
+async function createUser(name: string) {
+  const response = await fetch('/api/users', {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify({ name }),
+  });
+  const data = await response.json();
+  console.log(data);
+}
+```
+
+**API 最佳实践**
+
+- ✅ 所有 API 路由以 `/api` 开头，避免与前端路由冲突
+- ✅ 使用 RESTful 设计：GET 查询、POST 创建、PUT 更新、DELETE 删除
+- ✅ 返回统一的响应格式：`{ success: boolean, data?: any, error?: string }`
+- ✅ 添加错误处理和参数验证
+
+### 2. 样式开发
+
+**使用 Tailwind CSS**
+
+本项目使用 Tailwind CSS 进行样式开发，支持亮色/暗色模式自动切换。
+
+```typescript
+// 使用 Tailwind 工具类
+app.innerHTML = `
+  <div class="flex items-center justify-center min-h-screen bg-white dark:bg-black">
+    <h1 class="text-4xl font-bold text-black dark:text-white">
+      Hello World
+    </h1>
+  </div>
+`;
+```
+
+**主题变量**
+
+主题变量定义在 `src/index.css` 中，支持自动适配系统主题：
+
+```css
+:root {
+  --background: #ffffff;
+  --foreground: #171717;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --background: #0a0a0a;
+    --foreground: #ededed;
+  }
+}
+```
+
+**常用 Tailwind 类名**
+
+- 布局：`flex`, `grid`, `container`, `mx-auto`
+- 间距：`p-4`, `m-4`, `gap-4`, `space-x-4`
+- 颜色：`bg-white`, `text-black`, `dark:bg-black`, `dark:text-white`
+- 排版：`text-lg`, `font-bold`, `leading-8`, `tracking-tight`
+- 响应式：`sm:`, `md:`, `lg:`, `xl:`
+
+### 2. 依赖管理
+
+**必须使用 pnpm 管理依赖**
+
+```bash
+# ✅ 安装依赖
+pnpm install
+
+# ✅ 添加新依赖
+pnpm add package-name
+
+# ✅ 添加开发依赖
+pnpm add -D package-name
+
+# ❌ 禁止使用 npm 或 yarn
+# npm install  # 错误！
+# yarn add     # 错误！
+```
+
+项目已配置 `preinstall` 脚本，使用其他包管理器会报错。
+
+### 3. TypeScript 开发
+
+**类型安全**
+
+充分利用 TypeScript 的类型系统，确保代码质量：
+
+```typescript
+// 定义接口
+interface User {
+  id: number;
+  name: string;
+  email: string;
+}
+
+// 使用类型
+function createUser(data: User): void {
+  console.log(`Creating user: ${data.name}`);
+}
+
+// DOM 操作类型推断
+const button = document.querySelector<HTMLButtonElement>('#my-button');
+if (button) {
+  button.addEventListener('click', () => {
+    console.log('Button clicked');
+  });
+}
+```
+
+**避免 any 类型**
+
+尽量避免使用 `any`，使用 `unknown` 或具体类型：
+
+```typescript
+// ❌ 不推荐
+function process(data: any) { }
+
+// ✅ 推荐
+function process(data: unknown) {
+  if (typeof data === 'string') {
+    console.log(data.toUpperCase());
+  }
+}
+```
+
+## 常见开发场景
+
+### 添加新页面
+
+本项目是单页应用（SPA），如需多页面：
+
+1. 在 `src/` 下创建新的 `.ts` 文件
+2. 在 `vite.config.ts` 中配置多入口
+3. 创建对应的 `.html` 文件
+
+### DOM 操作
+
+```typescript
+// 获取元素
+const app = document.getElementById('app');
+const button = document.querySelector<HTMLButtonElement>('.my-button');
+
+// 动态创建元素
+const div = document.createElement('div');
+div.className = 'flex items-center gap-4';
+div.textContent = 'Hello World';
+app?.appendChild(div);
+
+// 事件监听
+button?.addEventListener('click', (e) => {
+  console.log('Clicked', e);
+});
+```
+
+### 数据获取
+
+```typescript
+// Fetch API
+async function fetchData() {
+  try {
+    const response = await fetch('https://api.example.com/data');
+    const data = await response.json();
+    return data;
+  } catch (error) {
+    console.error('Failed to fetch data:', error);
+  }
+}
+
+// 使用数据
+fetchData().then(data => {
+  console.log(data);
+});
+```
+
+### 环境变量
+
+在 `.env` 文件中定义环境变量（需以 `VITE_` 开头）：
+
+```bash
+VITE_API_URL=https://api.example.com
+```
+
+在代码中使用：
+
+```typescript
+const apiUrl = import.meta.env.VITE_API_URL;
+console.log(apiUrl); // https://api.example.com
+```
+
+## 技术栈
+
+**前端：**
+- **构建工具**: Vite 7.x
+- **语言**: TypeScript 5.x
+- **样式**: Tailwind CSS 3.x
+
+**后端：**
+- **框架**: Express 4.x
+- **内置中间件**: express.json(), express.urlencoded(), express.static()
+
+**工具：**
+- **包管理器**: pnpm 9+
+- **运行时**: Node.js 18+
+- **开发工具**: tsx (TypeScript 执行器)
+
+## 参考文档
+
+**前端：**
+- [Vite 官方文档](https://cn.vitejs.dev/)
+- [TypeScript 官方文档](https://www.typescriptlang.org/zh/docs/)
+- [Tailwind CSS 文档](https://tailwindcss.com/docs)
+
+**后端：**
+- [Express 官方文档](https://expressjs.com/)
+- [Express 中文文档](https://expressjs.com/zh-cn/)
+
+## 重要提示
+
+1. **必须使用 pnpm** 作为包管理器
+2. **使用 TypeScript** 进行类型安全开发，避免使用 `any`
+3. **使用 Tailwind CSS** 进行样式开发，支持响应式和暗色模式
+4. **环境变量必须以 `VITE_` 开头** 才能在客户端代码中访问
+5. **开发时使用 `licos dev`**，支持热更新和快速刷新
+6. **API 路由以 `/api` 开头**，避免与前端路由冲突
+7. **单进程架构**：开发和生产环境都是前后端在同一进程中运行
+
+## 常见问题
+
+**Q: 如何分离前后端端口？**
+
+如果需要前后端分离部署，可以：
+- 前端：使用 `npx vite` 单独启动（默认端口 5173）
+- 后端：修改 `server.ts`，移除 Vite middleware，单独启动
+
+**Q: 如何添加数据库？**
+
+```bash
+# 安装数据库客户端（以 PostgreSQL 为例）
+pnpm add pg
+pnpm add -D @types/pg
+
+# 在 server.ts 中使用
+import { Pool } from 'pg';
+const pool = new Pool({ connectionString: process.env.DATABASE_URL });
+```
+
+**Q: 如何部署？**
+
+1. 运行 `licos build` 构建前后端
+2. 将整个项目上传到服务器
+3. 运行 `pnpm install --prod`
+4. 运行 `licos start` 启动服务

package/lib/__templates__/vite/_gitignore

@@ -0,0 +1,68 @@
+# Dependencies
+node_modules/
+.pnp
+.pnp.js
+
+# Production build
+dist/
+dist-server/
+build/
+out/
+
+# Testing
+coverage/
+*.lcov
+.nyc_output
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Cache
+.cache/
+.eslintcache
+.stylelintcache
+node-compile-cache/
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+!.vscode/settings.json
+.idea/
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# OS files
+.DS_Store
+.DS_Store?
+._*
+Thumbs.db
+
+# TypeScript
+*.tsbuildinfo
+
+# Vite
+.vite/
+
+.coze-logs