agent-purge qo‘llanmasi: Coding Agent tizim promptlari va Personalarni yagona boshqarish

agent-purge nima

agent-purge bir nechta Coding Agent uchun tizim promptlarini boshqarish vositalari to‘plamidir. Turli Agentlar promptlarni ishga tushirish parametrlari, konfiguratsiya fayllari, Hook yoki plaginlar orqali o‘qishi mumkin. agent-purge bu farqlarni yashiradi va foydalanuvchiga bitta Persona mazmuni asosida promptni kiritish, almashtirish va bekor qilish imkonini beradi.

Loyiha uchta rejimni qo‘llab-quvvatlaydi:

• replace: Persona matni bilan maqsadli tizim promptini almashtiradi.
• append: Persona matnini mavjud prompt oxiriga qo‘shadi.
• off: kiritishni o‘chiradi va o‘zgarishlarni bekor qiladi.

Rejimlarni ishlash vaqtida almashtirish mumkin. Web boshqaruvini o‘chirish yoki --mode off buyrug‘idan foydalanish tegishli o‘zgarishlarni asl holatiga qaytaradi va boshqariladigan kiritish izlarini qoldirmaydi.

Asosiy mexanizmlar va funksiyalar

Yagona uchta kanal

agent-purge turli Harness’larni moslashtirish uchun uchta kanaldan foydalanadi. Uchala kanal ham yakunda joriy personas/<id>.md faylining matnidan foydalanadi.

• install: maqsadli Harness’ga boshqariladigan konfiguratsiya blokini yozadi; bunda Markdown, Hooks yoki plagin mexanizmidan foydalanilishi mumkin. Bu doimiy konfiguratsiya bo‘lib, tegishli Harness’ni to‘g‘ridan-to‘g‘ri ishga tushirgan boshqa foydalanuvchilarga ham ta’sir qiladi.
• shim: PATH boshiga ayni nomdagi buyruq qobig‘ini joylashtiradi va chaqiruvni agent-purge <h> buyrug‘iga yo‘naltiradi. Shu tariqa bevosita kiritilgan asl buyruqni boshqaradi.
• slash: sessiya ichida /purge on, /purge off yoki /purge status orqali konfiguratsiya fayllarini o‘zgartirmasdan rejimni ishlash vaqtida almashtiradi.

Mahalliy saqlash va qaytarish imkoniyati

Loyiha faqat prompt bilan bog‘liq joylarni o‘zgartiradi, ikkilik fayllarni o‘zgartirmaydi, litsenziyani buzmaydi yoki chetlab o‘tmaydi. Holat kompyuterdagi state.json faylida saqlanadi va yuklanmaydi. O‘rnatishni bekor qilish, boshqaruvni olib tashlash yoki rejimni o‘chirish orqali dastlabki holatni tiklash mumkin.

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

Muayyan Harness qaysi kanallarni qo‘llab-quvvatlashi kompyuterda ishga tushirish vaqtida aniqlangan natijalarga ko‘ra belgilanadi.

O‘rnatish talablari

agent-purge’ni ishga tushirish uchun Node.js 20 yoki undan yuqori versiyasi kerak. Loyihaning o‘zi hech qanday bog‘liqlikka ega emas. Uni npm orqali global o‘rnatish yoki Web boshqaruv panelini npx yordamida bevosita ochish mumkin.

O‘rnatish va ilk ishga tushirish

1-usul: global o‘rnatish

npm i -g agent-purge

O‘rnatish tugagach, quyidagini bevosita ishga tushiring:

agent-purge web

Mahalliy boshqaruv panelining standart manzili http://127.0.0.1:7788. Ushbu manzilni brauzerda ochib, Persona’lar, Harness holati va bosh boshqaruvni ko‘rish hamda boshqarish mumkin.

2-usul: npx orqali ishga tushirish

Global o‘rnatishni oldindan amalga oshirishni istamasangiz, quyidagini bevosita ishga tushiring:

npx agent-purge web

Ma’lumotlar katalogi

