常見的 llms.txt 錯誤
發佈:
大多數 llms.txt 問題都落在少數幾種模式中。以下是我們的驗證工具最常標記出的問題——以及每一項的快速修正方法。
1. 超過一個 H1
規範要求恰好只有一個最上層的 # Title。多餘的 # 標題會使結構混亂。請將其餘的降級為 ## 區段標題。
2. 缺少引用區塊摘要
標題正下方一到兩句的引用區塊，是模型最先讀到的脈絡。略過它是最常見的單一疏失。請加上一段：
# Acme > Acme turns CSV files into charts. These links cover setup, the API, and pricing.
3. 區段沒有連結（或完全沒有區段）
空的 ## 區段沒有任何作用。每個區段都應該包含一個指向實際頁面的 Markdown 連結項目清單。如果你完全沒有任何區段，請將關鍵頁面歸類到 ## Docs 和 ## Guides 這類標題之下。
4. 連結失效
一個檔案可能格式完美無瑕，卻指向失效的頁面——這會浪費爬蟲的預算並損害信任。每個 URL 都必須能夠正常解析。這是大多數工具會略過的檢查項目；我們會逐一抓取每一個連結。
5. 相對路徑或 http:// 連結
請在所有地方使用絕對的 https:// URL。模型可能無法解析像 /docs/start 這樣的相對路徑，而純 http:// 連結看起來不可信，並且在僅限 HTTPS 的爬取下可能會失效。
6. 內容類型錯誤
請以 text/plain; charset=utf-8 提供這個檔案。如果你的伺服器回傳 text/html（一種常見的設定錯誤），某些消費端就不會將它視為 llms.txt。
7. 臃腫且未經整理的檔案
llms.txt 是一份經過精心整理的索引，而不是傾倒整份 sitemap。數百個沒有說明的連結會淹沒訊號。請保留最佳的頁面，在每一個後面加上簡短的 : description，並把次要的連結移到 ## Optional 區段。
一次全部抓出來
把你的檔案丟進驗證工具——它會評估結構、連結可達性與最佳實踐，並明確告訴你上述哪些項目需要修正。第一次接觸這個格式嗎？先從如何建立 llms.txt 檔案開始。