@ruan-cat/utils CLI
本包提供了命令行工具，通过 package.json 的 bin 字段注册，安装后即可直接调用。
安装
作为 monorepo 内的 workspace 依赖引用：
json
{
"devDependencies": {
"@ruan-cat/utils": "workspace:^"
}
}或者作为 npm 包安装：
bash
pnpm add -D @ruan-cat/utils可用命令
安装后，以下 CLI 命令将自动注册到 node_modules/.bin：
ruan-cat-utils—— 统一入口命令，通过子命令分发执行。move-vercel-output-to-root—— 直接执行搬运 Vercel 构建产物的专用快捷命令。relizy-runner—— relizy 发版兼容层（Windows GNU 工具补齐 + 基线 tag 检查 +changelog --yes兼容吞参）。
通过统一入口调用
bash
npx ruan-cat-utils move-vercel-output-to-root [options]
npx ruan-cat-utils relizy-runner <relizy 子命令与参数>通过快捷命令调用
bash
npx move-vercel-output-to-root [options]
npx relizy-runner release --no-publish --no-provider-release
npx relizy-runner changelog --dry-run --yes两种方式完全等价。
查看帮助
bash
npx ruan-cat-utils --help
npx ruan-cat-utils move-vercel-output-to-root --help
npx ruan-cat-utils relizy-runner --help在 package.json scripts 中使用
由于安装依赖后命令已注册到 .bin，可以直接在 scripts 中以命令名调用：
json
{
"scripts": {
"move-output": "move-vercel-output-to-root --dry-run",
"release": "relizy-runner release --no-publish --no-provider-release"
}
}设计说明
本 CLI 采用标准的 bin 字段方案，而非 tsx <包名> 的方式调用。
原因是 tsx、ts-node、node 等运行时的 CLI 参数只会被解释为文件系统路径，而不会触发 Node.js 的模块解析算法。因此 tsx @ruan-cat/utils/move-vercel-output-to-root 这种写法会报 ERR_MODULE_NOT_FOUND 错误——运行时会在当前工作目录拼接路径去查找文件，而不是去 node_modules 里根据 exports 字段解析模块。
标准的 bin 字段方案通过包管理器（pnpm/npm/yarn）在 node_modules/.bin 中创建可执行链接，完全绕过了这个问题。
relizy-runner 补充说明
release/bump会默认自动补--yes，除非显式传入 runner 专用参数--no-yes。changelog不会自动补--yes。- 若历史脚本或 skill 仍写成
relizy-runner changelog --dry-run --yes，runner 会兼容接受该参数，但不会再把--yes透传给上游relizy。
贡献者
ruan-cat
Cursor