一、插件背景：为什么要用 IndexNow？
在传统的搜索引擎收录模式中，网站在发布新文章后，需要等待搜索引擎爬虫主动来抓取，这个过程短则几小时，长则数天甚至数周。对于内容更新频繁的网站来说，这种等待无疑是 SEO 优化的瓶颈。
IndexNow 是由微软必应（Bing）联合其他搜索引擎推出的一项开放协议。它的核心理念很简单：当网站内容发生变更时，由网站主动通知搜索引擎，搜索引擎收到通知后立即对该 URL 进行抓取和索引。这大大缩短了从内容发布到被搜索引擎收录的时间差。
据微软官方数据，使用 IndexNow 协议的网站，其内容被必应收录的速度相比传统方式提升了数倍。而且 IndexNow 是一个开放标准，参与该协议的搜索引擎都会受益，真正做到"一次通知，多引擎收录"。
使用 IndexNow 推送，站长可以在文章发布后主动"告诉"必应来抓取，不再是被动等待爬虫上门。
二、插件简介
「必应IndexNow推送」是一款专为迅睿CMS打造的插件，由 白马号博客 开发维护。插件提供两种推送方式：手动推送单个 URL 和 批量推送全部已发布文章，让站长在需要时主动将网站内容推送到必应 IndexNow 接口。
插件完全遵循迅睿CMS的【App】应用开发规范，安装简单，配置便捷，开箱即用。
插件名称：必应IndexNow推送 (BingIndexNow)
开发者：白马号博客
当前版本：v1.0.0
兼容环境：迅睿CMS 4.x / 3.x，PHP >= 7.2（需 cURL 扩展）
协议标准：IndexNow 开放协议
三、功能详解
手动推送——想推哪条推哪条
在插件后台的推送看板页面，站长可以直接输入任意 URL 进行即时推送：
输入要推送的完整文章链接
点击「手动推送」按钮
插件立即向 IndexNow 接口发送推送请求
推送结果实时反馈，成功或失败一目了然
这种方式特别适合以下场景：
网站刚完成改版，需要推送重要页面
只想推送某几篇特定文章，而非全站
推送失败后手动补推
临时测试推送功能是否正常
2. 批量推送——一键提交全站内容
对于新安装插件的网站，已有的历史文章也需要推送到搜索引擎。如果一条条手动推送，工作量巨大。插件的「批量推送所有文章」功能完美解决这个问题：
在推送看板点击「批量推送所有文章」按钮
插件自动遍历网站所有已安装的模块（内容模型）
智能探测各模块的数据表结构，兼容单站点和多站点部署模式
按模块逐批读取已发布的文章（每次 100 条），自动生成 URL 并推送
推送完成后汇总展示成功和失败的数量
整个流程全自动执行，站长只需点击一次按钮即可。不管网站有几百篇文章还是上万篇文章，都能一次性提交给必应搜索引擎。
3. 推送看板——数据一目了然
插件提供了直观的可视化统计看板，展示：
推送总数：累计推送的 URL 数量
成功数：推送成功的 URL 数量
失败数：推送失败的 URL 数量
成功率：以百分比形式展示，方便评估推送健康度
最近推送：最近一次推送的 URL、时间及状态
密钥文件状态：实时显示 IndexNow 密钥验证文件是否就绪
站长只需看一眼看板，就能掌握整个推送系统的运行状态。
4. 推送日志——全程可追溯
每一次推送操作都会被详细记录到数据库日志表中，包含以下字段：
| 字段 | 说明 |
|---|---|
| URL | 推送的文章链接 |
| 所属模块 | 文章所属的内容模块 |
| 内容ID | 文章在系统中的唯一标识 |
| 推送状态 | 成功/失败 |
| HTTP状态码 | IndexNow 接口返回的 HTTP 响应码 |
| 响应内容 | 接口返回的详细响应信息 |
| 推送时间 | 精确到秒的时间戳 |
| 错误信息 | 失败时的具体错误描述 |
日志列表支持按状态筛选（全部/成功/失败）和分页浏览，方便站长快速定位推送失败的记录，也方便后续重试。
5. 失败重试——不遗漏任何一次推送
网络波动或接口临时不可用都可能导致推送失败。插件提供了「重新推送」功能：
在日志列表中找到推送失败的记录
点击该记录操作栏的「重新推送」按钮
插件会重新向 IndexNow 接口发送该 URL
推送完成后自动更新该条日志的状态、HTTP 码和响应内容
一键重试，简单高效，确保每一条内容都能送达必应搜索引擎。
6. 密钥文件管理——符合协议规范
IndexNow 协议要求申请者提供一个可公开访问的密钥验证文件。插件内置了密钥文件管理功能：
在参数设置页面填写自定义 API Key
点击「生成密钥文件」，插件自动在站点根目录创建
{api_key}.txt文件文件内容即为 API Key 本身，符合 IndexNow 协议的验证要求
密钥文件状态在看板上实时显示，未生成时会有醒目提示
7. 版本日志——更新历史可查
插件内置了版本日志页面，展示每个版本的更新内容、发布时间等信息，方便站长了解插件的迭代情况。
四、安装与配置指南
安装步骤
方法一：手动安装
将插件目录
Bingindexnow完整复制到迅睿CMS的dayrui/App/目录下登录迅睿CMS后台 → 应用管理 → 未安装
找到「必应IndexNow推送」，点击「安装」按钮
系统会自动执行 SQL 安装脚本，创建推送日志表等必要数据结构
方法二：应用市场安装（待上架）
配置步骤
安装完成后，进入「必应IndexNow推送 → 参数设置」页面进行配置：
Step 1：填写 API Key
API Key 是一个自定义的密钥字符串，建议使用 UUID 或随机字符串
例如：
7f4927b1193adaf556c65dsadAPI Key 将同时作为密钥验证文件的名称和内容
Step 2：填写站点 URL
填写网站完整的首页地址
例如：
https://www.example.com注意带协议头（https://），结尾不要加斜杠
Step 3：设置推送超时
默认为 5 秒
可根据服务器网络状况在 1~30 秒之间调整
Step 4：启用插件
勾选「启用插件」
点击「保存设置」
Step 5：生成密钥文件
保存设置后，点击「生成密钥文件」按钮
验证文件是否可访问：访问
https://你的域名/{api_key}.txt浏览器应直接显示 API Key 字符串内容
Step 6：验证配置
回到推送看板，确认密钥文件状态显示为绿色「已就绪」
尝试手动推送一个 URL 测试是否正常
五、插件优势
对迅睿CMS开发者的价值
完全遵循官方规范：插件严格按照迅睿CMS的 App 应用开发规范编写，目录结构、控制器、模型、钩子、配置、语言包等一应俱全，是学习迅睿CMS插件开发的优秀参考案例
代码质量高：采用面向对象设计，模型层与控制器层分离，逻辑清晰，异常处理完善
兼容性好：同时支持迅睿CMS 4.x 版本，兼顾单站点和多站点部署模式
对站长的价值
零成本提升 SEO：只需简单配置，即可手动将网站内容推送给必应搜索引擎
操作简单：手动推送只需输入 URL 点击按钮，批量推送只需点击一次
数据透明：推送看板和日志让每一次推送都有据可查
全面覆盖：手动单条推送 + 批量全站推送，满足不同使用场景
六、使用场景建议
日常更新：每发布一篇重要文章，进入推送看板手动推送该文章 URL
新站上线：网站刚上线时，使用批量推送功能将全站文章一次性提交给必应
内容改版：网站改版后 URL 发生变化时，批量推送全站文章通知搜索引擎更新
定期维护：定期批量推送全站文章，确保搜索引擎索引保持最新状态
七、注意事项
密钥文件必须可访问：IndexNow 协议要求密钥文件能够通过 HTTP/HTTPS 公开访问，请确保文件权限和服务器配置正确
仅推送已发布文章：插件只处理状态为"已发布"的文章，草稿或待审核状态的文章不会进入推送队列
批量推送注意超时：对于文章数量较多的网站，批量推送可能需要较长时间，插件已设置 300 秒超时限制，请确保在推送过程中不要关闭浏览器
八、协议说明
IndexNow 是必应、Yandex 等搜索引擎共同支持的一项开放标准。其核心 API 非常简单，只需要一个 HTTP POST 请求即可通知搜索引擎：
POST https://api.indexnow.org/IndexNowContent-Type: application/json{
"host": "www.example.com",
"key": "7f4927b1193adaf556c65dsad",
"keyLocation": "https://www.example.com/5ebbd3239ac3406b951417f4927b1193.txt",
"urlList": [ "https://www.example.com/article/123.html" ]
}参与 IndexNow 协议的搜索引擎会在收到通知后尽快抓取并索引指定的 URL，大幅缩短收录周期。
九、版本历史
v1.0.0（2026-06-27）
初始发布版本
实现手动推送、批量推送、推送看板、推送日志、参数设置等核心功能
支持推送失败一键重试
内置密钥文件生成与管理
十、关于开发者
本插件由 白马号博客 开发并维护。我们专注于迅睿CMS生态的插件开发与技术分享，致力于为迅睿CMS用户提供高质量、易用、稳定的扩展工具。
如果你在使用过程中遇到任何问题，或者有功能建议，欢迎通过博客与我们联系。
「必应IndexNow推送」—— 主动推送，让迅睿CMS网站的内容被必应搜索引擎快速发现。