Agent Skills
返回列表
💻

JSON 图像渲染

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/vercel-labs-json-render-image。

技能介绍

要解决什么问题

很多场景里你希望用声明式 JSON描述一张图——社媒卡片、OG 图、邮件头图——而不是手写 SVG 或在服务端跑完整浏览器截图。@json-render/image 把 JSON 规格交给 Satori 布局引擎,直接产出 SVG 字符串或 PNG buffer,适合 Node 侧批量生成静态图。

技能如何工作

规格围绕一棵以 Frame 为根的组件树组织。内置 Layout(Box、Row、Column)、Content(Heading、Text、Image)和装饰类(Divider、Spacer),与 schema、standardComponents 配套,便于让 AI 或配置系统生成合法结构。

关键 API:

  • renderToSvg:渲染为 SVG 字符串
  • renderToPng:渲染为 PNG(需安装 @resvg/resvg-js)
  • @json-render/image/server:仅 schema 与 catalog,无 React/Satori 依赖,适合在纯后端拼装提示词或校验规格
  • @json-render/image/catalog 与 /render:按需拆分组件定义与渲染函数

也可按文档扩展 自定义组件,在标准注册表之外接入自己的布局或内容块。

适用边界与注意点

输出是静态栅格化布局,不是通用 HTML/CSS 全家桶;复杂交互、动画或任意 CSS 特性不在此包职责内。PNG 路径依赖 Resvg,部署时要保证该原生依赖可用。若只需要给模型看的组件清单而不在当次进程渲染,优先用 server 或 catalog 子路径减轻打包体积。

使用场景

  • CI 里根据 PR 元数据 JSON 批量生成仓库 README 顶部的贡献者徽章图
  • 用同一套 Frame/Row/Text 规格在 Node 脚本里产出多语言 Open Graph 预览图
  • 在纯 API 服务中校验客户端提交的 image spec,再调用 renderToPng 回传二进制
  • 给编排层下发 standardComponentDefinitions,让模型只输出可渲染的组件树 JSON

适合人员

  • 维护开源项目的维护者,希望用 JSON 模板自动生成发行说明配图而非手工改 Figma
  • 负责增长落地的工程师,需要把活动文案字段映射成固定尺寸的分享卡片 PNG
  • 构建 AI 出图流水线的后端开发,要在无头环境里把结构化输出落成 SVG/PNG
  • 为设计系统写文档的平台同学,需要把组件 catalog 同步给模型作生成约束