Graphicle yordamida kodlash agentlari uchun mahalliy kod grafigi va xotira yarating

Graphicle nima?

Graphicle — kodlash agentlari uchun repozitoriy kod grafigini loyiha xotirasi bilan birlashtiradigan mahalliy Rust dasturi. U fayllar, funksiyalar, sinflar, chaqiruvlar va importlarni indekslaydi, shuningdek hujjatlar, qarorlar, protseduralar va agentlarning avvalgi sessiyalarini eslab qoladi.

Agent yoki dasturchi savol berganida, Graphicle manba fayli va qatorlar oralig‘ini ko‘rsatadigan iqtibosli parchalarni qaytaradi. Kod grafigi va asosiy kontekst vositalari API kaliti yoki hisob qaydnomasisiz ishlaydi, Graphicle esa buni talab qiladigan model yoki ulagichni aniq sozlamaguningizcha hech qayerga ma’lumot yubormaydi.

Graphicle Claude Code, Cursor, Codex, VS Code, Claude Desktop va boshqa MCP mijozlari bilan ishlaydi. U buyruq qatori interfeysi, MCP serveri, brauzer ilovasi va SQLite asosidagi yagona ma’lumotlar omborini taqdim etadi.

Asosiy imkoniyatlar

• Kod grafigi: tree-sitter asosidagi parser yordamida fayllar, belgilar, chaqiruvlar, importlar, yo‘llar va ta’sirlangan kodni o‘rganing.
• Loyiha xotirasi: Markdown, PDF, Office va HTML hujjatlarini, ko‘rib chiqilgan qarorlarni, protseduralarni va saqlangan agent sessiyalarini qidiring.
• Iqtibosli kontekst: Modelni chaqirmasdan, token byudjeti doirasida kod va loyiha bilimlaridan tegishli parchalarni oling.
• Agent integratsiyasi: Qo‘llab-quvvatlanadigan kodlash agentlarini bitta sozlash buyrug‘i orqali MCP yordamida ulang.
• Kodga bog‘langan xotira: Ko‘rib chiqilgan xotiralarni ular tasvirlaydigan funksiyalarga biriktirish mumkin; bu kod o‘zgarganda xotiralar eskirgan deb belgilanadi.
• Mahalliy ishlash: Ma’lumotlar mahalliy saqlanadi, endpointlar sukut bo‘yicha loopback’da tinglaydi va Graphicle telemetriya yoki hisob qaydnomasidan foydalanmaydi.
• Avtomatik sinxronlash: Javoblardan oldin o‘zgargan fayllar sinxronlanadi, Git hook’lari esa commit, merge va checkout’dan keyin sinxronlashni ta’minlaydi.

Graphicle’ni o‘rnatish

Graphicle hozircha macOS va Linux’ni qo‘llab-quvvatlaydi. macOS yoki Homebrew o‘rnatilgan Linux tizimida eng sodda o‘rnatish usuli:

brew install graphicle-ai/tap/graphicle

Homebrew mavjud bo‘lmasa, reliz o‘rnatuvchisidan foydalaning:

curl -fsSL https://github.com/graphicle-ai/graphicle/releases/latest/download/install.sh | sh

Shuningdek, platformaga mos arxivni GitHub relizlar sahifasidan yuklab olishingiz mumkin. Windows uchun mahalliy qo‘llab-quvvatlash hozircha mavjud emas, ammo README Linux o‘rnatilishi WSL2 ostida ishlashi mumkinligini, lekin hali sinovdan o‘tkazilmaganini qayd etadi.

Repozitoriyni sozlash

Agentlaringiz tushunishi kerak bo‘lgan repozitoriyga o‘ting va sozlashni ishga tushiring:

cd your-repo
graphicle setup

Sozlash jarayoni repozitoriyni indekslaydi, uning kod grafigini yaratadi va topilgan kodlash agentlarini ulaydi. Kompyuteringizda o‘rnatilgan mijozlarga qarab, Claude Code, Codex, Cursor, VS Code, Claude Desktop va boshqa MCP mijozlari uchun MCP konfiguratsiyasini yangilashi mumkin.

Sozlash sessiyalarni yozib olishni ham yoqadi, Claude Code qidiruvlarini kod grafigiga yo‘naltiradi, AGENTS.md fayliga qisqa bo‘lim qo‘shadi va loyihani dolzarb saqlashga yordam beradigan Git hook’larini o‘rnatadi. Graphicle o‘zgartiradigan har bir faylni ko‘rsatadi va o‘zgartirishdan oldin zaxira nusxa yaratadi. Sozlash interaktiv so‘rovlarsiz ishlashi uchun quyidagidan foydalaning:

