Ubumenyi shingiro / Kode

Gukorera mububiko bwa git

Pro ishobora gukora mu mwe muri imwe muri repositories zawe nk'uko coding agent akora — asoma amadosiye yawe nyayo, kandi akayandika, akayahindura.

Uru rupapuro rwahinduwe imashini kugirango byorohe. Umwimerere wicyongereza ni verisiyo ikoreshwa.

Kuhuza aho ibikorerwa (repository)

?git, cyangwa uwo Git agendanwa mu kantu ko gufasha (toolbar), uhuza n'uburyo bwo kubika amakode (provider): GitHub, GitLab, cyangwa Gitea/Forgejo — bikubiyemo Codeberg n'izindi nzego zitoroshye (self-hosted instances). Ikoresha agaciro k'uburyo bwemerewe gukoresha (scoped personal access token), aho amakode abikwa (repository) n'aho amakode ari (branch). Aho amakode abikwa aho iyambaza kuri Nostr bishobora kuzuza aho ariyo adiresi ye aho kubanza.

Ntibacyo bivuze ko ugomba kwandika izina ry'ububiko. Kora kopi y'icyatubura (token) hanyuma uhitemo Simbura ibyo iri token ishobora kugerahoNymbot ibaza forge icyo token ishobora kubona, hanyuma ikerekana igisubizo nk'urutonde urusuzuma. Gusuzuma bihuza buri wumwe n'uruziga rwawo rw'ibanze (default branch) rwuzuye, hanyuma bikabishyira muri uyu muhango. Icyari cyamaze guhuzwa kigaragazwa nk'icyamaze guhuzwa aho kwerekwa nanone. Icyo cyifuzo gimanuka ku gikoresho cyawe kigana muri forge mu buryo butaziguye — si binyuze kuri Nymbot worker — bityo token ntijya ahandi itari imenyereye. Forge self-hosted ivunnye cross-origin requests ntishobora kwerekwa mu rutonde; andika repository ukoresheje intoki kandi ibindi byose bigenda kimwe.

Iyo ihunganye, agace k'ubwenge (chip) kerekana izina ry'aho amakuru y'ibanze (repository) abika, n'ubutumwa butumwa ukoresheje a Manga y'icyiciro cyihariye hitaye mu miterere ya uwo mugaragaro (repository) wahisemo gukora. ?git disconnect abyakura. Gukuraho mu rutonde rw'amashandari (repositories) ibanura i-token ariko ukagumana iryo sandari, ukerekana ko itagira i-token, kugira ngo ushobore kongeramo iyindi nyuma.

Repositories zamenyekanishijwe kuri Nostr

Amashyirahamwe amwe y'ibikorwa (repositories) yiyambaza kuri Nostr aho kwiyambaza kuri forge gusa, akoresheje NIP-34 — amabwiriza ari inyuma ya ngit na gitworkshop. Itangazo riri mu bwoko bwa Nostr event ririho izina ry'umushinga, abayobora umushinga, izitera (relays) zikura amavugurura (patches) n'ibibazo (issues), hamwe n'amavenyu (URLs) ushobora kuyakurira. Ikindi gitangazo kivuga aho buri gice (branch) kigana ubu.

Shyira inyuguti/ibintu naddr cyangwa a nostr:// uyandike muri ifomu y'ububiko hanyuma ukande Shakisha. Nymbot isoma itangazo ryibwirwa kuri relays hanyuma akuzuza ifomu: aho git host iyikoporozwe, urubuga (repository) ruri aho, n'urwego (branch) urwo mushinga bwite uvuga ko ari rwo ruriho ubu. Wowe uracyongeramo token y'icyo host, kuko Nostr iyobora itangazo naho git server ikaba iyobora amakode.

