# 在中国大陆使用 MiniCut

用中国大陆地区安装 MiniCut，从镜像站下载工具，设置代理，并把 MiniCut 切换成中文。

MiniCut 有一个设置管地区，就是 `settings.json` 里的 `region`，值是 `global` 或 `cn`。地区决定安装、`minicut update` 和 `minicut setup` 用哪些下载站点。代理和语言是另外两个你可以自己改的设置。

## 用 cn 地区安装

1. 运行安装命令，加上 `--region cn`。在 Windows 上用 `-Region cn`。命令在[在终端安装](/zh-cn/docs/cli/install-in-a-terminal)里。
2. 如果你不指定地区，安装会给两个下载站点各计时，每个最多 5 秒，然后用更快的那个。

安装会保存地区。`minicut update` 和 `minicut setup` 从 `settings.json` 里读它，所以你不用重复写。

## 从镜像站下载工具

保存了 cn 地区之后，`minicut setup` 会打印 `region: cn (settings.json), so every host uses its mirror, as with --china`，每个下载都用镜像站。在其他地区，加 `--china` 可以得到同样的效果。

```bash Terminal
minicut setup --china
```

没有这个选项也没有 cn 地区时，setup 会先给每个下载站点计时。4 秒内没有回应的站点，它就改用镜像站。

想先看每个下载、它的来源和大小，加 `--dry-run`。它什么都不下载，也什么都不写。

```bash Terminal
minicut setup --china --dry-run
```

Setup 不带 Python 3.12 或 ffmpeg。缺其中一个时，setup 会打印一行以 `MISSING:` 开头的信息，带着你所在地区的下载站点，然后以退出码 4 结束。装好它，再运行一次 `minicut setup`。

用了 `--china` 时，来自 GitHub 的文件会经过一个第三方代理，MiniCut 在使用每个文件之前先核对它的 SHA256。

## 设置代理

1. 保存代理。之后每条 `minicut` 命令和 MiniCut 应用都会用它。

```bash Terminal
minicut network --proxy http://192.0.2.10:7890
```

```text Output
Proxy saved: http://192.0.2.10:7890
```

2. 检查保存了什么。

```bash Terminal
minicut network
```

```text Output
Proxy: http://192.0.2.10:7890
```

3. 不想再用时，把它去掉。

```bash Terminal
minicut network --direct
```

```text Output
No proxy: every command connects directly.
```

如果你的代理需要登录，把登录信息写在地址里：`http://USER:PASSWORD@HOST:PORT`。MiniCut 把地址和用户名保存在 `settings.json` 里。密码保存在密钥库里，从不放进文件。

如果安装 MiniCut 时设置了 `HTTPS_PROXY`，安装会替你保存这个代理。你在 shell 里通过 `HTTPS_PROXY`、`HTTP_PROXY` 或 `NO_PROXY` 设的代理会原样使用。只有没有设置 `HTTPS_PROXY` 时，才会用保存的代理。对你自己电脑上的 MiniCut 应用的调用（`127.0.0.1` 和 `localhost`）不走代理。

如果保存的代理拒绝连接，命令会直接连接一次，并在 stderr 上打印下面这一行。运行它指出的命令，就不再使用这个代理。

```text Message
代理 HOST 连不上，已直接连接；运行 minicut network --direct 可以不再用它
```

不是 `http://HOST:PORT` 的地址会打印 `Invalid URL` 或 `a proxy is http://host:port, got` 和你输入的内容，以退出码 5 结束。

## 切换语言

在你选语言之前，MiniCut 应用默认打开中文。`minicut lang` 显示当前语言，`minicut lang en` 切换成英文。已打开的应用几秒内就会跟上这个改动。

```bash Terminal
minicut lang en
```

```text Output
English (ui_language en)
```

```bash Terminal
minicut lang zh
```

```text Output
中文 (ui_language zh)
```

其他任何值都会打印 `Usage: minicut lang [zh|en] [--json]`，以退出码 2 结束。

`minicut login --lang zh` 保存同一个设置，并用中文打开登录页面。不加 `--lang` 而且没有保存过语言时，登录页面用英文打开。

## 连接 minicut.ai

登录、你的账号，以及每条生成图片、配音或视频的命令，都要经过 minicut.ai。如果命令连不上它，会以退出码 7 结束。登录过的电脑可以离线继续工作 7 天，每条命令会在 stderr 上打印一行 `Offline:`。见[账号](/zh-cn/docs/cli/account)。

## 下一步

[在终端安装](/zh-cn/docs/cli/install-in-a-terminal) [初始设置](/zh-cn/docs/cli/setup) [故障排查](/zh-cn/docs/cli/troubleshooting)
