Ukuqalisa nge-iCode: Qalisa futhi Lungiselela Itheminali Ye-ejenti ye-AI

Yini iCode?

iCode uhlelo lwetheminali oluwumthombo ovulekile lokuhlela nokuphatha ama-agent e-AI kanye nama-workflow. Luhlanganisa izingxoxo, amaphrofayela amamodeli, ukumiswa kwama-agent, ukufinyelela ku-shell, umehluko wamafayela, izilawuli zokubuyisela emuva, nokuhlaziywa kokwenziwa kube isikhombimsebenzisi esisodwa.

Umsebenzi usaqhubeka: Izikhombimsebenzisi, amafomethi wamafayela, kanye nezilungiselelo ezizenzakalelayo ze-iCode zingashintsha phakathi kokukhishwa.

iCode ayifaki imodeli ye-AI. Kunalokho, uxhuma abahlinzeki bamamodeli ngokwakho bese ukhetha ukuthi iyiphi iphrofayela emisiwe okufanele isetshenziswe yi-agent.

Izici ezibalulekile

• Ingxoxo yetheminali: Buka izimpendulo ze-Markdown ezicebile, okuhlanganisa izinhlu ezifomethwe nemidwebo.
• Ama-agent alungisekayo: Chaza imiyalelo, amathuluzi, ama-sub-agent, amakhono, amaseva e-MCP, kanye nememori ngaphandle kokubhala ikhodi ye-agent.
• Amaphrofayela amaningi wamamodeli: Lungisa amaphrofayela avela kubahlinzeki abahlukene bese ushintsha amamodeli phakathi nengxoxo.
• Ukubukwa kwe-workflow: Landela ama-workflow i-node ngayinye bese uhlola imodeli, izingcingo zamathuluzi, kanye nokusetshenziswa kwama-token kwe-node ngayinye ye-agent.
• Ukubuyekeza izinguquko: Hlola wonke amafayela ashintshwe yi-agent ekubukweni komehluko okuhlanganisiwe noma okuhlukanisiwe.
• Ukubuyisela emuva: Khetha i-turn yangaphambilini, buyekeza izinguquko ezizobuyiselwa emuva, bese ulahla ingxoxo ngemva kwalelo phuzu.
• Ukuhlaziywa kwe-trajectory: Hlola ukuhlukaniswa kwesikhathi, ama-token, i-cache, kanye ne-parallelism, kanye nezingcingo zamamodeli, ama-hook, nezingcingo zamathuluzi.
• I-shell edidiyelwe: Sebenzisa itheminali yangempela ngaphakathi kwe-iCode, okuhlanganisa nezinhlelo ezisebenzisa isikrini esigcwele.

Okudingekayo

Okuwukuphela kwento edingekayo yi-uv. Ihlinzeka nge-Python 3.14 yephrojekthi, ngakho awudingi ukufaka lolo hlobo lwe-Python ngokwehlukana.

Sebenzisa itheminali yesimanje ukuze uthole ulwazi olungcono. I-README incoma i-Windows Terminal ku-Windows noma i-Ghostty ku-macOS ne-Linux.

Faka bese usebenzisa iCode

Qala ngekhophi yendawo ye-repository. Vula itheminali kufolda yayo eyinhloko bese uvumelanisa iphrojekthi nazo zonke izengezo ezidingekayo:

uv sync --extra all

Sebenzisa i---extra all njengoba injalo. Iphrojekthi ixwayisa ngokukhethekile ngokusebenzisa i-uv sync engenalutho noma ngokushintsha le nketho ibe yi---all-extras.

Okulandelayo, landa i-ripgrep binary efakwe neprojekthi. Ku-macOS noma ku-Linux, sebenzisa:

./scripts/fetch_rg.sh

Ku-Windows, sebenzisa iskripthi se-PowerShell esikhundleni salokho:

.\scripts\fetch_rg.ps1

Ekugcineni, qalisa iCode:

uv run icode

Igama lekhodi lephrojekthi ngu-Chrys, ngakho lo myalo uqala uhlelo olufanayo:

uv run chrys

