Cursor Chat Browser：管理 AI 聊天历史的 Web 应用

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

技术架构剖析

核心设计

Cursor Chat Browser 采用 Next.js 14 App Router 架构，使用 TypeScript 开发，通过 SQLite 读取 Cursor 的聊天数据库。这种设计既保证了现代 Web 开发的体验，又兼顾了本地文件操作的便捷性。

核心组件结构：

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

存储机制与兼容性

Cursor 编辑器将聊天历史存储在 SQLite 数据库中（state.vscdb 文件）。不同版本的 Cursor 存储位置有所不同，这也是本工具需要处理的关键点。

旧版本（工作区特定存储）： 每个工作区有独立的 state.vscdb 文件。

新版本（v44.9+，全局存储）： 使用全局存储，聊天数据集中管理。

兼容策略：

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

关键逻辑实现

路径自动检测

应用内置了针对不同操作系统的检测逻辑，确保能准确找到数据库文件。

// 伪代码示例：路径检测逻辑
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');
  }
}

搜索与导出

搜索功能支持全文搜索和类型过滤。用户输入关键词后，系统会扫描所有工作区的 state.vscdb 文件，解析聊天记录，匹配内容并展示结果。

导出功能则提供了三种格式选择：

• Markdown：纯文本格式，带代码块，适合阅读和版本控制。
• HTML：带样式的文档，代码块语法高亮，适合打印和存档。
• PDF：格式化文档，适合分享和汇报。

// 伪代码示例：导出逻辑
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);
  }
}

总结

Cursor Chat Browser 是一个小而美的开源工具，它填补了 Cursor 编辑器在历史记录管理上的空白。通过 Next.js + TypeScript + Tailwind CSS 的技术栈，它提供了一个轻量级、跨平台的解决方案。对于需要频繁与 AI 协作、重视知识沉淀的开发者来说，这是一个值得尝试的工具。

项目地址：GitHub - thomas-pedersen/cursor-chat-browser