Isifundo se-agent-purge: Ukuphatha ngokuhlanganyela iziqondiso zesistimu ne-Persona zama-Coding Agent

Yini i-agent-purge

i-agent-purge iyithuluzi lokuphatha imiyalelo yesistimu yezinhlelo eziningi ze-Coding Agent. Ama-Agent ahlukahlukene angafunda imiyalelo ngamapharamitha okuqalisa, amafayela okumisa, ama-Hook noma ama-plugin, kanti i-agent-purge ifihla lo mehluko ukuze abasebenzisi bakwazi ukufaka, ukushintsha nokuhlehlisa okuqukethwe kwe-Persona efanayo.

Le phrojekthi isekela izindlela ezintathu:

• replace: Isebenzisa umbhalo we-Persona ukufaka esikhundleni somyalelo wesistimu oqondiwe.
• append: Yengeza umbhalo we-Persona ekupheleni komyalelo okhona.
• off: Ivala ukufakwa futhi ihlehlise izinguquko.

Izindlela zingashintshwa ngesikhathi sokusebenza. Uma uvala iswishi enkulu ye-Web noma usebenzisa --mode off, ithuluzi libuyisela izinguquko ezifanele esimweni sazo sokuqala, lingashiyi izinsalela zokufakwa okulawulwayo.

Indlela eyinhloko nemisebenzi

Iziteshi ezintathu ezihlanganisiwe

i-agent-purge isebenzisa iziteshi ezintathu ukujwayelanisa ama-Harness ahlukahlukene. Izendlalelo zontathu zisebenzisa umbhalo wefayela lamanje personas/<id>.md.

• install: Ibhala ibhulokhi yokumisa elawulwayo ku-Harness eqondiwe, okungase kusetshenziswe i-Markdown, ama-Hook noma indlela yama-plugin. Lokhu ukumisa okuhlala kukhona, futhi kuzosebenza nakwabanye abaqalisa i-Harness efanele ngokuqondile.
• shim: Ibeka igobolondo lomyalo elinegama elifanayo ngaphambi kwe-PATH, bese idlulisela izingcingo ku-agent-purge <h>, ngaleyo ndlela ithathe izintambo zomyalo wokuqala othayiphiwe ngokuqondile.
• slash: Ishintsha ngesikhathi seseshini kusetshenziswa /purge on, /purge off noma /purge status, ngaphandle kokushintsha ukumiswa okukudiski.

Ukwenziwa kwasendaweni nokuhlehliseka

Le phrojekthi ishintsha kuphela izindawo ezihlobene nemiyalelo, ayishintshi amafayela kanambambili futhi ayiphuli noma yeqe ukugunyazwa. Isimo sigcinwa ku-state.json emshinini wendawo futhi asilayishwa. Ungabuyisela isimo sokuqala ngokukhipha, ngokususa ukuphathwa noma ngokuvala imodi.

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

Iziteshi ezisekelwa yi-Harness ethile kufanele zinqunywe ngemiphumela yokuhlolwa kwesikhathi sokusebenza emshinini wendawo.

Izidingo zangaphambi kokufakwa

Ukuze usebenzise i-agent-purge udinga i-Node.js 20 noma inguqulo ephakeme. Iphrojekthi yona ayinazo iz依依 ezidingekayo, futhi ingafakwa emhlabeni wonke nge-npm noma uvule ngokuqondile ikhonsoli ye-Web usebenzisa i-npx.

Ukufaka nokuqalisa okokuqala

Indlela yokuqala: Ukufaka emhlabeni wonke

npm i -g agent-purge

Ngemva kokufaka, ungasebenzisa ngokuqondile:

agent-purge web

Ikhonsoli yendawo itholakala ngokuzenzakalela ku-http://127.0.0.1:7788. Vula leli kheli esipheqululini ukuze ubuke futhi uphathe ama-Persona, isimo sama-Harness kanye neswishi enkulu.

Indlela yesibili: Ukuqalisa nge-npx

Uma ungafuni ukufaka emhlabeni wonke kuqala, sebenzisa ngokuqondile:

npx agent-purge web

Uhla lwemibhalo lwedatha