graphicle setup --yes

Integratsiya o‘zgarishlarini bekor qilish uchun quyidagini ishga tushiring:

graphicle disconnect

Disconnect buyrug‘i setup qo‘shgan narsalarni olib tashlaydi. U repozitoriyning mavjud Graphify chiqish katalogini o‘chirmaydi.

Terminaldan savollar berish

Sozlashdan keyin repozitoriyni qidirish uchun graphicle ask buyrug‘idan foydalaning:

graphicle ask "where is tax added to prices?"

Graphicle fayl nomlari, qatorlar oralig‘i, belgilar va parchalar bilan dalillarni qaytaradi. Natija quyidagicha ko‘rinishi mumkin:

Evidence for "where is tax added to prices?"
4 excerpts · 598 of 3,000 tokens

[1] shop/pricing.py:1-7  price_with_tax()
    """Prices and tax."""
    TAX_RATE = 0.2

    def price_with_tax(price):
        """A price with the sales tax added."""
        return round(price * (1 + TAX_RATE), 2)

Model sozlanmagan bo‘lsa, ask dalillarni ko‘rsatadi. Graphicle yozma javob qo‘shishi uchun Anthropic, OpenAI yoki Ollama kabi qo‘llab-quvvatlanadigan model provayderini sozlang:

graphicle config set model anthropic

Ollama orqali mahalliy modellar va OpenAI bilan mos serverlar ham qo‘llab-quvvatlanadi. Model sozlamalari uchun konfiguratsiya hujjatlariga qarang.

Graphicle’dan agent bilan foydalanish

graphicle setup MCP mijozini ulaganidan so‘ng, kodlash agentingizdan repozitoriy savollari uchun Graphicle’dan foydalanishni so‘rang. Masalan:

Muvaffaqiyatsiz so‘rovlar qayerda qayta yuborilishini Graphicle yordamida toping.

Agent Graphicle’ning kod grafigi va xotira vositalaridan foydalanishi, iqtibosli parchalarni olishi va bu natijalarni o‘z mulohazalari bilan birlashtirishi mumkin. Graphicle kod grafigi vositalari va xotira vositalarini o‘z ichiga olgan bitta MCP serverini taqdim etadi. Uning grafik vositalari qatoriga query_graph, get_neighbors va shortest_path kabi nomlar kiradi.

Grafik va loyiha xotirasini ko‘rish

Graphicle brauzer ilovasini ochish uchun quyidagini ishga tushiring:

graphicle open

Ilova kod grafigi, manba materiallari va loyiha xotirasini ko‘rish imkonini beradi. Taklif qilingan xotiralarni ko‘rib chiqish va tasdiqlash ham shu yerda amalga oshiriladi.

O‘rnatish va integratsiyalarni qamrab oluvchi holat tekshiruvini ishga tushirish uchun:

graphicle doctor

Agent ulana olmasa, sinxronlash to‘liq bo‘lmagandek ko‘rinsa yoki sozlangan muhitni tekshirmoqchi bo‘lsangiz, doctor buyrug‘idan foydalaning.

Bog‘liqliklar va ta’sirlangan kodni o‘rganish

Graphicle faqat koddan iborat grafikni yaratishi va so‘rashi mumkin. Avval grafikni ajratib oling:

graphicle graph extract . --code-only

Keyin qaysi kod belgiga bog‘liqligini so‘rang:

graphicle graph affected "retry()"

Graph buyrug‘i repozitoriy bo‘ylab qidirishi, belgilarni tushuntirishi, yo‘llarni kuzatishi va interaktiv HTML grafigini eksport qilishi mumkin. --code-only rejimi modelni talab qilmaydi.

Graphicle loyiha hujjatlaridagi kod tilga olingan joylarni ular havola qiladigan ta’riflar bilan ham bog‘lashi mumkin. Ushbu munosabatlarni ro‘yxatlash uchun hujjatlarni bog‘lovchi graph buyrug‘idan foydalaning:

graphicle call graph.doc_links

Javob modelisiz kontekstni olish

context buyrug‘i kod, hujjatlar, sessiyalar va ko‘rib chiqilgan xotiradan tegishli parchalarni oladi. U modelni chaqirmaydi:

graphicle context

