Mahalliy ustuvorlikka ega veb-tadqiqot va brauzer avtomatizatsiyasi uchun qz-browser-agent’dan foydalanish

qz-browser-agent nima?

qz-browser-agent, shuningdek 轻舟 yoki “yengil qayiq” deb ataladi, veb-tadqiqot, brauzerni avtomatlashtirish va tuzilgan ma’lumotlarni ajratib olish uchun mahalliy ishlashga ustuvorlik beruvchi Chrome kengaytmasidir. U o‘zingiz tanlagan model provayderidan foydalanish, brauzer yon paneli orqali veb-saytlar bilan ishlash hamda agent imkoniyatlarini qayta foydalaniladigan Skills yoki TypeScript funksiyalari bilan kengaytirish imkonini beradi.

Sessiyalar, Skills va to‘plangan ma’lumotlar brauzeringizda saqlanadi. Model so‘rovlari topshiriq kontekstiga qo‘shgan promptingiz hamda sahifa yoki fayl tarkibini o‘z ichiga olishi mumkin. Skills va MCP ulanishlari siz sozlagan xizmatlar bilan ma’lumot almashishi mumkin, shuning uchun tashqi xizmatlardan foydalanishdan oldin loyihaning ruxsatlar va ma’lumotlar oqimi haqidagi hujjatlarini ko‘rib chiqing.

Asosiy imkoniyatlar

• Brauzerni avtomatlashtirish: DOM elementlari yoki skrinshotlar bilan ishlash, shakllarni to‘ldirish hamda ish stoli yoki mobil ko‘rinishlarda tablar bo‘ylab ishlash.
• topshiriqlarni bir vaqtda bajarish, ish jarayonida uni to‘xtatish, yo‘nalishini o‘zgartirish yoki kontekst qo‘shish.
• Tuzilgan ma’lumotlar: jadvallar, media va sahifa tarkibini mahalliy to‘plamlarga ajratib olish, so‘ng natijalarni yon panelda ko‘rish, tahrirlash va eksport qilish.
• Skills: ko‘rsatmalar, skriptlar, vositalar va maxsus yon panel interfeysini ixtiyoriy ravishda mos veb-saytlarda faollashadigan, qayta foydalaniladigan ish jarayonlariga birlashtirish.
• Model tanlovi: mos API protokoli va vositalar orqali chaqiruvlarni qo‘llab-quvvatlaydigan provayderlarni, jumladan mahalliy model serverlarini ulash.
• TypeScript imkoniyatlari: agent vositalari, panel ko‘rinishlari, sozlamalar sahifalari yoki model provayderlarini qo‘shish.
• MCP ko‘prigi: ixtiyoriy ravishda mahalliy MCP ko‘prigi orqali brauzer vositalari va topshiriq boshqaruvlarini tashqi agentlarga taqdim etish.

Chrome kengaytmasini o‘rnatish

Eng so‘nggi relizdan foydalanish

1. qz-browser-agent’ning eng so‘nggi relizini yuklab oling.
2. Yuklab olingan ZIP arxivini chiqaring.
3. Chrome’da chrome://extensions manzilini oching.
4. Dasturchi rejimini yoqing.
5. Qadoqlanmagan kengaytmani yuklash tugmasini bosing va chiqarilgan qz-browser-agent-extension jildini tanlang.

Manba kodidan qurish

qz’ni mahalliy ravishda qurish uchun Node.js 24 LTS va npm’ni o‘rnating, so‘ng repository’ni klonlang yoki yuklab oling. Loyiha jildida bog‘liqliklarni o‘rnating va kengaytma buildini yarating:

npm ci
npm run build

Build tugagach, chrome://extensions sahifasiga qayting, Qadoqlanmagan kengaytmani yuklashni tanlang va yaratilgan dist/extension/ jildini ko‘rsating.

Model provayderini sozlash

