@coze-arch/cli 0.0.1-alpha.f9be02 → 0.0.1-alpha.ff64d9

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

@@ -0,0 +1,9 @@
+#!/bin/bash
+set -Eeuo pipefail
+
+COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
+
+cd "${COZE_WORKSPACE_PATH}"
+
+echo "Installing dependencies..."
+pnpm install --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only

package/lib/__templates__/vite/src/main.ts

@@ -13,8 +13,7 @@ export function initApp(): void {
         <!-- 头部：Logo 和 产品名称 -->
         <div class="flex items-center gap-3">
           <img
-            class="dark:invert"
-            src="https://lf3-static.bytednsdoc.com/obj/eden-cn/hkpzboz/coze_logo.png"
+            src="https://lf-coze-web-cdn.coze.cn/obj/eden-cn/lm-lgvj/ljhwZthlaukjlkulzlp/favicon.svg"
             alt="扣子编程 Logo"
             width="40"
             height="40"

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

@@ -37,7 +37,11 @@ export const paramsSchema = {
   additionalProperties: false,
 };
 
+const description = `Vite（简单项目）：\`coze init \${COZE_WORKSPACE_PATH} --template vite\`
+- 适用：轻量级 SPA、纯前端交互、仪表盘等轻量级项目。`;
+
 const config = {
+  description: description,
   paramsSchema,
 
   defaultParams: {
@@ -55,11 +59,31 @@ const config = {
 
   onAfterRender: async (context, outputPath) => {
     console.log(`\nProject created at: ${outputPath}`);
-    console.log(`\nConfiguration:`);
-    console.log(`  - TypeScript: enabled`);
-    console.log(`  - Framework: None (Vanilla JS/TS)`);
-    console.log(`  - Build Tool: Vite`);
+    console.log('\nConfiguration:');
+    console.log('  - Framework: vite');
+    console.log('  - TypeScript: enabled');
+    console.log('  - App Router: enabled');
     console.log(`  - Port: ${context.port}`);
+
+    // Skip pnpm add in test environment to avoid monorepo workspace issues
+    if (process.env.NODE_ENV === 'test') {
+      console.log('⊘ Skipping dependency update in test environment');
+      return;
+    }
+
+    const cmd = `pnpm add coze-coding-dev-sdk@"^0.7.0"`;
+    console.log(`${cmd}`);
+    try {
+      const projectRoot = resolve(outputPath);
+      execSync(cmd, {
+        cwd: projectRoot,
+        stdio: 'inherit',
+      });
+      console.log('✓ coze-coding-dev-sdk updated successfully');
+    } catch (error) {
+      console.error('✗ Failed to update coze-coding-dev-sdk:', error);
+      throw error;
+    }
   },
 };
 

package/lib/cli.js

@@ -7,10 +7,10 @@ var fs = require('fs');
 var shelljs = require('shelljs');
 var perf_hooks = require('perf_hooks');
 var fs$1 = require('fs/promises');
+var os = require('os');
 var toml = require('@iarna/toml');
 var jsYaml = require('js-yaml');
 var child_process = require('child_process');
-var os = require('os');
 var addFormats = require('ajv-formats');
 var Ajv = require('ajv');
 var minimist = require('minimist');
@@ -826,23 +826,48 @@ const getCommandConfig = (
 function _nullishCoalesce$1(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
 /**
- * 创建日志管理器
+ * 日志文件名常量
  */
-const createLogManager = (logDir = '.coze-logs') => {
-  const ensureLogDir = () => {
-    if (!fs.existsSync(logDir)) {
-      fs.mkdirSync(logDir, { recursive: true });
-    }
-  };
+const LOG_FILE_NAME = 'dev.log';
+
+/**
+ * 获取日志目录
+ * 优先使用环境变量 COZE_LOG_DIR，否则使用 ~/.coze-logs
+ */
+const getLogDir = () =>
+  process.env.COZE_LOG_DIR || path.join(os.homedir(), '.coze-logs');
 
-  const getLogPath = (logFile) => path.join(logDir, logFile);
+/**
+ * 解析日志文件路径
+ * - 如果是绝对路径，直接使用
+ * - 如果是相对路径，基于 getLogDir() + 相对路径
+ * - 如果为空，使用 getLogDir() + LOG_FILE_NAME
+ */
+const resolveLogFilePath = (logFile) => {
+  if (!logFile) {
+    return path.join(getLogDir(), LOG_FILE_NAME);
+  }
 
-  return {
-    createWriteStream: (logFile) => {
-      ensureLogDir();
-      return fs.createWriteStream(getLogPath(logFile), { flags: 'a' });
-    },
-  };
+  if (path.isAbsolute(logFile)) {
+    return logFile;
+  }
+
+  return path.join(getLogDir(), logFile);
+};
+
+/**
+ * 创建日志写入流
+ */
+const createLogStream = (logFilePath) => {
+  const logDir = path.dirname(logFilePath);
+
+  // 确保日志目录存在
+  if (!fs.existsSync(logDir)) {
+    fs.mkdirSync(logDir, { recursive: true });
+  }
+
+  // 使用 'w' 标志覆盖之前的日志
+  return fs.createWriteStream(logFilePath, { flags: 'w' });
 };
 
 /**
@@ -860,16 +885,15 @@ const executeRun = async (
     const commandArgs = getCommandConfig(config, commandName);
 
     // 2. 准备日志
-    const logManager = createLogManager();
-    const logFile = options.logFile || `${commandName}.log`;
-    const logStream = logManager.createWriteStream(logFile);
+    const logFilePath = resolveLogFilePath(options.logFile);
+    const logStream = createLogStream(logFilePath);
 
     // 3. 执行命令
     const commandString = commandArgs.join(' ');
 
     logger.info(`Executing: ${commandString}`);
     logger.info(`Working directory: ${process.cwd()}`);
-    logger.info(`Log file: ${logFile}`);
+    logger.info(`Log file: ${logFilePath}`);
 
     const childProcess = shelljs.exec(commandString, {
       async: true,
@@ -898,11 +922,11 @@ const executeRun = async (
         logger.error(
           `Command exited with code ${_nullishCoalesce$1(code, () => ( 'unknown'))}${signal ? ` and signal ${signal}` : ''}`,
         );
-        logger.error(`Check log file for details: ${logFile}`);
+        logger.error(`Check log file for details: ${logFilePath}`);
         process.exit(code || 1);
       } else {
         logger.success('Command completed successfully');
-        logger.info(`Log file: ${logFile}`);
+        logger.info(`Log file: ${logFilePath}`);
       }
     });
 
@@ -1248,17 +1272,139 @@ const convertDotfileName = (filePath) => {
 };
 
 /**
- * 复制并处理模板文件到目标目录
+ * 执行文件渲染钩子
  *
- * @param templatePath - 模板目录路径
- * @param outputPath - 输出目录路径
+ * @param templateConfig - 模板配置
+ * @param fileInfo - 文件渲染信息
  * @param context - 模板上下文
+ * @returns 处理后的文件信息，或 null 表示跳过该文件
  */
-const processTemplateFiles = async (
-  templatePath,
-  outputPath,
+const executeFileRenderHook = async (
+  templateConfig,
+  fileInfo,
   context,
 ) => {
+  if (!templateConfig.onFileRender) {
+    return fileInfo;
+  }
+
+  const result = await templateConfig.onFileRender(
+    fileInfo,
+    context,
+  );
+
+  // false: 跳过文件
+  if (result === false) {
+    return null;
+  }
+
+  // undefined/void: 使用默认内容
+  if (result === undefined || result === null) {
+    return fileInfo;
+  }
+
+  // string: 作为 content，其他不变
+  if (typeof result === 'string') {
+    return {
+      ...fileInfo,
+      content: result,
+    };
+  }
+
+  // FileRenderInfo: 使用新对象的信息
+  return result;
+};
+
+/**
+ * 处理单个文件
+ */
+const processSingleFile = async (options
+
+
+
+
+
+) => {
+  const { file, templatePath, outputPath, context, templateConfig } = options;
+
+  const srcPath = path.join(templatePath, file);
+  const destFile = convertDotfileName(file);
+
+  logger.verbose(
+    `  - Processing: ${file}${destFile !== file ? ` -> ${destFile}` : ''}`,
+  );
+
+  // 判断是否为二进制文件
+  const isBinary = !shouldRenderFile(srcPath);
+  let content;
+  let wasRendered = false;
+
+  if (isBinary) {
+    // 二进制文件，读取为 buffer 然后转为 base64
+    const buffer = await fs$1.readFile(srcPath);
+    content = buffer.toString('base64');
+  } else {
+    // 文本文件，渲染后的内容
+    content = await renderTemplate(srcPath, context);
+    wasRendered = true;
+  }
+
+  // 构造文件信息对象
+  const fileInfo = {
+    path: file,
+    destPath: destFile,
+    content,
+    isBinary,
+    wasRendered,
+  };
+
+  // 执行文件渲染钩子
+  const processedFileInfo = await executeFileRenderHook(
+    templateConfig,
+    fileInfo,
+    context,
+  );
+
+  // 如果返回 null，跳过该文件
+  if (processedFileInfo === null) {
+    logger.verbose('    ⊘ Skipped by onFileRender hook');
+    return;
+  }
+
+  // 使用处理后的目标路径
+  const finalDestPath = path.join(outputPath, processedFileInfo.destPath);
+
+  // 确保目标目录存在
+  await ensureDir(path.dirname(finalDestPath));
+
+  // 写入文件
+  if (processedFileInfo.isBinary) {
+    // 二进制文件：如果内容没变，直接复制；否则从 base64 解码写入
+    if (processedFileInfo.content === content) {
+      await fs$1.copyFile(srcPath, finalDestPath);
+      logger.verbose('    ✓ Copied (binary)');
+    } else {
+      const buffer = Buffer.from(processedFileInfo.content, 'base64');
+      await fs$1.writeFile(finalDestPath, buffer);
+      logger.verbose('    ✓ Written (binary, modified by hook)');
+    }
+  } else {
+    // 文本文件
+    await fs$1.writeFile(finalDestPath, processedFileInfo.content, 'utf-8');
+    logger.verbose('    ✓ Rendered and written');
+  }
+};
+
+/**
+ * 复制并处理模板文件到目标目录
+ */
+const processTemplateFiles = async (options
+
+
+
+
+) => {
+  const { templatePath, outputPath, context, templateConfig } = options;
   logger.verbose('Processing template files:');
   logger.verbose(`  - Template path: ${templatePath}`);
   logger.verbose(`  - Output path: ${outputPath}`);
@@ -1289,29 +1435,15 @@ const processTemplateFiles = async (
   }
 
   await Promise.all(
-    files.map(async file => {
-      const srcPath = path.join(templatePath, file);
-      const destFile = convertDotfileName(file);
-      const destPath = path.join(outputPath, destFile);
-
-      logger.verbose(
-        `  - Processing: ${file}${destFile !== file ? ` -> ${destFile}` : ''}`,
-      );
-
-      // 确保目标目录存在
-      await ensureDir(path.dirname(destPath));
-
-      if (shouldRenderFile(srcPath)) {
-        // 渲染文本文件
-        const rendered = await renderTemplate(srcPath, context);
-        await fs$1.writeFile(destPath, rendered, 'utf-8');
-        logger.verbose('    ✓ Rendered and written');
-      } else {
-        // 直接复制二进制文件
-        await fs$1.copyFile(srcPath, destPath);
-        logger.verbose('    ✓ Copied');
-      }
-    }),
+    files.map(file =>
+      processSingleFile({
+        file,
+        templatePath,
+        outputPath,
+        context,
+        templateConfig,
+      }),
+    ),
   );
 
   logger.verbose('✓ All files processed successfully');
@@ -1498,7 +1630,12 @@ const execute = async (
   const absoluteOutputPath = await prepareOutputDirectory(outputPath);
 
   // 6. 处理模板文件
-  await processTemplateFiles(templatePath, absoluteOutputPath, context);
+  await processTemplateFiles({
+    templatePath,
+    outputPath: absoluteOutputPath,
+    context,
+    templateConfig,
+  });
 
   // 7. 执行 onAfterRender 钩子
   await executeAfterRenderHook(templateConfig, context, absoluteOutputPath);
@@ -1611,13 +1748,20 @@ const runGitInit = (projectPath) => {
 /**
  * 运行开发服务器(后台模式)
  * 启动后台子进程运行开发服务器，父进程可以直接退出
+ * 使用 CLI 自己的 dev 命令(定义在 run.ts)而不是直接运行 npm run dev
  */
-const runNpmDev = (projectPath) => {
+const runDev = (projectPath) => {
   logger.info('\nStarting development server in background...');
-  logger.info(`Executing: npm run dev in ${projectPath}`);
+
+  // 获取当前 CLI 的可执行文件路径
+  // process.argv[0] 是 node，process.argv[1] 是 CLI 入口文件
+  const cliPath = process.argv[1];
+
+  logger.info(`Executing: ${cliPath} dev in ${projectPath}`);
 
   // 使用通用的后台执行函数启动开发服务器
-  const pid = spawnDetached('npm', ['run', 'dev'], {
+  // 调用 CLI 自己的 dev 命令
+  const pid = spawnDetached(process.argv[0], [cliPath, 'dev'], {
     cwd: projectPath,
     verbose: false, // 不输出额外的进程信息，由 logger 统一处理
   });
@@ -1693,7 +1837,7 @@ const executeInit = async (
 
     // 如果没有跳过 dev，则启动开发服务器
     if (!skipDev) {
-      runNpmDev(absoluteOutputPath);
+      runDev(absoluteOutputPath);
       timer.logPhase('Dev server startup');
     } else {
       // 只有跳过 dev 时才显示 Next steps
@@ -1707,7 +1851,7 @@ const executeInit = async (
           '  git init && git add . && git commit -m "initial commit"',
         );
       }
-      logger.info('  npm run dev');
+      logger.info('  coze dev');
     }
 
     // 输出总耗时
@@ -1741,7 +1885,7 @@ const registerCommand = program => {
     });
 };
 
-var version = "0.0.1-alpha.f9be02";
+var version = "0.0.1-alpha.ff64d9";
 var packageJson = {
 	version: version};
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coze-arch/cli",
-  "version": "0.0.1-alpha.f9be02",
+  "version": "0.0.1-alpha.ff64d9",
   "private": false,
   "description": "coze coding devtools cli",
   "license": "MIT",
@@ -25,14 +25,13 @@
     "test": "vitest --run --passWithNoTests",
     "test:all": "bash scripts/test-coverage.sh",
     "test:cov": "vitest --run --passWithNoTests --coverage",
-    "test:e2e": "bash scripts/e2e.sh",
+    "test:e2e": "NODE_ENV=test bash scripts/e2e.sh",
     "test:perf": "vitest bench --run --config vitest.perf.config.ts",
     "test:perf:compare": "bash scripts/compare-perf.sh",
     "test:perf:save": "bash scripts/run-perf-with-output.sh"
   },
   "dependencies": {
     "@iarna/toml": "^2.2.5",
-    "@inquirer/prompts": "^3.2.0",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "change-case": "^5.4.4",
@@ -50,14 +49,17 @@
     "@coze-arch/ts-config": "workspace:*",
     "@coze-arch/vitest-config": "workspace:*",
     "@coze-coding/lambda": "workspace:*",
+    "@inquirer/prompts": "^3.2.0",
     "@types/ejs": "^3.1.5",
     "@types/iarna__toml": "^2.0.5",
     "@types/js-yaml": "^4.0.9",
+    "@types/minimatch": "^5.1.2",
     "@types/minimist": "^1.2.5",
     "@types/node": "^24",
     "@types/shelljs": "^0.10.0",
     "@vitest/coverage-v8": "~4.0.16",
     "json-schema-to-typescript": "^15.0.3",
+    "minimatch": "^10.0.1",
     "rollup": "^4.41.1",
     "sucrase": "^3.35.0",
     "tsx": "^4.20.6",

package/lib/__templates__/expo/client/src/app/_layout.tsx

@@ -1,33 +0,0 @@
-import { useEffect } from 'react';
-import { GestureHandlerRootView } from 'react-native-gesture-handler';
-import { Stack } from 'expo-router';
-import { StatusBar } from 'expo-status-bar';
-import { LogBox } from 'react-native';
-import Toast from 'react-native-toast-message';
-import { AuthProvider } from "@/contexts/AuthContext";
-
-LogBox.ignoreLogs([
-  "TurboModuleRegistry.getEnforcing(...): 'RNMapsAirModule' could not be found",
-  // 添加其它想暂时忽略的错误或警告信息
-]);
-
-export default function RootLayout() {
-  return (
-    <AuthProvider>
-        <GestureHandlerRootView style={{ flex: 1 }}>
-            <StatusBar style="dark"></StatusBar>
-            <Stack screenOptions={{
-                // 设置所有页面的切换动画为从右侧滑入，适用于iOS 和 Android
-                animation: 'slide_from_right',
-                gestureEnabled: true,
-                gestureDirection: 'horizontal',
-                // 隐藏自带的头部
-                headerShown: false
-            }}>
-              <Stack.Screen name="(tabs)" options={{ title: "" }} />
-            </Stack>
-            <Toast />
-        </GestureHandlerRootView>
-    </AuthProvider>
-  );
-}

package/lib/__templates__/expo/client/src/app/index.ts

@@ -1 +0,0 @@
-export { default } from '@/screens/home'

package/lib/__templates__/expo/client/src/hooks/useColorScheme.ts

@@ -1 +0,0 @@
-export { useColorScheme } from "react-native";

package/lib/__templates__/expo/client/src/screens/home/index.tsx

@@ -1,50 +0,0 @@
-import React, { useState, useCallback } from 'react';
-import {
-  View,
-  Text,
-  ScrollView,
-  RefreshControl,
-} from 'react-native';
-import { useRouter, useFocusEffect } from 'expo-router';
-import { FontAwesome6 } from '@expo/vector-icons';
-import { useSafeAreaInsets } from 'react-native-safe-area-context';
-import { useTheme } from "@/hooks/useTheme";
-
-import { Screen } from '@/components/Screen';
-
-import { styles } from './styles';
-
-export default function HomeScreen() {
-  const insets = useSafeAreaInsets();
-  const { theme, isDark } = useTheme();
-
-  const [isRefreshing, setIsRefreshing] = useState(false);
-
-  const loadData = useCallback(async () => {
-  }, []);
-
-  useFocusEffect(
-    useCallback(() => {
-      loadData();
-    }, [loadData])
-  );
-
-  const handleRefresh = useCallback(() => {
-    setIsRefreshing(true);
-    loadData();
-  }, [loadData]);
-  return (
-    <Screen backgroundColor={theme.backgroundRoot} statusBarStyle={isDark ? 'light' : 'dark'}>
-      <ScrollView
-        showsVerticalScrollIndicator={false}
-        contentContainerStyle={{}}
-        refreshControl={
-          <RefreshControl refreshing={isRefreshing} onRefresh={handleRefresh} colors={['#2563EB']} />
-        }
-      >
-        <View style={[styles.header]}>
-        </View>
-      </ScrollView>
-    </Screen>
-  );
-}

package/lib/__templates__/expo/client/src/screens/home/styles.ts

@@ -1,60 +0,0 @@
-import { StyleSheet, Platform } from 'react-native';
-
-export const styles = StyleSheet.create({
-  loadingContainer: {
-    flex: 1,
-    justifyContent: 'center',
-    alignItems: 'center',
-  },
-  loadingText: {
-    marginTop: 12,
-    fontSize: 14,
-    color: '#64748B',
-  },
-  errorContainer: {
-    flex: 1,
-    justifyContent: 'center',
-    alignItems: 'center',
-    paddingHorizontal: 24,
-  },
-  errorText: {
-    marginTop: 16,
-    fontSize: 16,
-    color: '#64748B',
-  },
-  header: {
-    flexDirection: 'row',
-    justifyContent: 'space-between',
-    alignItems: 'center',
-    paddingHorizontal: 16,
-    // paddingBottom: 16,
-    backgroundColor: '#FFFFFF',
-    // borderBottomWidth: 1,
-    borderBottomColor: '#E2E8F0',
-  },
-  logoContainer: {
-    width: 32,
-    height: 32,
-    backgroundColor: '#2563EB',
-    borderRadius: 8,
-    justifyContent: 'center',
-    alignItems: 'center',
-    ...Platform.select({
-      ios: {
-        shadowColor: '#000',
-        shadowOffset: { width: 0, height: 1 },
-        shadowOpacity: 0.1,
-        shadowRadius: 2,
-      },
-      android: {
-        elevation: 2,
-      },
-    }),
-  },
-  logoText: {
-    fontSize: 18,
-    fontWeight: '700',
-    color: '#1E293B',
-    letterSpacing: -0.5,
-  },
-});