Indlela Yokusebenzisa i-qz-browser-agent Ocwaningweni Lwewebhu Olusebenza Kuqala Endaweni Nasekuzenzakaleleni Kwesiphequluli

Yini i-qz-browser-agent?

qz-browser-agent, ebizwa nangokuthi 轻舟 noma “isikebhe esilula,” iyisandiso se-Chrome esibeka okwasendaweni kuqala sokucwaninga kuwebhu, sokwenza imisebenzi yesiphequluli ngokuzenzakalelayo, kanye nokukhipha idatha ehlelekile. Sikuvumela ukuthi usebenzise umhlinzeki wemodeli ozikhethele yena, uxhumane namawebhusayithi usebenzisa iphaneli eseceleni yesiphequluli, futhi unwebe i-agent ngama-Skill asetshenziswa kabusha noma amakhono e-TypeScript.

Izikhathi zokusebenza, ama-Skill, kanye nedatha eqoqiwe kugcinwa esipheqululini sakho. Izicelo zemodeli zingafaka umyalo wakho kanye nanoma yikuphi okuqukethwe kwekhasi noma kwefayela okungezayo kumongo womsebenzi. Ama-Skill noxhumo lwe-MCP angashintshisana ngedatha namasevisi owacushayo, ngakho funda imibhalo yezimvume nokugeleza kwedatha yephrojekthi ngaphambi kokusebenzisa amasevisi angaphandle.

Izici Eziyinhloko

• Ukuzenzakalela kwesiphequluli: sebenzisana nezinto ze-DOM noma nezithombe-skrini, gcwalisa amafomu, futhi usebenze kuwo wonke amathebhu ezibonakalweni zedeskithophu noma zeselula.
• Imisebenzi emincane ehambisanayo: sebenzisa imisebenzi ngesikhathi esisodwa futhi uyiphazamise, uyinikeze enye indlela, noma wengeze umongo ngesikhathi umsebenzi uqhubeka.
• Idatha ehlelekile: khipha amathebula, imidiya, nokuqukethwe kwamakhasi uye kumaqoqo endawo, bese uhlola kuqala, uhlele, futhi uthumele imiphumela ephanelini eseceleni.
• Ama-Skill: hlanganisa imiyalelo, izikripthi, amathuluzi, kanye ne-UI yangokwezifiso yephaneli eseceleni kube izinqubo zokusebenza eziphindaphindekayo, ngokwenza kusebenze ngokuzikhethela kumawebhusayithi afanayo.
• Ukukhetha imodeli: xhuma abahlinzeki abasekela iphrothokholi ye-API ehambisanayo nokubizwa kwamathuluzi, kuhlanganise namaseva amamodeli asendaweni.
• Amakhono e-TypeScript: engeza amathuluzi e-agent, ukubukwa kwephaneli, amakhasi ezilungiselelo, noma abahlinzeki bamamodeli.
• Ibhuloho le-MCP: ngokuzikhethela veza amathuluzi esiphequluli nezilawuli zemisebenzi kuma-agent angaphandle ngebhuloho lendawo le-MCP.

Faka Isandiso se-Chrome

Sebenzisa Ukukhishwa Kwakamuva

1. Landa ukukhishwa kwakamuva kwe-qz-browser-agent.
2. Khipha ingobo yomlando ye-ZIP elandiwe.
3. Vula chrome://extensions ku-Chrome.
4. Vula Imodi yonjiniyela.
5. Chofoza Layisha okungapakishiwe bese ukhetha ifolda ekhishiwe ethi qz-browser-agent-extension.

Yakha Kusuka Kumthombo

Ukuze wakhe i-qz endaweni yakho, faka i-Node.js 24 LTS ne-npm, bese u-clone noma ulande inqolobane. Kusuka kufolda yephrojekthi, faka okuncikile bese udala ukwakhiwa kwesandiso:

npm ci
npm run build

Lapho ukwakha sekuqediwe, buyela ku-chrome://extensions, khetha Layisha okungapakishiwe, bese ukhetha ifolda ekhiqiziwe ethi dist/extension/.

Lungiselela Umhlinzeki Wemodeli

