Boloop 閱讀示意圖(由 AI 生成):導讀僅連接公開內容,不複製整個網站的正文。
當有人問及 Boloop 是否有 llms.txt 時,網站並沒有這個入口。後來我決定新增一份輕量級的導讀,說明網站由誰維護、包含哪些內容,並提供少量背景和公開頁面的連結。
實現完成後,網站多了一個可直接讀取的文本入口。它並沒有為我們獲得一個新的「AI 收錄通道」,也不證明引用量增加了。這個變更首先解決的是整理和維護導讀的問題。
我希望它能回答一個很小的問題
Boloop 有原創工程 Skills、軟體推薦、原創文章和互動作品。讀者打開網站後,可以沿著導航自行探索;閱讀網站的工具也需要一種簡潔的方式,了解這些內容之間的關係。
我不希望將整個網站的正文拼成一個不斷變大的文件。導讀僅保留網站簡介、三種語言入口、欄目,以及符合條件的已發布頁面標題和摘要。詳細內容、作者與許可仍以鏈接頁面為準。第三方推薦屬於原創者,這個關係不會因為被列進本站目錄而改變。
內容詳情的連結以英文頁面為主,語言區另列英文、簡體與繁體首頁。這是一份精簡的入口,而非三套正文的另一個存儲副本。
讓 CMS 決定哪些內容可以出現
手動維護一份文本很容易開始,但會增加一個新的發布遺漏點:文章標題變更後,導讀仍顯示舊標題;資源下架後,文件仍會暴露其連結。
因此,我們讓 Worker 在請求 /llms.txt 時,從 CMS 的公開發布快照生成內容。它與站點地圖共享發現查詢的基礎權限:已發布、公開、未刪除、有有效的發布數據、且非演示記錄。
讀取的是發布快照中的標題和摘要,草稿中的編輯不會提前出現在導讀中。即使請求來自網站所有者,也不能通過此列出管理員可見的私人記錄。外部文章和推薦 Skill 的轉介詳情不作為獨立條目展開,欄目入口仍可幫助讀者找到這些推薦。
共享基礎規則,並不意味著兩個文件的格式和用途相同。站點地圖是根據搜索發現的需要列出 URL;這份導讀則提供的是帶簡短說明 的閱讀路徑。
小功能也要處理下架和分頁
動態生成最需要防的一個問題是,使用舊緩存後,內容已被下架,但文件中仍保留了該內容。Boloop 對這個入口不復用共享快照,每次重新檢查公開權限,並使用 private, no-store 響應策略。
查詢也不能只取第一批記錄。我們重複使用了基於 ID 的分批讀取,隔離測試專門放入超過一批的數據,檢查後續條目是否仍會進入結果。這裡的測試條目是驗證分頁的合成數據,不能被視作網站真實內容規模。
標題和摘要還需要進行文本處理。換行、括號和 Markdown 符號不能讓一個普通標題變成新的文件結構或偽造鏈接。生成器會清理控制字符,並轉義影響結構的字符。
當數據庫讀取失敗時,入口會返回錯誤狀態,而不是用靜態舊副本偽裝成最新導讀。這使失敗更容易被識別,也避免了將「還能返回一點文字」誤認為內容一致。
上線驗證檢查的是文件行為
2026 年 10 月 22 日的發布驗證確認,入口返回 UTF-8 純文本,GET 可以讀取內容,HEAD 不返回正文,錯誤方法和不支持的路徑有明確響應。公開站點和非公開模式也分別處理。
當次線上導讀中有 43 個連結,每個連結的檢查都返回了正常頁面。這是那次發布快照的數量,隨後發布或下架內容會改變它。發布驗證還檢查了原有的 robots 和 sitemap 是否被這個功能改寫。
文件帶有 noindex, follow,並不意味著導讀損壞。我們的目標是讓工具按需讀取它,而不是將這份文本文件本身視為需要進入普通搜索結果的文章頁。
下架、草稿隔離和管理員不能越過公開權限等變化,在隔離測試中驗證;沒有為了驗證而隨意下架生產文章。這兩類驗證合在一起,支持的是實現和訪問行為,而不是 AI 平台是否實際使用它。
文件存在之後,還需要觀察收益
llms.txt 提案網站 現在描述了更廣的導讀和 Markdown 內容建議。Boloop 這次實現的是精簡導讀,沒有因此為每個頁面建立 Markdown 鏡像,也沒有聲稱完整覆蓋提案的所有建議。
同時,Google 的 AI 搜索說明 明確表示,進入其 AI 搜索功能不需要新增特殊機器可讀文件或 AI 文本文件。Google 的這項說明也不能反向代表所有其他 AI 工具的行為。
我會將後續觀察分開記錄:文件是否可訪問、工具是否確實讀取、回答是否真正引用本站、有沒有可歸因的訪問。如果品牌查詢中出現本站,也不能自動假設是 llms.txt 帶來的。
對 Boloop 而言,這個功能的合理規模就是現在這樣:重複使用 CMS,保持公開內容一致,讓文件小而容易理解。等有了真實的使用證據,再決定是否擴展。先保住正文質量、清楚的內鏈和正常的頁面訪問,比給這個入口附加一個尚未測得的增長故事更有用。