前言¶
在 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 说明与附带脚本，已核实能力包括：
- 公网图片 URL 入参：将 Liblib 可拉取的
https://...作为LoadImage输入提交任务。 - 本地文件入参：默认先上传到 R2（S3 兼容） 得到公网 URL，再交给 Liblib；也可选
data-uri模式（仅当 Liblib 侧接受时）。 - 飞书场景：从飞书消息文本中提取第一个
http(s)URL；本地附件推荐「R2 公网 URL → Liblib → 结果以MEDIA:行回传」以便频道直接展示图片。 - 异步任务：提交后获得
generateUuid，轮询直至generateStatus为 5（成功）或 6（失败），读取images[].imageUrl。 - 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
