Sebenzisa i-Chrome Relay Ukuze Ama-Agent Okubhala Ikhodi Alawule I-Chrome Yakho Ongene Kuyo

Yini i-Chrome Relay?

I-Chrome Relay ivumela ama-agent okubhala amakhodi asekelwayo ukuthi asebenzise amaphrofayela akho avamile e-Google Chrome emugqeni womyalo. Ama-agent angafinyelela amasayithi osuvele ungene kuwo ngenkathi esebenza kumathebhu angasebenzi angemuva, ngakho i-automation ayisusi ukugxila efasiteleni lakho lamanje.

Iphrojekthi isebenza ne-Claude Code, Codex, Cursor, ne-Paseo. Ixhuma imiyalo yesiphequluli yazo ku-Chrome nge-agent-browser. Imiyalo ivamise ukuqedwa cishe ngemizuzwana engu-0.15, futhi i-Chrome ayidingi imbobo yokulungisa iphutha ukude.

I-Chrome Relay isebenza kuphela uma uyivulile. Ayifaki isandiso sayo ngokuzenzakalela, futhi isebenza kuphela kuma-Mac umnikazi wawo oqede ukusetha.

Isebenza Kanjani i-Chrome Relay

agent-browser CLI → local relay → Chrome Relay extension → agent tab

Uhlelo lunezingxenye ezintathu eziyinhloko:

• Isandiso se-Chrome: Isandiso se-Manifest V3 esingapakishiwe esilayishwa ngokuhlukile kuphrofayela ngayinye ye-Chrome ofuna ama-agent ayisebenzise. Sivula amathebhu ama-agent eqenjini lamathebhu Agents elingasebenzi neligoqiwe, bese sithumela imiyalo ye-DevTools nge-chrome.debugger.
• I-local relay: I-LaunchAgent elalela ku-127.0.0.1:9333. Inikeza i-agent ngayinye i-endpoint yayo ye-DevTools futhi ikhawulela i-agent kumathebhu eyawavula.
• Ithuluzi lomugqa womyalo: Umyalo othi chrome-relay uphethe ukusetha, ama-URL okuxhuma, ubunikazi, izibuyekezo, ukuxilonga, amalogi, namarekhodi ohlolo.

I-relay ivimba imiyalo engavusa noma egxilise i-Chrome. I-Chrome isengabonisa umyalezo othi Chrome Relay started debugging this browser ngenkathi i-agent isebenza.

Izidingo

Ngaphambi kokufaka, qinisekisa ukuthi unalezi zinto:

• macOS
• Google Chrome
• Node.js 20 noma entsha
• agent-browser efakwe emhlabeni wonke

Faka i-agent-browser nge-npm:

npm i -g agent-browser

Faka i-Chrome Relay

1. Klona bese ulungiselela iphrojekthi

git clone https://github.com/aindeev/agent-chrome-relay
cd agent-chrome-relay
bin/chrome-relay setup

Umyalo wokusetha udala imfihlo yendawo, ulungiselela isevisi yangemuva, urekhoda ubunikazi, ubeka i-chrome-relay ku-PATH yakho, futhi uxhumanise ikhono le-Chrome Relay ne-Claude Code.

2. Layisha isandiso ku-Chrome

Phinda lezi zinyathelo kuphrofayela ngayinye ye-Chrome okufanele ama-agent akwazi ukuyisebenzisa:

1. Vula chrome://extensions.
2. Vula Developer mode.
3. Khetha Load unpacked.
4. Khetha ifolda ye-extension ekhoselweni lephrojekthi.

Ngenxa yokuthi iphrofayela ngayinye ye-Chrome ilayisha ikhophi yayo yesandiso, ungavumela kuphela amaphrofayela owakhethile ngokusobala.

3. Qinisekisa ukufakwa

chrome-relay doctor

Sebenzisa umphumela wokuxilonga ukuqinisekisa ukuthi i-relay nesandiso kulungiselelwe kahle ngaphambi kokucela i-agent ukuthi iphequlule.

Tshela I-agent Yakho Yokubhala Amakhodi Nge-Chrome Relay

Claude Code

Inqubo yokusetha ixhumanisa i-skill/SKILL.md ne-~/.claude/skills/chrome-relay. Lokhu kwenza ikhono litholakale kuwo wonke amakhosombe. I-CLAUDE.md esezingeni lekhosombe idinga kuphela isikhombi somugqa owodwa esiya kulelo khono lapho umyalo ocacile uwusizo.

Codex, Cursor, Namanye Ama-agent Asekelwayo

Khomba imiyalo yomhlaba wonke ye-agent efayeleni lekhono elifanayo. Isibonelo, engeza umyalo ofana nalo ku-~/.codex/AGENTS.md:

