Kurulum
Bir ortam için arcy.js'i kurun, trafiğin geldiğini doğrulayın, kurulumu kodlama ajanınıza devredin ve npm ile yapılan kurulumu güncel tutun.
Ayarlar > Kurulum, adresteki ortam için kurulum kodunu o ortamın yayınlanabilir anahtarı yerleştirilmiş olarak üretir.
Başlamadan önce
- Sayfa, kullanıcı menüsünün Ortam satırını izler. Öteki ortam için oradan geçin.
- Development ortamı her adresten yanıt verir. Production yalnızca Domainler sayfasında doğrulanmış bir domainin altındaki sitelerde yanıt verir. DNS kaydının yayılması saatler sürebilir; domaini erken ekleyin.
- Sohbet, gizlilik ve çerez politikalarınıza bağlantı verir ve bir şey saklamadan önce ziyaretçiden onay ister. İkisi de Yasal sayfasında ayarlanır.
Kurulum
Kurulum adımları üç adım tutar:
- arcy.js'i ekleyin. Önce çatınızı, sonra kullanıcıları nasıl oturum açtırdığınızı seçin.
Bu adımdan sonrası, ikisi de seçildiğinde görünür. Sayfa, seçtiğiniz ikiliyi bu yazılım ürünü için tarayıcınızda
hatırlar. Kodun kendisi ile
init()veidentify()çağrılarının ne yaptığı Hızlı başlangıç sayfasındadır. - Yer tutucuları değiştirin. Bu adım yalnızca seçtiğiniz kodda yer tutucu varsa görünür. Her yer tutucunun anlamı Hızlı başlangıç sayfasındadır.
- Kurulumu doğrulayın. Kontrol, bu ortamın yayınlanabilir anahtarını taşıyan bir oturum bekler. İki dakika sonra Tekrar kontrol et düğmesini bekler.
Kodlama ajanınıza verin, ARCY MCP sayfasındaki ARCY'yi uçtan uca kurun maddesini açar. Kodlama ajanınız orada önce arcy.js'i, sonra diğer her yüzeyi kurar.
Geliştiricinize sorun düğmesi, onun yanında, yerine gönderebileceğiniz bir bağlantı verir (ARCY MCP).
arcy.js'i güncel tutun
HTML dışındaki her çatıda 1. adım arcy.js'i güncel tutun bloğuyla biter. Blokta
güncelleme komutu yer alır, örneğin npm install arcy.js@latest (npm update eski sürüm
aralığında kalır). Yanındaki iki dosya her sürüm için bir pull request açar ve
kontrolleriniz geçince onu birleştirir. Bloğun dört düğmesi bunların tamamını tek bir
görev olarak kopyalar; görevi deponuzda Claude Code, Cursor, Codex veya Antigravity
çalıştırır.
version: 2
updates:
- package-ecosystem: "npm"
directory: "/"
target-branch: "main"
schedule:
interval: "daily"
cooldown:
default-days: 2
allow:
- dependency-name: "arcy.js"# Merges Dependabot's arcy.js pull requests once your required checks pass.
name: arcy.js auto-merge
on: pull_request
jobs:
auto-merge:
if: github.event.pull_request.user.login == 'dependabot[bot]'
runs-on: ubuntu-latest
permissions:
contents: write
pull-requests: write
steps:
- id: metadata
# Pinned by digest: a tag can be moved, and this step holds a token
# that can write to your repository.
uses: dependabot/fetch-metadata@21025c705c08248db411dc16f3619e6b5f9ea21a # v2.5.0
with:
github-token: "${{ secrets.GITHUB_TOKEN }}"
# A patch only. A minor can carry a change your own code must make,
# which the Update arcy.js prompt applies; merging it here would skip
# that step and leave the change unmade.
- if: steps.metadata.outputs.dependency-names == 'arcy.js' && steps.metadata.outputs.update-type == 'version-update:semver-patch'
run: gh pr merge --auto --squash "$PR_URL"
env:
PR_URL: ${{ github.event.pull_request.html_url }}
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}Varsayılan dalınızın adını target-branch satırına yazın; var olmayan bir dal botu
durdurur. Bu satır, allow listesinin güvenlik güncellemelerinizi arcy.js ile
sınırlamasını da önler. Deponuzda zaten bir dependabot.yml varsa girdiyi onun updates
listesine ekleyin, dosyanın yerine yenisini yazmayın. bun kullanıyorsanız npm yerine
bun yazın; Dependabot yalnızca bun.lock dosyasını okur.
İş akışını, varsayılan dalınız bir kontrolü zorunlu kıldıktan sonra ekleyin; yoksa pull request açıldığı anda birleşir. Ardından deponuzun ayarlarında Allow auto-merge seçeneğini açın. Kendi kendine yalnızca yama sürümleri birleşir; bir ara sürüm sizden kendi kodunuzda bir değişiklik isteyebildiği için bekler.
Neyi değiştirir
Doğrulama bir tıklamayı değil, gelen oturumu okur. npm ile yapılan bir kurulumda arcy.js'i güncel tutun bloğu adımların altında açık kalır; her ortamın hangi sürümü çalıştırdığı ve yeni sürümlerin neyi değiştirdiği Güncellemeler sayfasındadır.
Sorun çıktığında
Doğrulama kontrolü sorunu adıyla söyler:
- Bu ortamdan trafik yok: arcy.js yüklensin diye sitenizi başka bir sekmede açın. Kontrol son yarım saati okur; bu ortamda daha önce trafik olduysa onun yerine en son ne zaman görüldüğünü yazar, yani kurulum çalışıyor ve şu an sitede kimse yok.
- ARCY'ye ulaşılamadı: bağlantınızı ve bu yazılım ürününü görüntüleme yetkiniz olduğunu kontrol edip yeniden deneyin.
- Oturumları başka bir ortam alıyor: canlıdaki kod o ortamın yayınlanabilir anahtarını taşıyor. Sayfayı o ortama geçirin ya da kodunuzdaki yayınlanabilir anahtarı değiştirin.
- Bir siteden gelen istekler reddediliyor: site doğrulanmış bir domainin altında değil. Sitenin domainini Domainler sayfasında doğrulayın.
- Kimlik doğrulama başarısız oluyor: yanlış imzayla gelen oturumlar anonim olarak devam eder. Sunucunuzun ürettiği imzayı Kimlik doğrulama sayfasına göre kontrol edin.
- Bilinmeyen öznitelikler: kontrolün listelediklerini Öznitelikler sayfasında tanımlayın.
- Şimdiye kadar yalnızca localhost trafiği var: kurulum çalışıyor; doğrulanmış bir production domaininden henüz oturum gelmedi.
Ayrıca bakın
Kuruluşlar
B2B hesaplarınızın organization_id ile doğru gruplandığını denetleyin, hesaplara ad verin ve bir hesabın üyeleri arasındaki en zorlu oturumu bulun.
Kişiye iletme
ARCY'nin çalıştığı her aracı bulun, sayfanızın gönderdiği analitik olaylarını dinletin, aktarmanın düşeceği yardım masasını ya da e-posta adresini bağlayın.