模板渲染#

结构化数据 → PNG 信息图（Pillow 确定性渲染）。 ClawHub / OpenClaw 云端模式 — 渲染在 Yufluent 服务端 执行，按张计费；本机只需 TOKENAPI_KEY（ tk-*）与 requests。

快速开始（3 步，60 秒）#

1. 注册获取 API 密钥 → https://claw.changzhiai.com/login （新用户即送体验积分，无需绑卡）
2. 设置环境变量：export TOKENAPI_KEY=*** 或写入 .env 文件
3. 运行：参照下方 Examples 示例执行 python scripts/run.py ...

还没注册？前往 https://claw.changzhiai.com/login 免费获取密钥。

OpenClaw 与 Yufluent（必读）#

OpenClaw 对话与技能调用 共用同一 tk-*。接入见 https://claw.changzhiai.com/app/openclaw。

层走哪里干什么OpenClaw 对话Yufluent /v1/chat/completions（同一 tk-*）收集数据、选模板、调 run.py渲染正式输出POST /v1/skills/commerce-render/run（同一 tk-*）服务端 Pillow → PNG

Agent 硬性规则：

1. 禁止 用对话模型自行生成图片或给出像素级渲染指令。
2. 必须 通过 python scripts/run.py ...（或 POST /v1/skills/commerce-render/run）获取输出。
3. 对话模型仅用于：确认模板类型、帮助构造 JSON 数据、选品牌色。
4. 只需 TOKENAPI_KEY， 不要 要求用户另配厂商 LLM Key。

Instructions（Agent 工作流）#

1. 确认模板（见下表）；根据用户意图选择：尺码表 → size_chart，参数卡 → spec_card，卖点 → feature_grid。

2. 收集数据：

   • --product（必填）：产品名
   • --template / -t：模板类型
   • --render-data：JSON 数据文件或 JSON 字符串
   • --brand-color：品牌色 hex（默认 #1a56db）
   • --platform-size：如 amazon-main、 amazon-aplus-banner

3. 调用（必须 — 云端）： bash

   python scripts/run.py \
     --product "无线蓝牙耳机" \
     --template size_chart \
     --render-data data.json \
     --brand-color "#1a56db"
   
   

4. 计费：按张计费；402 余额不足；401 密钥无效。

模板类型#

template用途数据要求size_chart尺码表表头 + 行数据spec_card参数信息图键值对参数feature_grid卖点网格卖点列表compare_table功能对比表对比矩阵promo_banner促销 banner标题 + 副标题

与 ecommerce-imaging 分工#

commerce-renderecommerce-imaging表格/文字/参数 — Pillow 确定性照片/场景/白底 — AI 生图可预测、可重复创意、概率性

环境变量#

变量必填说明TOKENAPI_KEY是tk-*， Yufluent 控制台 获取TOKENAPI_BASE_URL否默认 http://localhost:8080/v1``RENDER_FONT_PATH否服务端中文字体路径（Pillow 渲染）

触发词#

• "生成尺码表"
• "做参数对比图"
• "卖点信息图"
• "促销 banner"
• "size chart"
• "spec card"
• "模板渲染"

Examples#

尺码表

bash

python scripts/run.py \
  --product "运动T恤" \
  --template size_chart \
  --render-data examples/size_chart.json \
  --brand-color "#1a56db"

参数卡

bash

python scripts/run.py \
  --product "蓝牙耳机" \
  --template spec_card \
  --specs '{"蓝牙版本":"5.3","续航":"30h","防水":"IPX5","重量":"45g"}' \
  --platform-size amazon-aplus-banner

促销 Banner

bash

python scripts/run.py \
  --product "夏季美妆套装" \
  --template promo_banner \
  --title "夏日美肌季" \
  --subtitle "全场满300减50 · 限时3天" \
  --brand-color "#e63946"

工作流联动#

visual-to-render：visual-craft brief → commerce-render 出图。

合规声明#

• 渲染内容须与产品事实一致，不虚构参数
• 字体版权需自行检查（建议 Noto Sans SC 或系统自带字体）

版本记录#

版本日期变更v1.1.02026-06-14SKILL.md added quickstart registration guide; 401/402 error messages now in Chinese with register linksv1.0.02026-06-13规范 SKILL.md：补充 Agent 规则、Instructions、触发词、示例、环境变量、合规、版本记录v0.1.0—初始模板渲染技能