{
  "schemaVersion": "1.0",
  "item": {
    "slug": "z-card-image",
    "name": "z-card-image",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/aatrooox/z-card-image",
    "canonicalUrl": "https://clawhub.ai/aatrooox/z-card-image",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/z-card-image",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=z-card-image",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "assets/icons/clover.svg",
      "assets/icons/jinx-face.svg",
      "assets/icons/openclaw-lobster.svg",
      "assets/icons/openclaw-logo.svg"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/z-card-image"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/z-card-image",
    "agentPageUrl": "https://openagent3.xyz/skills/z-card-image/agent",
    "manifestUrl": "https://openagent3.xyz/skills/z-card-image/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/z-card-image/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "z-card-image",
        "body": "将用户提供的文案渲染成 PNG 卡片图。\n支持短文案封面图、长文分页图、X 风格帖子分享长图，以及公众号文章封面图。只要输入是“帖子类型数据”并希望导出成 X 风格长图，都应走 x-like-posts。"
      },
      {
        "title": "环境要求",
        "body": "Python 3\nGoogle Chrome（macOS：/Applications/Google Chrome.app；Linux：chromium 需修改脚本路径）"
      },
      {
        "title": "执行流程",
        "body": "环境提示（用户触发时检测一次，有问题给提示，不中止流程）：\n\npython3 --version → 失败则告知：「⚠️ 未检测到 Python 3，渲染可能失败」\n检查 Chrome 路径 → 失败则提示安装\n\n\n\n识别场景：\n\n短文案封面图 → poster-3-4\n长文分页图 → article-3-4\nX 风格帖子分享图 / 帖子长图 / 帖子类型数据 → x-like-posts\n公众号文章封面图 → wechat-cover-split\n\n\n\n查模板规则：根据模板在「模板索引」中找到对应规范文档，读取后按其规则处理文案和参数。如用户要求高亮：整行用 --hl1/hl2/hl3，按词用 --highlight-words（逗号分隔），两者可同时使用，不能忽略\n\n\n识别平台：按「平台预设」自动设置配色；推特长图默认使用 Twitter 风格蓝白灰配色\n\n\n渲染输出：\n\nposter-3-4 → 执行 render_card.py\narticle-3-4 → 执行 render_article.py\nx-like-posts → 执行 render_x_like_posts.py\nwechat-cover-split → 执行 render_card.py\n默认 --out 填 tmp/...png；如用户指定导出位置，可直接传绝对路径或相对路径\n\n\n\n输出产物：生成 PNG 到指定路径，供后续发送、裁切或复用；如需给外部工具上传，仍应避免写入系统 /tmp/"
      },
      {
        "title": "x-like-posts 导航",
        "body": "x-like-posts 用于“帖子类型数据 → X 风格分享长图”。\n\n当命中这条路线时，继续读取：\n\nreferences/x-like-posts.md：输入 JSON 格式、可显示字段、时间规则、导出规则\nreferences/tweet-thread.md：旧命名兼容说明"
      },
      {
        "title": "输入校验",
        "body": "比例不存在：驳回请求，告知当前支持的比例列表，询问是否新增模板\n文案超出模板字数上限：先自动拆分/缩写后再渲染，不要直接塞入\n帖子过多：按规范拆成多张 Part 1 / Part 2，不要把超长内容强行塞进一张\n公众号封面标题过长：先压缩成 2~3 行短标题，再渲染，不能把完整长标题硬塞进模板"
      },
      {
        "title": "平台预设",
        "body": "平台--footer--bg--highlight公众号（默认）公众号 · 早早集市#e6f5ef#22a854小红书小红书 · 阿康#fdecea#e53935\n\n用户提到\"小红书配图\"时使用小红书预设；\"小绿书\"= 公众号配图，使用公众号预设；否则默认公众号。"
      },
      {
        "title": "模板索引",
        "body": "模板名比例尺寸用途规范文档poster-3-43:4900×1200文字海报（金句/大字报/封面）references/poster-3-4.mdarticle-3-43:4900×1200长文分页卡片references/article-3-4.mdx-like-posts自适应长图900px 宽X 风格帖子分享长图references/x-like-posts.mdwechat-cover-split335:1001340×400公众号文章封面长条图（左标题右 icon）references/wechat-cover-split.md"
      },
      {
        "title": "新增模板",
        "body": "新建 assets/templates/<name>.html\n在 render_card.py 的 size_map 里注册尺寸\n在上方模板索引中添加一行\n创建对应 references/<name>.md，记录该模板的参数、字数上限、配图选取规则"
      }
    ],
    "body": "z-card-image\n\n将用户提供的文案渲染成 PNG 卡片图。 支持短文案封面图、长文分页图、X 风格帖子分享长图，以及公众号文章封面图。只要输入是“帖子类型数据”并希望导出成 X 风格长图，都应走 x-like-posts。\n\n环境要求\nPython 3\nGoogle Chrome（macOS：/Applications/Google Chrome.app；Linux：chromium 需修改脚本路径）\n执行流程\n\n环境提示（用户触发时检测一次，有问题给提示，不中止流程）：\n\npython3 --version → 失败则告知：「⚠️ 未检测到 Python 3，渲染可能失败」\n检查 Chrome 路径 → 失败则提示安装\n\n识别场景：\n\n短文案封面图 → poster-3-4\n长文分页图 → article-3-4\nX 风格帖子分享图 / 帖子长图 / 帖子类型数据 → x-like-posts\n公众号文章封面图 → wechat-cover-split\n\n查模板规则：根据模板在「模板索引」中找到对应规范文档，读取后按其规则处理文案和参数。如用户要求高亮：整行用 --hl1/hl2/hl3，按词用 --highlight-words（逗号分隔），两者可同时使用，不能忽略\n\n识别平台：按「平台预设」自动设置配色；推特长图默认使用 Twitter 风格蓝白灰配色\n\n渲染输出：\n\nposter-3-4 → 执行 render_card.py\narticle-3-4 → 执行 render_article.py\nx-like-posts → 执行 render_x_like_posts.py\nwechat-cover-split → 执行 render_card.py\n默认 --out 填 tmp/...png；如用户指定导出位置，可直接传绝对路径或相对路径\n\n输出产物：生成 PNG 到指定路径，供后续发送、裁切或复用；如需给外部工具上传，仍应避免写入系统 /tmp/\n\nx-like-posts 导航\n\nx-like-posts 用于“帖子类型数据 → X 风格分享长图”。\n\n当命中这条路线时，继续读取：\n\nreferences/x-like-posts.md：输入 JSON 格式、可显示字段、时间规则、导出规则\nreferences/tweet-thread.md：旧命名兼容说明\n输入校验\n比例不存在：驳回请求，告知当前支持的比例列表，询问是否新增模板\n文案超出模板字数上限：先自动拆分/缩写后再渲染，不要直接塞入\n帖子过多：按规范拆成多张 Part 1 / Part 2，不要把超长内容强行塞进一张\n公众号封面标题过长：先压缩成 2~3 行短标题，再渲染，不能把完整长标题硬塞进模板\n平台预设\n平台\t--footer\t--bg\t--highlight\n公众号（默认）\t公众号 · 早早集市\t#e6f5ef\t#22a854\n小红书\t小红书 · 阿康\t#fdecea\t#e53935\n\n用户提到\"小红书配图\"时使用小红书预设；\"小绿书\"= 公众号配图，使用公众号预设；否则默认公众号。\n\n模板索引\n模板名\t比例\t尺寸\t用途\t规范文档\nposter-3-4\t3:4\t900×1200\t文字海报（金句/大字报/封面）\treferences/poster-3-4.md\narticle-3-4\t3:4\t900×1200\t长文分页卡片\treferences/article-3-4.md\nx-like-posts\t自适应长图\t900px 宽\tX 风格帖子分享长图\treferences/x-like-posts.md\nwechat-cover-split\t335:100\t1340×400\t公众号文章封面长条图（左标题右 icon）\treferences/wechat-cover-split.md\n新增模板\n新建 assets/templates/<name>.html\n在 render_card.py 的 size_map 里注册尺寸\n在上方模板索引中添加一行\n创建对应 references/<name>.md，记录该模板的参数、字数上限、配图选取规则"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/aatrooox/z-card-image",
    "publisherUrl": "https://clawhub.ai/aatrooox/z-card-image",
    "owner": "aatrooox",
    "version": "1.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/z-card-image",
    "downloadUrl": "https://openagent3.xyz/downloads/z-card-image",
    "agentUrl": "https://openagent3.xyz/skills/z-card-image/agent",
    "manifestUrl": "https://openagent3.xyz/skills/z-card-image/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/z-card-image/agent.md"
  }
}