Jenga Grafu ya Msimbo ya Ndani na Kumbukumbu kwa Mawakala wa Uandishi wa Msimbo kwa Graphicle

Graphicle ni nini?

Graphicle ni programu ya Rust inayofanya kazi ndani ya kompyuta yako na kuchanganya grafu ya msimbo wa hazina pamoja na kumbukumbu ya mradi kwa mawakala wa uandishi wa msimbo. Huorodhesha faili, vitendaji, madarasa, miito na uagizaji, huku pia ikikumbuka nyaraka, maamuzi, taratibu na vipindi vya awali vya mawakala.

Wakala au msanidi anapouliza swali, Graphicle hurudisha dondoo zilizonukuliwa zinazoonyesha faili chanzo na masafa ya mistari. Grafu ya msimbo na zana kuu za muktadha hufanya kazi bila ufunguo wa API au akaunti, na Graphicle haitumi data popote isipokuwa usanidi kwa uwazi modeli au kiunganishi kinachohitaji hilo.

Graphicle hufanya kazi na Claude Code, Cursor, Codex, VS Code, Claude Desktop na wateja wengine wa MCP. Hutoa kiolesura cha mstari wa amri, seva ya MCP, programu ya kivinjari na hifadhi moja ya data inayotumia SQLite.

Vipengele muhimu

• Grafu ya msimbo: Chunguza faili, alama, miito, uagizaji, njia na msimbo ulioathiriwa kwa kutumia kichanganua kinachotegemea tree-sitter.
• Kumbukumbu ya mradi: Tafuta katika hati za Markdown, PDF, Office na HTML, maamuzi yaliyopitiwa, taratibu na vipindi vilivyorekodiwa vya mawakala.
• Muktadha ulionukuliwa: Pata dondoo husika kutoka kwenye msimbo na maarifa ya mradi ndani ya bajeti ya tokeni, bila kuita modeli.
• Ujumuishaji wa mawakala: Unganisha mawakala wa uandishi wa msimbo wanaotumika kupitia MCP kwa amri moja ya usanidi.
• Kumbukumbu iliyounganishwa na msimbo: Kumbukumbu zilizopitiwa zinaweza kuunganishwa na vitendaji vinavyovieleza na huwa za zamani msimbo huo unapobadilika.
• Uendeshaji wa ndani kwanza: Data huhifadhiwa ndani, ncha husikiliza kwenye loopback kwa chaguo-msingi, na Graphicle haitumii telemetry wala akaunti.
• Usawazishaji wa kiotomatiki: Faili zilizobadilika husawazishwa kabla ya majibu, huku hooks za Git zikiweza kusawazisha baada ya commit, merge na checkout.

Sakinisha Graphicle

Kwa sasa Graphicle inatumika kwenye macOS na Linux. Njia rahisi zaidi ya usakinishaji kwenye macOS au mfumo wa Linux wenye Homebrew ni:

brew install graphicle-ai/tap/graphicle

Ikiwa Homebrew haipatikani, tumia kisakinishaji cha toleo:

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

Pia unaweza kupakua jalada maalum la jukwaa kutoka ukurasa wa matoleo wa GitHub. Usaidizi asilia wa Windows haupatikani kwa sasa, ingawa README inasema kuwa usakinishaji wa Linux unaweza kufanya kazi chini ya WSL2 na bado haujajaribiwa.

Sanidi hazina

Ingia kwenye hazina unayotaka mawakala wako waielewe, kisha endesha usanidi:

cd your-repo
graphicle setup

Mchakato wa usanidi huorodhesha hazina, huunda grafu yake ya msimbo na kuunganisha mawakala wa uandishi wa msimbo unaowapata. Kulingana na wateja waliosakinishwa kwenye kompyuta yako, unaweza kusasisha usanidi wa MCP kwa Claude Code, Codex, Cursor, VS Code, Claude Desktop na wateja wengine wa MCP.

