mirror of
https://github.com/Lydanne/spaceflow.git
synced 2026-03-11 19:52:45 +08:00
68 lines
1.5 KiB
Markdown
68 lines
1.5 KiB
Markdown
# runx — 运行命令
|
|
|
|
全局安装并运行 Extension 命令，类似于 `npx`。别名为 `x`。
|
|
|
|
## 基本用法
|
|
|
|
```bash
|
|
# 运行指定 Extension 的命令
|
|
spaceflow x @spaceflow/review --help
|
|
|
|
# 运行本地路径的 Extension
|
|
spaceflow x ./commands/ci-scripts -- --script ./deploy.sh
|
|
|
|
# 使用完整命令名
|
|
spaceflow runx @spaceflow/review -- -p 123
|
|
```
|
|
|
|
## 工作流程
|
|
|
|
1. **全局安装** — 如果 Extension 未全局安装，先执行全局安装
|
|
2. **运行命令** — 执行该 Extension 提供的命令，透传所有参数
|
|
|
|
## 参数传递
|
|
|
|
使用 `--` 分隔 `runx` 自身的选项和传递给 Extension 的参数：
|
|
|
|
```bash
|
|
spaceflow x <source> [runx选项] -- [Extension参数]
|
|
```
|
|
|
|
示例：
|
|
|
|
```bash
|
|
# 传递 --help 给 review 命令
|
|
spaceflow x @spaceflow/review -- --help
|
|
|
|
# 传递 -p 123 给 review 命令
|
|
spaceflow x @spaceflow/review -- -p 123
|
|
|
|
# 指定名称并传递参数
|
|
spaceflow x ./commands/ci-scripts -n ci-scripts -- --script ./test.sh
|
|
```
|
|
|
|
## 与 install 的区别
|
|
|
|
| 特性 | `install` | `runx` |
|
|
|------|-----------|--------|
|
|
| 安装位置 | 本地项目（默认） | 全局 |
|
|
| 持久化 | 写入 `spaceflow.json` | 不修改配置 |
|
|
| 用途 | 长期使用的 Extension | 临时运行 |
|
|
|
|
## 命令行选项
|
|
|
|
| 选项 | 简写 | 说明 |
|
|
|------|------|------|
|
|
| `--name <name>` | `-n` | 自定义 Extension 名称 |
|
|
| `--verbose` | `-v` | 详细日志 |
|
|
|
|
## 示例
|
|
|
|
```bash
|
|
# 临时运行 review
|
|
spaceflow x @spaceflow/review -- -p 42
|
|
|
|
# 临时运行本地 Extension
|
|
spaceflow x ./commands/my-tool -- --config custom.json
|
|
```
|