明途脚手架工具，提供项目初始化、包更新、发布、资源上传、hosts 配置和版本号维护等命令。

使用

无需安装，直接通过 npx 调用：

npx @mingto/mt-cli --help

后续所有命令都以 npx @mingto/mt-cli 开头，示例中简写为 mt-cli。

命令概览

命令	说明
mt-cli init [project-name]	创建新项目
mt-cli hosts	更新 hosts 文件配置
mt-cli up	发布当前包的新版本
mt-cli update	检测并更新项目中的 @mingto 包
mt-cli upload	上传单个文件到远程存储
mt-cli local	扫描并上传项目中的本地图片引用
mt-cli upgraded	更新 public/manifest.json 中的版本号

所有主要命令都支持 -D, --debug 输出详细日志。

init

创建新项目。

mt-cli init my-project

选项

选项	说明
-t, --template [template]	指定模板名称
-f, --force [force]	目标目录已存在时是否强制创建
-D, --debug	输出详细日志

内置模板

模板	说明
nuxt3	Nuxt3 模板
custom-ability	自定义能力模板
h5-vue3	h5-vue3 模板
pc-vue3	pc-vue3 模板

mt-cli init my-project -t h5-vue3

hosts

更新系统 hosts 文件中的空间域名配置。

mt-cli hosts -d demo -e development

选项

选项	说明
-d, --domain [domain]	指定空间域名，要求 4-20 位字母、数字或连字符
-e, --env [env]	指定运行环境
-D, --debug	输出详细日志

内置环境

环境	说明	IP	Base	Port
localhost	本地环境	127.0.0.1	/	3000
development	测试环境	172.168.80.30	/chat/	80

该命令会写入 mt01.cn 和 {domain}.mt01.cn。Windows 和 macOS 需要具备 hosts 文件写入权限。

up

发布当前包的新版本。

mt-cli up

选项

选项	说明
-D, --debug	输出详细日志

命令会读取当前目录的 package.json，引导选择 patch、minor、major 或自定义版本号，然后执行安装、构建和发布流程。发布失败时会回滚 package.json 的版本号。

update

检测当前项目依赖中的 @mingto 包，并更新到 npm 最新版本。

mt-cli update

选项

选项	说明
-y, --yes	跳过确认，直接更新所有可更新包
-D, --debug	输出详细日志

mt-cli update --yes

upload

上传单个文件到远程存储。

mt-cli upload -d web_image -f /absolute/path/to/demo.png

选项

选项	说明
-d, --dir <dir>	目标目录标识
-f, --file <file>	本地文件的绝对路径，支持 file:// 协议
-D, --debug	输出详细日志

支持的目标目录

目录标识	说明
web_image	数字人 web 图片
wechat_image	数字人微信图片
app_image	数字人 app 图片
szr_head	数字人头像
szr_video	数字人视频

支持的文件后缀

jpg、png、jpeg、gif、webp、mp4

local

扫描项目源码中的本地图片引用，上传后将引用替换为远程地址。

mt-cli local

配置文件

命令会读取当前目录下的 local.config.json，不存在时使用默认配置。

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

配置项	说明
paths	路径别名配置
include	扫描文件范围
exclude	排除文件范围
renameSameFile	文件名冲突时是否自动重命名
deleteOriginal	上传成功后是否删除本地原文件
uploadDir	上传目录标识

支持扫描 src="..."、url(...) 和 from '...' 形式的本地图片引用。

upgraded

更新当前项目 public/manifest.json 中的 version 字段。

mt-cli upgraded

选项

选项	说明
--no-git	跳过 git add、commit、push 操作
-D, --debug	输出详细日志

mt-cli upgraded --no-git

命令会引导选择 patch、minor、major 或自定义版本号。默认会提交并推送 public/manifest.json，使用 --no-git 可仅修改文件。