llms.txt 我们只砍下 36%:剩下 110KB 是手写文案,砍它等于改内容
站点 llms.txt 从 249.3KB 降到 159.4KB(−36.1%,249,300 → 159,363 字节),索引段从 503 条链接收到 110 条,摘要统一截到 80 字。再往下砍不动,因为剩下的 110KB 是手写策展段(83KB)、付费包(9.4KB)和错误码说明(17.9KB),砍它们属于内容改写而不是配置。附生成链、四个参数、被移出索引的 224 篇靠 llms-full.txt 兜底,以及四个不看体积的验收数字。
llms.txt 砍到 159KB 就停手:自动生成的部分能砍,手写策展段不能。索引 110 条、摘要 80 字、224 篇交给 llms-full.txt 兜底;验收看读取次数与 AI 引荐,不看体积。
适用对象
- 站点 llms.txt 从 249,300 字节降到 159,363 字节(−36.1%):索引段从 503 条链接收到 110 条(从全量页面里精选),每条摘要统一截到 80 字。
- 再往下砍不动:剩下的约 110KB 里,手写策展段 83,009 字节、付费包 9,443 字节、错误码说明 17,929 字节,砍它们等于改内容,不是调配置。
- public/llms.txt 是 prebuild 生成产物,手改必被覆盖;被移出索引的页面留在 /llms-full.txt 兜底;验收看读取次数与 AI 引荐,不看体积。
时间线:为什么 10 天原地不动
中间没有任何一次「瘦身生效」的记录,也没有谁改回去——它压根没被写进生成器里,因为当时改的是产物文件。
| 日期 | 发生了什么 | 线上体积 |
|---|---|---|
| 11-08 | 出瘦身方案:228,833 → 45,913 字节(110 条精选),批准 | 228.8KB |
| 11-09 及以后 | 每次构建跑 prebuild,从内容目录全量重建 public/llms.txt | 逐次增长 |
| 11-18(改前) | 实测,且发现此前改的是产物 | 248.8KB / 731 行 / 503 条 |
| 11-18(改后) | 改生成器后上线(0e3d04b) | 159,363 B(−36.1%) |
生成链:为什么手改 public/llms.txt 没用
先看 package.json 里的构建前置脚本:prebuild 会依次运行 scripts/portal-resource-route-slugs-generate.mjs 和 scripts/portal-llms-index-generate.mjs,后者直接覆写 public/llms.txt 与 public/llms-full.txt 的自动索引段。
由此得到三条判断:
本节判断
- public/llms.txt 的索引块不是源文件,是构建产物;手改、commit 都只能撑到下一次 build。
- 想瘦身,改的是生成器(scripts/portal-llms-index-generate.mjs)里的收录与截断规则,不是输出文件。
- 同理会发生在 sitemap.xml、resourceRouteSlugs.generated.ts 上——凡 generated 产物,都别手改。
改生成器的四个参数(我们定的值)
把规则写进生成器后,每次构建都会稳定产出同一格式的精选索引:
| 参数 | 我们定的 | 为什么 |
|---|---|---|
| 收录条数 | 110 条(索引段从 503 条链接收到 110 条) | 多数助手一次读取有上下文预算,超出就截断,截断掉的正好是开头的定位与边界 |
| 排序 | 固定支柱页(PINNED_SLUGS)优先,再按 AI 抓取证据与更新日新到旧补满 110 | 让助手先拿到核心支柱与真的在被抓取的页,而不是单纯按文件名排 |
| 摘要 | 每条截到 80 字 | 长描述会把预算吃光,助手只要一句能判断要不要点 |
| 兜底 | 全量留在 /llms-full.txt(261,984 字节,全量都在),在 llms.txt 里写明指向 | 少给 224 条不等于删掉 |
砍不动的那 110KB(这篇的真正结论)
这就是「瘦身到 45KB」没做到的原因:45KB 是重写整个文件的预算,而重写文件属于内容决策,不是配置决策。我们选择先砍能自动生成的部分,剩下的交给内容侧按季度复核。
| 段 | 字节 | 是生成器产物吗 | 能不能砍 |
|---|---|---|---|
| 手写策展段 | 83,009 | 不是 | 能,但要人来定:删哪段、留哪句 |
| All Resources Index(110 条) | 48,690 | 是 | 已砍到位 |
| 付费包说明 | 9,443 | 不是 | 能,但涉及报价与边界表述 |
| 错误码说明 | 17,929 | 不是 | 能,但那是排障内容,删了会掉页 |
怎么判断它有没有用(不看体积)
体积不是指标。我们 228KB 时 7 天只被读 12 次、AI 引荐 4 PV——体积没换来引用。这句话是我们自己的读数(2026-11-08 口径,7 天基线),不是行业结论。
| 指标 | 基线(2026-11-08 口径) | 30 天后看什么 |
|---|---|---|
| /llms.txt 请求次数 | 12 | 是否上升 |
| /llms-full.txt 请求次数 | 8 | 是否上升(升说明助手在找全量) |
| AI 引荐可归因 PV(ai_assistant) | 4 | 是否上升 |
| 人工抽 3 问 | 未做 | 助手能否在 1 次读取内说清定位与两条业务线 |
给要做这件事的人的检查清单
动手改自己站点的 llms.txt 之前,按下面 5 步走:
本节判断
- 1. grep -n llms package.json:先确认 llms.txt 是自动生成还是手写。
- 2. 生成的:改生成器的收录与排序规则,别动产物。
- 3. 手写的:把它加进构建流水线,否则三个月后一定和内容脱节。
- 4. 兜底要选对:逐页全量在 llms-full.txt;llms.json 那类结构化文件装的是簇和实体关系(41,469 字节,7 个资源簇),不能当逐页清单用。
- 5. 验收看读取次数与 AI 引荐,不看字节数。
觉得有用?转给正在做这件事的同事或朋友
常见问题
为什么不直接把 llms.txt 砍到 45KB?
因为自动生成的索引段已经压到 48.7KB(110 条),剩下的约 110KB 是手写策展段(83KB)、付费包说明(9.4KB)和错误码(17.9KB)。删减这些属于内容改写,我们按季度复核,不在配置瘦身里硬砍。
被移出 llms.txt 索引的 224 篇内容去哪了?
全部保留在 /llms-full.txt(约 262KB)和 /sitemap.xml(496 条)里,llms.txt 的索引块开头也写明了指向 /llms-full.txt。
llms.json 能替代 llms-full.txt 做全量兜底吗?
不能。本站的 llms.json(约 41.5KB)存的是 7 个核心簇与实体消歧关系,不是逐页清单;逐页全量兜底只能用 /llms-full.txt。