JSON 图像渲染
将以下提示词粘贴到你的 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 同步给模型作生成约束