文档 / 指南

在中国大陆使用 MiniCut

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

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

用 cn 地区安装

  1. 运行安装命令,加上 --region cn。在 Windows 上用 -Region cn。命令在在终端安装里。
  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 可以得到同样的效果。

Terminal
minicut setup --china

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

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

Terminal
minicut setup --china --dry-run

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

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

设置代理

  1. 保存代理。之后每条 minicut 命令和 MiniCut 应用都会用它。
Terminal
minicut network --proxy http://192.0.2.10:7890
Output
Proxy saved: http://192.0.2.10:7890
  1. 检查保存了什么。
Terminal
minicut network
Output
Proxy: http://192.0.2.10:7890
  1. 不想再用时,把它去掉。
Terminal
minicut network --direct
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 上打印下面这一行。运行它指出的命令,就不再使用这个代理。

Message
代理 HOST 连不上,已直接连接;运行 minicut network --direct 可以不再用它

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

切换语言

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

Terminal
minicut lang en
English (ui_language en)
Output
中文 (ui_language zh)

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

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

连接 minicut.ai

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

下一步