PixelLab Pip
首先对用户的资产、API 或问题意图进行分类，然后选择支持的 PixelLab 表面。当请求是问题时，直接回答问题。
工作流程
- 对请求进行分类：
问题 | 设置 | 创建资产 | 编辑/变换 | 动画化 | 提示增强 | 集成/编码 | 检查余额/状态 | 文档/API故障排查 | 网站/编辑器协助。 将明确的技能调用后的独立设置词汇（例如/pixellab-pip setup或@pixellab-pip setup）视为设置意图。如果应用提供了结构化参数，将其用作读取相同自然语言意图的另一种方式。 - 对目标资产或表面进行分类：
通用图像 | 背景 | 角色 | 对象 | 效果/视觉特效 | 用户界面 | 完整地图 | 地图图像 | 地图对象 | 俯视瓦片集 | 横版卷轴瓦片集 | 等距瓦片 | 瓦片变体 | 动画 | 现有图像。 - 选择表面：
使用 PixelLab MCP 管理编码代理资产，使用 REST v2 处理直接 API/代码/批量原语，仅将网站/Aseprite/Pixelorama 作为人工/编辑器表面，并将 REST v1 仅用于遗留兼容性。
对于设置意图，阅读
references/setup.md并执行设置向导契约：首先推荐 MCP + API，支持纯 MCP/纯 API/手动模式，并仅在无令牌预览和明确批准后更改设置。 - 仅在 PixelLab MCP 工具可用时使用 MCP，无论其名称是否带前缀。如果 MCP 不可用，则路由到记录的匹配 REST v2 端点。如果 MCP 和 REST v2 都不可用或失败，在使用任何非 PixelLab 回退方案前解释原因。
如果工具带有前缀，例如
mcp__pixellab__create_character，则通过后缀进行匹配。 - 当需要的工具/端点/字段缺失或不明确，或涉及认证、SDK 支持、定价、模型/模式可用性或最新 MCP 工具时，刷新当前事实。
- 对于需要一致性的敏感工作，总结用户的身份、风格、调色板、视图和参考锚点。在发起信用点消耗调用前，最多提出三个关键问题。
- 对于 PixelLab 自然语言请求参数（如
描述、动作、*_描述、项目描述、文本或调色板），除非用户选择退出，否则将模糊的用户措辞改进为端点可读的英文参数值。仅在匹配所选路由时使用记录的 PixelLab 增强端点；否则直接从请求和可见输入进行增强。对于非英语或混合语言请求，请阅读references/localization.md。 - 在实时生成之前，确保 PixelLab 持有者令牌已配置，且无需用户将其粘贴到聊天中。
- 执行或回答。仅在遇到已知冲突时请求简短澄清。
表面规则
| 表面 | 用途 | 避免场景 |
|---|---|---|
| 托管 MCP | 需要带有 ID、轮询、下载、列表/获取/删除助手、项目/沙箱/代理助手的托管 PixelLab 资产的工作流。 | MCP 未暴露的原始图像/编辑/UI 原语，或当 PixelLab MCP 工具不可用时的任何 MCP 调用。 |
| REST v2 | 脚本、批处理作业、服务器集成、精确端点控制、通用图像、背景、用户界面、内绘/编辑、提示增强、原始动画、旋转、调整大小、移除背景和 API 一致性检查。 | 在未检查已安装的 SDK 或当前文档的情况下猜测 SDK 方法。 |
| 网站 / 地图工坊 | 人工产品表面、完整地图手动工作、丰富库、可视化浏览器协助以及仅限网站的工作流。 | 对复制的浏览器会话令牌或未记录的根端点进行编程式使用。 |
| Aseprite | 当用户正在 Aseprite 中积极工作时，用于本地编辑器内插件工作流。 | 将本地插件路由视为公共 REST/MCP 契约。 |
| Pixelorama / 编辑器 | 网站编辑器工作流的可视化浏览器协助，包括现有资产、保存回传工作流，以及经过明确许可后的仅限网站的手动工作流。 | 隐藏的自动化、未记录的端点调用、公共 API 假设，或在没有第二次确认的情况下进行任何生成/保存/下载/编辑/删除操作。 |
| REST v1 | 现有遗留代码和旧 SDK 兼容性。 | 新工作，除非用户明确需要使用 v1。 |
托管 MCP 工具名称不是 REST 端点。不要将 MCP 工具名称作为 /v2/... 路径进行 curl 操作。
意图路由
| 用户意图 | surface Rules 后的默认路由 | 需要编码/精确控制时的 REST v2 路由 |
|---|---|---|
| 角色、玩家、NPC、敌人、生物 | MCP create_character，然后是 create_character_state、animate_character、get_character、列表/删除助手，以及明确请求时的 delete_animation。对于现有多方向角色的后续动画，当用户未指定方向时，默认第一个候选方向为南/下方向；在动画化所有方向前询问或确认。 | 角色端点，如 create-character-v3、create-character-with-4-directions、create-character-with-8-directions、create-character-pro、状态、动画、标签、ZIP/列表/获取/删除端点。 |
| 对象、道具、物品、拾取物、武器、家具 | MCP create_1_direction_object、create_8_direction_object、create_map_object、对象状态/动画/审查/标签工具。 | 对象端点，如 create-1-direction-object、create-8-direction-object、map-objects、对象状态/动画/标签/列表/获取/删除端点。 |
| 俯视地形瓦片集、Wang/自动瓦片/RPG 瓦片集 | MCP create_topdown_tileset。 | create-tileset、tilesets。 |
| 横版卷轴/平台游戏瓦片集 | MCP create_sidescroller_tileset。 | create-tileset-sidescroller、sidescroller 瓦片集端点。 |
| 等距瓦片/块/地面 | MCP create_isometric_tile。 | create-isometric-tile。 |
| 瓦片变体 / 专业瓦片 | MCP create_tiles_pro 用于单个瓦片变体，如六角、八角、方形俯视和等距瓦片。 | create-tiles-pro、tiles-pro/{tile_id}。 |
| 通用图像、精灵、类似图标的独立资产 | REST v2。 | create-image-pixen、generate-image-v2、create-image-pixflux、create-image-bitforge、generate-with-style-v2。 |
| 背景、场景、环境、背景板 | REST v2 图像生成；未记录直接的托管 MCP 背景工具。 | 使用包含场景/背景提示的常规图像生成。不要假设 create-image-pixflux-background 是一个场景背景生成器，除非检查了当前文档。 |
| UI、HUD、按钮、面板、血条、菜单 | REST v2。 | generate-ui-v2。网站 UI 库是人工/编辑器表面，除非存在公共生命周期端点。 |
| 图像编辑、内绘、蒙版、转换、调整大小、移除背景 | REST v2。 | inpaint、inpaint-v3、edit-image、edit-images-v2、image-to-pixelart、image-to-pixelart-pro、resize、remove-background。 |
| 减少颜色 / 量化调色板 | 网站/编辑器/本地图像工具。 | 未记录公共 REST v2/MCP 减少颜色端点；使用网站文档或本地工具，而非发明路由。 |
| 取消放大像素艺术 / 移除放大 | Aseprite 或 Pixelorama 扩展。 | 网站文档将其列为仅编辑器扩展；除非官方文档添加端点，否则不要路由到 REST/MCP。 |
| 试穿衣物/物品于角色 | 网站“试穿”功能用于单张图像实验性输出；仅对动画帧服装转移使用 REST transfer-outfit-v2。 | “试穿”返回合成图像，而非独立的纸娃娃图层。 |
| 多图像组合参考 | 网站实验性流程或验证文档后最接近的记录 REST 图像/编辑路由。 | 未记录直接的公共 REST v2/MCP“多图像”路由。 |
| 重塑角色比例 | 网站“重塑”功能或验证文档后最接近的记录编辑/角色路由。 | 网站文档要求画布恰好为 64x64；未记录公共 REST v2/MCP 重塑端点。 |
| 提示增强、改进生成提示 | 对于不匹配的路由，默认在代理侧重写；仅对记录的匹配增强端点使用 REST v2。 | enhance-pixen-prompt、enhance-character-v3-prompt 或 enhance-animation-v3-prompt。除非用户明确要求，否则不要将不匹配的增强端点用作通用优化器。 |
| 原始动画、骨骼、插值、服装转移、旋转 | REST v2，除非动画化受管理的 MCP 角色/对象。 | animate-with-text*、animate-with-skeleton、estimate-skeleton、edit-animation-v2、interpolation-v2、transfer-outfit-v2、rotate、generate-8-rotations-v2/v3。 |
| 地图图像、生成的关卡图像、视觉地图概念 | REST v2 图像/背景路由；网站用于地图扩展/纹理工作流。 | 未记录完整的公共 REST/MCP 地图 CRUD、地图扩展或地图纹理表面。 |
| 地图对象 | MCP create_map_object 加上默认的 get_map_object。 | POST /map-objects；MCP 地图对象在 8 小时后自动删除。在编写代码前，从 OpenAPI 验证当前的 REST 结果和轮询行为。 |
| 完整地图、地图工坊、地图 CRUD/导出 | 手动使用网站，或使用 MCP/REST 生成组件。 | 未记录完整的公共 REST/MCP 地图 CRUD 表面。 |
| 静态效果或 VFX 精灵 | REST v2 图像/编辑路由。当提供了目标精灵/图像且用户要求添加、绘制、叠加或应用效果/轨迹/光环/冲击时，将提供的图像视为编辑目标并使用 REST 图像编辑。仅当用户要求单独的可重用效果资产/层或未提供目标图像时，使用对象/图像生成。 | 未记录独立的公共 VFX 端点。PixelLab 编辑路由返回完整的编辑后图像，而非独立的效果层。 |
| 动画效果或 VFX | REST v2 原始动画或 MCP 对象动画（如果它应成为托管对象）。 | animate-with-text-v3、animate-with-skeleton 或对象动画端点；将 VFX 视为描述，而非单独的端点。 |
| 余额、信用点、账户检查 | MCP get_balance（如果可用）。 | GET /balance。 |
| REST 异步作业状态 | REST v2。 | GET /background-jobs/{job_id}。MCP 托管资产使用资源特定的 get_* 工具代替。 |
| PixelLab 项目、沙箱、部署的代理工作流、聊天、MCP 帮助/反馈 | MCP 工具 list_projects、sandbox_*、chat_*、agent_help、agent_feedback、agent_list、agent_inspect 和 agent_talk（如果可用）。 | 未记录公共 REST v2 等效项。 |
仅在冲突时澄清
- “瓦片”：询问用户是需要地形/自动瓦片集、平台游戏/横版卷轴瓦片集，还是单个瓦片变体。
- “地图”：询问用户是需要完整地图、地图对象、地图图像、瓦片集、等距瓦片还是瓦片变体。
- “对象/角色”：对于人物、NPC、生物、身体模板或身份/状态动画，推断为角色；对于道具/物品/家具/武器，推断为对象。仅在不明确时询问。
- “角色动画方向”：如果用户要求为现有多方向角色添加动画但未指明方向，默认使用
south/下方向作为预览候选。不要默认动画化西北、对角线或所有方向。仅当south方向不可用、资产方向未知或用户需要不同的面向游戏方向时，询问方向。仅当用户明确请求所有/8个方向、完整方向集或批准较大批次时，才动画化所有方向。 - “效果”：在不明显时询问是静态精灵还是动画效果。如果提供了目标精灵/图像且用户要求对其添加效果，推断为一次性图像编辑。仅当没有明确的编辑目标或用户要求单独的资产时，询问是重用的对象/层还是一次性精灵。
- “等距瓦片集”：询问用户需要一个等距瓦片还是完整瓦片集，因为公共文档只暴露了一个等距瓦片路由。
- “纸娃娃”：收集基础、图层、方向、动画以及独立 vs 合成输出；查看
references/paperdolling.md。 - 除非所选路由需要图像字段，否则提供的图像是可选的。当提供图像时，根据请求推断每个文件在端点中的特定角色；仅当单个文件可能合理代表身份、风格、概念、编辑目标、蒙版、调色板、初始化/源、第一帧或最后一帧时询问。
- 如果提示增强添加了从图像或用户简写推断的材料细节，则在信用点消耗的生成或编辑前显示建议的描述并获得确认。
仅阅读相关的参考：
- 持有者令牌设置、PixelLab UI 命名和 MCP 认证重用：
references/credentials.md。 - 安装后 MCP/API/认证的自然语言设置模式：
references/setup.md。 - 浏览器回退和网站自动化边界：
references/browser-fallback.md。 - 纸娃娃和分层角色工作流：
references/paperdolling.md。 - 瓦片集和瓦片变体详情：
references/tilesets.md。 - 附件、文件路径、提供的图像角色、端点字段或固定大小的图像转像素艺术：
references/image-inputs.md。 - 非英语或混合语言用户请求和响应语言处理：
references/localization.md。 - 官方 PixelLab 文档、MCP 文档、REST 文档和网络刷新路由：
references/official-docs.md。 - 使用量、余额、作业和结果报告：
references/usage-reporting.md。 - 从生成的帧进行的本地动画预览 GIF、精灵表或 ImageMagick/
magick组装：references/local-asset-assembly.md。
可选的更广泛文档：在完整的插件/仓库安装中，这些路径相对于此 SKILL.md 解析；原始技能安装可能省略它们。如果运行时 references/ 不够，如果文件存在则最多读取一个匹配的文件。如果不存在，则继续使用 references/official-docs.md 和当前的官方 PixelLab 文档；不要搜索或加载该集合。
- 表面边界和服务选择：
../../docs/pixellab/surfaces-and-services.md。 - 自然语言资产路由：
../../docs/pixellab/asset-routing.md。 - 产品/模型/模式术语：
../../docs/pixellab/terminology.md。 - S
…
[为翻译截断]