Mafunzo ya Capri: Dhibiti Faili, Miradi na Msimbo kwa Wakala wa AI wa Windows

Capri ni nini?

Capri ni wakala wa AI wa chanzo huria, mwenye mandhari ya cyberpunk, kwa Windows. Hutoa kiolesura asilia cha eneo-kazi cha kufanya kazi na faili, folda za miradi, msimbo, zana za shell, programu na wavuti kupitia msaidizi wa AI. Badala ya kuandika amri za terminali, unaeleza lengo kwa lugha ya kawaida na kuiruhusu Capri kuratibu kazi hiyo.

Capri hufanya kazi kama kiolesura na tabaka la zana, huku msaidizi wa nje akitoa hoja za AI. Inaunga mkono Claude Code, Codex, na Antigravity bila usanidi wa ziada. Wasaidizi wengine wanaweza kuunganishwa kupitia adapta maalum.

Capri ni mradi huru, usio rasmi wa mashabiki, uliochochewa na aina ya cyberpunk na Cyberpunk: Edgerunners. Haijahusishwa wala kuidhinishwa na CD PROJEKT RED, Netflix, Studio Trigger, Anthropic, OpenAI, au Google.

Vipengele muhimu

• Injini nyingi za AI: Unganisha Claude Code, Codex, Antigravity, au msaidizi mwingine kupitia adapta maalum.
• Kiolesura asilia cha Windows: Tumia programu ya eneo-kazi iliyosakinishwa badala ya kufanya kazi moja kwa moja kwenye terminali.
• Zana za faili na miradi: Tafuta, soma, panga na hariri faili au folda nzima za miradi.
• Mtiririko wa kazi wa wakala: Capri inaweza kupanga kazi, kuomba zana, kukagua matokeo na kuripoti kilichotokea.
• Msaada wa msimbo: Mwombe injini uliyochagua iandike, iboreshe, itatue hitilafu na iendeshe msimbo.
• Vidhibiti vya uidhinishaji: Kagua vitendo nyeti na viidhinishe au uvikanushe kabla Capri haijabadilisha mfumo wako.
• Wigo unaoweza kusanidiwa: Zuia ufikiaji kwenye folda zilizochaguliwa na uchague tabia ya ruhusa ya kuuliza, kiotomatiki au ya kusoma pekee.

Mahitaji

Kwa sasa Capri inahitaji Windows 10 au mpya zaidi. Inasambazwa kama kisakinishi cha Windows cha .exe. Matoleo ya macOS na Linux yako kwenye ramani ya mradi, lakini hayapatikani kwa sasa.

Pia unahitaji akaunti yako mwenyewe ya msaidizi wa AI anayeungwa mkono au ufunguo wa API. Capri yenyewe ni programu ya chanzo huria chini ya Leseni ya MIT, lakini mtoa huduma wa AI aliyeunganishwa anaweza kutoza matumizi kulingana na bei zake.

Sakinisha Capri kwenye Windows

1. Pakua kisakinishi

Fungua toleo jipya zaidi la Capri na upakue Capri-Setup.exe. Tumia ukurasa rasmi wa matoleo wa hazina badala ya chanzo kisichojulikana cha upakuaji kutoka kwa wahusika wengine.

2. Endesha mchawi wa usanidi

1. Fungua Capri-Setup.exe.
2. Fuata mchawi wa usakinishaji.
3. Baada ya usakinishaji, fungua Capri kutoka kwenye menyu ya Windows Start.

Kwa kuwa Capri ni programu mpya ambayo huenda bado haina sifa kubwa ya upakuaji, Windows SmartScreen inaweza kuonyesha onyo. Ikiwa ulipata kisakinishi kutoka kwenye ukurasa rasmi wa toleo, chagua More info kisha Run anyway ili kuendelea.

3. Unganisha injini ya AI

Mara ya kwanza inapozinduliwa, Capri hukuomba uchague msaidizi. Chagua Claude Code, Codex, Antigravity au chaguo jingine linaloungwa mkono, kisha ingia au utoe ufunguo wa API unaohitajika.

Maombi yako huchakatwa na msaidizi unayemunganisha. Kwa hiyo, masharti, sera ya faragha, bei na kanuni za akaunti za mtoa huduma hutumika kwenye uchakataji huo.

Jinsi Capri inavyoshughulikia kazi

