Kỹ năng Knowledge Graph Mã Nguồn Mở

Graphify — Knowledge Graph cho trợ lý lập trình AI

Name: Graphify
Author: Safi Shamsi

Graphify là kỹ năng mã nguồn mở giúp trợ lý lập trình AI hiểu codebase đa phương thức bằng cách xây dựng knowledge graph có thể truy vấn từ code, tài liệu, bài báo và sơ đồ.

Click to Use Graphify MCP Free

Graphify là gì?

Graphify là bộ dựng knowledge graph đa phương thức cho trợ lý lập trình AI như Claude Code, OpenAI Codex và OpenCode. Bằng cách kết hợp phân tích tĩnh Tree-sitter với trích xuất ngữ nghĩa dựa trên LLM, Graphify biến toàn bộ repository gồm source code, tài liệu, bài nghiên cứu và sơ đồ thành đồ thị tương tác, giải thích cả phần mềm làm gì và vì sao được thiết kế như vậy. Dự án do Safi Shamsi duy trì và phát hành theo giấy phép MIT.

3.7k+GitHub Stars

MITGiấy phép

71.5×Tỷ lệ giảm token

Python 3.10+Môi trường chạy

Năng lực cốt lõi

Graphify hợp nhất phân tích tĩnh, trích xuất ngữ nghĩa và phân cụm đồ thị thành một kỹ năng duy nhất có thể gọi từ trợ lý lập trình AI.

Trích xuất đa phương thức

Phân tích code (.py, .js, .go, .java, ...), Markdown, PDF và hình ảnh. Tree-sitter trích AST, call graph và docstring; LLM trích khái niệm từ văn bản; mô hình thị giác đọc sơ đồ.

Xây dựng knowledge graph

Gộp toàn bộ node/edge vào đồ thị NetworkX và áp dụng Leiden để phát hiện cộng đồng ngữ nghĩa, không cần vector embedding.

God nodes & kết nối bất ngờ

Xác định các "god nodes" có bậc cao nhất trong hệ thống và phát hiện các liên kết chéo tệp/chéo miền đáng chú ý.

Đầu ra tương tác

Xuất graph.html tương tác, graph.json có thể truy vấn và báo cáo GRAPH_REPORT.md dễ đọc.

Tích hợp trợ lý

Cung cấp lệnh /graphify, /graphify query, /graphify path, /graphify explain.

Bảo mật mặc định

Kiểm tra đầu vào chặt chẽ: chỉ cho phép http/https, giới hạn kích thước/thời gian, kiểm tra đường dẫn, escape HTML cho nhãn node để chống SSRF/injection/XSS.

Kiến trúc & pipeline

Graphify là pipeline nhiều giai đoạn. Mỗi giai đoạn là module độc lập để mở rộng linh hoạt.

detect — thu thập tệp extract — AST + node/edge từ LLM build — tạo đồ thị NetworkX cluster — cộng đồng Leiden analyze — god nodes & kết nối bất ngờ report — GRAPH_REPORT.md export — HTML / JSON / Obsidian

Các module hỗ trợ gồm ingest.py (fetch URL), cache.py (semantic cache), security.py (kiểm tra đầu vào), watch.py (cập nhật realtime) và serve.py (dịch vụ MCP).

Install & Run

Install Graphify AI from the repository with Python 3.12 and uv. The package is private-context-mcp; the CLI command is private-context.

# Requires Python 3.12 and uv; run from the Graphify AI repository root
uv sync --extra dev --extra cloud --no-editable \
  --reinstall-package private-context-mcp

# Verify the local installation
uv run --no-sync private-context doctor

# Start the local stdio MCP server
uv run --no-sync private-context serve --transport stdio

The commands use Graphify AI’s locked dependencies and local runtime. Use the hosted console at app.graaph.org when you do not need a local installation.

Ví dụ thực tế

Repository đi kèm các bộ dữ liệu có thể tái lập để minh họa Graphify trên thư viện nhỏ và tập hỗn hợp code + paper lớn.

