Công cụ tự động liên kết lịch sử hội thoại Claude Code vào đồ thị tri thức Obsidian

Xin chào. Tôi muốn giới thiệu claude-knowledge-graph, một dự án mã nguồn mở được tạo ra để giải quyết sự bất tiện mà tôi gặp phải gần đây khi dùng trợ lý lập trình AI (Claude Code) trong môi trường terminal.

Lý do tạo ra dự án (My Pain Point)

Tôi làm công việc data science và đồng thời xử lý các yêu cầu phân tích dữ liệu cũng như phát triển từ nhiều bộ phận khác nhau. Từ khi đưa Claude Code vào sử dụng, năng suất đã tăng lên đáng kể, nhưng có một vấn đề nghiêm trọng.

• Tri thức bị thất thoát và phân mảnh: Mỗi khi có yêu cầu phân tích mới, tôi lại tạo một thư mục ad-hoc mới để làm việc. Khi phiên làm việc kết thúc, các quyết định kiến trúc đã đưa ra trong quá trình vật lộn với AI, đoạn mã tiền xử lý phức tạp và cả quá trình debug đều biến mất theo.
• Lặp lại công việc một cách kém hiệu quả: Khi gặp lại các tác vụ tương tự về sau, tôi thường không tìm được lịch sử trước đó, nên hoặc phải giải thích lại toàn bộ bối cảnh cho AI từ đầu, hoặc phải lần mò theo trí nhớ để viết lại code, gây lãng phí rất nhiều thời gian.

Tôi bắt đầu dự án này từ suy nghĩ: “Liệu có cách nào để AI tự gọi lại lịch sử công việc trước đây của tôi theo đúng ngữ cảnh hiện tại, mà tôi không cần phải nhớ xem mình đã từng giải quyết vấn đề đó ở thư mục nào không?”

Giới thiệu dự án: claude-knowledge-graph

Đây là công cụ chặn toàn bộ hội thoại (prompt và phản hồi) trong Claude Code, phân tích chúng bằng local LLM, rồi tự động xây dựng thành một đồ thị tri thức Obsidian (Knowledge Graph) hợp nhất.

1. Zero-Friction (hoàn toàn tự động): Công cụ chạy ngầm bằng Hook của Claude Code. Người dùng chỉ cần lập trình như bình thường.
2. Gắn thẻ an toàn bằng local LLM: Sau khi công việc kết thúc, một local LLM nhẹ (Qwen 3.5 4B + llama.cpp) sẽ chạy ngầm trong chốc lát để tóm tắt hội thoại, trích xuất các khái niệm và thẻ chính rồi tự tắt. Không cần lo mã nguồn nội bộ bị rò rỉ ra bên ngoài.
3. Tự động liên kết dựa trên độ tương đồng (Killer Feature): Dựa trên các khái niệm, thẻ đã trích xuất, cùng với đường dẫn thư mục làm việc (cwd), công cụ sẽ so sánh đa chiều giữa hội thoại hiện tại và các bản ghi trước đó. Nó tìm ra các cách giải quyết cũ có mức liên quan cao và tự động liên kết chúng bằng wiki link ([[ ]]) ở cuối ghi chú hiện tại.

Đặc biệt hữu ích với những lập trình viên sau

• Người thường xuyên phải chuyển ngữ cảnh: Dù làm việc qua lại giữa nhiều dự án hay thư mục ad-hoc, toàn bộ tri thức vẫn được gom về một Obsidian Vault và tự động liên kết với nhau.
• Người làm việc trong môi trường bảo mật nghiêm ngặt: Đây là một lựa chọn local an toàn cho những ai ngại dùng dịch vụ ghi chú/logging trên cloud vì phải xử lý code hoặc dữ liệu nhạy cảm trong môi trường enterprise.
• Người theo đuổi mô hình Second Brain: Rất phù hợp cho người dùng Obsidian muốn xây dựng đồ thị tri thức trực quan, nơi thông tin được nối với nhau bằng node và edge, thay vì chỉ là log văn bản đơn thuần.

Công cụ được thiết kế để hoạt động tốt trên Mac (Apple Silicon) và Linux. Khuyến nghị môi trường có ít nhất 16GB RAM để chạy local LLM ở nền.

Thông tin chi tiết hơn về kiến trúc và cách cấu hình đã được tôi tổng hợp trong kho GitHub. Mọi phản hồi hoặc PR đều luôn được chào đón!

• GitHub link: https://github.com/yunwoonam/claude-knowledge-graph

[namyunwoo]

Liên kết GitHub là https://github.com/namyunwoo/claude-knowledge-graph