AI 补图片Alt标签

为什么 alt 值得单独做

• 无障碍：屏幕阅读器靠 alt 告诉视障用户这张图是什么；
• 图片搜索：Google 用 alt 理解图片与页面的关系；
• 内容完整性：装饰图、截图、产品图需要不同的 alt，不能全部空着。

WordPress 有一个坑：核心不会把媒体库里改过的 alt 自动注入正文里已经存在的 <img>。观象台插件在渲染期补上这一环——只补空，不覆盖手写值。

生成步骤

1. 进入单页审计

   内容审计 → 审计明细 → 找到「图片缺 alt」这条策略的证据。每条证据通常对应一张图。

2. 点「AI 填写」

   按钮在证据行右侧。工作台会先取这张图在页面上的紧邻文字，再调模型生成一句 alt。

3. 读建议

   看这句话是不是在描述「这张图在这段文字里起什么作用」。如果它写了具体画面细节（颜色、人物、界面元素），要提高警惕——模型看不到图，那些细节是猜的。

4. 采纳

   点「采纳」写入媒体库。页面会显示写入结果；成功后复采这一页，确认正文图片的 alt 变了。

5. 重新生成

   不满意就点「重新生成」，不要将就。alt 写错比空着更糟，因为它会误导屏幕阅读器和图片搜索。

一条好的 alt 长什么样

<img src="/dashboard.png" alt="">

<img src="/dashboard.png" alt="观象台数据总览：五个核心指标与搜索趋势">

描述这张图在页面里的作用，不堆关键词，不写「图片」「截图」这类废话。

写作规则：

• 一句话说清这张图展示了什么；
• 如果是截图，写「什么界面、看什么信息」；
• 如果是产品图，写「什么产品、什么角度 / 场景」；
• 如果是装饰图，正确做法是空 alt + aria-hidden，不要硬编一句；
• 不要以「SEO」「关键词」开头；
• 不要重复页面标题；
• 不要把所有图的 alt 写成同一句。

模型看到什么、看不到什么

这也意味着：

• 纯装饰图、氛围图，AI 很难写出有价值的 alt；
• 图里有关键信息（价格、型号、步骤），最好人工写；
• 需要精确描述产品外观时，人工写比 AI 可靠。

写到哪里、为什么有时前台没变

采纳写的是 WordPress 媒体库的 _wp_attachment_image_alt。前台是否能变，取决于：

1. 图片是不是通过媒体库插入的（正文里有 wp-image-N 类名）；
2. 正文里这张图原来的 alt 是不是空的（插件只补空）；
3. 主题 / 页面构建器有没有在输出时改写 alt。

如果前台没变，按这个顺序查。站外图、主题里手写的 <img>、没有附件 ID 的图，插件不会碰。

能不能撤销

界面不提供撤销。改错了重新生成一版再采纳，或去媒体库手动改。媒体库的 alt 是唯一来源，改完记得清缓存再看前台。

常见问题

为什么按钮只出现在部分图片上？

只有命中「图片缺 alt」的图才有这条证据。已经有 alt 的图不会重复出现。

为什么 AI 写的 alt 很笼统？

因为它看不到图。它只能根据上下文判断功能。需要更具体的描述，请人工写。

采纳后需要重新采集整站吗？

不需要。复采当前页就能确认正文输出；媒体库的 alt 是附件级字段，插件在渲染时读取。