模板渲染

结构化数据 → 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。

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. 调用（必须 — 云端）：

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

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

模板类型

与 ecommerce-imaging 分工

环境变量

触发词

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

Examples

尺码表

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

参数卡

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

促销 Banner

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 或系统自带字体）

版本记录