Yakha Igrafu Yekhodi Yendawo Nenkumbulo Yama-Agent Okubhala Ikhodi nge-Graphicle

Yini i-Graphicle?

I-Graphicle wuhlelo lwasendaweni olubhalwe nge-Rust oluhlanganisa igrafu yekhodi yenqolobane nolwazi lwephrojekthi olusetshenziswa ama-agent okubhala ikhodi. Ikhomba amafayela, imisebenzi, amakilasi, izingcingo, nama-import, futhi ikhumbula imibhalo, izinqumo, izinqubo, kanye nezikhathi zangaphambilini zama-agent.

Lapho i-agent noma umthuthukisi ebuza umbuzo, i-Graphicle ibuyisa izingcaphuno ezinezinkomba ezikhomba ifayela lomthombo nobubanzi bemigqa. Igrafu yekhodi namathuluzi omongo ayisisekelo kusebenza ngaphandle kokhiye we-API noma i-akhawunti, futhi i-Graphicle ayithumeli idatha kwenye indawo ngaphandle kokuthi ulungise ngokusobala imodeli noma isixhumi esidingayo.

I-Graphicle isebenza ne-Claude Code, Cursor, Codex, VS Code, Claude Desktop, namanye amaklayenti e-MCP. Ihlinzeka ngesixhumi somugqa womyalo, iseva ye-MCP, uhlelo lwesiphequluli, kanye nesitolo sedatha esisodwa esisekelwe ku-SQLite.

Izici ezibalulekile

• Igrafu yekhodi: Hlola amafayela, izimpawu, izingcingo, ama-import, izindlela, kanye nekhodi ethintekayo usebenzisa i-parser esekelwe ku-tree-sitter.
• Ulwazi lwephrojekthi: Sesha imibhalo ye-Markdown, PDF, Office, ne-HTML, izinqumo ezibuyekeziwe, izinqubo, kanye nezikhathi zama-agent ezirekhodiwe.
• Umongo onezinkomba: Thola izingcaphuno ezifanele ezivela kukhodi nolwazi lwephrojekthi ngaphakathi komkhawulo wamathokheni, ngaphandle kokubiza imodeli.
• Ukuhlanganiswa nama-agent: Xhuma ama-agent okubhala ikhodi asekelwayo nge-MCP usebenzisa umyalo owodwa wokusetha.
• Ulwazi oluxhumene nekhodi: Ulwazi olubuyekeziwe lungaxhunywa emisebenzini oluyichazayo futhi lube olungasasebenzi lapho leyo khodi ishintsha.
• Ukusebenza kuqala endaweni: Idatha igcinwa endaweni, iziphetho zilalela ku-loopback ngokuzenzakalelayo, futhi i-Graphicle ayisebenzisi i-telemetry noma i-akhawunti.
• Ukuvumelanisa okuzenzakalelayo: Amafayela ashintshiwe ayavumelaniswa ngaphambi kwezimpendulo, kanti ama-Git hook angavumelanisa ngemva kwama-commit, ama-merge, nama-checkout.

Faka i-Graphicle

I-Graphicle okwamanje isekela i-macOS ne-Linux. Indlela elula yokuyifaka ku-macOS noma kusistimu ye-Linux ene-Homebrew yile:

brew install graphicle-ai/tap/graphicle

Uma i-Homebrew ingatholakali, sebenzisa isifaki sokukhishwa:

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

Ungalanda futhi ingobo yomlando eqondene nenkundla ekhasini lokukhishwa le-GitHub. Ukusekelwa komdabu kwe-Windows akutholakali okwamanje, nakuba i-README iphawula ukuthi ukufakwa kwe-Linux kungase kusebenze ngaphansi kwe-WSL2 futhi akukahlolwa.

Setha inqolobane

Shintshela enqolobaneni ofuna ama-agent akho ayiqonde, bese usebenzisa ukusetha:

cd your-repo
graphicle setup

Inqubo yokusetha ikhomba inqolobane, yakha igrafu yayo yekhodi, futhi ixhuma ama-agent okubhala ikhodi ewatholayo. Kuya ngamaklayenti afakiwe emshinini wakho, ingabuyekeza ukumiswa kwe-MCP kwe-Claude Code, Codex, Cursor, VS Code, Claude Desktop, namanye amaklayenti e-MCP.

