Skip to content

CLI 选项 ​

命令格式 ​

text
kevairy create [目录] [选项]

在当前 Kevairy 源仓库中通过根脚本调用:

bash
pnpm create:app [目录] [选项]

参数 ​

选项说明
[目录]项目输出目录;交互模式下可省略,使用 --yes 时必须提供
--name <name>根 package.json 中的项目名称
--display-name <name>页面标题和品牌展示名称
--package-manager <manager>pnpm、npm 或 yarn,默认 pnpm
--template-version <version>@kevairy/template 版本,默认 latest
--install / --no-install是否自动安装依赖,默认安装
--git / --no-git是否初始化 Git 仓库,默认初始化
--verbose显示依赖安装和 Git 命令的完整输出
-y, --yes使用默认值并跳过所有交互
-h, --help显示帮助信息

默认值 ​

  • package 名称由目录名规范化得到;
  • 页面显示名称由 package 名称转换得到;
  • 包管理器为 pnpm;
  • 模板版本为 npm latest;
  • 默认安装依赖;
  • 默认初始化 Git 仓库。

自动化示例 ​

bash
pnpm create:app service-console \
  --name service-console \
  --display-name "Service Console" \
  --package-manager pnpm \
  --template-version 0.1.0 \
  --no-install \
  --no-git \
  --yes

非交互执行时应显式提供会影响交付结果的选项,避免脚手架默认值变化后影响流水线。

交互终端会显示品牌启动页、配置预览和动态任务状态。CI、管道或其他非 TTY 环境必须指定目标目录并使用 --yes,此时输出自动降级为稳定的逐行日志。命令执行失败时 CLI 会保留已生成的项目目录;使用 --verbose 可以查看完整的包管理器和 Git 输出。