README_CN.md 7.4 KB
# 🔐 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，随你选 |
| 🚀 零配置 | 自动检测路径，开箱即用 |
🏗️ 架构图
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
🔄 工作流程
sequenceDiagram
participant 用户
participant CLI as AI CLI (Codex/Kiro/...)
participant 监控器
participant 解析器
participant DB as SQLite
用户->>CLI: 和 AI 聊天
CLI->>CLI: 保存到本地文件
监控器->>监控器: 检测文件变化
监控器->>解析器: 解析新内容
解析器->>DB: 写入数据库
DB-->>用户: 随时查询
🚀 30 秒快速开始
# 下载
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/ # 日志
🗄️ 数据库结构
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 发给 AI 助手，它就知道：
- 怎么写 SQL 查询
- 怎么用 Python 分析
- 怎么帮你找对话
❓ 常见问题
需要配置什么吗？
不用。自动检测 `~/.codex`、`~/.kiro`、`~/.gemini`、`~/.claude`WSL 能用吗？
能！`\\wsl.localhost\Ubuntu\...` 这种路径也支持怎么看数据库？
用 [DB Browser for SQLite](https://sqlitebrowser.org/) 或任何 SQLite 工具会不会搞坏我的数据？
不会。只读取，从不修改原始文件📞 联系方式
- GitHub: tukuaiai
- Twitter / X: 123olp
- Telegram: @desci0
- Telegram 交流群: glue_coding
- Telegram 频道: 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 或提交 Pull Request。
📄 开源协议
MIT - 随便用，不用管我
**如果帮到你了，点个 ⭐ 呗！**
## Star History
---
**Made with ❤️ by [tukuaiai](https://github.com/tukuaiai)**
[⬆ 返回顶部](#-chat-vault)