# cursor-analysis

**Repository Path**: cong_wa/cursor-analysis

## Basic Information

- **Project Name**: cursor-analysis
- **Description**: Cursor Analysis 是一款专为 macOS 用户打造的桌面应用程序，用于深度分析 Cursor IDE 的使用情况。通过解析 Cursor 本地存储的 SQLite 数据库，为开发者提供全面的使用洞察，包括项目统计、代码贡献、会话管理和存储优化建议
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-09
- **Last Updated**: 2026-02-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cursor Analysis

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

## 产品概述

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

![Cursor界面](cursor.png)
![参考图](image.png)
### 核心价值

- **数据可视化**：将 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 |

---

## 开发命令

```bash
# 开发模式
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**: https://github.com/congwa/Cursor-Analysis
- **Gitee**: https://gitee.com/cong_wa/cursor-analysis.git

---

## 📸 图片显示说明

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

### � 图片配置
- **GitHub**: 使用本地图片引用
- **Gitee**: 使用本地图片引用
- **本地开发**: 使用本地图片引用

### 🛠️ 手动切换（如需要）
```bash
# 快速切换（推荐）
./quick-switch.sh

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

详细说明请参考：[scripts/README-image-processor.md](scripts/README-image-processor.md)

---

## 许可证

MIT License