Jinsi ya Kutumia qz-browser-agent kwa Utafiti wa Wavuti wa Kwanza wa Ndani na Uendeshaji wa Kivinjari

qz-browser-agent Ni Nini?

qz-browser-agent, pia huitwa 轻舟 au “mashua nyepesi,” ni kiendelezi cha Chrome kinachotanguliza matumizi ya ndani kwa ajili ya utafiti wa wavuti, uendeshaji otomatiki wa kivinjari, na uchimbaji wa data iliyopangwa. Hukuwezesha kutumia mtoa huduma wa modeli unayemiliki, kuingiliana na tovuti kupitia kidirisha cha pembeni cha kivinjari, na kupanua wakala kwa kutumia Skills zinazoweza kutumika tena au uwezo wa TypeScript.

Vipindi, Skills, na data iliyokusanywa huhifadhiwa kwenye kivinjari chako. Maombi ya modeli yanaweza kujumuisha agizo lako pamoja na maudhui ya ukurasa au faili yoyote unayoongeza kwenye muktadha wa kazi. Skills na miunganisho ya MCP zinaweza kubadilishana data na huduma unazosanidi, kwa hiyo soma hati za ruhusa na mtiririko wa data wa mradi kabla ya kutumia huduma za nje.

Vipengele Muhimu

• Uendeshaji otomatiki wa kivinjari: ingiliana na vipengele vya DOM au picha za skrini, jaza fomu, na fanya kazi kwenye vichupo vingi katika mionekano ya kompyuta au simu.
• Kazi ndogo sambamba: endesha kazi kwa wakati mmoja na uikatishe, ielekeze upya, au uongeze muktadha wakati kazi inaendelea.
• Data iliyopangwa: chota majedwali, maudhui ya media, na maudhui ya kurasa kwenye mikusanyo ya ndani, kisha hakiki, hariri, na hamisha matokeo kutoka kwenye kidirisha cha pembeni.
• Skills: panga maagizo, hati, zana, na kiolesura maalum cha kidirisha cha pembeni kuwa michakato ya kazi inayoweza kutumika tena, pamoja na kuwezesha kwa hiari kwenye tovuti zinazolingana.
• Chaguo la modeli: unganisha watoa huduma wanaotumia itifaki ya API inayooana na kuita zana, wakiwemo seva za modeli za ndani.
• Uwezo wa TypeScript: ongeza zana za wakala, mionekano ya paneli, kurasa za mipangilio, au watoa huduma wa modeli.
• Daraja la MCP: kwa hiari, wezesha mawakala wa nje kufikia zana za kivinjari na vidhibiti vya kazi kupitia daraja la ndani la MCP.

Sakinisha Kiendelezi cha Chrome

Tumia Toleo la Hivi Karibuni

1. Pakua toleo la hivi karibuni la qz-browser-agent.
2. Fungua kumbukumbu ya ZIP iliyopakuliwa.
3. Fungua chrome://extensions katika Chrome.
4. Washa Developer mode.
5. Bofya Load unpacked na uchague folda iliyofunguliwa ya qz-browser-agent-extension.

Jenga Kutoka kwenye Chanzo

Ili kujenga qz ndani, sakinisha Node.js 24 LTS na npm, kisha kloni au pakua hazina. Kutoka kwenye saraka ya mradi, sakinisha vitegemezi na unda muundo wa kiendelezi:

npm ci
npm run build

Ujenzi unapokamilika, rudi kwenye chrome://extensions, chagua Load unpacked, na uchague saraka iliyozalishwa ya dist/extension/.

Sanidi Mtoa Huduma wa Modeli

1. Fungua kidirisha cha pembeni cha qz kutoka kwenye upau wa zana wa kiendelezi.
2. Fungua Settings.
3. Chagua mtoa huduma wa modeli na uweke vitambulisho vyake.
4. Ikiwa unatumia mwisho maalum, toa URL yake pamoja na itifaki inayotumika.
5. Chagua modeli na uhifadhi usanidi.

qz imeundwa kufanya kazi na watoa huduma wanaotoa itifaki ya API inayotumika na kuita zana. Unaweza kutumia mtoa huduma wa mtandaoni anayeoana au seva ya modeli ya ndani, kulingana na usanidi wako.

Endesha Kazi ya Kwanza ya Kivinjari

Baada ya kusanidi mtoa huduma, anza kwa ombi rahisi la utafiti na uchimbaji:

Fungua example.com na utoe kichwa chake kikuu kwenye jedwali.

Wakala anaweza kwenda kwenye ukurasa ulioombwa, kukagua maudhui yake, na kuweka matokeo yaliyotolewa kwenye mkusanyo wa ndani. Tumia kidirisha cha pembeni kuhakiki au kuhariri data iliyokusanywa, na uhamishe data hiyo mkusanyo ukiwa tayari.

Kwa utafiti unaohitaji hatua zaidi, iombe qz ifanye kazi kwenye kurasa au vichupo vingi. Kazi ikiwa na sehemu huru za kushughulikiwa, kazi ndogo sambamba zinaweza kusaidia kuzichakata kwa wakati mmoja. Unaweza pia kukatiza kazi inayoendelea, kuielekeza upya, au kutoa muktadha wa ziada.

PANUA qz KWA SKILLS

