# 🔐 Chat Vault
**一个工具保存你所有的 AI 聊天记录**
[](https://python.org)
[](LICENSE)
[]()
[]()
[English](README.md) | [中文](README_CN.md)
[✨ 功能特性](#-功能特性) •
[🚀 快速开始](#-30-秒快速开始) •
[📋 命令一览](#-命令一览) •
[📁 项目结构](#-项目结构) •
[❓ 常见问题](#-常见问题)
[📞 联系方式](#-联系方式) •
[✨ 支持项目](#-支持项目) •
[🤝 参与贡献](#-参与贡献)
AI 解读文档: [zread.ai/tukuaiai/chat-vault](https://zread.ai/tukuaiai/chat-vault)
> 📦 本工具是 [vibe-coding-cn](https://github.com/tukuaiai/vibe-coding-cn) 的一部分 - 一份全面的 Vibe Coding 指南
---
## ✨ 功能特性
| 🔄 多 CLI 支持 |
Codex、Kiro、Gemini、Claude 全都行 |
| ⚡ 实时同步 |
系统级文件监控，聊完自动保存 |
| 🔢 Token 统计 |
tiktoken 精确计算，知道你用了多少 |
| 🔍 搜索 |
秒找任何对话 |
| 📤 导出 |
JSON 或 CSV，随你选 |
| 🚀 零配置 |
自动检测路径，开箱即用 |
---
## 🏗️ 架构图
```mermaid
graph LR
subgraph 数据来源
A[~/.codex]
B[~/.kiro]
C[~/.gemini]
D[~/.claude]
end
subgraph Chat Vault
E[监控器]
F[解析器]
G[存储层]
end
subgraph 输出
H[(SQLite 数据库)]
end
A --> E
B --> E
C --> E
D --> E
E --> F
F --> G
G --> H
```
---
## 🔄 工作流程
```mermaid
sequenceDiagram
participant 用户
participant CLI as AI CLI (Codex/Kiro/...)
participant 监控器
participant 解析器
participant DB as SQLite
用户->>CLI: 和 AI 聊天
CLI->>CLI: 保存到本地文件
监控器->>监控器: 检测文件变化
监控器->>解析器: 解析新内容
解析器->>DB: 写入数据库
DB-->>用户: 随时查询
```
---
## 🚀 30 秒快速开始
```bash
# 下载
git clone https://github.com/tukuaiai/vibe-coding-cn.git
cd vibe-coding-cn/libs/external/chat-vault
# 运行（自动安装依赖）
./start.sh # Linux/macOS
start.bat # Windows（双击）
```
**搞定！** 🎉
---
## 📊 运行效果
```
==================================================
AI 聊天记录 → 集中存储
==================================================
数据库: ./output/chat_history.db
[Codex] 新增:1241 更新:0 跳过:0 错误:0
[Kiro] 新增:21 更新:0 跳过:0 错误:0
[Gemini] 新增:332 更新:0 跳过:0 错误:0
[Claude] 新增:168 更新:0 跳过:0 错误:0
==================================================
总计: 1762 会话, 40000+ 消息
✓ 同步完成!
=== Token 统计 (tiktoken) ===
codex: 11,659,952 tokens
kiro: 26,337 tokens
gemini: 3,195,821 tokens
claude: 29,725 tokens
总计: 14,911,835 tokens
```
---
## 📋 命令一览
| 命令 | 说明 |
|------|------|
| `python src/main.py` | 同步一次 |
| `python src/main.py -w` | 实时监控（推荐） |
| `python src/main.py --stats` | 查看统计 |
| `python src/main.py --search "关键词"` | 搜索消息 |
| `python src/main.py --export json` | 导出 JSON |
| `python src/main.py --export csv --source codex` | 导出指定来源 |
| `python src/main.py --prune` | 清理孤立记录 |
---
## 📁 项目结构
```
chat-vault/
├── 🚀 start.sh / start.bat # 一键启动
├── 📦 build.py # 打包脚本
├── 📂 src/
│ ├── main.py # 主程序
│ ├── config.py # 配置检测
│ ├── storage.py # SQLite + tiktoken
│ ├── watcher.py # 文件监控
│ └── parsers/ # 各 CLI 解析器
├── 📂 docs/
│ ├── AI_PROMPT.md # AI 助手指南
│ └── schema.md # 数据库结构
└── 📂 output/
├── chat_history.db # 你的数据库
└── logs/ # 日志
```
---
## 🗄️ 数据库结构
```mermaid
erDiagram
sessions {
TEXT file_path PK "文件路径"
TEXT session_id "会话ID"
TEXT source "来源"
TEXT cwd "工作目录"
TEXT messages "消息JSON"
INTEGER file_mtime "修改时间"
TEXT start_time "开始时间"
INTEGER token_count "Token数"
}
meta {
TEXT key PK
TEXT value
}
```
---
## 🤖 让 AI 帮你查数据库
把 [docs/AI_PROMPT.md](docs/AI_PROMPT.md) 发给 AI 助手，它就知道：
- 怎么写 SQL 查询
- 怎么用 Python 分析
- 怎么帮你找对话
---
## ❓ 常见问题
需要配置什么吗？
不用。自动检测 `~/.codex`、`~/.kiro`、`~/.gemini`、`~/.claude`
WSL 能用吗？
能！`\\wsl.localhost\Ubuntu\...` 这种路径也支持
怎么看数据库？
用 [DB Browser for SQLite](https://sqlitebrowser.org/) 或任何 SQLite 工具
会不会搞坏我的数据？
不会。只读取，从不修改原始文件
---
## 📞 联系方式
- **GitHub**: [tukuaiai](https://github.com/tukuaiai)
- **Twitter / X**: [123olp](https://x.com/123olp)
- **Telegram**: [@desci0](https://t.me/desci0)
- **Telegram 交流群**: [glue_coding](https://t.me/glue_coding)
- **Telegram 频道**: [tradecat_ai_channel](https://t.me/tradecat_ai_channel)
- **邮箱**: tukuai.ai@gmail.com
---
## ✨ 支持项目
如果这个项目帮到你了，考虑支持一下：
- **币安 UID**: `572155580`
- **Tron (TRC20)**: `TQtBXCSTwLFHjBqTS4rNUp7ufiGx51BRey`
- **Solana**: `HjYhozVf9AQmfv7yv79xSNs6uaEU5oUk2USasYQfUYau`
- **Ethereum (ERC20)**: `0xa396923a71ee7D9480b346a17dDeEb2c0C287BBC`
- **BNB Smart Chain (BEP20)**: `0xa396923a71ee7D9480b346a17dDeEb2c0C287BBC`
- **Bitcoin**: `bc1plslluj3zq3snpnnczplu7ywf37h89dyudqua04pz4txwh8z5z5vsre7nlm`
- **Sui**: `0xb720c98a48c77f2d49d375932b2867e793029e6337f1562522640e4f84203d2e`
---
## 🤝 参与贡献
欢迎各种形式的贡献！随时开启一个 [Issue](https://github.com/tukuaiai/vibe-coding-cn/issues) 或提交 [Pull Request](https://github.com/tukuaiai/vibe-coding-cn/pulls)。
---
## 📄 开源协议
[MIT](LICENSE) - 随便用，不用管我
---
**如果帮到你了，点个 ⭐ 呗！**
## Star History
---
**Made with ❤️ by [tukuaiai](https://github.com/tukuaiai)**
[⬆ 返回顶部](#-chat-vault)