Kod yozuvchi agentlarga tizimga kirilgan Chrome brauzeringizni boshqarish uchun Chrome Relay’dan foydalaning

Chrome Relay nima?

Chrome Relay qo‘llab-quvvatlanadigan kodlash agentlariga buyruqlar qatoridan kundalik Google Chrome profillaringizdan foydalanish imkonini beradi. Agentlar siz allaqachon tizimga kirgan saytlarga kira oladi va buni faol bo‘lmagan fon tablarida amalga oshiradi, shu sababli avtomatlashtirish joriy oynangiz fokusini olib qo‘ymaydi.

Loyiha Claude Code, Codex, Cursor va Paseo bilan ishlaydi. Ularning brauzer buyruqlarini agent-browser orqali Chrome’ga ulaydi. Buyruqlar odatda taxminan 0.15 soniyada bajariladi va Chrome’ga masofaviy nosozliklarni tuzatish porti kerak bo‘lmaydi.

Chrome Relay ixtiyoriy tarzda yoqiladi. U kengaytmasini avtomatik o‘rnatmaydi va faqat egasi sozlashni yakunlagan Mac kompyuterlarida ishlaydi.

Chrome Relay qanday ishlaydi

agent-browser CLI → mahalliy relay → Chrome Relay kengaytmasi → agent tabi

Tizim uchta asosiy komponentdan iborat:

• Chrome kengaytmasi: Agentlar foydalanishi kerak bo‘lgan har bir Chrome profiliga alohida yuklanadigan, ochilmagan Manifest V3 kengaytmasi. U agent tablarini faol bo‘lmagan, yig‘ilgan Agents tablar guruhida ochadi va DevTools buyruqlarini chrome.debugger orqali yuboradi.
• Mahalliy relay: 127.0.0.1:9333 manzilida tinglaydigan LaunchAgent. U har bir agentga alohida DevTools endpointini beradi va agentni faqat o‘zi ochgan tablar bilan cheklaydi.
• Buyruqlar qatori vositasi: chrome-relay buyrug‘i sozlash, ulanish URL’lari, identifikatorlar, yangilanishlar, diagnostika, jurnallar va audit yozuvlarini boshqaradi.

Relay Chrome’ni ko‘tarishi yoki fokuslashi mumkin bo‘lgan buyruqlarni bloklaydi. Agent ishlayotganida Chrome’da Chrome Relay started debugging this browser xabari hali ham ko‘rinishi mumkin.

Talablar

O‘rnatishdan oldin quyidagilar mavjudligiga ishonch hosil qiling:

• macOS
• Google Chrome
• Node.js 20 yoki undan yangi versiyasi
• agent-browser global tarzda o‘rnatilgan

agent-browser’ni npm orqali o‘rnating:

npm i -g agent-browser

Chrome Relay’ni o‘rnatish

1. Loyihani klonlash va sozlash

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

Sozlash buyrug‘i mahalliy maxfiy kalitni yaratadi, fon xizmatini sozlaydi, identifikatorlarni qayd etadi, chrome-relay buyrug‘ini PATH’ga qo‘shadi va Claude Code uchun Chrome Relay ko‘nikmasini ulaydi.

2. Kengaytmani Chrome’ga yuklash

Agentlar foydalanishi kerak bo‘lgan har bir Chrome profilida quyidagi qadamlarni takrorlang:

1. chrome://extensions manzilini oching.
2. Developer mode rejimini yoqing.
3. Load unpacked bandini tanlang.
4. Repository’ning extension jildini tanlang.

Har bir Chrome profili kengaytmaning o‘z nusxasini yuklagani uchun faqat o‘zingiz aniq tanlagan profillarni ochishingiz mumkin.

3. O‘rnatishni tekshirish

chrome-relay doctor

Agentdan brauzerda ishlashni so‘rashdan oldin relay va kengaytma to‘g‘ri sozlanganini tasdiqlash uchun diagnostika chiqishidan foydalaning.

Kodlash agentingizga Chrome Relay haqida ayting

Claude Code

Sozlash jarayoni skill/SKILL.md faylini ~/.claude/skills/chrome-relay manziliga ulaydi. Bu ko‘nikmani barcha repository’larda ishlatish imkonini beradi. Repository darajasidagi CLAUDE.md fayliga faqat aniq ko‘rsatma kerak bo‘lganda ushbu ko‘nikmaga bir qatorli havola qo‘shish kifoya.

Codex, Cursor va boshqa qo‘llab-quvvatlanadigan agentlar

Agentning global ko‘rsatmalarini xuddi shu ko‘nikma fayliga yo‘naltiring. Masalan, ~/.codex/AGENTS.md fayliga quyidagiga o‘xshash ko‘rsatma qo‘shing:

Login ma’lumotlarim kerak bo‘ladigan har qanday brauzer bosqichida /path/to/agent-chrome-relay/skill/SKILL.md fayliga amal qiling.

Misoldagi yo‘lni klonlangan repository’ning mutlaq yo‘li bilan almashtiring.

Birinchi brauzer avtomatlashtirishingizni ishga tushiring

Avval Chrome Relay’dan autentifikatsiyalangan ulanish URL’sini so‘rang, so‘ngra ushbu URL’ni agent-browser’ga uzating:

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

you@company.com o‘rniga tegishli sozlangan identifikatorni, misoldagi sayt o‘rniga esa avtomatlashtirmoqchi bo‘lgan sahifangizni kiriting.

1. chrome-relay url ushbu Mac maxfiy kalitini o‘z ichiga olgan ulanish URL’sini chiqaradi.
2. agent-browser open agentga tegishli faol bo‘lmagan tabni yaratadi va so‘ralgan sahifani ochadi.
3. snapshot -i havolalar, tugmalar va maydonlar kabi interaktiv boshqaruv elementlarini ro‘yxatlaydi. Har biriga @e5 kabi havola beriladi.
4. click @e5 fon tabida haqiqiy kiritish emulyatsiyasi yordamida ko‘rsatilgan elementni faollashtiradi.
5. close brauzer sessiyasini yakunlaydi.

Tizimga kirish xatti-harakatini tushuning

Agentlar hisob ma’lumotlaringizni kiritmaydi. Agar sayt Google orqali yo‘naltirsa va to‘g‘ri hisob allaqachon tizimga kirgan bo‘lsa, kengaytma ushbu hisobni tanlashi va Continue yoki Allow tugmasini bosishi mumkin. Bu sahifa skriptlaridan foydalanadi va 1Password sahifaga freym joylashtirgan bo‘lsa ham ishlashi mumkin.

Agar jarayon parol, passkey, ikki bosqichli tasdiqlash yoki tizimdan chiqilgan hisob sahifasiga yetib borsa, avtomatlashtirish to‘xtaydi. Agent SIGN-IN NEEDED xabarini oladi va sizdan tizimga kirishni o‘z oynangizda yakunlashingizni so‘rashi kerak.

Profil va sayt identifikatorlarini boshqarish

Identifikator sozlamalari ~/.chrome-relay/identities.json faylida saqlanadi. Uni quyidagi buyruq bilan ko‘ring yoki boshqaring:

chrome-relay identities

Konfiguratsiya sozlash vaqtida aniqlangan Chrome profillarini, ixtiyoriy ravishda qo‘lda sozlangan sites.rules yozuvlarini va muvaffaqiyatli tizimga kirish bosqichlaridan keyin qayd etilgan sites.learned yozuvlarini o‘z ichiga oladi. Odatiy holatda sayt tanlangan Chrome profiliga tegishli hisobdan foydalanadi.

Xavfsizlik modeli

Har bir agent ulanishi ikkita tekshiruvdan o‘tishi kerak:

1. Mahalliy maxfiy kalit: Sozlash ~/.chrome-relay/token manzilida 600 fayl rejimiga ega token yaratadi. Token chrome-relay url tomonidan chiqariladigan URL manzillarga joylashtiriladi.
2. Ruxsat etilgan agent ilovasi: Ulanayotgan jarayon Claude Code, Codex, Cursor yoki Paseo bilan bog‘langan bo‘lishi kerak. Relay jarayonlarni va ushbu ilovalar farzand jarayonlarda o‘rnatadigan belgilarni tekshiradi.

Brauzerning Origin sarlavhasini olib keladigan ulanishlar, hatto maxfiy kalitga ega bo‘lsa ham, rad etiladi. Kengaytma ham Chrome asosida yaratilgan kengaytma IDsi, uning chrome-extension:// manbasi va ulanish jarayoni Chrome bo‘lishi talabi orqali tekshiriladi.

Ushbu boshqaruvlar aloqasi bo‘lmagan mahalliy vositalar, veb-sahifalar va tasodifiy ulanishlarni chetda saqlaydi. Ular sizning foydalanuvchi hisobingiz nomidan allaqachon ishlayotgan zararli dasturlarga qarshi xavfsizlik chegarasi emas, chunki bunday dastur maxfiy kalitni o‘qib, jarayon belgilariga taqlid qilishi mumkin.

Audit izini ko‘rib chiqing

Chrome Relay agent faoliyatini ~/.chrome-relay/audit/YYYY-MM-DD.jsonl manzilidagi kunlik JSON Lines fayllarida qayd etadi. Yozuvlarni quyidagi buyruq bilan o‘qing:

