Lighthouse, Markdown Bağlantıları Olmadan Llms.txt Dosyanızı Başarısız Oluyor @sejournal, @slobodanmanic aracılığıyla Windows

Lighthouse, Markdown Bağlantıları Olmadan Llms.txt Dosyanızı Başarısız Oluyor @sejournal, @slobodanmanic aracılığıyla

Chrome'un yeni Lighthouse Aracılı Tarama denetimi, .txt dosyanızı bir işaretleme belgesi olarak ele alır. Eğer llms.txt dosyanız işaretleme bağlantısı...

Chrome'un yeni Lighthouse Aracılı Tarama denetimi, .txt dosyanızı bir işaretleme belgesi olarak ele alır. Eğer llms.txt dosyanız işaretleme bağlantısı sözdizimini kullanmıyorsa, dosyadaki her bağlantı doğru ve çalışıyor olsa bile denetimde başarısız olursunuz. Denetimi nohacks.co'da gerçekleştirdim. Altı denetimden ikisi geçti. Üçü uygulanamaz olarak geri geldi. Biri başarısız oldu: llms.txt denetimi, kelimesi kelimesine "Dosya herhangi bir bağlantı içermiyor gibi görünüyor" hatası verdi. Düzeltme, bağlantı başına beş karakterdi. Dosya hâlâ düz metin olarak sunuluyor. Yalnızca denetim sonucu değişti.

Lighthouse 13.3.0, Performans, Erişilebilirlik, SEO ve En İyi Uygulamaların yanı sıra Aracılı Tarama kategorisini de sundu. Varsayılan kümedeki altı denetim: erişilebilirlik ağacının iyi biçimliliği (aracı-erişilebilirlik-ağacı), kümülatif düzen değişikliği (kümülatif-düzen-kaydırma), llms.txt keşfedilebilirliği (llms-txt) ve üç WebMCP denetimi (webmcp-registered-tools, webmcp-form-coverage, webmcp-schema-validity). Kategori, 0'dan 100'e kadar puan yerine kesirli bir geçiş oranı döndürür çünkü aracılı web'e yönelik standartlar hâlâ yürürlüktedir.

Nohacks.co'da Yapılan 6 Denetimden 1'i Başarısız Oldu

Denetimi Lighthouse CLI aracılığıyla gerçekleştirdim: npx lighthouse@latest https://nohacks.co --only-categories=agentic-browsing . Altı denetim geri döndü. Üçü geçersiz olarak geri geldi, tümü WebMCP: webmcp-registered-tools, webmcp-form-coverage ve webmcp-schema-validity. Lighthouse, uygulanamayan bir sonuç için hiçbir neden göstermez, sadece denetimi işaretler ve yoluna devam eder. nohacks.co, WebMCP'yi açığa çıkarıyor, ancak yalnızca deneysel zorunluluk navigator.modelContext API'si aracılığıyla (iki sözlük aracı, bir aracı-tarayıcı dizini için iki), bildirim niteliğinde form açıklamaları olmadan. Tarama, WebMCP bayrağı olmayan varsayılan başsız bir Chrome 150'de gerçekleştirildi; dolayısıyla geçerli olmayan karar, web sitesinin bu denetimlerin tanıdığı hiçbir şeyi açığa çıkarmadığı veya tarama ortamında o sırada etkin bir WebMCP API'sinin olmadığı anlamına gelebilir. Deniz Feneri hangisi olduğunu söylemiyor. İki denetim sorunsuz bir şekilde geçti: aracı erişilebilirlik ağacı, anlamsal HTML ve ARIA yapısının aracıların gezinmesi için yeterince iyi biçimlendirildiğini ve kümülatif düzen değişikliğinin sıfıra döndüğünü doğrulayarak "Tüm denetimler geçti" raporunu verdi.

Gelecekte Ne Bekleniyor?

Bir denetim başarısız oldu: llms-txt. Lighthouse'un birebir hata mesajı şuydu:

Sonuç ve Değerlendirme

Dosya herhangi bir bağlantı içermiyor gibi görünüyor.

