清歌AI蜘蛛屏蔽

本插件按 User-Agent 做子串匹配（忽略大小写），在 Z-Blog 模板渲染之前判定，对命中拦截列表的请求直接返回，

不进入主题模板渲染流程，也不查询数据库。降低站点的无效请求与服务器负载。

随着各家的 AI 训练与检索蜘蛛大量抓取，站点上来自 GPTBot、ClaudeBot、Bytespider 这类 UA 的请求越来越多。 AI蜘蛛本身是为了让ai可以更好的回答用户的问题，却持续消耗带宽、CPU 与数据库资源，在配置不高的服务器上表现尤其明显。 本插件在请求最开始（模板渲染之前）完成判定，命中即直接返回，不查询数据库、不加载主题模板， 对正常访客与搜索引擎收录几乎没有影响。

主要功能：

1. 内置 31 条 UA 关键词：GPTBot、ChatGPT-User、OAI-SearchBot、Google-Extended、

   Google-CloudVertexBot、ClaudeBot、Claude-Web、Claude-SearchBot、anthropic-ai、cohere-ai、MistralAI-User、

   Bytespider、PetalBot、Applebot-Extended、CCBot、Meta-ExternalAgent、Meta-ExternalFetcher、PerplexityBot、

   Perplexity-User、YouBot、Amazonbot、Diffbot、DataForSeoBot、ImagesiftBot、AI2Bot、Timpibot、Webzio-Extended、

   omgilibot、FacebookBot、facebookexternalhit、img2dataset。该列表可在后台增删

2. 白名单独立维护，内置 Googlebot、Bingbot、Baiduspider、YisouSpider、Sogou web spider、Sogou Orion spider、

   360Spider、DuckDuckBot、YandexBot。白名单在拦截列表之前判断，命中则直接放行；两个列表均可在后台增删

3. 响应状态码与响应内容为两项独立设置

   · 状态码：403 或 200

   · 内容：内置拦截页（内容固定，不可编辑）/ 空白页 / 自定义模板

4. 自定义模板支持变量替换：{code} 状态码、{status} 状态短语、{site} 站点地址、{url} 请求网址、

   {ip} 访客 IP、{ua} 浏览器标识、{time} 当前时间

5. 可选择拦截不发送 User-Agent 的请求（默认关闭）

6. 拦截日志记录时间、IP、命中的关键词、完整 User-Agent；支持分页浏览（每页 50 / 100 / 200 / 500 条可选），后台显示今日与累计条数，可一键清空

7. 后台「预览效果」展示设定的响应状态码与响应内容

8. 后台单页双标签：拦截设置 / 拦截日志，顶部显示当前配置的条目统计

9. 停用时可选择一并清除配置与拦截日志

10. 静态资源均为本地引用，无外站资源、无第三方依赖

技术说明：

· 挂载 6 个前台 Begin 钩子（Index / ViewPost / ViewList / ViewAuto / Feed / Search）

· UA 匹配使用 stripos 子串匹配（忽略大小写），未使用正则

· 静态资源 URL 附带文件修改时间作为版本号

· 配置通过 $zbp->Config() 读写，未建表

适用范围与限制：

本插件的判定依据是请求的 User-Agent 字符串。User-Agent 由客户端自行发送，可以被伪造或省略，

因此本插件无法拦截伪造 UA 的请求，也不能替代服务器层（Nginx / 防火墙 / CDN）的访问控制。

三、效果截图