1. Unaeleza lengo: Weka ombi la lugha ya kawaida kwenye programu ya eneo-kazi.
2. Capri huchagua injini: Ombi hutumwa kwa msaidizi wako wa AI aliyesanidiwa.
3. Injini huunda mpango: Msaidizi huamua hatua na zana zinazohitajika.
4. Capri huonyesha vitendo nyeti: Kulingana na ruhusa zako, unaweza kukagua shughuli za faili au mfumo zilizoombwa.
5. Unaidhinisha au unakataa: Vitendo vilivyoidhinishwa hutekelezwa kupitia tabaka la zana la Capri.
6. Capri huripoti matokeo: Wakala hukagua matokeo na kutoa muhtasari wa alichofanya.

Mifano ya matumizi ya msingi

Panga folda

Ili kusafisha folda, tambua eneo lengwa na ueleze mpangilio unaotaka:

Safisha folda yangu ya Downloads na upangilie faili kulingana na aina. Nionyeshe mpango kabla ya kuhamisha chochote.

Capri inaweza kuchanganua folda, kupendekeza mpango na kuomba idhini kabla ya kuhamisha faili. Kagua kwa makini folda lengwa na majina ya faili kabla ya kukubali operesheni hiyo.

Chunguza na urekebishe msimbo

Fungua au ruhusu ufikiaji wa folda husika ya mradi, kisha mpe Capri ombi lililoelekezwa:

Tafuta hitilafu katika mradi huu, eleza chanzo chake, irekebishe na uendeshe ukaguzi unaopatikana.

Injini ya AI uliyochagua inaweza kukagua msimbo, kutafuta tatizo linalowezekana, kuhariri faili husika na kuendesha ukaguzi. Kwa ukaguzi salama zaidi, mwombe Capri ieleze mabadiliko yanayopendekezwa kabla ya kuiruhusu ibadilishe mradi.

Fanya muhtasari wa hati

Capri inaweza kufanya kazi kwenye faili nyingi zilizo kwenye folda iliyoruhusiwa. Kwa mfano:

Fanya muhtasari wa kila PDF kwenye folda hii na uandike hati moja iliyounganisha muhtasari wote.

Kabla ya kuidhinisha kazi hiyo, thibitisha ni folda gani Capri itasoma na mahali inapopanga kuhifadhi hati iliyotengenezwa.

Unda mradi wa wavuti

Pia unaweza kuomba mtiririko kamili wa uundaji:

Sanidi programu mpya ya wavuti kwenye folda hii, sakinisha vitegemezi vyake na uianzisha.

Aina hii ya ombi inaweza kuhusisha kuunda faili, kupakua vifurushi, kuendesha amri za shell na kuzindua mchakato. Kagua mfumo unaopendekezwa, amri na saraka lengwa kabla ya kuidhinisha.

Sanidi ruhusa na wigo

README inatoa mfano ufuatao wa usanidi:

engine: claude-code

permissions:
  mode: ask
  allowed_folders:
    - ~/Documents
    - ~/Projects

interface:
  theme: cyberpunk

Thamani ya engine huchagua msaidizi aliyeunganishwa. Thamani zilizoandikwa zinajumuisha claude-code, codex, antigravity, na custom.

Sehemu ya permissions inaunga mkono hali tatu zilizoandikwa:

• ask: Capri huuliza kabla ya kuchukua hatua. Hii ndiyo njia bora ya kuanzia unapojifunza jinsi wakala anavyofanya kazi.
• auto: Hatua zinaweza kuendelea kiotomatiki. Tumia hii tu unapolielewa jukumu na umeweka mipaka yake kwa uangalifu.
• read-only: Tumia Capri kwa ukaguzi na uchanganuzi bila kuruhusu marekebisho.

Orodha ya allowed_folders huweka kikomo cha maeneo ambayo wakala anaweza kufikia. Afadhali uruhusu ufikiaji wa saraka maalum ya kazi badala ya diski nzima au wasifu mzima wa mtumiaji.

Vidokezo vya hali ya juu

Andika maelekezo yenye mipaka iliyo wazi

Taja folda lengwa, matokeo unayotaka, njia ya uthibitishaji, na hatua zinazohitaji uthibitisho. Ombi sahihi hupunguza utata:

Review the project in my Projects folder. Identify the cause of the failing tests, explain your proposed edits, and wait for approval before changing files. After approval, run the existing test suite.

Anza katika hali ya kusoma pekee

Kwa hifadhi ya msimbo au mkusanyiko wa hati usiofahamu, anza kwa ufikiaji wa read-only. Mwambie Capri akague nyenzo hizo na apendekeze mpango. Badilisha hali ya ruhusa tu unapokuwa tayari kuidhinisha marekebisho.