Ukusetha kuphinde kunike amandla ukuthwebula izikhathi, kuqondise ukusesha kwe-Claude Code kugrafu yekhodi, kwengeze isigaba esifushane ku-AGENTS.md, futhi kufake ama-Git hook asiza ukugcina iphrojekthi isesikhathini. I-Graphicle ibala wonke amafayela ewashintshayo futhi idale ikhophi eyisipele ngaphambi kokuwashintsha. Ukuze ukusetha kusebenze ngaphandle kwemiyalo yokusebenzisana, sebenzisa:

graphicle setup --yes

Ukuze uhlehlise izinguquko zokuhlanganisa, sebenzisa:

graphicle disconnect

Umyalo we-disconnect ususa lokho okwengezwe ukusetha. Awususi ifolda ekhona yokukhishwa kwe-Graphify yenqolobane.

Buza imibuzo kutheminali

Ngemva kokusetha, sebenzisa i-graphicle ask ukusesha inqolobane:

graphicle ask "where is tax added to prices?"

I-Graphicle ibuyisa ubufakazi obunamagama amafayela, ububanzi bemigqa, izimpawu, nezingcaphuno. Umphumela ungabukeka kanje:

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)

Ngaphandle kwemodeli emisiwe, i-ask ibonisa ubufakazi. Ukuze i-Graphicle ingeze impendulo ebhaliwe, lungisa umhlinzeki wemodeli osekelwayo njenge-Anthropic, OpenAI, noma Ollama:

graphicle config set model anthropic

Amamodeli asendaweni asebenzisa i-Ollama namaseva ahambisana ne-OpenAI nawo ayasekelwa. Bona imibhalo yokumisa ukuze uthole izilungiselelo zemodeli.

Sebenzisa i-Graphicle ne-agent

Uma i-graphicle setup isixhume iklayenti le-MCP, cela i-agent yakho yokubhala ikhodi ukuthi isebenzise i-Graphicle emibuzweni yenqolobane. Isibonelo:

Sebenzisa i-Graphicle ukuthola lapho izicelo ezihlulekile ziphindwa khona.

I-agent ingasebenzisa amathuluzi egrafu yekhodi nawe-memory e-Graphicle, ithole izingcaphuno ezinezinkomba, futhi ihlanganise leyo miphumela nokucabanga kwayo. I-Graphicle iveza iseva eyodwa ye-MCP equkethe amathuluzi egrafu yekhodi namathuluzi olwazi. Amathuluzi egrafu afaka amagama afana ne-query_graph, get_neighbors, ne-shortest_path.

Phequlula igrafu nolwazi lwephrojekthi

Ukuvula uhlelo lwesiphequluli lwe-Graphicle, sebenzisa:

graphicle open

Uhlelo lukuvumela ukuthi uphequlule igrafu yekhodi, izinto zomthombo, nolwazi lwephrojekthi. Yilapho futhi kungabuyekezwa futhi kuvunywe khona ulwazi oluphakanyisiwe.

Ukuze uhlole impilo yokufakwa nokuhlanganiswa, sebenzisa:

graphicle doctor

Sebenzisa i-doctor lapho i-agent ingakwazi ukuxhuma, ukuvumelanisa kubonakala kungaphelele, noma ufuna ukuqinisekisa indawo emisiwe.

Hlola ukuncika nekhodi ethintekayo

I-Graphicle ingakha futhi ibuze igrafu yekhodi kuphela. Qala ngokukhipha igrafu:

graphicle graph extract . --code-only

Bese ubuza ukuthi iyiphi ikhodi encike kuphawu:

graphicle graph affected "retry()"

Umyalo we-graph ungasesha indawo yokugcina ikhodi, uchaze izimpawu, ulandele izindlela, futhi ukhiphe igrafu ye-HTML esebenzisanayo. Imodi ye---code-only ayidingi imodeli.

I-Graphicle ingaxhumanisa nokushiwo kwekhodi emibhalweni yephrojekthi nezincazelo ezibhekiselwa kuzo. Sebenzisa umyalo we-graph wokuxhumanisa imibhalo ukuze ubhale lobo budlelwano:

graphicle call graph.doc_links

Thola umongo ngaphandle kwemodeli yezimpendulo

Umyalo we-context uthola izingcaphuno ezifanele kukhodi, emibhalweni, kumaseshini, nasenkumbulweni ebuyekeziwe. Awubizi imodeli:

graphicle context

Endaweni yokusebenza enamarepository amaningi, cela umongo kuyo yonke indawo yokusebenza:

graphicle context --workspace

