Test etme: güncellemeler ve Plugin'ler

Bu, güncelleme ve Plugin doğrulaması için ayrılmış kontrol listesidir. Amaç basit: kurulabilir paketin gerçek kullanıcı durumunu güncelleyebildiğini, eski kalıcı durumu doctor ile onarabildiğini ve desteklenen kaynaklardan Plugin'leri hâlâ kurabildiğini, yükleyebildiğini, güncelleyebildiğini ve kaldırabildiğini kanıtlamak.

Daha geniş test çalıştırıcı haritası için bkz. Test Etme. Canlı sağlayıcı anahtarları ve ağa dokunan paketler için bkz. Canlı test etme.

# Neyi koruyoruz

Güncelleme ve Plugin testleri şu sözleşmeleri korur:

• Bir paket tarball'ı eksiksizdir, geçerli bir dist/postinstall-inventory.json içerir ve açılmamış repo dosyalarına bağlı değildir.
• Kullanıcı, yapılandırmayı, ajanları, oturumları, çalışma alanlarını, Plugin izin listelerini veya kanal yapılandırmasını kaybetmeden daha eski yayımlanmış bir paketten aday pakete geçebilir.
• openclaw doctor --fix --non-interactive, eski temizleme ve onarım yollarının sahibidir. Başlangıç, kalıcı eski Plugin durumu için gizli uyumluluk geçişleri büyütmemelidir.
• Plugin kurulumları yerel dizinlerden, git repolarından, npm paketlerinden ve ClawHub kayıt yolu üzerinden çalışır.
• Plugin npm bağımlılıkları yönetilen npm köküne kurulur, güvenden önce taranır ve kaldırma sırasında npm üzerinden kaldırılır; böylece yukarı taşınmış bağımlılıklar geride kalmaz.
• Hiçbir şey değişmediğinde Plugin güncellemesi kararlıdır: kurulum kayıtları, çözümlenen kaynak, kurulu bağımlılık düzeni ve etkin durum bozulmadan kalır.

# Geliştirme sırasında yerel kanıt

Dar başlayın:

pnpm changed:lanes --json
pnpm check:changed
pnpm test:changed

Plugin kurulumu, kaldırması, bağımlılığı veya paket envanteri değişiklikleri için, düzenlenen yüzeyi kapsayan odaklı testleri de çalıştırın:

pnpm test src/plugins/uninstall.test.ts src/infra/package-dist-inventory.test.ts test/scripts/package-acceptance-workflow.test.ts

Herhangi bir paket Docker hattı bir tarball tüketmeden önce paket yapıtını kanıtlayın:

pnpm release:check

release:check, yapılandırma/belge/API kayma kontrollerini çalıştırır, paket dist envanterini yazar, npm pack --dry-run çalıştırır, paketlenmesi yasak dosyaları reddeder, tarball'ı geçici bir öneke kurar, postinstall çalıştırır ve paketli kanal giriş noktalarını duman testinden geçirir.

# Docker hatları

Docker hatları ürün düzeyi kanıttır. Linux kapsayıcıları içinde gerçek bir paketi kurar veya günceller ve davranışı CLI komutları, Gateway başlangıcı, HTTP yoklamaları, RPC durumu ve dosya sistemi durumu üzerinden doğrular.

Yineleme yaparken odaklı hatları kullanın:

pnpm test:docker:plugins
pnpm test:docker:plugin-lifecycle-matrix
pnpm test:docker:plugin-update
pnpm test:docker:upgrade-survivor
pnpm test:docker:published-upgrade-survivor
pnpm test:docker:update-restart-auth
pnpm test:docker:update-migration

Önemli hatlar:

• test:docker:plugins, Plugin kurulum duman testini, yerel klasör kurulumlarını, yerel klasör güncelleme atlama davranışını, önceden kurulu bağımlılıkları olan yerel klasörleri, file: paket kurulumlarını, CLI yürütmeli git kurulumlarını, hareket eden ref git güncellemelerini, yukarı taşınmış geçişli bağımlılıklarla npm kayıt kurulumlarını, npm güncelleme işlemsizliklerini, yerel ClawHub fixture kurulumlarını ve güncelleme işlemsizliklerini, pazar yeri güncelleme davranışını ve Claude paketi etkinleştirme/incelemesini doğrular. ClawHub bloğunu hermetik/çevrimdışı tutmak için OPENCLAW_PLUGINS_E2E_CLAWHUB=0 ayarlayın.
• test:docker:plugin-lifecycle-matrix, aday paketi boş bir kapsayıcıya kurar; bir npm Plugin'ini kurulum, inceleme, devre dışı bırakma, etkinleştirme, açık yükseltme, açık düşürme ve Plugin kodunu sildikten sonra kaldırma süreçlerinden geçirir. Her aşama için RSS ve CPU metriklerini günlüğe yazar.
• test:docker:plugin-update, değişmemiş kurulu bir Plugin'in openclaw plugins update sırasında yeniden kurulmadığını veya kurulum meta verisini kaybetmediğini doğrular.
• test:docker:upgrade-survivor, aday tarball'ı kirli eski kullanıcı fixture'ı üzerine kurar, paket güncellemesini ve etkileşimsiz doctor'ı çalıştırır, ardından bir loopback Gateway başlatır ve durum korunmasını denetler.
• test:docker:published-upgrade-survivor, önce yayımlanmış bir temeli kurar, bunu gömülü bir openclaw config set tarifiyle yapılandırır, aday tarball'a günceller, doctor'ı çalıştırır, eski temizlemeyi denetler, Gateway'i başlatır ve /healthz, /readyz ile RPC durumunu yoklar.
• test:docker:update-restart-auth, aday paketi kurar, yönetilen token-auth Gateway başlatır, openclaw update --yes --json için çağıranın gateway auth ortamını kaldırır ve aday güncelleme komutunun normal yoklamalardan önce Gateway'i yeniden başlatmasını gerektirir.
• test:docker:update-migration, temizleme ağırlıklı yayımlanmış güncelleme hattıdır. Yapılandırılmış Discord/Telegram tarzı kullanıcı durumundan başlar, yapılandırılmış Plugin bağımlılıklarının oluşma şansı olması için temel doctor'ı çalıştırır, yapılandırılmış paketli bir Plugin için eski Plugin bağımlılık kalıntısı tohumlar, aday tarball'a günceller ve güncelleme sonrası doctor'ın eski bağımlılık köklerini kaldırmasını gerektirir.

Yararlı yayımlanmış yükseltme survivor varyantları:

[email protected] \
OPENCLAW_UPGRADE_SURVIVOR_SCENARIO=versioned-runtime-deps \
pnpm test:docker:published-upgrade-survivor

OPENCLAW_UPGRADE_SURVIVOR_BASELINE_SPEC=openclaw@latest \
OPENCLAW_UPGRADE_SURVIVOR_SCENARIO=bootstrap-persona \
pnpm test:docker:published-upgrade-survivor

Kullanılabilir senaryolar base, feishu-channel, bootstrap-persona, plugin-deps-cleanup, configured-plugin-installs, stale-source-plugin-shadow, tilde-log-path ve versioned-runtime-deps şeklindedir. Toplu çalıştırmalarda, OPENCLAW_UPGRADE_SURVIVOR_SCENARIOS=reported-issues bildirilen tüm sorun biçimli senaryolara, yapılandırılmış Plugin kurulum geçişi dahil, genişler.

Tam güncelleme geçişi, kasıtlı olarak Tam Sürüm CI'dan ayrıdır. Sürüm sorusu "2026.4.23'ten itibaren yayımlanmış her kararlı sürüm bu adaya güncellenip Plugin bağımlılık kalıntısını temizleyebilir mi?" olduğunda manuel Update Migration iş akışını kullanın:

gh workflow run update-migration.yml \
  --ref main \
  -f workflow_ref=main \
  -f package_ref=main \
  -f baselines=all-since-2026.4.23 \
  -f scenarios=plugin-deps-cleanup

# Paket Kabulü