Ibi bivuze ko amategeko ari aho yakopiywe (cloned). Isanduku y'imibare (repository) ifite URL yo kuyikopera kuri GitHub, GitLab, Gitea cyangwa Forgejo — harimo n'izishyirwa mu mbuga bwite — ni imwe Nymbot ishobora gusoma. Iyakopiywe gusa binyuze kuri git:// ar ssh nta HTTP API yo gusoma amafili binyuze muri yo, kandi Nymbot ivuga ibyo aho kugira ngo yongere ikonekte imwe gusa. Iyo uwo muntu ari we uziho (self-hosted), umuhatira (provider) uba ari igitekerezo gishingiye ku izina rye, kandi ushobora kuwuboneyaho icyakwiriye mbere yo kubika.

Ububiko bwongerwamo mu buryo butyo bwafite ikimenyetso ngit mu rutonde, kandi ibisubizo bicyitiriza izina ryambazwa aho kubyita hifashishijwe inzira yaryo ku kiranuka.

Icyo ishobora gukora

Ubutumwa muri repo bukorana nk'umufatanyabikorwa muto aho kuba igisubizo kimwe gusa. Model ishobora kugaragaza imidashyikirwa, gusoma inyandiko no gushakisha mu miterere yayo, hanyuma igasubiza ikoresheje ibyo yabonye mu by'ukuri — bityo "kuki uruziga rw'ubundi bwongerera imbaraga rugarukira hakiri kare" bigasubizwa bishingiye ku kodi yawe, aho gusubiza hakoreshejwe ibyo gufata nk'uko bimeze ku kodi ishobora kuba nk'iyawe.

Ibona uruziga wometse, ku kaba kacyeye ubu.

Na serivure iracyakora yashyizweho kugira ngo ikoreshwe muri chat, ishobora nambi gusaba gukora command kuri code yawe, nk'ibizamini (tests), kuri Nymbot server. Buri rugero ruri hagati rwategereje ko ubugire uruhushya.

Gushyira inyandiko kuri

?git writes on yongera ubushobozi bwo kwerekana amadosiye (commit files), kurema amashami (branches) no gufungura ibihangano by'ubusabe (pull or merge requests). Ntabwo biyashyirwamo mu buryo bw'ibanze, kandi ni byiza kubigumamo kugeza igihe ubishaka.

Iyo wanditse, usaba impinduka maze uhabwa igice cy’inyandiko (branch) n'uburyo bwo kuyigeza ku bandi (pull request) kugira ngo igenzurwe, aho kwandika umwandiko mugufi muri chat: buri kazi kora kuri imbonezamubano yihariyeNta kintu cyose kishyirwa muri branch yawe y'ibanze keretse niba utabuhembye, ibyo ni ryo shobe wamukuye, kandi ukeneye ko bikorwa.

Ibihindurwa by'ikigendera bishyirwa muri commit imwe kuri buri repositari, ku mpera y'ikigendera cyangwa igihe imodeli izasanga igikorwa kimwe cyuzuye. Niba wifuza kubona ibyo mbere, fungura Banza ubaze mbere yo kwemera ku ryo rubuga. Imiterere yacyo iratuma ihinduka ririndwa, igisubizo kigaragaza ibyo ihindura nk'ibitandukanyirizo, na Koresha abikora mu gihe Guca mu bintu abibura. Kwishyura ntibiba bifite igiciro.

Akanyamuneza kuri buri kazi

Na Buri murimo uhabwa igice cyihariye (branch) kuri, ibyo bikorewa kuri buri repository niba utabyizimije, umukoro wandika commits kuri branch iyihariye, yitwa nymbot/ hamwe n'ikimenyetso gito (id). Nymbot ikikora bishingiye ku mpera z'uruziga rw'akazi igihe imirimo itanga commit yayo ya mbere, bityo imirimo isoma gusa ntikora uruziga rw'akazi na rimwe. Uruziga rw'akazi rwenyine ntiruhindurwa, ibyo ni byo bituma imirimo myinshi ishobora kwandika mu nzu y'amakuru imwe icyarimwe aho gutegereza igihe cyayo.

