用途:让 TYPO3 页面用结构化数据准确描述其可见内容,从渲染页面的同一批记录生成一份连贯、可测试的实体图,避免维护第二套隐藏的编辑事实。适用于 TYPO3 14.3 项目的结构化数据审计、保留、实现与验证。
主要能力:先盘点现有 application/ld+json、Microdata/RDFa、schema 扩展、TypoScript/Fluid 产出者、页面类型与内容元素;再依据用户可见内容推导类型与属性,不虚构价格、库存、营业时间、作者、评价、评分、地址、职位、活动或 FAQ 答案。优先服务端渲染 JSON-LD,使用绝对规范 URL、稳定 @id、ISO-8601 日期、真实语言 URL 与可抓取图片,尽量把全局与页面实体放入一个相连的 @graph。
类型选择:站点身份用 Organization 或具体 LocalBusiness 子类型;普通页面用最具体的 WebPage 子类型;可见面包屑用 BreadcrumbList;博客/新闻详情用 Article 或 NewsArticle;编辑撰写的 FAQ 用 FAQPage;用户提问加用户回答用 QAPage;产品详情用 Product 加有效 Offer;活动详情用 Event;招聘用 JobPosting;食谱用 Recipe。
实现方式:保留已能产出正确实体图的项目专用产出者;需要抽象时优先使用兼容安装的 brotkrueml/schema API 与 Fluid ViewHelpers,并核对锁定安装中的 Composer 约束与类。按归属边界映射记录:Site 配置管全局身份,页面/根线管 WebPage 与面包屑,EXT:news 管文章,Content Blocks 或领域记录管 FAQ、产品、活动、职位、食谱、评价与媒体。使用单一序列化边界安全编码,禁止把编辑文本拼进 script 标签。多语言站点渲染翻译后的可见值与语言 URL。
验证与限制:对每个受影响页面类抓取最终 HTML、提取全部 JSON-LD,无恢复解析,要求对象/数组根、https://schema.org 上下文、已知类型属性、稳定唯一身份、绝对 URL、无矛盾重复;与可见页面及权威记录比对名称、问答、价格、评分、日期、地址、库存、图片与链接;用 Schema.org Validator 验证整图,Google Rich Results Test 仅用于当前支持的 Google 功能类型。不承诺排名、知识面板、星级或富结果。FAQ 富结果目前仅限知名权威政府与健康站点,HowTo 富结果支持已移除。规范 URL、hreflang、meta、站点地图与 robots 由 typo3-seo 负责;可见 FAQ/产品/活动/职位/食谱模型由 typo3-content-blocks 负责;非 TYPO3 站点用通用 schema 技能。本技能不部署、不请求索引。