文档 / CLI 参考

全局选项

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

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

选项

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

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

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

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

Terminal

minicut me --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 修改

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