安装、更新与磁盘占用

更新应用、检查启动问题，并用内置命令清理聊天和 worktree。

This page has not been translated into English yet. The original Chinese version is shown below.

启动异常时先完全退出再重开：macOS 用 Cmd+Q，Windows/Linux 也需退出 tray 中的进程。只 reload window 不一定清除旧进程或环境。

更新与频道

命令面板运行 Cursor: Attempt Update，按提示重启。Stable 是默认频道；Early Access 提供预发布版本，可在 Cursor Settings 切换，稳定性可能不同。

macOS 提示 Cursor is damaged 时，官方建议先退出并确认 Activity Monitor 中无残留进程，等待一分钟重开；仍失败再从官方来源重装或重启机器。该提示本身不足以判断下载损坏，先按实际诊断处理。

聊天占用磁盘

Agent 聊天本地数据库通常比扩展更占空间。两条内置命令需要按顺序运行：

Delete Old Chats…，选择保留时间，例如 30 天。
GC Agent KV Blobs，压缩实际数据库文件。

只删除旧记录可能不会缩小文件；大型数据库每步可能需一两分钟。删除会影响保留历史，先确定要留下的时间范围。

Worktree 清理

Agents Window > Settings > Worktrees > Cleanup 可设 Max Worktrees（默认 25）和 Max Total Size (GB)（默认 50，0 关闭体积限制），跨全部工作区计算，并显示每个源仓库的 worktree。

经典编辑器 VS Code Settings 可查 cursor.worktreeMaxCount、cursor.worktreesGlobalMaxSizeGb，以及 cursor.worktreeCleanupIntervalHours（默认 6，仅此设置页提供）。自动清理优先旧 worktree；删除前确认其中工作是否仍需保留。

扩展空间与资源

Show Running Extensions 显示已加载扩展及 CPU/内存。卸载通过经典编辑器 Extensions sidebar，不能从“运行中”列表推断未加载扩展占用为零。性能定位见扩展排查。