前言¶
人像、宠物或商品图要统一成漫画、动漫或手绘一类视觉时，常见做法是手动套滤镜或进 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