1. Vula iphaneli eseceleni ye-qz kubha yamathuluzi yesandiso.
2. Vula Izilungiselelo.
3. Khetha umhlinzeki wemodeli bese ufaka imininingwane yakhe yokungena.
4. Uma usebenzisa indawo yokugcina yangokwezifiso, nikeza kokubili i-URL yayo nephrothokholi eyisekelayo.
5. Khetha imodeli bese ulondoloza ukucushwa.

i-qz yakhelwe ukusebenza nabahlinzeki abaveza iphrothokholi ye-API esekelwayo kanye nokubizwa kwamathuluzi. Ungasebenzisa umhlinzeki osingathwe ohambisanayo noma iseva yemodeli yasendaweni, kuye ngokusetha kwakho.

Qalisa Umsebenzi Wokuqala Wesiphequluli

Njengoba umhlinzeki eselungiselelwe, qala ngesicelo esilula sokucwaninga nokukhipha:

Vula i-example.com bese ukhipha isihloko sayo esikhulu usifake etafuleni.

I-agent ingaya ekhasini eliceliwe, ihlole okuqukethwe kwalo, bese ibeka umphumela okhishiwe eqoqweni lendawo. Sebenzisa iphaneli eseceleni ukuze uhlole noma uhlele idatha eqoqiwe, bese uyithumela lapho iqoqo selilungile.

Ukuze wenze ucwaningo olunzulu, cela i-qz ukuthi isebenze emakhasini noma kumathebhu amaningi. Uma umsebenzi unezingxenye ezizimele, imisebenzi emincane ehambisanayo ingasiza ukuzicubungula ngesikhathi esisodwa. Ungaphinde uphazamise umsebenzi oqhubekayo, uwunikeze enye indlela, noma unikeze umongo owengeziwe.

Nweba i-qz Ngama-Skill

Ama-Skill amaphakheji asetshenziswa kabusha ezinqubweni zokusebenza eziphindaphindekayo. I-Skill ingahlanganisa imiyalelo, ukuzenzakalela kwe-JavaScript, amathuluzi, kanye namawijethi asebenzisanayo angokwezifiso ephanelini eseceleni. Ama-Skill amasayithi nawo angalungiselelwa ukuthi asebenze kumawebhusayithi afanayo.

Phatha ama-Skill kusixhumi esibonakalayo se-qz noma uwafake kumareposithri e-Git. Sebenzisa ama-Skill lapho inqubo idinga ukuziphatha okuhambisanayo emisebenzini yocwaningo ephindaphindwayo, njengokuqoqa ulwazi kusayithi elithile noma ukwethula imiphumela usebenzisa ingxenye yephaneli yangokwezifiso.

Engeza Amakhono e-TypeScript

Amakhono e-TypeScript avumela onjiniyela ukuthi banikele ngokusebenza okusha esandisweni. Anganikeza amathuluzi e-agent, abahlinzeki bokunikezwa kwemiphumela yamathuluzi, amakhasi ezilungiselelo, ukubukwa kwephaneli, noma abahlinzeki bamamodeli.

Ukuze uqale, kopisha isibonelo samakhono sephrojekthi usiyise ku-src/capabilities/, qamba kabusha ukubhaliswa kwaso, bese ugcina kuphela iminikelo edingwa isici sakho. Ifayela lokuqala elincane lingathumela amathuluzi nabahlinzeki bokunikezwa kwemiphumela kanje:

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

Ukwakhiwa kuthola lezi zimemezelo ngokuzenzakalelayo. Izibambi zamathuluzi zisebenza ku-service worker yangemuva futhi zingadlulisela izenzo noma ukusetshenziswa kwezikripthi kumathebhu asebenzayo. Abahlinzeki bokunikezwa kwemiphumela bafaka amakhadi emiphumela asebenzisanayo ephanelini eseceleni.

Ukuze uthole imininingwane ye-SDK nezinkontileka zamanje zezandiso, bheka umhlahlandlela wamakhono kanye nemibhalo yababambiqhaza yephrojekthi. Lawa ma-API ayahlolwa, ngakho cabangela izinguquko ezingaba khona lapho wakha isandiso.

