pindou-color-data

该仓库是国内拼豆色卡数据仓库，提供多个拼豆品牌系列的色卡数据，包括MARD家、优肯、COCO、漫漫家、盼盼家、咪小窝等。每个系列包含colors.json、colors.xlsx、legend.pdf和README.md文件，涵盖颜色数从174到418不等，所有颜色均包含RGB值。数据经过交叉验证和去重处理，适合其他应用以git submodule方式挂载使用。This repository is a domestic perler bead color chart dataset warehouse, providing color chart data for multiple perler bead brand series including MARD, Youken, COCO, Manman, Panpan, Mi Xiaowo and others. Each series includes files such as colors.json, colors.xlsx, legend.pdf and README.md, with the number of colors ranging from 174 to 418, and all colors are equipped with complete RGB values. The data has undergone cross-validation and deduplication processing, and is suitable for being mounted as a git submodule by other applications.

原始信息汇总

数据集概述

数据集名称：拼豆色卡四件套交付目录
仓库地址：https://github.com/HansBug/pindou-color-data
生成日期：2026-05-19
定位：面向拼豆色卡的数据仓库，适合其他应用以 git submodule 方式挂载使用。

---

数据内容与结构

每个系列子目录包含以下四个文件：

• colors.json：颜色数据
• colors.xlsx：颜色表格
• legend.pdf：图例PDF
• README.md：系列说明

---

系列清单

系列名称	主流度	说明	颜色数	有 RGB	无 RGB	不可辨认
MARD家	S / 5.0	国内最主流/默认参考	221	221	0	0
MARD家源码版	S / 5.0	国内最主流/默认参考	221	221	0	0
MARD家291色	S / 4.7	国内默认参考体系的完整版	291	291	0	0
优肯418色	A / 4.2	进阶全量/官方体系	418	418	0	0
优肯197色	A / 4.1	官方稳定/进阶常用	197	197	0	0
优肯M221色	A- / 3.9	官方 MARD 兼容新体系	221	221	0	0
COCO	A- / 3.9	常见性价比品牌	291	291	0	0
漫漫家	B+ / 3.7	老牌/图纸生态常见	278	278	0	0
盼盼家	B+ / 3.6	工具生态常见品牌	289	289	0	4
咪小窝	B / 3.4	常见但偏工具/玩家圈	290	290	0	4
优肯174色旧表	B- / 3.0	旧公开表/参考价值高于采购价值	174	174	0	0

---

数据关系与去重说明

• 错码、缺码与不可辨认色号：manman-278 中 5 组重复色号已修正；panpan-289 与 mixiaowo-290 中各有 4 个色号为 - 的颜色，使用占位 UNKNOWN-*，标记 unidentified: true，不猜测品牌色号。
• MARD 221 两个来源：色号集合完全一致，但 77 个 HEX/RGB 不同，144 个一致。两者均保留，默认推荐 mard-221-alfonse-doudou，差异明细保存在 Mard-221-source-differences.json。
• 优肯 MARD 同款 221 与优肯 M221：youken-mard-221-public 与 artkal-m-221-official 数据完全重复，已移除前者，直接用后者。
• 优肯特殊材质 RGB 补齐：artkal-c-197-official 中 CG/CP/CT 材质用官方色卡图采样值补齐，标注 official_chart_image_sampled；CT01-CT09 透明材质使用 #RRGGBBAA 和 transparency 字段；artkal-m-221-official 中 MH1 透明色使用比特拼豆页面给出的 #FFFFFF 作基底色，标注 public_tool_display_hex。
• 黄豆豆、小舞家与 MARD 291：三者 291 个色号、HEX、RGB 完全一致，不再保留前两者独立目录，需要时可暂按 mard-291-github 读取。

---

主流度评级口径