Kategori puanı 0,67 oldu. İlk sürpriz buydu. nohacks.co/llms.txt adresindeki dosyada birçok bağlantı bulunmaktadır. Makalelere, bölümlere, konuklara ve sözlüğe giden gezinme yolları. RSS beslemesi URL'leri. Ses dosyası URL kalıpları. Dosya beş kilobayttan fazla yapılandırılmış içerik içeriyor. Peki Lighthouse neden sıfır bağlantı rapor ediyordu?

Teknik Analiz

Lighthouse .txt dosyasını İşaretleme Olarak Ayrıştırır ve Düz Metin Bağlantılarını Reddeder

Dosya uzantısı .txt'tir, ancak Lighthouse içeriği işaretleme olarak ayrıştırır ve herhangi bir metnin bağlantı olarak sayılması için işaretleme bağlantısı söz dizimini talep eder. Dosyanın adı llms.txt . HTTP sunucusu bunu metin/düz MIME türüyle döndürür. Bir tarayıcıda açtığınızda düz metin görürsünüz. Ancak llmstxt.org'daki llms.txt spesifikasyonu, formatı bir işaretleme belgesi olarak tanımlar. Spesifikasyon açıktır: "Her bölüm, bağlantıların işaretli bir madde işareti listesini içerir. Her liste öğesinde, bağlantıdan iki nokta üst üste işaretiyle ayrılmış, bağlantıyla ilgili isteğe bağlı notların takip ettiği bir bağlantı bulunur." Lighthouse'un ayrıştırıcısı bunu kesinlikle uygular. Her bağlantı, bağlantı metninin etrafında köşeli parantezler ve URL'nin etrafında parantezlerle birlikte işaretleme bağlantısı sözdizimi [text](url) olarak kodlanmalıdır.

Önemli Gelişmeler

Dosyam daha doğal bir düz metin biçimi kullanıyordu:

- Ana sayfa: / - Yayın künyesi, köşe taşı serileri, en son makaleler ve bölümler - Makaleler: /blog - AXO, ajans ağı ve AI ajanları hakkındaki tüm makaleler - Bölüm: /bölüm/[slug] - Tam gösteri notları, transkript, ses oynatıcı

Uzmanların Görüşleri

Aynı varış noktaları. Aynı açıklamalar. Aynı bilgi. Lighthouse'un ayrıştırıcısı bu satırları bağlantı olarak kaydetmez. Dosyanın tamamında tam olarak sıfır kayıtlıydı. Denetim başarısız olur.

Metin/düz MIME türüyle sunulan, .txt uzantılı, markdown olarak biçimlendirilmediği sürece denetimde başarısız olan bir dosya. Bu, denetim katmanının daha dürüst olması gereken bir uyumsuzluktur. Uzantı bir şey söylüyor. MIME türü bir şey söylüyor. Ayrıştırıcı gerçeğin kaynağıdır ve ayrıştırıcı işaretleme talep eder.

Sistem Güvenliği

Düzeltme Bağlantı Başına 5 Karakterdir

Her bağlantı hedefini işaretleme parantezi-paren sözdizimine ([text](url)) sarın ve her açıklamadan önceki - ayırıcıyı : ile değiştirin. Bağlantı başına beş karakter. Dosya boyunca tekrarlanan mekanik dönüşüm.

Nasıl Önlem Alınmalı?

- [Anasayfa](/): Yayın künyesi, temel dizileri, en son makaleler ve bölümler - [A makaleler](/blog): AXO, aracılı web ve yapay zeka aracıları hakkındaki tüm makaleler - [Bölüm](/episode/[slug]): Tam gösteri notları, transkript, ses oynatıcı

Detaylar ve Etkileri

Düzenlemeyi yaptım. Denetimi yeniden gerçekleştirdik. Skor 0,67'den 1,0'a çıktı. Denetim başlığı "llms.txt önerileri takip etmiyor" yerine "llms.txt tavsiyeleri takip ediyor" olarak değiştirildi. Sonrası raporda ayrıntı öğesi yok. Temiz geçiş.

Dosya hala text/plain olarak sunuluyor. Dosya uzantısı hala .txt'dir. Dosya içeriği hala aynı içeriktir. Yalnızca bağlantı kodlaması değişti.

Lighthouse Dosya Kalitesini Değil, Ayrıştırılabilir Bağlantı Sözdizimini Ölçer

