用途:在 Astro 站点中配置并校验 JSON-LD 结构化数据,使输出的实体与属性同页面可见内容一致。
主要能力:选择与真实内容匹配的 Schema.org 类型;用 @id 与稳定的绝对 URL 构建类型化对象;将 JSON 序列化后插入 script application/ld+json;分别校验 JSON 语法、Schema.org 词汇、与可见文本的事实对应关系以及搜索引擎要求;检查跨组件共享实体(尤其 publisher 与作者),避免重复冲突。
使用方式:读取可见内容、实体、稳定 ID 与 JSON-LD 序列化结果;若路径与示例不同,使用 .astrofy/config/paths.json 中定义的路径;在应用在线文档 API 前,核对 lockfile 与 node_modules 中的已安装版本;属性须源自与正文相同的来源;对插入 HTML script 的内容做转义;修改已有实现时,集中标记须保留已发布实体的 @id,去重但不得虚构评价、价格或作者;验证命令为 astrofy check --category structured,并在已发布的预览中核对。
适用场景:Astro 站点的结构化数据编写与审核。
限制:标题等含 script 结束标签的内容必须保持为 JSON-LD 文本;资料未提供安装命令、价格与平台信息。