
llms.txt 有了内容,还要检查它指向哪里
站点首页、文档、教程和帮助页分散在不同位置,想给 AI 阅读者一份入口清单,可以先整理一份 llms.txt。难点往往不在文件名,而在于:哪些链接值得收录,是否仍指向正式内容,更新后谁负责检查。
AIGoCode 的工具目录列有「llms.txt 生成器」,说明为「填写站点简介和链接,生成 AI 可读的站点索引」。本文围绕生成前后的人工验收展开,不把生成文件等同于已部署,也不承诺它能提高搜索排名、获得 AI 引用或被任何特定工具读取。
先定读者任务,再选入口
不要从「把所有链接都塞进去」开始。先问:来读这份索引的人或工具,需要了解产品、查接入步骤,还是寻找某个参数的正式定义?这些任务对应的入口不同。
建议先在本地建一份链接清单,记录每个页面的用途、适合谁读、是否公开,以及负责人。介绍页回答产品是什么;上手页回答怎么开始;参数页回答具体字段;故障页回答某种报错如何处理。只有页面确实承担这项任务,才按这个用途收录。
标题相似不意味着内容重复。一个概览和一个深入教程可以同时存在,但说明中应交代阅读顺序。反过来,旧入口只是跳转到新入口时,优先核对哪个地址是站点当前认可的正式地址,避免清单中堆出多份看似不同的同一内容。
逐条确认正式地址和公开范围
整理链接时,建议打开最终目标页面,核对标题与实际正文,而不只复制导航里的文字。尤其检查以下几种情况:测试域名、预览地址、已经迁移的文档、需要登录的控制台,以及包含临时访问参数的分享链接。
索引通常用于引导阅读公开资料。内部草稿、带私人凭据的地址、只有本人能访问的附件,不宜当作公开入口。需要登录的页面若确有收录理由,应在说明中写清访问条件;不要让读者以为它是可以直接阅读的说明文档。
本文不表示生成器会替你检测权限、识别失效链接或抓取全站。页面能否公开访问、是否代表正式产品口径,都需要你按实际情况检查。
每个链接写一句能帮助选择的说明
链接说明应该回答「点开能解决什么」,而不是重复页面标题。例如,对一个虚构项目,可以写「首次配置:选择接入方式并完成最小请求」「错误说明:按状态码查排查步骤」。这些是写法示例,不是 AIGoCode 已提供页面或功能的声明。
可以按产品认识、开始使用、深入参考和问题处理组织阅读顺序。分组只是信息整理建议,不要求生成器具有某个固定栏目或自动排序规则。实际输入方式以工具页面为准,取得生成文本后仍应检查标题、说明和链接是否对应。
如果一条说明只能写成「很强」「全面」「最好用」,就继续回到原页面找具体任务。对尚未上线的能力、没有公开证据的效果和价格,不要靠索引简介补成产品承诺。
自行保存文本后,先做文件验收
拿到生成文本后,建议自行复制到文本编辑器并保存,再检查文件名、正文可读性和链接目标。这里的本地保存由你自行完成,不预设工具具有导出或下载按钮。保留一份来源清单,便于维护者知道每条链接为什么被收录,而不是以后只剩一份无法追溯的文本。
| 检查项 | 人工验收动作 | 需要记录的异常 |
|---|---|---|
| 站点简介 | 对照正式介绍页检查定位与能力 | 未上线功能、过时产品名 |
| 页面标题 | 打开目标页核对实际用途 | 标题和正文任务不一致 |
| 链接目标 | 检查最终域名、路径和访问条件 | 预览地址、失效页、登录限制 |
| 阅读顺序 | 按新读者任务通读一次清单 | 缺少起点、重复入口、跳步 |
| 文件交接 | 将文件和维护说明一起交给负责人 | 没有负责人或更新依据 |
这里不规定工具会怎样处理特殊字符、相对路径或空分组。实际生成结果里如有地址拼接或格式疑问,就逐条打开并核对;不要按另一个工具的习惯推断。
部署验收与生成验收分开
「已经在本地保存文本」和「站点已经提供文件」是两项不同状态。若计划通过站点的 /llms.txt 提供索引,应由有权限的维护者按该站点的部署方式处理,然后用完整公开地址检查实际响应和内容。
建议在交接单中分别写明:生成稿已检查、部署待处理,或部署后已由谁在什么时间核对。本文只讨论验收方法,不替你修改生产站点,也不表示任何生成器会自动上传或发布文件。
上线后还要点击索引中的入口。文件本身能打开,不代表里面的链接都有效;页面存在也不代表描述仍然正确。遇到跳转或内容迁移,检查最终页面是否仍能完成原来标注的读者任务。
让索引跟着正式内容一起维护
建议把索引检查纳入文档迁移、导航调整和产品说明更新的交接中。变更时先确认原入口承担的任务是否保留,再更新链接或说明。不能因为某个新页面刚上线,就不加判断地把它塞进清单。
从 AIGoCode 工具目录找到 llms.txt 生成器,可以先整理简介和链接。最终交付应包含经过人工核对的文件、来源清单与部署状态,让接手者清楚知道哪些已确认、哪些还待处理。