freehire 分级 Open Graph 卡片实战:静态品牌图、公司 OG 端点与共享渲染原语

原创2026-10-24 14:50:522,189 阅读
文章标签:后端前端搜索引擎网页爬虫数据工程AI 应用可观测性

freehire 分级 Open Graph 卡片实战:静态品牌图、公司 OG 端点与共享渲染原语

本文以 freehire 仓库中的 og-brand-cards 变更任务清单为主线,完整还原一次"从只有职位页有分享图"到"全站默认品牌预览 + 公司页专属预览"的前端工程改造。读完你将掌握:satori + resvg 的 PNG 生成链路如何抽象成单一渲染入口、三张卡片如何共享一套品牌原语而不发生样式漂移、公司 OG 端点如何在保证 404 语义与降级策略的同时并发读取活数据,以及如何用免依赖脚本对整条链路做 RED→GREEN 验证。

一、改造前的现状与目标

变更提案 proposal.md 把问题描述得很直接:站点已有一条 per-job 的 OG 流水线,src/lib/server/og/{card,render,fonts,logo}.ts 通过 satori → resvg 渲染职位卡片,由 GET /jobs/:slug/og.png 提供;但 Seo.svelte 只在页面显式传入 image 属性时才输出 og:image,而全站只有职位详情页这么做。结果是首页、公司页、榜单页、营销页被分享时都只是一张纯文字卡。

设计文档 design.md 给出的目标是三条:

  • 每个页面默认都拿到品牌化的链接预览;
  • 公司页拿到"以 logo 为主角"的品牌预览;
  • 职位卡、公司卡、品牌卡共享同一套品牌语汇,且结构上无法漂移。

明确的非目标同样重要,它划定了这次改造的边界:

非目标 原因(来自 design.md)
不做动态首页 OG 端点 品牌卡内容基本固定,提交一张静态 PNG 零运行时成本,图上的数字按需重新生成
不使用 emoji 国旗 这里的 satori 没有 emoji 字体,总部信息通过 countryLabel 以文本呈现
不涉及 Go/后端/数据库/API 改动 整次改造只发生在前端 web/(SvelteKit)层

二、三层覆盖模型:卡片选择就是"页面传了哪个 image"

整个方案的核心抽象非常轻:不引入路由级判断逻辑,而是三层图片,逐层覆盖。

第一层  静态品牌图    web/static/og.png              → 全站默认 <origin>/og.png
第二层  职位卡        /jobs/:slug/og.png(改造前已存在) → 职位详情页覆盖
第三层  公司卡        /companies/:slug/og.png(本次新增) → 公司详情页覆盖

对应到代码里,"选择哪一层"就等价于页面传给 <Seo> 的 image 属性是什么,默认值在组件内部兜底。这条设计让新增第四层(例如博客卡、贡献者卡,仓库中已分别有 web/src/lib/server/og/blog.ts 与 web/src/lib/server/og/contributor.ts)时无需改动任何路由分发逻辑。

改造后新增与修改的文件按职责可分为四类,与任务清单的章节一一对应:

类别 文件 职责
共享原语 shared.ts 尺寸常量、转义、monogram、品牌 mark、logo 方块、chip、页脚
渲染核心 render.ts renderMarkupPng 单一渲染入口 + 职位卡薄包装
卡片构建器 card.ts、company.ts、brand.ts 纯函数:实体 → HTML 字符串
端点与元数据 companies/[slug]/og.png/+server.ts](web/src/routes/companies/[slug]/og.png/+server.ts)、[Seo.svelte HTTP 响应、缓存头、og:image 输出
生成与验证 og-render.mjs、og-smoke.mjs、gen-og.mjs、og.png 免依赖脚本与提交的静态资产

三、任务 1:把品牌原语抽到 og/shared.ts

改造前的痛点是品牌 mark 的 base64、chip 样式、页脚布局散落在 card.ts 内部;一旦新增公司卡和品牌卡,就会出现三份 base64 blob 和三套样式副本,样式必然漂移。因此第一步是"行为逐字对齐"的抽取。

shared.ts 顶部导出的第一组内容是画布尺寸与转义:

export const OG_WIDTH = 1200;
export const OG_HEIGHT = 630;

export function esc(s: string): string {
  return s
    .replace(/&/g, '&amp;')
    .replace(/</g, '&lt;')
    .replace(/>/g, '&gt;')
    .replace(/"/g, '&quot;');
}

品牌 mark 以 base64 data-URI 内联,注释说明了原因:satori 无法抓取远程图片,只有内联才能被嵌入:

const MARK_SVG =
  '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">' +
  '<path fill-rule="evenodd" clip-rule="evenodd" d="M256 56C366.457 56 ..." fill="#0a0a0a"/>' +
  '</svg>';
export const MARK_DATA_URI = `data:image/svg+xml;base64,${Buffer.from(MARK_SVG).toString('base64')}`;

参数化 logo 方块与 monogram 降级

任务清单里的签名是 logoBox(logo, name, size)(参数化尺寸、圆角与字号按比例缩放、monogram 兜底)。当前源码在此之上又多了一个 shape 参数,用于区分"实体的标记"和"人的头像":

export function logoBox(
  logo: string | null,
  name: string,
  size: number,
  shape: 'tile' | 'circle' = 'tile',
): string {
  const radius = shape === 'circle' ? '50%' : `${Math.round(size / 5)}px`;
  if (logo) {
    const fit = shape === 'circle' ? 'cover' : 'contain';
    return `<img src="${esc(logo)}" style="width:${size}px;height:${size}px;border-radius:${radius};object-fit:${fit}" />`;
  }
  const font = Math.round(size * 0.42);
  return (
    `<div style="display:flex;align-items:center;justify-content:center;width:${size}px;height:${size}px;` +
    `border-radius:${radius};background:#f4f4f4;color:#525252;font-size:${font}px;font-weight:700">` +
    `${esc(monogram(name))}</div>`
  );
}

这里有三个值得记住的实现细节:

  1. 圆角与字号随尺寸比例缩放:radius = round(size / 5)、font = round(size * 0.42)。以 72px 代入恰好得到原职位卡的 radius 14 / font 30,所以抽取过程对既有职位卡是像素级兼容的。
  2. object-fit 随语义切换:实体的 logo 用 contain(被裁边的 logo 就是坏 logo),人的头像用 cover(填满圆形)。
  3. satori 从 style 读图片尺寸,而不是 HTML 的 width/height 属性——写在 style 里才生效。

monogram 是模块内私有函数:取一到两个大写首字母,单词只有一个时截前两位,名字为空时返回 ?。

chip 与统一页脚

export type Chip = { text: string; muted?: boolean };

export function chipMarkup(chip: Chip): string {
  const style = chip.muted
    ? 'display:flex;align-items:center;color:#a3a3a3;font-size:24px;font-weight:500;padding:8px 4px'
    : 'display:flex;align-items:center;background:#f4f4f4;color:#171717;font-size:24px;font-weight:500;border-radius:999px;padding:9px 18px';
  return `<div style="${style}">${esc(chip.text)}</div>`;
}

muted 变体专门服务于职位卡上的 +N 溢出技能计数(见 card.ts 中 skills.length - SKILL_LIMIT 的逻辑)。

brandFooter() 是所有卡片共同的收尾行:左侧 mark + wordmark,右侧站点域名 freehire.me。任务 1.1 明确要求"从 card.ts 逐字搬移行为",任务 1.2 则要求 card.ts 改为从 shared.ts 导入、删掉本地副本,且 buildCard 的输出除 logo 尺寸外保持字节一致——这种"先等价重构、再改行为"的顺序,是让后续验证(渲染冒烟)失败时能立刻定位是重构问题还是新功能问题的关键。

四、任务 2:renderMarkupPng —— 唯一的渲染路径

改造前的 render.ts 只认识 Job 类型。为了让公司卡和品牌卡也能复用同一套 satori/resvg 代码,这里新增了一个通用原语:

export async function renderMarkupPng(markup: string, fonts: OgFont[]): Promise<Uint8Array<ArrayBuffer>> {
  const svg = await satori(html(markup), { width: OG_WIDTH, height: OG_HEIGHT, fonts });
  const png = new Resvg(svg, { fitTo: { mode: 'width', value: OG_WIDTH } }).render().asPng();
  const out = new Uint8Array(png.byteLength);
  out.set(png);
  return out;
}

export async function renderCardPng(job: Job, opts: { fonts: OgFont[]; logo: string | null }) {
  return renderMarkupPng(buildCard(job, { logo: opts.logo }), opts.fonts);
}

三个设计取舍写在文件头注释里:

  • 不导入任何 SvelteKit 运行时($app/*),因此既能跑在 SSR 端点里,也能被裸 Node 脚本直接加载;
  • 字体加载与 logo 抓取各自独立成模块,render.ts 保持为输入的纯变换;
  • 返回类型被刻意转成 Uint8Array<ArrayBuffer>:resvg 返回的是 Node Buffer(底层是 Uint8Array<ArrayBufferLike>),在端点里直接当 BodyInit 会不满足 Web 类型约束,所以拷贝进一个普通 ArrayBuffer 支撑的视图。这段注释是典型的"类型系统逼出来的正确实现",照抄它的价值高于照抄签名。

五、任务 3:职位卡 logo 从 72px 放大到 96px

这一条在提案里被标注为"实现层打磨,不改变 spec 级行为"。改动就是把 card.ts 的常量改为 96 并切换到共享的 logoBox / brandFooter:

const SKILL_LIMIT = 3;
const LOGO_SIZE = 96;
const TITLE_LINE_CLAMP = 3;

export function buildCard(job: Job, opts: { logo: string | null }): string {
  const titleSize = titleFontSize(job.title);
  const chipRow = chips(job).map(chipMarkup).join('');
  return `
<div style="display:flex;flex-direction:column;justify-content:space-between;width:${OG_WIDTH}px;height:${OG_HEIGHT}px;padding:64px 72px;background:#ffffff;color:#0a0a0a;font-family:Inter">
  <div style="display:flex;align-items:center;gap:20px">
    ${logoBox(opts.logo, job.company, LOGO_SIZE)}
    <div style="display:flex;font-size:28px;font-weight:600;color:#404040;overflow:hidden">${esc(job.company)}</div>
  </div>
  <div style="display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:${TITLE_LINE_CLAMP};text-overflow:ellipsis;overflow:hidden;font-size:${titleSize}px;font-weight:700;letter-spacing:-0.03em;line-height:1.05">${esc(job.title)}</div>
  <div style="display:flex;flex-wrap:wrap;gap:12px">${chipRow}</div>
  ${brandFooter()}
</div>`.trim();
}

配套的 titleFontSize() 把标题长度映射到 64/52/42/34/30 五档字号,再用 -webkit-line-clamp: 3 兜底最多三行——这是在没有图片裁剪能力的前提下控制排版溢出的实用手段。chip 的优先级顺序固定为:工作形态 → 职级 → 薪资 → 前三个技能 → +N。

六、任务 4:公司 OG 卡片与 GET /companies/:slug/og.png

6.1 卡片构建器 buildCompanyCard

company.ts 是一个纯同步函数:实体 + 已解析的 logo + 开放职位数 → HTML 字符串。它不发起任何 I/O,因此可以被冒烟脚本直接调用。

const LOGO_SIZE = 140;
const jobsFmt = new Intl.NumberFormat('en');

function openJobsLabel(n: number): string {
  return `${jobsFmt.format(n)} open ${n === 1 ? 'job' : 'jobs'}`;
}

function chips(company: Company): Chip[] {
  const out: Chip[] = [];
  const industry = company.industries?.[0];
  if (industry) out.push({ text: industry });
  if (company.hq_country) out.push({ text: countryLabel(company.hq_country) });
  return out;
}

内容层次与 spec 的"Company card content"要求严格对应:

区域 数据来源 缺省行为
Hero logo logoBox(logo, name, 140) 解析失败 → monogram 方块
公司名 company.name,56px / 700 必填
开放职位数 openJobs,Intl.NumberFormat 千分位分组 0 也照常显示 "0 open jobs"
Tagline company.tagline?.trim() 空或纯空白 → 整块省略
Chips industries[0] + countryLabel(hq_country) 缺失项直接不产生 chip

countryLabel 位于 facets.ts,用平台 Intl 的 regionNames 把 US 这类代码转成可读国家名,异常时回退为大写代码——这正是不使用 emoji 国旗时总部信息的呈现方式。

6.2 端点实现:并发、404 语义与降级

export const GET: RequestHandler = async ({ params, fetch }) => {
  const api = serverApi(fetch);

  const openJobsFacets = new URLSearchParams({ company_slug: params.slug });
  const openJobsPromise = api.searchJobs(openJobsFacets, 1, 0);

  let company;
  try {
    ({ company } = await api.getCompany(params.slug, 1, 0));
  } catch (e) {
    openJobsPromise.catch(() => {});
    if (e instanceof ApiError && e.status === 404) error(404, 'Company not found');
    throw e;
  }

  const [openJobsSlice, fonts, logo] = await Promise.all([
    openJobsPromise,
    loadOgFonts(),
    resolveLogo(company.name),
  ]);

  const png = await renderMarkupPng(
    buildCompanyCard(company, { logo, openJobs: openJobsSlice.total ?? 0 }),
    fonts,
  );

  return new Response(png, {
    headers: {
      'content-type': 'image/png',
      'cache-control': 'public, max-age=3600, stale-while-revalidate=86400',
    },
  });
};

这段 40 行左右的代码里有四个容易被忽略的工程决策:

  1. 职位数查询提前启动。searchJobs 只需要 slug,不依赖实体,所以在 getCompany 之前就发起,与实体读取并行——与公司详情页 loader 的做法一致。
  2. 404 分支要"回收"在途 Promise。如果公司不存在,先 openJobsPromise.catch(() => {}) 标记为已处理,避免 Node 报 unhandled rejection,然后才 error(404)。这是 image 端点特有的坑:图片端点没有额外渲染层来兜住异常。
  3. 数据与页面同源。计数走 searchJobs({company_slug: slug}, 1, 0).total,与公司详情页同一读路径,所以卡片上的数字不会和页面上的数字打架。
  4. 缓存策略。public, max-age=3600, stale-while-revalidate=86400,与职位端点在 jobs/[slug]/og.png/+server.ts 中完全一致:公司事实变化慢,爬虫也很少重取。

6.3 Logo 解析:失败绝不影响渲染

resolveLogo 位于 logo.ts,注释直接点明 satori 不能抓远程图,因此必须先服务端取回、转 data-URI:

const TIMEOUT_MS = 2500;

export async function resolveLogo(company: string): Promise<string | null> {
  const url = companyLogoUrl(company);
  if (!url) return null;
  try {
    const res = await fetch(url, { signal: AbortSignal.timeout(TIMEOUT_MS) });
    if (!res.ok) return null;
    const bytes = Buffer.from(await res.arrayBuffer());
    if (bytes.length === 0) return null;
    const type = res.headers.get('content-type') || 'image/png';
    return `data:${type};base64,${bytes.toString('base64')}`;
  } catch {
    return null;
  }
}

所有失败路径(无 URL、非 2xx、空响应体、超时、网络异常)都收敛为 null,由 logoBox 走 monogram 分支。这就是 spec 中"logo resolution failure SHALL NOT fail the image render"的落地方式:降级发生在数据层,而不是渲染层。

6.4 挂到页面元数据上

公司详情页只需在原有 <Seo> 上补一个绝对 URL:

<Seo
  ...
  image={`${origin}/companies/${data.slug}/og.png`}
/>

同目录下的招聘子页 companies/[slug]/hiring/+page.svelte 也复用同一张公司卡(image={origin{origin}{companyHref}/og.png}),这是"一层覆盖多路由"的收益。

七、任务 5:静态品牌卡与 scripts/gen-og.mjs

品牌卡不走端点,而是构建期生成、把 PNG 提交进仓库。理由写在 brand.ts 与 gen-og.mjs 的头注释里:卡片内容基本固定(标题 + 烘焙进图的目录规模数字),静态资产请求时零成本,且它就是所有没有专属预览的页面的默认值。

brand.ts 的 buildBrandCard({ stats }) 接受 BrandStat[]({ value, label })并渲染三段式布局:左上 mark + wordmark 与右上域名、居中的大标题、底部等宽间距的数据条。

export type BrandStat = { value: string; label: string };

function statMarkup(stat: BrandStat): string {
  return (
    `<div style="display:flex;flex-direction:column">` +
    `<div style="display:flex;font-size:52px;font-weight:700;letter-spacing:-0.02em">${esc(stat.value)}</div>` +
    `<div style="display:flex;font-size:24px;color:#a3a3a3">${esc(stat.label)}</div>` +
    `</div>`
  );
}

生成脚本用 Vite 的 SSR loader 直接加载 TypeScript 源码,无需新增依赖:

const STATS = [
  { value: '3.3M+', label: 'unique jobs' },
  { value: '470K+', label: 'companies' },
  { value: '300+', label: 'sources' },
  { value: '90+', label: 'Telegram channels' },
];

const vite = await createOgVite();
const { renderMarkupPng } = await vite.ssrLoadModule('/src/lib/server/og/render.ts');
const { buildBrandCard } = await vite.ssrLoadModule('/src/lib/server/og/brand.ts');
const fonts = await loadFonts();

const png = Buffer.from(await renderMarkupPng(buildBrandCard({ stats: STATS }), fonts));
if (!isValidPng(png)) process.exit(1);
await writeFile(outPath, png);

注意 gen-og.mjs 中那段关于数字口径的注释,它比"3.3M+"本身更有价值:职位数取 /api/v1/stats/catalog 的去重后 unique_open_jobs(即 /jobs 页面上能浏览到的数量),而不是原始 open_jobs——后者按板块重复计数,会比访客实际可浏览的规模高约 40%。也就是说,图上的数字必须与产品口径一致,否则就是误导性营销素材。

与任务清单的对照也值得记录,因为文档与代码已经出现了受控的偏移:

项 任务清单/设计文档 当前源码 说明
大标题 "Open source job aggregator that covers all ATS" The open-source search engine for every job 文案后续迭代,版本以源码常量为准
数据条 3 列(open jobs / companies / ATS platforms,2.9M+/188K+/50+) 4 列(unique jobs / companies / sources / Telegram channels) 随数据源扩张调整
脚本复用 复制 og-smoke.mjs 模式 抽出公共引导 og-render.mjs 字体与校验逻辑收敛到一处

注册命令只需要在 web/package.json 中加一行:

{
  "scripts": {
    "og:smoke": "node scripts/og-smoke.mjs",
    "og:gen": "node scripts/gen-og.mjs"
  }
}

八、任务 6:Seo.svelte 的站点级默认图

最后一块拼图让"每个页面都有预览"成为默认行为,而不是每个页面各自记得传参:

import { page } from '$app/state';

let { title, description, canonical, ogType = 'website', image, robots } = $props();

const previewImage = $derived(image ?? `${page.url.origin}/og.png`);

image 仍然可选:未传时回退到 ${page.url.origin}/og.png,传入时覆盖。page 从 $app/state 导入,SSR 安全(这也是为什么注释强调"渲染于服务端,爬虫和链接预览机器人能在首屏 HTML 里拿到")。

随后的 head 输出是固定的完整标签集:og:title、og:description(条件输出)、og:type、og:site_name、og:image、og:image:type(image/png)、og:image:width(1200)、og:image:height(630)、og:image:alt(取页面标题)、twitter:card(summary_large_image)、twitter:title、twitter:description、twitter:image。显式写死 1200×630 与 PNG 类型,让抓取端不必先下载图片即可判定尺寸,对大图卡片(summary_large_image)尤其重要。

九、任务 7:验证策略——可执行的 RED→GREEN

这个项目刻意不引入 JS 单元测试框架(设计文档中已说明),因此渲染链路的自动化验证落在一个免依赖脚本上。任务清单与 og-smoke.mjs 共同定义了验证方式。

9.1 夹具覆盖降级分支,而不是只测 happy path

脚本用 fixtures 构造职位卡的各类边界情况,companyFixtures 构造公司卡情况:

夹具 覆盖场景
full 技能超 3 个(触发 +N muted chip)、有薪资、有职级
noSalary 缺薪资 chip
noLogo logo 为 null → monogram
longTitle 超长标题 → 小字号 + 三行截断
companyFull Supabase,tagline + industry + US,128 个职位
companyNoChips 无 tagline / 无 industry / 无 HQ,3 个职位
companyOneJob 单数 "1 open job"
companyZeroJobs 0 open jobs

再加上 contributor* 系列(头像全部为 null,即头像不可解析时的回退路径)。所有夹具都断言输出是合法 PNG 并写入 /tmp/og-smoke/ 供肉眼检查:

const PNG_SIGNATURE = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);

export function isValidPng(png) {
  return png.subarray(0, 8).equals(PNG_SIGNATURE) && png.length > 2000;
}

"签名正确且长度 > 2000 字节"是一个务实的判据:它能拦住空图、纯白图、satori 抛错后的残缺输出,又不需要像素级比对基线(后者在字体渲染差异下会频繁误报)。

9.2 为什么脚本不能复用应用内的字体加载器

og-render.mjs 的注释解释了这一层"看起来可以偷懒但没有偷懒"的地方:应用侧 fonts.ts 用 $app/server 的 read() 读取 Vite 导入的字体资源,这是适配器无关的运行时读法,只在 SvelteKit 运行时下存在;裸 Vite 脚本没有这个运行时,所以脚本改为 readFile + fs 直接读 web/src/lib/server/og/fonts/ 下的三个 Inter 字重(400/600/700),并让 @resvg/resvg-js 走 ssr.external,避免原生模块被打包。

应用侧则对字体做了进程内记忆化(let cache: OgFont[] | null = null),因为字体在一个进程生命周期内不会变,文件只读一次。

9.3 手工核验清单

自动化只能证明"是一张合法 PNG",不能证明"看起来对"。任务清单因此保留了人工步骤:

# 在 web/ 目录下
npm run og:gen        # 重新生成并覆盖 web/static/og.png
npm run og:smoke      # 渲染全部夹具到 /tmp/og-smoke/

# 本地 SSR(dev 环境,VITE_API_URL 指向生产接口)
curl -sS -o /tmp/company.png http://localhost:5173/companies/<slug>/og.png
curl -sS -o /tmp/job.png     http://localhost:5173/jobs/<slug>/og.png

# 查看源码确认 meta 标签:/ 应为品牌默认图,/companies/<slug> 应为公司图
npm run check
npm run lint

核验重点:公司 logo 是否正确显示(而非一律 monogram)、/ 的 og:image 是否指向 <origin>/og.png、公司页是否覆盖为 /companies/<slug>/og.png、npm run check 与 npm run lint 是否干净。

十、约束、风险与维护手册

设计文档列出的三条风险在源码里都能找到对应的防御措施,理解它们是后续维护的前提。

satori 只支持 flexbox,没有 CSS grid;任何有多个子元素的节点必须显式 display:flex。 这一点在 shared.ts、card.ts、company.ts、brand.ts 的头部注释里反复出现,因为它们共享同一条渲染路径。冒烟脚本用真实渲染来捕捉违规——satori 遇到不合法布局会直接抛错,所以"能渲染出合法 PNG"本身就是布局合规的证明。

图上数字会与实时目录漂移。 缓解方式是:数字带 + 表示为近似值、只出现在泛化页面的品牌卡上,而职位卡和公司卡始终读活数据;当目录规模显著增长时,重跑 npm run og:gen 并重新提交 web/static/og.png。当前仓库中该文件大小约 40 KB(1200×630 扁平 PNG),可随时从源码再生,因此提交二进制资产是可接受的。

公司事实的时效性。 端点的缓存窗口是 1 小时 + 1 天 stale-while-revalidate,意味着公司新增职位或改名后,卡片可能滞后最多一天才刷新;这是用缓存换爬虫友好度的显式取舍,而不是缺陷。

十一、一套可复用的落地流程

把这次变更抽象成方法,任何项目都可以照搬这个顺序:

  1. 先抽共享原语,行为等价:把 mark、转义、logo 方块、chip、页脚收敛到一个纯模块,用"输出等价"的冒烟测试锁定重构不改变既有卡片。
  2. 再抽象渲染入口:把"某类实体 → PNG"收敛为 renderMarkupPng(markup, fonts),原卡片变成薄包装,新卡片直接复用同一 resvg 配置。
  3. 卡片构建器保持纯函数:实体 + 已解析的图片 + 计数 → HTML 字符串,无 I/O、无框架耦合,才能被脚本直接测试。
  4. 降级放在数据层:logo 解析失败返回 null,由构建器统一走 monogram;不要指望渲染层兜底。
  5. 端点复用页面的读路径与 404 语义:卡片数字与页面数字必须同源;实体不存在就返回 404 且不返回图片体。
  6. 静态资源 vs 端点要显式抉择:内容固定 → 构建期生成并提交;内容随时间变 → 按需渲染 + 明确 Cache-Control。
  7. 默认值写进元数据组件:previewImage = image ?? \${origin}/og.png``,让"忘记传参"不再等于"没有预览"。

顺着这条路径回看本次任务清单的 7 个章节(共享原语 → 渲染原语 → 职位卡放大 → 公司卡与端点 → 品牌静态卡 → 全站默认图 → 验证),每一章都只做一件事、且都能被上一步的验证手段证明未破坏既有行为。这也是为什么一次涉及三张卡片、两个端点、七个文件的前端改造,最终能安静地落地——整条链路只有一条渲染路径、一套品牌语汇、一个判断"渲染成功"的标准。

登录后查看全文
freehire