Usanidi pia huwezesha kunasa vipindi, huelekeza utafutaji wa Claude Code kwenye grafu ya msimbo, huongeza sehemu fupi kwenye AGENTS.md na kusakinisha hooks za Git zinazosaidia kuuweka mradi katika hali ya sasa. Graphicle huorodhesha kila faili inachobadilisha na huunda nakala rudufu kabla ya kuibadilisha. Ili kuruhusu usanidi kuendelea bila vidokezo shirikishi, tumia:

graphicle setup --yes

Ili kutendua mabadiliko ya ujumuishaji, endesha:

graphicle disconnect

Amri ya disconnect huondoa ulichoongeza na usanidi. Haifuti saraka ya matokeo ya Graphify iliyopo ya hazina.

Uliza maswali kutoka kwenye terminali

Baada ya usanidi, tumia graphicle ask kutafuta kwenye hazina:

graphicle ask "where is tax added to prices?"

Graphicle hurudisha ushahidi wenye majina ya faili, masafa ya mistari, alama na dondoo. Matokeo yanaweza kuonekana hivi:

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)

Bila modeli iliyosanidiwa, ask huonyesha ushahidi. Ili Graphicle iongeze jibu lililoandikwa, sanidi mtoa modeli anayetumika kama Anthropic, OpenAI au Ollama:

graphicle config set model anthropic

Modeli za ndani kupitia Ollama na seva zinazooana na OpenAI pia zinatumika. Angalia nyaraka za usanidi kwa mipangilio ya modeli.

Tumia Graphicle na wakala

Baada ya graphicle setup kuunganisha mteja wa MCP, mwombe wakala wako wa uandishi wa msimbo atumie Graphicle kwa maswali kuhusu hazina. Kwa mfano:

Tumia Graphicle kupata mahali ambapo maombi yaliyoshindwa yanajaribiwa tena.

Wakala anaweza kutumia zana za grafu ya msimbo na kumbukumbu za Graphicle, kupokea dondoo zilizonukuliwa na kuchanganya matokeo hayo na mantiki yake yenyewe. Graphicle hutoa seva moja ya MCP iliyo na zana za grafu ya msimbo na zana za kumbukumbu. Zana zake za grafu zinajumuisha majina kama query_graph, get_neighbors na shortest_path.

Vinjari grafu na kumbukumbu ya mradi

Ili kufungua programu ya kivinjari ya Graphicle, endesha:

graphicle open

Programu hukuruhusu kuvinjari grafu ya msimbo, nyenzo chanzo na kumbukumbu ya mradi. Pia hapo ndipo kumbukumbu zilizopendekezwa zinaweza kupitiwa na kuidhinishwa.

Kwa ukaguzi wa hali unaohusu usakinishaji na miunganisho, endesha:

graphicle doctor

Tumia doctor wakati wakala hawezi kuunganisha, usawazishaji unaonekana haujakamilika au unataka kuthibitisha mazingira yaliyosanidiwa.

Chunguza utegemezi na msimbo ulioathiriwa

Graphicle inaweza kujenga na kuuliza kwenye grafu ya msimbo pekee. Kwanza toa grafu:

graphicle graph extract . --code-only

Kisha uliza ni msimbo gani unategemea ishara fulani:

graphicle graph affected "retry()"

Amri ya graph inaweza kutafuta kwenye hazina, kueleza ishara, kufuatilia njia, na kuhamisha grafu shirikishi ya HTML. Hali ya --code-only haihitaji modeli.

Graphicle pia inaweza kuunganisha marejeo ya msimbo katika hati za mradi na ufafanuzi unaorejelewa. Tumia amri ya graph ya kuunganisha hati kuorodhesha mahusiano hayo:

graphicle call graph.doc_links

Pata muktadha bila modeli ya majibu

Amri ya context hupata dondoo zinazohusiana kutoka kwenye msimbo, hati, vipindi, na kumbukumbu zilizokaguliwa. Haiiti modeli:

graphicle context

Kwa nafasi ya kazi iliyo na hazina nyingi, omba muktadha katika nafasi yote ya kazi:

graphicle context --workspace

