外观
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 输出。