Konfiguratsiya va Persona’lar npm paketi katalogida saqlanmaydi, shuning uchun paketni yangilash foydalanuvchi ma’lumotlarini ustiga yozmaydi. Standart joylashuv:

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

Katalog asosan state.json va personas/ ni o‘z ichiga oladi. Ilk ishga tushirishda vosita Persona katalogida boshlang‘ich neutral.md shablonini yaratadi.

Agar avval 0.1.x versiyasidan foydalanilgan bo‘lsa, yangi versiya ilk bor ishga tushirilganda paket katalogida joylashgan eski ma’lumotlar avtomatik ko‘chiriladi va asl fayllar saqlab qolinadi.

Ma’lumotlarni saqlash joyini sozlash

Alohida ma’lumotlar katalogini belgilash uchun AGENT_PURGE_HOME muhit o‘zgaruvchisidan foydalanish mumkin. Bu Persona’larni zaxiralash, ish muhitlarini ajratish yoki konfiguratsiyani boshqa diskka joylashtirish kerak bo‘lgan holatlar uchun qulay.

Linux yoki macOS

export AGENT_PURGE_HOME=/path/to/your/data

Windows

setx AGENT_PURGE_HOME D:\ap-data

O‘rnatgandan so‘ng, muhit o‘zgaruvchisi kuchga kirganiga ishonch hosil qilish uchun agent-purge’ni yangi terminal sessiyasida ishga tushiring.

Persona’larni tushunish va boshqarish

Har bir Persona uchun personas/<id>.md fayli mavjud. Fayl Frontmatter va asosiy matndan iborat bo‘lib, asosiy matn tizim promptiga amalda yoziladigan mazmundir.

Frontmatter quyidagi maydonlarni qo‘llab-quvvatlaydi:

• description: Persona tavsifi; Web ro‘yxatida va agent-purge ls chiqishida ko‘rsatiladi.
• desc: eski tavsif maydoni, hanuz qo‘llab-quvvatlanadi.
• order: ixtiyoriy saralash ma’lumotlari.
• harness: ixtiyoriy Harness mosligi ma’lumotlari.
• model: ixtiyoriy model mosligi ma’lumotlari.

Web boshqaruv panelida faqat nom va tavsif o‘zgartirilganda, boshqa Frontmatter kalitlari saqlanadi va butun blok ustiga yozilmaydi.

Persona’larni ro‘yxatlash

agent-purge ls

Bu buyruq barcha Persona’larni ro‘yxatlaydi va joriy mos keluvchi elementni belgilaydi. Shuningdek, ishga tushirish vaqtida aniqlangan Harness o‘rnatilishi, versiyasi, kiritish qatlami va har bir kanalning mavjudligini ko‘rsatadi.

Joriy Persona’ni almashtirish

agent-purge use <id>

Bu yerdagi <id> personas/ katalogidagi Persona faylining nom identifikatoriga mos keladi. Almashtirgandan so‘ng, keyingi boshqariladigan chaqiruvlar ushbu Persona’dan foydalanadi.

Faqat bitta chaqiruv uchun Persona belgilash

Joriy global tanlovni o‘zgartirmoqchi bo‘lmasangiz, faqat shu chaqiruv uchun boshqa Persona’ni belgilang:

agent-purge pi --persona <id>

Bu usul turli promptlarning ta’sirini vaqtincha sinash uchun mos. Chaqiruv tugagach, ushbu Persona keyingi chaqiruvlar uchun standart tanlovga aylanmaydi.

Asosiy foydalanish misollari

Web boshqaruv panelini ishga tushirish

agent-purge web

So‘ng http://127.0.0.1:7788 manziliga kiring. Boshqaruv paneli ish holatini ko‘rish va bosh boshqaruvni boshqarish uchun ishlatiladi. Bosh boshqaruv o‘chirilganda, kiritish bekor qilinadi.

Joriy Persona bilan Codex’ni ishga tushirish

agent-purge codex

agent-purge mos Backend va kompyuterdagi ish muhiti asosida ishga tushirishni boshqaradi hamda joriy Persona’ni ushbu Harness’da amalda mavjud mexanizm orqali qo‘llashga urinadi.

