Tumia Chrome Relay Kuwaruhusu Mawakala wa Usimbaji Kudhibiti Chrome Yako Uliyoingia

Chrome Relay Ni Nini?

Chrome Relay huwezesha mawakala wa programu wanaotumika na mfumo kutumia wasifu wako wa kawaida wa Google Chrome kupitia mstari wa amri. Mawakala wanaweza kufikia tovuti ambazo tayari umeingia, huku wakifanya kazi kupitia vichupo vya chinichini visivyotumika, hivyo otomatiki haiathiri dirisha lako la sasa.

Mradi huu hufanya kazi na Claude Code, Codex, Cursor na Paseo. Huunganisha amri zao za kivinjari na Chrome kupitia agent-browser. Kwa kawaida amri hukamilika kwa takriban sekunde 0.15, na Chrome haihitaji mlango wa utatuzi wa mbali.

Chrome Relay ni ya hiari. Haiweki kiendelezi chake kiotomatiki, na huendeshwa tu kwenye Mac ambazo mmiliki wake amekamilisha usanidi.

Jinsi Chrome Relay Inavyofanya Kazi

agent-browser CLI → relay ya ndani → kiendelezi cha Chrome Relay → kichupo cha wakala

Mfumo huu una vipengele vitatu vikuu:

• Kiendelezi cha Chrome: Kiendelezi cha Manifest V3 kisichofungashwa, kinachopakiwa kando katika kila wasifu wa Chrome unaotaka mawakala watumie. Hufungua vichupo vya mawakala katika kikundi cha vichupo Agents kisichotumika na kilichokunjwa, na hutuma amri za DevTools kupitia chrome.debugger.
• Relay ya ndani: LaunchAgent inayosikiliza kwenye 127.0.0.1:9333. Humpa kila wakala kituo tofauti cha DevTools na humzuia wakala kufikia vichupo ambavyo hakuvifungua.
• Zana ya mstari wa amri: Amri ya chrome-relay hushughulikia usanidi, URL za muunganisho, vitambulisho, masasisho, uchunguzi, kumbukumbu na rekodi za ukaguzi.

Relay huzuia amri zinazoweza kuleta au kuangazia Chrome. Chrome bado inaweza kuonyesha ujumbe Chrome Relay started debugging this browser wakati wakala anafanya kazi.

Mahitaji

Kabla ya usakinishaji, hakikisha una:

• macOS
• Google Chrome
• Node.js 20 au toleo jipya zaidi
• agent-browser iliyosakinishwa kimataifa

Sakinisha agent-browser kwa npm:

npm i -g agent-browser

Sakinisha Chrome Relay

1. Nakili na usanidi mradi

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

Amri ya usanidi huunda siri ya ndani, husanidi huduma ya chinichini, huhifadhi vitambulisho, huweka chrome-relay kwenye PATH yako, na huunganisha ujuzi wa Chrome Relay kwa Claude Code.

2. Pakia kiendelezi kwenye Chrome

Rudia hatua hizi katika kila wasifu wa Chrome ambao mawakala wanapaswa kuweza kutumia:

1. Fungua chrome://extensions.
2. Washa Developer mode.
3. Chagua Load unpacked.
4. Chagua folda ya extension ya hazina.

Kwa kuwa kila wasifu wa Chrome hupakia nakala yake ya kiendelezi, unaweza kuwezesha tu wasifu unaouchagua waziwazi.

3. Thibitisha usakinishaji

chrome-relay doctor

Tumia matokeo ya uchunguzi kuthibitisha kuwa relay na kiendelezi vimesanidiwa ipasavyo kabla ya kumwomba wakala kuvinjari.

Mjulishe Wakala Wako wa Programu Kuhusu Chrome Relay

Claude Code

Mchakato wa usanidi huunganisha skill/SKILL.md na ~/.claude/skills/chrome-relay. Hii hufanya ujuzi huo upatikane katika hazina zote. CLAUDE.md ya kiwango cha hazina inahitaji tu kiashiria cha mstari mmoja kuelekea ujuzi huo pale maagizo ya wazi yanapohitajika.

Codex, Cursor na Mawakala Wengine Wanaotumika

Elekeza maagizo ya kimataifa ya wakala kwenye faili hiyo hiyo ya ujuzi. Kwa mfano, ongeza maagizo kama haya kwenye ~/.codex/AGENTS.md:

