给大模型的站点说明文件里,每条链接后面那句说明该写什么
给大模型准备的站点说明文件(llms.txt)里,链接后面那句说明不是装饰,它决定模型在压缩过的上下文里能不能判断这条链接值不值得进一步读取。按公开的提案约定,整份文件中真正必需的段落只有一处——文件最上方用一级标题写项目或站点的名称;剩下的都是按约定组织的可选结构,链接条目就在其中。条目行的固定写法是方括号里的名称加圆括号里的地址,之后可以跟一个冒号,冒号后面才是那句关于该文件的说明。
整个文件里只有一处是必需的
必需与可选的分界很清楚:项目名称的一级标题是必需段落,缺了它这份文件就不成立;导语、正文分组、链接列表、标注为 Optional 的段落则按约定出现,可以有也可以没有。这意味着撰写者真正需要动脑的地方,是那些可选段落怎么写——它们不报错,但直接决定抓取方能否快速定位重点。站内这一份由 llms.txt 相关能力自动生成,人工负责的是维护摘要而不是逐行手写。
条目行的写法:名称、地址、冒号后的说明
一条合格的条目分三段。名称用人能读懂的短语,不用重复整篇标题;地址指向站内真实存在的页面;冒号之后的说明补上前两段没交代的信息。很多人把说明写成标题的复读,等于浪费了这半行字。
| 段落 | 是否必需 | 写什么 | 反例 |
|---|---|---|---|
| 一级标题 | 必需 | 站点或项目名称 | 写成一句口号 |
| 条目名称 | 必需 | 这一页是什么的短名 | 复制整篇文章标题 |
| 条目地址 | 必需 | 指向页面的链接 | 指向不存在的旧地址 |
| 冒号后说明 | 可选 | 回答什么问题、给谁看、更新到哪天 | 重复名称 |
| Optional 段 | 可选 | 次要、可被跳过的链接 | 把主干入口塞进来 |
说明句要回答的三个问题
一句有效的说明,尽量在十几字内回答三件事:这一页回答什么问题(它的内容边界)、给谁看(新手还是已上手的人、选型还是排障)、更新到哪一天(时效性)。把这三件事压进一句,模型在需要更短上下文时也能保留判断依据;只写名称和地址,它就只能靠猜。
可选段落用来放什么
提案里标注为 Optional 的段落,是给抓取方在上下文吃紧时可以跳过的那部分,所以放次要链接:版本较长的旧记录、边缘专题、补充阅读。主干入口和最能回答高频问题的页面不要放进 Optional,否则在最关键的省略场景里反而被丢掉。关键词库能在这里帮上忙——把高频检索词归入对应条目的说明里,让一句说明同时承载「主题词」和「边界」。
站内由哪个模块生成这份文件
这份说明文件与站点地图不是一回事:站点地图给的是地址清单和修改时间,面向的是通用爬虫;模型说明文件给的是带语义的条目和摘要,面向的是大模型。站内由 SEO 与 GEO 相关模块自动生成,新增或更新文档时同步刷新,人工只在两处介入——维护每条的说明句,维护哪些进正文分组、哪些进 Optional。
常见问题
问:说明句写多长合适? 答:一句、十几个字最能被保留;长段落容易被截断,也会挤占省略时的判断成本。
问:既然必需段落只有一处,其它能不能都不写? 答:可以不写也不报错,但只有名称和地址的条目把判断全交给了模型,说明句正是让它少走弯路的地方。
问:有了站点地图还要这份文件吗? 答:要,两者回答的问题不同,一个给地址、一个给语义,站内分别由不同模块维护,互为补充。