Ukumisa nama-Persona akugcini kuhla lwemibhalo lwephakheji ye-npm, ngakho ukuthuthukisa iphakheji ngeke kubhale phezu kwedatha yomsebenzisi. Izindawo ezizenzakalelayo yilezi:

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

Uhla lwemibhalo luqukethe ikakhulukazi i-state.json ne-personas/. Ekuqaliseni kokuqala, ithuluzi lidala ithempulethi yokuqala engu-neutral.md ohlwini lwemibhalo lwama-Persona.

Uma uke wasebenzisa inguqulo engu-0.1.x, ekuqaliseni kokuqala kwenguqulo entsha ithuluzi lizothutha ngokuzenzakalela idatha ebikade ikuhla lwemibhalo lwephakheji, futhi ligcine amafayela okuqala.

Ukwenza ngokwezifiso indawo yokugcina idatha

Ungacacisa olunye uhla lwemibhalo lwedatha usebenzisa okuguquguqukayo kwemvelo okungu-AGENT_PURGE_HOME. Lokhu kulungele ukwenza isipele sama-Persona, ukwahlukanisa izindawo zokusebenza noma ukubeka ukumisa kwenye idiski.

Linux noma macOS

export AGENT_PURGE_HOME=/path/to/your/data

Windows

setx AGENT_PURGE_HOME D:\ap-data

Ngemva kokukusetha, sebenzisa i-agent-purge eseshinini entsha yetheminali ukuze uqinisekise ukuthi okuguquguqukayo kwemvelo sekusebenzile.

Ukuqonda nokuphatha ama-Persona

I-Persona ngayinye ihambisana nefayela elingu-personas/<id>.md. Ifayela lakhiwe yi-Frontmatter nombhalo oyinhloko, lapho umbhalo oyinhloko kungukuqukethwe okufakwa emyalelweni wesistimu.

I-Frontmatter isekela le mikhakha elandelayo:

• description: Incazelo ye-Persona, ezoboniswa ohlwini lwe-Web nakokukhishwa kwe-agent-purge ls.
• desc: Umkhakha wencazelo wenguqulo endala, osasekelwa.
• order: Ulwazi lokuhlela olungakhethwa.
• harness: Ulwazi lokufanisa i-Harness olungakhethwa.
• model: Ulwazi lokufanisa imodeli olungakhethwa.

Uma ushintsha igama nencazelo kuphela kukhonsoli ye-Web, ezinye izinkinobho ze-Frontmatter ziyagcinwa futhi azibhalwa phezu ngokuphelele.

Ukufaka ohlwini ama-Persona

agent-purge ls

Lo myalo ubala wonke ama-Persona futhi umaka okufanayo kwamanje. Uphinde ubonise isimo sokufakwa kwama-Harness esitholwe ngesikhathi sokusebenza, inguqulo, ungqimba lokufaka kanye nokutholakala kweziteshi ezahlukene.

Ukushintsha i-Persona yamanje

agent-purge use <id>

Lapha <id> ihambisana nesihlonzi segama lefayela le-Persona esohlwini lwemibhalo lwe-personas/. Ngemva kokushintsha, izingcingo ezilawulwayo ezilandelayo zizosebenzisa le-Persona.

Ukucacisa i-Persona ocingweni olulodwa kuphela

Uma ungafuni ukushintsha okukhethiwe emhlabeni wonke, ungacacisa enye i-Persona kulolu cingo kuphela:

agent-purge pi --persona <id>

Le ndlela ilungele ukuhlola okwesikhashana imiphumela yemiyalelo ehlukene; ngemva kokuphela kocingo, le-Persona ngeke ibe ukukhetha okuzenzakalelayo kwezingcingo ezilandelayo.

Izibonelo zokusetshenziswa okuyisisekelo

Ukuqalisa ikhonsoli ye-Web

agent-purge web

Bese uvakashela http://127.0.0.1:7788. Ikhonsoli ingasetshenziswa ukubuka isimo sokusebenza nokulawula iswishi enkulu. Uma uvala iswishi enkulu, ukufaka kuyahlehliswa.

Ukuqalisa i-Codex nge-Persona yamanje

agent-purge codex

