# 故障排查

minicut 命令打印的信息、每条的意思，以及该怎么做。退出码见全局选项。

在第一列里找你看到的那条信息。大写的文字，例如 `PATH`，代表会变的值。每个退出码的含义都在[全局选项](/zh-cn/docs/cli/global-options)里。

| 你看到的 | 退出码 | 原因 | 怎么做 |
|---|---|---|---|
| `You are not signed in. Ask your agent to run minicut login.` | 10 | 这台电脑没有登录 | 运行 `minicut login`。电脑上没有浏览器时，见[没有浏览器时登录](/zh-cn/docs/cli/sign-in-without-a-browser) |
| `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](/zh-cn/docs/cli/use-minicut-in-china-mainland) |
| `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`，再运行同一条命令。见[更新和卸载](/zh-cn/docs/cli/update-and-uninstall) |
| `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 | 安装缺了一个文件 | 再运行一次安装那一行。见[在终端安装](/zh-cn/docs/cli/install-in-a-terminal) |
| `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 | 命令因为没有预料到的错误停下 | 再运行一次命令。再失败的话，带上这一行联系我们 |