前言¶

在 Agent 里做「商品图换背景、融合场景」时，常见做法是手写 Liblib 开放平台的签名请求、自己轮询 generateUuid，再把结果图回传到飞书会话。链路长、容易漏步骤。下面介绍 SkillHub 上的社区 Skill liblib-comfy-fusion：把 LiblibAI ComfyUI 应用 API 的提交、轮询和本地/URL 入参封装成可复用流程，并针对飞书附件与消息里的图片 URL 做了约定输出。

这是什么¶

liblib-comfy-fusion（坐标 @user_7eb79720/liblib-comfy-fusion，版本 1.0.1，分类 design-media，来源 community，发布者 user_7eb79720）是一份基于通用 SKILL.md 格式的 Agent Skill。它通过 AccessKey / SecretKey 签名 调用 Liblib ComfyUI 应用接口，生成商品背景融合类图片；适合在对话里出现「Liblib Comfy 生成、飞书图片融合、本地或 URL 入图、按 generateUuid 查任务、从飞书消息里抽图片链接」等需求时由 Agent 自动选用。

SkillHub 页面标注 requires_api_key=true，使用前需配置 Liblib API 密钥。

核心功能¶

依据 Skill 说明与附带脚本，已核实能力包括：

1. 公网图片 URL 入参：将 Liblib 可拉取的 https://... 作为 LoadImage 输入提交任务。
2. 本地文件入参：默认先上传到 R2（S3 兼容） 得到公网 URL，再交给 Liblib；也可选 data-uri 模式（仅当 Liblib 侧接受时）。
3. 飞书场景：从飞书消息文本中提取第一个 http(s) URL；本地附件推荐「R2 公网 URL → Liblib → 结果以 MEDIA: 行回传」以便频道直接展示图片。
4. 异步任务：提交后获得 generateUuid，轮询直至 generateStatus 为 5（成功）或 6（失败），读取 images[].imageUrl。
5. CLI：scripts/liblib_client.py 提供 run 与 status 子命令，成功时可将结果下载到 workspace/outputs/images/YYYY-MM-DD/ 并在 stdout 输出 MEDIA:... 相对路径。

底层 API 基址为 https://openapi.liblibai.cloud，提交路径 POST /api/generate/comfyui/app，状态路径 POST /api/generate/comfy/status；鉴权查询参数含 AccessKey、Signature、Timestamp、SignatureNonce，签名为对 uriPath & Timestamp & SignatureNonce 做 HMAC-SHA1 后 URL-safe Base64（去掉尾部 =）。

安装与启用¶

先做 CLI 检查，再把 Skill 装进当前 Agent 的 skills 目录（装错目录 Agent 不会加载）。

1、确认已安装 SkillHub CLI：

command -v skillhub && skillhub --version

未安装时可按 SkillHub 安装说明 执行官方安装脚本。

2、安装本 Skill（--dir 必须指向当前环境的 skills 目录）：

skillhub install @user_7eb79720/liblib-comfy-fusion --dir <skills 目录>

常见路径示例（以官方安装文档为准）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装后重启或刷新 Agent，使 Skill 生效。

3、配置环境变量（Liblib 必填；本地图走 R2 上传时还需 R2 相关变量，可用 CLI 参数覆盖）：

export LIB_ACCESS_KEY="你的 Liblib AccessKey"
export LIB_SECRET_KEY="你的 Liblib SecretKey"

# 本地文件默认经 R2 转公网 URL 时使用（示例名以 SKILL 为准）
export R2_ENDPOINT="..."
export R2_ACCESS_KEY="..."
export R2_SECRET_KEY="..."
export R2_BUCKET="..."
export PUBLIC_URL_BASE="..."

脚本内 Comfy 工作流默认值含 YOUR_TEMPLATE_UUID 等占位，部署时需按你在 Liblib 侧的应用模板替换（见 scripts/liblib_client.py 顶部常量或运行参数）。

本地模式依赖 Python 3、requests；R2 上传路径需要 boto3。

典型用法¶

在 Skill 目录下调用客户端（路径相对于已安装的 @user_7eb79720/liblib-comfy-fusion）：

公网 URL 直接生成：

python3 scripts/liblib_client.py run --image-url "https://example.com/input.jpg"

飞书下发的本地附件（先 R2 再 Liblib）：

python3 scripts/liblib_client.py run --local-image "/path/to/input.png" --basename "product-fusion"

从飞书消息文本里取图链：

python3 scripts/liblib_client.py run --feishu-text "请处理这个图 https://example.com/input.jpg"

只提交、不轮询：

python3 scripts/liblib_client.py run --local-image "./input.jpg" --no-poll

按任务 ID 查询：

python3 scripts/liblib_client.py status <generateUuid>

成功时（generateStatus=5），结果会落到 workspace/outputs/images/日期/；stdout 一行 MEDIA:./outputs/images/... 便于 OpenClaw 飞书频道在当前会话展示。完整 JSON 在 stderr。若频道不支持 MEDIA:，说明中提到可改用 feishu-uploader 等上传方式（需自行具备对应 Skill）。

在 Cursor 等客户端中，也可直接用自然语言描述需求（例如「用 Liblib 把这张商品图融合到背景里，图在 …」），由 Agent 按 Skill 指引调用上述脚本与环境变量。

适用场景与注意¶

适合谁

• 已在 Liblib 开通 ComfyUI 应用 API，需要把「签名 + 提交 + 轮询 + 落盘」固定成 Agent 可执行步骤的团队。
• 飞书协作里经常收商品图、希望 Agent 自动融合背景并把图回传到群聊的场景。

限制与注意

• 入参 URL 必须能被 Liblib 服务器公网访问；本地文件默认依赖 R2 与正确配置的 PUBLIC_URL_BASE。
• 返回的 imageUrl 多为临时链接（说明中写约 7 天），需要长期留存请自行下载或转存。
• 内容审核失败时需换图或换 URL 重试。
• SkillHub 统计（以抓取资料为准）：评分 100000，下载 1004，安装 20；社区维护，升级与工单以 SkillHub 页面为准。

结尾¶

liblib-comfy-fusion 把 Liblib ComfyUI 应用 API 的商品背景融合流程收进一份 Skill：密钥签名、任务轮询、URL/本地/飞书入参和 MEDIA: 回传都有对应约定。若你正在 SkillHub 上找 design-media 类、且需要 API Key 的 Liblib 集成，可从官方页安装试用。

• SkillHub 页面：https://www.skillhub.cn/skills/user_7eb79720/liblib-comfy-fusion
• API 坐标页：https://api.skillhub.cn/user_7eb79720/liblib-comfy-fusion