httpx (nhỏ)

6 tệp Python mô hình hóa tầng HTTP transport. Kết quả: 144 node, 330 edge, 6 community. God nodes: Client, AsyncClient, Response, Request. Kết nối bất ngờ: DigestAuth → Response.

Kho Karpathy hỗn hợp

3 repo framework GPT + 5 bài attention + 4 sơ đồ (~52 tệp, ~92k từ). Kết quả: 285 node, 340 edge, 53 community. Chi phí truy vấn trung bình ~1.7k token so với ~123k cách ngây thơ, giảm 71.5×.

So sánh

Graphify so với các dự án mã nguồn mở lân cận trong mảng code intelligence.

Dự án	Trọng tâm	Điểm mạnh	Hạn chế so với Graphify
Sourcegraph	Tìm kiếm code đa repo	Điều hướng cấp doanh nghiệp	Không phải knowledge graph; ngữ nghĩa thiết kế còn hạn chế
Code2Vec	Embedding mức hàm	Truy hồi/phân loại vector	Không có cấu trúc đồ thị, không có đầu vào đa phương thức
Neo4j	Cơ sở dữ liệu đồ thị tổng quát	Truy vấn Cypher mạnh	Không tự sinh knowledge graph từ code

Bảo mật, giấy phép & độ tin cậy

Graphify phát hành theo MIT License. Các phụ thuộc chính như NetworkX (BSD) và Tree-sitter (MIT) đều là giấy phép mở linh hoạt. Dự án không thu telemetry. Cuộc gọi mạng ra ngoài duy nhất là bước trích xuất ngữ nghĩa, dùng API key của bạn; chỉ gửi mô tả ngữ nghĩa tài liệu, không gửi source code thô. URL bị giới hạn http/https, tải xuống có giới hạn kích thước/thời gian, đường dẫn đầu ra được kiểm tra containment, nhãn node được escape HTML để ngăn SSRF, Cypher injection và XSS.

Tìm hiểu thêm về Graphify

Các hướng dẫn chuyên sâu về cách Graphify xây dựng, phân cụm và phục vụ knowledge graph cho trợ lý lập trình AI.

Knowledge Graph cho trợ lý lập trình AI

Vì sao đồ thị cấu trúc thường hiệu quả hơn vector RAG cho hiểu code.

Trích xuất AST bằng Tree-sitter

Cách Graphify phân tích 19 ngôn ngữ cục bộ, không gọi LLM khi parse source.

Leiden Community Detection

Phân cụm dựa trên topology đồ thị, không cần embedding hay vector store.

Tích hợp Claude Code

Hướng dẫn từng bước cho chỉ thị CLAUDE.md và hook PreToolUse.

Tham chiếu lệnh CLI

Toàn bộ lệnh /graphify và graphify trong một trang.

Graphify vs Alternatives

So sánh khách quan với Sourcegraph, Code2Vec và Neo4j.

Câu hỏi thường gặp

Graphify có gửi code của tôi cho mô hình bên thứ ba không?

Không. Graphify chỉ gửi mô tả ngữ nghĩa của tài liệu/sơ đồ tới mô hình bạn đã cấu hình, không gửi file source thô.

Hỗ trợ những trợ lý lập trình AI nào?

Hỗ trợ sẵn Claude Code, OpenAI Codex và OpenCode qua các manifest skill-*.md. Bất kỳ trợ lý nào chạy được lệnh shell đều có thể gọi graphify.

Graphify xử lý codebase lớn tới mức nào?

Tree-sitter parsing và xây dựng đồ thị NetworkX mở rộng tuyến tính theo kích thước mã. Với corpus ~500k từ, truy vấn BFS subgraph vẫn quanh ~2k token so với ~670k theo cách ngây thơ.

Graphify có miễn phí cho mục đích thương mại không?

Có. Graphify dùng MIT License và miễn phí cho cả cá nhân lẫn doanh nghiệp.