Denetim, dosyanızın mekanik olarak ayrıştırılabilir olup olmadığını kontrol eder. Dosyanın web sitenizi yararlı bir şekilde tanımlayıp tanımlamadığını kontrol etmez. Her iki okuma da aynı anda doğrudur.

İlk okuma: Denetim gerçek bir şeyi ölçüyor. Markdown bağlantısı sözdizimi mekanik olarak ayrıştırılabilir. Düz metin açıklayıcı satırlar değildir. Bir AI aracısının (veya aracının yerine geçen Lighthouse ayrıştırıcısının) dosyadan bağlantıları programlı olarak çıkarması gerekiyorsa işaretleme formatı gereklidir. Denetim, düzeltmemden önceki dosyanın standart araçlarla bağlantılar için ayrıştırılamadığı yönünde doğrudur. Markdown bağlantısı sözdizimine dönüşüm, gerçek bir birlikte çalışabilirlik açığını giderir.

İkinci okuma: format uyumluluğu dosya kalitesiyle aynı değildir. Düz metin açıklamaları kullanan, özenle yazılmış, doğru ve kapsamlı bir llms.txt dosyası bu denetimde başarısız olur. Markdown bağlantısı sözdizimine sahip, otomatik olarak oluşturulmuş ince bir llms.txt dosyası geçer. Denetim ikisi arasındaki farkı söyleyemez. WordPress.org listesine göre 3 milyondan fazla web sitesi tarafından kullanılan WordPress eklentisi AIOSEO, varsayılan olarak işaretleme bağlantısı sözdizimine sahip llms.txt dosyaları oluşturuyor; Glenn Gabe varsayılan olarak açık bir davranış ortaya çıkardı ve eklentinin kendi belgeleri bunu doğruluyor. Otomatik olarak oluşturulan dosyalar, işaretleme bağlantısı sözdizimini kullanır çünkü oluşturucunun yaydığı şey budur. Çoğu muhtemelen bu denetimi geçiyor. Elle seçilmiş, sahibinin farkında olduğu llms.txt dosyalarının çoğu muhtemelen başarısız olur.

Bu boşluk, denetimin başarılı/başarısız durumunu web sitenizin aracılara ne kadar hazır olduğunun bir ölçüsü olarak ele almadan önce düşünmeye değer. Denetim, dosyanızın ayrıştırılabilir olup olmadığını kontrol ediyor. Dosyanızın yararlı olup olmadığını kontrol etmiyor.

Lighthouse Agentic Browsing'in Llms.txt Kontrolünü Önemsemeli misiniz?

Evet ama dar anlamda. Lighthouse size llms.txt dosyanızın işaretleme olarak ayrıştırılabilir olup olmadığını söyleyebilir. Dosyanın web sitenizi dürüstçe tanımlayıp tanımlamadığını size söyleyemez. O çek senin. Chrome DevTools'u açın, Lighthouse sekmesine tıklayın, Aracılı Tarama kategorisinin işaretli olduğunu doğrulayın ve URL'nizde Analiz'i çalıştırın. Denetim bir dakikadan az sürer. Bağlantı yok hatası başarısız olursa, düzeltme bağlantı başına beş karakter ve beş dakikalık düzenlemedir. Eğer geçerse, Lighthouse'un soramayacağı daha zor soru olacak. Dosya, yapılandırmadığınız bir eklenti tarafından otomatik olarak mı oluşturuldu, yoksa kendiniz mi yazdınız; her iki durumda da, web sitenizin gerçekte ne olduğunu açıklıyor mu?

Makine Öncelikli Mimari Yapısı tüm bunların altında yer alır: sayfa düzenlerinden önceki veri modelleri, bağımsız oluşturma, istemci tarafı JavaScript'e veya makine tarafından okunabilir olması için insan ekranı varsayılanlarına bağlı olmayan içerik. llms.txt denetimi bu katmandaki dar kapsamlı bir denetimdir. Makine tarafından okunabilen yüzeyinizin web sitenizi doğru bir şekilde tanımlayıp tanımlamadığı gibi daha büyük yapısal soru sizindir.

Bu yazı ilk olarak No Hacks'te yayınlandı.

Öne Çıkan Görsel: Darko 1981/Shutterstock

Paylaş: