初始设置

打开 MiniCut 应用、检查并安装 MiniCut 需要的工具、连接你的 Agent 应用，以及更新或移除 MiniCut 的命令。

本页的每条命令都不用登录就能运行。每条命令都接受的选项和所有退出码，见全局选项。

MiniCut 主文件夹在 macOS 和 Linux 上是 ~/.minicut，在 Windows 上是 %LOCALAPPDATA%\minicut。设置 MINICUT_HOME 可以改用别的文件夹。

minicut

在浏览器里打开 MiniCut 应用，应用没在运行就先启动它。

Usage

minicut

说明

MiniCut 应用在你的电脑上运行，地址是 http://127.0.0.1:7311/，或者 MINICUT_PORT 里的端口。应用没在运行时，minicut 通过登录项启动它。登录项会在你登录电脑时启动应用。命令最多等应用 10 秒，然后打印地址并打开它。

如果已经有一个应用页面开着，它只打印地址，不再开第二个标签页。在 Agent 的沙盒里，命令连不上应用，它会打印地址，由你自己打开。

输出

minicut open

在 MiniCut 应用里打开一个项目的某一集，停在你指定的标签页，并打印这个地址。

Usage

minicut open PROJECT [--episode EPISODE] [--tab {editor|script|shots|checks|assets}] [--no-open]

替换下面的内容：

• PROJECT：minicut new 给出的项目 id。
• EPISODE：集的 id，例如 ep01。

说明

minicut open 像 minicut 一样启动应用，然后在你指定的集和标签页打开项目。即使已经有别的应用页面开着，指向项目标签页的链接也会打开。

选项

示例

打开第一集的剪辑

minicut open snow-bus

在没有这个 id 的项目的电脑上：

No project snow-bus in ~/.minicut/projects.

用不合法的项目 id 打开

minicut open "Snow Bus"

Not a project id: Snow Bus. Use the id from minicut new (letters, digits and -).

输出

应用打开了或打印了地址时，退出码 0。项目、集或标签页不对，或者应用没有启动时，退出码 2。没有 PROJECT 时，它打印用法行，并以退出码 2 结束。

minicut doctor

显示你的系统、MiniCut 主文件夹、可用磁盘空间，以及 MiniCut 用的每个工具和它的状态、版本。

Usage

minicut doctor

说明

minicut doctor 只读取你的电脑，什么都不改，也从不下载任何东西。它打印：

1. 你的系统和工具文件夹。
2. 它找到的 Node 和 Python 版本。
3. 可用磁盘空间，和 setup 需要的 5 GB 对比。
4. MiniCut 主文件夹里的每个文件夹，以及它是否存在。
5. 一张工具表，列是 Tool、State、Version 和 Where。
6. 缺了多少个工具，以及下一步要运行的命令。

退出码是 0，缺工具时也是。

minicut setup

建好 MiniCut 主文件夹，然后安装它缺的工具。

Usage

minicut setup [--china] [--dry-run] [--local-speech] [--no-tools]

说明

minicut setup 建好主文件夹，里面有 settings.json 和 library、projects、tools、cache 文件夹。然后把每个缺的工具下载到 tools 文件夹。已经装好的工具会跳过。

setup 需要 5 GB 可用磁盘。不加 --china 时，它先给每个下载站计时，站点 4 秒内没有回应就改用它的镜像站。加上 --china，所有下载都用镜像站。如果安装时存的是中国大陆地区，setup 不加这个选项也用镜像站。

setup 不带 Python 3.12 和 ffmpeg。缺其中一个时，它打印一行以 MISSING: 开头的信息，带上你所在地区的官方下载网站。它做完其他所有步骤，然后以退出码 4 结束。装好缺的那个，再运行一次 minicut setup。

同一时间只运行一个 setup。第二个会等待，然后跳过第一个已经装好的。setup 以 Done. Run: minicut doctor 结束。

选项

示例

看 setup 会下载什么

minicut setup --dry-run

最后会打印已知下载的总大小，和 Dry run: nothing downloaded, nothing written.

在中国大陆安装工具

minicut setup --china

输出

minicut update

在你现有的版本旁边，安装最新的 MiniCut 版本。

Usage

minicut update

说明

minicut update 按安装时保存的地区下载最新版本，装在当前版本旁边。MiniCut 应用会用新文件重启。已经在运行的命令会用旧文件跑完。

MiniCut 也会自己检查更新，最多每天一次，由一个没有命令会等它的单独程序来做。应用页面在使用时，它从不更新。更新之后，下一条命令会在 stderr 上打印一行。要关闭自动更新，见全局选项。

输出

更新一边运行一边打印进度。完成时退出码 0。如果另一个更新正在运行，它打印下面这一行，并以退出码 75 结束：

Another Minicut update is running on this computer. Run minicut update again when it has finished.

minicut network

保存一个每条命令和 MiniCut 应用都使用的代理，或者把它删掉。

