Mafunzo ya agent-purge: Dhibiti kwa pamoja vidokezo vya mfumo na Persona za Coding Agent

agent-purge ni nini

agent-purge ni zana ya kudhibiti vidokezo vya mfumo kwa Coding Agent nyingi. Agent tofauti zinaweza kusoma vidokezo kupitia vigezo vya kuanzisha, faili za usanidi, Hook au programu-jalizi, na agent-purge huficha tofauti hizo ili watumiaji waweze kuingiza, kubadilisha na kuondoa maudhui ya Persona moja kwa pamoja.

Mradi huu unaunga mkono hali tatu:

• replace: hubadilisha kidokezo cha mfumo lengwa kwa maudhui ya Persona.
• append: huongeza maudhui ya Persona mwishoni mwa kidokezo kilichopo.
• off: huzima uingizaji na kuondoa mabadiliko.

Hali zinaweza kubadilishwa papo hapo. Ukizima swichi kuu ya Web au kutumia --mode off, zana itarejesha mabadiliko husika kama yalivyokuwa awali bila kuacha mabaki ya uingizaji unaosimamiwa.

Mbinu na vipengele kuu

Njia tatu zilizounganishwa

agent-purge hutumia njia tatu kuendana na Harness tofauti. Njia zote tatu hatimaye hutumia maudhui ya faili ya sasa ya personas/<id>.md.

• install: huandika sehemu ya usanidi unaosimamiwa kwenye Harness lengwa, ikiwezekana kwa kutumia Markdown, Hooks au programu-jalizi. Huu ni usanidi wa kudumu, hivyo utaanza kutumika pia mtu mwingine akianzisha Harness husika moja kwa moja.
• shim: huweka ganda la amri lenye jina hilo hilo mbele ya PATH, kisha kupeleka mwito kwa agent-purge <h>, na hivyo kuchukua usimamizi wa amri ghafi iliyoingizwa moja kwa moja.
• slash: hubadilisha hali papo hapo ndani ya kipindi kwa kutumia /purge on, /purge off au /purge status, bila kubadilisha usanidi wa diski.

Ujanibishaji na urejeshaji

Mradi hubadilisha tu sehemu zinazohusiana na vidokezo, haugeuzi faili za binary wala kuvunja au kukwepa idhini. Hali huhifadhiwa kwenye state.json ya kompyuta ya ndani na haitumwi popote. Hali ya awali inaweza kurejeshwa kwa kusanidua, kuondoa usimamizi au kuzima hali.

agent-purge uninstall <h>
agent-purge disarm
agent-purge <h> --mode off

Njia zinazoungwa mkono na Harness mahususi zinapaswa kuthibitishwa kwa matokeo ya utambuzi wa wakati wa kuendesha kwenye kompyuta hiyo.

Mahitaji ya usakinishaji

Kuendesha agent-purge kunahitaji Node.js 20 au toleo la juu zaidi. Mradi wenyewe hauna utegemezi, na unaweza kusakinishwa kimataifa kupitia npm au kufungua moja kwa moja dashibodi ya Web kwa kutumia npx.

Usakinishaji na uendeshaji wa kwanza

Njia ya kwanza: Usakinishaji wa kimataifa

npm i -g agent-purge

Baada ya usakinishaji kukamilika, unaweza kuendesha moja kwa moja:

agent-purge web

Anwani chaguo-msingi ya dashibodi ya ndani ni http://127.0.0.1:7788. Fungua anwani hiyo kwenye kivinjari ili kuona na kudhibiti Persona, hali ya Harness na swichi kuu.

Njia ya pili: Kuanzisha kupitia npx

Ikiwa hutaki kufanya usakinishaji wa kimataifa kwanza, unaweza kuendesha moja kwa moja:

npx agent-purge web

Saraka ya data

Usanidi na Persona hazihifadhiwi kwenye saraka ya kifurushi cha npm, hivyo kusasisha kifurushi hakutafuta data ya mtumiaji. Maeneo chaguo-msingi ni:

• Linux na macOS: ~/.agent-purge/
• Windows: C:\Users\<wewe>\.agent-purge\

Saraka hii kwa kawaida huwa na state.json na personas/. Wakati wa uendeshaji wa kwanza, zana huunda kiolezo cha kuanzia neutral.md kwenye saraka ya Persona.

Ikiwa uliwahi kutumia toleo la 0.1.x, wakati wa uendeshaji wa kwanza wa toleo jipya data iliyokuwa kwenye saraka ya kifurushi itahamishwa kiotomatiki, huku faili za awali zikihifadhiwa.

Kubinafsisha eneo la kuhifadhi data

Unaweza kutumia kigezo cha mazingira AGENT_PURGE_HOME kubainisha saraka huru ya data. Hii inafaa unapohitaji kuhifadhi nakala za Persona, kutenganisha mazingira ya kazi au kuweka usanidi kwenye diski nyingine.

Linux au macOS

export AGENT_PURGE_HOME=/path/to/your/data

Windows

