Graphify — Kod Bazangizni AI Assistantga Tushuntirish

Keling, rost bo'laylik: oylar oldin ishlagan kod bazasini ochganingizda, o'shaning "qayerdan boshlash kerak" hissi sizni qo'rqitadi. Fayllar joyida, arxitektura esingizda, lekin hamma narsani bir-biriga ulash — bu arxeologiya.

Graphify aynan shuni o'zgartirishni maqsad qilgan.

Graphify Nima?

Graphify — bu sizning butun kod bazangizdan so'rov berish mumkin bo'lgan bilim grafigini yaratadigan ochiq manbaali tool. Manba kodi, hujjatlar, tadqiqot ishlariva diagrammalar — hammasi bitta qidiruvchi grafda birlashtiriladi.

Boshqacha qilib aytganda: AI assistantga fayllar to'plami emas, butun loyiha xaritasi bering.

Muallif: Safi Shamsi. MIT litsenziyasi ostida chiqarilgan. NetworkX va Tree-sitter asosida ishlaydi.

Ko'p Rejimli Yondashuv

Graphify faqat kodni tahlil qilmaydi — turli xil ma'lumot turlarini qayta ishlaydi:

• Manba kodi (.py, .js, .go, .java va boshqalar) — Tree-sitter AST, chaqiruv graflari va docstringlarni ajratadi
• Markdown va PDF — LLM asosidagi ajratish matndan tushunchalarni chiqaradi
• Diagrammalar va rasmlar — Vision modellar arxitektura diagrammalarini o'qiydi

Bu yondashuv tufayli siz faqat chaqiruv grafi olmaysiz — turli fayl turlari o'rtasidagi semantik aloqalarni olasiz.

Bosqichma-Bosqich Jarayon

1. Yig'ish — Barcha kerakli fayllarni topish
2. Ajratish — AST va semantik tugunlarni olish
3. Qurish — NetworkX grafigini yaratish
4. Guruhlash — Leiden algoritmi bilan jamoaviy aniqlash
5. Tahlil — "Xudo tugunlari" va kutilmagan aloqalarni topish
6. Hisobot — O'qiladigan natija chiqarish

Leiden algoritmi juda aqlli tanlov. Vector embedding (qimmat va noaniq) o'rniga, semantik klasterlarni aniq guruhlaydi. Qo'shimcha embedding modeli shart emas.

"Xudo Tugunlari" va "Kutilmagan Aloqalar"

Qiziqarli xususiyat: Graphify eng yuqori bog'liqlikka ega fayllarni — "xudo tugunlari"ni aniqlaydi. Bular odatda asosiy classlar, kirish nuqtalari yoki muhim shared utilitylar.

Yana bir qiziq: "surprises" — kutilmagan cross-file yoki cross-domain aloqalar. httpx kutubxonasida misol: DigestAuth va Response o'rtasida bog'liqlik topildi. Bu aloqani alohida fayllarni o'qib bilish mumkin emas, lekin grafda aniq ko'rinadi.

Token Tejamkorligi

Muhim raqam: aralash corpus benchmarkda Graphify 71.5× token kamaytirishga erishdi naive context injection solishtirganda.

Bu katta pul demak. AI API to'lovlari, kichikroq context window, tezroq javoblar va kamroq hallucination xatari.

Xavfsizlik

Graphify xavfsizlikni jiddiy oladi:

• Faqat http/https URL ruxsat etilgan
• Yuklab olishda size va timeout limit
• Path containment tekshiruvi (directory traversal yo'q)
• Barcha node label uchun HTML escaping
• Telemetriya yoki uchinchi tomon ma'lumot yig'ish yo'q

Kodingingiz hech qachon sizning muhitni tark etmaydi. Faqat semantik tavsif (manba kodi emas) AI modelga yuboriladi.

AI Assistantlar Bilan Integratsiya

Claude Code, Codex, OpenCode uchun buyruqlar:

• /graphify — yangi graf qurish
• /graphify query <savol> — kod bazasi haqida so'rash
• /graphify path <fayl> — muayyan fayllarni o'rganish
• /graphify explain — graf tuzilmasini tushuntirish

Natija: interaktiv graph.html, programmatic foydalanish uchun graph.json va audit fayli GRAPH_REPORT.md.

O'rnatish

pip install graphifyy
graphify install
graphify ./sizning-loyiha

Talablar: Python 3.10+ va AI model API kaliti.

Qayerda Turadi

Graphify Sourcegraph yoki Neo4j o'rnini egallashga intilmaydi. U o'rtadagi joyni egallaydi:

• Static analysis toollardan ko'ra semantik
• Vector-based retrievaldan ko'ra strukturali
• AI assistant context injection uchun mo'ljallangan

Murakkab loyihalarda, ayniqsa hujjatlar va tadqiqot ishlarini o'z ichiga olgan aralash kod bazalarida ishlaydigan developerlar uchun juda foydali.

Katta Rasm

Graphify kabi toollar kengroq tendentsiyani ifodalaydi: AI assistantlar faqat kod generatsiya qilmaydi, balki ular ishlayotgan sistemalarni tushunadi. Bilim grafigi vizualizatsiya hiyli emas — bu aniqroq, kontekstga sezgir tavsiyalar berishi mumkin bo'lgan reasoning struktura.

Graphify standartga aylanadimi — hali ko'rish kerak. Lekin muammosi haqiqiy. Kod bazalari murakkab, o'zaro bog'liq sistemalar. Ehtimol, ular graf-asosidagi toollarni haqliydir.

AI assistantlaringiz loyiha arxitekturasini tushunishda qiynalayotgan bo'lsangiz — Graphify bir kechki eksperimentga arziydi.