@qigy/runner

通过简短别名执行复杂命令的 CLI 工具。将常用命令注册为短别名，一键执行。

安装

npm install -g @qigy/runner

使用

所有操作通过 run 命令执行。

执行别名

run <alias> [变量值...]

示例 — 在项目目录下执行 npm install：

run i
# 等价于 npm install

变量替换 — 命令中的 [变量名] 会被后续参数替换：

run add md "mkdir [dirName]"
run md my-project
# 等价于 mkdir my-project

别名管理

run get [?keyword]               # 搜索别名（匹配 alias/command/remark）
run add <alias> <command> [?备注]  # 添加别名
run update <alias> <command> [?备注] # 更新别名
run rename <alias> <newAlias>    # 重命名别名
run del <alias...>               # 删除一个或多个别名

示例：

run get i
# 输出表格：Alias | Command | Remark

run add dev "npm run dev" "启动开发服务器"

run update dev "npm run dev --port 3000"

run del dev old-alias

其他命令

run ui       # 打开 Web 管理界面
run lang      # 切换语言（中英文之间切换）
run lang zh-CN  # 切换到中文
run lang en-US  # 切换到英文
run doc      # 显示帮助信息

配置文件

| 文件 | 说明 | | ------------- | ----------------------------------------------- | | runner.json | 别名定义列表，格式 [{alias, command, remark}] | | config.json | 应用配置，如 {lang: "zh-CN"} |

文件默认存放在 runner 安装目录（全局安装时为 node_modules/@qigy/runner/src/）。

Web UI

run ui 启动内置 Web 管理界面（默认 7000 端口），提供可视化管理：

• 搜索/查看别名列表
• 添加/编辑/删除别名
• 导入或导出别名（JSON 文件）