Kwa hatua yoyote ya kivinjari inayohitaji kuingia kwangu, fuata /path/to/agent-chrome-relay/skill/SKILL.md.

Badilisha njia ya mfano kwa njia kamili ya hazina yako uliyoinakili.

Tekeleza Otomatiki Yako ya Kwanza ya Kivinjari

Kwanza iombe Chrome Relay URL ya muunganisho ulioidhinishwa, kisha ipitishe URL hiyo kwa 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

Badilisha you@company.com kwa kitambulisho husika kilichosanidiwa, na ubadilishe tovuti ya mfano kwa ukurasa unaotaka kuufanyia otomatiki.

1. chrome-relay url huchapisha URL ya muunganisho iliyo na siri ya Mac hii.
2. agent-browser open huunda kichupo kisichotumika kinachomilikiwa na wakala na kufungua ukurasa ulioombwa.
3. snapshot -i huorodhesha vidhibiti shirikishi kama vile viungo, vitufe na sehemu za kujaza. Kila kimoja hupokea rejeleo kama @e5.
4. click @e5 huamilisha kipengele kilichorejelewa kwa kutumia uigaji halisi wa ingizo katika kichupo cha chinichini.
5. close humaliza kipindi cha kivinjari.

Elewa Tabia ya Kuingia

Mawakala hawaandiki vitambulisho vyako. Tovuti ikielekeza kupitia Google na akaunti sahihi ikiwa tayari imeingia, kiendelezi kinaweza kuchagua akaunti hiyo na kubofya Continue au Allow. Hii hutumia uandishi wa ukurasa na inaweza kufanya kazi hata wakati 1Password imeweka fremu kwenye ukurasa.

Mchakato ukifika kwenye skrini ya nenosiri, passkey, uthibitishaji wa hatua mbili au akaunti iliyotoka, otomatiki husimama. Wakala hupokea ujumbe wa SIGN-IN NEEDED na anapaswa kukuomba ukamilishe kuingia kwenye dirisha lako.

Dhibiti Vitambulisho vya Wasifu na Tovuti

Usanidi wa vitambulisho huhifadhiwa katika ~/.chrome-relay/identities.json. Ukague au uusimamie kwa:

chrome-relay identities

Usanidi unajumuisha profaili za Chrome zilizogunduliwa wakati wa usanidi, sites.rules zilizosanidiwa kwa hiari mwenyewe, na maingizo ya sites.learned yaliyorekodiwa baada ya hatua za kuingia zilizofaulu. Kwa chaguo-msingi, tovuti hutumia akaunti inayohusiana na profaili ya Chrome iliyochaguliwa.

Muundo wa Usalama

Kila muunganisho wa wakala lazima upite ukaguzi mbili:

1. Siri ya ndani: Usanidi hutengeneza tokeni katika ~/.chrome-relay/token yenye hali ya faili 600. Tokeni hujumuishwa katika URL zinazoonyeshwa na chrome-relay url.
2. Programu ya wakala iliyoruhusiwa: Mchakato unaounganisha lazima uhusishwe na Claude Code, Codex, Cursor, au Paseo. Relay hukagua michakato na alama ambazo programu hizi huweka katika michakato tanzu.

Miunganisho yenye kichwa cha kivinjari cha Origin hukataliwa hata ikiwa ina siri hiyo. Kiendelezi pia hukaguliwa kwa kutumia kitambulisho chake cha kiendelezi kilichotokana na Chrome, asili yake ya chrome-extension://, na sharti kwamba mchakato unaounganisha uwe Chrome.

Vidhibiti hivi huzuia zana za ndani zisizohusiana, kurasa za wavuti, na miunganisho ya bahati mbaya. Si mpaka wa usalama dhidi ya programu hasidi ambayo tayari inaendeshwa kama mtumiaji wako, kwa sababu programu kama hiyo inaweza kusoma siri na kuiga alama za michakato.

Kagua Rekodi ya Ukaguzi

Chrome Relay hurekodi shughuli za wakala katika faili za kila siku za JSON Lines zilizo chini ya ~/.chrome-relay/audit/YYYY-MM-DD.jsonl. Soma rekodi hizo kwa:

chrome-relay audit

