前言¶

在 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