Tumia folda ya mradi iliyotengwa

Nakili kazi ya majaribio kwenye folda maalum na upe Capri ufikiaji wa saraka hiyo pekee. Hii hupunguza mabadiliko ya kimakosa na kurahisisha kukagua tofauti za faili zilizotokana na kazi hiyo.

Tenganisha upangaji kutoka utekelezaji

Kwa kazi kubwa, omba kwanza mpango bila marekebisho. Kagua hatua hizo, kisha toa maagizo ya pili yanayoidhinisha sehemu iliyoidhinishwa pekee. Hii ni muhimu hasa kwa shughuli za faili nyingi, usakinishaji wa vitegemezi, au urekebishaji mpana wa msimbo.

Badilisha injini inapofaa

Capri hukuruhusu kuchagua kati ya injini za AI zinazotumika. Ikiwa una akaunti za wasaidizi wengi, chagua yule anayefaa zaidi kazi ya sasa. Kumbuka kwamba kila mtoa huduma ana uwezo, gharama, na masharti yake ya faragha.

Tumia adapta maalum kwa uangalifu

Wasaidizi wengine wanaweza kuunganishwa kupitia adapta maalum. Unapotumia moja, thibitisha jinsi inavyoshughulikia vitambulisho vya kuingia, maombi, miito ya zana, na data inayorejeshwa. README haitoi maelekezo ya kutekeleza adapta, kwa hiyo soma nyaraka za sasa za mradi au nyenzo za uchangiaji kabla ya kuunda muunganisho.

Usidhani kuwa kila kipengele cha ramani ya maendeleo kinapatikana

Ramani ya maendeleo inaorodhesha mfumo wa programu-jalizi, udhibiti wa sauti, kipanga ratiba cha kazi, matunzio ya mandhari, na matoleo ya macOS na Linux kama yaliyopangwa badala ya yaliyokamilika. Kagua maelezo ya toleo jipya zaidi kabla ya kubuni mtiririko wa kazi unaotegemea vipengele hivyo.

Miongozo ya usalama

• Kagua kila hatua nyeti: Zingatia hasa ufutaji, uhamishaji, ubadilishaji, amri za shell, na usakinishaji wa vitegemezi.
• Punguza ufikiaji wa folda: Fichua faili zinazohitajika kwa kazi ya sasa pekee.
• Hifadhi nakala: Hifadhi nakala za data muhimu kabla ya kupanga kwa wingi, kuhariri kiotomatiki, au kufanya shughuli nyingine kubwa.
• Linda vitambulisho vya siri: Usishiriki kamwe funguo za API, tokeni za akaunti, au siri nyingine.
• Kagua amri zinazozalishwa: Elewa amri ya shell kabla ya kumruhusu Capri kuiendesha.
• Tumia udhibiti wa matoleo: Kwa miradi ya msimbo, fanya commit au hifadhi hali ya sasa kwa njia nyingine kabla ya kuomba marekebisho makubwa.

Ukigundua tatizo la usalama, fuata maelekezo ya kuripoti usalama ya mradi na liripoti kwa faragha.

Utatuzi wa matatizo na nyenzo za mradi

Ikiwa kisakinishi, muunganisho wa injini, au mtiririko wa kazi wa wakala haufanyi kazi inavyotarajiwa, kagua hifadhi ya Capri kwenye GitHub na maelezo ya toleo jipya zaidi. Hitilafu na mawazo ya vipengele yanaweza kutumwa kupitia fomu za masuala ya mradi.

Michango inakaribishwa katika maeneo kama vile ripoti za hitilafu, nyaraka, mandhari, mapendekezo ya vipengele, na adapta za injini. Kagua mwongozo wa kuchangia wa hifadhi kabla ya kuwasilisha mabadiliko.

Hitimisho

Capri huwapa watumiaji wa Windows kiolesura cha eneo-kazi cha kuwaelekeza wasaidizi wa AI wanaotumika kufanya kazi na faili, miradi, na msimbo. Sakinisha programu, unganisha injini unayoipendelea, punguza ufikiaji kwa folda inazohitaji, na anza kwa ruhusa za kuhitaji uthibitisho au za kusoma pekee. Maelekezo yaliyo wazi, ukaguzi makini, nakala za kuhifadhi, na mipaka finyu ya ufikiaji ni muhimu unapomruhusu wakala yeyote wa AI kuchukua hatua kwenye kompyuta yako.