For any browser step that needs my logins, follow /path/to/agent-chrome-relay/skill/SKILL.md.

Faka esikhundleni sendlela yesibonelo indlela ephelele eya ekhosombeni lakho elikloniwe.

Qalisa I-automation Yakho Yokuqala Yesiphequluli

Qala ngokucela i-Chrome Relay i-URL yokuxhuma eqinisekisiwe, bese udlulisela leyo URL ku-agent-browser:

agent-browser --cdp "$(chrome-relay url you@company.com)" open https://app.example.com/
agent-browser snapshot -i
agent-browser click @e5
agent-browser close

Faka esikhundleni you@company.com ngobunikazi obulungiselelwe obufanele, bese ufaka esikhundleni sesayithi yesibonelo ikhasi ofuna ukulisebenzisa nge-automation.

1. chrome-relay url iphrinta i-URL yokuxhuma equkethe imfihlo yale Mac.
2. agent-browser open idala ithebhu engasebenzi ephethwe yi-agent bese ivula ikhasi eliceliwe.
3. snapshot -i ibala izilawuli ezisebenzisanayo ezifana nezixhumanisi, izinkinobho, nezinkambu. Ngasinye sithola ireferensi efana ne-@e5.
4. click @e5 ivula into ekhonjiwe isebenzisa ukulingisa kokufaka kwangempela kuthebhu engemuva.
5. close iphetha iseshini yesiphequluli.

Qonda Indlela Ukungena Okusebenza Ngayo

Ama-agent awathayiphi imininingwane yakho yokungena. Uma isayithi lidlulisela ku-Google futhi i-akhawunti efanele isivele ingenile, isandiso singakhetha leyo akhawunti bese sichofoza Continue noma Allow. Lokhu kusebenzisa imibhalo yekhasi futhi kungasebenza ngisho nalapho i-1Password ibeke ifreyimu ekhasini.

Uma inqubo ifika esikrinini sephasiwedi, se-passkey, sokuqinisekisa ngezinyathelo ezimbili, noma se-akhawunti ephumile, i-automation iyama. I-agent ithola umlayezo othi SIGN-IN NEEDED futhi kufanele ikucele ukuthi uqedele ukungena efasiteleni lakho.

Phatha Ubunikazi Bamaphrofayela Namasayithi

Ukulungiselelwa kobunikazi kugcinwa ku-~/.chrome-relay/identities.json. Kuhlole noma ukuphathе ngalo myalo:

chrome-relay identities

Ukucushwa kuhlanganisa amaphrofayela e-Chrome atholwe ngesikhathi sokusetha, i-sites.rules elungiselelwe ngesandla ngokuzithandela, kanye nokufakiwe kwe-sites.learned okuqoshwe ngemva kwezinyathelo zokungena eziphumelele. Ngokuzenzakalelayo, isayithi lisebenzisa i-akhawunti ehambisana nephrofayela ye-Chrome ekhethiwe.

Imodeli Yokuphepha

Konke ukuxhumana kwe-agent kufanele kudlule ekuhlolweni okubili:

1. Imfihlo yasendaweni: Ukusetha kudala ithokheni ku-~/.chrome-relay/token enemodi yefayela engu-600. Ithokheni ifakwa kuma-URL akhishwa yi-chrome-relay url.
2. Uhlelo lokusebenza lwe-agent oluvunyelwe: Inqubo exhumayo kufanele ihlotshaniswe ne-Claude Code, Codex, Cursor, noma Paseo. I-relay ihlola izinqubo kanye nezimpawu ezisethwa yilezi zinhlelo zokusebenza ezinqubweni ezingaphansi kwazo.

Ukuxhumana okuphethe unhlokweni we-browser Origin kuyaliwa noma ngabe kunemfihlo. Isandiso naso siyahlolwa kusetshenziswa i-ID yesandiso etholwe ku-Chrome, i-origin ethi chrome-extension://, kanye nemfuneko yokuthi inqubo exhumayo kube yi-Chrome.

Lezi zilawuli zigcina amathuluzi endawo angahlobene, amakhasi ewebhu, nokuxhumana okwenzeke ngephutha kungangeni. Azilona umngcele wokuphepha ovikela ku-malware esivele isebenza njengomsebenzisi wakho, ngoba leyo software ingafunda imfihlo bese ilingisa izimpawu zezinqubo.

Buyekeza Umkhondo Wokuhlolwa

I-Chrome Relay iqopha umsebenzi wama-agent kumafayela e-JSON Lines ansuku zonke ngaphansi kwe-~/.chrome-relay/audit/YYYY-MM-DD.jsonl. Funda amarekhodi ngale ndlela:

