7.4 KiB

Raw Blame History

🔐 Chat Vault

一个工具保存你所有的 AI 聊天记录

✨ 功能特性 • 🚀 快速开始 • 📋 命令一览 • 📁 项目结构 • ❓ 常见问题

📦 本工具是 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 或任何 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

⬆ 返回顶部

7.4 KiB Raw Blame History Unescape Escape