@minto-ai/mt-cli

明途脚手架工具 - 提供项目初始化、版本发布、依赖更新和 hosts 管理等功能的命令行工具。

安装

使用 pnpm 进行全局安装：

pnpm install -g @minto-ai/mt-cli

使用

全局安装后使用

安装完成后，您可以在命令行中使用 mt-cli 命令：

mt-cli --help

使用 npx（推荐）

无需全局安装，直接使用 npx 运行：

# 查看帮助
npx @minto-ai/mt-cli --help

# 创建新项目
npx @minto-ai/mt-cli init my-project

# 发布版本
npx @minto-ai/mt-cli up

# 管理 hosts 文件
npx @minto-ai/mt-cli hosts

可用命令

项目初始化 (init)

创建新项目，支持多种模板选择。

# 创建新项目（交互式）
mt-cli init [project-name]

# 指定模板创建
mt-cli init my-project --template nuxt3

可用选项：

• -t, --template [template] - 指定模板名称
• -f, --force - 如果目录已存在，强制覆盖

支持的模板：

• nuxt3 - Nuxt3 模板
• custom-ability - 自定义能力模板
• h5-vue3 - H5 Vue3 模板
• pc-vue3 - PC Vue3 模板

版本发布 (up)

自动化版本发布流程，包括构建、测试和发布到 npm。

mt-cli up

发布流程：

1. 切换 npm 镜像到 tencent
2. 清空 node_modules 和 dist 目录
3. 安装依赖 (pnpm i)
4. 构建项目 (npm run build)
5. 切换 npm 镜像到 npm
6. 选择版本更新类型（Patch/Minor/Major/Custom）
7. 更新 package.json 版本号
8. 发布到 npm

依赖更新 (update)

自动检测并更新项目中的 @minto-ai 相关依赖包到最新版本。

# 交互式检查更新
mt-cli update

# 跳过确认直接更新
mt-cli update --yes

可用选项：

• -y, --yes - 跳过确认，直接更新所有检测到的包

功能特性：

• 自动识别 package.json 中的 @minto-ai 依赖
• 对比当前版本与 npm 最新版本
• 批量更新依赖包

版本号升级 (upgraded)

专门用于更新 public/manifest.json 中的版本号，并可选提交到 Git。

# 更新 manifest.json 版本号
mt-cli upgraded

# 更新版本号但不进行 Git 操作
mt-cli upgraded --no-git

可用选项：

• --no-git - 跳过 Git 提交和推送操作

功能流程：

1. 读取 public/manifest.json
2. 选择版本更新类型（Patch/Minor/Major/Custom）
3. 更新 manifest.json 文件
4. (可选) 自动执行 git add, git commit, git push

Hosts 文件管理 (hosts)

管理 Windows 系统的 hosts 文件，支持多环境域名配置。

# 交互式配置 hosts
mt-cli hosts

# 命令行指定配置
mt-cli hosts --domain myapp --env development

可用选项：

• -d, --domain [domain] - 指定空间域名（4-20位字母、数字或连字符）
• -e, --env [env] - 指定运行环境

支持的环境：

• localhost - 本地环境 (127.0.0.1:3000)
• development - 测试环境 (172.168.80.30:80)

本地资源处理 (local)

扫描项目中的本地图片引用，自动上传至 OBS 并替换源码路径。

注意：该命令依赖项目根目录下的 local.config.json 配置文件。

mt-cli local

功能特性：

• 自动扫描 .vue, .ts, .html 等文件中的图片引用
• 一键上传图片至 OBS 并去重
• 自动替换源码中的引用路径为远程 URL
• 支持文件名冲突自动重命名
• 可选删除本地原始文件

配置文件 (local.config.json) 示例：

{
  "paths": { "@/*": ["./src/*"] },
  "include": ["./src/**/*.{vue,ts,tsx,js,jsx,html}"],
  "exclude": [],
  "renameSameFile": true,
  "deleteOriginal": false,
  "uploadDir": "web_image"
}

文件上传 (upload)

将本地文件快速上传至指定的远程存储目录。

# 交互式上传
mt-cli upload

# 命令行指定参数上传
mt-cli upload --dir web_image --file "C:\path\to\image.png"

可用选项：

• -d, --dir [dir] - 指定目标目录标识（如 web_image）
• -f, --file [file] - 指定本地文件路径

支持的上传目录：

• web_image - 数字人 web 图片
• wechat_image - 数字人微信图片
• app_image - 数字人 app 图片
• szr_head - 数字人头像
• szr_video - 数字人视频