Materials CLI

当用户希望将 JSON Schema 渲染为图像（PNG/JPG）、验证渲染数据 Schema，或根据自然语言提示生成 Schema 并完成渲染时，使用此技能。

命令

• render — 将 JSON Schema 文件渲染为图像。
• generate — 使用 AI（OpenAI）根据提示词生成 Schema，然后将其渲染为图像。
• validate — 根据 declare-render 数据 Schema 验证 JSON Schema 的有效性。

适用场景

• 用户提出“将 Schema 渲染为图像”、“把 JSON 转成图片”或“根据 Schema 绘图”等请求。
• 用户希望“根据描述生成图像”，或“根据提示词创建 Schema 并渲染”。
• 用户希望使用渲染数据 Schema 对某个 JSON 文件进行“校验/验证”。

使用方式

通过 Node.js 运行（可在项目目录中执行，或在全局安装后运行：npm install -g materials-cli）：

materials render  [options]
materials generate "" [options]
materials validate  [options]

render

• materials render schema.json -o output.png
• 选项：-s, --schema 、-o, --output （默认为 ./output.png）、-f, --format 、-w, --width、-h, --height、--output-schema 、-i, --interactive

generate（AI 模式）

• materials generate "一个红色圆形，内含文字 Hello" -o out.png
• 选项：-o, --output、-f, --format、-w, --width、-h, --height、--output-schema、--model、--api-key、--base-url、-i, --interactive
• 若未通过命令行参数传入，则自动使用环境变量 OPENAI_API_KEY（以及可选的 OPENAI_MODEL 和 OPENAI_BASE_URL）。

validate

• materials validate schema.json
• 选项：-s, --schema 、-i, --interactive

CLI 帮助信息

Usage: materials  [options]

Commands:
  render      将 JSON Schema 文件渲染为图像
  generate    使用 AI 生成 Schema，然后渲染
  validate    根据渲染数据 Schema 验证 Schema

Examples:
  materials render schema.json -o output.png
  materials generate "一个红色圆形，内含文字 Hello"
  materials validate schema.json

Schema 格式说明

JSON Schema 遵循 declare-render 格式：根对象需包含 id、width、height 和 layers 字段。支持的图层类型包括 text、image 和 shape。建议在渲染前使用 materials validate 命令校验 Schema 的有效性。