在定制家居与装饰材料行业，客户选材长期依赖纸质色卡、实物小样和静态效果图，这套方式有三个绕不开的问题：色卡只有巴掌大，看不到材质铺在整面柜体、背板、台面上的真实效果；效果图是离线渲染，客户想换一个颜色就要重新出图；一旦在门店改了主意，往往要重新打样、重新排产，周期和成本都压在厂商身上。销售在门店、展会现场缺少能当场把"换一下这个木纹"呈现出来的工具，沟通全靠语言描述，理解偏差最终都变成返工。
配色家面向定制家居品牌、装饰材料厂商与设计门店，把材质选择从"翻图册"变成"实时看效果"：在真实的三维展厅场景中，客户说出想要的感觉，销售人员当场在柜体的不同部位替换材质，纹理、反射与光照实时变化，并可保存成方案、导出图片与视频交付。项目立项的核心目的，是解决选材环节的沟通效率与成单率问题——把原本需要数天的打样确认压缩到几分钟，同时显著减少因理解偏差导致的返工与材料浪费。
配色家是一套运行在 Windows 上的三维实时选材演示系统，主要包含以下功能模块：
一、三维展厅与场景管理。内置可替换的展厅场景包，支持场景切换、场景内自由行走与定点传送，适配不同客户的展厅风格。
二、CMF 材质库。按材质类别组织色卡与贴图，支持关键词检索、材质预览图生成，并可直接导入第三方 ZIP 材质包，系统自动完成解压、贴图转换与入库。
三、分区换材。将柜体拆分为上柜板、下柜板、背板、地板、整体柜板、台面等多个独立控制区域，每个区域可单独替换材质并保留各自的选择记忆；同时支持按客户需求定制区域数量与通道映射。
四、实体交互硬件。支持 NFC 材质卡片——把实物样卡放在读卡器上即可切换对应材质；支持外接旋钮控制器逐区切换；并联动串口 LED 灯带，用灯光指示当前控制区域。
五、视角与巡游。可保存任意观察视角，设置传送点位与镜头轨迹，支持一键自动巡游，用于无人值守的门店展示。
六、方案与内容交付。整套材质搭配可保存为方案随时复原；支持导出高清图片与视频。
七、客户端能力。包含账号登录、中英双语切换、离线运行、增量自动更新与一键安装。
我主导技术方案与核心开发：桌面客户端架构、三维程序与界面集成、硬件接入、打包发版全链路。
技术栈：Electron + React + TypeScript + Vite，Unreal Engine 实时渲染，Node.js 主进程，Inno Setup 打包。
关键实现：
1. 双层窗口集成。Electron 全屏透明窗口作 UI 层，通过 Windows 窗口父子关系把三维程序嵌入下层，实现 UI 悬浮在实时画面之上。
2. 鼠标穿透状态机。覆盖层会挡住三维场景操作，改为以主进程为唯一事实来源，状态广播 + 光标轮询双向兜底，保证控件可点、场景可拖，互不干扰。
3. 指令通道。界面与渲染端走 UDP + JSON，按区域编号下发材质目录、切换视角、保存视角，渲染端回传执行结果。
4. 硬件接入。集成 NFC 读卡器、多路串口与全局键盘钩子，把物理卡片、旋钮输入映射为区域切换与材质加载，并处理热插拔与断连重连。
5. 增量更新。增量包与完整包双形态，断点续传 + SHA-512 校验 + CDN 缓存刷新，避免边缘节点返回旧包导致升级失败。
6. 安装期权限。装到 Program Files 后普通用户不可写，安装阶段对数据目录批量授权，解决素材保存失败。
7. 多构建变体。同一套代码用构建参数派生标准版与客户定制版，区域数量、通道映射、安装身份、更新策略差异化且互不影响。
难点集中在窗口层级与输入事件的归属判定、硬件热插拔的稳定性、CDN 缓存下升级包的一致性。
评论