- 4 个稳定模板 + Robot H5 Beta：覆盖 Vue 中后台、Monorepo、微前端、模块联邦和企业移动 H5
- 模板配置系统：Robot Admin 支持 Full / Lite / Custom 三档配置，按需裁剪演示页面和可选功能
- 秒级下载：
git clone --depth=1引擎，和 create-vue / degit 同方案，自动走系统代理 - 国内友好：Gitee 优先 → GitHub 兜底 → HTTP ZIP 二次兜底，三层容错
- 现代交互：基于 @clack/prompts，4 种选模板方式，实时进度条，确认面板
- 离线可用：首次下载自动缓存，断网也能创建项目
- 零配置：自动检测 bun/pnpm/yarn/npm，自动初始化 Git，开箱即用
# 零安装体验（推荐）
npx @agile-team/robot-cli create my-project
# 或
bunx @agile-team/robot-cli create my-project
# 全局安装后使用
npm i -g @agile-team/robot-cli
robot create选择 Robot Admin 完整版 时，CLI 会自动询问模板配置模式：
◆ 选择模板配置:
│ ○ 完整版（Full）- 包含所有演示页面和功能模块
│ ● 精简版（Lite）- 移除演示页面，保留核心业务框架 ⭐ 推荐
│ ○ 自定义（Custom）- 自行选择要保留的模块
| 模式 | 说明 | 适用场景 |
|---|---|---|
| Full | 保留全部 74 个页面、所有功能和依赖 | 学习参考、功能演示 |
| Lite ⭐ | 移除 56 个演示页面 + 仪表盘 + i18n + 3D 背景等，保留核心业务框架 + 系统管理 | 实际项目开发 |
| Custom | 逐项选择要保留的页面模块、功能模块、可选包 | 定制化需求 |
裁剪在模板下载后自动执行，其他模板不受影响，现有 CLI 功能完全不变。
| 模板 | 架构 | 技术栈 | 仓库分支 |
|---|---|---|---|
| Robot Admin 完整版 | 单体应用 | Vue 3 + Naive UI + Pinia + 权限 + 图表 + 50+ 示例 | main |
| Robot Monorepo | Monorepo | bun workspace + 多包管理 + 共享组件 | monorepo |
| Robot MicroApp | 微前端 | MicroApp + 主子应用 + 路由共享 | micro-app |
| Robot Module Federation | 模块联邦 | Vite Module Federation + 远程模块 | module-federation |
前 4 个模板共用仓库 ChenyCHENYU/Robot_Admin，不同架构通过分支区分。
| 模板 | 场景 | 技术栈 | 运行要求 |
|---|---|---|---|
| Robot H5 | 企业 H5 / 微信与钉钉浏览器 / App WebView | Vue 3 + Vite 7 + Vant 4 + Bridge | Node 22.12/24 + pnpm 11.8 |
Robot H5 使用模板自带的 template.manifest.json 契约初始化。CLI 会校验模板身份、
Node.js 和包管理器要求，再安全调用模板的非交互初始化器。当前为 Beta，请先在测试项目验证。
robot-cli 每周还会真实执行冻结依赖安装与生产构建，及时发现上游模板漂移。
Robot Admin 精简版 · React 全家桶 · NestJS 后端 · Electron 桌面端 — 即将上线，敬请期待。
交互式创建项目，全流程引导。
robot create # 交互式
robot create my-app -t robot-admin # 指定模板
robot create mobile-app -t robot-h5 # Robot H5 Beta（要求 Node 24 + pnpm 11.8）
robot create my-app --from https://github.com/org/repo # 自定义仓库
robot create my-app --dry-run # 预览，不实际创建
robot create my-app --skip-install # 跳过依赖安装
robot create my-app --no-cache # 强制重新下载robot list # 查看所有模板
robot list -r # 只看推荐模板robot search vue # 搜 Vue 相关
robot search 微前端 # 搜中文关键词robot doctor # 环境诊断（Node/Git/包管理器/网络）
robot doctor --clear-cache # 清理模板缓存Robot CLI 使用三层容错策略：
1. git clone --depth=1 (Gitee) ← 国内最快
2. git clone --depth=1 (GitHub) ← 自动继承系统代理
3. HTTP ZIP 下载 (codeload CDN) ← git 不可用时兜底
- 实时显示 git 克隆进度条（百分比 + 速度）
- 首次下载自动缓存到
~/.robot-cli/cache/ - 断网时使用缓存版本
robot-cli/
├── bin/robot.js # CLI 入口
├── src/
│ ├── index.ts # Commander 命令注册 + Banner
│ ├── create.ts # 交互式创建流程
│ ├── download.ts # 下载引擎（git clone + HTTP 兜底）
│ ├── templates.ts # 模板查询
│ ├── doctor.ts # 环境诊断
│ ├── utils.ts # 工具函数
│ ├── types.ts # 类型定义
│ ├── trimmer/
│ │ └── index.ts # 模板配置裁剪引擎
│ └── config/
│ ├── templates.config.ts # 模板注册表（所有模板定义在这里）
│ └── cli.config.ts # CLI 配置（推荐列表、启动命令等）
├── tests/ # Vitest 单元测试
├── tsup.config.ts # 构建配置（ESM, node20）
└── .github/workflows/ # 提交与 PR 的 CI 检查
git clone https://github.com/ChenyCHENYU/robot-cli.git
cd robot-cli
bun install
bun run dev # watch 构建
bun link # 全局链接
robot create # 测试编辑 src/config/templates.config.ts：
"your-template": {
name: "模板名称",
description: "模板描述",
repoUrl: "https://github.com/org/repo",
branch: "main",
features: ["特性1", "特性2"],
version: "full",
}模板仓库要求：根目录有 package.json。
bun run build # tsup 构建
bun run test # Vitest 测试
bun run typecheck # TypeScript 类型检查
bun run lint # oxlint 代码检查bun run check # 完整质量检查
bun run release:dry-run # 检查 npm 包内容
bun run release:patch # 生成版本提交和 tag（也可用 minor / major）
bun run release:publish # 本地登录 npm 后发布；自动检查并构建 dist
git push origin main
git push origin vX.Y.Z # 单独推送本次 tagnpm 包由维护者在本地通过 Bun 发布；prepublishOnly 会执行完整质量检查，prepack
会自动构建发布所需的 dist。GitHub Actions 只运行 CI，不接触 npm 凭据，也不参与
发版。请单独推送本次 tag，不要使用 --follow-tags 批量推送历史标签。
TypeScript 5.7+ · tsup 8 · Vitest 3 · @clack/prompts · Commander · Node ≥ 20
模板下载失败？
robot doctor # 先诊断环境
# 确保系统已安装 git 且网络可用command not found: robot？
npx @agile-team/robot-cli create # 免安装使用
# 或重新全局安装
npm i -g @agile-team/robot-cli如何选架构？
| 场景 | 推荐模板 |
|---|---|
| 中小后台项目 | robot-admin |
| 大型项目、多包共享 | robot-monorepo |
| 多团队协作、独立部署 | robot-micro-app |
| 运行时模块共享 | robot-module-federation |
| 企业 H5、微信/钉钉浏览器、App WebView | robot-h5（Beta） |
- 4 stable templates + Robot H5 Beta: Vue admin, Monorepo, micro-frontends, Module Federation, and enterprise mobile H5
- Template configuration system: Robot Admin supports Full / Lite / Custom modes — trim demo pages and optional features on demand
- Instant download:
git clone --depth=1engine, same approach as create-vue / degit, inherits system proxy - China-friendly: Gitee first → GitHub fallback → HTTP ZIP fallback, triple fault-tolerance
- Modern UX: @clack/prompts, 4 template selection modes, real-time progress, confirmation panels
- Offline support: Auto-cached after first download, works without internet
- Zero config: Auto-detects bun/pnpm/yarn/npm, auto-inits Git, works out of the box
# Zero-install (recommended)
npx @agile-team/robot-cli create my-project
# or
bunx @agile-team/robot-cli create my-project
# Global install
npm i -g @agile-team/robot-cli
robot createWhen selecting Robot Admin Full, the CLI offers three configuration modes:
◆ Select template configuration:
│ ○ Full — Keep all demo pages and features
│ ● Lite — Remove demos, keep core business framework ⭐ Recommended
│ ○ Custom — Choose modules to keep
| Mode | Description | Use Case |
|---|---|---|
| Full | All 74 pages, all features and deps | Learning, demos |
| Lite ⭐ | Remove 56 demo pages + dashboard + i18n + 3D login + more, keep core + sys-manage | Real projects |
| Custom | Pick individual page modules, features, optional packages | Custom needs |
Trimming runs automatically after download. Other templates are not affected.
| Template | Architecture | Stack | Branch |
|---|---|---|---|
| Robot Admin Full | Monolith | Vue 3 + Naive UI + Pinia + Auth + Charts + 50+ demos | main |
| Robot Monorepo | Monorepo | bun workspace + multi-package | monorepo |
| Robot MicroApp | Micro-frontend | MicroApp + sub-apps + shared routing | micro-app |
| Robot Module Federation | Module Federation | Vite Module Federation + remote modules | module-federation |
| Template | Use case | Stack | Runtime |
|---|---|---|---|
| Robot H5 | Enterprise H5 / WeChat and DingTalk browsers / App WebView | Vue 3 + Vite 7 + Vant 4 + Bridge | Node 22.12/24 + pnpm 11.8 |
Robot H5 is initialized through its template.manifest.json contract. The CLI validates
template identity and runtime constraints before invoking its non-interactive initializer.
Its weekly smoke test also performs a frozen dependency install and production build.
robot create # Interactive
robot create my-app -t robot-admin # Specify template
robot create mobile-app -t robot-h5 # Robot H5 Beta (Node 24 + pnpm 11.8)
robot create my-app --from https://github.com/org/repo # Custom repo
robot create my-app --dry-run # Preview only
robot create my-app --skip-install # Skip deps install
robot create my-app --no-cache # Force re-downloadrobot list # List all templates
robot list -r # Recommended only
robot search vue # Search by keyword
robot doctor # Environment diagnostic
robot doctor --clear-cache # Clear template cache1. git clone --depth=1 (Gitee) ← Fastest in China
2. git clone --depth=1 (GitHub) ← Inherits system proxy
3. HTTP ZIP (codeload CDN) ← Fallback when git unavailable
git clone https://github.com/ChenyCHENYU/robot-cli.git
cd robot-cli
bun install
bun run dev # Watch build
bun run build # Production build
bun run test # Vitest unit tests
bun run typecheck # TypeScript check
bun run lint # oxlintbun run check
bun run release:dry-run
bun run release:patch # or release:minor / release:major
bun run release:publish # checks and builds dist automatically
git push origin main
git push origin vX.Y.Z # push only this tagThe maintainer publishes the npm package locally with Bun. prepublishOnly runs the
quality checks and prepack builds dist automatically. GitHub Actions only runs CI;
it never receives npm credentials and does not participate in releases. Push the new tag
explicitly instead of using --follow-tags with historical tags.
Tech Stack: TypeScript 5.7+ · tsup 8 · Vitest 3 · @clack/prompts · Commander · Node ≥ 20
MIT