Vercel CLI'ya kurulum sorunlarını teşhis eden ve çözümleri yazdıran vercel doctor komutu eklendi

Neler geldi

Vercel, CLI'sına vercel doctor adında bir teşhis komutu ekledi. Vercel bloguna göre komut, geliştiricinin yerel kurulumunu inceliyor, bulduğu her sorunu raporluyor ve çözüm komutunu yazdırıyor — normalde bir destek talebi alışverişine dönüşen süreci tek bir terminal komutuna indiriyor.

Kontroller neleri kapsıyor

3 Kasım'da yayımlanan duyuru, komutun incelediği dört alanı listeliyor. Yüklü CLI sürümünü ve CLI'nın nasıl kurulduğunu doğruluyor, oturum açma bilgisini ve o an seçili olan takımı kontrol ediyor, yerel dizinin bir Vercel projesine bağlı olduğunu teyit ediyor ve vercel.json içindeki proje yapılandırmasını doğruluyor. Yerel kontrollerin yanı sıra, Vercel durum sayfasındaki aktif olayları da raporluyor; böylece bir platform kesintisinin neden olduğu bir arıza, yerel bir yapılandırma hatasıyla karıştırılma olasılığı azalıyor.

Her kontrol dört durumdan biriyle sonuçlanıyor: OK, Warning, Failed veya Skipped. Bir kontrol başarısız olduğunda doctor, önerilen çözümü düz metin paragrafı yerine bir komut olarak raporluyor.

Bir uç durum özel olarak ele alınıyor. vercel upgrade yüklü CLI'yı güncelleyemediğinde, kurulum kontrolü CLI'nın gerçekte nereden çalıştığını ve nasıl yeniden yükleneceğini raporluyor — etkin kurulumun normal yükseltme yoluyla güncellenemediği durumu çözmek için.

Gözetimsiz çalışacak şekilde tasarlandı

İki tasarım kararı öne çıkıyor. Birincisi, doctor oturum açma bilgisi veya bağlı bir proje olmadan çalışıyor; bu yüzden yeni bir makinede ya da henüz hiçbir kurulum yapılmamış bir ortamda çalıştırılabiliyor. İkincisi, Vercel komutun asla istem göstermediğini, asla oturum açmadığını ve asla proje bağlamadığını belirtiyor; bu da onu etkileşimsiz şekilde çağırmayı güvenli kılıyor.

Açıklanan motivasyon ajan odaklı. Duyuruya göre doctor istemlerde beklemediği için, kodlama ajanları bir çözüm tahmin etmeden önce onu çalıştırabiliyor. Bir --json bayrağı bunu tamamlıyor; her kontrolün durumunu ve önerilen komutu yapılandırılmış çıktı olarak döndürüyor ve otomatik araçlara, insan tarafından okunabilir terminal metnini kazımak yerine ayrıştırıp üzerinde işlem yapabilecekleri deterministik bir veri sunuyor.

Nasıl denenebilir

Komut en son CLI sürümünde geliyor; bu yüzden izlenecek yol bir güncelleme ve ardından vercel doctor. Vercel ayrıca okuyucuları tam dokümantasyon için CLI komut referansının doctor bölümüne yönlendiriyor.

Neden önemli

CLI kurulum arızalarının çoğu sıra dışı değildir: eski bir sürüm, yanlış takım bağlamı, eksik bir proje bağlantısı, vercel.json içindeki bir yazım hatası. Zaman alan şey genellikle çözümün kendisi değil, bunlardan hangisinin bozuk olduğunu anlamaktır. Doctor bu triyaj adımını tek bir komuta sıkıştırıyor ve tam çözümü elinize veriyor; bu da hem hata ayıklama süresini hem de destek yükünü azaltmalı.

Daha büyük sinyal, etkileşimsiz tasarımın JSON çıktısıyla birleşmesi. Vercel, doctor'ı kodlama ajanlarının tahmin etmeden önce çağırabileceği bir şey olarak açıkça konumlandırıyor — CLI kullanımının büyüyen bir kısmının makine tarafından yönetildiğinin bir kabulü bu. Her yerde çalıştırılması güvenli, yapılandırılmış sonuçlar üreten ve çözüm komutları çıkaran bir teşhis aracı, otomatik bir ajanın insan müdahalesi olmadan kendi ortamını onarması için tam olarak ihtiyaç duyduğu arayüz. Durum sayfası entegrasyonu son bir güvence ekliyor: biri yerel kurulumunda bir saat hata ayıklamaya başlamadan önce doctor, platformun kendisinin kötü bir gün geçirip geçirmediğini söyleyebiliyor.