Instant Indexer
当公开页面发生变化时，通知参与的搜索引擎。具体抓取哪些内容由各搜索引擎自行决定。
插件
Instant Indexer
当公开页面发生变化时，通知参与的搜索引擎。具体抓取哪些内容由各搜索引擎自行决定。
描述
Instant Indexer 会在公开页面被添加、修改或移除时通知参与的搜索引擎。具体抓取哪些内容由各搜索引擎自行决定。
变更
插件会在发布、实时编辑、下架、移入回收站和恢复时，把被纳入范围的公开条目加入队列。修改 slug 时，新旧两个 URL 都会入队。编辑通常在 30 到 90 秒后发送，在这个时间窗口内每个 URL 只发送一次。每个请求最多包含 1,000 个 URL。
草稿、尚未发布的定时条目、预览页和 noindex 页面不会被纳入。对于已知地址，在 noindex 变更后会发送移除通知。已入队的页面不会被重新检查；较早的通知可能先于 noindex 或下架通知到达。
发送功能默认关闭。关闭期间发生的变更不会入队。关闭发送会取消“全部提交”。等待中的 URL 会在下一次发送或每小时清理时被丢弃，即使之后又重新开启了发送。
设置与记录
在设置中选择内容类型和端点。需要一个根目录密钥文件 https:///.txt，其中只包含生成的密钥。也可以改为把该根路径重定向到插件的密钥路由；部分搜索引擎可能不会跟随重定向。
设置完成后，使用首页 URL 进行测试。返回 200 表示密钥验证通过；返回 202 表示正在等待密钥检查。启用发送后，使用“全部提交”把现有的公开页面加入队列，并记住它们的地址，以便后续发送移除通知。
编辑和管理员可以查看提交日志。管理员管理设置和提交。仪表盘会显示等待中和已发送的 URL 数量以及最近一次响应。
插件采用 MIT 许可证，无需账户、许可证密钥，也不收集遥测数据。
Instant Indexer 是 Peachfin Themes 开发的独立插件，与 IndexNow 或任何搜索引擎的运营方没有关联，也未获得其认可。
安装
要求
使用 EmDash 1.1 或更高版本，并带有沙盒运行器（Cloudflare：Workers Paid 和 Worker Loader 绑定；Node：workerd）。已在 EmDash 1.2.0 上测试。
安装
- 从插件注册表安装 Instant Indexer（
@peachfinthemes.com/instant-indexer）。 - 批准内容和模式的读取权限以及网络访问权限。“安全”一节列出了允许访问的主机。
- Instant Indexer 设置：EmDash 1.1：设置地址。1.2：先使用已配置的地址，然后是 Site URL，最后是设置。在 1.1 上修复设置；在 1.2 上，通过 Settings > General 中的 Change domain 使用配置或 Site URL（https；仅 localhost 可使用 http）。重启 Node；在 Workers 上，重新部署或等待新的隔离实例。Public site address (optional) 会覆盖协议、主机和端口。它不能替代缺失的 EmDash 地址；缺失时不会发送任何内容。
- 添加下文所述的根目录密钥文件。
- 开启 Send changes to search engines 并保存。发送关闭期间发生的变更不会入队。
- 选择 Test connection。返回 200 表示密钥验证通过。返回 202 表示正在等待密钥检查。如果一直如此，请检查根目录文件是否包含已保存的密钥并且可公开读取。
- 运行 Submit all published URLs now，把现有的公开页面加入队列，并记住它们的地址，以便后续发送移除通知。
关闭发送会取消“全部提交”。启用发送后请重新启动它。等待中的 URL 会在下一次发送或每小时清理时被丢弃，即使之后又重新开启了发送。
根目录密钥文件
安装时会生成一个随机密钥。在站点的 public/ 文件夹中添加 .txt 文件，内容只包含该密钥，然后部署。它必须能够通过 https:///.txt 读取。
也可以把 /.txt 重定向到同一站点上的 /_emdash/api/plugins/instant-indexer/key。部分搜索引擎可能不会跟随重定向。无论哪种方式，都需要根目录密钥路径。
更换密钥后，请更新根目录文件或重定向，并重新测试。
本地和测试地址会被拒绝。请在公开的预发布副本上保持发送关闭。
常见问题
它会发送什么？
Instant Indexer 使用 IndexNow 协议，在公开页面发生变化时通知参与的搜索引擎。具体抓取哪些内容由各搜索引擎自行决定。并非所有搜索引擎都参与。
测试是如何进行的？
Test connection 会发送一个包含首页 URL 的请求，并且从不重试。返回 200 表示密钥验证通过。返回 202 表示正在等待密钥检查。如果一直如此，请检查根目录密钥文件是否可公开读取并包含已保存的密钥。收到 429 或服务器错误时会暂停发送。暂停期间测试会被拒绝。
为什么需要根目录密钥文件？
密钥必须能通过 https:///.txt 获取，才能覆盖普通页面。该文件只能包含已保存的密钥。也可以改为把该路径重定向到插件的密钥路由，但部分搜索引擎可能不会跟随。如果收到 422 响应，请检查根目录文件，并确认页面 URL 使用相同的主机。
什么时候应该使用“全部提交”？
在启用发送之后运行它，以便把现有页面加入队列，并记住地址以供日后发送移除通知。未知的 URL 无法作为移除上报。被排除的内容类型会被跳过。关闭发送会取消本次运行；开启后请重新启动。等待中的 URL 会在下一次发送或每小时清理时被丢弃，即使之后又重新开启了发送。
发送失败时会怎样？
响应 400、403 和 422 会丢弃该批次。请修复原因，然后使用 Submit all published URLs now 重新把现有页面加入队列。对于 429、服务器错误和网络错误，已入队的 URL 会以递增的等待时间重试。会遵循 Retry-After，最长 7 天。每个队列行在失败 8 次后停止重试。新的编辑会让该 URL 重新入队。
在哪里可以获得帮助？
请访问支持页面。
安全
报告问题
在提交公开 issue 之前，请先通过私下方式向 [email protected] 报告安全问题。
权限
内容读取权限用于查找公开条目的 URL。模式读取权限用于识别 URL 模式和公开的内容类型。插件无法写入或发布内容。
网络访问
插件只能访问以下端点主机：
api.indexnow.orgwww.bing.comyandex.com
请求会发送到所选的端点，内容包括站点的主机名、密钥、密钥位置和公开页面的 URL。如果个人数据是地址的一部分，URL 中可能包含个人数据。没有遥测。
草稿、尚未发布的定时条目、预览页和 noindex 页面不会作为新页面入队。对于已知地址，在 noindex 变更后会发送移除通知。已入队的页面不会被重新检查；较早的通知可能先于 noindex 或下架通知到达。其他主机上的 URL 会被丢弃。
访问与密钥
编辑和管理员可以查看提交日志。管理员管理设置和提交。
需要一个可公开读取的根目录密钥文件 https:///.txt，其中只包含已保存的密钥。也可以把该路径重定向到 /_emdash/api/plugins/instant-indexer/key；部分搜索引擎可能不会跟随。插件会以纯文本、不缓存的方式提供其密钥路由。
存储的数据
站点会存储设置、密钥、等待中的 URL、记住的地址和日志。每次发送和每小时清理时，日志都会被裁剪到约 200 条；计数可能短暂偏高。每次发送最多写入 90 行，其余 URL 以汇总行表示。
卸载时会根据站点的卸载选项删除这些数据。
测试站点
地址缺失、本地地址和测试地址都会阻止发送。地址检查并不能证明站点是公开的或处于生产环境。发送功能默认关闭。请在公开的预发布副本上保持关闭。
更新日志
1.0.1 (2026-10-08)
已在 EmDash 1.2.0 上测试。更新了适用于 EmDash 1.2 的站点地址说明。插件的工作方式没有变化。
1.0.0 (2026-10-06)
在公开页面发生变化时，通过 IndexNow 通知参与的搜索引擎。具体抓取哪些内容由各搜索引擎自行决定。
- 发送功能默认关闭。关闭期间发生的变更不会入队。关闭发送会取消“全部提交”。等待中的 URL 会在下一次发送或每小时清理时被丢弃，即使之后又重新开启了发送。
- 对发布、实时编辑、下架、移入回收站和恢复的变更入队，修改 slug 后新旧两个 URL 都会入队。编辑通常在 30 到 90 秒后发送，每个窗口内每个 URL 只发送一次，每个请求最多包含 1,000 个 URL。
- 排除草稿、尚未发布的定时条目、预览页和 noindex 页面。对于已知地址，在 noindex 变更后会发送移除通知。已入队的页面不会被重新检查。
- 为参与的搜索引擎提供三个端点可供选择。
- 安装时生成一个随机密钥。需要由所有者提供根目录密钥文件。也可以把根目录密钥路径重定向到插件的密钥路由。返回 200 表示密钥验证通过；202 表示正在等待密钥检查。
- 从站点读取公开的 URL 模式、语言前缀和结尾斜杠设置。路径覆盖是可选的。
- “全部提交”每一步读取 90 个条目，并记住 URL 以便发送移除通知。取消在下一步生效；除非禁用了发送，已入队的 URL 仍会发送。
- 对速率限制、服务器错误和网络故障以递增的等待时间重试。Retry-After 最长适用 7 天。每个队列行在失败 8 次后停止重试。测试不会重试。
- 每次发送和每小时清理时，把日志裁剪到约 200 条。仪表盘会显示等待中和已发送的 URL 数量以及最近一次响应。
- 管理员控制设置和提交。内容和模式访问均为只读。网络访问仅限于声明的三个端点。
采用 MIT 许可证，无需账户、许可证密钥，也不收集遥测数据。