pi’ga bir martalik savol yuborish

agent-purge pi --ask "Iltimos, ushbu loyihaning xatolarni qayta ishlash mantiqini tekshiring"

Bu buyruq joriy Persona bilan bir martalik chaqiruvni ishga tushiradi va --ask dan keyingi matnni shu davradagi savol sifatida uzatadi.

Sessiya ichida ishlash vaqtida almashtirish

Slash kanalini qo‘llab-quvvatlaydigan Harness’lar uchun sessiya ichida quyidagilardan foydalanish mumkin:

/purge on
/purge status
/purge off

• /purge on: Persona kiritilishini yoqadi.
• /purge status: joriy holatni ko‘rsatadi.
• /purge off: kiritishni o‘chiradi va diskdagi konfiguratsiyani o‘zgartirmaydi.

Kiritish haqiqatan kuchga kirganini qanday tekshirish mumkin

matrix.json statik imkoniyatlar matritsasini saqlaydi, ammo statik e’lon kompyuterdagi haqiqiy joriy holat bilan har doim ham teng emas. Versiya farqlari, o‘rnatish usuli va Harness’ning o‘zidagi o‘zgarishlar kanallarning mavjudligiga ta’sir qilishi mumkin.

Shuning uchun agent-purge ls yoki Web boshqaruv paneli taqdim etadigan ishga tushirish vaqtiga oid ma’lumotlarni birinchi navbatda tekshiring. Ular quyidagilarni ko‘rsatadi:

• Harness o‘rnatilganmi.
• Aniqlangan Harness versiyasi.
• Prompt SYS yoki USER kiritish qatlamida joylashganmi.
• install, shim va slash uchta kanalining mavjudligi.

Statik imkoniyatlar jadvali va ishga tushirish vaqtidagi aniqlash natijalari o‘rtasida ziddiyat bo‘lsa, ishga tushirish vaqtidagi natijaga amal qiling.

Kengaytirilgan foydalanish usullari

Turli vazifalar uchun bir nechta Persona tayyorlash

personas/ katalogida bir nechta Markdown faylini saqlash mumkin. Masalan, ulardan alohida-alohida kodni ko‘rib chiqish, refaktoring bo‘yicha tavsiyalar yoki kundalik ishlab chiqish hamkorligi uchun foydalaning. Maqsadni description orqali aniq yozing va ko‘rsatish tartibini order yordamida sozlang; moslik doirasini cheklash kerak bo‘lsa, harness yoki model maydonlaridan foydalaning.

Almashtirishdan oldin quyidagini ishga tushiring:

agent-purge ls

Maqsadli Persona’ni tasdiqlagach, quyidagini bajaring:

agent-purge use <id>

Uzoq muddatli konfiguratsiya va vaqtinchalik tajribalarni ajratish

• Doimiy ishlashi kerak bo‘lsa, maqsadli Harness qo‘llab-quvvatlaydigan install kanalidan foydalaning.
• Asl buyruqni bevosita kiritganda ham uni agent-purge boshqarishini istasangiz, shim kanalidan foydalaning.
• Faqat joriy sessiyada sinamoqchi bo‘lsangiz, slash kanali yoki bir martalik --persona parametridan foydalaning.

Muayyan kanalning mavjudligi ham ishga tushirish vaqtidagi aniqlash natijalariga ko‘ra belgilanadi.

O‘zgartirishdan oldin tiklash yo‘lini saqlash

Loyiha holatni saqlab, qaytarish imkonini beruvchi amallarni taqdim etsa-da, amaliy foydalanishda avval joriy Persona, maqsadli Harness va yoqilgan rejimni tekshirish tavsiya etiladi. Sinov tugagach, quyidagi usullar orqali o‘zgarishlarni bekor qilish mumkin:

agent-purge uninstall <h>
agent-purge disarm

Shuningdek, --mode off rejimiga o‘tish yoki Web boshqaruv panelida bosh boshqaruvni o‘chirish mumkin.

