@142vip工程化

切换主题

@142vip/fairy-cli ​

NPM version

通用型 CLI 助手、一站式工具，支持多种命令操作

安装 ​

安装后可通过 fa 或 fairy 调用（package.json bin 字段）。

shell
# npm
npm install -D @142vip/fairy-cli

# pnpm
pnpm add -D @142vip/fairy-cli

功能 ​

  • ✅ 子命令通用选项：--dry-run（打印将执行的命令/HTTP 步骤）、--vip（@142vip Monorepo 专用，见 release / sync）
  • ✅ 登录 Docker / npm（login）
  • ✅ 依赖安装（install）
  • ✅ Monorepo 版本发布（release）
  • ✅ CHANGELOG 生成（changelog）
  • ✅ npm 镜像推送（publish）
  • ✅ CNPM 包同步（sync）
  • ✅ 项目部署（deploy）
  • ✅ ESLint 检查与格式化（lint）
  • ✅ 清理构建产物（clean）
  • ✅ 软著源代码文档生成（copyright）
  • ✅ Git Commit 规范提交（commit）
  • ✅ Agent Skills 同步与校验（ai，集成 @142vip/agent-skills）
  • ✅ 编程式 API：fairyCliMain、releasePackage、buildReleaseVersionOptions、printPreCheckRelease

配置 ​

无

使用 ​

查看全部命令：

shell
fa -h

输出示例：

text
Usage: @142vip/fairy-cli [options] [command]

通用型Cli助手、一站式工具，支持多种命令操作

Options:
  -v,--version                    VipCommander Version By @142vip
  -h, --help                      display help for command

Commands:
  login|l [options]               登录平台
  install|i [options]             安装依赖
  release|re [options]            发布新的版本
  changelog|c [options]           生成 CHANGELOG 日志记录
  publish|p [options]             远程镜像推送
  sync|s [options] [packageName]  同步NPM包
  deploy|de [options]             项目部署
  lint|li [options]               根据Eslint检查、格式化代码风格
  clean|cl [options]              快速清理项目
  copyright|cr [options]          软件著作权登记的源代码文档生成
  commit|co [options] [vip]       Git Commit 提交信息
  ai|a [options] [action]         AI Agent Skills 管理
  help [command]                  display help for command

常用示例：

shell
# Monorepo 交互发版（@142vip 组织）
fa release --vip -F './packages/*'

# 试运行：打印将执行的命令/HTTP 步骤，不写盘、不提交
fa release --vip --dry-run
fa sync --vip --dry-run
fa clean --deps --dry-run

# 发布时标记 GitHub Release 为 Pre-release（默认 Latest）
fa release --vip --prerelease

# 同步 Agent Skills 到当前项目
fa ai sync -t .

# 校验下游 skills 是否与包内一致
fa ai check -t .

# 查看 agent-skills 包信息
fa ai info

编程式调用：

ts
import { fairyCliMain, printPreCheckRelease, releasePackage } from '@142vip/fairy-cli'

await fairyCliMain()

升级 ​

shell
# 依赖更新
pnpm upgrade @142vip/fairy-cli

参考 ​

证书 ​

MIT

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

仅供学习参考，商业使用请保留作者版权信息，作者不保证也不承担任何软件的使用风险。