chrome-relay audit

Umkhondo wokuhlolwa uhlanganisa imininingwane yokuxhumana, ifolda yokusebenza, izihlonzi zeseshini, amakhasi avakashelwe, izindawo zokuchofoza, okhiye abakhethekile, imibhalo yama-agent, izithombe-skrini, okulayishiwe, ama-pop-up, ukuchofoza kokungena, namakhasi avinjiwe. Ukuze kuvikelwe ubumfihlo, umbhalo othayiphiwe umelelwa kuphela ngenani lezinhlamvu, futhi izintambo zemibuzo kuma-URL ziyasuswa.

Ukuziphatha Okuthuthukile Namathiphu

Ama-pop-up Namamathebhu Amasha

Izixhumanisi ezisebenzisa target=_blank kanye nama-pop-up zivuleka njengamathebhu afihliwe aphethwe yi-agent efanayo. Izinqubo zokuqinisekisa ngama-pop-up zisengathumela imilayezo koyivulile futhi zizivale. I-relay iphoqelela ama-origin abonwe emilayezweni kanye ne-targetOrigin kunokuthemba izimangalo zekhasi.

Amakhasi e-1Password

I-Chrome inganqamula i-debugger yesandiso lapho ikhasi liqukethe ifreyimu yesinye isandiso, njengemenyu ye-1Password efomini lokungena. I-Chrome Relay iyalinda bese ixhuma kabusha ngaphambi kokuqhubeka nemiyalo ye-agent.

Ukuhlanzwa Okuzenzakalelayo

Amathebhu ama-agent ayavalwa ngemva kwemizuzu engu-30 kungabikho msebenzi. Lapho i-relay iqala kabusha, isandiso siphinde sivale amathebhu esasike sawavula. Ukuhlanzwa kusekelwe kuma-ID wamathebhu, ngakho akuguquli amaqembu akho wamathebhu.

Okokufaka Kwasemuva

Ukulingisa ukugxila kuhlala kunikwe amandla kumathebhu ama-agent. Lokhu kuvumela ukuchofoza nokuthayipha ukuthi kufinyelele kumathebhu angasebenzi ngenkathi ithebhu yakho yamanje ye-Chrome iqhubeka isendaweni yayo.

Buyekeza, Hlola Futhi Ususe I-Chrome Relay

Ngemva kokudonsa izinguquko zenqolobane, qala kabusha i-relay bese ulayisha kabusha isandiso kuwo wonke amaphrofayela amisiwe:

git pull
chrome-relay update

Hlola amalogi e-relay ngale ndlela:

chrome-relay logs

Ifayela lelogi ligcinwe ku-~/.chrome-relay/relay.log. Ukuze ukhiphe isevisi yasendaweni nokusetha komugqa womyalo, sebenzisa:

chrome-relay uninstall

Bese ususa ngesandla isandiso esingapakishwanga kuphrofayela ngayinye ye-Chrome.

Ukuthuthukisa Nokuhlola

Ukuze ufake okuncikile kwe-relay futhi usebenzise iqoqo lokuhlola:

cd relay && npm install && npm test

Ukuhlola kuhlanganisa ukugunyazwa kokuxhumana, okuhlanganisa imfihlo, izinhlelo zokusebenza ezivunyelwe, ukuxhumana kwesandiso okusebenza nge-Chrome kuphela, kanye nokuziphatha kokuhlolwa. Ngemva kokuhlela amafayela angaphansi kwe-extension/, layisha kabusha isandiso ngale ndlela:

chrome-relay update

Ezimweni zangokwezifiso, i-CHROME_RELAY_HOME ishintsha umkhombandlela wedatha, kanti i-CHROME_RELAY_PORT ishintsha imbobo ye-relay.

Isiphetho

I-Chrome Relay inikeza ama-agent okwenza amakhodi asekelwayo ukufinyelela okulawulwayo kumaseshini e-Chrome akhona ngaphandle kokudinga imbobo yokulungisa kude noma ukuthatha iwindi lakho elisebenzayo. Uma i-relay yasendaweni nesandiso esingapakishwanga sekulungisiwe, ungazenzakalisa imisebenzi yesiphequluli egunyaziwe nge-agent-browser, ukhethe ubuwena ngephrofayela noma ngesayithi, uhlole amarekhodi anemininingwane okuhlolwa agcina ubumfihlo, futhi uthembele ekuhlanzweni okuzenzakalelayo kwamaseshini ashiywe.

Ukuze uthole ikhodi yomthombo, izibuyekezo, nokubika izinkinga, vakashela inqolobane ye-Chrome Relay ku-GitHub. Iphrojekthi itholakala ngaphansi kweLayisensi ye-MIT.