@cogita/plugin-sitemap 在静态构建阶段生成标准的 sitemap.xml,帮助搜索引擎发现站点首页、文章页面和用户配置的其他公开路由。
插件只负责构建期数据收集和 XML 输出,不引入运行时虚拟模块,也不修改主题页面渲染。站点地图的绝对地址由 site.url 与 site.base 共同决定。
没有 sitemap 配置时插件返回 null,不改变现有零配置行为。配置启用后,如果没有 site.url,默认跟随 strict 让构建失败;非严格模式下只警告并跳过生成。
站点地图优先读取 core 注入的 ContentIndex,并复用共享的文章列表路由契约。由于 Rspress 插件的 beforeBuild 生命周期并行执行,站点地图不读取 virtual-posts-data,避免隐式依赖另一个插件的执行顺序。没有共享索引时仍保留独立扫描兜底。
site.url 提供域名和可能已有的部署路径。site.base 在 site.url 未包含部署路径时补充到 URL 中。posts.routePrefix 和文章文件路径。/about 这类站点路由,也支持完整的 HTTP(S) 地址。loc 去重并稳定排序。sitemap.xml。path 跳出构建输出目录。lastmod 只输出可解析的日期。priority 会限制在 0 到 1 之间。第一期不包含图片站点地图、多语言索引和 sitemap index。后续 SEO 插件可以复用站点地图的规范化 URL 工具;路由是否写入站点地图还会受主题布局能力约束,避免生成主题实际没有页面的 404 地址。