更新和卸载
自己更新 MiniCut 或让它自动更新,关掉自动更新,以及连同项目一起或不连项目卸载 MiniCut。
每次更新,MiniCut 都会保留你的项目、素材库、画布和 settings.json。卸载也会保留它们,除非你要求不保留。
更新 MiniCut
- 查看你的版本。
Minicut CLI这一行显示版本。
minicut status- 运行更新。
minicut update- 等它结束。结束时它打印
updated to和新版本。如果你已经是最新版本,它以ready结束。然后它打印Log:和安装日志的路径,以及minicut:和命令的完整路径。
更新会按安装时保存的地区,在你现有的版本旁边装上最新版本。你保持登录。MiniCut 应用会用新文件重启,这会结束已打开的应用页面的会话。已经在运行的命令会在旧文件上跑完。MiniCut 把旧版本多保留一次更新,这样它能退回去。
如果新应用 10 秒内没有启动,MiniCut 会退回你的旧版本,更新以退出码 2 结束。如果缺 Python 3.12 或 ffmpeg,更新照样完成,它会打印一行 MISSING:。装好这个工具,再运行 minicut setup。如果另一个更新正在运行,命令会打印 Another Minicut update is running on this computer. Run minicut update again when it has finished.,以退出码 75 结束。
这条命令在初始设置里有说明。如果别的命令打印 This Minicut is too old. Run minicut update, then the same command again.,先运行更新。这条信息的退出码是 12。
自动更新
自动更新是开着的。任何 minicut 命令都会在后台启动一次检查,没有命令会等它。一次检查一天最多运行一次。第一次检查在安装后第一条命令之后的一天运行。minicut update、minicut uninstall 和 minicut setup 不启动检查。
只有下面几条同时成立时,MiniCut 才会自己更新:
- 最新版本比你的高。MiniCut 从不退回到更低的版本。
- 轮到了你的电脑。新版本是分批推给电脑的。
- 最近 10 分钟内没有用过 MiniCut 应用页面。
如果还没轮到你的电脑,有应用页面正在用,或者检查连不上 minicut.ai,MiniCut 一小时后再试。自动更新之后,你的下一条命令会在 stderr 上打印一行,只打印一次:
Minicut updated to VERSION.关掉自动更新
下面任意一种都可以。之后只有你运行 minicut update 时才会更新。
- 把环境变量
MINICUT_NO_AUTOUPDATE设为1。 - 在你的 MiniCut 主文件夹里的
settings.json中加上"auto_update": false,macOS 和 Linux 上是~/.minicut。文件里的其他键保留。 - 设置
CI。CI设成0或false以外的任何值时,MiniCut 都不会自动更新。
{
"auto_update": false
}想检查,运行 minicut status。它的最后一行显示 auto_update,关着的时候还显示原因。
MINICUT_NO_AUTOUPDATE=1 minicut statusauto_update: {"on":false,"off_because":"MINICUT_NO_AUTOUPDATE is set","last_check":null,"last_result":null,"next_check":null}卸载 MiniCut
- 运行卸载。它什么都不问,马上开始。如果是你的 Agent 运行的,在你运行过
minicut agent-rules之后,Claude Code 和 Codex 会先问你。
minicut uninstall- 想连你的项目、素材库、画布和设置也一起删掉,加
--all。
minicut uninstall --all- 看退出码。0 表示 MiniCut 已移除。7 表示已移除,但 minicut.ai 没有回应。这时这台电脑会一直留在你账号的 设备 页面上,直到你在那里把它移除。
卸载会为它做过的每一步打印一行,比如 signed out、removed the login item 和 removed the tools and the app; kept projects, library, canvas, settings.json。这些步骤列在初始设置的 minicut uninstall 下。
留下的内容
| 项目 | minicut uninstall | minicut uninstall --all |
|---|---|---|
| 这台电脑的登录密钥 | 移除 | 移除 |
| MiniCut 应用、登录项、工具和旧版本 | 移除 | 移除 |
你的 shell 配置里的 minicut 那一行,或 Windows 上你的 Path 里的那一项 | 移除 | 移除 |
| 每个 Agent 应用里的 MiniCut 技能文件夹,以及 Claude Code 和 Codex 里的 MiniCut 钩子 | 移除 | 移除 |
projects、library、canvas 和 settings.json | 保留 | 移除 |
minicut agent-rules 写入的规则 | 保留 | 保留 |
| 其他技能和其他钩子 | 保留 | 保留 |
| 主文件夹里不是 MiniCut 做出来的文件 | 保留,命令会说有几个 | 保留,命令会说有几个 |
| 主文件夹 | 保留 | 移除,但只在它是安装时建的、而且里面没有别的东西时 |
如果主文件夹里没有 minicut-home.json,卸载什么都不改。它会打印 FOLDER has no Minicut install marker (minicut-home.json), so it may hold files that are not Minicut's. Nothing was removed.,以退出码 1 结束。FOLDER 是主文件夹的路径。
想重新安装,运行在终端安装里的安装命令。安装会保留它在主文件夹里找到的 projects、library、canvas 和 settings.json。