Lokhu kwenza i-Graphicle ibe wusizo lapho ukuqaliswa kwenye repository kuncike emibhalweni noma kukhodi yomthombo kwenye repository. Ukucushwa kwe-Workspace MCP kuchazwe kumadokhumenti e-MCP.

Qonda ukuvumelanisa nobumfihlo

Ngesikhathi sokuvumelanisa, i-Graphicle ihlonipha i-.gitignore futhi yeqa amafayela emvelo, okhiye, nemininingwane yokungena. Ukuthwebula amaseshini kususa okuqukethwe okungaphakathi kwezikhala ze-<private>...</private> futhi kufihla imininingwane yokungena.

Ku-macOS, ifolda eyinhloko yedatha yasendaweni yi-~/Library/Application Support/Graphicle. Ku-Linux, yi-~/.local/share/graphicle. Igrafu eyenziwe yi-graphicle graph extract ibhalwa ku-.graphicle/ ngaphakathi kwephrojekthi.

Uhlelo lokusebenza, ama-endpoint e-HTTP, nama-endpoint e-MCP alalela ku-127.0.0.1 ngokuzenzakalelayo. Ukufinyelela kunethiwekhi kwenzeka kuphela uma ucela isici esikudinga, njengemodeli noma isixhumi esilungiselelwe, ukukhipha igrafu ephelele okuthumela imibhalo noma izithombe ku-LLM, imisebenzi ethile ye-GitHub CLI, noma okuphakelayo kwezibuyekezo.

Amathiphu athuthukile

Gcina izimpendulo zisekelwe ebufakazini

Sebenzisa izingcaphuno ezinezingcaphuno ze-Graphicle ukuze uqinisekise izimangalo ze-agent ngokuzihlola kumafayela nemigqa ngqo. Lokhu kuwusizo ikakhulukazi ekulungiseni amaphutha, ekuqondeni ama-repository ongawajwayele, nasekubuyekezeni izinguquko.

Buyekeza izinkumbulo eziphakanyisiwe

Izinkumbulo eziphakanyiswe yi-agent azibi ulwazi oluthembekile lwephrojekthi ngokuzenzakalelayo. Zibuyekeze ohlelweni ngaphambi kokuzivuma. Izinkumbulo ezixhunywe ezimpawini zekhodi zingaphelelwa yisikhathi lapho ikhodi ehambisanayo ishintsha, kanti ukuhlela kwenye indawo kufayela elifanayo kuvame ukuzishiya zisesikhathini.

Sebenzisa ama-Git hook ukuze ugcine umongo wamanje

Gcina i-repository ivumelanisiwe ngokugcina ama-hook afakwe ngesikhathi sokusetha. Avumelanisa ngemva kwama-commit, ama-merge, nama-checkout, kanti i-Graphicle iphinde ivumelanise amafayela ashintshwe ngaphambi kwempendulo.

Lungisa imikhawulo ye-repository

Ngokuzenzakalelayo, iphrojekthi ingaqukatha amafayela ombhalo afinyelela ku-100,000 kanye no-1 GiB wombhalo. Imikhawulo inganyuswa ekucushweni uma usebenza ne-repository enkulu. Amafayela amakhulu kakhulu angahlaziywa ngokwengxenye noma agcinwe njengombhalo oseshwayo esikhundleni sokumisa ukuvumelanisa.

Xhuma elinye iklayenti le-MCP

Kumaklayenti i-Graphicle engawatholi ngokuzenzakalelayo, engeza ukucushwa okufushane kwe-JSON MCP okuchazwe kumhlahlandlela we-MCP. Iseva efanayo ye-MCP inikeza kokubili amandla e-graph nawe-memory.

Isiphetho

I-Graphicle inikeza ama-agent ekhodi umbono wasendaweni, oseshwayo wesakhiwo se-repository nolwazi lwephrojekthi. Yifake, sebenzisa i-graphicle setup, bese usebenzisa u-ask, u-context, u-open, no-graph ukuze uphenye ikhodi ngezingcaphuno. Lungisa imodeli kuphela uma ufuna izimpendulo ezikhiqiziwe; i-graph, ukuvumelanisa, iseva ye-MCP, ukuthwebula amaseshini, nohlelo lokusebenza kungasebenza ngaphandle kwayo.

Ukuze uthole imininingwane eyengeziwe, qhubeka ngesiqalo esisheshayo sephrojekthi, umhlahlandlela wama-agent, ireferensi yokucushwa, kanye nemibuzo evame ukubuzwa.