开源！Claude 对话历史管理系统，支持浏览、搜索、继续开发
之前写了一篇架构设计文章，说要开发一个 Claude 对话历史管理系统。
现在开发完了，正式开源：github.com/jiafeimao-gjf/claude_vibe_coding_manager
这个工具解决什么问题？
用 Claude Code 久了，对话历史散落在 ~/.claude/history.jsonl 里，查找起来非常不方便：
- 想回顾某个重要讨论？得在 jsonl 文件里 grep
- 想继续之前的项目？得翻半天才能找到 session id
- 想按项目整理会话？根本没这功能
这个工具把这些问题都解决了。
核心功能
1. 全量 / 增量导入
一键导入 .claude 目录下的所有数据：
- history.jsonl（用户输入记录）
- sessions/（会话元数据）
- projects/（项目目录）
- file-history/（文件版本快照）
增量同步只导入新增记录，不重复劳动。
2. 会话浏览与搜索
- 按项目、会话筛选
- 关键词全文搜索
- 时间线浏览
- 支持中英文界面
3. 文件历史查看
Claude Code 的文件修改历史也能查看，版本快照一目了然。
4. 一键继续开发
在任意会话页面，点击 “Continue in Claude” 按钮，自动复制 claude --resume <session_id> 命令到剪贴板，直接粘贴继续工作。
5. 活动仪表盘
- 最近活跃会话
- 热门项目排行
- 使用趋势图
技术栈
| 层级 | 技术选型 |
|---|---|
| 前端 | Vue 3 + Vite + Pinia + TailwindCSS v4 + vue-i18n |
| 后端 | Python FastAPI + SQLAlchemy 2 + SQLite |
| 测试 | pytest（15 个测试全部通过） |
完全本地化 — SQLite 文件存在 data/ 目录，不需要任何外部服务。
快速上手
后端
cd backend
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload --port 9453
前端
cd frontend
npm install
npm run dev
打开 http://localhost:8453，点击 Import → Full Import 加载数据。
API 接口
| 接口 | 说明 |
|---|---|
POST /api/import/full |
全量重新导入 |
POST /api/import/incremental |
增量导入新条目 |
GET /api/projects |
项目列表 |
GET /api/sessions |
会话列表 |
GET /api/messages/search?q= |
搜索消息 |
GET /api/file-history |
文件历史 |
GET /api/stats/overview |
统计数据 |
完整文档访问 http://localhost:9453/docs
项目结构
claude_vibe_coding_manager/
├── backend/
│ ├── app/
│ │ ├── main.py # FastAPI 入口
│ │ ├── database.py # SQLite 配置
│ │ ├── models/ # ORM 模型
│ │ ├── schemas/ # Pydantic 模型
│ │ ├── routers/ # API 路由
│ │ ├── services/ # 导入服务
│ │ └── utils/ # 工具函数
│ └── requirements.txt
├── frontend/
│ ├── src/
│ │ ├── views/ # 页面组件
│ │ ├── components/ # 公共组件
│ │ ├── stores/ # Pinia 状态
│ │ ├── api/ # API 调用
│ │ └── i18n/ # 国际化
│ └── package.json
├── data/ # SQLite 数据库
├── README.md
└── LICENSE (MIT)
特性亮点
- 黑夜模式 — 自动跟随系统，localStorage 持久化
- 国际化 — 中英文切换，日期格式跟随语言
- 响应式 — 适配桌面和移动端
- TypeScript — 前端全类型支持
- 测试覆盖 — pytest 15 个测试
开源地址
github.com/jiafeimao-gjf/claude_vibe_coding_manager
MIT 协议，欢迎 Star、Fork、提 Issue 和 PR。
开发心得
用 Claude Code 开发这个工具本身就是一次”vibe coding”体验：
- 提需求 → Claude 生成代码
- 测试跑不过 → 丢给 Claude 修复
- 架构调整 → 描述需求，Claude 重构
整个过程比自己写快多了，代码质量也不差。
下一步计划
- 支持更多的 Claude 数据导入（tasks、shell-snapshots）
- 添加会话收藏和标签功能
- 导出为 Markdown/PDF
如果你也在用 Claude Code，这个工具应该能帮到你。
有问题或建议欢迎在 GitHub 提 Issue！
转载请注明来源，欢迎对文章中的引用来源进行考证，欢迎指出任何有错误或不够清晰的表达。可以在下面评论区评论，也可以邮件至 1056615746@qq.com
