摘要：桌面数字人讲师绿幕抠像实修记录：待机帧背景实测偏青绿(82,255,84)而键控钉死纯绿，半透明绿雾怎么调阈值都在；登记实测键色修好待机后，一句’她一说话绿又回来了’暴露真相——待机与说话是两条通路、两套色相的背景。最终抠像着色器改双键取最近距离，全帧仿真四项全过。附途中一张预览图丢进装帧目录把引擎搞崩的事故与症状识别公式。
摘要：桌面数字人讲师做透明合成，绿幕边缘怎么都抠不净。帧像素没错、抠像参数也没错，修好了 yet 被一句”她一说话绿又回来了”点破——待机与说话根本是两条视频通路、两套不同色相的背景素材。本文记录量色取证、双键抠像着色器，和途中自己挖坑把引擎搞崩的那次事故。
一、现象：同一批生成的三位老师，只有她不干净
背景：一批 AI 英语老师数字人，桌面客户端是一个置顶半透明窗口，人物视频由前端 WebGL 绿幕键控（chroma key）融进桌面。素材是图生视频模型逐条生成的：绿幕背景、5 秒循环、每位老师一条约 123 帧。
三位老师同一套提示词、同一条流水线出来。接通后两位合成得干干净净，人物直接坐在桌面上；只有一位周身一圈明显的绿色雾边，无论怎么调相似度阈值都藏不住。
第一个反直觉的事实：绿幕未必是那个标准纯绿。
逐帧量色：出问题的老师待机帧背景聚在 RGB(82,255,84)——偏青的鲜绿；另两位的背景才贴近纯绿。前端键控把键色钉死在纯绿，软阈值透明线定在距离 0.55，她的背景离键色距离 0.519，恰好卡在半透明区间——alpha 约 0.64，整层背景变成一片半透明绿雾盖在桌面上。人眼看到的是”绿边没抠净”，实际上帧像素完全没错，错的是键色不匹配这条素材。
这里还有个正确取舍：不动帧像素。 曾试验把偏青绿线性归一成纯绿的全帧方案，仿真结果直接否决——肤色蓝/红通道被压暗 45/37 个色阶，人物整体色偏垮掉。绿幕问题在合成层解决，绝不回头改源素材。
修法是给每位老师按实测色登记专属键色（一行配置表），她拿到实测值。重启客户端，待机背景 alpha 从 0.64 归零。
二、复验：待机干净了，她一开口绿又回来
决策人试用后反馈：”待机没问题，她一说话绿幕就回来。”
这一句暴露了一个外部看不见的结构事实：数字人有”待机循环”和”说话合成”两条视频通路，两条通路的背景不是同一套素材。待机用新抽的偏青绿幕；说话帧的背景来自旧人物资产库，是标准纯绿。也就是说这位老师机器里实际存在两种背景：偏青绿和纯绿。
单键 shader 下：待机通路干净了，说话通路背景离新键色距离 0.464，alpha 反而涨到 0.826——绿雾更浓。第一轮只修了一半，因为眼里只有”新装的素材”，没去量”另一条通路还在用旧资产库”。
真正修法是键控着色器改双键取最近距离：
float d = min(distance(c.rgb, key), distance(c.rgb, key2));
float a = smoothstep(d, 0.175, 0.550); // 阈值保持很紧, 背景是平坦色块
float spill = max(max(c.r,c.b),0.22) - c.g;
c.rgb = clamp(c.rgb - vec3(0.0, spill, 0.0) * 0.9, 0.0, 1.0); // 绿溢出压制
gl_FragColor = vec4(c.rgb * (a*0.92+0.08), a);
key = 该老师登记的实测色，key2 = 恒为纯绿兜底。任何一条通路的背景都会被”更近的那个键”打透明；人脸、皮肤、嘴唇离两个键都远（距离全在 1.0 上下），透明度不受损失。没登记实测色的老师两键相同，min() 退化成原行为——零风险升级。
全帧仿真验证四项全过：待机背景 alpha=0.000、说话背景 alpha=0.000、皮肤=1.000、嘴唇=1.000；另两位只用纯绿的老师双键下同样不退化。重启前端，实机复验：待机干净，说话也干净。
三、自己挖的坑：一张预览图丢进装帧目录，引擎崩循环
修复过程中我生成了一张合成预览 jpg 想看效果，随手丢进了引擎的帧装帧目录。读帧代码按文件名转数字排序，撞上 jpg 文件名直接异常——实例起不来，看门狗无限重拉，客户端每 5 秒建一次会话随即销毁，表现为永远”连接失败”。
症状识别公式值得抄：看门狗反复 LAUNCH + 引擎日志每 5 秒一条建会话且零出帧率 = 实例死在加载期，根本没活到出流。第一嫌疑：目录里混进了非帧文件。
配套铁律：装帧目录只准放编号帧，调试产物一律进工作区。随手一张图，自救半小时。
四、可以直接抄走的五条经验
- 绿幕键控参数按素材登记，不要全局钉死。生成模型产出的”绿幕”每条色相都有随机偏移；接入前逐帧采样四角背景做聚类量色，色相不符就登记实测键色，而不是动帧像素。
- 数字人多通路要逐条通路验证背景。待机/说话（乃至聆听、大误差兜底）常常来自不同素材集——只修一条通路等于修一半，”盘上测量干净但肉眼仍有绿”就是测量对象和观看对象不是同一条通路的硬信号。
- 抠像 shader 从一开始就该写成多键取最近距离 + 绿通道主导去溢出。单键是这次返工的根因；多键对单色素材完全无损。
- 合成层与源素材解耦。键控问题在键控层解决；全帧色域归一会连带压暗肤色通道（实测 45/37 色阶），是废案。
- 验收必须走真实通路：磁盘帧仿真只是中间证据，最终以”切到那位老师、说一句话”的实机表现为准。
