{"id":26365453,"url":"https://github.com/biaov/mine-auto-cli","last_synced_at":"2025-10-04T15:09:42.045Z","repository":{"id":199674769,"uuid":"703432824","full_name":"biaov/mine-auto-cli","owner":"biaov","description":"一个将多个命令简化成一个命令的工具 😆","archived":false,"fork":false,"pushed_at":"2025-09-09T09:14:58.000Z","size":335,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-09-11T05:29:36.613Z","etag":null,"topics":["auto-cli","cli","typescript","vite"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/mine-auto-cli","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/biaov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-10-11T08:32:21.000Z","updated_at":"2025-09-09T09:14:57.000Z","dependencies_parsed_at":"2023-10-11T15:18:35.784Z","dependency_job_id":"b1d27bae-0f71-4450-9771-d1787c1c7b36","html_url":"https://github.com/biaov/mine-auto-cli","commit_stats":null,"previous_names":["biaov/mine-auto-cli"],"tags_count":24,"template":false,"template_full_name":null,"purl":"pkg:github/biaov/mine-auto-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biaov%2Fmine-auto-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biaov%2Fmine-auto-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biaov%2Fmine-auto-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biaov%2Fmine-auto-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/biaov","download_url":"https://codeload.github.com/biaov/mine-auto-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biaov%2Fmine-auto-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278329037,"owners_count":25969066,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["auto-cli","cli","typescript","vite"],"created_at":"2025-03-16T19:37:05.967Z","updated_at":"2025-10-04T15:09:42.017Z","avatar_url":"https://github.com/biaov.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mine-auto-cli\r\n\r\n一个将多个命令简化成一个命令的工具 😆\r\n\r\n\u003ch2 align=\"center\"\u003e\r\n  \u003ca href=\"https://www.npmjs.com/package/mine-auto-cli\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/mine-auto-cli.svg?logo=npm\" alt=\"版本\" /\u003e\u003c/a\u003e\r\n  \u003ca href=\"https://www.npmjs.com/package/mine-auto-cli\"\u003e\u003cimg src=\"https://img.shields.io/npm/dt/mine-auto-cli?logo=Markdown\" alt=\"下载量\" /\u003e\u003c/a\u003e\r\n  \u003ca href=\"https://www.npmjs.com/package/mine-auto-cli\"\u003e\u003cimg src=\"https://packagephobia.com/badge?p=mine-auto-cli\" alt=\"安装大小\" /\u003e\u003c/a\u003e\r\n  \u003ca href=\"https://github.com/biaov/mine-auto-cli/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-green?logo=Unlicense\" alt=\"版权\" /\u003e\u003c/a\u003e\r\n\u003c/h2\u003e\r\n\r\n## 特性\r\n\r\n- [x] [初始化配置文件](#初始化配置文件)\r\n- [x] [简化 `Git` 提交命令](#简化-git-提交命令)\r\n- [x] [简化打包提交命令](#简化打包提交命令)\r\n- [x] [简化手动更改版本号命令](#简化手动更改版本号命令)\r\n- [x] [生成工作目录结构文件](#生成工作目录结构文件)\r\n- [x] [检查 `package.json` 依赖版本](#检查-packagejson-依赖版本)\r\n- [x] [生成依赖注释文件](#生成依赖注释文件)\r\n- [x] [更新 `.vscode` 文件](#更新-vscode-文件)\r\n- [x] [切换 Node 版本](#切换-node-版本)\r\n\r\n## 全局安装\r\n\r\n```sh\r\nnpm i -g mine-auto-cli\r\n```\r\n\r\n## 使用\r\n\r\n### 查看版本\r\n\r\n```sh\r\nauto -v\r\n```\r\n\r\n### 查看所有命令\r\n\r\n```sh\r\nauto -h\r\n```\r\n\r\n### 初始化配置文件\r\n\r\n- 自动生成初始化 `auto-cli.jsonc` 文件\r\n- 带上 `-y` 或者 `--yml` 生成 `auto-cli.yml`\r\n- 如果两个文件都存在，则合并优先于 `auto-cli.jsonc` 文件\r\n- 初始化的所有字段仅是默认值和可选值，可以自定义删除\r\n\r\n```sh\r\nauto init\r\n```\r\n\r\n- 字段解析：\r\n\r\n  - `prefix`: 版本前缀，默认为 `^`\r\n  - `registry`: 依赖来源，默认为 `https://registry.npmmirror.com/`\r\n  - `check`: 是否更新 `package.json` 文件，为 `true` 时等同于 `auto check -u`, `-u` 优先级最高， 默认为 `false`\r\n  - `reject`: 拒绝检查的依赖，默认为 `[]`\r\n  - `resolve`: 指定版本检查的标签，默认为 `[]`，例如：['mine-auto-cli@beta']，默认标签为 `latest`\r\n  - `comment`: 配置依赖解析说明预设\r\n\r\n- auto-cli.jsonc\r\n\r\n```json\r\n{\r\n  \"prefix\": \"^\",\r\n  \"registry\": \"https://registry.npmmirror.com/\",\r\n  \"check\": false,\r\n  \"reject\": [],\r\n  \"resolve\": [],\r\n  \"comment\": {}\r\n}\r\n```\r\n\r\n- auto-cli.yml\r\n\r\n```yml\r\nprefix: ^\r\nregistry: https://registry.npmmirror.com/\r\ncheck: false\r\nreject: []\r\nresolve: []\r\ncomment: {}\r\n```\r\n\r\n### 简化 Git 提交命令\r\n\r\n```sh\r\nauto git [描述]\r\n# 等同于\r\ngit add -A\r\ngit commit -m [描述]\r\ngit push\r\n```\r\n\r\n### 简化打包提交命令\r\n\r\n```sh\r\nauto build[:环境] [描述]\r\n# 等同于\r\nnpm run build:staging\r\ngit add -A\r\ngit commit -m [描述]\r\ngit push\r\n```\r\n\r\n### 简化手动更改版本号命令\r\n\r\n```sh\r\n# 版本号自增\r\nauto version++\r\n# 或者指定具体的版本号\r\nauto version@1.0.0\r\n```\r\n\r\n### 生成工作目录结构文件\r\n\r\n- 可以在工作目录生成 `directory.md` 文件\r\n\r\n```sh\r\nauto mkdir\r\n```\r\n\r\n- `directory.md`\r\n\r\n```MD\r\n├── mine-auto-cli\r\n│    ├── src\r\n│    │    └── commander\r\n└    └── README.md\r\n```\r\n\r\n- 通过 `-l, --line` 生成的结构文件带横线，默认数量为 `20`\r\n- 通过 `-n, --name` 自定义生成的结构文件名称，默认名称为 `directory`\r\n\r\n```sh\r\nauto mkdir -l 10 -n demo\r\n```\r\n\r\n- `demo.md`\r\n\r\n```MD\r\n├── mine-auto-cli  ----------------------\r\n│    ├── src  ---------------------------\r\n│    │    └── commander -----------------\r\n└    └── README.md ----------------------\r\n```\r\n\r\n### 检查 package.json 依赖版本\r\n\r\n```sh\r\nauto check\r\n```\r\n\r\n![img](./assets/check.png)\r\n\r\n### 生成依赖注释文件\r\n\r\n- 可以在工作目录生成 `comment.md` 文件\r\n\r\n```sh\r\nauto comment\r\n```\r\n\r\n- `comment.md`\r\n- 可以在 `auto-cli.jsonc` 配置 `comment` 用来设置预设值，不设置的话默认为空\r\n\r\n```MD\r\n### 依赖解析\r\n\r\n#### dependencies\r\n\r\n- `mine-h5-ui`:\r\n\r\n#### devDependencies\r\n\r\n- `mine-auto-cli`:\r\n\r\n#### optionalDependencies\r\n\r\n- `@rollup/rollup-linux-x64-gnu`:\r\n```\r\n\r\n### 更新 `.vscode` 文件\r\n\r\n```sh\r\nauto vscode-config\r\n```\r\n\r\n### 切换 Node 版本\r\n\r\n- 基于 nvm 快速切换 node 版本\r\n- 当我们运行的项目过多并且版本还不一致时，此命令可以用于快速切换\r\n- 默认选择第一个版本号\r\n\r\n```sh\r\n# 命令\r\nauto node [版本号]\r\n# 切换为 20 开头的版本\r\nauto node 20\r\n# 切换为 20.12.1 的版本\r\nauto node 20.12.1\r\n```\r\n\r\n### 技术栈\r\n\r\n- `Vite` + `TypeScript` + `NodeJs`\r\n\r\n### 依赖解析\r\n\r\n#### dependencies\r\n\r\n- `chalk`: 字体颜色\r\n- `commander`: 命令\r\n- `download-git-repo`: 下载 Git 仓库\r\n- `inquirer`: 用户交互\r\n- `js-yaml`: 解析 .yml 文件\r\n- `log-symbols`: 图标\r\n- `ora`: 动画效果\r\n- `pacote`: 包信息请求器\r\n- `semver-utils`: 解析包版本\r\n- `strip-json-comments`: 移除 json 注释\r\n- `update-notifier`: 检查更新\r\n\r\n#### devDependencies\r\n\r\n- `@types/js-yaml`: `js-yaml` 类型\r\n- `@types/node`: `node` 类型\r\n- `@types/pacote`: `pacote` 类型\r\n- `@types/semver-utils`: `semver-utils` 类型\r\n- `@types/update-notifier`: `update-notifier` 类型\r\n- `prettier`: 格式化工具\r\n- `typescript`: 编程语言\r\n- `vite`: 项目构建工具\r\n\r\n## 贡献者们\r\n\r\n[![贡献者们](https://contrib.rocks/image?repo=biaov/mine-auto-cli)](https://github.com/biaov/mine-auto-cli/graphs/contributors)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbiaov%2Fmine-auto-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbiaov%2Fmine-auto-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbiaov%2Fmine-auto-cli/lists"}