feat(seo): add h1 + BreadcrumbList and enrich BlogPosting schema on blog posts / 博客文章增加 h1 与 BreadcrumbList 并丰富 BlogPosting 结构化数据

[Oseltamivir]

Summary

Fixes two on-page / structured-data SEO gaps on blog posts.

1. Blog posts had no <h1>. The post title rendered as <h2>, and the MDX renderer maps markdown #→<h2> too — so posts shipped with no top-level heading carrying the primary keyword.

• Post title <h2> → <h1> (identical styling), on both EN and /zh pages.
• Exactly-one-<h1> verified: MDX mapper still maps #/##→<h2> (bodies emit no <h1>); no other <h1> in the blog subcomponents, layouts, header/footer; the Cypress post test now asserts cy.get('h1') has length 1 and contains the title.

2. BlogPosting JSON-LD was missing recommended Article fields, and posts had no BreadcrumbList (compare/glossary pages have one; blog posts didn't).

• BlogPosting gains image (per-post OG image URL), inLanguage (en-US / zh-CN), mainEntityOfPage, and publisher.logo (ImageObject, 1200×675).
• New BreadcrumbList (Home → Blog → post) emitted as a separate JSON-LD block, matching the compare-page pattern. /zh translated (首页 / 博客).
• Extracted pure builders buildBlogPostingJsonLd, buildBlogBreadcrumbJsonLd, buildBlogBreadcrumbJsonLdZh, blogOgImageUrl into blog.ts so they are unit-testable.

Testing

• pnpm typecheck ✅ · pnpm lint ✅ · pnpm fmt ✅
• pnpm test:unit: +20 new passing tests for the JSON-LD builders, 0 regressions. (Same 13 pre-existing, unrelated clean-tree failures as noted elsewhere — not touched here.)
• Single-<h1> guarantee covered by an updated Cypress e2e assertion (the blog page is an async RSC using compileMDX/fs/shiki, which the node-env vitest harness can't render).

Overlay support

Not applicable — blog-post on-page headings and structured data, no inference/evaluation chart-data path involved.

中文说明

修复博客文章的两处页面内 / 结构化数据 SEO 问题。

1. 博客文章此前没有 <h1>。 文章标题以 <h2> 渲染，且 MDX 渲染器把 Markdown # 也映射为 <h2>，因此文章缺少承载主关键词的顶级标题。

• 文章标题由 <h2> 改为 <h1>（样式不变），EN 与 /zh 两侧同步。
• 已验证页面仅有一个 <h1>：MDX 映射器仍把 #/## 映射为 <h2>（正文不产生 <h1>），博客子组件、布局、页头/页脚均无 <h1>；Cypress 文章测试现在断言 cy.get('h1') 数量为 1 且包含标题。

2. BlogPosting JSON-LD 缺少推荐的 Article 字段，且文章没有 BreadcrumbList（compare/glossary 页面有，博客文章没有）。

• BlogPosting 新增 image（每篇文章的 OG 图片 URL）、inLanguage（en-US / zh-CN）、mainEntityOfPage 与 publisher.logo（ImageObject，1200×675）。
• 新增 BreadcrumbList（首页 → 博客 → 文章），作为独立 JSON-LD 块输出，与 compare 页面模式一致；/zh 侧翻译为“首页 / 博客”。
• 将纯函数构建器 buildBlogPostingJsonLd、buildBlogBreadcrumbJsonLd、buildBlogBreadcrumbJsonLdZh、blogOgImageUrl 抽取到 blog.ts 以便单元测试。

测试：pnpm typecheck、pnpm lint、pnpm fmt 均通过；pnpm test:unit 新增 20 个通过用例，无回归。单一 <h1> 保证由更新后的 Cypress 端到端断言覆盖（博客页面是使用 compileMDX/fs/shiki 的异步 RSC，node 环境的 vitest 无法渲染）。叠加层（overlay）支持：不适用。

---

Note

Low Risk
SEO and markup-only changes on blog pages with no auth, data, or API behavior changes; risk is limited to heading semantics and structured-data shape.

Overview
Blog post pages now use a single <h1> for the post title (EN and /zh), replacing the previous <h2>, so the primary keyword sits in the page’s top heading while MDX body headings still render as <h2> and below. Cypress asserts exactly one h1 containing the title.

Structured data moves out of the page components into shared blog.ts helpers: BlogPosting JSON-LD gains image, inLanguage, mainEntityOfPage, and publisher.logo, and a separate BreadcrumbList block (Home → Blog → post, with a Chinese mirror) is emitted on both locales. 20 unit tests cover the builders.

^{Reviewed by Cursor Bugbot for commit 10f1b9a. Bugbot is set up for automated code reviews on this repo. Configure here.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
inferencemax-app	Ready	Preview, Comment	Jul 20, 2026 9:37am

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 2c296e4. Configure here.}