Pindou（拼豆）是一款免费在线拼豆图纸生成器，可将照片、插画转为带色号的像素拼豆图，支持网页直接使用，无需安装。

如何把照片变成拼豆图纸？

在 Pindou 工作台上传图片，选择 MARD 或 COCO 等色卡与格数，系统自动像素化生成图纸，可用画笔精修后导出 PNG 或 PDF。

图片会上传到服务器吗？

默认在本地浏览器完成像素化处理，图片不会上传。仅在使用 AI 预处理时，图片会通过本站转发至火山引擎图像 API；凭证由用户自备并仅存本机。

支持哪些拼豆色卡品牌？

支持 MARD、COCO、漫漫、盼盼、咪小窝等主流拼豆色号体系，也可自定义色板。

如何导出带色号的拼豆图纸？

在工作台生成图纸后，可导出带色号的高清 PNG、采购清单，H5/App 端还支持 PDF 图纸导出。

拼豆图纸生成器免费吗？

Pindou 核心功能免费使用。AI 预处理为可选功能，需用户自行配置火山引擎凭证，费用由用户账号承担。

支持从小红书导入图片吗？

支持。在工作台点击「小红书导入」，粘贴分享文案或短链，系统解析图集后可选图进入拼豆流程。解析经本站 Function 转发，失败时可手动保存图片上传。

如何限制拼豆图纸的颜色数量？

工作台「参数」面板可设置最大颜色数（0 为不限制），系统会将多余颜色合并到相近主色，适合控制采购成本。

大图如何按拼板打印？

导出 PDF 时选择「分板导出」，系统按 29×29 格切分多页，每页含板坐标，便于打印后拼接。

拼豆新手从哪里学？

访问本站「拼豆教程」页面，了解选豆、色卡、上传做图、分板打印与熨烫技巧；也可从画廊打开可编辑案例上手练习。

熨烫拼豆要注意什么？

用烘焙纸覆盖豆子，中低温熨烫至微熔粘连，冷却后再撕纸。单面熨烫保留颗粒感，双面更平整；避免温度过高导致豆子过度熔化。

开源 · MIT · npm

@wangdandan810012/bead-core

蛋蛋拼豆核心算法库 — Pindou 网页端背后的图片转图纸引擎。将 RGBA 像素映射为拼豆色号网格，供开发者集成到自己的应用。

安装

npm install @wangdandan810012/bead-core

包页面： https://www.npmjs.com/package/@wangdandan810012/bead-core

零运行时依赖

不绑定 Vue / Canvas，Node 与浏览器均可使用

CIEDE2000 配色

感知色差 ΔE，与主流拼豆工具一致的色板匹配

照片清晰度优化

最近邻降采样 + 可调合并阈值，保留边缘细节

完整流水线

转换 → 合并 → 限色 → 背景标记 → 排除色重映射

处理流水线

prepareSourcePixels
       ↓
runPipeline
  ├─ convertImageToPattern（降采样 + CIEDE2000 配色）
  ├─ mergeSimilarRegions
  ├─ limitGridColors
  ├─ markExternalBackground
  └─ remapExcludedColors

色板数据由调用方传入（支持 MARD、COCO 等多品牌色号映射），库本身不包含 UI，适合 Web、小程序或 Node 批处理场景。

主要 API

导出	说明
`runPipeline`	主流水线入口
`convertImageToPattern`	图片 → 拼豆网格
`prepareSourcePixels`	亮度 / 对比度 / 锐化 / 降噪
`mergeSimilarRegions`	相似色区域合并
`markExternalBackground`	贴边背景洪水填充
`computeColorStats`	色号用量统计

快速示例

import { prepareSourcePixels, runPipeline } from '@wangdandan810012/bead-core'

const adjusted = prepareSourcePixels(pixels, width, height, imageAdjust, photoOptimize)
const { grid } = runPipeline(adjusted, width, height, {
  gridWidth: 100,
  mode: 'average',
  mergeThreshold: 0,
  maxColors: 0,
  palette,
  backgroundPaletteIds: ['neutral-001'],
  excludedPaletteIds: [],
})

与 Pindou 网页的关系

本站在浏览器中调用同一套算法完成「上传 → 生成 → 精修 → 导出」。
算法库独立发布，便于其他开发者复用或二次集成。
详细算法说明见 GitHub 仓库 docs/algorithms/ 目录。