Rekodi ya ukaguzi inajumuisha maelezo ya muunganisho, folda ya kazi, vitambulishi vya vipindi, kurasa zilizotembelewa, nafasi za kubofya, vitufe maalum, hati za wakala, picha za skrini, upakiaji, madirisha ibukizi, mibofyo ya kuingia, na kurasa zilizozuiwa. Kwa faragha, maandishi yaliyoandikwa huwakilishwa tu na idadi ya herufi zake, na mifuatano ya hoja za URL huondolewa.

Tabia za Kina na Vidokezo

Madirisha Ibukizi na Vichupo Vipya

Viungo vinavyotumia target=_blank na madirisha ibukizi hufunguka kama vichupo vilivyofichwa vinavyomilikiwa na wakala huyo huyo. Mitiririko ya uthibitishaji ya madirisha ibukizi bado inaweza kutuma ujumbe kwa kilichofungua na kujifunga yenyewe. Relay hutekeleza asili za ujumbe zilizotazamwa na targetOrigin badala ya kuamini madai ya ukurasa.

Kurasa za 1Password

Chrome inaweza kutenganisha kitatuzi cha kiendelezi ukurasa unapokuwa na fremu ya kiendelezi kingine, kama vile menyu ya 1Password kwenye fomu ya kuingia. Chrome Relay husubiri na kuunganisha tena kabla ya kuendelea na amri za wakala.

Usafishaji wa Kiotomatiki

Vichupo vya wakala hufungwa baada ya dakika 30 za kutotumika. Relay inapowashwa upya, kiendelezi pia hufunga vichupo vilivyofunguliwa hapo awali. Usafishaji unatokana na vitambulisho vya vichupo, kwa hivyo haubadilishi vikundi vyako vya vichupo.

Ingizo la Mandharinyuma

Uigaji wa kulenga unabaki umewezeshwa katika vichupo vya wakala. Hii huruhusu mibofyo na uandishi kufikia vichupo visivyotumika huku kichupo chako cha sasa cha Chrome kikibaki mahali pake.

Sasisha, Tambua Matatizo, na Ondoa Chrome Relay

Baada ya kuvuta mabadiliko ya hazina, anzisha upya relay na upakie upya kiendelezi katika kila profaili iliyosanidiwa:

git pull
chrome-relay update

Angalia kumbukumbu za relay kwa:

chrome-relay logs

Faili la kumbukumbu limehifadhiwa katika ~/.chrome-relay/relay.log. Ili kuondoa huduma ya ndani na usanidi wa mstari wa amri, endesha:

chrome-relay uninstall

Kisha ondoa mwenyewe kiendelezi kilichofunguliwa kutoka kila profaili ya Chrome.

Uundaji na Majaribio

Ili kusakinisha vitegemezi vya relay na kuendesha mkusanyiko wa majaribio:

cd relay && npm install && npm test

Majaribio yanahusu uidhinishaji wa miunganisho, ikiwemo siri, programu zinazoruhusiwa, muunganisho wa kiendelezi wa Chrome pekee, na tabia ya ukaguzi. Baada ya kuhariri faili zilizo chini ya extension/, pakia upya kiendelezi kwa:

chrome-relay update

Kwa mazingira maalum, CHROME_RELAY_HOME hubatilisha saraka ya data na CHROME_RELAY_PORT hubatilisha mlango wa relay.

Hitimisho

Chrome Relay huwapa mawakala wa usimbaji wanaoungwa mkono ufikiaji unaodhibitiwa wa vipindi vilivyopo vya Chrome bila kuhitaji mlango wa utatuzi wa mbali au kuchukua udhibiti wa dirisha lako linalotumika. Baada ya relay ya ndani na kiendelezi kilichofunguliwa kusanidiwa, unaweza kuendesha kiotomatiki kazi za kivinjari zilizoidhinishwa kwa agent-browser, kuchagua utambulisho kwa kila profaili au tovuti, kukagua rekodi za kina za ukaguzi zinazolinda faragha, na kutegemea usafishaji wa kiotomatiki kwa vipindi vilivyoachwa.

Kwa msimbo wa chanzo, masasisho, na kuripoti masuala, tembelea hazina ya Chrome Relay kwenye GitHub. Mradi unapatikana chini ya Leseni ya MIT.