@coze-arch/cli 0.0.3 → 0.0.5

package/lib/__templates__/expo/AGENTS.md

@@ -0,0 +1,77 @@
+# Expo App + Express.js
+
+## 目录结构规范（严格遵循）
+
+当前仓库是一个 monorepo（基于 pnpm 的 workspace）
+
+- Expo 代码在 client 目录，Express.js 代码在 server 目录
+- 本模板默认无 Tab Bar，可按需改造
+
+目录结构说明
+
+├── server/                     # 服务端代码根目录 (Express.js)
+|   ├── src/
+│   │   └── index.ts            # Express 入口文件
+|   └── package.json            # 服务端 package.json
+├── client/                     # React Native 前端代码
+│   ├── app/                    # Expo Router 路由目录（仅路由配置）
+│   │   ├── _layout.tsx         # 根布局文件（必需，务必阅读）
+│   │   ├── home.tsx            # 首页
+│   │   └── index.tsx           # re-export home.tsx
+│   ├── screens/                # 页面实现目录（与 app/ 路由对应）
+│   │   └── demo/               # demo 示例页面
+│   │       ├── index.tsx       # 页面组件实现
+│   │       └── styles.ts       # 页面样式
+│   ├── components/             # 可复用组件
+│   │   └── Screen.tsx          # 页面容器组件（必用）
+│   ├── hooks/                  # 自定义 Hooks
+│   ├── contexts/               # React Context 代码
+│   ├── constants/              # 常量定义（如主题配置）
+│   ├── utils/                  # 工具函数
+│   ├── assets/                 # 静态资源
+|   └── package.json            # Expo 应用 package.json
+├── package.json
+├── .cozeproj                   # 预置脚手架脚本（禁止修改）
+└── .coze                       # 配置文件（禁止修改）
+
+## 依赖管理与模块导入规范
+
+### 依赖安装
+**禁止**使用 `npm` 或 `yarn`，按目录区分安装命令：
+
+| 目录 | 安装命令 | 说明 |
+|------|----------|------|
+| `client/` | `npx expo install <package>` | Expo 会自动选择与 SDK 兼容的版本 |
+| `server/` | `pnpm add <package>` | 使用 pnpm 管理后端依赖 |
+
+```bash
+# client 目录（Expo 项目）
+cd client && npx expo install expo-camera expo-image-picker
+
+# server 目录（Express 项目）
+cd server && pnpm add axios cors
+```
+
+**网络问题处理**：`npx expo install` 可能因网络原因失败，失败时重试 2 次，仍失败则改用 `pnpm add` 安装
+
+## Expo 开发规范
+
+### 路径别名
+
+Expo 配置了 `@/` 路径别名指向 `client/` 目录：
+
+```tsx
+// 正确
+import { Screen } from '@/components/Screen';
+
+// 避免相对路径
+import { Screen } from '../../../components/Screen';
+```
+
+## 本地开发
+
+运行 coze dev 可以同时启动前端和后端服务，如果端口已占用，该命令会先杀掉占用端口的进程再启动，也可以用来重启前端和后端服务
+
+```bash
+coze dev
+```

package/lib/__templates__/expo/README.md

@@ -34,22 +34,25 @@
 ├── .cozeproj                   # 预置脚手架脚本（禁止修改）
 └── .coze                       # 配置文件（禁止修改）
 
-## 安装依赖
+## 依赖管理与模块导入规范
 
-### 命令
+### 依赖安装
+**禁止**使用 `npm` 或 `yarn`，按目录区分安装命令：
 
-```bash
-pnpm i
-```
-
-### 新增依赖约束
+| 目录 | 安装命令 | 说明 |
+|------|----------|------|
+| `client/` | `npx expo install <package>` | Expo 会自动选择与 SDK 兼容的版本 |
+| `server/` | `pnpm add <package>` | 使用 pnpm 管理后端依赖 |
 
-如果需要新增依赖，需在 client 和 server 各自的目录添加（原因：隔离前后端的依赖），禁止在根目录直接安装依赖
+```bash
+# client 目录（Expo 项目）
+cd client && npx expo install expo-camera expo-image-picker
 
-### 新增依赖标准流程
+# server 目录（Express 项目）
+cd server && pnpm add axios cors
+```
 
-- 编辑 `client/package.json` 或 `server/package.json`
-- 在根目录执行 `pnpm i`
+**网络问题处理**：`npx expo install` 可能因网络原因失败，失败时重试 2 次，仍失败则改用 `pnpm add` 安装
 
 ## Expo 开发规范
 

package/lib/__templates__/expo/client/contexts/AuthContext.tsx

@@ -33,9 +33,15 @@ export const AuthProvider: React.FC<{ children: ReactNode }> = ({ children }) =>
     token: null,
     isAuthenticated: false,
     isLoading: false,
-    login: async (token: string) => {},
-    logout: async () => {},
-    updateUser: () => {},
+
+    // 登录逻辑，根据项目实际情况实现
+    login: async (token: string) => {}, // eslint-disable-line @typescript-eslint/no-empty-function
+
+    // 登出逻辑，根据项目实际情况实现
+    logout: async () => {}, // eslint-disable-line @typescript-eslint/no-empty-function
+
+    // 更新用户信息，根据项目实际情况实现
+    updateUser: () => {}, // eslint-disable-line @typescript-eslint/no-empty-function
   };
   return <AuthContext.Provider value={value}>{children}</AuthContext.Provider>;
 };