Iyo akazi kageze ku iherezo, Nymbot akora iki Iyo bikoze avuga. Fungura pull request ni ryo rigenewe; Tanga guhuriza hamwe asiga akabuto ka Merge kuri igisubizo; Siga ishami ntikora ikindi na kimwe. Icyerekezo cy'ibanze gishyizwe muri Settings, munsi ya Iyo igice cy'inshinga cyarangiye, kandi buri urubuga ruriho ibikorwa (repository) rushobora guhitamo mu buryo bwihariye bwacyo. Niba uwo muhanda w'imikorere (forge) udafite API y'ibibazo byo gusaba gusoma ibikorwa (pull requests) Nymbot ishobora gukoresha, cyangwa iyakerarwa, urwego (branch) rurekera uko rwari rumeze kandi igisubizo kigavuga ibyo.

Igisubizo kigaragaza uruzinduko ruri na fungura PR, Guhuza na Siba, kandi idapane ry'Ibikorwa (Tasks pane) ririshyira muri iryo korwa. Mu gihe igikorwa kigikomeje kugenda, ikarita yacyo, idapane ry'Ibikorwa, n'urutonde rw'ibiri kugenda bishingira ku izina ry'amashami (branch) akimara kuboneka, kuri buri gikoresho cyose cyinjiriye muri konti. Igikorwa gihagaritswe cyangwa kikaba kigihutiye mu rugendo gisubiza rya shami racyo, kugira ngo rishobore kuvangirwa, gusibwa cyangwa gukoranwa n'ibindi. Kuvangira (merge) ni uruvange rw'ibikorwa (merge commit) binyuze muri pull request ya forge yihariye, banyuzije kuri commit Nymbot yanditse, kugira ngo commits nshya zishyizwe muri iryo korwa mu gihe hagati hagati zitazavangirwa zitabonye. Nta kintu cyigeze kishyirwaho cyane mu buryo bw'uko binyuranyije (force-pushed). Niba rya shami rirwanya rya shami rikorerwaho, igisubizo gitanga fungura PR kugira ngo ubone ikisubizo cyangwa Basaba Nymbot ko yahindura imvihe (branch), ivanga ishahe (branch) rikora muri yo ukoresheje merge commit aho gukoresha rebase. GitHub na Gitea cyangwa Forgejo bishobora kubikora; GitLab ifite API itabyemera, bityo aho ubigenza mu isaba ryo guhuza (merge request).

Ihinduka mu mafayili ya CI n'uburyo bikora biracyategereje isuzuma ryawe, nk'uko bikorera iyo nta uburyo (branch) bwihariye bufite.

Zimya uburyo bwo kwandika (commit) mu buryo butaziguye mu nkingi itegurirwa akazi (working branch). Inshingano imwe bityo iba ifite aho ibika amakuru (repository) yonyine, kandi iyindi ya kabiri kuri iyo nkingi imwe isoma gusa kugeza igihe iy'ibanze yarangiriye. Inyandiko za kera z'iyi porogaramu na zo zikora mu buryo bumwe.

Gusubiza ibyo urugendo rwagusunze

Igisubizo cyanditse kuri repository yawe kivuga ibyo guhindura: repository, imashini (branch), ndetse fayili ya buri wariho. Saho aya mivugire abishyira mu mwanya wabo — buri nzira muri zo zisomwa kuri commit aho branch yari imeze mbere y'uko ikora, maze ikubikwa uko yari imeze. Umukoro wari umaze gukorwa kuri uruvange rwayo bwite wasize uruhande rw'akazi wunyine, bityo nta kintu kiri hano kishyirwa gusubizamo: Siba ikura uruvunja rwaryo aho.

Icyo ni gusubiza ibintu uko byari, si ukandika bishya. Nta kintu gishimbuje kandi nta mateka yahinduwe: ibyo Nymbot yakozemo biguma mu mbonerahamwe, ariko ntibibi shyira mu miterere y'uruziga (branch). Umuntu wese wari wafashe ibintu hagati y'iyo gihe agahazaza agakomeza kubikoresha kuko bitagihindutse.