1. Kengaytma asboblar panelidan qz yon panelini oching.
2. Sozlamalarni oching.
3. Model provayderini tanlang va uning hisob ma’lumotlarini kiriting.
4. Maxsus endpoint’dan foydalanayotgan bo‘lsangiz, uning URL manzili va qo‘llab-quvvatlanadigan protokolini kiriting.
5. Modelni tanlang va konfiguratsiyani saqlang.

qz qo‘llab-quvvatlanadigan API protokoli va vositalar orqali chaqiruvlarni taqdim etadigan provayderlar bilan ishlash uchun mo‘ljallangan. Sozlamangizga qarab, mos hostingdagi provayder yoki mahalliy model serveridan foydalanishingiz mumkin.

Birinchi brauzer topshirig‘ini bajaring

Provayder sozlangach, oddiy tadqiqot va ajratib olish so‘rovidan boshlang:

example.com saytini oching va uning asosiy sarlavhasini jadvalga ajrating.

Agent so‘ralgan sahifaga o‘tishi, tarkibini tekshirishi va ajratib olingan natijani mahalliy to‘plamga joylashtirishi mumkin. To‘plangan ma’lumotlarni ko‘rish yoki tahrirlash uchun yon paneldan foydalaning, to‘plam tayyor bo‘lgach uni eksport qiling.

Murakkabroq tadqiqotlar uchun qz’dan bir nechta sahifa yoki tab bo‘ylab ishlashni so‘rang. Topshiriqda bir-biridan mustaqil ishlar bo‘lsa, parallel quyi topshiriqlar ularni bir vaqtda qayta ishlashga yordam beradi. Shuningdek, bajarilayotgan topshiriqni to‘xtatishingiz, uning yo‘nalishini o‘zgartirishingiz yoki qo‘shimcha kontekst berishingiz mumkin.

qz’ni Skills bilan kengaytirish

Skills takroriy ish jarayonlari uchun qayta foydalaniladigan paketlardir. Skill ko‘rsatmalar, JavaScript avtomatlashtirishi, vositalar va yon paneldagi maxsus interaktiv vidjetlarni birlashtirishi mumkin. Site Skills mos veb-saytlarda faollashadigan qilib ham sozlanishi mumkin.

Skills’ni qz interfeysidan boshqaring yoki ularni Git repository’laridan o‘rnating. Muayyan saytdan ma’lumot to‘plash yoki natijalarni maxsus panel komponenti orqali taqdim etish kabi takroriy tadqiqot topshiriqlarida izchil xatti-harakat kerak bo‘lsa, Skills’dan foydalaning.

TypeScript imkoniyatlarini qo‘shish

TypeScript imkoniyatlari dasturchilarga kengaytmaga yangi funksiyalar qo‘shish imkonini beradi. Ular agent vositalari, vosita natijalarini ko‘rsatuvchilar, sozlamalar sahifalari, panel ko‘rinishlari yoki model provayderlarini taqdim etishi mumkin.

Boshlash uchun loyiha capability namunasini src/capabilities/ ichiga ko‘chiring, ro‘yxatdan o‘tkazish nomlarini o‘zgartiring va funksiyangizga kerak bo‘lgan hissalarni qoldiring. Minimal kirish fayli vositalar va ko‘rsatuvchilarni quyidagicha eksport qilishi mumkin:

// src/capabilities/<your-feature>/index.ts
export { default as tools } from "./tools.js";
export { default as renderers } from "./renderers.js";

Build ushbu deklaratsiyalarni avtomatik aniqlaydi. Vosit Handler’lari fon service worker’ida ishlaydi va amaldagi tablarga amallar yoki skript bajarilishini topshirishi mumkin. Ko‘rsatuvchilar yon panelda interaktiv natija kartalarini joylashtiradi.

SDK tafsilotlari va joriy kengaytma shartnomalari uchun imkoniyatlar qo‘llanmasi hamda loyihaning hissa qo‘shuvchilar hujjatlari bilan tanishing. Ushbu API'lar eksperimental hisoblanadi, shuning uchun kengaytma yaratishda ehtimoliy o‘zgarishlarni hisobga oling.

