Cursor Chat Browser：浏览和管理 Cursor AI 聊天历史

访问：

• 打开浏览器访问：http://localhost:3000

配置：

应用会自动检测 Cursor 工作区存储路径：

• Windows: %APPDATA%\Cursor\User\workspaceStorage
• WSL2: /mnt/c/Users/<USERNAME>/AppData/Roaming/Cursor/User/workspaceStorage
• macOS: ~/Library/Application Support/Cursor/User/workspaceStorage
• Linux: ~/.config/Cursor/User/workspaceStorage
• Linux (remote/SSH): ~/.cursor-server/data/User/workspaceStorage

如果自动检测失败，可以在配置页面（⚙️）手动设置路径。

注意：新版本的 Cursor 已将聊天数据存储从工作区特定位置移动到全局存储。此应用现在支持两种存储方法，以确保与所有 Cursor 版本兼容。

核心特性

1. 浏览功能

   • 查看所有工作区的聊天历史
   • 按工作区组织聊天记录
   • 浏览 AI 聊天日志和 Composer 日志
   • 在工作区内的不同聊天标签之间导航
   • 查看带类型指示器的合并日志
   • 显示每个工作区的聊天和 Composer 数量

2. 搜索功能

   • 在导航栏中使用搜索栏搜索所有日志
   • 按聊天日志、Composer 日志或两者过滤结果
   • 搜索结果显示：
     • 类型徽章（Chat/Composer）
     • 匹配的文本片段
     • 工作区位置
     • 标题
     • 时间戳

3. 导出功能

   • Markdown：纯文本格式，带代码块
   • HTML：带语法高亮的样式文档
   • PDF：适合分享的格式化文档

4. 多存储支持

   • 支持工作区特定存储（旧版本）
   • 支持全局存储（新版本 Cursor）
   • 自动检测存储位置
   • 兼容所有 Cursor 版本

5. 双重日志支持

   • AI 聊天日志
   • Composer 日志
   • 类型区分和过滤
   • 合并视图

6. 用户体验

   • 响应式设计
   • 深色/浅色模式支持
   • 语法高亮的代码块
   • 可收藏的聊天 URL
   • 自动工作区路径检测

项目详细剖析

架构设计

Cursor Chat Browser 采用 Next.js 14 App Router 架构，使用 TypeScript 开发，通过 SQLite 读取 Cursor 的聊天数据库。

核心组件：

Cursor Chat Browser
├── Next.js 14 (App Router)
│   ├── 页面路由
│   ├── 服务端组件
│   └── 客户端组件
├── SQLite 数据库读取
│   ├── 读取 state.vscdb 文件
│   ├── 解析聊天记录
│   └── 解析 Composer 日志
├── UI 组件 (shadcn/ui)
│   ├── 导航栏
│   ├── 搜索栏
│   ├── 聊天列表
│   └── 导出功能
└── 样式系统 (Tailwind CSS)
    ├── 响应式设计
    └── 深色/浅色模式

设计理念：

1. 简单易用：Web 界面，无需复杂配置
2. 自动检测：自动检测 Cursor 存储路径
3. 兼容性：支持新旧版本的 Cursor 存储格式
4. 响应式：支持桌面和移动端
5. 可扩展：基于 Next.js，易于扩展功能

Cursor 存储机制

Cursor 编辑器将聊天历史存储在 SQLite 数据库中（state.vscdb 文件）。

存储位置：

• Windows: %APPDATA%\Cursor\User\workspaceStorage\<workspace-id>\state.vscdb
• macOS: ~/Library/Application Support/Cursor/User/workspaceStorage/<workspace-id>/state.vscdb
• Linux: ~/.config/Cursor/User/workspaceStorage/<workspace-id>/state.vscdb

新版本变化：

• 旧版本：每个工作区有独立的 state.vscdb 文件
• 新版本（v44.9+）：使用全局存储，聊天数据集中管理

数据库结构：