i-agent-purge izophatha ukuqaliswa ngokwe-Backend efanele kanye nemvelo yokusebenza yomshini wendawo, bese izama ukusebenzisa i-Persona yamanje ngendlela etholakala ngempela kuleyo Harness.

Ukuthumela umbuzo wesikhashana ku-pi

agent-purge pi --ask "Sicela uhlole indlela yokuphatha amaphutha kule phrojekthi"

Lo myalo uqalisa ucingo olulodwa nge-Persona yamanje futhi usebenzisa okuqukethwe okulandela u---ask njengombuzo walolu cingo.

Ukushintsha ngesikhathi seseshini

Kuma-Harness asekela isiteshi se-Slash, ungasebenzisa lokhu phakathi neseshini:

/purge on
/purge status
/purge off

• /purge on: Nika amandla ukufakwa kwe-Persona.
• /purge status: Buka isimo samanje.
• /purge off: Vala ukufaka ngaphandle kokushintsha ukumisa okukudiski.

Ukuqinisekisa ukuthi ukufaka kusebenzile ngempela

matrix.json igcina ithebula lamakhono amile, kodwa isimemezelo esimile asilingani ngaso sonke isikhathi nesimo sangempela somshini wamanje. Umehluko wenguqulo, indlela yokufaka kanye nezinguquko ze-Harness uqobo kungathinta ukutholakala kweziteshi.

Ngakho-ke, qala ngokubheka ulwazi lwesikhathi sokusebenza olunikezwa yi-agent-purge ls noma ikhonsoli ye-Web. Luzobonisa:

• Ukuthi i-Harness isifakiwe yini.
• Inguqulo ye-Harness etholakele.
• Ukuthi imiyalelo ikungqimba lokufaka le-SYS noma le-USER.
• Ukuthi iziteshi ezintathu, i-install, i-shim ne-slash, ziyatholakala yini.

Uma ithebula lamakhono amile liphikisana nemiphumela yokuhlolwa kwesikhathi sokusebenza, sebenzisa imiphumela yesikhathi sokusebenza.

Amacebo okusetshenziswa okuthuthukile

Ukulungiselela ama-Persona amaningi emisebenzi ehlukene

Ungagcina amafayela amaningi e-Markdown ngaphansi kwe-personas/, isibonelo amafayela ahlukene okubuyekeza ikhodi, iziphakamiso zokuyakha kabusha noma ukusebenzisana kwansuku zonke ekuthuthukiseni. Sebenzisa i-description ukucacisa inhloso, futhi usebenzise i-order ukulungisa ukuhleleka kokuboniswa; uma udinga ukukhawulela ububanzi bokufanisa, sebenzisa umkhakha we-harness noma we-model.

Ngaphambi kokushintsha, qala ngokusebenzisa:

agent-purge ls

Ngemva kokuqinisekisa i-Persona eqondiwe, sebenzisa:

agent-purge use <id>

Ukuhlukanisa ukumisa kwesikhathi eside nokuhlola kwesikhashana

• Uma kudingeka kusebenze njalo, sebenzisa isiteshi se-install esisekelwa yi-Harness eqondiwe.
• Uma ufuna ukuthi nemiyalo yokuqala ethayiphiwe ngokuqondile iphathwe yi-agent-purge, sebenzisa isiteshi se-shim.
• Uma ufuna ukuhlola kuphela kuseshini yamanje, sebenzisa kuqala isiteshi se-slash noma ipharamitha yesikhathi esisodwa ethi --persona.

Ukuthi isiteshi esithile singasetshenziswa yini kusafanele kunqunywe ngemiphumela yokuhlolwa kwesikhathi sokusebenza.

Ukugcina indlela yokubuyisela ngaphambi kokushintsha

Nakuba iphrojekthi igcina isimo futhi inikeza imisebenzi ehlehlisekayo, ekusetshenzisweni kwangempela kusanconywa ukuthi uqale uqinisekise i-Persona yamanje, i-Harness eqondiwe nemodi enikwe amandla. Ngemva kokuhlola, ungahlehlisa usebenzisa:

agent-purge uninstall <h>
agent-purge disarm

Ungashintshela futhi ku---mode off, noma uvale iswishi enkulu kukhonsoli ye-Web.