Ishlab chiqish jarayoni

Loyihaning test muhitini buyruqlar va yig‘ish parametrlari hujjatlaridagi ko‘rsatmalarga amal qilib sozlang. Asosiy ishlab chiqish buyruqlari:

npm run dev       # Manba o‘zgarishlarida qayta yig‘ish
npm test          # Standart test to‘plamlarini ishga tushirish
npm run verify    # Turlarni tekshirish va qamrov bilan avtomatlashtirilgan to‘plamlarni ishga tushirish

Qayta yig‘ilgandan so‘ng kengaytmani chrome://extensions sahifasidan qayta yuklang va qz yon panelini qayta oching. Bu Chrome eng so‘nggi yaratilgan kengaytma fayllaridan foydalanayotganini ta’minlaydi.

Kengaytirilgan foydalanish bo‘yicha maslahatlar

• Tuzilgan promptlardan foydalaning: ajratib olinadigan ma’lumotlarni foydali to‘plamga tartiblash uchun maqsadli sahifalar, yig‘iladigan maydonlar va kerakli chiqish formatini tasvirlab bering.
• To‘g‘ri o‘zaro ta’sir rejimini tanlang: DOM asosidagi o‘zaro ta’sir sahifa elementlari va shakllar uchun foydali, skrinshot asosidagi o‘zaro ta’sir esa vizual kontekst muhim bo‘lganda yordam beradi.
• Takrorlanadigan ish jarayonlarini ajrating: takroriy ko‘rsatmalar va skriptlarni har bir promptda qayta yozish o‘rniga Skills'ga aylantiring.
• Parallel ishlashdan ehtiyotkorlik bilan foydalaning: mustaqil tadqiqot vazifalarini bir vaqtda topshiring, so‘ng yon panelda birlashtirilgan natijalarni ko‘rib chiqing.
• Zarur bo‘lganda mahalliy xizmatlarni afzal ko‘ring: qz mahalliy model serverlarini qo‘llab-quvvatlaydi, bu model trafigini siz nazorat qiladigan infratuzilma doirasida saqlashga yordam beradi.
• Ma’lumotlar ulanishlarini ko‘rib chiqing: sahifa mazmuni, fayllar, Skills va MCP integratsiyalari so‘rovlarga kiritilishi yoki sozlangan xizmatlar bilan almashilishi mumkin. Maxfiy ma’lumotlar bilan ishlashdan oldin ruxsatlarni tekshiring.
• Manba o‘zgarishlaridan so‘ng qayta yuklang: muvaffaqiyatli qayta yig‘ish kengaytmani avtomatik yangilamaydi; testdan oldin uni Chrome'da qayta yuklang.

Ixtiyoriy MCP integratsiyasi

Ixtiyoriy mahalliy MCP ko‘prigi brauzer vositalari va vazifa boshqaruvlarini tashqi agentlarga taqdim etadi. Boshqa MCP bilan mos agent yoki ilova qz'ni boshqarishi kerak bo‘lganda undan foydalaning. MCP ulanishlari sozlangan xizmatlar bilan ma’lumot almashishi mumkinligi sababli, uni yoqishdan oldin ko‘prik hujjatlari va ma’lumotlar oqimi ta’sirini ko‘rib chiqing.

Xulosa

qz-browser-agent Chrome yon paneli, model boshqaruvidagi brauzer avtomatlashtirishi, tuzilgan mahalliy to‘plamlar, parallel quyi vazifalar hamda Skills va TypeScript orqali kengaytirish imkoniyatlarini birlashtiradi. Tez boshlash uchun relizni o‘rnating, mos model provayderini sozlang va maqsadli ma’lumot ajratib olish promptini sinab ko‘ring. Maxsus ish jarayonlari yoki integratsiyalar kerak bo‘lsa, manba kodidan yig‘ing va loyihani Skills, imkoniyatlar yoki ixtiyoriy MCP ko‘prigi yordamida kengaytiring.