技能介绍

要解决什么问题

拼豆（perler bead）实物制作前，需要把照片或插画压成固定网格上的色号图——手工在 PS 里描格、对色号既费时又容易和手头豆子品牌对不上。本技能面向「先出图纸、再拼」的流程：你给出文字描述和可选的参考图 URL，后端按指定板宽、板高生成二维组装图（Blueprint），并返回调色盘、网格色号、用量统计与可分享的会话链接。

技能如何工作

核心入口是工匠智能体（Craftsman-Agent）在 OneKey Agent Gateway 上注册的 generate_perler_bead_pindou API。典型输入包括：

prompt：说明要生成的图案或后期意图，例如人像去背景、灰底改白底、卡通化等
images：待处理图片的 URL 列表
width / height：成品板尺寸（如 16×16 表示 16 格宽、16 格高）
brand（可选）：豆子品牌色号体系，可选 default、mard、artkal、perler、hama，默认按 MARD

输出侧你会拿到 palette（色号与编码）、grid（每格对应色号）、statistics、session_id，以及 share_url。在分享页打开画布后，可通过站内的 export 导出 PNG/PDF 等图纸文件。技能侧也提供 Node/Python 脚本封装同一 API，适合在 CLI 或其它 Agent 流水线里调用。

适用边界与注意点

走 Gateway 需配置 DEEPNLP_ONEKEY_ROUTER_ACCESS（与 AI Agent Marketplace / OneKey 的 Access Key 相同）；不想配 Key 时，可直接用在线页拼豆生成器的游客模式。
网格分辨率由 width/height 决定，细节过多的原图在极小格数下会损失信息，需要在尺寸与可拼性之间权衡。
色号以所选 brand 为准，换品牌应改参数，否则实物采购可能对不上盘。

截图预览

使用场景

手头有游戏或 Minecraft 道具的参考图 URL，要按 16×16 等固定格数生成带 MARD 色号的二维拼豆组装图。
人像或商品图需要先通过 prompt 去背景、改白底或卡通化，再输出 palette、grid 与豆子用量统计用于采购。
已选定 artkal、perler、hama 等品牌色号体系，要把同一张插画压成指定 width/height 的拼豆网格。
API 返回 session 与 share_url 后，要在分享画布上核对图案并导出 PNG/PDF 给线下拼豆小组打印对照。

适合人员

周末按图拼豆、常把照片或截图转成指定板宽高的 MARD 色号网格的手作玩家
做像素风周边或教程、要把角色立绘压成可分享拼豆蓝图并统计用豆量的内容创作者
在 Agent 或脚本里对接 OneKey Router、用 prompt 与 images 调用 generate_perler_bead_pindou 的集成工程师
STEAM 或亲子手工课、需要把学生作品快速变成可打印拼豆纸样并选 hama/perler 色号的教师