• S：国内手工小店/玩家图纸交流中的默认或最主流体系。
• A：成熟、常见、有较强官方或工具生态支撑。
• B：常见于工具、材料包或玩家圈，适合作为补充品牌。
• 分数：1-5 的相对评估，综合媒体报道、工具站覆盖、公开色卡生态、搜索可见度与官方资料。

---

调研来源

• 中工网/北京青年报关于 DIY 拼豆店的报道：https://www.workercn.cn/c/2026-02-25/8740893.shtml
• 淮南日报关于拼豆热度的报道：https://hnrb.huainannet.com/attachment/202604/08/40d9546e-d38a-43b4-b314-b4b300b22616.pdf
• 比特拼豆色卡：https://bitbead.pomodiary.com/zh/colors
• 拼豆工具站 Mard 标准色卡/售卖页：https://www.pindou.online/colors
• PinDou 图纸生成器：https://pindou-e90.pages.dev/
• xiaoana 拼豆工具色号映射：https://www.xiaoana.cn/
• Zippland/perler-beads 公开源码：https://github.com/Zippland/perler-beads
• BeadPattern 拼豆图纸生成器：https://beadpattern.net/zh/about
• 爱拼豆 App：https://apps.apple.com/cn/app/%E7%88%B1%E6%8B%BC%E8%B1%86/id6756688364
• 拼豆酱 Perler Chan：https://pindou.baby/
• 公开源码 get-colors-from-beans：https://git.xiongxiao.me/abearxiong/get-colors-from-beans

---

附加文件

• manifest.json：所有子目录和统计的机器可读清单。
• Mard-221-source-differences.json：MARD 221 两个公开来源之间的 HEX 差异。

---

作为 Submodule 使用

bash git submodule add https://github.com/HansBug/pindou-color-data.git data/pindou-color-data

---

维护脚本

• scripts/generate_deliverables.py：从 colors.json 重生成各系列四件套。
• scripts/build_tables.js：上游采集/清洗辅助脚本。
• 依赖：python -m pip install openpyxl==3.1.5 pillow==12.2.0

搜集汇总

数据集介绍

构建方式

拼豆色卡数据集从多个主流拼豆品牌中系统采集颜色数据，涵盖MARD、优肯、COCO、漫漫、盼盼等多个系列，共包含11个子数据集，每个子集均以JSON格式存储颜色及其标准RGB值。数据处理中交叉验证了多个来源的色号映射，识别并标记了不可辨认的色号及重复数据，如MARD 221两个版本间77处差异。对于优肯特殊材质，通过采样官方色卡图补齐RGB，并使用RGBA和透明度字段表达透明材质特性。最终通过维护脚本自动生成一致格式的XLSX、PDF图例和说明文档，确保数据集结构统一且可维护。

特点

该数据集的显著特点在于全面性与严谨性。它覆盖了从主流到小众的多个品牌色系，如国内最主流的MARD 221和官方标准优肯系列，并提供了基于媒体报道、工具站覆盖和玩家生态的主流度评级辅助用户选择。数据质量方面，通过多来源交叉验证修正错误色号，对无法确认的品牌色使用稳定占位符而非猜测，同时保留差异明细以备核验。透明材质使用RGBA格式显式标记，避免下游误用。去重处理避免了完全重复数据的冗余存储，如黄豆豆系列直接映射至MARD 291，提升了数据集的精简与可用性。

使用方法

用户可通过Git子模块方式直接挂载此数据集，使用`git submodule add`命令后，即可在项目中引用各系列的`colors.json`文件获取颜色数据。每个子目录中均配有可读的Excel表格和图例PDF以满足不同分析需求。维护脚本存放于`scripts/`目录，用户如需更新或自定义数据集，可修改JSON后运行Python脚本重新生成XLSX和PDF交付物，依赖安装仅需openpyxl和Pillow库。数据中的`unidentified`和`transparency`字段为下游过滤和特殊材质处理提供了明确接口，方便集成至各类拼豆相关工具或应用程序中。

背景与挑战

