为什么Friend Maker官方色绘制如此稳定？84色基本盘与9槽位配置机制解析

• 桌面应用
• 智能硬件
• 固件
• 图像处理

Friend Maker 是一款把图片转成像素网格和 ESP32 控制器脚本、驱动任天堂 Switch 上《Tomodachi Life》自动绘图的 macOS/Windows 工具包。它的官方色绘制模式把图片量化到系统自带的84 色基本盘（7 行 × 12 列），并通过游戏右侧的9 个色盘槽位分批配置颜色——这正是整条绘制链路稳定复现的关键。

什么是官方色绘制？

Friend Maker 提供三条绘制路线：单色、官方色和自定义多色。官方色模式的特点是不自己“发明”颜色，而是直接选用《Tomodachi Life》绘图页内置的基本颜色：

• 基本颜色区域为固定的7 行 × 12 列网格，共84 个可直接选择的基础颜色
• 图片先在网页端被量化（映射）到这 84 个颜色之一
• ESP32 只负责打开颜色页、移动到对应格子并选中——动作完全确定、可复现

这种“颜色集合有限 + 动作有限”的思路，让整条链路非常适合开环控制：不需要摄像头回看屏幕，也能稳定出图。

84 色基本盘：一张写死的颜色表

84 个官方色并不是运行时随机算出来的，而是维护在一份固定颜色表中：

• 完整色表定义在 officialPalette.ts，OFFICIAL_COLOR_GRID就是一张7 × 12的 HEX 颜色矩阵，OFFICIAL_PALETTE将其摊平为 84 项
• 通过officialPaletteCellFromIndex(index)可以把任意颜色索引换算成它在色盘上的row / col坐标，供后续命令直接使用

量化环节在 quantize.ts 中完成：official 模式下，程序把每个像素与 84 个官方色逐一计算色差，取最近的一个（buildOfficialPalettePixelMap），保证“图上显示什么颜色，游戏里就只可能出现什么颜色”。

此外，UI 还允许在8 / 16 / 32 / 64 / 84之间选择官方色量化档位（见 studioColorCountState.js 中的COLOR_COUNT_OPTIONS_BY_MODE）。档位越低，用色越收敛、换色越少，绘制越快、越稳定。

9 槽位配置机制：颜色的“分批快递”

游戏绘图页右侧只有9 个色盘槽位，一次最多只能“随身带走”9 种颜色。Friend Maker 的做法是把图片用到的颜色按 9 个一批滚动配置：

1. 先复位：脚本开始时发送一次BC RESET，让固件内部把 9 个槽位状态重置为游戏默认颜色，保证每次运行的起点一致
2. 按批配置：scanline.ts 中以PALETTE_SLOT_COUNT = 9为批次切分已用颜色，每个颜色生成一条BC <slot> <row> <col>命令，告诉固件“把第 N 个槽位指向基本颜色页第 row 行第 col 列”
3. 状态跟踪：固件侧在 paletteTiming.ts 中维护每个槽位当前所在的row / col，配置时只计算“从当前位置走到目标格子”的步数，避免重复的长距离移动
4. 超时自适配：串口发送器按“槽位选择 + 格子移动”的真实步数估算每条命令的超时时间（estimateBasicPaletteConfigDurationMs），而不是拍脑袋写死，慢命令不会被误判为失败

整个设计可以概括为一句话：颜色选择被建模成一张 7×12 网格上的“走格子”问题——路径可计算、步数可预估、状态可跟踪。

为什么官方色比自定义多色更稳？

对比项目 development-manual.md 中对两条多色路线的分析，官方色路线的优势很清晰：

• 不需要精确调色：自定义颜色需要在编辑页用色相/饱和度/明度滑杆逐格调色（每格都是数十次按键，误差会累积）；官方色只需方向键走到目标格子再按一次A回画布
• 颜色集合有限：84 色是封闭集合，任何颜色都能确定性地落到某个格子，不存在“找不着最近色”的边界情况
• 动作可预测：每个槽位配置所需的时间可以被精确估算，超时、日志、中断恢复（恢复任务会落盘并可续绘）都建立在同一套命令模型上

💡 新手建议：第一次使用选32或64档官方色，画面还原度和绘制速度比较平衡；追求极致速度可以降到16色。

小结

Friend Maker 官方色绘制之所以稳定，靠的不是玄学，而是三件事：一张固定的 84 色基本盘（7 × 12官方色表）、9 个槽位分批配置的滚动换色机制，以及全链路可估算的按键/时间模型。颜色有限、动作有限、状态可跟踪——这就是它“可试用、可复现、可排错”的底气。

如果你还想继续深入，推荐阅读 PRD.md 中关于官方色校准表与后续优化路线的规划。

• 桌面应用
• 智能硬件
• 固件
• 图像处理