Skills ni vifurushi vinavyoweza kutumika tena kwa michakato ya kazi inayorudiwa. Skill inaweza kuchanganya maagizo, uendeshaji otomatiki wa JavaScript, zana, na wijeti maalum shirikishi kwenye kidirisha cha pembeni. Skills za tovuti zinaweza pia kusanidiwa ziwezeshwe kwenye tovuti zinazolingana.

Dhibiti Skills kutoka kwenye kiolesura cha qz au zisakinishe kutoka kwenye hazina za Git. Tumia Skills wakati mchakato wa kazi unahitaji tabia thabiti katika kazi za utafiti zinazorudiwa, kama vile kukusanya taarifa kutoka kwenye tovuti fulani au kuwasilisha matokeo kupitia kijenzi maalum cha paneli.

Ongeza Uwezo wa TypeScript

Uwezo wa TypeScript huwawezesha watengenezaji kuchangia utendaji mpya kwenye kiendelezi. Unaweza kutoa zana za wakala, vitekeleza uwasilishaji wa matokeo ya zana, kurasa za mipangilio, mionekano ya paneli, au watoa huduma wa modeli.

Ili kuanza, nakili mfano wa uwezo wa mradi kwenye src/capabilities/, badilisha majina ya usajili, na uache michango ambayo kipengele chako kinahitaji pekee. Faili ya mwanzo iliyo ndogo inaweza kuhamisha zana na vitekeleza uwasilishaji kama hivi:

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

Mchakato wa ujenzi hugundua matamko haya kiotomatiki. Vishughulikiaji vya zana huendesha kwenye service worker ya nyuma na vinaweza kukabidhi vitendo au utekelezaji wa hati kwenye vichupo vinavyotumika. Vitekeleza uwasilishaji huweka kadi shirikishi za matokeo kwenye kidirisha cha pembeni.

Kwa maelezo ya SDK na mikataba ya sasa ya viendelezi, soma mwongozo wa uwezo na nyaraka za wachangiaji za mradi. API hizi ni za majaribio, kwa hiyo zingatia uwezekano wa mabadiliko unapounda kiendelezi.

Mtiririko wa Maendeleo

Sanidi mazingira ya majaribio ya mradi kwa kufuata nyaraka za amri na chaguo za ujenzi. Amri kuu za maendeleo ni:

npm run dev       # Jenga upya mabadiliko ya msimbo yanapotokea
npm test          # Endesha seti chaguomsingi za majaribio
npm run verify    # Kagua aina na endesha seti otomatiki kwa kutumia coverage

Baada ya kujenga upya, pakia tena kiendelezi kutoka chrome://extensions na ufungue upya paneli ya pembeni ya qz. Hii huhakikisha Chrome inaendesha faili za hivi punde za kiendelezi zilizozalishwa.

Vidokezo vya Matumizi ya Juu

• Tumia vidokezo vilivyopangwa: eleza kurasa lengwa, sehemu za kukusanya, na muundo wa matokeo unaotakiwa ili data iliyotolewa iweze kupangwa kuwa mkusanyiko unaofaa.
• Chagua hali sahihi ya mwingiliano: mwingiliano unaotegemea DOM ni muhimu kwa vipengele na fomu za ukurasa, huku mwingiliano unaotegemea picha ya skrini ukisaidia wakati muktadha wa kuona ni muhimu.
• Tenganisha mitiririko ya kazi inayorudiwa: geuza maagizo na hati zinazorudiwa kuwa Skills badala ya kuzirudia katika kila kidokezo.
• Tumia kazi sambamba kwa uangalifu: kabidhi kwa wakati mmoja kazi huru za utafiti, kisha kagua matokeo yaliyounganishwa kwenye paneli ya pembeni.
• Pendelea huduma za ndani inapofaa: qz inasaidia seva za modeli za ndani, ambazo zinaweza kusaidia kuweka trafiki ya modeli ndani ya miundombinu unayodhibiti.
• Kagua miunganisho ya data: maudhui ya ukurasa, faili, Skills, na miunganisho ya MCP vinaweza kujumuishwa katika maombi au kubadilishana na huduma zilizosanidiwa. Kagua ruhusa kabla ya kushughulikia taarifa nyeti.
• Pakia upya baada ya mabadiliko ya msimbo: ujenzi uliofanikiwa hauonyeshi kiendelezi upya kiotomatiki; kipakie tena kwenye Chrome kabla ya kukijaribu.

Muunganisho wa Hiari wa MCP

Madaraja ya ndani ya MCP ya hiari hufichua zana za kivinjari na vidhibiti vya kazi kwa mawakala wa nje. Itumie unapohitaji wakala au programu nyingine inayooana na MCP idhibiti qz. Kwa kuwa miunganisho ya MCP inaweza kubadilishana data na huduma zilizosanidiwa, kagua nyaraka za daraja na athari za mtiririko wa data kabla ya kuiwezesha.

Hitimisho

qz-browser-agent inachanganya paneli ya pembeni ya Chrome, otomatiki ya kivinjari inayoendeshwa na modeli, mikusanyiko ya ndani iliyopangwa, kazi ndogo sambamba, na uwezo wa kupanuliwa kupitia Skills na TypeScript. Sakinisha toleo lililotolewa kwa kuanza haraka, sanidi mtoa modeli anayeoana, na ujaribu kidokezo mahususi cha uchimbaji. Ikiwa unahitaji mitiririko maalum ya kazi au miunganisho, jenga kutoka kwenye msimbo chanzo na panua mradi kwa kutumia Skills, uwezo, au daraja la hiari la MCP.