背景概述

拼豆（Perler Beads）作为一种新兴的手工DIY形式，近年来在全球范围内，尤其是在中国年轻群体中掀起了消费热潮。pindou-color-data数据集由HansBug团队于2026年5月创建，旨在系统性地整合并规范化国内主流拼豆品牌的色卡体系。该数据集覆盖MARD、优肯、COCO、漫漫家等11个系列，共包含数千种颜色的RGB数值及色号映射，其核心研究问题在于解决拼豆生态中色卡标准混乱、跨品牌颜色匹配困难等痛点。通过引入主流度评级与多源交叉验证机制，该数据集为拼豆图纸设计、工具开发及玩家社区提供了权威的色彩参考基准，对推动拼豆产业的数字化和标准化具有里程碑意义。

当前挑战

该数据集面临的挑战主要体现在两大层面。在领域问题层面，拼豆行业长期缺乏统一的颜色标准，不同品牌（如MARD与优肯）的色号体系差异显著，导致玩家在跨品牌使用豆子或参考图纸时频繁出现色差错配；同时，部分品牌（如优肯）的特殊材质（透明、荧光）缺乏官方RGB发布，增加了数据采集的模糊性。在构建过程中，团队需处理上游数据源的错码、缺码和重复色号（如manman-278出现5组重复），且部分色号（如panpan-289与mixiaowo-290中的4个未知色）无法在任何公共映射表中确认真实品牌身份，需通过占位符‘UNKNOWN-*’标记而非主观猜测，确保数据溯源的可信度。

常用场景

经典使用场景

在拼豆手工艺与数字创意交叉领域中，pindou-color-data数据集被广泛用作跨品牌色卡体系的标准参照基准。其核心使用场景涵盖拼豆图纸自动生成、色彩匹配算法验证以及多品牌色号映射系统的构建。研究者与开发者可借助该数据集中包含的MARD、优肯、COCO等主流品牌色号及其RGB/HEX数值，实现从物理拼豆颜色到数字色彩空间的精准转换。数据集以JSON、XLSX及PDF等多种格式交付，并支持Git Submodule挂载，极大便利了拼豆设计工具链的集成与迭代，成为连接实体工艺与数字创作生态的关键枢纽。

衍生相关工作

围绕pindou-color-data数据集，已衍生出多项具有影响力的相关工作与工具。在工具生态层面，PinDou图纸生成器、beadpattern.net及爱拼豆App等均以此为底层色卡数据库，实现了对MARD、优肯、COCO等品牌的统一支持。在数据科学领域，该数据集被用于验证色号映射算法与品牌色彩空间转换模型，例如结合xiaoana与Zippland/perler-beads等公开源码进行的交叉校验研究。学术界进一步关注色彩数据质量评估与异常检测，基于其中的"unidentified"标记与跨源差异文档（如Mard-221-source-differences.json）开展数据清洁与补全实验。这一系列工作共同构建了从原始色卡采集到应用落地的完整技术栈，充分彰显了该数据集作为拼豆数字基础设施的辐射价值。

数据集最近研究

最新研究方向

随着拼豆手作体验经济的持续升温，该领域的研究前沿正从单一的色号匹配转向多源异构色彩数据的系统化治理与跨品牌互操作。pindou-color-data数据集应运而生，精准回应了碎片化生态下色卡标准缺失的痛点，首次系统汇整了MARD、优肯、COCO等11个主流与进阶品牌的色号体系，并通过交叉验证、异常标记、透明度数据扩充等手段，实现了对错码、缺码及不可辨认色号的可信处理。该数据集在主流度评级、去重逻辑与RGBA透明材质表示上的严谨设计，不仅为下游工具站、图纸生成器和移动应用提供了统一的色号基准，更呼应了2025-2026年拼豆产业供应链扩张与玩家圈层细化的热点趋势，成为推动国内手作数字经济标准化进程的关键基础设施。