setx AGENT_PURGE_HOME D:\ap-data

Baada ya kuweka thamani hiyo, unapaswa kuendesha agent-purge kwenye kipindi kipya cha terminal ili kuhakikisha kigezo cha mazingira kimeanza kutumika.

Kuelewa na kudhibiti Persona

Kila Persona inalingana na faili moja ya personas/<id>.md. Faili hiyo ina Frontmatter na maudhui, ambapo maudhui ndiyo sehemu inayoandikwa kwenye kidokezo cha mfumo.

Frontmatter inaunga mkono sehemu zifuatazo:

• description: maelezo ya Persona, yanaonyeshwa kwenye orodha ya Web na matokeo ya agent-purge ls.
• desc: sehemu ya zamani ya maelezo, bado inaungwa mkono.
• order: taarifa ya hiari ya kupanga.
• harness: taarifa ya hiari ya kulinganisha Harness.
• model: taarifa ya hiari ya kulinganisha modeli.

Unapobadilisha jina na maelezo pekee kwenye dashibodi ya Web, funguo nyingine za Frontmatter huhifadhiwa na hazibadilishwi kwa sehemu nzima.

Kuorodhesha Persona

agent-purge ls

Amri hii huorodhesha Persona zote na kuashiria zinazolingana kwa sasa. Pia huonyesha hali ya usakinishaji wa Harness iliyogunduliwa wakati wa kuendesha, toleo, safu ya uingizaji na upatikanaji wa kila njia.

Kubadilisha Persona ya sasa

agent-purge use <id>

Hapa <id> inalingana na kitambulisho cha jina la faili ya Persona kwenye saraka ya personas/. Baada ya kubadilisha, miito inayosimamiwa itakayotokea baadaye itatumia Persona hiyo.

Kubainisha Persona kwa mwito mmoja tu

Ikiwa hutaki kubadilisha chaguo la sasa la kimataifa, unaweza kubainisha Persona nyingine kwa mwito huu pekee:

agent-purge pi --persona <id>

Njia hii inafaa kwa kujaribu kwa muda athari za vidokezo tofauti. Baada ya mwito kumalizika, Persona hiyo haitakuwa chaguo-msingi la miito inayofuata.

Mifano ya matumizi ya msingi

Kuanzisha dashibodi ya Web

agent-purge web

Kisha tembelea http://127.0.0.1:7788. Dashibodi inaweza kutumika kuona hali ya uendeshaji na kudhibiti swichi kuu. Swichi kuu inapozimwa, uingizaji huondolewa.

Kuanzisha Codex kwa Persona ya sasa

agent-purge codex

agent-purge hushughulikia uanzishaji kulingana na Backend husika na mazingira ya kompyuta, na hujaribu kutumia Persona ya sasa kupitia utaratibu unaopatikana kwa Harness hiyo.

Kuuliza swali la mara moja kwa pi

agent-purge pi --ask "Tafadhali kagua mantiki ya kushughulikia makosa katika mradi huu"

Amri hii huanzisha mwito mmoja kwa kutumia Persona ya sasa na kutumia maudhui yanayofuata --ask kama swali la kipindi hicho.

Kubadilisha hali papo hapo ndani ya kipindi

Kwa Harness zinazounga mkono njia ya Slash, unaweza kutumia zifuatazo ndani ya kipindi:

/purge on
/purge status
/purge off

• /purge on: huwasha uingizaji wa Persona.
• /purge status: huonyesha hali ya sasa.
• /purge off: huzima uingizaji bila kubadilisha usanidi wa diski.

Jinsi ya kuthibitisha kuwa uingizaji umeanza kutumika

matrix.json huhifadhi jedwali tuli la uwezo, lakini tamko tuli si lazima lilingane na hali halisi ya kompyuta ya sasa. Tofauti za matoleo, mbinu za usakinishaji na mabadiliko ya Harness yenyewe vinaweza kuathiri upatikanaji wa njia.

Kwa hiyo, unapaswa kwanza kuangalia taarifa za wakati wa kuendesha zinazoonyeshwa na agent-purge ls au dashibodi ya Web. Taarifa hizo huonyesha:

• Ikiwa Harness imesakinishwa.
• Toleo la Harness lililogunduliwa.
• Ikiwa kidokezo kiko kwenye safu ya uingizaji ya SYS au USER.
• Ikiwa njia tatu za install, shim na slash zinapatikana.

Jedwali tuli la uwezo likipingana na matokeo ya utambuzi wa wakati wa kuendesha, tumia matokeo ya wakati wa kuendesha.

Mbinu za matumizi ya hali ya juu

Kuandaa Persona nyingi kwa kazi tofauti

Unaweza kudumisha faili nyingi za Markdown chini ya personas/, kwa mfano zikiwa zimetengwa kwa ukaguzi wa msimbo, mapendekezo ya urekebishaji au ushirikiano wa kila siku wa maendeleo. Tumia description kueleza matumizi kwa uwazi, na tumia order kurekebisha mpangilio wa kuonyeshwa; unapohitaji kuweka kikomo cha ulinganishaji, unaweza kutumia sehemu za harness au model.