Paket Kabulü, GitHub yerel paket kapısıdır. Bir aday paketi package-under-test tarball'ına çözer, sürümü ve SHA-256'yı kaydeder, ardından tam o tarball'a karşı yeniden kullanılabilir Docker E2E hatlarını çalıştırır. İş akışı koşum ref'i paket kaynak ref'inden ayrıdır; böylece güncel test mantığı daha eski güvenilir sürümleri doğrulayabilir.

Aday kaynaklar:

• source=npm: openclaw@beta, openclaw@latest veya tam yayımlanmış bir sürümü doğrulayın.
• source=ref: seçili güncel koşumla güvenilir bir branch, tag veya commit'i paketleyin.
• source=url: gerekli package_sha256 ile bir HTTPS tarball'ını doğrulayın.
• source=artifact: başka bir Actions çalıştırması tarafından yüklenmiş bir tarball'ı yeniden kullanın.

Tam Sürüm Doğrulama, varsayılan olarak çözümlenen sürüm SHA'sından oluşturulan source=artifact kullanır. Yayım sonrası kanıt için [email protected] geçirin; böylece aynı yükseltme matrisi gönderilmiş npm paketini hedefler.

Sürüm kontrolleri, paket/güncelleme/yeniden başlatma/Plugin kümesiyle Paket Kabulü'nü çağırır:

doctor-switch update-channel-switch update-corrupt-plugin upgrade-survivor published-upgrade-survivor update-restart-auth plugins-offline plugin-update

Sürüm bekletmesi etkin olduğunda şunları da geçirirler:

published_upgrade_survivor_baselines=last-stable-4 2026.4.23 2026.5.2 2026.4.15
published_upgrade_survivor_scenarios=reported-issues
telegram_mode=mock-openai

Bu, paket geçişini, güncelleme kanalı değiştirmeyi, bozuk yönetilen Plugin toleransını, eski Plugin bağımlılığı temizlemeyi, çevrimdışı Plugin kapsamını, Plugin güncelleme davranışını ve Telegram paket QA'sını aynı çözümlenmiş yapıt üzerinde tutar; varsayılan sürüm paket kapısının yayımlanmış her sürümü dolaşmasını gerektirmez.

last-stable-4, npm'de yayımlanmış en son dört kararlı OpenClaw sürümüne çözümlenir. Sürüm paket kabulü, ilk Plugin güncelleme uyumluluk sınırı olarak 2026.4.23'ü, Plugin mimarisi çalkantı sınırı olarak 2026.5.2'yi ve daha eski bir 2026.4.1x yayımlanmış güncelleme temeli olarak 2026.4.15'i sabitler; çözücü, zaten en son dört sürümde bulunan sabitlemeleri yinelerden arındırır. Kapsamlı yayımlanmış güncelleme geçişi kapsamı için Tam Sürüm CI yerine ayrı Update Migration iş akışında all-since-2026.4.23 kullanın. Eski tarih öncesi çapayı da istediğiniz manuel daha geniş örnekleme için release-history kullanılabilir durumda kalır.

Birden fazla yayımlanmış yükseltme survivor temeli seçildiğinde, yeniden kullanılabilir Docker iş akışı her temeli kendi hedefli çalıştırıcı işine parçalar. Her temel parçası seçili senaryo kümesini yine çalıştırır, ancak günlükler ve yapıtlar temel başına kalır ve duvar saati süresi tek büyük seri iş yerine en yavaş parçayla sınırlanır.

Sürümden önce bir adayı doğrularken paket profilini manuel çalıştırın:

gh workflow run package-acceptance.yml \
  --ref main \
  -f workflow_ref=main \
  -f source=npm \
  -f package_spec=openclaw@beta \
  -f suite_profile=package \
  -f published_upgrade_survivor_baselines="last-stable-4 2026.4.23 2026.5.2 2026.4.15" \
  -f published_upgrade_survivor_scenarios=reported-issues \
  -f telegram_mode=mock-openai

