Skip to content

congwa/Cursor-Analysis

Repository files navigation

Cursor Analysis

由于手动删除cursor的本地数据库sql文件内容,会导致cursor变得卡顿,无法分析到具体原因,本项目不再维护。 本项目现提供功能仅当分析cursor本地数据库信息使用。当一个分析工具,后续有需要会加一个导出excel功能。

macOS 专属的 Cursor IDE 使用分析工具

产品概述

Cursor Analysis 是一款专为 macOS 用户打造的桌面应用程序,用于深度分析 Cursor IDE 的使用情况。通过解析 Cursor 本地存储的 SQLite 数据库,为开发者提供全面的使用洞察,包括项目统计、代码贡献、会话管理和存储优化建议。

核心价值

  • 数据可视化:将 Cursor 的使用数据转化为直观的图表和统计信息
  • 项目追踪:了解在各个项目上的 AI 辅助编码投入
  • 存储管理:识别占用空间的数据,提供清理建议
  • 会话管理:支持查看、搜索、排序和批量删除历史会话

页面功能详解

📊 概览页面(Overview)

首页仪表盘,一览 Cursor 使用全貌。

统计卡片 说明
项目数量 使用 Cursor 的项目总数
聊天会话 AI 对话总次数
添加代码 AI 辅助添加的总代码行数
删除代码 AI 辅助删除的总代码行数
净增代码 添加行数 - 删除行数
总存储 Cursor 数据占用的磁盘空间

可视化图表

  • 模式使用分布:饼图展示 Agent 模式 vs Chat 模式的使用占比
  • 项目代码贡献 Top 10:柱状图展示代码贡献最多的 10 个项目

💾 存储页面(Storage)

深入分析 Cursor 的磁盘占用情况。

存储目录 说明
globalStorage 扩展数据、状态数据库
History 文件编辑历史记录
workspaceStorage 各工作区的独立数据

清理建议

  • state.vscdb.backup - 备份文件,可安全删除
  • History - 可删除超过 30 天的历史
  • state.vscdb - 主数据库,包含所有对话历史

📁 项目页面(Projects)

按项目维度查看 AI 编码统计。

功能特性

功能 说明
项目列表 显示所有使用过 Cursor 的项目
排序方式 按添加代码量/删除代码量/会话数量/变更文件数/名称排序
分页浏览 每页 20 个项目,支持翻页
展开详情 点击项目查看该项目下的所有会话
删除项目 删除某个项目的全部会话记录(二次确认)

展开后的会话列表

  • 搜索过滤:按名称/描述搜索
  • 模式过滤:Agent / Chat / 全部
  • 状态过滤:活跃 / 已归档 / 全部
  • 隐藏无修改:默认隐藏无代码变更的会话
  • 多维度排序:变更文件数/添加行数/删除行数/净增行数/更新时间/创建时间/上下文使用/名称
  • 批量选择:本页全选、全部选择
  • 批量删除:选中多个会话后一键删除

🗂️ 工作区页面(Workspaces)

从工作区视角查看数据,特别适合多项目工作区用户。

功能 说明
工作区类型 区分单项目/多项目工作区
包含项目 展示工作区内的所有项目路径
代码统计 显示添加/删除行数和会话数
会话管理 支持与项目页面相同的完整会话管理功能
整体删除 删除工作区的所有会话(二次确认)

🗄️ 数据库页面(Database)

技术视角的底层数据分析。

数据类别 说明
ItemTable VS Code 兼容的键值存储
cursorDiskKV Cursor 专用存储
bubbleId 每条对话消息
checkpointId Agent 模式检查点
agentKv Agent 运行时数据
composerData Composer 会话数据

可视化:饼图展示各类数据占用比例


🗑️ 垃圾桶页面(Trash)

已删除会话的回收站,防止误删。

功能 说明
删除记录 显示所有已删除的会话
删除时间 记录每条会话的删除时间
原始信息 保留会话名称、项目路径、代码统计
永久删除 单条永久删除
清空垃圾桶 批量清空所有记录(二次确认)

会话详情弹窗

点击任意会话卡片,打开详情弹窗查看完整信息:

信息 说明
会话名称 自动生成或用户命名
模式类型 Agent 或 Chat
归档状态 是否已归档
创建/更新时间 会话的时间线
所属分支 创建时的 Git 分支
上下文使用 Token 使用百分比
代码统计 添加行/删除行/变更文件/净增行
会话描述 AI 生成的摘要
会话 ID UUID 标识符

技术架构

┌─────────────────────────────────────────────────────────┐
│                    Cursor Analysis                       │
├─────────────────────────────────────────────────────────┤
│  Frontend (React + TypeScript)                          │
│  ├── recharts - 数据可视化                              │
│  ├── lucide-react - 图标库                              │
│  └── Vite - 构建工具                                    │
├─────────────────────────────────────────────────────────┤
│  Backend (Rust + Tauri)                                 │
│  ├── rusqlite - SQLite 数据库操作                       │
│  ├── serde - 序列化/反序列化                            │
│  ├── walkdir - 目录遍历                                 │
│  └── chrono - 时间处理                                  │
├─────────────────────────────────────────────────────────┤
│  Data Sources                                           │
│  ├── ~/Library/Application Support/Cursor/User/         │
│  │   ├── globalStorage/state.vscdb (主数据库)           │
│  │   ├── workspaceStorage/*/state.vscdb (工作区数据)    │
│  │   └── cursor-analysis-trash.db (垃圾桶)              │
│  └── ~/Library/Application Support/Cursor/Workspaces/   │
└─────────────────────────────────────────────────────────┘

系统要求

项目 要求
操作系统 macOS 10.15+
架构 Apple Silicon (ARM) / Intel (x86_64)
依赖 需已安装 Cursor IDE

开发命令

# 开发模式
pnpm dev          # 启动 Vite 开发服务器
pnpm tauri dev    # 启动 Tauri 开发环境

# 构建发布
pnpm build        # 构建前端
pnpm tauri build  # 构建完整应用

# 版本管理
pnpm run bump:patch   # 补丁版本升级 1.0.0 → 1.0.1
pnpm run bump:minor   # 次要版本升级 1.0.0 → 1.1.0
pnpm run bump:major   # 主要版本升级 1.0.0 → 2.0.0
pnpm run release      # 自动升级版本并构建 Universal Binary

仓库地址


📸 图片显示说明

本项目统一使用本地图片引用,确保在所有平台正常显示:

� 图片配置

  • GitHub: 使用本地图片引用
  • Gitee: 使用本地图片引用
  • 本地开发: 使用本地图片引用

🛠️ 手动切换(如需要)

# 快速切换(推荐)
./quick-switch.sh

# 或手动指定平台
./scripts/image-processor.sh github  # GitHub 模式(本地图片)
./scripts/image-processor.sh gitee   # Gitee 模式(本地图片)

详细说明请参考:scripts/README-image-processor.md



有帮助请给个 star


许可证

MIT License

About

Cursor Analysis 是一款专为 macOS 用户打造的桌面应用程序,用于深度分析 Cursor IDE 的使用情况。通过解析 Cursor 本地存储的 SQLite 数据库,为开发者提供全面的使用洞察,包括项目统计、代码贡献、会话管理和存储优化建议。

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors