大语言模型（LLMLens）使用文档

作者：kuakeba.cn | 版本：1.0.0 | 适用于 Zsens Admin 3.0+（PHP 8.2+）

一、插件简介

将站点的文章、页面与分类整理为符合 llmstxt.org 规范的 llms.txt 文件，通过 /llms.txt 对外输出，供大语言模型（LLM）抓取与理解站点内容：

• 自动生成 # 站点名、> 站点简介、## 板块小节 的标准 Markdown 结构
• 收录板块可勾选：分类板块 / 站点页面 / 主题文章（文章、讨论、问答类型可选）
• 主题链接可附正文纯文本摘要，帮助 LLM 理解内容
• 支持自定义附加链接（如 API 文档、外部资源），汇入「其它资源」小节
• 生成结果按分钟级缓存，后台可一键刷新，避免每次请求都查库
• 可在全站前台 <head> 注入 <link rel="alternate" type="text/markdown"> 发现标签
• 零侵入：不修改任何宿主文件，仅注册插件路由与后台菜单，卸载即彻底清理

二、环境要求

三、安装步骤

1. 将 LLMLens 目录放入 plugins/ 下
2. 进入后台 应用中心，找到「大语言模型」，点击 安装（自动注册后台菜单并清空缓存）
3. 进入 应用中心 → 大语言模型 → 配置，按需调整收录板块、摘要长度、缓存时长等
4. 访问 https://你的域名/llms.txt 即可看到生成的索引文件
5. 后台左侧菜单 大语言模型 → 预览 llms.txt 可实时预览内容、查看统计、刷新缓存

卸载插件时会自动删除后台菜单、静态资源与内容缓存，不留任何残留。

四、配置项说明

后台 应用中心 → 大语言模型 → 配置：

修改配置后，已缓存内容会在缓存到期或手动「刷新缓存」后更新。

五、输出格式示例

# 快刻吧资源社区

> 专注精品资源分享与交流的社区。

## 分类板块

- [技术交流](https://example.com/category/1.html): 各类技术话题讨论
- [资源分享](https://example.com/category/2.html): 精选资源发布板块

## 站点页面

- [关于我们](https://example.com/page/about.html): 站点介绍与联系方式

## 主题文章

- [欢迎使用本社区](https://example.com/topic/1.html): 社区使用指南与规则说明……

## 其它资源

- [API 文档](https://example.com/page/api.html): 开放接口说明

六、工作原理

1. 路由输出：插件注册前台路由 GET /llms.txt，由插件控制器实时读取缓存或现场生成，以 text/markdown; charset=utf-8 输出，不经过任何宿主模板
2. 数据来源：分类（communitycategory，status=1，按 sort 排序）、单页（communitypage，status=1，按 sort 排序）、主题（community_topic，status=1，按发布时间倒序）
3. 链接地址：主题 / 分类 / 页面链接均通过社区 FrontRoute 生成，自动适配自定义路径与伪静态后缀，并补全为完整绝对地址
4. 缓存：生成结果写入系统缓存（默认 30 分钟），后台「刷新缓存」会清除并立即重建
5. 发现标签：通过 renderAssets 钩子向全站前台注入 <link rel="alternate">，零侵入不修改社区模板

七、后台功能

大语言模型 → 预览 llms.txt：

• 实时生成并预览完整内容（不受缓存影响）
• 统计链接条数、总行数、文件大小与缓存状态
• 一键访问 /llms.txt、刷新缓存、复制全部内容

八、接口说明

GET /llms.txt

对外公开访问，无需登录。

响应：200 text/markdown; charset=utf-8，正文为符合 llmstxt.org 规范的 Markdown；插件停用时返回 404。

九、常见问题

Q：修改配置后 /llms.txt 没有变化？

内容有缓存（默认 30 分钟）。可到后台「大语言模型 → 预览 llms.txt → 刷新缓存」立即重建，或等待缓存到期。

Q：只想让 LLM 抓取部分内容？

在配置中取消勾选不需要的板块或主题类型；需要隐藏的主题在社区中设为隐藏（status=0）即可，插件只收录正常状态的内容。

Q：llms.txt 中的链接带不带域名？

全部输出完整绝对地址（自动取当前访问域名），符合 llmstxt.org 对链接的要求。

Q：卸载会影响社区数据吗？

不会。插件不创建任何数据表、不修改任何宿主文件，卸载仅删除后台菜单、静态资源与自身缓存。