app-factory（app工厂）CLI

一个用于从本地模板或 Git 仓库快速搭建 Vite 多页面（MPA）项目的命令行工具。

使用方式

# 使用 npx（推荐）
npx qai-app-factory@latest

# 或全局安装
npm i -g qai-app-factory
app-factory

# 在指定目录创建项目
app-factory my-app

# 从指定 Git 仓库与分支拉取模板
app-factory my-app --template https://git.zuoyebang.cc/zhiji/project-template.git --branch app-h5-template

# 不传 --template 时，将使用内置默认模板与分支
app-factory my-app

# 在当前目录创建项目（目录需为空或允许覆盖）
app-factory .

参数说明

• --template <path|git-url>：模板来源，本地路径或 Git 仓库地址（以 .git 结尾）。
• --pkg-manager <npm|pnpm|yarn|bun>：指定安装依赖的包管理器。
• --no-install：跳过依赖自动安装。
• --branch <name>：从 Git 仓库拉取时指定分支。

默认模板

• 仓库：https://git.zuoyebang.cc/zhiji/project-template.git
• 分支：app-h5-template
• 可通过环境变量覆盖：APP_FACTORY_TEMPLATE_GIT、APP_FACTORY_TEMPLATE_BRANCH

功能特性

• 支持从本地目录复制或从 Git 仓库浅克隆模板，并自动移除 .git。
• 自动将目标项目 package.json 的 name 改为新项目名。
• 可选自动安装依赖（支持 npm/pnpm/yarn/bun）。
  • 自动识别优先级：目标目录锁文件 > 用户代理（npx/包管理器 UA）> 默认 pnpm
  • 锁文件判定：pnpm-lock.yaml → pnpm；yarn.lock → yarn；bun.lockb → bun；package-lock.json → npm

许可证

MIT