Ukuhamba Komsebenzi Wokuthuthukisa

Lungisa indawo yokuhlola yephrojekthi ngokulandela imibhalo yemiyalo nezinketho zokwakha. Imiyalo eyinhloko yokuthuthukisa yile:

npm run dev       # Yakha kabusha lapho umthombo ushintsha
npm test          # Qalisa amasethi okuhlola ajwayelekile
npm run verify    # Hlola izinhlobo bese uqalisa amasethi azenzakalelayo anekhava

Ngemva kokwakha kabusha, layisha kabusha isandiso ku-chrome://extensions bese uvula kabusha iphaneli eseceleni ye-qz. Lokhu kuqinisekisa ukuthi i-Chrome isebenzisa amafayela akamuva akhiqiziwe esandiso.

Amathiphu Okusebenzisa Okuthuthukile

• Sebenzisa iziqondiso ezihlelekile: chaza amakhasi okuqondiswe kuwo, izinkambu okufanele ziqoqwe, kanye nefomethi yomphumela oyifunayo ukuze idatha ekhishiwe ihlelwe ibe iqoqo eliwusizo.
• Khetha imodi efanele yokusebenzisana: ukusebenzisana okusekelwe ku-DOM kuwusizo ezintweni zamakhasi namafomu, kanti ukusebenzisana okusekelwe ezithombeni-skrini kungasiza lapho umongo obonakalayo ubalulekile.
• Hlukanisa ukuhamba komsebenzi okuphindaphindwayo: guqula imiyalo nemibhalo ephindaphindwayo ibe ama-Skill esikhundleni sokuyiphinda kuzo zonke iziqondiso.
• Sebenzisa umsebenzi ohambisanayo ngokucophelela: nikeza abanye imisebenzi yocwaningo ezimele ukuthi yenziwe ngesikhathi esisodwa, bese ubuyekeza imiphumela ehlanganisiwe kuphaneli eseceleni.
• Khetha izinsizakalo zasendaweni lapho kufanele khona: i-qz isekela amaseva amamodeli asendaweni, angasiza ukugcina ithrafikhi yamamodeli ngaphakathi kwengqalasizinda oyilawulayo.
• Buyekeza ukuxhumana kwedatha: okuqukethwe kwamakhasi, amafayela, ama-Skill, nokuhlanganiswa kwe-MCP kungafakwa ezicelweni noma kushintshanwe nezinsizakalo ezilungiselelwe. Hlola izimvume ngaphambi kokuphatha imininingwane ebucayi.
• Layisha kabusha ngemva kwezinguquko zomthombo: ukwakha kabusha ngempumelelo akusivuseleli ngokuzenzakalelayo isandiso; silayishe kabusha ku-Chrome ngaphambi kokusihlola.

Ukuhlanganiswa Kwe-MCP Ongakukhetha

Ibhuloho lendawo le-MCP elingakhethwa linikeza ama-ejenti angaphandle amathuluzi esiphequluli nezilawuli zemisebenzi. Lisebenzise lapho udinga enye i-ejenti noma uhlelo lokusebenza oluhambisana ne-MCP ukuthi lulawule i-qz. Njengoba ukuxhumana kwe-MCP kungashintshanisa idatha nezinsizakalo ezilungiselelwe, buyekeza imibhalo yebhuloho nemithelela yokugeleza kwedatha ngaphambi kokulivula.

Isiphetho

i-qz-browser-agent ihlanganisa iphaneli eseceleni ye-Chrome, i-automation yesiphequluli eqhutshwa yimodeli, amaqoqo endawo ahlelekile, imisebenzi ehambisanayo, kanye nokwandiseka ngama-Skill ne-TypeScript. Faka inguqulo ekhishiwe ukuze uqale ngokushesha, lungisa umhlinzeki wemodeli ohambisanayo, bese uzama isiqondiso esigxile ekukhishweni kwedatha. Uma udinga ukuhamba komsebenzi okwenziwe ngokwezifiso noma ukuhlanganiswa, yakha kusuka emthonjeni bese wandisa iphrojekthi ngama-Skill, amakhono, noma ibhuloho le-MCP elingakhethwa.