3D 打印耗材颜色识别助手

离线查询、匹配和展示 3D 打印耗材颜色的 Agent Skill。它可以根据图片主色或指定 HEX，推荐最接近的耗材颜色，并生成可搜索、可筛选、可打印的本地 HTML 色卡。

当前内置三套色库：

无需联网查询，也不会上传用户图片。图片取色、近色匹配和 HTML 生成都在本地完成。

能做什么

• 查询耗材的中文名、英文名、材料系列、官方编码和 HEX 色值
• 从图片中提取主要颜色
• 使用 CIE Lab 和 CIEDE2000 色差寻找最接近的耗材
• 为每个输入色输出 Top 3 / Top N 推荐
• 生成图片近色匹配 HTML 报告
• 生成完整离线 HTML 色卡
• 区分官方数字色值与图片采样估算色值

支持色库

Bambu Lab / 拓竹

使用 BambuStudio 官方仓库数据快照，覆盖：

• PETG HF：14 色
• PLA Basic：38 色
• PLA Matte：25 色
• PLA Lite：13 色

CaiDuoWu / 彩多屋

来自用户提供的彩多屋色卡海报，已排除透明、彩虹、金属、变色龙、夜光、双色、三色、四色等非纯色条目。

覆盖：

• PETG-CF
• ABS
• PETG
• PLA Matte
• PLA+ Bio
• PLA Silk Solid
• TPU
• PLA-CF

注意：彩多屋 HEX 是从海报图片中采样估算的代表色，不是厂家公布的官方数字色值。

Polymaker

来自 Polymaker 官方 Shopify 商品接口中明确标注 HEX Code 的条目。

覆盖：

• PolyLite PLA
• PolyMax PLA
• PolySonic PLA
• PolyLite LW-PLA
• Panchroma Matte PLA
• Panchroma Satin PLA
• Polymaker PETG
• PolyLite Translucent PETG
• PolyMax PETG
• PolyLite ABS
• Polymaker ASA
• PolyFlex TPU90
• PolyFlex TPU95
• PolyFlex TPU95-HF

注意：没有官方 HEX Code 的 Polymaker 颜色会被跳过。

工作原理

图片或 HEX
  ↓
本地提取主要颜色
  ↓
从 sRGB 转换到 CIE Lab 色彩空间
  ↓
使用 CIEDE2000 计算感知色差
  ↓
与内置耗材参考色比较
  ↓
输出最接近的材料、颜色名、HEX 和 HTML 色卡

普通 RGB 数值距离并不完全符合人眼感受。CIEDE2000 会综合考虑亮度、色相和饱和度，因此更适合做视觉近色匹配。

快速安装

仓库地址：

https://github.com/tonyljl526/bambu-filament-color-match

通用安装：Codex、OpenCode、Gemini CLI

这些工具通常都支持 .agents/skills 路径：

git clone https://github.com/tonyljl526/bambu-filament-color-match.git \
  ~/.agents/skills/bambu-filament-color-match

使用一键安装脚本

git clone https://github.com/tonyljl526/bambu-filament-color-match.git
cd bambu-filament-color-match

安装到用户全局目录：

./install.sh codex
./install.sh claude
./install.sh opencode
./install.sh gemini
./install.sh universal

安装到当前项目：

./install.sh codex --project
./install.sh claude --project
./install.sh opencode --project
./install.sh gemini --project
./install.sh universal --project

如果目标目录已存在，追加 --force 覆盖安装。

分工具安装

OpenAI Codex

推荐安装到通用 Skills 目录：

git clone https://github.com/tonyljl526/bambu-filament-color-match.git \
  ~/.agents/skills/bambu-filament-color-match

旧版 Codex 环境可安装到：

./install.sh codex-legacy

调用示例：

使用 $filament-match，根据这张图片匹配拓竹官方耗材颜色并生成色卡。

Claude Code

git clone https://github.com/tonyljl526/bambu-filament-color-match.git \
  ~/.claude/skills/bambu-filament-color-match

或：

./install.sh claude

OpenCode

git clone https://github.com/tonyljl526/bambu-filament-color-match.git \
  ~/.config/opencode/skills/bambu-filament-color-match

或：

./install.sh opencode

Gemini CLI

gemini skills install \
  https://github.com/tonyljl526/bambu-filament-color-match.git \
  --consent

或：

./install.sh gemini

Windows PowerShell

git clone https://github.com/tonyljl526/bambu-filament-color-match.git `
  "$HOME\.agents\skills\bambu-filament-color-match"

直接运行

即使不使用 AI Agent，也可以直接运行 Python 脚本。

查看拓竹色库：

python3 scripts/match_colors.py --brand bambu --list

查看彩多屋色库：

python3 scripts/match_colors.py --brand caiduowu --list

查看 Polymaker 色库：

python3 scripts/match_colors.py --brand polymaker --list

根据 HEX 匹配：

python3 scripts/match_colors.py \
  --brand polymaker \
  --hex "#0056B8,#FEC600,#C12E1F" \
  --top 3

根据图片匹配：

python3 scripts/match_colors.py \
  --brand bambu \
  --image "/absolute/path/to/image.png" \
  --colors 6 \
  --top 3 \
  --html "/absolute/path/to/color-match.html"

生成完整 HTML 色卡：

python3 scripts/match_colors.py \
  --brand polymaker \
  --catalog-html "/absolute/path/to/polymaker-color-card.html"

参数说明

数据可信边界

• 拓竹：来自 BambuStudio 官方仓库数据快照。
• 彩多屋：来自用户提供海报图片采样，适合近似参考，不等同于官方数字色值。
• Polymaker：来自官方商品页中的 HEX Code，未带 HEX Code 的商品颜色不收录。
• 所有 HEX 都是数字参考色，不保证实物打印完全一致。光线、相机白平衡、材料表面、层纹和打印参数都会影响观感。

详细来源见：

references/data-notes.md

目录结构

bambu-filament-color-match/
├── SKILL.md
├── agents/
│   └── openai.yaml
├── references/
│   ├── bambu-filament-colors.json
│   ├── caiduowu-filament-colors.json
│   ├── polymaker-filament-colors.json
│   └── data-notes.md
├── scripts/
│   └── match_colors.py
└── install.sh

许可

本项目使用 AGPL-3.0 许可证。第三方品牌名称和色值数据归各自权利方所有；本仓库仅作为离线匹配与展示工具。