Robot CLI

July 15, 2026 · View on GitHub

最后更新: 2026-07-15


已上线 (v3.x)

能力说明
4 个稳定模板 + 1 个 BetaRobot Admin、Monorepo、MicroApp、Module Federation;Robot H5 以 Beta 接入
模板配置系统(v3.1 新增)Robot Admin 完整版支持 Full/Lite/Custom 三档配置,精准裁剪演示页面、可选功能和依赖
git clone 下载引擎使用 git clone --depth=1,与 create-vue/degit 同方案,自动继承系统代理,实时进度条
Gitee 国内加速Gitee 优先克隆,GitHub 兜底,HTTP ZIP 二次兜底,三层容错
@clack/prompts 现代交互4 种模板选择方式(推荐/分类/搜索/全部),确认面板,美化输出
离线缓存首次下载自动缓存,网络断了也能用
环境诊断 robot doctor检测 Node/Git/包管理器/网络,一键排查
coming-soon 防护未上线的 8 个模板标记为"开发中",选择时跳过,不会让用户踩坑
CIGitHub Actions 自动检查 Node 20/22/24;npm 版本由维护者本地使用 Bun 发布
模板契约支持校验模板 manifest、Node/pnpm 约束,并无 shell 调用模板初始化器
单元测试覆盖校验、模板查询、下载、裁剪和模板运行时契约

模板配置系统 (v3.1)

核心思路:选择 Robot Admin 完整版时,CLI 自动提供 Full / Lite / Custom 三种配置模式,裁剪规则内置于 CLI,无需在模板项目中添加任何文件。

三种模式

模式说明
完整版(Full)保留全部功能,等同于直接 clone 主分支
精简版(Lite)⭐移除演示页面、仪表盘、i18n、统计、可选包、3D 背景等,保留核心业务框架 + 系统管理
自定义(Custom)用户逐项选择要保留的页面模块(4 项)、功能模块(3 项)、@robot-admin 可选包(4 项)

可裁剪模块一览

分类模块Lite 默认裁剪
页面模块演示页面(56 个组件示例 + 预览系统)
页面模块仪表盘(ECharts 图表页面)
页面模块系统管理页面(用户/角色/权限/菜单/字典)
页面模块外部页面 + 关于
功能模块国际化(i18n 多语言支持)
功能模块登录页 3D 背景(Spline 动画)
功能模块Vercel Analytics(线上统计)
可选包@robot-admin/directives
可选包@robot-admin/file-utils
可选包@robot-admin/form-validate
可选包@robot-admin/git-standards

无论选择何种模式,vue-command-palettemotion-v(零使用依赖)始终被自动清理。


模板上线计划

已上线

模板仓库分支
Robot Admin 完整版Robot_Adminmain
Robot MonorepoRobot_Adminmonorepo
Robot MicroApp 微前端Robot_Adminmicro-app
Robot Module FederationRobot_Adminmodule-federation
Robot H5(Beta)Robot_H5main

待建仓

模板需要创建的仓库优先级
Robot React 完整版/精简版Robot_React
Robot NestJS 完整版/精简版Robot_Nest
Robot ElectronRobot_Electron
Robot NestJS 微服务Robot_Nest_Micro

远期方向 (v4.x)

方向说明
更多模板配置支持将模板配置系统扩展到其他模板(Monorepo、MicroApp 等)
Robot H5 转 Stable完成性能预算、CI、开源授权后进入首页推荐
monorepo 子包脚手架robot add auth-module 在 monorepo 中快速添加新子包
模板版本锁定robot create my-app -t robot-admin@v2.0 指定 tag
私有模板注册表企业内部模板源 robot registry add https://...
插件系统robot plugin add eslint-config 一键注入配置