Usage

minicut network [--proxy URL | --direct] [--json]

替换下面的内容：

• URL：代理地址，格式是 http://HOST:PORT。

说明

minicut network --proxy 把代理存进 settings.json。地址里的密码放进密钥存储，不放进这个文件。--direct 删除代理。不加选项时，它显示已保存的代理。如果安装 MiniCut 时设了 HTTPS_PROXY，安装会替你保存那个代理。

选项

示例

保存代理

minicut network --proxy http://192.0.2.10:8080

Proxy saved: http://192.0.2.10:8080

显示已保存的代理

minicut network

Proxy: http://192.0.2.10:8080

删除代理

minicut network --direct

No proxy: every command connects directly.

输出

加上 --json 且没有其他选项时，它打印 {"proxy":null} 或已保存的地址。退出码 0；地址不是 http://HOST:PORT 的格式时是 5：

a proxy is http://host:port, got ftp://x

minicut uninstall

让这台电脑退出登录，停止 MiniCut 应用，并移除 MiniCut。你的项目和素材库会留下。

Usage

minicut uninstall [--all] [--json]

说明

minicut uninstall 按顺序做这些步骤：

1. 在 minicut.ai 上让这台电脑退出登录，并删除它的密钥。
2. 停止 MiniCut 应用，并移除登录项，这样就没有东西会再启动它。
3. 从每个 Agent 应用里移除 MiniCut 技能文件夹，以及 Claude Code 和 Codex 里的 MiniCut 钩子。其他技能和钩子保持不变。
4. 从你的 shell 配置文件里移除 minicut，在 Windows 上是从你的 Path 里移除。
5. 从 MiniCut 主文件夹里移除工具和应用。

它保留 projects、library、canvas 和 settings.json。加上 --all，这些也一起移除。它只移除 MiniCut 自己做出来的文件，并告诉你留下了多少个别的文件。

选项

输出

它为做过的每一步打印一行。加上 --json：

{"state": "uninstalled", "revoked": true, "kept": ["projects", "library", "canvas", "settings.json"], "home": "~/.minicut"}

加上 --all 时，kept 是 []。退出码：

minicut install-skill

把 MiniCut 技能包复制到某个 Agent 应用的技能文件夹，让你的编程 Agent 知道怎么运行 MiniCut。

Usage

minicut install-skill --app APP [--force]
minicut install-skill --all-found [--force]
minicut install-skill --status [--json]

替换下面的内容：

• APP：下表里的 Agent 应用 id。

说明

技能包放在应用技能文件夹里一个叫 miniharness-short-drama 的文件夹中。对 Claude Code 和 Codex，它还会把 MiniCut 的环节钩子加进应用的设置。如果 Agent 应用开着，请重启它，让它加载这个技能。

不加任何选项时，命令列出各个应用和它们的文件夹，并以退出码 2 结束。

选项

示例

给 Claude Code 安装技能

minicut install-skill --app claude-code

Claude Code: copied the skill pack to ~/.claude/skills/miniharness-short-drama
Claude Code: added the loop hooks (Stop, PreToolUse) to ~/.claude/settings.json

显示哪些应用有这个技能

minicut install-skill --status

Claude Code: installed, ~/.claude/skills/miniharness-short-drama
Codex: not installed. Run: minicut install-skill --app codex

输出

技能装好了，或者状态打印出来了，退出码 0。下面这些情况退出码 2：

minicut agent-rules

写下规则，让 Claude Code 或 Codex 可以运行 minicut 命令，其中要花钱或要移除东西的命令会先问你。

Usage

minicut agent-rules [--app {claude-code|codex}] [--dry-run] [--json]

说明

对 Claude Code，minicut agent-rules 把规则加进 ~/.claude/settings.json。对 Codex，加进 ~/.codex/rules/default.rules。不加 --app 时，这两个应用中在这台电脑上的每一个它都会写。每条规则都写明这台电脑上 minicut 启动器的完整路径。已经有的规则不会重复添加，其他所有规则保持不变。

规则写好后重启 Codex，让它读到这些规则。

选项

示例

看 Claude Code 的规则

minicut agent-rules --app claude-code --dry-run

Claude Code: would add to ~/.claude/settings.json:
  permissions.allow: Bash(~/.minicut/bin/minicut *)
  permissions.ask: Bash(~/.minicut/bin/minicut uninstall*)
  permissions.ask: Bash(~/.minicut/bin/minicut * --yes*)
  sandbox.excludedCommands: ~/.minicut/bin/minicut *

输出

规则写好了，或者本来就有，退出码 0。这台电脑上两个应用都没有，或者设置文件不是合法的 JSON 时，退出码 2。后一种情况下，命令会打印要你手动添加的规则。两个应用都没有时，它打印：

No Claude Code (~/.claude) or Codex (~/.codex) on this computer. Nothing written.

另见