用 Cursor 写代码越久C 盘越慌。有一天我用磁盘分析工具扫了一眼发现C:\Users\...\AppData\Roaming\Cursor居然将近 20GB。第一反应是不是缓存炸了项目索引扩展点进去一看真正的大头其实是这些内容大约占用是什么state.vscdb~11GB本地状态库聊天、Agent、Composer 历史state.vscdb.backup~4GB上面的备份cursor-agent多版本~2GB历史版本的 Agent CLI 安装包其他缓存/日志少量CachedData、logs 等结论很明确不是项目文件占空间是 Cursor 自己把聊天和 Agent 历史越堆越多。几个月前的对话对我来说基本没用但它一直躺在 SSD 里。官方设置里又没有「只保留最近 90 天」这种开关。于是我写了个小工具。工具介绍cursor-cleancursor-clean是一个轻量 Python 命令行工具扫描 Cursor Roaming 目录告诉你哪些能删默认只保留最近90 天聊天可改旧的cursor-agent版本只留最新一份不删state.vscdb.backup备份保留零第三方依赖不建自己的数据库支持中文 / 英文界面先扫描、再确认避免误删PyPIhttps://pypi.org/project/cursor-clean/开源仓库把你的 GitHub 地址贴这里一分钟上手环境Windows Python 3.9pipinstall-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先scan看清楚退出 Cursor再clean腾出的往往不是几百 MB而是数 GB。安装pipinstall-Ucursor-clean项目页PyPIhttps://pypi.org/project/cursor-clean/GitHubhttps://github.com/TIZZYONE/cursor-clean.git#Cursor #Python #磁盘清理 #开发者工具 #开源