# 全局选项

每条 minicut 命令都一样的选项、输出格式、退出码和环境变量。

每条 `minicut` 命令都遵守本页的规则。脚本或编程 Agent 可以用同样的方式读任何命令的退出码和 JSON 输出。

## 选项

| 选项 | 类型 | 说明 |
|---|---|---|
| `--json` | 开关 | 在 stdout 上打印一个 JSON 对象，而不是文字。每条在用法行里列出它的命令都能用 |
| `--help`、`-h` | 开关 | 打印每条命令和一行说明，然后以退出码 0 结束。`minicut help` 效果一样 |

MiniCut 不认识的命令名，会打印命令列表并以退出码 2 结束。在没有登录的电脑上，登录检查排在前面，所以以退出码 10 结束。

## 输出

结果打到 stdout。给人看的提示打到 stderr，所以 stdout 始终只有一个干净的结果。stderr 上可能出现两种提示：

- 离线提示：电脑有一阵子没连上 minicut.ai 时出现。见[账号](/zh-cn/docs/cli/account)。
- 自动更新之后，下一条命令会打印一行。

加上 `--json`，每条命令的错误格式都一样：

```bash Terminal
minicut me --json
```

```json Output
{"error":{"code":"signed_out","message":"You are not signed in. Ask your agent to run minicut login.","url":null,"request_id":null}}
```

| 字段 | 说明 |
|---|---|
| `code` | 固定的错误代码。读它来决定怎么做 |
| `message` | 和文字输出打印的是同一句话 |
| `url` | minicut.ai 上能解决这个问题的页面，或 `null` |
| `request_id` | 这次请求的 id，联系我们时报给我们，或 `null` |

不加 `--json` 时，命令打印这句话，然后在有的时候打印网址和 `Request id:`。

如果命令因为没有预料到的错误停下，它打印 `minicut:` 和这个错误，并以退出码 1 结束。

## 退出码

| 退出码 | 含义 | 怎么做 |
|---|---|---|
| 0 | 完成 | 不用做什么 |
| 1 | 检查发现了问题，或者命令因为它打印出来的错误停下 | 读打印出来的几行。每个检查失败都写明了修法 |
| 2 | 命令没法运行：选项写错、缺文件或 id 不对 | 改好命令再运行 |
| 3 | 命令要先得到你的同意才运行。它打印了你同意之后要运行的那一行。什么都没发出去 | 同意的话，运行打印出来的那一行。可用磁盘少于 5 GB 时，`minicut setup` 也用 3 |
| 4 | `minicut setup` 结束了，但缺 Python 3.12 或 ffmpeg | 从 setup 打印的网站安装，再运行一次 setup |
| 5 | 输入超出了命令或模型能接受的范围 | 改掉信息里指出的那个输入 |
| 6 | 还没好：有任务在运行 | 过一会儿再运行同一条命令 |
| 7 | MiniCut 连不上 minicut.ai | 连上网络，再运行同一条命令 |
| 8 | 我们这边出了问题，或者现在请求太多 | 再运行同一条命令。再失败的话，等几分钟 |
| 9 | 你的账号不包含这项功能。信息里有一个 minicut.ai 的链接 | 打开信息里的链接 |
| 10 | 这台电脑没有登录，或者登录被取消、已过期 | 运行 `minicut login` |
| 12 | 这个版本的 MiniCut 太旧 | 运行 `minicut update`，再运行同一条命令 |
| 75 | 另一个 `minicut update` 正在运行 | 等它结束，再运行 `minicut update` |

## 环境变量

| 变量 | 默认值 | 说明 |
|---|---|---|
| `MINICUT_HOME` | `~/.minicut`，Windows 上是 `%LOCALAPPDATA%\minicut` | MiniCut 主文件夹：设置、密钥文件、工具、项目和素材库 |
| `MINICUT_PORT` | `7311` | MiniCut 应用在你电脑上用的端口。另一个程序占了这个端口时设置它 |
| `MINICUT_NO_AUTOUPDATE` | 未设置 | 设为 `1` 可关闭自动更新。`settings.json` 里的 `"auto_update": false` 效果一样 |
| `MINICUT_NO_ERROR_REPORTS` | 未设置 | 设为 `1` 可关闭崩溃报告。`settings.json` 里的 `"error_reports": false` 效果一样 |
| `CI` | 未设置 | 设置后，MiniCut 不自动更新，也不发送崩溃报告 |
| `HTTPS_PROXY` | 未设置 | 安装 MiniCut 时读取。安装会把它存成每条命令用的代理。之后用 [minicut network](/zh-cn/docs/cli/setup#minicut-network) 修改 |

命令崩溃时，MiniCut 会向 minicut.ai 发送一份崩溃报告。报告里没有密钥、没有文件路径、也没有错误信息。

## 另见

[账号](/zh-cn/docs/cli/account) [初始设置](/zh-cn/docs/cli/setup) [快速开始](/zh-cn/docs/cli/quickstart)