Lungisa imodeli yakho yokuqala

iCode iza ingenawo amaphrofayela wamamodeli. Ekuqaliseni kokuqala, cindezela u-F4 ukuze uvule i-Model Configuration bese wengeza iphrofayela yomhlinzeki wemodeli oyisebenzisayo.

Ngemva kokulungisa amaphrofayela, ungagcina amaphrofayela abahlinzeki abahlukene eceleni bese ushintsha phakathi kwawo ngesikhathi sengxoxo. Njengoba iCode inganikezi imodeli uqobo, uxhumano lomhlinzeki olulungisayo lunquma ukuthi izicelo zamamodeli zithunyelwa kuphi.

Ukusetshenziswa okuyisisekelo

Zulazula kubha yokufaka

Isikrini sasekhaya sigcina i-agent yamanje, imodeli, imodi yokugunyaza, kanye neseshini kubonakala. Izandiso eziningana zinikeza ukufinyelela okusheshayo emisebenzini ebalulekile:

• # ifinyelela kuma-agent.
• $ ifinyelela kumamodeli.
• / ifinyelela emiyalweni.
• @ ifinyelela kumafayela.
• ! ifinyelela ku-shell.

Qala ingxoxo

Khetha i-agent nemodeli emisiwe, bese ufaka isicelo sakho kubha yokufaka. Izimpendulo zivezwa njenge-Markdown ecebile ngqo etheminali. Lapho i-agent ishintsha amafayela, iCode igcina lezo zinguquko ukuze ukwazi ukuzibuyekeza nge-turn ngayinye noma zonke ndawonye.

Lungisa i-agent

Cindezela u-F2 ukuze uvule i-Agent Configuration. I-agent iwukucushwa, hhayi ikhodi yohlelo. Kulesi sikrini, ungahlela imiyalelo yayo, amathuluzi, ama-sub-agent, amakhono, amaseva e-MCP, kanye nememori.

Gcina imiyalelo ye-agent ihambisana nenhloso yayo, futhi uvule kuphela amathuluzi nokuhlanganiswa ekudingayo. Lokhu kubalulekile futhi kubumfihlo ngoba amathuluzi angaphandle namaseva angase aphathe idatha ngokuzimela.

Buyekeza izinguquko zamafayela

Sebenzisa isibukeli se-diff ukuze uhlole amafayela ashintshwe yi-agent. Ungabuyekeza izinguquko nge-turn eyodwa ngesikhathi noma uziqoqe zibe ukubuka okuphelele. Kokubili ukuboniswa okuhlanganisiwe nokuhlukanisiwe kuyatholakala.

Qalisa futhi uhlole ama-workflow

Imodi ye-workflow ikuvumela ukuthi ubuke i-workflow isebenza i-node ngayinye. Ku-node ngayinye ye-agent, iCode ingabonisa imodeli ekhethiwe, izingcingo zayo zamathuluzi, kanye nokusetshenziswa kwama-token.

Lo mbono uwusizo lapho umsebenzi ubandakanya izigaba noma ama-agent amaningi. Esikhundleni sokuphatha ukwenziwa njengempendulo eyodwa engacacile, ungabona ukuthi umsebenzi uhamba kanjani kugrafu.

Amathiphu athuthukile

Sebenzisa ukubuyisela emuva ngaphambi kokuqhubeka ngemuva kwesinyathelo esingalungile

Uma ingxoxo ikhiqiza izinguquko ongazifuni, khetha isinyathelo sangaphambilini bese uvula ukubuyisela emuva. I-iCode ikubonisa ukuthi yiziphi izinguquko zamafayela ezizobuyiselwa emuva ngaphambi kokusebenzisa ukubuyisela emuva. Bese ilahla ingxenye yengxoxo elandela isinyathelo esikhethiwe.

Buyekeza ngokucophelela izinguquko zamafayela ezihlongozwayo ngaphambi kokuqinisekisa, ikakhulukazi lapho izinyathelo eziningana ziguqule amafayela afanayo.

Hlaziya ukwenziwa nge-Trajectory