Ungaphazamisi ukuqala okujwayelekile ngokuphumelela kokufaka

Kumaklayenti edeskithophu avaliwe lapho umyalelo wesistimu ukuseva noma ukukanambambili okuvalekile, i-agent-purge izoqalisa kuphela ngendlela ejwayelekile futhi ngeke ifake imiyalelo. Uma usebenzisa agent-purge <h>, ithuluzi lizokhipha ngokusobala isizathu sokuthi kungani ukufaka kungenzeki, esikhundleni sokuzenza sengathi sekuqalile ukusebenza.

Ukubuka ngokushesha isakhiwo sephrojekthi

• bin/: Indawo yokungena ye-CLI.
• lib/: Umqondo wesimo, ama-Persona, ukufaka, iziteshi nokuhlola.
• backends/: Amapharamitha okuqalisa ama-Harness ahlukahlukene nokuphathwa kwemisho yobunikazi.
• web/: Ikhonsoli yendawo, okuhlanganisa i-server.mjs ne-ui.html.
• bench/: Ukuhlolwa kwangempela kwezinga lempumelelo yokufaka nemibhalo yokwahlulela, esetshenziswa kuphela ekuthuthukiseni futhi engabambi iqhaza ekusebenzeni okuvamile.
• matrix.json: Ithebula lamakhono amile.

Imingcele yokuphepha, yobumfihlo nokuhambisana nemithetho

agent-purge ibekwe ku-Harness esemthethweni yendawo umsebenzisi anegunya lokuyiphatha, futhi isetshenziselwa ubunjiniyela bezikhuthazi nokuhlola ukuqina. Ayiguquli amafayela kanambambili, ayidluli izimvume, ayilayishi isimo sendawo ngaphandle, futhi akufanele isetshenziswe kumasistimu angagunyaziwe.

• Yisebenzise kuphela kumadivayisi, kusofthiwe nasezindaweni zokuhlola ezithobela imithetho olawula ngokusemthethweni.
• Ungayisebenzisi ekuhlaseleni okungagunyaziwe, ekuxhashazweni kobuthakathaka, ekwebiweni kwedatha, ekungeneni ngokungemthetho noma ekusabalaliseni imithwalo enonya.
• Ungaphuli imithetho esebenzayo, imigomo yezinsizakalo zamamodeli noma izinqubomgomo zokusetshenziswa kabi.
• Le phrojekthi inikezwa ngaphansi kwelayisensi ye-MIT “njengoba injalo”; abasebenzisi banesibopho sokufaka kwabo, okukhiphayo nokuziphatha kwabo kokusetshenziswa.
• Lapho usebenzisa igama, imibono, ikhodi noma izikhuthazi zephrojekthi, nikeza ukuqashelwa futhi ubonise umthombo ngokwesitatimende sesilondolozi.

README iphinde ibeke imikhawulo eqinile ekufinyeleleni amaseva namawebhusayithi ezindawo ezithile. Ngaphambi kokusetshenziswa kwangempela, funda ngokugcwele izitatimende zokuzihlangula nokuthobela imithetho ezisesilondolozini, futhi uqinisekise ukuthi ububanzi bokusebenza buhambisana nezimfuneko zazo.

Isifinyezo

agent-purge ihlanganisa izindawo zokungena zezikhuthazi ezingahambisani zama-Coding Agent amaningi ibe imiqondo efana ne-Persona, install, shim ne-slash, futhi inikeza ikhonsoli yeWebhu, ukutholwa ngesikhathi sokusebenza kanye nekhono lokuhlehlisa izinguquko. Lapho uqala, ungafaka ithuluzi, uvule ikhonsoli yeWebhu, usebenzise agent-purge ls ukuze uhlole ukusekelwa, bese ukhetha i-Persona ukuze uqalise i-Harness oyifunayo. Ezivivinyweni zesikhashana, sebenzisa kuqala i-Persona yesikhathi esisodwa noma ukushintsha okushisayo phakathi neseshini; ekucushweni kwesikhathi eside, yenza kusebenze iziteshi ezihlala zisebenza kuphela ngemva kokuqinisekisa amakhono esikhathi sokusebenza nemingcele yokuthobela imithetho.