Trình tìm kiếm lịch sử Claude Code
Tìm kiếm toàn bộ lịch sử phiên làm việc của Claude Code (và Codex) rồi khôi phục nguyên vẹn các tệp đã bị xoá.
Tiện íchTrung cấp★ 1,323⑂ 212Điểm AI 9/10Cập nhật lần cuối: 8 thg 8, 2026
Kỹ năng này làm gì
Tìm kiếm và phục hồi nội dung từ các tệp JSONL lưu lịch sử phiên Claude Code.
- Tìm kiếm không bỏ sót: quét cả home mặc định (
~/.claude), các home theo profile (~/.claude-profiles/*),CLAUDE_CONFIG_DIRhiện tại và mọi kho lưu trữ dài hạn khai báo trong~/.claude/history-sources.json. Không nhớ dự án? Dùng--all-projects. Muốn gộp cả Codex? Dùng--codex. - Khôi phục tệp chính xác: lấy đúng byte đã chụp từ snapshot
file-history, kể cả thay đổi bằng Edit/shell sau lệnh Write và tệp nhị phân. Nếu không có snapshot, script khôi phục nội dung Write và ghi rõ là độ tin cậy thấp hơn. - Phân tích & phân loại phiên: thống kê tin nhắn/công cụ, trích xuất riêng những gì người dùng thực sự gõ ra file HTML, và lệnh
triagephân loại phiên bị crash:done,stuck_no_result,interrupted_explicit…
Phù hợp với ai
- Người cần tìm lại đoạn code hoặc quyết định trong cuộc trò chuyện vài ngày trước
- Ai lỡ xoá tệp và muốn khôi phục từ lịch sử phiên
- Người dùng nhiều profile model khác nhau hoặc song song cả Codex
- Nhóm muốn rà soát các phiên bị gián đoạn do reboot/crash
Ví dụ sử dụng
- Không nhớ dự án nào:
python3 scripts/analyze_sessions.py search --all-projects 'kế hoạch refactor', sau đó loại bỏ phiên hiện tại bằng--exclude-session <id>vì chính câu lệnh bạn vừa gõ cũng khớp. - Khôi phục component đã xoá:
python3 scripts/recover_content.py <session.jsonl> -k ImportantFile -o ./recovered_ui/rồi đối chiếu SHA-256 trongrecovery_report.txt. - Rà soát việc dang dở sau sự cố:
python3 scripts/analyze_sessions.py triage --all-projects --kind stuck_no_resultđể đọc toàn văn phản hồi cuối và chọn phiên cần tiếp tục.
· · · Hướng dẫn cài đặt · · ·
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục daymade-claude-code/claude-code-history-files-finder từ repo GitHub daymade/claude-code-skills vào ~/.claude/skills/claude-code-history-files-finder/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/daymade/claude-code-skills.git /tmp/daymade-skills && mkdir -p ~/.claude/skills && cp -r /tmp/daymade-skills/daymade-claude-code/claude-code-history-files-finder ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal và tạo thư mục kỹ năng:
mkdir -p ~/.claude/skills - Tải mã nguồn về thư mục tạm:
git clone https://github.com/daymade/claude-code-skills.git /tmp/daymade-skills - Chép riêng kỹ năng này:
cp -r /tmp/daymade-skills/daymade-claude-code/claude-code-history-files-finder ~/.claude/skills/ - Kiểm tra Python 3:
python3 --version(khuyến nghị 3.9 trở lên) - Khởi động lại Claude Code và thử yêu cầu kiểu "tìm giúp tôi trong lịch sử hội thoại trước" để kích hoạt kỹ năng.
- (Tuỳ chọn) Nếu bạn có kho lưu trữ lịch sử cũ, khai báo đường dẫn trong
~/.claude/history-sources.jsonđể chúng được tìm mặc định. - Kiểm thử:
python3 ~/.claude/skills/claude-code-history-files-finder/scripts/analyze_sessions.py list /duong/dan/tuyet/doi/du-an
Xem mã nguồn trên GitHub ↗Giấy phép: MIT