文档 / 资源
故障排查
minicut 命令打印的信息、每条的意思，以及该怎么做。退出码见全局选项。
在第一列里找你看到的那条信息。大写的文字，例如 PATH，代表会变的值。每个退出码的含义都在全局选项里。
| 你看到的 | 退出码 | 原因 | 怎么做 |
|---|---|---|---|
You are not signed in. Ask your agent to run minicut login. | 10 | 这台电脑没有登录 | 运行 minicut login。电脑上没有浏览器时，见没有浏览器时登录 |
This computer was signed out on minicut.ai. | 10 | 登录在 minicut.ai 上被删除了 | 运行 minicut login |
Sign-in was cancelled on minicut.ai. | 10 | 登录在 minicut.ai 上被取消了 | 再运行一次 minicut login，并在 minicut.ai 上确认 |
This sign-in code expired. Run minicut login again. | 10 | 验证码只有 15 分钟有效，或者这台电脑上没有在等的验证码 | 运行 minicut login --device 拿新的验证码，再在同一台电脑上运行 minicut login --complete |
Waiting for you to confirm on minicut.ai. | 0 | 你还没确认验证码 | 确认验证码，再运行一次 minicut login --complete |
Could not reach minicut.ai. 或 minicut.ai did not answer in time. | 7 | 没有网络、代理挡住了，或者网速太慢 | 连上网络，再运行同一条命令。代理的问题见在中国大陆使用 MiniCut |
Could not reach minicut.ai, and this computer's sign-in was last confirmed N days ago. Connect to the internet, then run the same command again. | 7 | 电脑已经离线超过 7 天 | 连上网络，再运行同一条命令 |
Offline: minicut.ai was last reached N days ago. Minicut keeps working offline for M more days. | 不变 | 电脑离线了。这条提示打到 stderr | 在 M 天内连上网络 |
This Minicut is too old. Run minicut update, then the same command again. | 12 | 已安装的版本对这条命令来说太旧 | 运行 minicut update，再运行同一条命令。见更新和卸载 |
Another Minicut update is running on this computer. Run minicut update again when it has finished. | 75 | 已经有一个更新在运行 | 等它结束，再运行 minicut update |
Too many requests. Try again in N seconds. | 8 | 短时间内请求太多 | 等 N 秒，再运行同一条命令 |
Something went wrong on our side. Try again. | 8 | 我们这边出了故障 | 再运行同一条命令。再失败的话，等几分钟。联系我们时请带上 Request id: 那一行 |
This account reached today's limit. It resets at TIME. | 8 | 账号今天的用量到上限了 | TIME 之后再运行命令 |
This model is not available right now. Try again later. | 8 | 模型暂时不接受请求 | 过一会儿再运行同一条命令，或者用 minicut models 选另一个模型 |
Nothing was sent. 加上一行你同意后要运行的命令 | 3 | 命令要用积分。它先显示要做什么，花之前先问你 | 同意的话，运行打印出来的那一行 |
Pick a model. Run minicut models to see them, then pass --model. | 5 | 命令需要一个模型名 | 运行 minicut models，再加上 --model NAME |
No model named NAME. Nothing was sent. The list: minicut models. | 5 | 这个模型名不在列表里 | 用 minicut models 里的名字 |
FIELD on this model is RANGE. You asked for VALUE. | 5 | 这个值超出了模型能接受的范围 | 把值改成 RANGE 之内的 |
Minicut is not fully installed: PATH is missing. Run the install line again. | 2 | 安装缺了一个文件 | 再运行一次安装那一行。见在终端安装 |
the folder FOLDER already holds files that are not Minicut's (FILES), so Minicut will not install into it. Set MINICUT_HOME to a new folder, or empty this one. | 1 | 安装文件夹里有不是 MiniCut 做的文件 | 把 MINICUT_HOME 设成一个新文件夹，或者清空这一个 |
Port 7311 is used by another program. Set MINICUT_PORT to a free port, then run minicut again. | 2 | 另一个程序占用了 MiniCut 应用的端口 | 把 MINICUT_PORT 设成一个空闲端口，再运行 minicut |
The Minicut app did not start. | 2 | MiniCut 应用启动后没有回应 | 运行 minicut doctor，再运行 minicut |
REFUSED: under 5 GB free. Free some space and run again. | 3 | setup 需要 5 GB 可用磁盘 | 腾出磁盘空间，再运行 minicut setup |
MISSING: Python 3.12. Download it from SITE and install it ..., then run minicut setup again. 或 ffmpeg 的同样一行 | 4 | setup 不带 Python 3.12 和 ffmpeg | 从 SITE 安装它，再运行 minicut setup |
FAILED TOOL: REASON | 1 | 某个工具的下载失败了 | 再运行一次 minicut setup。在中国大陆，加上 --china |
以 这一行需要你自己运行： 开头，后面跟一条命令 | 2 | 这个程序写不了那个文件夹，例如在 Agent 的沙盒里 | 在你自己的终端里运行那条命令 |
No project NAME in PATH. | 2 | 文件夹里没有这个 id 的项目 | 用 minicut new 给出的 id |
Not a project id: NAME. Use the id from minicut new (letters, digits and -). | 2 | 项目 id 里有别的字符 | 只用字母、数字和 - |
unknown app "NAME". Apps: 后面跟一个列表 | 2 | --app 给的名字不在列表里 | 用列表里的 id |
PATH already exists. Add --force to copy the pack over it. | 2 | 技能文件夹已经在那里了 | 加上 --force |
a proxy is http://host:port, got VALUE 或 Invalid URL | 5 | 代理地址不对，或者 --proxy 后面没有地址 | 用 http://HOST:PORT 的格式 |
代理 HOST 连不上，已直接连接；运行 minicut network --direct 可以不再用它 | 不变 | 已保存的代理拒绝了连接，所以命令改为直接连接 | 修好代理，或者运行 minicut network --direct 不再使用它 |
FOLDER has no Minicut install marker (minicut-home.json), so it may hold files that are not Minicut's. Nothing was removed. | 1 | 卸载在那个文件夹里没有找到 MiniCut 的安装 | 检查 MINICUT_HOME 指向的是你的 MiniCut 主文件夹 |
minicut: ERROR | 1 | 命令因为没有预料到的错误停下 | 再运行一次命令。再失败的话，带上这一行联系我们 |