从扫描到验证修复

一次扫描发现演示文章缺少描述。我们在 Filament 中添加描述，再次扫描，并生成显示修复结果的报告。

这些画面来自 2026 年 9 月 9 日运行中的本地 Merchant 演示。内容是预置示例数据，两次扫描和报告都专门为本演练生成，没有预填历史趋势。应用使用 Laravel 12、Filament 4，以及 Rankbeam 核心、免费编辑器和 Pro 引擎。

下载生成的报告，PDF，98 KB

扫描已注册页面

安装 Pro并注册扫描目标后，运行：

php artisan seo-pro:scan --sync

演示注册了 18 条内容记录和三个路由。第一次扫描完成全部 21 个目标，没有失败，发现 20 个问题：六个警告和 14 个提示。

截图以 2× 分辨率捕获，打开即可按完整尺寸查看。

检查一个问题

在 SEO Dashboard 中，点击受影响行旁的 Page issues。对于“Behind the Scenes: Our Product Photography”，问题详情指出缺失的 description、页面网址，以及检测到它的扫描。

保存描述

在 Posts 中打开文章，填写 SEO description 并保存。免费 Filament 编辑器在搜索预览中显示输入文本，并将来源标为 Manual。本例的描述为 142 个字符，标题仍来自文章。

保存字段与验证修复是两个步骤，扫描评分在下次扫描后才更新。不使用 Filament 时，可以通过模型的 `saveSEO()` 方法保存同一个值。

重新扫描并检查变化

再次运行同一命令：

php artisan seo-pro:scan --sync

现在仪表板将这个具体问题标为 Fixed，其他 19 个问题仍未解决。

检查项	修复前	修复后
已完成目标	21	21
未解决问题	20	19
警告	6	5
提示	14	14
平均技术 SEO 评分	92	93

评分反映 Rankbeam 的技术检查，不测量流量、搜索排名或是否出现在 AI 回答中。描述检查通过，也不保证搜索引擎会显示该描述。

生成报告

本次演示在编辑文章之前生成了一份基线报告，然后在重新扫描后生成第二份报告：

# After the first scan, before making changes:
php artisan seo-pro:report --output=storage/app/seo-reports/baseline.pdf

# After saving the fix and rescanning:
php artisan seo-pro:report --output=storage/app/seo-reports/after-fix.pdf

第二份 PDF 显示一个已修复、零个新增和 19 个未解决问题。趋势只包含上面两次扫描。Search Console 和 AI 机器人日志均已关闭，因此对应部分说明数据不可用。

第一份报告建立比较基线。如果只在修复页面后生成一份报告，就无法展示相对于更早报告的变化。需要不推进基线的预览时，使用 --no-store。

示例使用 Browsershot 渲染器。渲染器要求、品牌设置和定时发送见白标报告。

在自己的应用中运行

从安装 Pro开始，再扫描一个你可以检查输出的页面。Pro 也能不依赖 Filament运行。若想先尝试免费元数据渲染器，可以使用 Docker 演示。