Asl holatda ishga tushirishni muvaffaqiyatli kiritish deb qabul qilmang

Tizim prompti server tomonida yoki yopiq ikkilik faylda joylashgan yopiq manbali desktop dasturlar uchun agent-purge faqat dasturni asl holatda ishga tushiradi va prompt kiritishni bajarmaydi. agent-purge <h> ishga tushirilganda, vosita kiritishning imkonsizligi sababini aniq ko‘rsatadi va kiritish muvaffaqiyatli bo‘lgandek ko‘rsatmaydi.

Loyiha tuzilmasi qisqacha

• bin/: CLI kirish nuqtasi.
• lib/: holat, Persona, kiritish, kanallar va aniqlash mantiqi.
• backends/: har bir Harness uchun ishga tushirish parametrlari va identifikatsiya qatorlarini qayta ishlash.
• web/: mahalliy boshqaruv paneli, jumladan server.mjs va ui.html.
• bench/: kiritish muvaffaqiyatini amalda o‘lchash va hakam skriptlari; faqat ishlab chiqish uchun, odatiy ishga tushirishda qatnashmaydi.
• matrix.json: statik imkoniyatlar matritsasi.

Xavfsizlik, maxfiylik va muvofiqlik chegaralari

agent-purge foydalanuvchi boshqarish huquqiga ega bo‘lgan mahalliy rasmiy Harness uchun mo‘ljallangan bo‘lib, prompt muhandisligi va barqarorlikni baholashga xizmat qiladi. U ikkilik fayllarni o‘zgartirmaydi, avtorizatsiyani chetlab o‘tmaydi, mahalliy holatni tashqariga yuklamaydi va ruxsatsiz tizimlarda ishlatilmasligi kerak.

• Faqat o‘zingiz boshqarish huquqiga ega bo‘lgan qurilmalar, dasturlar va qonuniy tajriba muhitlarida foydalaning.
• Ruxsatsiz hujumlar, zaifliklardan foydalanish, ma’lumotlarni o‘g‘irlash, noqonuniy kirib borish yoki zararli yuklamalarni tarqatish uchun foydalanmang.
• Amaldagi qonunlar va qoidalarni, model xizmatlari shartlarini hamda suiiste’molga qarshi siyosatlarni buzmang.
• Loyiha MIT litsenziyasi asosida “mavjud holicha” taqdim etiladi; foydalanuvchi o‘z kiritmalari, chiqishlari va foydalanish xatti-harakatlari uchun javobgardir.
• Loyiha nomi, g‘oyalari, kodi yoki promptlaridan foydalanganda ombor deklaratsiyasiga muvofiq mualliflikni ko‘rsating va manbani belgilang.

README shuningdek, ayrim hududlardagi serverlar va veb-saytlarga kirishni qat’iy cheklaydi. Amalda foydalanishdan oldin ombordagi javobgarlikdan ozod qilish va muvofiqlik deklaratsiyasini to‘liq o‘qing hamda amallar doirasi undagi talablarga mos kelishiga ishonch hosil qiling.

Xulosa

agent-purge turli Coding Agent’lardagi bir-biridan farq qiluvchi prompt kirish nuqtalarini Persona, install, shim va slash kabi yagona tushunchalarga birlashtiradi hamda Web konsoli, ish vaqtida aniqlash va qaytarib olish imkoniyatlarini taqdim etadi. Ishni boshlashda avval vositani o‘rnating, Web konsolini oching, qo‘llab-quvvatlanish holatini tekshirish uchun agent-purge ls buyrug‘ini ishga tushiring, so‘ng maqsadli Harness’ni ishga tushirish uchun Persona’ni tanlang. Vaqtinchalik tajribalar uchun bir martalik Persona yoki sessiya davomida tezkor almashtirishdan foydalanish ma’qul; uzoq muddatli konfiguratsiya uchun esa doimiy kanalni yoqishdan oldin ish vaqtidagi imkoniyatlar va muvofiqlik chegaralarini tasdiqlash kerak.