Cindezela u-F12 ukuze uvule umbono we-trajectory. Uhlolojikelele lwawo luchaza ukuthi isikhathi nama-token kusetshenziswe kuphi, luhlukanise umsebenzi wemodeli, ukwenziwa kwamathuluzi, nokulinda. Luphinde lunikeze ukusetshenziswa kwama-token ne-cache ngesinyathelo ngasinye, kanye nolwazi lokusebenza ngokufana.

Umugqa wesikhathi ungena emininingwaneni yezingcingo zemodeli ngazinye, ama-hook, nezingcingo zamathuluzi ngaphakathi kwesinyathelo. Wusebenzise ukuphenya ukusebenzisana okubizayo noma okuhamba kancane nokuqonda ukulandelana kwemisebenzi.

Sebenzisa i-shell ehlanganisiwe

Faka ku-shell ngo-!. Lena yi-terminal yangempela, hhayi iphaneli elinomkhawulo lokubonisa imiyalo, ngakho izinhlelo ezisebenzisa isikrini esigcwele zingasebenza lapho futhi zamukele konke ukucindezelwa kokhiye.

Khumbula ukuthi imiyalo, ama-script wamakhono, nama-workflow yizinhlelo ezizimele ezinokufinyelela kunethiwekhi yakho. Buyekeza ukuthi zenzani ngaphambi kokuzisebenzisa, ikakhulukazi ezindaweni ezibucayi.

Vula umhlahlandlela ophelele womsebenzisi

Cindezela u-F8 ngaphakathi kwe-iCode ukuze uvule umhlahlandlela womsebenzisi owakhelwe ngaphakathi. Amadokhumenti afanayo ayatholakala ku-directory ye-docs/ ku-repository ngesiNgisi nangesiShayina Esenziwe Lula.

Ubumfihlo nokuxhumana kwangaphandle

I-iCode ayinayo i-telemetry, i-analytics, noma ukubika ukuphahlazeka futhi ayiqoqi idatha yakho. Ngokuzenzakalelayo, ayithumeli lutho, kuhlanganise nedatha yokusetshenziswa, kuphrojekthi noma kwabanye abantu besithathu.

Idatha isengadluliselwa ezindaweni ozilungiselelayo, kuhlanganise kubahlinzeki bamamodeli, kumaseva e-MCP, kuma-hook, nakuma-exporter e-OpenTelemetry. Amathuluzi ewebhu akhutshaziwe ngokuzenzakalelayo. Uma enikwe amandla, ukusesha kuya kumhlinzeki wakho omulungisile noma kusevisi yomphakathi yakwa-Exa ethi mcp.exa.ai lapho kungekho mhlinzeki olungisiwe, kuyilapho amakhasi ecelwa ngokuqondile kumawebhusayithi awo.

Ukuthobela nemvume yokusebenzisa

I-iCode iyithuluzi lokuhlela nokuxhumanisa futhi ayinikezi ngemodeli ye-AI. Lapho uxhuma amamodeli ukuze uwasebenzisele ibhizinisi noma ubunjiniyela, unesibopho sokuthobela i-EU AI Act kanye nazo zonke ezinye izimfuneko zomthetho noma zokulawula ezisebenzayo.

Le phrojekthi ingumthombo ovulekile ngaphansi kwe-Apache License 2.0. Izingxenye zezinkampani zangaphandle ezihlanganisiwe zigcina amalayisensi azo, abhalwe ku-file ye-NOTICE ekwi-repository.

Isiphetho

Nge-uv, i-terminal yesimanje, kanye nephrofayela yemodeli elungisiwe, ungasebenzisa i-iCode njengesixhumi esibonakalayo esiyinhloko sama-agent e-AI asekelwe ku-terminal nama-workflow. Qala ngengxoxo elula, buyekeza zonke izinguquko zamafayela ezikhiqiziwe, bese uhlola ukumiswa kwama-agent, ama-workflow, ukubuyisela emuva, ukufinyelela ku-shell, nokuhlaziywa kwe-trajectory njengoba imisebenzi yakho iba yinkimbinkimbi.