本文面向：使用 Claude Code 的開發(fā)者，想了解 ChatCrystal 如何導(dǎo)入和處理對話數(shù)據(jù)。
預(yù)計閱讀時間：8 分鐘

Claude Code 的對話存在哪

Claude Code 把每輪對話保存為 JSONL 文件，存放在：

~/.claude/projects/
├── c--Users-Project-MyApp/
│   ├── abc123.jsonl
│   ├── def456.jsonl
│   └── ...
├── c--Users-Project-AnotherApp/
│   └── ...
└── ...

每個子目錄對應(yīng)一個項目，目錄名是項目路徑的編碼（/ 替換為 -）。每個 .jsonl 文件是一次對話，每行是一個 JSON 對象，包含一條消息。

導(dǎo)入時發(fā)生了什么

運行 crystal import 時，ChatCrystal 做了以下事情：

掃描 ~/.claude/projects/**/*.jsonl
  → 逐行讀取 JSONL
  → 過濾噪音消息
  → 清理系統(tǒng)標簽
  → 提取 user / assistant 消息
  → 按項目分組
  → 寫入 SQLite 數(shù)據(jù)庫

噪音過濾

Claude Code 的 JSONL 里混著大量非對話內(nèi)容，ChatCrystal 會自動過濾：

只保留 user 和 assistant 類型的完整消息。

內(nèi)容清理

Claude Code 的消息內(nèi)容里有很多系統(tǒng)標簽，ChatCrystal 會自動清除：

<!-- 這些會被刪除 -->
<system-reminder>...</system-reminder>
<command-name>/help</command-name>
<command-message>...</command-message>
<command-args>...</command-args>
<local-command-stdout>...</local-command-stdout>
<local-command-caveat>...</local-command-caveat>

清理后只保留實際的對話內(nèi)容。

項目名提取

目錄名 c--Users-Project-ChatCrystal 會被解析為 ChatCrystal。規(guī)則是找到 Project 或 projects 標記，取后面的部分。

自定義數(shù)據(jù)目錄

如果你的 Claude Code 數(shù)據(jù)不在默認位置，可以通過環(huán)境變量指定：

CLAUDE_PROJECTS_DIR=/path/to/your/claude/projects crystal import

或在 ChatCrystal 設(shè)置頁面修改 Claude Projects Dir 配置。

文件監(jiān)聽：自動導(dǎo)入

ChatCrystal 啟動后會自動監(jiān)聽 Claude Code 數(shù)據(jù)目錄。當你和 Claude Code 產(chǎn)生新對話時，ChatCrystal 會自動檢測并導(dǎo)入，不需要手動執(zhí)行 crystal import。

監(jiān)聽邏輯：

• 使用 chokidar 監(jiān)聽 ~/.claude/projects/**/*.jsonl
• 新文件或文件變化時觸發(fā)導(dǎo)入
• 有防抖機制（debounce），避免頻繁觸發(fā)

手動導(dǎo)入 vs 自動導(dǎo)入

首次使用建議手動 crystal import 一次，把歷史數(shù)據(jù)全部導(dǎo)入。之后文件監(jiān)聽會自動處理新增對話。

導(dǎo)入結(jié)果驗證

crystal status

輸出示例：

ChatCrystal Status
  Server       : running
  Database     : connected
  Conversations: 147
  Notes        : 89
  Tags         : 23

如果 Conversations 數(shù)量為 0，說明沒有檢測到對話文件。檢查：

1. Claude Code 是否有歷史對話：ls ~/.claude/projects/
2. 目錄下是否有 .jsonl 文件
3. 如果用了自定義目錄，確認 CLAUDE_PROJECTS_DIR 配置正確

常見問題

導(dǎo)入后看不到對話

確認導(dǎo)入時沒有報錯。運行 crystal import 查看輸出：

Scanning claude-code: found 0 conversations

如果是 0，檢查 ~/.claude/projects/ 目錄是否存在以及是否有 .jsonl 文件。

對話內(nèi)容不完整

Claude Code 的 JSONL 是流式寫入的，如果對話中途異常退出（比如 kill 進程），最后幾條消息可能不完整。ChatCrystal 會跳過格式異常的行，不影響其他消息的導(dǎo)入。

導(dǎo)入速度

純文本解析非?？?，100 個對話文件通常在 1-2 秒內(nèi)完成。慢的部分是后續(xù)的 LLM 摘要生成，不是導(dǎo)入本身。

到此這篇關(guān)于Claude Code對話自動導(dǎo)入的完全指南的文章就介紹到這了,更多相關(guān)Claude Code對話自動導(dǎo)入內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論