Ntibiba bifite igiciro. Gusubira inyuma ntibukora ku mashingiti, bityo ntibikoresha amatsinda — access token iyambereke n'iyo mpanuro imwe nk'uko ibikora kuri izindi zose, kandi nta kintu na kimwe cy'icyo checkpoint kiba kigurandiye ahandi uretse kuri nimugari wawe bwite.

Igiciro cy'inshingano yo muri repo ni iki

Umukoro w'ububiko (repo task) ukoresha kugeza kuri imirongo sita y'ubuvugaciro (model calls) kuri ubu butumwa — kureba, gusoma, gushakisha, gusubiza — buri imwe itishyurwa hashingiwe ku bwuzuzanye bw'umuzinga w'ubuvugaciro bwagenwe. Igiciro cya ProHanyuma call zikoreshejwe gusa ni zo zishyurwaho, bityo ikibazo kisubizwa muri file imwe kishyura nk'uko bishyura igisubizo gisanzwe.

Igisubizo cy'uburyo (app) kigaragaza ingano n'umubare w'imitetelezo nyuma ya buri kazi ryo muri repo.

Iyo umurimo ushize umwanya

Inshingano yo mu bubiko ni uruziga, si igisubizo kimwe: icyiciro (model) kigaragaza ikibanza cy'imikorere, gisoma ifayili, gushakisha mu miterere yayo, gisoma indi, hanyuma gusa kigandika. Uruzuiga rufite urugero — umubare w'ubwo icyiciro (model) cyakoreshejwe uburyo ubuherereye ikiguzi — kuko ubuyobozi butagira urugero ari igiciro kitagira urugero.

Iyo umurimo wakoresheje ingano yateganyijwe ariko haracyari ibikora, Nymbot ahagarara, ikaguha ibyo imaze kugeraho, ikabivuze. Nta kindi kishyurwa.

Ushobora no kubireka akomeza. Shyiraho umutunganyirize wo gukomeza muri Settings, hanyuma Nymbot igure ikomeza ikoresha amafaranga asigaye igihe umurimo ushire, itangira aho washyiraga aho gusubira kwisoma mu rubuga kuva ku ntangiriro. Irikora mu ntambwe imwe imbere, buri ntambwe ivuga igiciro cyayo, ikagera aho ihagarara igihe umutunganyirize ushire, umurimo ushire, cyangwa igihe ukanda Stop. Guhitamo “kugeza igihe amafaranga yanjye azashize” biracyari igipimo cy'imaximali — ni amafaranga yawe aho kuba umubare wategereye.

Ubusanzwe igikoresho cyawe gihereza buri ntambwe, bityo inshingano ikomeza gusa igihe porogaramu (app) ifunguye. Na imikorere yo inyuma iyahagaze, serivure itanga izindi miterere yaryo mu gihe porogaramu ifunze, mu mutego umaze, atari ibirenze imiterere 40 n'amasaha 6, kandi ikakubwira rimwe igihe akazi kageze ku iherezo. Kugira ngo ibikore, igumana ikimenyetso cy'ububiko (repository token) cyafunze n'urufunguzo ikinyirazina gusa mu gihe akazi kacyari karengereye, ikacyigira igihe akazi kageze ku iherezo kandi buri gihe mu masaha 6. Akazi k'inyuma (background task) kanyura mu gace kacyo k'inyandiko nk'indi miterere yose.

Ibyerekeye icyo kimenyetso

Kubera ko ihuriza hamwe ibintu, ubu bwumvikanyo bukoresha urubuga ruziguye bukora kuri buri gikoresho wiyandikishije ngo ucyikoresheye bwa mbere. Gukuraho urubuga kuri gikoresho kimwe bituma n'andi akubura uruhushya rwa token. Token ntigera igera muri serivure tangaagabanyirizo ka