用 Cursor 写代码越久，C 盘越慌。

有一天我用磁盘分析工具扫了一眼，发现：

C:\Users\...\AppData\Roaming\Cursor居然将近 20GB。

第一反应：是不是缓存炸了？项目索引？扩展？

点进去一看，真正的大头其实是这些：

结论很明确：

不是项目文件占空间，是 Cursor 自己把聊天和 Agent 历史越堆越多。

几个月前的对话，对我来说基本没用，但它一直躺在 SSD 里。

官方设置里又没有「只保留最近 90 天」这种开关。于是我写了个小工具。

工具介绍：cursor-clean

cursor-clean是一个轻量 Python 命令行工具：

• 扫描 Cursor Roaming 目录，告诉你哪些能删
• 默认只保留最近90 天聊天（可改）
• 旧的cursor-agent版本只留最新一份
• 不删state.vscdb.backup（备份保留）
• 零第三方依赖，不建自己的数据库
• 支持中文 / 英文界面
• 先扫描、再确认，避免误删

PyPI：https://pypi.org/project/cursor-clean/

（开源仓库：把你的 GitHub 地址贴这里）

一分钟上手

环境：Windows + Python 3.9+

pipinstall-Ucursor-clean

重要：清理前先完全退出 Cursor
（任务管理器里确认没有Cursor.exe，否则压缩数据库可能卡住。）

# 先看能清什么（可选手动选中文）cursor-clean scan--langzh# 确认后清理cursor-clean clean--langzh

常用参数：

# 只保留 60 天cursor-clean clean--langzh --keep-days60# 非交互一键清cursor-clean clean-y--langzh# 只删旧 agent 版本 / 只压缩数据库cursor-clean clean-agents-y--langzh cursor-clean vacuum--langzh

为什么做成开源 pip 包？

• 希望装完就能用：pip install cursor-clean
• 逻辑简单，方便审计：就是扫目录 + 改 Cursor 自己的state.vscdb+ 删旧文件夹
• 不想引入一堆依赖，也不想再搞一个「清理工具自己的数据库」

技术栈很朴素：Python 标准库。

写在最后

Cursor 很强，但本地状态也会悄悄长大。

如果你也发现 Roaming\Cursor 动辄十几 GB：

1. 先scan看清楚
2. 退出 Cursor
3. 再clean

腾出的往往不是几百 MB，而是数 GB。

安装：

pipinstall-Ucursor-clean

项目页：

• PyPI：https://pypi.org/project/cursor-clean/
• GitHub：https://github.com/TIZZYONE/cursor-clean.git

#Cursor #Python #磁盘清理 #开发者工具 #开源