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，保持公开内容一致，让文件小而容易理解。等有了真实使用证据，再决定要不要扩展。先保住正文质量、清楚的内链和正常的页面访问，比给这个入口附加一个尚未测得的增长故事更有用。