@mingto/mt-cli

@mingto/mt-cli

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

使用

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

npx @mingto/mt-cli --help

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

命令概览

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

init

创建新项目。

mt-cli init my-project

选项

内置模板

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

hosts

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

mt-cli hosts -d demo -e development

选项

内置环境

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

up

发布当前包的新版本。

mt-cli up

选项

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

update

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

mt-cli update

选项

mt-cli update --yes

upload

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

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

选项

支持的目标目录

支持的文件后缀

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"
}

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

upgraded

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

mt-cli upgraded

选项

mt-cli upgraded --no-git

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

许可证

ISC