Kabla ya kubadilisha, endesha:

agent-purge ls

Baada ya kuthibitisha Persona lengwa, endesha:

agent-purge use <id>

Kutofautisha usanidi wa kudumu na majaribio ya muda

• Unapohitaji utendaji wa kudumu, tumia njia ya install inayoungwa mkono na Harness lengwa.
• Unapotaka amri asili iliyoingizwa moja kwa moja pia isimamiwe na agent-purge, tumia njia ya shim.
• Unapotaka kujaribu katika kipindi cha sasa pekee, tumia njia ya slash au kigezo cha mara moja cha --persona.

Upatikanaji wa njia fulani bado unapaswa kuthibitishwa kwa matokeo ya utambuzi wa wakati wa kuendesha.

Kuhifadhi njia ya urejeshaji kabla ya kubadilisha

Ingawa mradi huhifadhi hali na hutoa utendaji wa kurejesha, unapoutumia bado inashauriwa kwanza kuthibitisha Persona ya sasa, Harness lengwa na hali iliyowashwa. Baada ya kukamilisha majaribio, unaweza kuondoa mabadiliko kwa njia zifuatazo:

agent-purge uninstall <h>
agent-purge disarm

Unaweza pia kubadilisha hadi --mode off au kuzima swichi kuu kwenye dashibodi ya Web.

Usichukulie kuanzisha bila mabadiliko kuwa uingizaji umefanikiwa

Kwa programu za eneo-kazi zilizofungwa ambazo vidokezo vyake vya mfumo viko upande wa seva au ndani ya binary iliyofungwa, agent-purge huanzisha programu kama ilivyo bila kuingiza vidokezo. Unapoendesha agent-purge <h>, zana itaonyesha wazi sababu ya kutoweza kuingiza badala ya kujifanya kuwa uingizaji umeanza kutumika.

Muhtasari wa muundo wa mradi

• bin/: sehemu ya kuingilia ya CLI.
• lib/: mantiki ya hali, Persona, uingizaji, njia na utambuzi.
• backends/: vigezo vya kuanzisha Harness mbalimbali na ushughulikiaji wa sentensi ya utambulisho.
• web/: dashibodi ya ndani, ikiwemo server.mjs na ui.html.
• bench/: vipimo halisi vya kiwango cha mafanikio ya uingizaji na hati za mwamuzi, kwa matumizi ya uundaji pekee na si sehemu ya uendeshaji wa kawaida.
• matrix.json: jedwali tuli la uwezo.

Usalama, faragha na mipaka ya uzingatiaji

agent-purge imeundwa kwa ajili ya Harness rasmi ya ndani ambayo mtumiaji ana haki ya kuisimamia, ikilenga uhandisi wa vidokezo na tathmini ya uimara. Haibadilishi faili za binary, haipiti uidhinishaji, haitumii hali ya ndani nje, na haipaswi kutumiwa kwenye mifumo isiyoidhinishwa.

• Itumie tu kwenye vifaa, programu na mazingira ya majaribio yanayodhibitiwa na wewe na yaliyo kwa mujibu wa sheria.
• Usiitumie kwa mashambulizi yasiyoidhinishwa, unyonyaji wa udhaifu, wizi wa data, kuingia kinyume cha sheria au kusambaza mizigo hasidi.
• Usikiuke sheria na kanuni zinazotumika, masharti ya huduma za modeli au sera za matumizi mabaya.
• Mradi unatolewa chini ya leseni ya MIT “kama ulivyo”; watumiaji wanawajibika kwa pembejeo zao, matokeo na matendo yao ya matumizi.
• Unapotumia jina, mawazo, msimbo au vidokezo vya mradi, toa utambuzi na uonyeshe chanzo kulingana na taarifa ya hazina.

README pia inaweka vikwazo vikali kuhusu kufikia seva na tovuti katika maeneo mahususi. Kabla ya matumizi halisi, soma kikamilifu taarifa za kutowajibika na uzingatiaji wa sheria katika hazina, na uhakikishe kuwa eneo la operesheni linakidhi masharti yake.

Muhtasari

agent-purge huunganisha milango ya vidokezo isiyolingana ya Coding Agent mbalimbali kuwa dhana kama Persona, install, shim na slash, na hutoa dashibodi ya wavuti, utambuzi wakati wa utekelezaji na uwezo wa kurejesha mabadiliko. Kwa kuanza, unaweza kusakinisha zana, kufungua dashibodi ya wavuti, kuendesha agent-purge ls ili kukagua usaidizi, kisha uchague Persona ya kuanzisha Harness lengwa. Kwa majaribio ya muda, pendelea kutumia Persona ya mara moja au kubadilisha wakati wa kikao; kwa usanidi wa muda mrefu, washa njia ya kudumu baada ya kuthibitisha uwezo wa wakati wa utekelezaji na mipaka ya uzingatiaji wa sheria.