Bir nechta repozitoriydan iborat ish maydoni uchun kontekstni butun ish maydoni bo‘ylab so‘rang:

graphicle context --workspace

Bu Graphicle’ni bir repozitoriydagi amalga oshirish boshqa repozitoriydagi hujjatlar yoki manba kodiga bog‘liq bo‘lganida foydali qiladi. Ish maydoni MCP konfiguratsiyasi MCP hujjatlarida bayon qilingan.

Sinxronlash va maxfiylikni tushunish

Sinxronlash vaqtida Graphicle .gitignore qoidalariga amal qiladi hamda muhit fayllari, kalitlar va hisob ma’lumotlarini o‘tkazib yuboradi. Sessiya yozuvi <private>...</private> oralig‘idagi kontentni olib tashlaydi va hisob ma’lumotlarini yashiradi.

macOS’da asosiy mahalliy ma’lumotlar jildi ~/Library/Application Support/Graphicle. Linux’da esa ~/.local/share/graphicle. graphicle graph extract orqali yaratilgan graf loyiha ichidagi .graphicle/ jildiga yoziladi.

Ilova, HTTP endpointlar va MCP endpointlar sukut bo‘yicha 127.0.0.1 manzilida tinglaydi. Tarmoqdan faqat sozlangan model yoki ulagich, hujjatlar yoki rasmlarni LLM’ga yuboradigan to‘liq graf ajratib olish, tanlangan GitHub CLI amallari yoki yangilanishlar tasmasi kabi tarmoqni talab qiladigan funksiyani so‘raganingizda foydalaniladi.

Kengaytirilgan maslahatlar

Javoblarni dalillarga asoslang

Agent da’volarini aniq fayllar va qatorlar bilan tekshirish uchun Graphicle taqdim etadigan iqtibosli parchalardan foydalaning. Bu, ayniqsa, xatolarni tuzatish, notanish repozitoriylarni tushunish va o‘zgarishlarni ko‘rib chiqishda foydalidir.

Taklif qilingan xotiralarni ko‘rib chiqing

Agent taklif qilgan xotiralar avtomatik ravishda ishonchli loyiha bilimiga aylanmaydi. Tasdiqlashdan oldin ularni ilovada ko‘rib chiqing. Kod belgilariga biriktirilgan xotiralar tegishli kod o‘zgarganda eskirishi mumkin, ayni faylning boshqa joylaridagi tahrirlar esa odatda ularni dolzarb holda qoldiradi.

Joriy kontekst uchun Git hook’laridan foydalaning

Sozlash vaqtida o‘rnatilgan hook’larni saqlab, repozitoriyni sinxron holda tuting. Ular commit, merge va checkout’dan keyin sinxronlaydi, Graphicle esa javob berishdan oldin o‘zgartirilgan fayllarni ham sinxronlaydi.

Repozitoriy cheklovlarini sozlang

Sukut bo‘yicha loyiha 100 000 tagacha matn fayli va 1 GiB hajmdagi matnni o‘z ichiga olishi mumkin. Kattaroq repozitoriy bilan ishlayotgan bo‘lsangiz, konfiguratsiyada bu cheklovlarni oshirish mumkin. Juda katta fayllar qisman tahlil qilinishi yoki sinxronlashni to‘xtatish o‘rniga qidiriladigan matn sifatida saqlanishi mumkin.

Boshqa MCP mijozini ulang

Graphicle avtomatik aniqlamaydigan mijozlar uchun MCP qo‘llanmasida bayon qilingan qisqa JSON MCP konfiguratsiyasini qo‘shing. Xuddi shu MCP serveri graf va xotira imkoniyatlarining ikkalasini ham taqdim etadi.

Xulosa

Graphicle kodlash agentlariga repozitoriy tuzilishi va loyiha bilimlarining mahalliy, qidiriladigan ko‘rinishini beradi. Uni o‘rnating, graphicle setup buyrug‘ini ishga tushiring va kodni iqtiboslar bilan tekshirish uchun ask, context, open va graph buyruqlaridan foydalaning. Yaratilgan javoblarni xohlaganingizdagina modelni sozlang; graf, sinxronlash, MCP serveri, sessiya yozuvi va ilova modelsiz ham ishlashi mumkin.

Batafsil ma’lumot uchun loyihaning tezkor boshlash qo‘llanmasi, agentlar qo‘llanmasi, konfiguratsiya ma’lumotnomasi va FAQ bo‘limlariga murojaat qiling.