Sürüm sorusu MCP kanallarını, cron/subagent temizliğini, OpenAI web aramasını veya OpenWebUI'yi içerdiğinde suite_profile=product kullanın. Yalnızca tam Docker sürüm yolu kapsamına ihtiyaç duyduğunuzda suite_profile=full kullanın.

# Sürüm varsayılanı

Sürüm adayları için varsayılan kanıt yığını şudur:

1. Kaynak düzeyi regresyonlar için pnpm check:changed ve pnpm test:changed.
2. Paket yapıt bütünlüğü için pnpm release:check.
3. Kurulum/güncelleme/yeniden başlatma/Plugin sözleşmeleri için Paket Kabulü package profili veya release-check özel paket hatları.
4. İşletim sistemine özgü yükleyici, onboarding ve platform davranışı için çapraz işletim sistemi sürüm kontrolleri.
5. Yalnızca değişen yüzey sağlayıcı veya barındırılan hizmet davranışına dokunduğunda canlı paketler.

Maintainer makinelerinde, geniş kapılar ve Docker/paket ürün kanıtı, açıkça yerel kanıt yapılmadığı sürece Testbox içinde çalışmalıdır.

# Eski uyumluluk

Uyumluluk esnekliği dardır ve zaman sınırlıdır:

• 2026.4.25 dahil 2026.4.25-beta.* sürümüne kadar olan paketler, Paket Kabulü'nde zaten gönderilmiş paket meta verisi boşluklarını tolere edebilir.
• Yayımlanmış 2026.4.26 paketi, zaten gönderilmiş yerel derleme meta verisi damga dosyaları için uyarı verebilir.
• Daha sonraki paketler modern sözleşmeleri karşılamalıdır. Aynı boşluklar uyarı vermek veya atlamak yerine başarısız olur.

Bu eski biçimler için yeni başlangıç geçişleri eklemeyin. Bir doctor onarımı ekleyin veya genişletin, ardından güncelleme komutu yeniden başlatmanın sahibi olduğunda bunu upgrade-survivor, published-upgrade-survivor veya update-restart-auth ile kanıtlayın.

# Kapsam ekleme

Güncelleme veya Plugin davranışını değiştirirken, doğru nedenle başarısız olabilecek en düşük katmana kapsam ekleyin:

• Saf yol veya meta veri mantığı: kaynağın yanında birim testi.
• Paket envanteri veya paketlenmiş dosya davranışı: package-dist-inventory veya tarball denetleyici testi.
• CLI kurulum/güncelleme davranışı: Docker hattı doğrulaması veya fixture.
• Yayımlanmış sürüm geçiş davranışı: published-upgrade-survivor senaryosu.
• Güncellemenin sahip olduğu yeniden başlatma davranışı: update-restart-auth.
• Kayıt/paket kaynak davranışı: test:docker:plugins fixture'ı veya ClawHub fixture sunucusu.
• Bağımlılık düzeni veya temizleme davranışı: hem çalışma zamanı yürütmesini hem de dosya sistemi sınırını doğrulayın. npm bağımlılıkları yönetilen npm kökü altında yukarı taşınmış olabilir; bu yüzden testler, paket yerel node_modules ağacı varsaymak yerine kökün tarandığını/temizlendiğini kanıtlamalıdır.

Yeni Docker fixture'larını varsayılan olarak hermetik tutun. Testin amacı canlı kayıt davranışı olmadıkça yerel fixture kayıtlarını ve sahte paketleri kullanın.

# Hata triyajı

Yapıt kimliğiyle başlayın:

• Paket Kabulü resolve_package özeti: kaynak, sürüm, SHA-256 ve artefakt adı.
• Docker artefaktları: .artifacts/docker-tests/**/summary.json, failures.json, hat günlükleri ve yeniden çalıştırma komutları.
• Yükseltme sağ kalan özeti: .artifacts/upgrade-survivor/summary.json; temel sürüm, aday sürüm, senaryo, aşama zamanlamaları ve tarif adımları dahil.

Tüm sürüm şemsiyesini yeniden çalıştırmak yerine aynı paket artefaktıyla başarısız olan tam hattı yeniden çalıştırmayı tercih edin.