chrome-relay audit

Audit izi ulanish tafsilotlari, ishchi jild, sessiya identifikatorlari, kirilgan sahifalar, bosish koordinatalari, maxsus tugmalar, agent skriptlari, skrinshotlar, yuklamalar, qalqib chiquvchi oynalar, tizimga kirish bosishlari va bloklangan sahifalarni o‘z ichiga oladi. Maxfiylikni ta’minlash uchun kiritilgan matn faqat uning belgilar soni bilan ifodalanadi, URL so‘rov satrlari esa olib tashlanadi.

Kengaytirilgan xususiyatlar va maslahatlar

Qalqib chiquvchi oynalar va yangi varaqlar

target=_blank atributidan foydalanadigan havolalar va qalqib chiquvchi oynalar shu agentga tegishli yashirin varaqlar sifatida ochiladi. Qalqib chiquvchi autentifikatsiya jarayonlari hali ham ochuvchi oynaga xabar yuborishi va o‘zini yopishi mumkin. Relay sahifaning da’volariga ishonish o‘rniga kuzatilgan xabar manbalari va targetOriginni majburiy tekshiradi.

1Password sahifalari

Sahifada boshqa kengaytmaning freymi, masalan, kirish shaklidagi 1Password menyusi mavjud bo‘lsa, Chrome kengaytma nosozliklarni tuzatish vositasini uzib qo‘yishi mumkin. Chrome Relay agent buyruqlarini davom ettirishdan oldin kutadi va qayta ulanadi.

Avtomatik tozalash

Agent varaqlari 30 daqiqa davomida faoliyat bo‘lmagach yopiladi. Relay qayta ishga tushirilganda, kengaytma avval ochgan varaqlarini ham yopadi. Tozalash varaqlar IDlari asosida amalga oshiriladi, shuning uchun o‘zingiz yaratgan varaqlar guruhlariga o‘zgartirish kiritilmaydi.

Fonda kiritish

Agent varaqlarida fokus emulyatsiyasi yoqilgan holda qoladi. Bu joriy Chrome varag‘ingiz o‘z joyida turgan paytda bosishlar va kiritishlar faol bo‘lmagan varaqlarga yetib borishiga imkon beradi.

Chrome Relay’ni yangilang, tashxislang va olib tashlang

Repozitoriydagi o‘zgarishlarni yuklab olgandan so‘ng, relay’ni qayta ishga tushiring va har bir sozlangan profilda kengaytmani qayta yuklang:

git pull
chrome-relay update

Relay jurnallarini quyidagi buyruq bilan ko‘ring:

chrome-relay logs

Jurnal fayli ~/.chrome-relay/relay.log manzilida saqlanadi. Mahalliy xizmat va buyruq satri sozlamalarini olib tashlash uchun quyidagini bajaring:

chrome-relay uninstall

Keyin ochilgan kengaytmani har bir Chrome profilidan qo‘lda olib tashlang.

Ishlab chiqish va testlash

Relay bog‘liqliklarini o‘rnatish va testlar to‘plamini ishga tushirish uchun:

cd relay && npm install && npm test

Testlar ulanishni avtorizatsiya qilishni, jumladan maxfiy kalitni, ruxsat etilgan ilovalarni, faqat Chrome orqali kengaytmaga ulanishni va audit xatti-harakatlarini tekshiradi. extension/ ichidagi fayllarni tahrirlagandan so‘ng, kengaytmani quyidagi buyruq bilan qayta yuklang:

chrome-relay update

Maxsus muhitlar uchun CHROME_RELAY_HOME ma’lumotlar katalogini, CHROME_RELAY_PORT esa relay portini almashtiradi.

Xulosa

Chrome Relay qo‘llab-quvvatlanadigan kodlash agentlariga masofadan nosozliklarni tuzatish portini talab qilmasdan yoki faol oynangizni egallamasdan mavjud Chrome sessiyalariga boshqariladigan kirish imkonini beradi. Mahalliy relay va ochilgan kengaytma sozlangach, agent-browser yordamida autentifikatsiyadan o‘tgan brauzer vazifalarini avtomatlashtirishingiz, har bir profil yoki sayt uchun alohida identifikatorlarni tanlashingiz, maxfiylikni hisobga olgan batafsil audit yozuvlarini tekshirishingiz va tashlab ketilgan sessiyalar avtomatik tozalanishiga ishonishingiz mumkin.

Manba kodi, yangilanishlar va muammolar haqida xabar berish uchun Chrome Relay GitHub repozitoriyiga tashrif buyuring. Loyiha MIT litsenziyasi asosida taqdim etilgan.