Cursor Chat Browser：管理 AI 聊天历史的 Web 应用
在使用 Cursor 进行 AI 编程时，我们常遇到这样的困扰：想回顾之前的对话却找不到入口，想搜索某个技术问题的解决方案无从下手，或者想导出聊天记录分享给团队却不知道如何操作。Cursor Chat Browser 正是为了解决这些问题而生的开源工具。它是一个用于浏览和管理 Cursor 编辑器 AI 聊天历史的 Web 应用，支持查看、搜索和导出你的 AI 对话为 Markdown、HTML、PDF 等多种格式。
核心功能与价值
这个工具的核心价值在于让对话历史变得可检索、可管理。它提供了一个统一的 Web 界面来浏览所有工作区的聊天历史，支持按工作区组织记录。全文搜索功能让你能快速定位特定技术问题，无论是 AI 聊天日志还是 Composer 日志都能被索引。
导出能力是另一个亮点，支持 Markdown、HTML（带语法高亮）、PDF 格式，方便归档或分享。此外，它还兼容新旧版本的 Cursor 存储格式，支持 Windows、macOS、Linux 及 WSL2，解决了多平台路径差异的问题。
技术架构
项目采用 Next.js 14 App Router 架构，使用 TypeScript 开发，通过 SQLite 读取 Cursor 的聊天数据库。UI 组件基于 shadcn/ui，样式系统使用 Tailwind CSS。这种组合既保证了类型安全，又提供了现代化的交互体验。核心组件包括导航栏、搜索栏、聊天列表以及导出功能模块。
Cursor 编辑器将聊天历史存储在 SQLite 数据库中（state.vscdb 文件）。旧版本中每个工作区有独立的文件，新版本（v44.9+）则使用全局存储集中管理。应用通过自动检测逻辑处理这两种格式的兼容性问题。
安装与配置
克隆仓库后，运行 npm install 安装依赖，然后启动开发服务器即可。访问 http://localhost:3000 打开应用。
git clone https://github.com/thomas-pedersen/cursor-chat-browser.git
cd cursor-chat-browser
npm install
npm run dev
应用会自动检测 Cursor 工作区存储路径，例如 Windows 下的 %APPDATA%\Cursor\User\workspaceStorage。如果自动检测失败，可以在配置页面手动设置路径。
跨平台路径检测
在路径检测方面，我们需要处理不同平台的差异。以伪代码为例，逻辑大致如下：
// 伪代码示例
function detectCursorPath() {
const platform = process.platform;
switch(platform) {
case 'win32': return path.join(process.env.APPDATA, 'Cursor/User/workspaceStorage');
case 'darwin': return path.join(os.(), );
:
(()) {
;
}
path.(os.(), );
: ();
}
}
