@ysjdemo/umi-create-cli 0.0.1 → 0.0.3

package/README.md

@@ -1,117 +1,94 @@
-# @cfmm/umi-create-cli
+# @ysjdemo/umi-create-cli
 
-一个用于快速创建 Umi 4 项目的脚手架工具。
+一个用于创建Umi4项目的脚手架工具
 
-## ✨ 特性
+## 使用方式（推荐npx）
 
-- 🚀 快速创建 Umi 4 项目
-- 🎨 提供多种项目模板
-- 📦 自动配置常用依赖和配置
-- 💻 支持 TypeScript
-- 🔧 预配置 ESLint 和 Prettier
-
-## 📦 安装
-
-### 全局安装
 ```bash
-npm install -g @cfmm/umi-create-cli
-```
+# 🔥 推荐：使用 npx 直接创建（无需安装）
+# 会自动提示选择模板，默认推荐 Ant Design Pro
+npx @ysjdemo/umi-create-cli create my-project
 
-### 或使用 npx（推荐）
-```bash
-npx @cfmm/umi-create-cli create my-project
+# 或直接指定模板
+npx @ysjdemo/umi-create-cli create my-project -t antd
+npx @ysjdemo/umi-create-cli create my-project -t basic
+
+# 查看帮助
+npx @ysjdemo/umi-create-cli --help
 ```
 
-## 🚀 使用
+## 交互式模板选择
 
-### 创建新项目
-```bash
-# 使用默认模板（basic）
-ysj-umi create my-project
+当您运行创建命令时，会看到如下交互界面：
 
-# 指定模板类型
-ysj-umi create my-project -t antd
+```
+🚀 创建 Umi4 项目...
+📋 请选择项目模板:
+❯ 🎨 antd - Ant Design Pro 模板 (推荐)
+  📦 basic - 基础模板
 ```
 
-### 在当前目录初始化
-```bash
-# 在当前目录初始化项目
-ysj-umi init
+## 安装方式（可选）
 
-# 指定模板类型
-ysj-umi init -t antd
-```
+如果需要频繁使用，可以选择全局安装：
 
-### 查看帮助
 ```bash
-ysj-umi --help
-```
+# 全局安装
+npm install -g @ysjdemo/umi-create-cli
 
-## 📋 可用模板
+# 或使用 yarn
+yarn global add @ysjdemo/umi-create-cli
 
-### 1. basic - 基础模板
-- ✅ Umi 4 基础配置
-- ✅ React 18 + TypeScript
-- ✅ 基础路由配置
-- ✅ 简单的页面示例
+# 安装后使用
+ysj-umi create my-project
+ysj-umi --version
+```
 
-### 2. antd - Ant Design Pro 模板
-- ✅ 基于 Ant Design 5.0
-- ✅ Pro Components 组件库
-- ✅ 完整的后台管理界面
-- ✅ 仪表盘、用户管理、设置页面
-- ✅ 表格、表单等常用功能
+## 特性
 
-## 📁 项目结构
+- 🚀 快速创建Umi4项目
+- 📦 内置常用配置模板
+- 🎨 支持TypeScript
+- 📱 支持多种UI库选择
+- ⚡️ 支持npx直接使用，无需安装
+- 🎯 交互式模板选择，默认推荐最佳实践
 
-创建的项目具有以下目录结构：
+## 模板选项
 
-```
-my-project/
-├── src/
-│   ├── components/     # 通用组件
-│   ├── pages/         # 页面组件
-│   ├── services/      # API 服务
-│   └── utils/         # 工具函数
-├── .umirc.ts          # Umi 配置文件
-├── .gitignore         # Git 忽略文件
-├── .prettierrc        # Prettier 配置
-├── tsconfig.json      # TypeScript 配置
-├── package.json       # 项目依赖
-└── README.md          # 项目说明
-```
+- **🎨 Ant Design Pro 模板**（推荐）：企业级后台管理系统
+  ```bash
+  npx @ysjdemo/umi-create-cli create my-admin -t antd
+  ```
+  - 集成 Ant Design 5.0
+  - Pro Components 组件库
+  - 完整的后台管理界面
+  - 仪表盘、用户管理、设置页面
 
