README.th TH
Read this in other languages
English | 简体中文 | 日本語 | 한국어 | Deutsch | Français | Español | हिन्दी | Português | Русский | العربية | فارسی | Italiano | Polski | Nederlands | Türkçe | Українська | Tiếng Việt | Bahasa Indonesia | Svenska | Ελληνικά | Română | Čeština | Suomi | Dansk | Norsk | Magyar | ภาษาไทย | Oʻzbekcha | 繁體中文 | Filipino | עברית
ลดการใช้จ่ายโทเคนของเอเจนต์ลง 80% Graphify Cloud คือหน่วยความจำที่ทำงานตลอดเวลา ซึ่งกำกับดูแลเอเจนต์ของคุณ รักษาคุณภาพโค้ดให้สูง และพิสูจน์ความถูกต้องด้วยการตรวจสอบเชิงรูปนัย เริ่มทดลองใช้ฟรี 14 วัน →
พิมพ์ /graphify ในผู้ช่วยเขียนโค้ด AI ของคุณ แล้วมันจะแมปทั้งโปรเจกต์ของคุณ (โค้ด, เอกสาร, PDF, รูปภาพ, วิดีโอ) ให้เป็น กราฟความรู้ ที่คุณสามารถ สืบค้นแทนการ grep ไฟล์ทีละไฟล์ได้
- การแมปโค้ดฟรีและทำงานในเครื่องทั้งหมด โค้ดถูกแยกวิเคราะห์ด้วย tree-sitter AST: เป็นแบบกำหนดได้แน่นอน ไม่ใช้ LLM ไม่มีอะไรออกจากเครื่องของคุณ (เอกสาร, PDF, รูปภาพ และวิดีโอใช้โมเดลของผู้ช่วยของคุณ หรือ API key ที่กำหนดไว้ สำหรับการประมวลผลเชิงความหมายหนึ่งรอบ)
- ทุกเส้นเชื่อมมีคำอธิบาย การเชื่อมต่อแต่ละจุดถูกติดป้ายว่า
EXTRACTED(ปรากฏชัดเจนในต้นฉบับ) หรือINFERRED(graphify เป็นผู้อนุมาน) คุณจึงบอกได้ว่าอะไรคืออ่านมาตรง ๆ และอะไรคืออนุมาน - ไม่ใช่ดัชนีเวกเตอร์ ไม่มี embedding ไม่มีที่เก็บเวกเตอร์: เป็นกราฟจริงที่คุณเดินสำรวจได้ ถามคำถามหนึ่งข้อ ตามเส้นทางระหว่างสองสิ่ง หรืออธิบายแนวคิดหนึ่งอย่าง
[!NOTE] อยากให้สิ่งนี้ทำงานตลอดเวลาไหม? Graphify Cloud รักษากราฟให้สดตลอดทั้ง SDLC ของคุณ: รองรับ monorepo และข้าม repo, การตรวจสอบเชิงรูปนัย, และการรีวิวโค้ดด้วยมุมมองภาพรวมของ SDLC ของคุณ รวมถึงตัวเชื่อมต่อสำหรับ Sentry, Jira และอื่น ๆ เพื่อให้เหตุการณ์และทิกเก็ตอยู่ในกราฟเดียวกับโค้ดของคุณ เริ่มทดลองใช้ฟรี 14 วันที่ app.graphify.com
ฐานโค้ด FastAPI ที่แมปโดย graphify โหนดทุกจุดคือแนวคิดหนึ่ง สีคือชุมชนที่ตรวจพบ และทั้งหมดคลิกได้ใน graph.html
เริ่มต้นใช้งาน (30 seconds) ต้องมี Python 3.10+ และ uv (หรือ pipx):
uv tool install graphifyy # install the CLI (or: pipx install graphifyy)
graphify install # detects your assistant and registers the skill
จากนั้น ในผู้ช่วย AI ของคุณ:
เท่านี้เอง คุณจะได้ สามไฟล์:
graphify-out/
├── graph.html open in any browser: click nodes, filter, search
├── GRAPH_REPORT.md the highlights: key concepts, surprising connections, suggested questions
└── graph.json the full graph: query it anytime without re-reading your files
กราฟที่ถูกบันทึกไว้มี graph.schema_version เพื่อให้การผสานรวมตรวจพบการเปลี่ยนแปลงรูปแบบที่เข้ากันไม่ได้ พร้อมด้วย graph.graphify_version ที่ระบุรุ่น Graphify ที่สร้างมันขึ้นมา
ติดตั้งครั้งเดียว ใช้ได้กับผู้ช่วยทุกตัว ทุกระบบปฏิบัติการ Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot และอีก 20+ ตัว บน macOS, Linux และ Windows: เลือกแพลตฟอร์มของคุณ
ดูการทำงานจริง¶
เมื่อสร้างกราฟแล้ว คุณสืบค้นมันแทนการอ่านไฟล์ นี่คือผลลัพธ์จริงจากการรัน graphify บนฐานโค้ด FastAPI ที่แสดงด้านบน:
$ graphify explain "APIRouter"
Node: APIRouter
Source: routing.py L2210
Community: 2
Degree: 47
Connections (47):
--> RequestValidationError [uses] [INFERRED]
--> Dependant [uses] [INFERRED]
--> .get() [method] [EXTRACTED]
<-- __init__.py [imports] [EXTRACTED]
...
$ graphify path "FastAPI" "ModelField"
Shortest path (3 hops):
FastAPI --uses--> DefaultPlaceholder <--references-- get_request_handler() --references--> ModelField
ทุกเส้นเชื่อมมี ป้ายความเชื่อมั่น (EXTRACTED = ปรากฏชัดเจนในต้นฉบับ, INFERRED = ได้มาจากการตีความ) คุณจึงบอกได้ว่าอะไรคืออ่านมาตรง ๆ และอะไรคืออนุมาน graphify query "<question>" คืนกราฟย่อยที่จำกัดขอบเขตสำหรับคำถามภาษาธรรมดา และ graphify path A B ตามรอยว่าสองสิ่งใด ๆ เชื่อมโยงกันอย่างไร
มันทำอะไรได้บ้าง¶
สิ่งที่คุณได้ทันทีที่แกะกล่อง:
| ความสามารถ | สิ่งที่คุณได้รับ |
|---|---|
| God nodes | แนวคิดที่เชื่อมต่อมากที่สุด เพื่อให้คุณเห็นว่าทุกอย่างไหลผ่านอะไร |
| Communities | แบ่งกราฟออกเป็นระบบย่อย (Leiden) พร้อมป้ายกำกับที่ไม่ต้องใช้ LLM |
| Cross-file links | calls / imports / inherits / mixes_in ตีความข้าม ~40 languages ผ่าน tree-sitter AST |
| Query, path, explain | ถามคำถามหนึ่งข้อ ตามเส้นทางระหว่างสองสิ่ง หรืออธิบายแนวคิดหนึ่งอย่าง ทั้งหมดกระทำกับ graph.json |
| Rationale + doc refs | คอมเมนต์ # NOTE: / # WHY: และการอ้างอิง ADR/RFC กลายเป็นโหนดชั้นหนึ่งที่เชื่อมโยงกับโค้ด |
| Beyond code | เอกสาร, PDF, รูปภาพ และวิดีโอ/เสียง ล้วนแมปเข้าสู่กราฟเดียวกัน |
| Local-first | โค้ดถูกแยกวิเคราะห์ในเครื่องด้วย tree-sitter (ไม่มี LLM ไม่มีอะไรออกจากเครื่องของคุณ) มีเพียงการประมวลผลเชิงความหมายกับเอกสาร/สื่อเท่านั้นที่เรียกใช้แบ็กเอนด์ และต่อเมื่อคุณกำหนดค่าไว้ |
[!TIP] กำลังรันสิ่งนี้ข้ามหลาย repo หรือ monorepo อยู่ใช่ไหม? Graphify Cloud ทำสิ่งนี้อย่างต่อเนื่องและลดการใช้จ่ายโทเคนของเอเจนต์ลง 80% พร้อมลิงก์ข้าม repo, การรีวิวโค้ดครอบคลุมทั้ง SDLC, การตรวจสอบเชิงรูปนัย และตัวเชื่อมต่อ Sentry/Jira เริ่มทดลองใช้ฟรี 14 วัน →
เกณฑ์มาตรฐาน: 0.497 recall@10, 0 LLM credits¶
| Benchmark | Metric | graphify | Field |
|---|---|---|---|
| LOCOMO (n=300) | recall@10 | 0.497 | mem0 0.048, supermemory 0.149 |
| LOCOMO (n=300) | QA accuracy | 45.3% | supermemory 49.7%, mem0 27.3% |
| LongMemEval-S (n=50) | QA accuracy | 76% | tied with dense RAG |
| ERPNext cross-tool (n=6) | key-fact coverage | 82.0% | grep/read baseline 70.8% |
| Graph build | LLM credits | 0 | per-token for most systems |
ทุกระบบรันบนฮาร์เนสเดียวกัน ด้วยโมเดลและงบประมาณเดียวกัน ให้คะแนนโดยผู้ตัดสินที่ผ่านการตรวจสอบแบบปิดตาเทียบกับผู้ตัดสินคนที่สอง (90.6% agreement, Cohen's kappa 0.81) ตารางแยกตามระบบฉบับเต็ม ผลด้านความเข้าใจโค้ด และคำสั่งทำซ้ำ: BENCHMARKS.md
เอกสารประกอบ¶
คู่มือและเอกสารอ้างอิงฉบับเต็มอยู่ที่ docs.graphify.com:
- Quickstart: สร้างกราฟแรกของคุณ
- CLI reference: ทุกคำสั่งและทุกแฟล็ก
- Ask better graph questions: รูปแบบการสืบค้น
- Configuration: ตัวแปรสภาพแวดล้อมและการปรับจูน
- Supported inputs: ภาษาและชนิดไฟล์
- Team workflows และ PR review
- Troubleshooting และ How it works
ข้อกำหนดเบื้องต้น¶
| ข้อกำหนด | ขั้นต่ำ | ตรวจสอบ | ติดตั้ง |
|---|---|---|---|
| Python | 3.10+ | python --version |
python.org |
| uv (recommended) | any | uv --version |
curl -LsSf https://astral.sh/uv/install.sh \| sh |
| pipx (alternative) | any | pipx --version |
pip install pipx |
ติดตั้งด่วนบน macOS (Homebrew):
ติดตั้งด่วนบน Windows:
Ubuntu/Debian:
sudo apt install python3.12 python3-pip pipx
# or install uv:
curl -LsSf https://astral.sh/uv/install.sh | sh
Install¶
[!IMPORTANT] แพ็กเกจอย่างเป็นทางการ: แพ็กเกจ PyPI คือ
graphifyy(มี y สองตัว) แพ็กเกจgraphify*อื่น ๆ บน PyPI ไม่มีส่วนเกี่ยวข้อง คำสั่ง CLI ยังคงเป็นgraphify
ที่เก็บซอร์สอย่างเป็นทางการคือ Graphify-Labs/graphify
การเริ่มต้นแบบสองคำสั่งอยู่ด้านบนสุดของ README นี้ ส่วนนี้ครอบคลุมวิธีติดตั้ง การติดตั้งแบบจำกัดขอบเขตโปรเจกต์ และทุกแพลตฟอร์มที่รองรับ
วิธีติดตั้ง (เลือกหนึ่งอย่าง):
uv tool install graphifyy # recommended, isolated env (if 'graphify' isn't found after, run: uv tool update-shell)
pipx install graphifyy # alternative
pip install graphifyy # may need PATH setup, see Troubleshooting below
จากนั้นรัน graphify install หนึ่งครั้ง มันจะตรวจจับว่าคุณรันผู้ช่วยตัวใดและลงทะเบียนสกิลให้ จึงไม่มีการตั้งค่าแยกตามผู้ช่วยแต่ละตัว เปิดผู้ช่วย AI ของคุณแล้วพิมพ์ /graphify .
หากต้องการติดตั้งสกิลของผู้ช่วยลงในที่เก็บปัจจุบันแทนโปรไฟล์ผู้ใช้ของคุณ ให้เพิ่ม --project:
การติดตั้งแบบจำกัดขอบเขตโปรเจกต์จะเขียนไว้ใต้ไดเรกทอรีปัจจุบัน เช่น .claude/skills/graphify/SKILL.md หรือ .agents/skills/graphify/SKILL.md (พร้อมกับ references/ sidecar ที่สกิลโหลดเมื่อจำเป็น) และพิมพ์คำแนะนำ git add สำหรับไฟล์ที่คอมมิตได้ คำสั่งเฉพาะแพลตฟอร์มที่รองรับการติดตั้งแบบจำกัดขอบเขตโปรเจกต์ก็รับแฟล็กเดียวกัน เช่น graphify claude install --project หรือ graphify codex install --project
[!TIP] เจอ
command not found, ปัญหาpipบน Mac/Windows, การใส่เครื่องหมายคำพูดใน PowerShell, การใช้uvx, ความแปลกของ PATH ใน git-hook หรือโหมด strict อยู่ใช่ไหม? ดู Installation และ Troubleshooting
Pick your platform (20+ assistants, click to expand)
| Platform | Install command |
|---|---|
| Claude Code (Linux/Mac) | graphify install |
| Claude Code (Windows) | graphify install (auto-detected) or graphify install --platform windows |
| CodeBuddy | graphify install --platform codebuddy |
| Codex | graphify install --platform codex |
| OpenCode | graphify install --platform opencode |
| Kilo Code | graphify install --platform kilo |
| GitHub Copilot CLI | graphify install --platform copilot |
| VS Code Copilot Chat | graphify vscode install |
| Aider | graphify install --platform aider |
| OpenClaw | graphify install --platform claw |
| Factory Droid | graphify install --platform droid |
| Trae | graphify install --platform trae |
| Trae CN | graphify install --platform trae-cn |
| Gemini CLI | graphify install --platform gemini |
| Hermes | graphify install --platform hermes |
| Kimi Code | graphify install --platform kimi |
| Amp | graphify amp install |
| Agent Skills (cross-framework) | graphify install --platform agents (alias --platform skills) |
| Kiro IDE/CLI | graphify kiro install |
| Pi coding agent | graphify install --platform pi, plus graphify pi guard install for the native guard |
| Cursor | graphify cursor install |
| Devin CLI | graphify devin install |
| Google Antigravity | graphify antigravity install |
ผู้ใช้ Codex ต้องมี multi_agent = true ใต้ [features] ใน ~/.codex/config.toml ด้วย เพื่อการสกัดแบบขนาน CodeBuddy ใช้กลไก Agent tool และ PreToolUse hook เดียวกับ Claude Code Factory Droid ใช้ Task tool สำหรับการจัดส่งซับเอเจนต์แบบขนาน OpenClaw และ Aider ใช้การสกัดแบบลำดับ (การรองรับเอเจนต์แบบขนานบนแพลตฟอร์มเหล่านั้นยังอยู่ช่วงต้น) Trae ใช้ Agent tool สำหรับการจัดส่งซับเอเจนต์แบบขนาน และ ไม่ รองรับ PreToolUse hook ดังนั้น AGENTS.md จึงเป็นกลไกที่ทำงานตลอดเวลา
--platform agents (ชื่อพ้อง --platform skills) มุ่งไปที่ตำแหน่ง Agent-Skills แบบข้ามเฟรมเวิร์กทั่วไป: ใช้ ~/.agents/skills/ ซึ่งเป็นแบบ user-global ตามข้อกำหนด (อ่านโดย npx skills และเฟรมเวิร์กที่สอดคล้องกับข้อกำหนด) สำหรับการติดตั้งแบบ global และ ./.agents/skills/ สำหรับการติดตั้งแบบโปรเจกต์ (--project) คำสั่ง graphify install เปล่า ๆ ยังคงเป็นแพลตฟอร์มเดียว (Claude Code) โดยการออกแบบ: ใช้แพลตฟอร์มชื่อ agents เมื่อคุณต้องการให้สกิลถูกค้นพบได้โดยเฟรมเวิร์กใด ๆ ที่อ่าน .agents/skills
Pi ไม่มี PreToolUse hook ดังนั้น graphify pi guard install จึงลงทะเบียนส่วนขยาย Pi แบบเนทีฟ (ผ่าน pi install <package directory> ของ Pi เอง) ที่รัน graphify hook-guard ที่ติดตั้งไว้ ก่อนการเรียก read, grep, find และ bash แบบค้นหาของ Pi การตัดสินกราฟสด/เก่าและการปฏิเสธการอ่านที่จัดทำดัชนีแล้วครั้งเดียวต่อเซสชันด้วย GRAPHIFY_HOOK_STRICT=1 มาจากนโยบายเดียวกัน ดังนั้น Pi จึงมีพฤติกรรม hook ตรงกับ Claude Code คำแนะนำมาถึงในรูปข้อความนำทาง <system-reminder source="graphify"> ต้องใช้ Pi 0.58.4 หรือใหม่กว่า: เวอร์ชันก่อนหน้าปล่อยให้ข้อความนำทางข้ามส่วนที่เหลือของชุดการเรียกเครื่องมือแบบขนาน แพ็กเกจนี้มาพร้อมในการติดตั้ง Graphify ดังนั้นให้ติดตั้ง Graphify แบบถาวร (uv tool install graphifyy หรือ pipx install graphifyy ไม่ใช่ uvx) รีสตาร์ต Pi หลังติดตั้งหรืออัปเกรด และนำออกด้วย graphify pi guard uninstall มีเพียงเป้าหมายไฟล์ในเครื่องเท่านั้นที่ถูกตรวจสอบ hook นี้ต้องการ graphify อยู่บนรายการ PATH แบบสัมบูรณ์นอกโปรเจกต์ ถูกจำกัดไว้ที่การเรียกสองวินาที อินพุต 256 KiB/เอาต์พุต 64 KiB และ fail open แพ็กเกจเดียวกันยังโหลดใน Oh My Pi ด้วย: omp plugin install "$(graphify pi guard path)" เส้นทางที่ลงทะเบียนมีเวอร์ชัน Python และ venv อยู่ด้วย ดังนั้นให้รัน graphify pi guard install ใหม่หลังเปลี่ยนอย่างใดอย่างหนึ่ง และนำรายการเก่าออกด้วย pi remove <old path>
Codex ใช้
$graphifyแทน/graphify
Optional extras (install only what you need)
| Extra | What it adds | Install |
|---|---|---|
pdf |
PDF extraction | uv tool install "graphifyy[pdf]" |
office |
.docx and .xlsx support |
uv tool install "graphifyy[office]" |
google |
Google Sheets rendering | uv tool install "graphifyy[google]" |
video |
Video/audio transcription (faster-whisper + yt-dlp) | uv tool install "graphifyy[video]" |
mcp |
MCP stdio server | uv tool install "graphifyy[mcp]" |
neo4j |
Neo4j push support | uv tool install "graphifyy[neo4j]" |
falkordb |
FalkorDB push support | uv tool install "graphifyy[falkordb]" |
svg |
SVG graph export | uv tool install "graphifyy[svg]" |
leiden |
Leiden community detection (graspologic on Python < 3.13; native backend on 3.13+) | uv tool install "graphifyy[leiden]" |
ollama |
Ollama local inference | uv tool install "graphifyy[ollama]" |
openai |
OpenAI / OpenAI-compatible APIs | uv tool install "graphifyy[openai]" |
gemini |
Google Gemini API | uv tool install "graphifyy[gemini]" |
anthropic |
Anthropic Claude API (--backend claude, uses ANTHROPIC_API_KEY) |
uv tool install "graphifyy[anthropic]" |
bedrock |
AWS Bedrock (uses IAM, no API key) | uv tool install "graphifyy[bedrock]" |
azure |
Azure OpenAI Service (--backend azure, uses AZURE_OPENAI_API_KEY + AZURE_OPENAI_ENDPOINT) |
uv tool install "graphifyy[openai]" |
sql |
SQL schema extraction | uv tool install "graphifyy[sql]" |
postgres |
Live PostgreSQL introspection (--postgres DSN) |
uv tool install "graphifyy[postgres]" |
dm |
BYOND DreamMaker .dm/.dme AST extraction (may need a C compiler + python3-dev if no wheel matches your platform) |
uv tool install "graphifyy[dm]" |
terraform |
Terraform / HCL .tf/.tfvars/.hcl AST extraction |
uv tool install "graphifyy[terraform]" |
pascal |
Pascal / Delphi .pas/.dpr/.dpk/.inc AST extraction (more accurate calls/inherits edges; falls back to a regex extractor when absent) |
uv tool install "graphifyy[pascal]" |
ocaml |
OCaml .ml/.mli AST extraction |
uv tool install "graphifyy[ocaml]" |
commonlisp |
Common Lisp .lisp/.cl/.lsp/.asd AST extraction |
uv tool install "graphifyy[commonlisp]" |
robot |
Robot Framework .robot/.resource extraction (suites, test cases, keywords, keyword-call and resource/library import edges) |
uv tool install "graphifyy[robot]" |
chinese |
Chinese query segmentation (jieba) | uv tool install "graphifyy[chinese]" |
all |
Everything above | uv tool install "graphifyy[all]" |
ทำให้ผู้ช่วยของคุณใช้กราฟเสมอ¶
รันสิ่งนี้หนึ่งครั้งในโปรเจกต์ของคุณหลังจากสร้างกราฟแล้ว:
รัน graphify <platform> install หนึ่งครั้งในโปรเจกต์ของคุณ เช่น graphify claude install หรือ graphify codex install (หรือ graphify install --platform <name>)
สิ่งนี้เขียนไฟล์การตั้งค่าขนาดเล็กที่บอกให้ผู้ช่วยของคุณปรึกษากราฟความรู้สำหรับคำถามเกี่ยวกับฐานโค้ด โดยเลือกการสืบค้นที่จำกัดขอบเขตอย่าง graphify query "<question>" มากกว่าการอ่านรายงานทั้งฉบับหรือ grep ไฟล์ดิบ
- แพลตฟอร์มแบบ Hook (Claude Code, Gemini CLI): hook จะทำงานโดยอัตโนมัติก่อนการเรียกเครื่องมือแบบค้นหา (และบน Claude Code จะทำงานก่อนการอ่านไฟล์ซอร์สทีละไฟล์ผ่านเครื่องมือ Read/Glob ด้วย) และผลักผู้ช่วยของคุณไปสู่เส้นทางกราฟ
- แพลตฟอร์มแบบไฟล์คำสั่ง (Codex, OpenCode, Cursor ฯลฯ): ไฟล์คำสั่งแบบถาวร (
AGENTS.md,.cursor/rules/ฯลฯ) ให้คำแนะนำแบบสืบค้นก่อนเดียวกัน
GRAPH_REPORT.md ยังคงใช้ได้สำหรับการทบทวนสถาปัตยกรรมในวงกว้าง
ไฟล์ที่แต่ละแพลตฟอร์มเขียนออกมาจริง ๆ (เช่น CODEBUDDY.md + PreToolUse hooks ของ CodeBuddy, AGENTS.md ของ Codex, ปลั๊กอิน .kilo แบบเนทีฟของ Kilo, กฎ alwaysApply ของ Cursor และอื่น ๆ) ครอบคลุมใน Always-on setup
หากต้องการนำ graphify ออกจากทุกแพลตฟอร์มในครั้งเดียว: graphify uninstall (เพิ่ม --purge เพื่อลบ graphify-out/ ด้วย) หรือใช้คำสั่งเฉพาะแพลตฟอร์ม (เช่น graphify claude uninstall)
สกิล CLI หรือคำสั่ง MCP?¶
คำสั่งที่ติดตั้งโดย graphify install และคำสั่งที่มาพร้อมการเชื่อมต่อ Graphify MCP อธิบายวิธีสืบค้นกราฟที่แตกต่างกัน:
| Setup | Guidance to use | Query access |
|---|---|---|
| CLI ในเครื่องและสกิลผู้ช่วยที่ติดตั้งไว้ | คำสั่งของแพลตฟอร์มที่เขียนโดย graphify install |
รัน graphify query, graphify path และ graphify explain กับกราฟในเครื่อง (graphify-out/ โดยค่าเริ่มต้น) |
| เซิร์ฟเวอร์ Graphify MCP ที่เชื่อมต่อ | คำสั่งของการเชื่อมต่อนั้นและเครื่องมือที่เซิร์ฟเวอร์นั้นแสดงรายการ | เรียกเครื่องมือ MCP ที่แสดงรายการกับกราฟที่การเชื่อมต่อนั้นให้บริการ ชื่อและคำอธิบายเครื่องมือมาจากเซิร์ฟเวอร์ |
ทั้งสองแบบส่งเสริมการสืบค้นกราฟแบบจำกัดขอบเขตก่อนการค้นหาซอร์สในวงกว้าง เลือกคำสั่งที่ตรงกับเครื่องมือที่ผู้ช่วยของคุณเข้าถึงได้จริง ไม่มีบล็อกใดสร้างกฎลำดับความสำคัญสากลสำหรับไฟล์คำสั่งของผู้ช่วยของคุณ หากคุณใช้ทั้งสองการผสานรวม ให้ระบุว่าแต่ละอันสืบค้นกราฟใด และเลือกเส้นทางการสืบค้นหลักหนึ่งเส้นทาง แทนการคัดลอกบล็อกคำสั่งแบบไม่มีเงื่อนไขสองบล็อกลงใน AGENTS.md
graphify install ติดตั้งการผสานรวมผู้ช่วยในเครื่อง ไม่ได้สร้างการเชื่อมต่อ MCP ไคลเอนต์ MCP ไม่จำเป็นต้องรันการสืบค้น CLI ในเครื่องเพื่อใช้เซิร์ฟเวอร์ที่เชื่อมต่ออยู่ เซิร์ฟเวอร์ที่โฮสต์ในเครื่องยังคงต้องมีการติดตั้ง Graphify และกราฟของตัวเอง ในขณะที่การเชื่อมต่อแบบโฮสต์อาจให้บริการกราฟที่ไม่มีอยู่ในไดเรกทอรีทำงานของไคลเอนต์ หากเครื่องมือที่คาดหวังหายไป ให้ตรวจสอบการติดตั้ง CLI หรือการเชื่อมต่อ MCP ที่เกี่ยวข้อง แทนการถือว่าคำสั่งของอีกการตั้งค่าหนึ่งใช้แทนกันได้
ในรายงานมีอะไร¶
GRAPH_REPORT.md สรุป god nodes, ชุมชน และเส้นทางสำคัญ สำหรับการทบทวนสถาปัตยกรรมในวงกว้าง กราฟถูกสร้างอย่างไรและมีอะไรอยู่ในนั้น: How graphify works
มันจัดการไฟล์อะไรได้บ้าง: ~40 languages¶
graphify แยกวิเคราะห์ ~40 programming languages ในเครื่องด้วย tree-sitter AST และแมปเอกสาร, PDF, รูปภาพ และเสียง/วิดีโอ ผ่านการประมวลผลเชิงความหมายที่เป็นทางเลือก รายการฉบับเต็ม: Supported inputs
คำสั่งที่ใช้บ่อย¶
/graphify . # build graph for current folder
/graphify ./docs --update # re-extract only changed files
/graphify . --cluster-only # rerun clustering without re-extracting
/graphify . --cluster-only --resolution 1.5 # more granular communities
/graphify . --cluster-only --exclude-hubs 99 # suppress utility super-hubs from god-node rankings
/graphify . --no-viz # skip the HTML, just the report + JSON
/graphify . --wiki # build a markdown wiki from the graph
graphify export callflow-html # Mermaid architecture/call-flow HTML (auto-regenerates on every git commit if hook is installed)
/graphify query "what connects auth to the database?"
/graphify path "UserService" "DatabasePool"
/graphify explain "RateLimiter"
/graphify add https://arxiv.org/abs/1706.03762 # fetch a paper and add it
/graphify add <youtube-url> # transcribe and add a video
graphify hook install # auto-rebuild on commit + branch checkout (run `graphify update .` after `git pull`: see "Recommended workflow" below)
graphify merge-graphs a.json b.json # combine two graphs
graphify prs # PR dashboard: CI state, review status, worktree mapping
graphify prs 42 # deep dive on PR #42 with graph impact
graphify prs --triage # AI ranks your review queue (uses whatever backend is configured)
graphify prs --conflicts # PRs sharing graph communities: merge-order risk
ดู การอ้างอิงคำสั่งฉบับเต็ม ด้านล่าง
การละเว้นไฟล์¶
graphify เคารพ .gitignore และรองรับแพตเทิร์น --exclude และ .graphifyignore ระดับโปรเจกต์ รายละเอียด: Configuration
การกำหนดค่าโปรเจกต์¶
สร้าง .graphifyrc ในรากของการสแกน สำหรับการตั้งค่าที่เป็นของโปรเจกต์ มากกว่าของการรันครั้งเดียว หนึ่ง key=value ต่อหนึ่งบรรทัด บรรทัดที่ขึ้นต้นด้วย # คือคอมเมนต์
นามสกุลที่กำกวม นามสกุลบางชนิดหมายถึงภาษาต่างกันในโปรเจกต์ต่างกัน: .inc เป็น PHP บน pfSense, เป็น Pascal ในทรี Delphi, เป็น SQL หรือแอสเซมบลีในที่อื่น; .h เป็น C หรือ C++; .m เป็น Objective-C หรือ MATLAB graphify ต้องเลือกค่าเริ่มต้นแบบ global หนึ่งค่า และเมื่อเลือกผิด ไฟล์นั้นจะไม่ล้มเหลว: มันถูกแยกวิเคราะห์ด้วยภาษาผิด และให้โหนดโดยบังเอิญไม่กี่โหนด กราฟจึงดูเหมือนมีข้อมูลอยู่ ทั้งที่สัญลักษณ์จริงหายไป ประกาศว่านามสกุลนั้นหมายถึงอะไรใน repo ของคุณ:
# .graphifyrc
# A language name:
language.inc=php
# Or an extension graphify already knows:
language.tpl=.ts
# Baked into the git hooks (see Team setup):
viz_node_limit=0
การประกาศนี้ไหลผ่านการจัดหมวดหมู่ การเลือกตัวสกัด ไวยากรณ์และการตีความ การ import, graphify watch และแคช AST (ไฟล์ที่ถูกแยกวิเคราะห์ใหม่ภายใต้ภาษาอื่นจะไม่ใช้รายการเก่าซ้ำ) และ .graphifyrc เดียวกันถูกอ่านโดย extract, update, hooks, เซิร์ฟเวอร์ MCP และสกิล /graphify การพิมพ์ผิดจะถูกรายงานครั้งเดียวบน stderr และการสแกนดำเนินต่อด้วยค่าเริ่มต้น การประกาศโต้ตอบกับการแคช การสร้างใหม่แบบ incremental และการตีความ import อย่างไร: Configuration
การตั้งค่าสำหรับทีม¶
คอมมิตหรือแชร์กราฟเพื่อให้ทั้งทีมของคุณสืบค้นบริบทเดียวกัน และรีวิว pull request ด้วยบริบทของกราฟ ดู Share context with your team และ Review pull requests
การใช้กราฟโดยตรง¶
นอกเหนือจากผู้ช่วย AI ของคุณ ให้สืบค้น graph.json โดยตรงจาก CLI ด้วย graphify query, graphify path และ graphify explain ชื่อที่ตรงกับหลายโหนดจะถูกปฏิเสธโดยแสดงรายการตัวเลือก แทนการเดา สคริปต์สามารถอ่านผลลัพธ์ได้จากรหัสออก: 0 คือมีคำตอบ, 3 คือชื่อกำกวม, 4 คือไม่มีโหนดที่ตรงกัน ดู Ask better graph questions และ query reference
ตัวแปรสภาพแวดล้อม¶
แบ็กเอนด์, API key, พฤติกรรม hook และการปรับจูน ถูกควบคุมด้วยตัวแปรสภาพแวดล้อม ตารางฉบับเต็ม: Configuration
ความเป็นส่วนตัว¶
- ไฟล์โค้ด: ประมวลผลในเครื่องผ่าน tree-sitter ไม่มีอะไรออกจากเครื่องของคุณ คอร์พัสที่มีแต่โค้ดไม่ต้องใช้ API key:
graphify extractรันแบบออฟไลน์เต็มรูปแบบ ในรีโพแบบผสม ให้เพิ่ม--code-onlyเพื่อจัดทำดัชนีเฉพาะโค้ด และข้ามเอกสาร/PDF/รูปภาพที่มิฉะนั้นจะต้องใช้ LLM - วิดีโอ / เสียง: ถอดเสียงในเครื่องด้วย faster-whisper ไม่มีอะไรออกจากเครื่องของคุณ
- เอกสาร, PDF, รูปภาพ: ถูกส่งไปยังผู้ช่วย AI ของคุณเพื่อการสกัดเชิงความหมาย (ผ่านสกิล
/graphifyโดยใช้โมเดลใดก็ตามที่เซสชัน IDE ของคุณรันอยู่)graphify extractแบบ headless ต้องการGEMINI_API_KEY/GOOGLE_API_KEY(Gemini),MOONSHOT_API_KEY(Kimi),ANTHROPIC_API_KEY(Claude),OPENAI_API_KEY(OpenAI),DEEPSEEK_API_KEY(DeepSeek), อินสแตนซ์ Ollama ที่กำลังรัน (OLLAMA_BASE_URL), ข้อมูลรับรอง AWS ผ่าน provider chain มาตรฐาน (Bedrock - ไม่ต้องใช้ API key ใช้ IAM) หรือไบนารี CLIclaude(Claude Code - ไม่ต้องใช้ API key ใช้การสมัครสมาชิก Claude ของคุณ) แฟล็ก--dedup-llmใช้ key เดียวกัน - ที่ตั้งข้อมูล:
graphify extractตรวจจับโดยอัตโนมัติว่าจะใช้ provider ใด โดยอิงจากว่าตั้ง API key ใดไว้ (ลำดับความสำคัญ: Gemini → Kimi → Claude → OpenAI → DeepSeek → Azure → Bedrock → Ollama) สำหรับโค้ดที่มีข้อกำหนดด้านที่ตั้งข้อมูล ให้ใช้--backend ollama(ในเครื่องเต็มรูปแบบ) หรือส่งแฟล็ก--backendอย่างชัดเจน Kimi (MOONSHOT_API_KEY) กำหนดเส้นทางไปยังเซิร์ฟเวอร์ Moonshot AI ในประเทศจีน - ไม่มีเทเลเมทรี ไม่มีการติดตามการใช้งาน ไม่มีการวิเคราะห์
- การบันทึกการสืบค้น: ทุกการเรียก
graphify query,graphify path,graphify explainและ MCPquery_graphถูกบันทึกไปยัง~/.cache/graphify-queries.logในรูปแบบ JSON Lines (ไทม์สแตมป์, คำถาม, คอร์พัส, โหนดที่คืนมา, ระยะเวลา) การตอบกลับกราฟย่อยฉบับเต็มจะ ไม่ ถูกเก็บโดยค่าเริ่มต้น ตั้งGRAPHIFY_QUERY_LOG_DISABLE=1เพื่อเลือกไม่เข้าร่วม หรือGRAPHIFY_QUERY_LOG=/dev/nullเพื่อปิดเสียงโดยไม่ปิดเส้นทางโค้ด
การแก้ปัญหา¶
ปัญหาการติดตั้งและการสกัดที่พบบ่อยและการแก้ไข: Troubleshooting
การอ้างอิงคำสั่งฉบับเต็ม¶
ทุกคำสั่งและทุกแฟล็ก พร้อมตัวอย่าง: CLI reference
เรียนรู้เพิ่มเติม¶
- docs.graphify.com: เอกสารฉบับเต็ม: คู่มือ, การอ้างอิงคำสั่ง และการผสานรวม
- How it works: ไปป์ไลน์การสกัด, การตรวจจับชุมชน, การให้คะแนนความเชื่อมั่น, เบนช์มาร์ก
- ARCHITECTURE.md: การแยกส่วนโมดูล, วิธีเพิ่มภาษา
- Optional integrations: Docker MCP Toolkit + SQLite
- The Memory Layer: หนังสือว่าด้วยแนวคิดเบื้องหลัง graphify และสถาปัตยกรรมตั้งแต่ต้นจนจบ
Graphify Cloud¶
Graphify Cloud คือเลเยอร์ที่ทำงานตลอดเวลา ซึ่งสร้างขึ้นบน graphify แทนที่จะเป็นกราฟที่คุณสร้างใหม่ตามต้องการต่อโฟลเดอร์ มันรักษากราฟสดหนึ่งกราฟตลอดวงจรการพัฒนาซอฟต์แวร์ทั้งหมดของคุณ:
- โทเคนน้อยลง 80%: หน่วยความจำที่ทำงานตลอดเวลาหมายความว่าเอเจนต์ของคุณหยุดอ่านซ้ำและอธิบายฐานโค้ดซ้ำในทุกเซสชัน
- Monorepo และข้าม repo: กราฟที่เชื่อมต่อกันหนึ่งกราฟข้ามทุกบริการและทุกที่เก็บ ไม่ใช่กราฟหนึ่งต่อหนึ่งโฟลเดอร์
- การตรวจสอบเชิงรูปนัย: ตรวจสอบค่าคงที่ของสถาปัตยกรรมและการพึ่งพากับกราฟสด
- การรีวิวโค้ดด้วยมุมมองภาพรวมของ SDLC ของคุณ: เห็นว่าการเปลี่ยนแปลงหนึ่งแผ่กระเพื่อมไปทั่วทั้งระบบอย่างไรก่อนที่คุณจะ merge
- ตัวเชื่อมต่อ SDLC: ดึง Sentry, Jira และอื่น ๆ เข้ามา เพื่อให้เหตุการณ์ ทิกเก็ต และโค้ดอยู่ในกราฟเดียว
- ทำงานตลอดเวลา: อัปเดตอย่างต่อเนื่องในเบื้องหลัง ข้ามโค้ด เอกสาร และการประชุม
เริ่มทดลองใช้ฟรี 14 วันที่ app.graphify.com →
การมีส่วนร่วม¶
ยินดีรับการมีส่วนร่วม ดู CONTRIBUTING.md สำหรับการตั้งค่าสภาพแวดล้อมการพัฒนา, คำสั่งทดสอบและ CI-parity, เวิร์กโฟลว์ git และอะไรที่ทำให้การมีส่วนร่วมแข็งแกร่ง (ตัวอย่างจริงและรายงานบั๊กการสกัดมีประโยชน์ที่สุด) สถาปัตยกรรมและวิธีเพิ่มภาษา: ARCHITECTURE.md
เพิ่งมาที่นี่? ทักทายบน Discord หรือใน GitHub Discussions
ผู้มีส่วนร่วม¶
Made with contrib.rocks.
การแปล¶
README นี้มีให้ใน 32 ภาษา ใช้ตัวสลับภาษาที่ด้านบนของไฟล์นี้เพื่ออ่านในภาษาของคุณ หรือเรียกดู docs/translations/ หากต้องการปรับปรุงการแปลหรือเพิ่มการแปลใหม่ ให้เปิด pull request กับไฟล์ที่ตรงกันที่นั่น
การต่อยอดบน graphify¶
กำลังสร้างบางอย่างในระบบนิเวศ graphify อยู่ใช่ไหม? นั่นเป็นสิ่งที่สนับสนุน หากโปรเจกต์ของคุณใช้ "graphify" ในชื่อ (เช่น graphify-dashboard หรือ graphify-action) โปรดเพิ่มหมายเหตุสั้น ๆ ใน README ของคุณเพื่อชี้แจงว่ามันสร้างโดยชุมชนและไม่ได้เป็นพันธมิตรหรือได้รับการรับรองจาก Graphify Labs "graphify" และโลโก้ graphify เป็นเครื่องหมายของ Graphify Labs โปรดอย่าใช้ในลักษณะที่สื่อถึงสถานะทางการ
ชุมชนและลิงก์¶
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 graph/graphify