package/lib/__templates__/expo/client/eslint.config.mjs

@@ -100,6 +100,9 @@ export default [
         },
       ],
       'reactnative/wrap-horizontal-scrollview-inside-view': ['error'],
+      'no-empty-function': 'off',
+      '@typescript-eslint/no-empty-function': 'error',
+      'no-warning-comments': ['error', { terms: ['TODO'], location: 'start' }],
     },
   },
 

package/lib/__templates__/nextjs/AGENTS.md

@@ -0,0 +1,54 @@
+# 项目上下文
+
+### 版本技术栈
+
+- **Framework**: Next.js 16 (App Router)
+- **Core**: React 19
+- **Language**: TypeScript 5
+- **UI 组件**: shadcn/ui (基于 Radix UI)
+- **Styling**: Tailwind CSS 4
+
+## 目录结构
+
+```
+├── public/                 # 静态资源
+├── scripts/                # 构建与启动脚本
+│   ├── build.sh            # 构建脚本
+│   ├── dev.sh              # 开发环境启动脚本
+│   ├── prepare.sh          # 预处理脚本
+│   └── start.sh            # 生产环境启动脚本
+├── src/
+│   ├── app/                # 页面路由与布局
+│   ├── components/ui/      # Shadcn UI 组件库
+│   ├── hooks/              # 自定义 Hooks
+│   ├── lib/                # 工具库
+│   │   └── utils.ts        # 通用工具函数 (cn)
+│   └── server.ts           # 自定义服务端入口
+├── next.config.ts          # Next.js 配置
+├── package.json            # 项目依赖管理
+└── tsconfig.json           # TypeScript 配置
+```
+
+- 项目文件（如 app 目录、pages 目录、components 等）默认初始化到 `src/` 目录下。
+
+## 包管理规范
+
+**仅允许使用 pnpm** 作为包管理器，**严禁使用 npm 或 yarn**。
+**常用命令**：
+- 安装依赖：`pnpm add <package>`
+- 安装开发依赖：`pnpm add -D <package>`
+- 安装所有依赖：`pnpm install`
+- 移除依赖：`pnpm remove <package>`
+
+## 开发规范
+
+- **项目理解加速**：初始可以依赖项目下`package.json`文件理解项目类型，如果没有或无法理解退化成阅读其他文件。
+- **Hydration 错误预防**：严禁在 JSX 渲染逻辑中直接使用 typeof window、Date.now()、Math.random() 等动态数据。必须使用 'use client' 并配合 useEffect + useState 确保动态内容仅在客户端挂载后渲染；同时严禁非法 HTML 嵌套（如 <p> 嵌套 <div>）。
+
+
+## UI 设计与组件规范 (UI & Styling Standards)
+
+- 模板默认预装核心组件库 `shadcn/ui`，位于`src/components/ui/`目录下
+- Next.js 项目**必须默认**采用 shadcn/ui 组件、风格和规范，**除非用户指定用其他的组件和规范。**
+
+

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

@@ -0,0 +1,42 @@
+# 项目上下文
+
+## 技术栈
+
+- **核心**: Nuxt 4, Vue 3, TypeScript
+- **UI**: Tailwind CSS
+
+## 目录结构
+
+```
+├── app/                # 页面路由与布局
+│   ├── pages/          # 页面组件
+│   └── app.vue         # 根组件
+├── assets/             # 静态资源
+│   └── css/            # 全局样式
+├── public/             # 公共静态资源
+├── scripts/            # 构建与启动脚本
+│   ├── build.sh        # 构建脚本
+│   ├── dev.sh          # 开发环境启动脚本
+│   ├── prepare.sh      # 预处理脚本
+│   └── start.sh        # 生产环境启动脚本
+├── server/             # 服务端逻辑
+│   ├── api/            # API 路由
+│   ├── middleware/     # 中间件
+│   └── routes/         # 服务端路由
+├── nuxt.config.ts      # Nuxt 配置
+├── package.json        # 项目依赖管理
+└── tsconfig.json       # TypeScript 配置
+```
+
+## 包管理规范
+
+**仅允许使用 pnpm** 作为包管理器，**严禁使用 npm 或 yarn**。
+**常用命令**：
+- 安装依赖：`pnpm add <package>`
+- 安装开发依赖：`pnpm add -D <package>`
+- 安装所有依赖：`pnpm install`
+- 移除依赖：`pnpm remove <package>`
+
+## 开发规范
+
+- 使用 Tailwind CSS 进行样式开发

package/lib/__templates__/templates.json

@@ -126,43 +126,6 @@
         "additionalProperties": false
       }
     },
-    {
-      "name": "test-only",
-      "description": "Test template showcasing all template hooks and features",
-      "location": "./test-only",
-      "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"
-          },
-          "includeTests": {
-            "type": "boolean",
-            "default": true,
-            "nullable": true,
-            "description": "Include test files"
-          },
-          "addCopyright": {
-            "type": "boolean",
-            "default": false,
-            "nullable": true,
-            "description": "Add copyright header to source files"
-          }
-        },
-        "required": [],
-        "additionalProperties": false
-      }
-    },
     {
       "name": "vite",
       "description": "Vite（简单项目）：`coze init ${COZE_WORKSPACE_PATH} --template vite`\n- 适用：轻量级 SPA、纯前端交互、仪表盘等轻量级项目。",

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 进行样式开发