Cursor Chat Browser：管理 AI 聊天历史的 Web 工具
在使用 Cursor 编辑器进行 AI 编程时，你是否遇到过这些痛点：想回顾之前的对话却找不到入口？搜索某个技术问题的解决方案无从下手？或者想把聊天记录导出分享给团队却不知道如何操作？
Cursor Chat Browser 是一个开源的 Web 应用，专门用于浏览和管理 Cursor 编辑器的 AI 聊天历史。它支持查看、搜索和导出你的 AI 对话为 Markdown、HTML、PDF 等多种格式，让你轻松管理和回顾与 AI 的对话历史。
核心功能与价值
这个工具主要解决了 Cursor 编辑器本身在历史记录管理上的不足。它的核心价值在于将分散的对话集中化、可检索化。
- 浏览与搜索：可以浏览所有工作区的 Cursor 聊天历史，并支持全文搜索。搜索结果会显示类型徽章（Chat/Composer）、匹配片段、工作区位置和时间戳。
- 多存储兼容：同时支持旧版本的工作区特定存储和新版本的全局存储，自动检测路径，兼容 Windows、macOS、Linux 及 WSL2。
- 双重日志支持：不仅支持 AI 聊天日志，还支持 Composer 日志，并能区分和过滤这两种类型。
- 多格式导出：支持导出为 Markdown（纯文本带代码块）、HTML（带语法高亮）以及 PDF（适合分享），满足备份和文档化的需求。
- 响应式设计：界面支持深色/浅色模式，移动端也能友好访问。
架构与技术栈
项目采用 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)
├── 响应式设计
└── 深色/浅色模式
数据存储机制
Cursor 编辑器将聊天历史存储在 SQLite 数据库中（state.vscdb 文件）。应用会自动扫描这些文件并解析 JSON 格式的聊天数据。
简化的数据库结构：
CREATE TABLE ItemTable (
key TEXT PRIMARY KEY,
value TEXT -- JSON 格式的聊天数据
);
路径自动检测逻辑：
应用内置了针对不同操作系统的检测逻辑，无需手动配置即可找到数据库位置。如果自动检测失败，也可以在设置中手动指定路径。
// 伪代码示例：路径检测逻辑
function detectCursorPath(): string {
const platform = process.platform;
(platform) {
:
path.(process.., );
:
path.(os.(), );
:
(()) {
;
}
path.(os.(), );
:
();
}
}
