@coze-arch/cli 0.0.3-alpha.419211 → 0.0.3-beta.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
# 项目上下文
|
|
2
|
+
|
|
3
|
+
### 版本技术栈
|
|
4
|
+
|
|
5
|
+
- **Framework**: Next.js 16 (App Router)
|
|
6
|
+
- **Core**: React 19
|
|
7
|
+
- **Language**: TypeScript 5
|
|
8
|
+
- **UI 组件**: shadcn/ui (基于 Radix UI)
|
|
9
|
+
- **Styling**: Tailwind CSS 4
|
|
10
|
+
|
|
11
|
+
## 目录结构
|
|
12
|
+
|
|
13
|
+
```
|
|
14
|
+
├── public/ # 静态资源
|
|
15
|
+
├── scripts/ # 构建与启动脚本
|
|
16
|
+
│ ├── build.sh # 构建脚本
|
|
17
|
+
│ ├── dev.sh # 开发环境启动脚本
|
|
18
|
+
│ ├── prepare.sh # 预处理脚本
|
|
19
|
+
│ └── start.sh # 生产环境启动脚本
|
|
20
|
+
├── src/
|
|
21
|
+
│ ├── app/ # 页面路由与布局
|
|
22
|
+
│ ├── components/ui/ # Shadcn UI 组件库
|
|
23
|
+
│ ├── hooks/ # 自定义 Hooks
|
|
24
|
+
│ ├── lib/ # 工具库
|
|
25
|
+
│ │ └── utils.ts # 通用工具函数 (cn)
|
|
26
|
+
│ └── server.ts # 自定义服务端入口
|
|
27
|
+
├── next.config.ts # Next.js 配置
|
|
28
|
+
├── package.json # 项目依赖管理
|
|
29
|
+
└── tsconfig.json # TypeScript 配置
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
- 项目文件（如 app 目录、pages 目录、components 等）默认初始化到 `src/` 目录下。
|
|
33
|
+
|
|
34
|
+
## 包管理规范
|
|
35
|
+
|
|
36
|
+
**仅允许使用 pnpm** 作为包管理器，**严禁使用 npm 或 yarn**。
|
|
37
|
+
**常用命令**：
|
|
38
|
+
- 安装依赖：`pnpm add <package>`
|
|
39
|
+
- 安装开发依赖：`pnpm add -D <package>`
|
|
40
|
+
- 安装所有依赖：`pnpm install`
|
|
41
|
+
- 移除依赖：`pnpm remove <package>`
|
|
42
|
+
|
|
43
|
+
## 开发规范
|
|
44
|
+
|
|
45
|
+
- **项目理解加速**：初始可以依赖项目下`package.json`文件理解项目类型，如果没有或无法理解退化成阅读其他文件。
|
|
46
|
+
- **Hydration 错误预防**：严禁在 JSX 渲染逻辑中直接使用 typeof window、Date.now()、Math.random() 等动态数据。必须使用 'use client' 并配合 useEffect + useState 确保动态内容仅在客户端挂载后渲染；同时严禁非法 HTML 嵌套（如 <p> 嵌套 <div>）。
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
## UI 设计与组件规范 (UI & Styling Standards)
|
|
50
|
+
|
|
51
|
+
- 模板默认预装核心组件库 `shadcn/ui`，位于`src/components/ui/`目录下
|
|
52
|
+
- Next.js 项目**必须默认**采用 shadcn/ui 组件、风格和规范，**除非用户指定用其他的组件和规范。**
|
|
53
|
+
|
|
54
|
+
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# 项目上下文
|
|
2
|
+
|
|
3
|
+
## 技术栈
|
|
4
|
+
|
|
5
|
+
- **核心**: Nuxt 4, Vue 3, TypeScript
|
|
6
|
+
- **UI**: Tailwind CSS
|
|
7
|
+
|
|
8
|
+
## 目录结构
|
|
9
|
+
|
|
10
|
+
```
|
|
11
|
+
├── app/ # 页面路由与布局
|
|
12
|
+
│ ├── pages/ # 页面组件
|
|
13
|
+
│ └── app.vue # 根组件
|
|
14
|
+
├── assets/ # 静态资源
|
|
15
|
+
│ └── css/ # 全局样式
|
|
16
|
+
├── public/ # 公共静态资源
|
|
17
|
+
├── scripts/ # 构建与启动脚本
|
|
18
|
+
│ ├── build.sh # 构建脚本
|
|
19
|
+
│ ├── dev.sh # 开发环境启动脚本
|
|
20
|
+
│ ├── prepare.sh # 预处理脚本
|
|
21
|
+
│ └── start.sh # 生产环境启动脚本
|
|
22
|
+
├── server/ # 服务端逻辑
|
|
23
|
+
│ ├── api/ # API 路由
|
|
24
|
+
│ ├── middleware/ # 中间件
|
|
25
|
+
│ └── routes/ # 服务端路由
|
|
26
|
+
├── nuxt.config.ts # Nuxt 配置
|
|
27
|
+
├── package.json # 项目依赖管理
|
|
28
|
+
└── tsconfig.json # TypeScript 配置
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## 包管理规范
|
|
32
|
+
|
|
33
|
+
**仅允许使用 pnpm** 作为包管理器，**严禁使用 npm 或 yarn**。
|
|
34
|
+
**常用命令**：
|
|
35
|
+
- 安装依赖：`pnpm add <package>`
|
|
36
|
+
- 安装开发依赖：`pnpm add -D <package>`
|
|
37
|
+
- 安装所有依赖：`pnpm install`
|
|
38
|
+
- 移除依赖：`pnpm remove <package>`
|
|
39
|
+
|
|
40
|
+
## 开发规范
|
|
41
|
+
|
|
42
|
+
- 使用 Tailwind CSS 进行样式开发
|
|
@@ -126,43 +126,6 @@
|
|
|
126
126
|
"additionalProperties": false
|
|
127
127
|
}
|
|
128
128
|
},
|
|
129
|
-
{
|
|
130
|
-
"name": "test-only",
|
|
131
|
-
"description": "Test template showcasing all template hooks and features",
|
|
132
|
-
"location": "./test-only",
|
|
133
|
-
"paramsSchema": {
|
|
134
|
-
"type": "object",
|
|
135
|
-
"properties": {
|
|
136
|
-
"appName": {
|
|
137
|
-
"type": "string",
|
|
138
|
-
"minLength": 1,
|
|
139
|
-
"pattern": "^[a-z0-9-]+$",
|
|
140
|
-
"description": "Application name (lowercase, alphanumeric and hyphens only)"
|
|
141
|
-
},
|
|
142
|
-
"port": {
|
|
143
|
-
"type": "number",
|
|
144
|
-
"default": 5000,
|
|
145
|
-
"minimum": 1024,
|
|
146
|
-
"maximum": 65535,
|
|
147
|
-
"description": "Development server port"
|
|
148
|
-
},
|
|
149
|
-
"includeTests": {
|
|
150
|
-
"type": "boolean",
|
|
151
|
-
"default": true,
|
|
152
|
-
"nullable": true,
|
|
153
|
-
"description": "Include test files"
|
|
154
|
-
},
|
|
155
|
-
"addCopyright": {
|
|
156
|
-
"type": "boolean",
|
|
157
|
-
"default": false,
|
|
158
|
-
"nullable": true,
|
|
159
|
-
"description": "Add copyright header to source files"
|
|
160
|
-
}
|
|
161
|
-
},
|
|
162
|
-
"required": [],
|
|
163
|
-
"additionalProperties": false
|
|
164
|
-
}
|
|
165
|
-
},
|
|
166
129
|
{
|
|
167
130
|
"name": "vite",
|
|
168
131
|
"description": "Vite（简单项目）：`coze init ${COZE_WORKSPACE_PATH} --template vite`\n- 适用：轻量级 SPA、纯前端交互、仪表盘等轻量级项目。",
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
# 项目上下文
|
|
2
|
+
|
|
3
|
+
## 技术栈
|
|
4
|
+
|
|
5
|
+
- **核心**: Vite 7, TypeScript, Express
|
|
6
|
+
- **UI**: Tailwind CSS
|
|
7
|
+
|
|
8
|
+
## 目录结构
|
|
9
|
+
|
|
10
|
+
```
|
|
11
|
+
├── scripts/ # 构建与启动脚本
|
|
12
|
+
│ ├── build.sh # 构建脚本
|
|
13
|
+
│ ├── dev.sh # 开发环境启动脚本
|
|
14
|
+
│ ├── prepare.sh # 预处理脚本
|
|
15
|
+
│ └── start.sh # 生产环境启动脚本
|
|
16
|
+
├── server/ # 服务端逻辑
|
|
17
|
+
│ ├── routes/ # API 路由
|
|
18
|
+
│ ├── server.ts # Express 服务入口
|
|
19
|
+
│ └── vite.ts # Vite 中间件集成
|
|
20
|
+
├── src/ # 前端源码
|
|
21
|
+
│ ├── index.css # 全局样式
|
|
22
|
+
│ ├── index.ts # 客户端入口
|
|
23
|
+
│ └── main.ts # 主逻辑
|
|
24
|
+
├── index.html # 入口 HTML
|
|
25
|
+
├── package.json # 项目依赖管理
|
|
26
|
+
├── tsconfig.json # TypeScript 配置
|
|
27
|
+
└── vite.config.ts # Vite 配置
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## 包管理规范
|
|
31
|
+
|
|
32
|
+
**仅允许使用 pnpm** 作为包管理器，**严禁使用 npm 或 yarn**。
|
|
33
|
+
**常用命令**：
|
|
34
|
+
- 安装依赖：`pnpm add <package>`
|
|
35
|
+
- 安装开发依赖：`pnpm add -D <package>`
|
|
36
|
+
- 安装所有依赖：`pnpm install`
|
|
37
|
+
- 移除依赖：`pnpm remove <package>`
|
|
38
|
+
|
|
39
|
+
## 开发规范
|
|
40
|
+
|
|
41
|
+
- 使用 Tailwind CSS 进行样式开发
|
package/lib/cli.js
CHANGED