--- read_when: - Testleri çalıştırma veya düzeltme summary: Testleri yerel olarak çalıştırma (vitest) ve force/coverage modlarını ne zaman kullanma title: Testler x-i18n: generated_at: "2026-07-12T12:14:27Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: 63806ea72da1579f4aa0b92c14a6d2d3e67990d6c10cb6d9b1b2bb4a63c8e140 source_path: reference/test.md workflow: 16 --- - Eksiksiz test seti (paketler, canlı, Docker): [Test](/tr/help/testing) - Güncelleme ve Plugin paketi doğrulaması: [Güncellemeleri ve Plugin'leri test etme](/tr/help/testing-updates-plugins) ## Agent varsayılanı Agent oturumları, testleri ve hesaplama açısından yoğun doğrulamaları Crabbox aracılığıyla uzaktan çalıştırır. Güvenilir bakım sorumlusu kodunda varsayılan olarak Blacksmith Testbox kullanılır. Yapılandırılmış Testbox iş akışı kimlik bilgilerini yüklediğinden, güvenilmeyen katkıcı veya çatallanmış depo kodu bunun yerine gizli bilgi içermeyen çatallanmış depo CI'ını ya da arındırılmış doğrudan AWS Crabbox'ı kullanmalıdır. Güvenilir bir kod görevinin testlere veya kapsamlı kanıta ihtiyaç duyması olasıysa, arka plandaki bir komut oturumunda hemen ön ısıtma başlatın, yükleme sürerken çalışmaya devam edin, döndürülen `tbx_...` kimliğini yeniden kullanın, her çalıştırmada mevcut çalışma kopyasını eşitleyin ve devretmeden önce durdurun: ```bash node scripts/crabbox-wrapper.mjs warmup --provider blacksmith-testbox --keep --timing-json ``` İlk başarılı yeniden kullanımdan sonra sarmalayıcı, kiralamanın temelini, bağımlılık ve Testbox iş akışı parmak izini `.crabbox/testbox-leases/` altında kaydeder. Yalnızca kaynak kodu düzenlemeleri, önceden ısıtılmış kutuyu yeniden kullanmaya devam eder. Birleştirme tabanı, kilit dosyası, paket yöneticisi girdisi, sarmalayıcı veya Testbox iş akışı değişirse işlem güvenli biçimde başarısız olur ve yeni bir kiralama gerekir. Her çalıştırma yine de mevcut çalışma kopyasını eşitler. `OPENCLAW_TESTBOX_ALLOW_STALE=1` yalnızca kasıtlı tanılama içindir, sürüm kanıtı için değildir. Aşağıdaki yerel test komutları, insan iş akışları veya kullanıcının açıkça istediği bir Agent geri dönüşü içindir. Uzak sağlayıcının kullanılamadığı bildirilmelidir; bu durum kapsamlı bir yerel geçidin sessizce çalıştırılmasına izin vermez. Güvenilmeyen kod için `--provider aws` ile ön ısıtma yapın. Her çalıştırmada `CRABBOX_ENV_ALLOW=CI` ayarlanmalı, `--provider aws --no-hydrate` geçirilmeli ve bağımlılıklar yüklenmeden ya da testler çalıştırılmadan önce yeni bir geçici uzak `HOME` kullanılmalıdır. Bu güvenilmeyen kaynağa ayrılmış, yeni ısıtılmış bir kiralama kullanın; güvenilir veya daha önce kimlik bilgileri yüklenmiş bir kiralamayı asla yeniden kullanmayın. Temiz ve güvenilir bir `main` çalışma kopyasından kurulu güvenilir bir Crabbox ikili dosyası başlatın ve yalnızca uzak PR'ı `--fresh-pr` ile getirin; güvenilmeyen çalışma kopyasının sarmalayıcısını veya yapılandırmasını asla yerel olarak çalıştırmayın. `CRABBOX_AWS_INSTANCE_PROFILE` ayarını kaldırın ve çözümlenen `aws.instanceProfile` boş değilse güvenli biçimde başarısız olun. Herhangi bir kurulum/test öncesinde, güvenilir mutlak yollu araçlarla bir IMDSv2 belirteci zorunlu tutun, IAM kimlik bilgileri uç noktasının 404 döndürdüğünü kanıtlayın ve uzaktaki `git rev-parse HEAD` değerinin incelenen PR başının tam SHA değeriyle eşleştiğini doğrulayın. Kiralamayı bu SHA'ya bağlayın ve baş değiştiğinde durdurup yeniden ısıtın. Temiz `main` üzerinden güvenilir `scripts/crabbox-untrusted-bootstrap.sh` dosyasını `--fresh-pr` ile birlikte yükleyin; bu betik sabitlenmiş Node/pnpm sürümlerini kurar, SHA'yı ve paket yöneticisi sabitlemesini doğrular, `HOME` ortamını yalıtır, bağımlılıkları kurar ve ardından istenen testi çalıştırır. Aracı, rol olmadığını veya uzak PR bulunmadığını kanıtlayamazsa gizli bilgi içermeyen çatallanmış depo CI'ını kullanın. `hydrate-github`, `--no-sync` veya kimlik bilgileri yüklenmiş bir Testbox iş akışı kullanmayın. Tüm `CRABBOX_TAILSCALE*` geçersiz kılmalarını kaldırın, `--network public --tailscale=false` değerlerini zorunlu tutun, çıkış Node'u/LAN bayraklarını temizleyin ve herhangi bir betik yüklemeden önce `crabbox inspect` çıktısının Tailscale durumu olmadan genel ağ kullanımını bildirmesini zorunlu tutun. ## Olağan yerel sıra 1. Değiştirilen kapsam için Vitest kanıtı amacıyla `pnpm test:changed`. 2. Tek bir dosya, dizin veya açık hedef için `pnpm test `. 3. Yalnızca tam yerel Vitest paketine bilinçli olarak ihtiyaç duyduğunuzda `pnpm test`. Bir Codex çalışma ağacında veya bağlı/seyrek çalışma kopyasında Agent'lar doğrudan yerel `pnpm test*` / `pnpm check*` / `pnpm crabbox:run` kullanımından kaçınır: - Kullanıcının açıkça istediği, küçük bir dosyaya yönelik yerel geri dönüş: `node scripts/run-vitest.mjs `. - Değişiklik geçitleri veya kapsamlı kanıt: pnpm'in Testbox içinde çalışması için `node scripts/crabbox-wrapper.mjs run --provider blacksmith-testbox ... -- env OPENCLAW_CHECK_CHANGED_REMOTE_CHILD=1 OPENCLAW_CHANGED_LANES_RAW_SYNC=1 corepack pnpm check:changed`. - Sarmalayıcının son `exitCode` değeri ve zamanlama JSON'u komut sonucudur. Yetkilendirilmiş bir Blacksmith GitHub Actions çalıştırması, Testbox sürekli etkinlik eyleminin dışından durdurulduğu için başarılı bir SSH komutundan sonra `cancelled` gösterebilir; bunu hata olarak değerlendirmeden önce sarmalayıcı özetini ve komut çıktısını kontrol edin. - `OPENCLAW_HEAVY_CHECK_LOCK_SCOPE=worktree `: `pnpm check:changed` ve hedefli `pnpm test ...` gibi komutlarda yoğun denetimlerin serileştirilmesini ortak Git dizini yerine mevcut çalışma ağacı içinde tutar. Bunu yalnızca bağlantılı çalışma ağaçlarında bağımsız denetimleri bilinçli olarak çalıştırdığınız yüksek kapasiteli yerel ana makinelerde kullanın. ## Temel komutlar Test sarmalayıcı çalıştırmaları kısa bir `[test] passed|failed|skipped ... in ...` özetiyle sona erer; Vitest'in kendi süre satırı parça başına ayrıntı olarak kalır. | Komut | Ne yapar | | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `pnpm test` | Açık dosya/dizin hedefleri, kapsamlı Vitest hatları üzerinden yönlendirilir. Hedefsiz çalıştırmalar tam paket kanıtıdır: sabit parça grupları yerel paralel yürütme için yaprak yapılandırmalara genişletilir ve beklenen parça yayılımı başlatılmadan önce yazdırılır. Uzantı grubu, tek ve dev bir kök proje süreci yerine her zaman uzantı başına parça yapılandırmalarına genişletilir. | | `pnpm test:changed` | Ucuz ve akıllı değiştirilmiş test çalıştırması: doğrudan test düzenlemelerinden, kardeş `*.test.ts` dosyalarından, açık kaynak eşlemelerinden ve yerel içe aktarma grafiğinden kesin hedefler belirler. Geniş kapsamlı/yapılandırma/paket değişiklikleri, kesin testlerle eşleşmedikçe atlanır. | | `OPENCLAW_TEST_CHANGED_BROAD=1 pnpm test:changed` | Açık kapsamlı değiştirilmiş test çalıştırmasıdır; bir test düzeneği/yapılandırma/paket düzenlemesinin Vitest'in daha kapsamlı değiştirilmiş test davranışına geri dönmesi gerektiğinde kullanın. | | `pnpm test:force` | Yapılandırılmış OpenClaw Gateway bağlantı noktasını (varsayılan `18789`) serbest bırakır, ardından sunucu testlerinin çalışan bir örnekle çakışmaması için tam paketi yalıtılmış bir Gateway bağlantı noktasıyla çalıştırır. | | `pnpm test:coverage` | Varsayılan birim hattı (`vitest.unit.config.ts`) için bilgilendirici bir V8 kapsam raporu üretir; kapsam eşikleri uygulanmaz. | | `pnpm test:coverage:changed` | Yalnızca `origin/main` sonrasında değiştirilen dosyalar için birim kapsamı. | | `pnpm changed:lanes` | `origin/main` ile karşılaştırılan farkın tetiklediği mimari hatları gösterir. | | `pnpm check:changed` | CI dışında varsayılan olarak Crabbox/Testbox'a devreder, ardından uzak alt süreçte akıllı değişiklik denetimi geçidini çalıştırır: etkilenen hatlar için biçimlendirme, tür denetimi, lint ve koruma komutları. Vitest'i çalıştırmaz; test kanıtı için `pnpm test:changed` veya `pnpm test ` kullanın. | ## Paylaşılan test durumu ve süreç yardımcıları - `src/test-utils/openclaw-test-state.ts`: bir test yalıtılmış bir `HOME`, `OPENCLAW_STATE_DIR`, `OPENCLAW_CONFIG_PATH`, yapılandırma fikstürü, çalışma alanı, Agent dizini veya kimlik doğrulama profili deposu gerektirdiğinde Vitest'ten kullanın. - `pnpm test:env-mutations:report`: `HOME`, `OPENCLAW_STATE_DIR`, `OPENCLAW_CONFIG_PATH`, `OPENCLAW_WORKSPACE_DIR` veya ilgili ortam anahtarlarını doğrudan değiştiren testler/düzenekler hakkında engelleyici olmayan rapor. Paylaşılan test durumu yardımcısına geçiş adaylarını bulmak için kullanın. - `test/helpers/openclaw-test-instance.ts`: çalışan bir Gateway, CLI ortamı, günlük yakalama ve temizliği tek bir yerde gerektiren süreç düzeyindeki uçtan uca testler. - `scripts/lib/docker-e2e-image.sh` dosyasını kaynak olarak kullanan Docker/Bash uçtan uca hatları, kapsayıcıya `docker_e2e_test_state_shell_b64