@coze-arch/cli 0.0.33-alpha.eeae5b → 0.0.34-alpha.da5090

package/lib/__templates__/expo/README.md

@@ -258,4 +258,4 @@ import { Screen } from '../../../components/Screen';
 
 ## 本地开发
 
-`coze dev`：用来首次启动前后端服务，也可以用来重启前后端服务（该命令会先尝试杀掉占用端口的进程，再启动服务）
+`coze-dev dev`：用来首次启动前后端服务，也可以用来重启前后端服务（该命令会先尝试杀掉占用端口的进程，再启动服务）

package/lib/__templates__/native-static/template.config.js

@@ -6,7 +6,7 @@
 // start_aigc
 const config = {
   description:
-    'Native Static（纯静态）：`coze init ${COZE_WORKSPACE_PATH} --template native-static`\n' +
+    'Native Static（纯静态）：`coze-dev init ${COZE_WORKSPACE_PATH} --template native-static`\n' +
     '- 适用：纯静态 HTML/CSS/JS 项目、静态网站\n' +
     '- 使用 Python http.server 作为开发服务器\n' +
     '- 不需要 Node.js 环境，适合简单静态内容',

package/lib/__templates__/nextjs/README.md

@@ -7,7 +7,7 @@
 ### 启动开发服务器
 
 ```bash
-coze dev
+coze-dev dev
 ```
 
 启动后，在浏览器中打开 [http://localhost:<%= port %>](http://localhost:<%= port %>) 查看应用。
@@ -17,13 +17,13 @@ coze dev
 ### 构建生产版本
 
 ```bash
-coze build
+coze-dev build
 ```
 
 ### 启动生产服务器
 
 ```bash
-coze start
+coze-dev start
 ```
 
 ## 项目结构

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

@@ -7,6 +7,6 @@ cd "${COZE_WORKSPACE_PATH}"
 
 echo "Installing dependencies..."
 pnpm install --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
-if command -v coze > /dev/null 2>&1 && coze check-bins --help > /dev/null 2>&1; then
-  coze check-bins --fix
+if command -v coze-dev > /dev/null 2>&1 && coze-dev check-bins --help > /dev/null 2>&1; then
+  coze-dev check-bins --fix
 fi

package/lib/__templates__/nextjs/template.config.js

@@ -9,7 +9,7 @@ import { appendFileSync, openSync, closeSync, mkdirSync } from 'fs';
 
 
 
-const description = `Next.js（复杂项目）：\`coze init \${COZE_WORKSPACE_PATH} --template nextjs\`
+const description = `Next.js（复杂项目）：\`coze-dev init \${COZE_WORKSPACE_PATH} --template nextjs\`
 - 适用：全栈应用、复杂多页面等复杂项目
 - 使用默认nextjs项目规范
     - **目录规范**： 默认开启src目录（打开--src-dir选项）：项目文件（如 app 目录、pages 目录、components 等）初始化到 src/ 目录下。

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

@@ -7,8 +7,8 @@ cd "${COZE_WORKSPACE_PATH}"
 
 echo "Installing dependencies..."
 pnpm install --prefer-frozen-lockfile --prefer-offline
-if command -v coze > /dev/null 2>&1 && coze check-bins --help > /dev/null 2>&1; then
-  coze check-bins --fix
+if command -v coze-dev > /dev/null 2>&1 && coze-dev check-bins --help > /dev/null 2>&1; then
+  coze-dev check-bins --fix
 fi
 
 echo "Preparing Nuxt project..."

package/lib/__templates__/nuxt-vue/template.config.js

@@ -7,7 +7,7 @@
 
 
 
-const description = `Nuxt.js（服务端 + Vue）：\`coze init \${COZE_WORKSPACE_PATH} --template nuxt-vue\`
+const description = `Nuxt.js（服务端 + Vue）：\`coze-dev init \${COZE_WORKSPACE_PATH} --template nuxt-vue\`
 - 适用：全栈应用、需要服务端接口能力的 Vue 项目
 - 特点：
     - **服务端能力**：内置服务端 API 路由，可直接创建后端接口

package/lib/__templates__/pi-agent/template.config.js

@@ -29,7 +29,7 @@ export const paramsSchema = {
 
 const config = {
   description:
-    'Pi Agent：`coze init ${COZE_WORKSPACE_PATH} --template pi-agent`\n' +
+    'Pi Agent：`coze-dev init ${COZE_WORKSPACE_PATH} --template pi-agent`\n' +
     '- 适用：基于 pi-agent-core 的 AI Agent 应用\n' +
     '- 支持飞书、微信等多渠道接入\n' +
     '- 内置 Dashboard 管理面板\n' +

package/lib/__templates__/taro/template.config.js

@@ -8,7 +8,7 @@
 
 
 
-const description = `Taro（小程序 + H5）：\`coze init \${COZE_WORKSPACE_PATH} --template taro\`
+const description = `Taro（小程序 + H5）：\`coze-dev init \${COZE_WORKSPACE_PATH} --template taro\`
 - 适用：微信小程序、H5 跨端应用
 - 前后端分离架构：Taro 4 + NestJS
 - 支持微信小程序和 H5 双端构建

package/lib/__templates__/templates.json

@@ -28,7 +28,7 @@
     },
     {
       "name": "native-static",
-      "description": "Native Static（纯静态）：`coze init ${COZE_WORKSPACE_PATH} --template native-static`\n- 适用：纯静态 HTML/CSS/JS 项目、静态网站\n- 使用 Python http.server 作为开发服务器\n- 不需要 Node.js 环境，适合简单静态内容",
+      "description": "Native Static（纯静态）：`coze-dev init ${COZE_WORKSPACE_PATH} --template native-static`\n- 适用：纯静态 HTML/CSS/JS 项目、静态网站\n- 使用 Python http.server 作为开发服务器\n- 不需要 Node.js 环境，适合简单静态内容",
       "location": "./native-static",
       "paramsSchema": {
         "type": "object",
@@ -39,7 +39,7 @@
     },
     {
       "name": "nextjs",
-      "description": "Next.js（复杂项目）：`coze init ${COZE_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/`目录下",
+      "description": "Next.js（复杂项目）：`coze-dev init ${COZE_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",
@@ -64,7 +64,7 @@
     },
     {
       "name": "nuxt-vue",
-      "description": "Nuxt.js（服务端 + Vue）：`coze init ${COZE_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` 理解项目配置",
+      "description": "Nuxt.js（服务端 + Vue）：`coze-dev init ${COZE_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",
@@ -96,7 +96,7 @@
     },
     {
       "name": "pi-agent",
-      "description": "Pi Agent：`coze init ${COZE_WORKSPACE_PATH} --template pi-agent`\n- 适用：基于 pi-agent-core 的 AI Agent 应用\n- 支持飞书、微信等多渠道接入\n- 内置 Dashboard 管理面板\n- 使用 TypeScript + Express + Vite",
+      "description": "Pi Agent：`coze-dev init ${COZE_WORKSPACE_PATH} --template pi-agent`\n- 适用：基于 pi-agent-core 的 AI Agent 应用\n- 支持飞书、微信等多渠道接入\n- 内置 Dashboard 管理面板\n- 使用 TypeScript + Express + Vite",
       "location": "./pi-agent",
       "paramsSchema": {
         "type": "object",
@@ -120,7 +120,7 @@
     },
     {
       "name": "taro",
-      "description": "Taro（小程序 + H5）：`coze init ${COZE_WORKSPACE_PATH} --template taro`\n- 适用：微信小程序、H5 跨端应用\n- 前后端分离架构：Taro 4 + NestJS\n- 支持微信小程序和 H5 双端构建\n- 使用 TailwindCSS + weapp-tailwindcss 实现跨端样式",
+      "description": "Taro（小程序 + H5）：`coze-dev init ${COZE_WORKSPACE_PATH} --template taro`\n- 适用：微信小程序、H5 跨端应用\n- 前后端分离架构：Taro 4 + NestJS\n- 支持微信小程序和 H5 双端构建\n- 使用 TailwindCSS + weapp-tailwindcss 实现跨端样式",
       "location": "./taro",
       "paramsSchema": {
         "type": "object",
@@ -152,7 +152,7 @@
     },
     {
       "name": "vite",
-      "description": "Vite（简单项目）：`coze init ${COZE_WORKSPACE_PATH} --template vite`\n- 适用：轻量级 SPA、纯前端交互、仪表盘等轻量级项目。",
+      "description": "Vite（简单项目）：`coze-dev init ${COZE_WORKSPACE_PATH} --template vite`\n- 适用：轻量级 SPA、纯前端交互、仪表盘等轻量级项目。",
       "location": "./vite",
       "paramsSchema": {
         "type": "object",

package/lib/__templates__/vite/README.md

@@ -13,7 +13,7 @@
 ### 启动开发服务器
 
 ```bash
-coze dev
+coze-dev dev
 ```
 
 启动后，在浏览器中打开 [http://localhost:<%= port %>](http://localhost:<%= port %>) 查看应用。
@@ -23,7 +23,7 @@ coze dev
 ### 构建生产版本
 
 ```bash
-coze build
+coze-dev build
 ```
 
 构建产物位于 `dist/` 目录，可直接部署到静态托管服务。
@@ -31,7 +31,7 @@ coze build
 ### 预览生产版本
 
 ```bash
-coze start
+coze-dev start
 ```
 
 在本地启动一个静态服务器，预览生产构建的效果。
@@ -66,15 +66,15 @@ coze start
 
 **工作原理：**
 
-- **开发模式** (`coze dev`)：
+- **开发模式** (`coze-dev dev`)：
   - 运行 `server/server.ts` 启动 Express 服务器
   - Vite 以 middleware 模式集成到 Express
   - 前端支持 HMR（热模块替换）
   - 后端 API 和前端在同一进程，端口 <%= port %>
 
-- **生产模式** (`coze start`)：
-  - `coze build` 构建前端 → `dist/` 目录
-  - `coze build` 构建后端 → `dist-server/index.js` (CommonJS 格式)
+- **生产模式** (`coze-dev start`)：
+  - `coze-dev build` 构建前端 → `dist/` 目录
+  - `coze-dev build` 构建后端 → `dist-server/index.js` (CommonJS 格式)
   - 运行 `dist-server/index.js` 启动生产服务器
   - Express 服务静态文件 + API 路由
   - 单一 Node.js 进程，轻量高效
@@ -386,7 +386,7 @@ console.log(apiUrl); // https://api.example.com
 2. **使用 TypeScript** 进行类型安全开发，避免使用 `any`
 3. **使用 Tailwind CSS** 进行样式开发，支持响应式和暗色模式
 4. **环境变量必须以 `VITE_` 开头** 才能在客户端代码中访问
-5. **开发时使用 `coze dev`**，支持热更新和快速刷新
+5. **开发时使用 `coze-dev dev`**，支持热更新和快速刷新
 6. **API 路由以 `/api` 开头**，避免与前端路由冲突
 7. **单进程架构**：开发和生产环境都是前后端在同一进程中运行
 
@@ -412,7 +412,7 @@ const pool = new Pool({ connectionString: process.env.DATABASE_URL });
 
 **Q: 如何部署？**
 
-1. 运行 `coze build` 构建前后端
+1. 运行 `coze-dev build` 构建前后端
 2. 将整个项目上传到服务器
 3. 运行 `pnpm install --prod`
-4. 运行 `coze start` 启动服务
+4. 运行 `coze-dev start` 启动服务

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

@@ -7,6 +7,6 @@ cd "${COZE_WORKSPACE_PATH}"
 
 echo "Installing dependencies..."
 pnpm install --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
-if command -v coze > /dev/null 2>&1 && coze check-bins --help > /dev/null 2>&1; then
-  coze check-bins --fix
+if command -v coze-dev > /dev/null 2>&1 && coze-dev check-bins --help > /dev/null 2>&1; then
+  coze-dev check-bins --fix
 fi

package/lib/__templates__/vite/template.config.js

@@ -40,7 +40,7 @@ export const paramsSchema = {
   additionalProperties: false,
 };
 
-const description = `Vite（简单项目）：\`coze init \${COZE_WORKSPACE_PATH} --template vite\`
+const description = `Vite（简单项目）：\`coze-dev init \${COZE_WORKSPACE_PATH} --template vite\`
 - 适用：轻量级 SPA、纯前端交互、仪表盘等轻量级项目。`;
 
 const config = {

package/lib/cli.js

@@ -125,10 +125,10 @@ const generateTemplatesHelpText = () => {
   lines.push(`\n  ${'='.repeat(76)}`);
   lines.push('\n  Usage:');
   lines.push(
-    '    coze init <directory> -t <template-name> [--param value ...]',
+    '    coze-dev init <directory> -t <template-name> [--param value ...]',
   );
   lines.push('\n  Example:');
-  lines.push('    coze init my-app -t nextjs --appName my-app --port 3000');
+  lines.push('    coze-dev init my-app -t nextjs --appName my-app --port 3000');
   lines.push('');
 
   return lines.join('\n');
@@ -2107,14 +2107,13 @@ const EventBuilder = {
 };
 
 var name = "@coze-arch/cli";
-var version = "0.0.33-alpha.eeae5b";
+var version = "0.0.34-alpha.da5090";
 var description = "coze coding devtools cli";
 var license = "MIT";
 var author = "fanwenjie.fe@bytedance.com";
 var maintainers = [
 ];
 var bin = {
-	coze: "bin/main",
 	"coze-dev": "bin/main"
 };
 var files = [
@@ -2197,7 +2196,6 @@ var publishConfig = {
 };
 var cozePublishConfig = {
 	bin: {
-		coze: "bin/main",
 		"coze-dev": "bin/main"
 	}
 };
@@ -2804,7 +2802,7 @@ const executeWarmup = async (options) => {
     }
 
     logger.success('\n✅ All templates warmed up successfully!');
-    logger.info('\nNext time you run `coze init`, it will be much faster as node_modules are pre-installed.');
+    logger.info('\nNext time you run `coze-dev init`, it will be much faster as node_modules are pre-installed.');
 
     timer.logTotal();
   } catch (error) {
@@ -8686,7 +8684,7 @@ const detectAndValidateTemplate = (cwd) => {
 
 /**
  * Scan routes once without starting polling
- * Used by the standalone `coze routes` command
+ * Used by the standalone `coze-dev routes` command
  *
  * @param cwd - Current working directory
  * @param options - Scanning options (output path, etc.)
@@ -10197,7 +10195,7 @@ const startDevServerStep = ctx => {
     if (skipCommit) {
       logger.info('  git add --all && git commit -m "chore: init env"');
     }
-    logger.info('  coze dev');
+    logger.info('  coze-dev dev');
   }
 };
 
@@ -10357,7 +10355,7 @@ const main = async () => {
   const program = new commander.Command();
 
   program
-    .name('coze')
+    .name('coze-dev')
     .description(
       'Coze Coding CLI - Project template engine for frontend stacks',
     )

package/package.json

@@ -1,13 +1,12 @@
 {
   "name": "@coze-arch/cli",
-  "version": "0.0.33-alpha.eeae5b",
+  "version": "0.0.34-alpha.da5090",
   "private": false,
   "description": "coze coding devtools cli",
   "license": "MIT",
   "author": "fanwenjie.fe@bytedance.com",
   "maintainers": [],
   "bin": {
-    "coze": "bin/main",
     "coze-dev": "bin/main"
   },
   "files": [
@@ -90,7 +89,6 @@
   },
   "cozePublishConfig": {
     "bin": {
-      "coze": "bin/main",
       "coze-dev": "bin/main"
     }
   }