@142vip/fairy-cli

@142vip/fairy-cli是一个工程化项目CLI工具，在终端中可以使用别名fa执行命令。

快速使用

1# 安装
2pnpm i @142vip/fairy-cli
3
4# 查看帮助
5npx fa -h
6
7# 查看版本
8npx fa -v

功能

1Usage: @142vip/fairy-cli [options] [command]
2
3通用型Cli助手、一站式工具，支持多种命令操作
4
5Options:
6  -v,--version                    VipCommander Version By @142vip
7  -h, --help                      display help for command
8
9Commands:
10  login|l [options]               登录平台
11  install|i [options]             安装依赖
12  release|re [options]            发布新的版本
13  changelog|c [options]           生成CHANGELOG文档
14  publish|p [options]             远程镜像推送
15  sync|s [options] [packageName]  同步NPM包
16  deploy|de [options]             项目部署
17  lint|li [options]               根据Eslint检查、格式化代码风格
18  turbo|t [options] [filters...]  通用型TurboPack管理工具
19  clean|cl [options]              快速清理项目
20  copyright|cr [options]          软件著作权登记的源代码文档生成
21  commit|co [options] [vip]       Git Commit 提交信息
22  help [command]                  display help for command
23

copyright命令

软件著作权申请时，快速生成前后30页的源代码文档，用于审批

查看命令

1# 查看copyright命令
2npx fa cr -h
3
4Usage: @142vip/fairy-cli copyright|cr [options]
5
6申请著作权登记的软件，快速生成源代码文档，包括源代码文档的前30页、后30页、前后30页
7
8Options:
9  -l,--max-line-count    每页最大行数
10  -s,--max-source-count  扫描的最大代码行数
11  --logger               开启日志追踪模式 (default: false)
12  --dry-run              试运行，生成软著源代码文档 (default: false)
13  -h, --help             display help for command

使用示例

1# 正式运行
2fa cr
3# 试运行
4fa cr --dry-run

release

发布新的版本，更新version字段信息，提交到Git仓库

查看命令

1# 查看release命令参数
2npx fa release -h
3
4Usage: @142vip/fairy-cli release|re [options]
5
6发布新的版本，更新version字段信息，提交到Git仓库
7
8Options:
9  --trace                       开启日志追踪模式 (default: false)
10  --dry-run                     试运行 (default: false)
11  --vip                         @142vip组织专用功能 (default: false)
12  --preid <preid>               用于预发布的版本增量标记
13  --tag <tag>                   标签名 (default: false)
14  --commit <msg>                提交信息 (default: false)
15  --push                        推送到Git远程 (default: true)
16  --skip-confirm                跳过确认框二次确认 (default: false)
17  -r,--recursive                递归更新所有package.json中的version字段信息 (default: false)
18  --execute <command>           版本更新后需要执行的命令
19  --package <package>           指定需要发布的包
20  --branch <branch>             指定分支进行发布 (default: "next")
21  --check-release               发布仓库主版本时，校验Monorepo中子模块版本 (default: false)
22  --check-branch [checkBranch]  发布版本时，是否校验分支 (default: [])
23  -F,--filter <filter>          模块的路径，例如："./package/*" (default: [])
24  -h, --help                    display help for command

使用示例

1# 发布
2fa release
3
4# 发布试运行
5fa release --dry-run
6
7# 发布monorepo模式的仓库
8fa release --vip -F './apps/*' -F './packages/*' --check-branch next --check-branch main
9
10# 发布，并校验分支
11fa release --check-branch next
12fa release --check-branch next --check-branch main

sync

同步npm仓库的模块包到cnpm仓库，支持同步多个模块，也可以访问cnpm站点手动同步模块。

查看命令

1# 查看sync命令参数
2npx fa sync -h
3
4Usage: @142vip/fairy-cli sync [options] [packageNames...]
5
6同步npm仓库的模块包到cnpm仓库
7
8Arguments:
9  packageNames  需要同步的模块包名称，支持多个。例如： @142vip/fairy-cli
10
11Options:
12  -h, --help    display help for command

使用示例

1# 同步@142vip/fairy-cli
2fa sync @142vip/fairy-cli
3
4# 同步多个
5fa sync @142vip/fairy-cli @142vip/release-version

clean

查看命令

1# 查看clean命令参数
2npx fa clean -h
3
4Usage: @142vip/fairy-cli clean [options]
5
6清除开发、构建等环境下的无用目录
7
8Options:
9  -n,--nuxt      删除nuxt构建目录，包括.nuxt、.output目录 (default: false)
10  -d,--dist      删除dist目录 (default: false)
11  -m,--midway    删除midway构建目录 (default: false)
12  --turbo        删除turbo缓存目录 (default: false)
13  --vite         删除vite缓存目录 (default: false)
14  --deps         删除node_modules目录 (default: false)
15  --coverage     删除coverage目录 (default: false)
16  -f,--force     强制删除，默认值：false (default: false)
17  --all          深度删除所有 (default: false)
18  --ignore-tips  忽略提示，直接删除 (default: false)
19  --dry-run      试运行，不做实际删除操作 (default: false)
20  -h, --help     display help for command
21

使用示例

1# 删除node_modules依赖
2npx fa clean -n  -d -m --turbo --vite --ignore-tips --all
3
4# 删除dist等目录
5npx fa clean --deps --ignore-tips --all

相关

• del
• turbo
• @142vip/changelog
• @142vip/commit-linter
• @142vip/release-version
• @142vip/utils

证书

MIT

Copyright (c) 2019-present, 142vip 储凡