Kuanza na iCode: Kuendesha na Kusanidi Kituo cha Wakala wa AI

iCode ni nini?

iCode ni programu huria ya terminali kwa ajili ya kuratibu mawakala wa AI na mtiririko wa kazi. Huleta mazungumzo, wasifu wa modeli, usanidi wa wakala, ufikiaji wa shell, tofauti za faili, vidhibiti vya kurejesha mabadiliko, na uchanganuzi wa utekelezaji katika kiolesura kimoja.

Bado inaendelea kutengenezwa: Violesura, miundo ya faili, na mipangilio chaguomsingi ya iCode inaweza kubadilika kati ya matoleo.

iCode haijumuishi modeli ya AI. Badala yake, unaunganisha watoa huduma wa modeli mwenyewe na kuchagua wasifu uliosanidiwa ambao wakala anapaswa kutumia.

Vipengele muhimu

• Gumzo la terminali: Tazama majibu yenye Markdown iliyopangiliwa, yakiwemo orodha na michoro iliyoumbizwa.
• Wakala wanaoweza kusanidiwa: Fafanua maagizo, zana, mawakala wasaidizi, ujuzi, seva za MCP, na kumbukumbu bila kuandika msimbo wa wakala.
• Wasifu nyingi za modeli: Sanidi wasifu kutoka kwa watoa huduma tofauti na ubadilishe modeli wakati wa mazungumzo.
• Mwonekano wa mtiririko wa kazi: Fuatilia mtiririko wa kazi hatua kwa hatua na ukague modeli, miito ya zana, na matumizi ya tokeni ya kila nodi ya wakala.
• Ukaguzi wa mabadiliko: Kagua kila faili iliyobadilishwa na wakala katika mwonekano wa tofauti uliounganishwa au uliogawanywa.
• Kurejesha mabadiliko: Chagua zamu iliyotangulia, kagua mabadiliko yatakayorejeshwa, na uondoe mazungumzo baada ya hatua hiyo.
• Uchanganuzi wa mfuatano: Chunguza mgawanyo wa muda, tokeni, akiba, na uendeshaji sambamba, pamoja na miito ya modeli, hooks, na miito ya zana.
• Shell iliyounganishwa: Endesha terminali halisi ndani ya iCode, ikiwemo programu za skrini nzima.

Mahitaji ya awali

Sharti pekee linalohitajika ni uv. Huandaa Python 3.14 kwa ajili ya mradi, kwa hiyo huhitaji kusakinisha toleo hilo la Python kando.

Tumia terminali ya kisasa ili kupata matumizi bora. README inapendekeza Windows Terminal kwenye Windows au Ghostty kwenye macOS na Linux.

Sakinisha na endesha iCode

Anza kutoka kwenye nakala ya ndani ya hazina. Fungua terminali katika saraka yake kuu na usawazishe mradi pamoja na ziada zote zinazohitajika:

uv sync --extra all

Tumia --extra all kama ilivyoonyeshwa. Mradi unaonya mahsusi dhidi ya kutumia uv sync pekee au kubadilisha chaguo hilo na --all-extras.

Kisha, pakua jozi ya ripgrep iliyojumuishwa. Kwenye macOS au Linux, endesha:

./scripts/fetch_rg.sh

Kwenye Windows, endesha hati ya PowerShell badala yake:

.\scripts\fetch_rg.ps1

Mwisho, zindua iCode:

uv run icode

Jina la msimbo la mradi ni Chrys, kwa hiyo amri hii huanzisha programu hiyo hiyo:

uv run chrys

Sanidi modeli yako ya kwanza

iCode huja bila wasifu wa modeli. Katika uzinduzi wa kwanza, bonyeza F4 ili kufungua Usanidi wa Modeli na uongeze wasifu wa mtoa huduma wa modeli unayemtumia.

Baada ya kusanidi wasifu, unaweza kuweka wasifu kutoka kwa watoa huduma tofauti pamoja na kubadilisha kati yao wakati wa mazungumzo. Kwa kuwa iCode haitoi modeli yenyewe, muunganisho wa mtoa huduma unaosanidi huamua maombi ya modeli yanatumwa wapi.

Matumizi ya msingi

Elekea kutoka kwenye upau wa kuingiza

Skrini ya kwanza huweka wakala wa sasa, modeli, hali ya uidhinishaji, na kipindi wazi. Viambishi kadhaa hutoa ufikiaji wa haraka kwa vitendaji muhimu:

• # hufikia mawakala.
• $ hufikia modeli.
• / hufikia amri.
• @ hufikia faili.
• ! hufikia shell.

Anzisha mazungumzo

Chagua wakala na modeli iliyosanidiwa, kisha weka ombi lako kwenye upau wa kuingiza. Majibu huonyeshwa kama Markdown yenye muundo moja kwa moja kwenye terminali. Wakala anapobadilisha faili, iCode huhifadhi mabadiliko hayo ili uweze kuyakagua kwa zamu moja moja au yote pamoja.

Sanidi wakala

Bonyeza F2 ili kufungua Usanidi wa Wakala. Wakala ni usanidi badala ya msimbo wa programu. Kutoka kwenye skrini hii, unaweza kuhariri maagizo, zana, mawakala wasaidizi, ujuzi, seva za MCP, na kumbukumbu.

