用途:查找库文档、API 参考、变更日志或破坏性变更时,lib-docs 先抓取作者自行发布的 llms.txt,因其无策展延迟、无可能产生幻觉的增强层,故优先于 context7;llms.txt 不可用时以 context7 作为回退。
主要能力与用法: 探测:bash scripts/llms-probe.sh <docs-domain>,输出 TSV 的 kind \t url \t size,其中 index 指 llms.txt 的页面列表,full 指 llms-full.txt 的完整语料。路径因站点而异,应探测而非硬编码 URL。 抓取:full 体积不超过约 500 KB 时直接 WebFetch;更大或大小未知时,先 WebFetch 索引,再并行抓取匹配的页面链接。资料特别提示 Cloudflare 的 llms-full.txt 约 46 MB,盲目全量抓取会撑爆上下文窗口。 回退:探测失败时改用 context7,通过 ctx7 CLI 操作,需一次性登录 bunx ctx7@latest login。先解析库 ID,ID 不可猜测:bunx ctx7@latest library <name> [query];再查询文档:bunx ctx7@latest docs <libraryId> "<query>",具体查询的排序效果远好于宽泛查询。仅当默认答案过于浅显时才加 --research 重试,它会启动沙箱代理且成本更高。
适用与限制:多数 Mintlify/GitBook 托管的文档会发布 llms.txt;Tailwind 以及多数 1.0 之前或社区库不发布,此类直接走 context7。具体站点的 llms.txt 路径、体积与可用性需先探测确认,未探测前不应假定 URL。