fixing-metadata

工作流程

1. 识别缺少或元数据不正确的页面（标题、描述、规范、OG标签）
2. 根据下面的优先级规则进行审计——先修复关键问题（重复、索引）
3. 确保标题、描述、规范和og:url彼此一致
4. 在真实URL（而非localhost）上验证社交卡片渲染是否正确
5. 保持差异最小化且仅限于元数据——不要重构无关代码

何时应用

在以下情况下参考这些指南：

• 添加或更改页面标题、描述、规范、机器人指令
• 实现Open Graph或Twitter卡片元数据
• 设置网站图标、应用图标、清单、主题色
• 构建共享SEO组件或布局元数据默认值
• 添加结构化数据（JSON-LD）
• 更改区域设置、替代语言或规范路由
• 发布新页面、营销页面或可分享链接

按优先级分类的规则类别

优先级	类别	影响
1	正确性和重复	关键
2	标题和描述	高
3	规范和索引	高
4	社交卡片	高
5	图标和清单	中
6	结构化数据	中
7	区域设置和替代	低-中
8	工具边界	关键

快速参考

1. 正确性和重复（关键）

• 每个页面只在一个地方定义元数据，避免冲突系统
• 不要发出重复的标题、描述、规范或机器人标签
• 元数据必须是确定性的，没有随机或不稳定的值
• 转义和清理任何用户生成或动态字符串
• 每个页面必须有安全的标题和描述默认值

2. 标题和描述（高）

• 每个页面必须有标题
• 在整个站点中使用一致的标题格式
• 保持标题简短可读，避免堆砌关键词
• 可分享或可搜索的页面应有元描述
• 描述必须是纯文本，无Markdown或引号滥用

3. 规范和索引（高）

• 规范URL必须指向页面的首选URL
• 仅对私有、重复或非公开页面使用noindex
• 机器人元标签必须与实际访问意图匹配
• 预览或暂存页面在可能的情况下默认使用noindex
• 分页页面必须有正确的规范行为

4. 社交卡片（高）

• 可分享页面必须设置Open Graph标题、描述和图片
• Open Graph和Twitter图片必须使用绝对URL
• 优先使用正确的图片尺寸和稳定的宽高比
• og:url必须与规范URL匹配
• 使用合理的og:type，通常是website或article
• 适当设置twitter:card，默认使用summary_large_image

5. 图标和清单（中）

• 至少包含一个跨浏览器可用的网站图标
• 在相关时包含apple-touch-icon
• 清单必须有效并在使用时引用
• 有意设置theme-color以避免UI chrome不匹配
• 图标路径应稳定且可缓存

6. 结构化数据（中）

• 除非明确映射到真实页面内容，否则不要添加JSON-LD
• JSON-LD必须有效并反映实际渲染的内容
• 不要虚构评分、评论、价格或组织详情
• 除非必要，每个页面优先使用一个结构化数据块

7. 区域设置和替代（低-中）

• 正确设置html lang属性
• 存在本地化时设置og:locale
• 仅当页面真实存在时添加hreflang替代
• 本地化页面必须按区域设置正确规范化

8. 工具边界（关键）

• 优先最小化更改，不要重构无关代码
• 除非要求，不要迁移框架或SEO库
• 遵循项目现有的元数据模式（Next.js metadata API、react-helmet、手动head等）

审查指南

• 先修复关键问题（重复、规范、索引）
• 确保标题、描述、规范和og:url一致
• 在真实URL（而非localhost）上验证社交卡片
• 优先使用稳定、简单的元数据，而非巧妙或动态的
• 保持差异最小化且仅限于元数据