-## 🛠️ 开发流程
+- **📦 基础模板**：轻量级起始项目
+  ```bash
+  npx @ysjdemo/umi-create-cli create my-project -t basic
+  ```
+  - 基础 Umi 4 配置
+  - TypeScript 支持
+  - 简洁的项目结构
 
-创建项目后，进入项目目录并安装依赖：
+## 开发
 
 ```bash
-cd my-project
-npm install
-```
+# 克隆项目
+git clone https://github.com/Ivan-YangSj/umi-cli.git
 
-启动开发服务器：
+# 安装依赖
+npm install
 
-```bash
+# 本地开发测试
 npm start
-```
 
-构建生产版本：
-
-```bash
-npm run build
+# 发布新版本
+npm version patch
+git push origin --tags
 ```
 
-## 📖 相关文档
-
-- [Umi 4 官方文档](https://umijs.org/)
-- [Ant Design 文档](https://ant.design/)
-- [Pro Components 文档](https://procomponents.ant.design/)
-
-## 🤝 贡献
-
-欢迎提交 Issue 和 Pull Request！
-
-## 📄 许可证
+## License
 
-[MIT](LICENSE) 
+MIT 

package/bin/cli.js

@@ -12,7 +12,7 @@ program
 program
   .command('create <project-name>')
   .description('创建一个新的 Umi4 项目')
-  .option('-t, --template <template>', '使用指定模板 (basic, antd)', 'basic')
+  .option('-t, --template <template>', '使用指定模板 (basic, antd, qiankun)')
   .action(async (projectName, options) => {
     try {
       await createProject(projectName, options);
@@ -26,7 +26,7 @@ program
 program
   .command('init')
   .description('在当前目录初始化 Umi4 项目')
-  .option('-t, --template <template>', '使用指定模板 (basic, antd)', 'basic')
+  .option('-t, --template <template>', '使用指定模板 (basic, antd, qiankun)')
   .action(async (options) => {
     try {
       await initProject(options);

package/lib/create.js

@@ -1,146 +1,171 @@
-const fs = require('fs-extra');
-const path = require('path');
-const inquirer = require('inquirer');
-const chalk = require('chalk');
-const ora = require('ora');
-const { generateTemplate, getAvailableTemplates } = require('./templates');
+const fs = require("fs-extra");
+const path = require("path");
+const inquirer = require("inquirer");
+const chalk = require("chalk");
+const ora = require("ora");
+const { generateTemplate, getAvailableTemplates } = require("./templates");
+
+// 默认选择的模板
+const BASE_TEMPLATE = "qiankun";
+
+const templateChoices = [
+  {
+    name: `🏗️  qiankun + antd + umi - 微前端模板 ${chalk.cyan("(推荐)")}`,
+    value: "qiankun",
+    short: "qiankun",
+  },
+  {
+    name: `🎨 antd + umi - Ant Design Pro 模板`,
+    value: "antd",
+    short: "antd",
+  },
+  {
+    name: `📦 umi - 基础模板`,
+    value: "umi",
+    short: "umi",
+  },
+];
 
 async function createProject(projectName, options) {
-  const { template = 'basic' } = options;
-  
+  const { template } = options;
+
   console.log(`🚀 创建 Umi4 项目...`);
-  
+
   // 获取可用模板列表
   const availableTemplates = await getAvailableTemplates();
-  
-  // 如果指定的模板不存在，让用户选择
+
   let selectedTemplate = template;
-  if (!availableTemplates.includes(template)) {
-    console.log(chalk.yellow(`⚠️  模板 "${template}" 不存在`));
-    console.log(chalk.blue(`📋 可用模板: ${availableTemplates.join(', ')}`));
-    
+
+  // 如果没有指定模板，或者指定的模板不存在，让用户选择
+  if (!template || !availableTemplates.includes(template)) {
+    if (template && !availableTemplates.includes(template)) {
+      console.log(chalk.yellow(`⚠️  模板 "${template}" 不存在`));
+    }
+
+    console.log(chalk.blue(`📋 请选择项目模板:`));
+
     const { chosenTemplate } = await inquirer.prompt([
       {
-        type: 'list',
-        name: 'chosenTemplate',
-        message: '请选择要使用的模板:',
-        choices: availableTemplates.map(t => ({
-          name: t === 'basic' ? `${t} (基础模板)` : 
-                t === 'antd' ? `${t} (Ant Design Pro)` : t,
-          value: t
-        }))
-      }
+        type: "list",
+        name: "chosenTemplate",
+        message: "选择项目模板:",
+        choices: templateChoices,
+        default: BASE_TEMPLATE, // 默认选择antd
+      },
     ]);
     selectedTemplate = chosenTemplate;
   }
-  
+
+  console.log(chalk.cyan(`📋 使用模板: ${selectedTemplate}`));
+
   const targetDir = path.resolve(projectName);
-  
+
   // 检查目录是否已存在
   if (await fs.pathExists(targetDir)) {
     const { overwrite } = await inquirer.prompt([
       {
-        type: 'confirm',
-        name: 'overwrite',
+        type: "confirm",
+        name: "overwrite",
         message: `目录 ${projectName} 已存在，是否覆盖？`,
-        default: false
-      }
+        default: false,
+      },
     ]);
-    
+
     if (!overwrite) {
-      console.log(chalk.red('❌ 项目创建取消'));
+      console.log(chalk.red("❌ 项目创建取消"));
       return;
     }
-    
+
     await fs.remove(targetDir);
   }
-  
-  const spinner = ora('正在创建项目...').start();
-  
+
+  const spinner = ora("正在创建项目...").start();
+
   try {
     // 生成项目文件
     await generateTemplate(projectName, selectedTemplate, targetDir);
-    
-    spinner.succeed('项目文件生成完成');
-    
-    console.log(chalk.green('✅ 项目创建成功！'));
-    console.log('');
+
+    spinner.succeed("项目文件生成完成");
+
+    console.log(chalk.green("✅ 项目创建成功！"));
+    console.log("");
     console.log(chalk.cyan(`📁 进入项目目录: cd ${projectName}`));
-    console.log(chalk.cyan('📦 安装依赖: npm install 或 yarn'));
-    console.log(chalk.cyan('🚀 启动项目: npm start 或 yarn start'));
-    
+    console.log(chalk.cyan("📦 安装依赖: npm install 或 yarn"));
+    console.log(chalk.cyan("🚀 启动项目: npm start 或 yarn start"));
   } catch (error) {
-    spinner.fail('项目创建失败');
+    spinner.fail("项目创建失败");
     console.error(chalk.red(error.message));
     process.exit(1);
   }
 }
 
 async function initProject(options) {
-  const { template = 'basic' } = options;
+  const { template } = options;
   const projectName = path.basename(process.cwd());
-  
+
   console.log(`🚀 初始化 Umi4 项目...`);
-  
+
   // 获取可用模板列表
   const availableTemplates = await getAvailableTemplates();
-  
-  // 如果指定的模板不存在，让用户选择
+
   let selectedTemplate = template;
-  if (!availableTemplates.includes(template)) {
-    console.log(chalk.yellow(`⚠️  模板 "${template}" 不存在`));
-    console.log(chalk.blue(`📋 可用模板: ${availableTemplates.join(', ')}`));
-    
+
+  // 如果没有指定模板，或者指定的模板不存在，让用户选择
+  if (!template || !availableTemplates.includes(template)) {
+    if (template && !availableTemplates.includes(template)) {
+      console.log(chalk.yellow(`⚠️  模板 "${template}" 不存在`));
+    }
+
+    console.log(chalk.blue(`📋 请选择项目模板:`));
+
     const { chosenTemplate } = await inquirer.prompt([
       {
-        type: 'list',
-        name: 'chosenTemplate',
-        message: '请选择要使用的模板:',
-        choices: availableTemplates.map(t => ({
-          name: t === 'basic' ? `${t} (基础模板)` : 
-                t === 'antd' ? `${t} (Ant Design Pro)` : t,
-          value: t
-        }))
-      }
+        type: "list",
+        name: "chosenTemplate",
+        message: "选择项目模板:",
+        choices: templateChoices,
+        default: BASE_TEMPLATE, // 默认选择antd
+      },
     ]);
     selectedTemplate = chosenTemplate;
   }
-  
+
+  console.log(chalk.cyan(`📋 使用模板: ${selectedTemplate}`));
+
   const targetDir = process.cwd();
-  
+
   // 检查当前目录是否为空
   const files = await fs.readdir(targetDir);
   if (files.length > 0) {
     const { proceed } = await inquirer.prompt([
       {
-        type: 'confirm',
-        name: 'proceed',
-        message: '当前目录不为空，是否继续？',
-        default: false
-      }
+        type: "confirm",
+        name: "proceed",
+        message: "当前目录不为空，是否继续？",
+        default: false,
+      },
     ]);
-    
+
     if (!proceed) {
-      console.log(chalk.red('❌ 项目初始化取消'));
+      console.log(chalk.red("❌ 项目初始化取消"));
       return;
     }
   }
-  
-  const spinner = ora('正在初始化项目...').start();
-  
+
+  const spinner = ora("正在初始化项目...").start();
+
   try {
     // 生成项目文件
     await generateTemplate(projectName, selectedTemplate, targetDir);
-    
-    spinner.succeed('项目文件生成完成');
-    
-    console.log(chalk.green('✅ 项目初始化成功！'));
-    console.log('');
-    console.log(chalk.cyan('📦 安装依赖: npm install 或 yarn'));
-    console.log(chalk.cyan('🚀 启动项目: npm start 或 yarn start'));
-    
+
+    spinner.succeed("项目文件生成完成");
+
+    console.log(chalk.green("✅ 项目初始化成功！"));
+    console.log("");
+    console.log(chalk.cyan("📦 安装依赖: npm install 或 yarn"));
+    console.log(chalk.cyan("🚀 启动项目: npm start 或 yarn start"));
   } catch (error) {
-    spinner.fail('项目初始化失败');
+    spinner.fail("项目初始化失败");
     console.error(chalk.red(error.message));
     process.exit(1);
   }
@@ -148,5 +173,5 @@ async function initProject(options) {
 
 module.exports = {
   createProject,
-  initProject
-}; 
+  initProject,
+};

package/lib/templates/antd/README.md

@@ -1,65 +1,49 @@
-# {{projectName}}
+# Umi 4 + Ant Design Pro 项目
 
-这是一个使用 cfmm-cli-umi 脚手架创建的 Umi 4 + Ant Design Pro 项目。
-
-## 特性
-
-- 🚀 基于 Umi 4 和 Ant Design 5
-- 📦 开箱即用的 Pro Components
-- 🎨 美观的管理后台界面
-- 📱 响应式设计
-- 🔐 内置权限管理
-- 📈 丰富的图表组件
+这是一个使用 @ysjdemo/umi-create-cli 脚手架创建的 Umi 4 + Ant Design Pro 项目。
 
 ## 开始使用
 
-### 安装依赖
-
 ```bash
+# 安装依赖
 npm install
-# 或
-yarn
-```
 
-### 启动开发服务器
-
-```bash
+# 启动开发服务器
 npm start
-# 或
-yarn start
-```
-
-### 构建生产版本
 
-```bash
+# 构建生产版本
 npm run build
-# 或
-yarn build
 ```
 
-## 项目结构
+## 功能特性
 
-```
-├── src/
-│   ├── components/     # 通用组件
-│   ├── pages/         # 页面组件
-│   │   ├── Dashboard/ # 仪表盘
-│   │   ├── Users/     # 用户管理
-│   │   └── Settings/  # 系统设置
-│   ├── services/      # API 服务
-│   └── utils/         # 工具函数
-├── .umirc.ts          # Umi 配置文件
-└── package.json
-```
+- ⚡️ Umi 4 - 现代化的前端框架
+- 🎨 Ant Design 5.0 - 企业级 UI 设计语言
+- 📦 Pro Components - 丰富的业务组件
+- 🛡️ TypeScript - 静态类型检查
+- 📱 响应式设计 - 适配不同终端
+
+## 已集成功能
 
-## 页面说明
+- 📊 仪表盘页面
+- 👥 用户管理
+- 📋 表格列表
+- 📝 表单页面
+- ⚙️ 设置页面
 
-- **仪表盘**: 数据统计展示
-- **用户管理**: 用户列表和管理
-- **系统设置**: 应用配置管理
+## 目录结构
+
+```
+src/
+├── components/     # 业务组件
+├── pages/         # 页面组件
+├── services/      # API 服务
+├── utils/         # 工具函数
+└── models/        # 数据模型
+```
 
-## 更多信息
+## 了解更多
 
-- [Umi 4 文档](https://umijs.org/)
+- [Umi 官方文档](https://umijs.org/)
 - [Ant Design 文档](https://ant.design/)
 - [Pro Components 文档](https://procomponents.ant.design/) 

package/lib/templates/antd/package.json

@@ -1,7 +1,8 @@
 {
-  "name": "{{projectName}}",
+  "name": "my-umi-antd-project",
   "private": true,
-  "author": "cfmm-cli-umi",
+  "author": "@ysjdemo/umi-create-cli",
+  "version": "1.0.0",
   "scripts": {
     "build": "umi build",
     "dev": "umi dev",

package/lib/templates/basic/README.md

@@ -1,46 +1,38 @@
-# {{projectName}}
+# Umi 4 项目
 
-这是一个使用 cfmm-cli-umi 脚手架创建的 Umi 4 项目。
+这是一个使用 @ysjdemo/umi-create-cli 脚手架创建的 Umi 4 项目。
 
 ## 开始使用
 
-### 安装依赖
-
 ```bash
+# 安装依赖
 npm install
-# 或
-yarn
-```
-
-### 启动开发服务器
 
-```bash
+# 启动开发服务器
 npm start
-# 或
-yarn start
-```
 
-### 构建生产版本
-
-```bash
+# 构建生产版本
 npm run build
-# 或
-yarn build
 ```
 
-## 项目结构
+## 功能特性
+
+- ⚡️ Umi 4 - 现代化的前端框架
+- 📦 开箱即用的配置
+- 🎨 TypeScript 支持
+- 📱 响应式设计
+
+## 目录结构
 
 ```
-├── src/
-│   ├── components/     # 通用组件
-│   ├── pages/         # 页面组件
-│   ├── services/      # API 服务
-│   └── utils/         # 工具函数
-├── .umirc.ts          # Umi 配置文件
-└── package.json
+src/
+├── components/     # 组件目录
+├── pages/         # 页面目录
+├── services/      # 服务层
+└── utils/         # 工具函数
 ```
 
-## 更多信息
+## 了解更多
 
-- [Umi 4 文档](https://umijs.org/)
-- [Ant Design 文档](https://ant.design/) 
+- [Umi 官方文档](https://umijs.org/)
+- [React 官方文档](https://reactjs.org/) 

package/lib/templates/basic/package.json

@@ -1,7 +1,8 @@
 {
-  "name": "{{projectName}}",
+  "name": "my-umi-project",
   "private": true,
-  "author": "cfmm-cli-umi",
+  "author": "@ysjdemo/umi-create-cli",
+  "version": "1.0.0",
   "scripts": {
     "build": "umi build",
     "dev": "umi dev",

package/lib/templates/basic/src/pages/Home/index.tsx

@@ -1,22 +1,38 @@
-import { PageContainer } from '@ant-design/pro-components';
-import { Card, Typography } from 'antd';
 import React from 'react';
-
-const { Title, Paragraph } = Typography;
+import styles from './index.less';
 
 const HomePage: React.FC = () => {
   return (
-    <PageContainer>
-      <Card>
-        <Title level={2}>欢迎使用 Umi 4！</Title>
-        <Paragraph>
-          这是一个使用 cfmm-cli-umi 脚手架创建的基础 Umi 4 项目。
-        </Paragraph>
-        <Paragraph>
-          你可以开始编辑 <code>src/pages/Home/index.tsx</code> 来开发你的应用。
-        </Paragraph>
-      </Card>
-    </PageContainer>
+    <div className={styles.container}>
+      <h1 className={styles.title}>
+        欢迎使用 Umi 4 项目
+      </h1>
+      <p className={styles.description}>
+        这是一个使用 @ysjdemo/umi-create-cli 脚手架创建的基础 Umi 4 项目。
+      </p>
+      <div className={styles.features}>
+        <div className={styles.feature}>
+          <h3>🚀 现代化</h3>
+          <p>基于最新的 Umi 4 框架构建</p>
+        </div>
+        <div className={styles.feature}>
+          <h3>📦 开箱即用</h3>
+          <p>预配置了常用的开发工具</p>
+        </div>
+        <div className={styles.feature}>
+          <h3>🎨 TypeScript</h3>
+          <p>完整的 TypeScript 支持</p>
+        </div>
+      </div>
+      <div className={styles.actions}>
+        <a href="https://umijs.org/" target="_blank" rel="noopener noreferrer">
+          查看 Umi 文档
+        </a>
+        <a href="https://github.com/Ivan-YangSj/umi-cli" target="_blank" rel="noopener noreferrer">
+          GitHub 仓库
+        </a>
+      </div>
+    </div>
   );
 };
 

package/lib/templates/index.js

@@ -1,51 +1,81 @@
 const fs = require('fs-extra');
 const path = require('path');
 
-// 模板变量替换函数
+/**
+ * 模板变量替换函数
+ * 将模板文件中的占位符（如{{projectName}}）替换为实际的值
+ * @param {string} content - 文件内容
+ * @param {object} variables - 变量对象，包含要替换的键值对
+ * @returns {string} 替换后的内容
+ */
 function replaceTemplateVariables(content, variables) {
   let result = content;
+  // 遍历所有变量，逐一替换
   for (const [key, value] of Object.entries(variables)) {
+    // 创建占位符格式：{{变量名}}
     const placeholder = `{{${key}}}`;
+    // 全局替换所有匹配的占位符
     result = result.replace(new RegExp(placeholder, 'g'), value || '');
   }
   return result;
 }
 
-// 递归复制目录并替换模板变量
+/**
+ * 递归复制目录并替换模板变量
+ * 这是核心函数，负责将模板目录完整复制到目标位置，并处理模板变量
+ * @param {string} srcDir - 源目录路径（模板目录）
+ * @param {string} destDir - 目标目录路径（项目生成位置）
+ * @param {object} variables - 模板变量对象
+ */
 async function copyTemplateDir(srcDir, destDir, variables) {
+  // 确保目标目录存在，如果不存在则创建
   await fs.ensureDir(destDir);
   
+  // 读取源目录下的所有文件和文件夹
   const items = await fs.readdir(srcDir);
   
+  // 遍历每个项目（文件或文件夹）
   for (const item of items) {
-    const srcPath = path.join(srcDir, item);
-    const destPath = path.join(destDir, item);
+    const srcPath = path.join(srcDir, item);    // 源文件/文件夹的完整路径
+    const destPath = path.join(destDir, item);  // 目标文件/文件夹的完整路径
     
+    // 获取文件/文件夹的统计信息
     const stat = await fs.stat(srcPath);
     
     if (stat.isDirectory()) {
-      // 递归处理子目录
+      // 如果是目录，递归调用自己，复制整个子目录
       await copyTemplateDir(srcPath, destPath, variables);
     } else {
-      // 处理文件
+      // 如果是文件，读取文件内容并处理模板变量
       const content = await fs.readFile(srcPath, 'utf8');
+      // 替换文件中的模板变量（如{{projectName}}）
       const processedContent = replaceTemplateVariables(content, variables);
+      // 将处理后的内容写入目标文件
       await fs.writeFile(destPath, processedContent);
     }
   }
 }
 
+/**
+ * 生成模板项目的主函数
+ * @param {string} projectName - 项目名称
+ * @param {string} templateType - 模板类型（如react、vue等）
+ * @param {string} targetDir - 目标生成目录
+ */
 async function generateTemplate(projectName, templateType, targetDir) {
+  // 获取模板根目录路径
   const templatesDir = path.join(__dirname, './');
+  // 构建特定模板目录路径
   const templateDir = path.join(templatesDir, templateType);
+  // 构建通用文件目录路径
   const commonDir = path.join(templatesDir, 'common');
   
-  // 检查模板是否存在
+  // 检查指定的模板是否存在
   if (!await fs.pathExists(templateDir)) {
     throw new Error(`模板 "${templateType}" 不存在`);
   }
   
-  // 模板变量
+  // 定义模板变量，这些变量会在模板文件中被替换
   const variables = {
     projectName: projectName || 'my-umi-app'
   };
@@ -53,17 +83,25 @@ async function generateTemplate(projectName, templateType, targetDir) {
   // 确保目标目录存在
   await fs.ensureDir(targetDir);
   
-  // 首先创建基础目录结构
-  const baseDirs = ['src/pages', 'src/components', 'src/services', 'src/utils'];
+  // 创建项目的基础目录结构
+  // 这些是前端项目常用的目录结构
+  const baseDirs = [
+    'src/pages',      // 页面组件目录
+    'src/components', // 公共组件目录
+    'src/services',   // API服务目录
+    'src/utils'       // 工具函数目录
+  ];
+  
+  // 遍历并创建所有基础目录
   for (const dir of baseDirs) {
     await fs.ensureDir(path.join(targetDir, dir));
   }
   
-  // 复制模板特定的文件
+  // 复制模板特定的文件（如React模板、Vue模板等）
   console.log(`📂 正在复制模板文件...`);
   await copyTemplateDir(templateDir, targetDir, variables);
   
-  // 复制通用文件
+  // 复制通用文件（如配置文件、README等，所有模板都需要的文件）
   if (await fs.pathExists(commonDir)) {
     console.log(`📄 正在复制通用配置文件...`);
     await copyTemplateDir(commonDir, targetDir, variables);
@@ -72,14 +110,20 @@ async function generateTemplate(projectName, templateType, targetDir) {
   console.log(`✅ 模板文件复制完成`);
 }
 
-// 获取可用的模板列表
+/**
+ * 获取所有可用的模板列表
+ * 扫描模板目录，返回所有可用的模板类型
+ * @returns {Array<string>} 可用模板列表
+ */
 async function getAvailableTemplates() {
   const templatesDir = path.join(__dirname, './');
   
+  // 如果模板目录不存在，返回空数组
   if (!await fs.pathExists(templatesDir)) {
     return [];
   }
   
+  // 读取模板目录下的所有项目
   const items = await fs.readdir(templatesDir);
   const templates = [];
   
@@ -87,7 +131,8 @@ async function getAvailableTemplates() {
     const itemPath = path.join(templatesDir, item);
     const stat = await fs.stat(itemPath);
     
-    // 排除common目录和index.js文件，只返回实际的模板目录
+    // 只返回目录类型的模板，排除common目录和index.js文件
+    // common目录是通用文件目录，不是模板类型
     if (stat.isDirectory() && item !== 'common') {
       templates.push(item);
     }
@@ -96,7 +141,8 @@ async function getAvailableTemplates() {
   return templates;
 }
 
+// 导出主要功能函数
 module.exports = {
-  generateTemplate,
-  getAvailableTemplates
+  generateTemplate,        // 生成模板项目
+  getAvailableTemplates   // 获取可用模板列表
 }; 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ysjdemo/umi-create-cli",
   "author": "ysj <411367308@qq.com>",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "一个用于创建Umi4项目的脚手架工具",
   "main": "index.js",
   "bin": {
@@ -11,7 +11,6 @@
     "start": "node bin/cli.js",
     "test": "echo \"Error: no test specified\" && exit 1",
     "prepublishOnly": "echo 'Preparing to publish...'",
-    "publish:auto": "node scripts/publish.js",
     "version:patch": "npm version patch",
     "version:minor": "npm version minor",
     "version:major": "npm version major"
@@ -29,12 +28,12 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/yourusername/cfmm-cli-umi.git"
+    "url": "https://github.com/Ivan-YangSj/umi-cli.git"
   },
   "bugs": {
-    "url": "https://github.com/yourusername/cfmm-cli-umi/issues"
+    "url": "https://github.com/Ivan-YangSj/umi-cli/issues"
   },
-  "homepage": "https://github.com/yourusername/cfmm-cli-umi#readme",
+  "homepage": "https://github.com/Ivan-YangSj/umi-cli#readme",
   "publishConfig": {
     "access": "public"
   },