Yalinganishe maagizo ya wakala na madhumuni yake, na uwashe zana na miunganisho anayohitaji pekee. Hili pia ni muhimu kwa faragha kwa sababu zana na seva za nje zinaweza kushughulikia data kwa kujitegemea.

Kagua mabadiliko ya faili

Tumia kitazamaji cha tofauti kukagua faili zilizobadilishwa na wakala. Unaweza kukagua mabadiliko zamu moja kwa wakati au kuyakusanya katika mwonekano wa jumla. Mawasilisho yaliyounganishwa na yaliyogawanywa yanapatikana.

Endesha na kagua mitiririko ya kazi

Hali ya mtiririko wa kazi hukuruhusu kutazama mtiririko wa kazi ukitekelezwa hatua kwa hatua. Kwa kila nodi ya wakala, iCode inaweza kuonyesha modeli iliyochaguliwa, miito yake ya zana, na matumizi ya tokeni.

Mtazamo huu ni muhimu wakati kazi inahusisha hatua au mawakala wengi. Badala ya kuchukulia utekelezaji kama jibu moja lisiloeleweka, unaweza kuona jinsi kazi inavyosonga kupitia grafu.

Vidokezo vya kina

Tumia urejeshaji kabla ya kuendelea kutoka kwenye zamu yenye hitilafu

Ikiwa mazungumzo yanazalisha mabadiliko yasiyotakikana, chagua zamu ya awali na ufungue urejeshaji. iCode inaonyesha ni mabadiliko gani ya faili yatakayotenguliwa kabla ya kutumia urejeshaji. Kisha hutupa sehemu ya mazungumzo iliyo baada ya zamu iliyochaguliwa.

Kagua kwa makini mapendekezo ya kutengua faili kabla ya kuthibitisha, hasa wakati zamu kadhaa zimebadilisha faili zilezile.

Changanua utekelezaji kwa Trajectory

Bonyeza F12 ili kufungua mwonekano wa trajectory. Muhtasari wake unaeleza muda na tokeni zilitumika wapi, ukitenganisha shughuli za modeli, utekelezaji wa zana, na kusubiri. Pia hutoa matumizi ya tokeni na akiba kwa kila zamu, pamoja na maelezo ya utekelezaji sambamba.

Mstari wa muda huchambua miito mahususi ya modeli, hooks, na miito ya zana ndani ya zamu. Uitumie kuchunguza mwingiliano unaogharimu au kuchukua muda mwingi na kuelewa mfuatano wa shughuli.

Tumia shell iliyounganishwa

Fungua shell kwa kuingiza !. Hii ni terminali halisi badala ya paneli yenye matokeo machache ya amri, kwa hiyo programu za skrini nzima zinaweza kuendeshwa hapo na kupokea kila kibofyo cha kitufe.

Kumbuka kuwa amri, hati za ujuzi, na mtiririko wa kazi ni programu huru zenye ufikiaji wako wa mtandao. Kagua zinachofanya kabla ya kuziendesha, hasa katika mazingira nyeti.

Fungua mwongozo kamili wa mtumiaji

Bonyeza F8 ndani ya iCode ili kufungua mwongozo wa mtumiaji uliojengewa ndani. Hati hiyo hiyo inapatikana katika saraka ya docs/ ya hifadhi kwa Kiingereza na Kichina Kilichorahisishwa.

Faragha na miunganisho ya nje

iCode haina telemetry, uchanganuzi, wala ripoti za kuacha kufanya kazi, na haikusanyi data yako. Kwa chaguo-msingi, haitumi chochote, ikiwemo data ya matumizi, kwa mradi au wahusika wengine.

Data bado inaweza kutumwa kwenye maeneo unayosanidi, yakiwemo watoa huduma wa modeli, seva za MCP, hooks, na wauzaji wa OpenTelemetry. Zana za wavuti zimezimwa kwa chaguo-msingi. Zikiwezeshwa, utafutaji hutumwa kwa mtoa huduma uliyemsanidi au kwa huduma ya umma ya Exa mcp.exa.ai wakati hakuna mtoa huduma aliyesanidiwa, huku kurasa zikiombwa moja kwa moja kutoka kwenye tovuti zao.

Uzingatiaji na leseni

iCode ni zana ya uratibu na haitoi modeli ya AI. Unapounganisha modeli kwa matumizi ya biashara au uhandisi, unawajibika kwa uzingatiaji wa Sheria ya AI ya EU na mahitaji mengine yote yanayotumika ya kisheria au udhibiti.

Mradi huu ni programu huria chini ya Apache License 2.0. Vipengele vya wahusika wengine vilivyowekwa pamoja vinaendelea kuwa na leseni zao husika, ambazo zimeandikwa katika faili ya NOTICE ya hifadhi.

Hitimisho

Ukitumia uv, terminali ya kisasa, na wasifu wa modeli uliosanidiwa, unaweza kutumia iCode kama kiolesura kikuu cha mawakala na mitiririko ya kazi ya AI inayotegemea terminali. Anza kwa mazungumzo rahisi, kagua kila mabadiliko ya faili yanayozalishwa, kisha chunguza usanidi wa mawakala, mitiririko ya kazi, urejeshaji, ufikiaji wa shell, na uchanganuzi wa trajectory kadiri kazi zako zinavyokuwa changamano zaidi.