前言¶
人像、寵物或商品圖要統一成漫畫、動漫或手繪一類視覺時，常見做法是手動套濾鏡或進 PS 逐張調色，人物辨識度容易丟，批量出圖也很難保持同一套線條和配色。若希望 Agent 在對話裏直接完成「原圖 + 參考畫風 → 成圖」，並能在第一張滿意後按同一風格處理後續照片，可以把 SkillHub 上的 照片轉繪（@beatra-ai/ai-photo-restyler）裝進當前 Agent 的 skills 目錄，由 Skill 內的說明驅動調用流程。
這是什麼¶
照片轉繪 是發佈者 beatra 在 SkillHub 上架的企業來源（enterprise）Skill，座標 @beatra-ai/ai-photo-restyler，當前版本 0.1.9，分類爲 design-media。它面向「從用戶自己的照片出發，疊加一張畫風參考圖做風格遷移」：在轉成漫畫風、動漫風、卡通、水彩、手繪、黏土或 3D 角色畫風時，儘量保住人物、寵物或商品的辨識度，讓配色、線條和上色方式向參考圖靠攏。
與單純全局濾鏡不同，這裏強調 參考圖驅動的風格遷移 和 批量同一畫風，適合社交頭像、朋友圈配圖、表情包素材、海報和周邊等二次創作場景。
SkillHub 頁面標註該 Skill 需要 API Key（requires_api_key=true）；具體密鑰名稱與配置方式以安裝後包內 SKILL.md 爲準，本文不臆造字段名。
核心功能¶
以下能力均來自 SkillHub 官方簡介，未在資料中出現的接口或參數不寫。
- 多畫風輸出：支持漫畫風、動漫風、卡通、水彩、手繪、黏土、3D 角色等方向（具體可選項以 Skill 內說明爲準）。
- 辨識度保留：轉繪時側重讓人物、寵物或商品仍可辨認，而非整圖糊成單一濾鏡效果。
- 參考圖風格遷移：以用戶照片爲內容底圖，用一張畫風參考圖約束配色、線條與上色方式。
- 適用素材類型：自拍、人像、寵物照、商品圖、旅行照等常見照片類型。
- 批量一致性：第一張效果滿意後，可按同一畫風處理多張照片，便於成套素材。
SkillHub 統計（以頁面抓取爲準）：評分 100000，下載 17848 次。
安裝與啓用¶
官方頁面要求按 SkillHub 安裝文檔操作，安裝包名爲 @beatra-ai/ai-photo-restyler。
1. 確認 SkillHub CLI¶
先檢查本機是否已有 skillhub：
command -v skillhub && skillhub --version
若未安裝，可按 SkillHub 文檔執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅需 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安裝到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前 Agent 實際使用的 skills 目錄；裝到默認 ./skills/ 往往不會被識別。文檔記載的常見路徑如下：
| Agent / 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
以 Cursor 爲例：
skillhub install beatra-ai/ai-photo-restyler --dir ~/.cursor/skills/
也可在 SkillHub 技能頁將安裝提示發給 Agent，並指明依據：https://skillhub.cn/install/skillhub.md ，安裝 @beatra-ai/ai-photo-restyler。
3. API Key¶
標籤 requires_api_key=true 表示運行前需配置對應服務的 API Key。請在安裝完成後打開該 Skill 目錄下的 SKILL.md，按發佈者說明填寫環境變量或配置項；未在公開頁面列出的密鑰名不要自行假設。
安裝或更新 skills 後，按你所用客戶端的要求重啓或刷新 Agent，以便加載新 Skill。
典型用法¶
公開頁面未給出獨立 REST 示例；通用 SKILL.md 型 Skill 的典型工作流如下，與官方簡介一致，可在對話中復現。
- 準備素材：一張要轉繪的源照片（人像、寵物、商品或旅行照）；一張目標畫風的參考圖（線條、配色、上色方式儘量貼近你想要的結果）。
- 說明需求：在 Agent 對話中啓用 照片轉繪，寫明目標畫風（如動漫風、水彩、3D 角色等）以及用途（頭像、海報、表情包等）。
- 試第一張：根據
SKILL.md的指引提交或上傳圖片，確認人物/寵物/商品是否仍可辨認、風格是否貼近參考圖。 - 批量同風格：第一張滿意後，用同一參考圖與相同參數處理其餘照片，保持成套視覺一致。
具體命令、腳本路徑或上傳方式以安裝包內 SKILL.md 爲準；若與本文概括不一致，以 Skill 文檔爲優先。
適用場景與注意¶
適合誰
- 需要在 Agent 工作流裏快速做照片轉漫畫/動漫/手繪類素材，又不想每張手工修圖的設計、運營或獨立開發者。
- 已有明確畫風參考（插畫、角色立繪、品牌視覺），希望多張實拍或商品圖統一到同一二次元或插畫氣質的團隊。
限制與注意
- 依賴外部 API 與有效 API Key，網絡與配額會影響可用性；企業來源 Skill 的使用條款以 SkillHub 與發佈者說明爲準。
- 轉繪質量受源圖清晰度、參考圖匹配度影響；複雜背景或極端光照時，需在對話裏迭代參數或換參考圖。
- 涉及真人肖像、商標或商品外觀時，請自行確認版權與平臺規範，Skill 不提供合規審查。
結尾¶
照片轉繪（@beatra-ai/ai-photo-restyler）把「源照片 + 畫風參考圖」的風格遷移封裝進 Agent Skill，在多畫風轉繪的同時強調辨識度與批量統一，適合頭像、社交配圖和周邊類二次創作。安裝與密鑰配置見 SkillHub 安裝文檔與包內 SKILL.md。
- SkillHub 技能頁：https://www.skillhub.cn/skills/beatra-ai/ai-photo-restyler
- 官方地址：https://api.skillhub.cn/beatra-ai/ai-photo-restyler
- 安裝說明：https://skillhub.cn/install/skillhub.md