Hii hufanya Graphicle kuwa muhimu wakati utekelezaji katika hazina moja unategemea nyaraka au msimbo wa chanzo katika hazina nyingine. Usanidi wa MCP wa nafasi ya kazi umeelezwa katika nyaraka za MCP.

Elewa usawazishaji na faragha

Wakati wa usawazishaji, Graphicle huheshimu .gitignore na kuruka faili za mazingira, funguo, na vitambulisho vya siri. Ukusanyaji wa vipindi huondoa maudhui yaliyo ndani ya sehemu za <private>...</private> na kuficha vitambulisho vya siri.

Kwenye macOS, folda kuu ya data ya ndani ni ~/Library/Application Support/Graphicle. Kwenye Linux, ni ~/.local/share/graphicle. Grafu iliyoundwa na graphicle graph extract huandikwa kwenye .graphicle/ ndani ya mradi.

Programu, vituo vya HTTP, na vituo vya MCP husikiliza kwenye 127.0.0.1 kwa chaguo-msingi. Ufikiaji wa mtandao hutokea tu unapoomba kipengele kinachouhitaji, kama vile modeli au kiunganishi kilichosanidiwa, uchimbaji kamili wa grafu unaotuma hati au picha kwa LLM, shughuli zilizochaguliwa za GitHub CLI, au mlisho wa masasisho.

Vidokezo vya kina

Weka majibu yakitegemea ushahidi

Tumia dondoo zenye marejeo ya Graphicle kuthibitisha madai ya wakala dhidi ya faili na mistari halisi. Hii ni muhimu hasa kwa utatuzi wa hitilafu, kuelewa hazina usizozoea, na kukagua mabadiliko.

Kagua kumbukumbu zilizopendekezwa

Kumbukumbu zinazopendekezwa na wakala haziji kuwa maarifa yanayoaminika ya mradi kiotomatiki. Zikague kwenye programu kabla ya kuziidhinisha. Kumbukumbu zilizounganishwa na ishara za msimbo zinaweza kupitwa na wakati msimbo unaohusiana unapobadilika, huku mabadiliko mahali pengine katika faili hilohilo kwa kawaida yakiziacha zikiwa za sasa.

Tumia hooks za Git kwa muktadha wa sasa

Weka hazina ikiwa imesawazishwa kwa kuhifadhi hooks zilizosakinishwa wakati wa usanidi. Husawazisha baada ya commits, merges, na checkouts, huku Graphicle pia ikisawazisha faili zilizobadilishwa kabla ya jibu.

Rekebisha mipaka ya hazina

Kwa chaguo-msingi, mradi unaweza kuwa na hadi faili 100,000 za maandishi na 1 GiB ya maandishi. Mipaka inaweza kuongezwa katika usanidi ikiwa unafanya kazi na hazina kubwa zaidi. Faili kubwa sana zinaweza kuchanganuliwa kwa sehemu au kuhifadhiwa kama maandishi yanayoweza kutafutwa badala ya kusimamisha usawazishaji.

Unganisha mteja mwingine wa MCP

Kwa wateja ambao Graphicle haiwatambui kiotomatiki, ongeza usanidi mfupi wa JSON wa MCP ulioelezwa katika mwongozo wa MCP. Seva hiyo hiyo ya MCP hutoa uwezo wa grafu na kumbukumbu.

Hitimisho

Graphicle huwapa mawakala wa usimbaji mwonekano wa ndani unaoweza kutafutwa wa muundo wa hazina na maarifa ya mradi. Isakinishe, endesha graphicle setup, na utumie ask, context, open, na graph kuchunguza msimbo wenye marejeo. Sanidi modeli tu unapotaka majibu yaliyotengenezwa; grafu, usawazishaji, seva ya MCP, ukusanyaji wa vipindi, na programu vinaweza kufanya kazi bila modeli.

Kwa maelezo zaidi, endelea na mwongozo wa kuanza haraka, mwongozo wa mawakala, marejeo ya usanidi, na Maswali Yanayoulizwa Mara kwa Mara ya mradi.