-- 简化的数据库结构
CREATE TABLE ItemTable (
    key TEXT PRIMARY KEY,
    value TEXT -- JSON 格式的聊天数据
);

路径自动检测

应用会自动检测不同平台的 Cursor 存储路径：

检测逻辑：

// 伪代码示例
function detectCursorPath(): string {
    const platform = process.platform;
    switch (platform) {
        case 'win32':
            return path.join(process.env.APPDATA, 'Cursor/User/workspaceStorage');
        case 'darwin':
            return path.join(os.homedir(), 'Library/Application Support/Cursor/User/workspaceStorage');
        case 'linux':
            // 检查是否是 WSL2
            if (isWSL2()) {
                return `/mnt/c/Users/${username}/AppData/Roaming/Cursor/User/workspaceStorage`;
            }
            return path.join(os.homedir(), '.config/Cursor/User/workspaceStorage');
        default:
            throw new Error('Unsupported platform');
    }
}

手动配置：

如果自动检测失败，用户可以在配置页面手动设置路径：

1. 点击配置图标（⚙️）
2. 输入 Cursor 工作区存储路径
3. 保存配置

搜索功能实现

搜索功能支持全文搜索和类型过滤：

搜索流程：

1. 用户输入搜索关键词
2. 扫描所有工作区的 state.vscdb 文件
3. 解析聊天记录和 Composer 日志
4. 全文搜索匹配内容
5. 按类型过滤（Chat/Composer/All）
6. 显示搜索结果

搜索结果展示：

• 类型徽章（Chat/Composer）
• 匹配的文本片段（高亮显示）
• 工作区位置
• 标题
• 时间戳

导出功能

支持三种导出格式：

Markdown 导出：

# Chat Title
## User
用户消息内容
## Assistant
AI 回复内容
```code
代码块内容

**HTML 导出**：

- 带样式的 HTML 文档
- 代码块语法高亮（使用 highlight.js 或类似库）
- 响应式设计
- 可打印格式

**PDF 导出**：

- 使用浏览器打印功能或 PDF 库
- 格式化文档
- 适合分享和存档

**导出实现**：

```typescript
// 伪代码示例
async function exportChat(chatId: string, format: 'md' | 'html' | 'pdf') {
    const chat = await loadChat(chatId);
    switch (format) {
        case 'md':
            return exportAsMarkdown(chat);
        case 'html':
            return exportAsHTML(chat);
        case 'pdf':
            return exportAsPDF(chat);
    }
}

技术栈详解

Next.js 14 App Router：

• 使用最新的 App Router 架构
• 服务端组件和客户端组件混合使用
• 文件系统路由
• 服务端数据获取

TypeScript：

• 类型安全
• 更好的开发体验
• 代码提示和错误检查

Tailwind CSS：

• 实用优先的 CSS 框架
• 快速开发
• 响应式设计
• 深色模式支持

shadcn/ui：

• 基于 Radix UI 的组件库
• 可访问性支持
• 可定制样式
• 组件丰富

SQLite：

• 使用 better-sqlite3 或类似库读取数据库
• 轻量级，无需额外服务
• 直接读取 Cursor 的数据库文件

兼容性处理

项目需要处理新旧版本的 Cursor 存储格式差异：

旧版本（工作区特定存储）：

workspaceStorage/
├── workspace-id-1/
│   └── state.vscdb
├── workspace-id-2/
│   └── state.vscdb
└── ...

新版本（全局存储）：

User/
├── workspaceStorage/
│   └── (旧格式)
└── globalStorage/
    └── (新格式)

兼容策略：

1. 同时检查两种存储位置
2. 优先使用新格式
3. 如果新格式不存在，回退到旧格式
4. 统一数据模型处理两种格式

项目地址与资源

官方资源

• 🌟 GitHub: github.com/thomas-pedersen/cursor-chat-browser
• 🐛 Issue Tracker: GitHub Issues
• 💬 Pull Requests: GitHub PRs