CURRENT UI MANUAL · OBS BRIDGE SCHEMA 36

金易音视·调色大师完整使用指南

本指南以当前软件真实运行界面和实际参数模型为依据，覆盖安装、全部菜单、7 类 24 个工具、节点、示波器、OBS 连接、参数作用、操作逻辑与故障排查。

24当前实际工具
7工具分类
Schema 36客户端 / Bridge 协议
OBS 29–32当前已验证范围

截图：rc182 滤镜卡片来自真实 Qt 面板，缩略图由同一张 AI 人像实际应用各款 LUT 生成。其余明确标注 rc177、rc176 或 OBS 的图片为历史实机记录，不冒充新版或直播画面。

选择调色位置

在“来源”按场景展开并选择来源，再选择调色层。“管理”窗口上方显示当前选择，底部“去调色”进入编辑；“更多操作”包含批量、复制、移动、重置、删除和备份恢复。切换编辑对象不切换播出场景；共用来源会影响引用它的所有场景。

批量处理与恢复

批量操作只作用于勾选的调色层。删除调色不删除 OBS 来源；移动后原层保留参数并关闭。恢复原层前先关闭目标副本，避免叠加。OBS 对象被删除或改名时，旧列表与待确认操作失效，请点击“刷新列表”后重新选择；切换配置或场景集合后重新打开管理。

取样与遮罩

精确调色选“节点精确取样”；吸桌面或其他软件选“桌面参考取样”。黄色框内像素参与区域取样，不只取十字中心。

为什么其他位置也被选中？

限定器按颜色和亮度选取，不识别“嘴唇”或“皮肤”语义；同色物体可能同时进入遮罩。只调局部时配合区域窗口。白色遮罩表示命中，黑色表示排除。

节点取样使用当前工具输入。桌面参考取样读取显示后的颜色，可能包含屏幕色彩处理和后续效果，不等于原始节点像素。精确取样目前支持 SDR、最长边不超过 4096；不支持的输入会提示，不会冒充精确取样。

打开取样窗后若参数或目标改变，请重新取样。自动白平衡应选中性灰白，曝光取样不保证任意彩色物体都适合自动校正。

一、安装、升级与卸载

支持边界

项目当前说明
系统Windows 10 / 11 x64。
OBSOBS Studio 29、30、31、32 x64 是已验证范围。低于 29 会阻止安装 Bridge；高于 32 会显示中文风险提醒，默认取消，但用户可以确认继续。继续后应先在测试场景验证插件加载、画面和稳定性，再用于正式直播。
组件桌面客户端、金易音视 OBS Bridge 插件、Bridge effect、VC++ 运行库。
候选版版本号含 -rc 表示发行候选版；未签名、未安装或未上线时不能称为正式发布。
安装前：保存直播工程，完全退出调色大师与 OBS。任务管理器仍有 OBS 或旧客户端进程时不要覆盖插件。
安装：运行 Setup，保留“OBS 实时调色插件”组件。Windows 请求管理员权限属于向 Program Files 与 OBS 插件目录写入文件。
首次启动：先启动 OBS，再启动调色大师。登录后顶部会显示识别状态；进入“来源”选择来源和专业调色滤镜。
便携版：解压完整 ZIP 后双击“启动金易音视调色大师.cmd”。需要手动补装插件或运行环境时，使用根目录中对应的中文入口；不要只复制 EXE。
动作会发生什么不会发生什么
覆盖升级替换程序和 Bridge 文件；用户预设、布局、恢复数据继续保留。安装器不会强制关闭正在直播的 OBS。
回滚安装失败时按安装器备份恢复上一版本程序文件。不能把“文件已备份”误认为已经验证所有 OBS 版本。
卸载移除程序和已安装插件。默认保留当前用户的预设、布局、日志与崩溃报告，便于重装恢复。

二、当前软件界面与工作区

rc182 来源工作流：“调色对象 / 预设 / 滤镜”是三个页面。先在“节点”选中要处理的调色节点，再点选滤镜卡片；只改变当前节点的 LUT，不覆盖其他节点或其他调整。个人文件从“调整 → 3D LUT”导入，两处共享同一节点的滤镜与强度。

rc182 原生滤镜面板，同源人像方卡与无滤镜入口
16款近似重制滤镜随安装包提供，无需单独下载；“无滤镜”只旁路当前节点的 LUT。
滤镜使用与色彩说明

原生、焕肤、冷白皮、正常、白皙·清透、超白、初恋、奶油、清纯、蓝调、气色、白皙·柔光、冷白、奶茶、美味、胶片。它们是参考色彩效果拟合的近似重制，不是第三方厂商原版，不代表官方合作。缩略图为100%强度，实际画面受光线、白平衡、输入色彩空间和前级节点影响。“正常”与“清纯”在100%时的颜色映射相同，可用不同强度获得不同表现。请先将LOG/HDR正确转换，再使用面向SDR的创意LUT。

升级不会替换旧工程引用的个人文件或缓存，重新点选新卡片才应用新LUT。每个节点独立保存文件、强度和启用状态；单节点、全部节点预设及完整调色导出都包含有效LUT。单文件上限32 MiB，去重原始总量256 MiB、压缩总量64 MiB；已验证五个节点分别加载大尺寸LUT后换目录恢复。超过限制会明确报错。

保存与换电脑：滤镜应用强度只控制 LUT，节点强度控制整个节点，两者独立保存。单节点预设替换当前节点；全部节点预设恢复节点链，但不覆盖当前输入输出技术设置。“文件 → 导出完整调色”携带整套设置及有效 LUT 内容，导入时不依赖原电脑路径；损坏或超限文件会提示错误，不应忽略。旁路保留参数，不等于删除滤镜文件。

rc177 来源树
来源按场景展开；调色层与管理入口在下方。
rc177 历史预设筛选
按来源、节点范围和风格筛选。rc178 底部为保存、应用、删除；同名覆盖需确认。完整调色导出和复制可携带 LUT。
区域作用使用逻辑
顶部状态栏OBS 状态、重新识别、当前目标、布局、监看、撤销/重做、全局锁、查看原图、账号。“OBS 已连接”只表示控制通道正常；还要确认来源、滤镜与 Bridge Schema。
画面监看可选择“所选来源”逐个检查某个 OBS 源，也可选择“OBS 节目输出”检查当前节目场景最终合成；支持清晰/静帧、缩放与适配。来源模式跟随该源在 OBS 场景中的旋转、镜像和方向；节目输出模式显示 OBS 最终合成。监看分辨率不改变 OBS 输出分辨率。
工具轨道24 个真实工具的图标入口。宽屏显示轨道；窄屏改为可搜索下拉。可在“调色 → 工具栏显示”自定义。
来源选择 OBS 来源、滤镜、创建专业滤镜、刷新与连接设置。先选来源再选滤镜；参数只发送给顶部显示的当前目标。
调整编辑当前选中 Corrector 节点的一套完整 GradeState。切换节点后，24 个工具会一起切换到该节点的参数。
示波器按真实帧显示波形、矢量、直方图和色度分布。显示设置不改变 OBS 画面；隐藏面板时会降低不必要的分析开销。
节点建立串行、并行、图层和键混合 DAG。Corrector 保存调色；Mixer 只混合输入；Input / Output 是技术边界。
2.3.14-rc176 竖向单侧四主色轮工具台
rc176：窄屏按单列滚动，完整保留参数、复位与锁定。

三、通用控件操作方式

控件操作影响与保护
阶段电源点击工具标题右侧电源键启用/旁路该阶段。只旁路当前工具阶段，不会清空参数；再次启用恢复原值。
高级设置点击带三角的分组标题，展开分析图或低频选项。展开或收起低频高级选项；不会重复放置常用操作。
阶段重置点击标题栏最右侧的回转箭头图标。重置当前阶段，可用 Ctrl+Z 撤销；按钮不重复显示“复位”文字，并与电源、“已调”和独立工具保持同一基线。
已调 / 独立“已调”集中查看本节点实际改动；“独立”把调参时需要持续观察的当前可视化置顶。普通工具只带出可视化；Log、HDR、限定器、网格等范围型工具会同时带出直接定义图形范围的控制参数。分析折叠时也可独立打开；四主色轮整体带出。独立窗口可缩放、最大化，关闭后回到原位置并保留折叠状态。一次保留一个独立窗口，切换分类后点击独立会改为当前分类。两边使用同一模型实时同步。
滑条拖动连续调整；点击数值框可精确输入；右键可复制、粘贴、恢复默认。拖动过程中按限频连续发送到 OBS，不必等鼠标松开。
单参数复位点击参数右侧回转箭头。只恢复这一项；锁定时不允许误改或复位。
参数锁点击每项锁，或顶部锁定全部参数。预设、重置和手动操作会跳过已锁参数。
色轮拖动圆心改变 X/Y 色偏；亮度条改变该分区明暗；双击色轮复位，方向键微调。屏幕方向按连续六色环映射；全局偏移影响整个亮度范围。
范围预览左键按住检查；右键保持。点击“退出遮罩/退出高亮”恢复正常画面。用于看工具权重，不是永久效果；开播前必须关闭。
吸管选“节点精确取样”，再框选当前工具输入画面。按工具语义取白点、黑点、曲线样本、限定颜色或网格节点。

数值阅读：多数 0–1 参数是归一化强度；负值通常表示反向作用；色相 0–1 表示一圈；曝光和 HDR 范围明确使用 stops；亮度输出峰值明确使用 nit / cd/m²。

五、7 类 24 个调色工具

输入与预处理

输入管理、降噪、HDR Zone、细节与质感

基础与一级校正

基础校正、通道混合、CDL 校正、色轮、Log 色轮

明暗与曲线

色阶、曲线

色彩网格

色彩扭曲、色度–亮度网格

选区与遮罩

限定器、区域窗口

创意与风格

色彩分区、分离色调、色温滤镜、黑白混合、可选颜色、特殊调整、渐变映射

LUT 与输出

LUT、输出管理

1. 输入管理

在创意调色之前规范输入范围。黑点/白点决定进入调色链的有效范围，Gamma 修整改变中间调，输入增益整体缩放输入。吸管可从 OBS 帧读取黑、灰、白参考。

参数范围与作用
参数范围默认影响
输入黑点0–0.250抬高后压缩暗端并重新映射黑场。
输入白点0.75–11降低后更早到达白场。
Gamma 修整0.1–41主要改变中间调分布。
输入增益0.25–41进入后续工具前整体缩放。

2. 降噪

当前为空域降噪。先用低强度处理亮度噪声，再按需处理色度斑点；边缘保护和细节恢复用于抑制涂抹。并行分支和较大半径会增加真实 GPU 工作。

参数范围与作用
参数范围默认影响
亮度降噪0–10平滑明暗噪声。
色度降噪0–10平滑彩色噪点。
混合强度0–11原图与降噪结果混合。
边缘保护0–10.65越高越保留轮廓。
细节恢复0–0.750.25回加高频细节。
采样半径1–21增大空间采样范围和成本。

3. HDR Zone

HDR 信号按 OBS 协商出的扩展线性光域分区；SDR 信号会自动映射到可见相对光域，因此直播常用的 Rec.709 SDR 也能使用黑位、暗部、阴影、亮部、高光、镜面高光和全局色轮。每个色轮都有色偏、曝光和饱和度。

参数范围与作用
参数范围 / 默认影响
信号解释自动按 OBS 协商的来源色彩空间选择 HDR 或 SDR 分区模型。
参考白跟随 OBSHDR 时把扩展线性亮度换算到相对曝光分区；SDR 时使用可见相对范围。
各区中心-12–+8 stops；按内置模型移动该分区在曝光轴上的中心。
各区宽度0.25–4 stops；按内置模型控制与相邻区的覆盖范围。
色轮 X/Y-1–1；0对分区加入连续六色方向色偏。
曝光-1–1；0提高或降低该分区曝光。
饱和度0–2；1控制该分区色彩浓度。

4. 细节与质感

2.3.14-rc176 细节与质感工具竖向界面
rc176：按区域调整锐化、柔化与局部对比。
参数范围与作用
参数范围 / 默认影响
亮度锐化0–2 / 0增强明暗边缘，不直接放大彩色噪声。
RGB 锐化0–2 / 0增强 RGB / 色度边缘；过高可能放大彩边。
模糊强度0–1 / 0控制柔化混合量。
模糊半径0.5–4 / 2控制柔化邻域大小，必须与强度配合。
暗部 / 中间调 / 高光细节-1–1 / 0负值柔化、正值增强，只重点作用对应亮度区。
清晰度-1–1 / 0改变中尺度局部对比。
纹理-1–1 / 0改变更细的表面纹理。
去雾-1–1 / 0正值增强空气透视与对比，负值减弱。
朦胧0–1 / 0加入柔化提亮的雾化层。
褪色0–1 / 0抬起黑位并降低反差，形成淡化外观。

5. 基础校正

2.3.14-rc177 基础校正工具竖向界面
rc177：先校正曝光和白平衡，再调整对比与饱和度。
参数范围与作用
参数范围 / 默认影响
色温 / 色调-2–2 / 0校正蓝黄与绿洋红偏色。
色相-1–1 / 0全局旋转色相。
曝光-5–5 / 0以曝光档整体调亮或调暗。
对比度0–4 / 1围绕轴心拉开或压缩明暗。
轴心0–1 / 0.435确定对比度不动点。
黑位 / 阴影 / 中间调 / 高光 / 白位-2–2 / 0分区塑造层次；相邻区域有平滑过渡。
饱和度0–4 / 1全局色彩浓度。
色彩增强-2–2 / 0偏向增强低饱和颜色，保护已饱和区域。
亮度混合0–1 / 1控制色彩处理与亮度保留的关系。

6. 通道混合

红、绿、蓝三个输出通道分别由输入 R/G/B 系数和常数组成；每个输出通道独立计算。

参数范围与作用
参数范围 / 默认影响
R→R、G→G、B→B-2–2 / 1对应输出通道的主输入贡献；默认对角线保持原色。
其余交叉通道系数-2–2 / 0把其他输入通道混入当前输出；负值会反相扣除该颜色贡献。
红 / 绿 / 蓝常数-1–1 / 0向对应输出通道直接加入或减去固定偏移，会连同黑位一起移动。

默认矩阵不改变画面。适合交叉混色、黑白风格与偏色校正；复位当前工具会恢复单位矩阵。

7. CDL 校正

CDL 是影视制作中通用的颜色决策参数，包含增益、偏移、伽马和饱和度。

参数范围与作用
参数组范围 / 默认影响
Slope · 增益 R/G/B0–4 / 1通道乘性增益，主要影响整体和彩色高端。
Offset · 偏移 R/G/B-1–1 / 0通道加性偏移，黑位也会移动。
Power · 伽马 R/G/B0.1–4 / 1主要塑造中间调明暗。
CDL 饱和度0–4 / 1按 CDL 规则控制饱和度。

8. 色轮

2.3.14-rc176 当前四主色轮
rc176：分别调整暗部、中间调、高光和全局偏移。
参数范围与作用
参数范围 / 默认影响
暗部 / 中间调 / 高光 X、Y-1–1 / 0按对应亮度权重加入连续六色方向色偏，相邻亮度区平滑过渡。
全局偏移 X、Y-1–1 / 0对全部亮度范围加入统一色偏。
各轮亮度-1–1 / 0提高或降低该轮负责的亮度范围；全局偏移亮度作用全画面。

范围预览的黑白遮罩中白色表示权重高；彩色高亮保留原图便于定位。双击色轮复位 X/Y，单参数复位只恢复对应数值。

9. Log 色轮

Log 色轮与主色轮使用同一套拖动、数值输入、锁定和复位操作，但允许明确控制暗部与高光分界。

参数范围与作用
参数范围 / 默认影响
暗部 / 中间调 / 高光 / 全局 X、Y-1–1 / 0对 Log 分区或全局加入色偏。
各轮亮度-1–1 / 0提高或降低该 Log 分区的亮度。
暗部边界0.05–0.75 / 0.25决定暗部结束并向中间调过渡的位置。
高光边界0.25–0.95 / 0.65决定中间调结束并进入高光的位置。
过渡柔化0.01–0.25 / 0.10控制分区交界宽度；越高过渡越平滑。

暗部和高光边界不能交叉，模型自动保持最小间隔；范围预览仅用于检查权重，不写入永久画面。

10. 色阶

参数范围与作用
参数范围 / 默认影响
输入黑场0–1 / 0把所设输入值映射为输出黑。
Gamma0.1–4 / 1调整输入黑白之间的中间调。
输入白场0–1 / 1把所设输入值映射为输出白。
输出黑 / 输出白0–1 / 0、1限制最终黑白端点。

11. 曲线

2.3.14-rc176 窄屏曲线工具
rc176：选择曲线类型，再取样或拖动控制点。

基础曲线含主曲线、红、绿、蓝；色彩曲线含色相→色相、色相→饱和度、色相→亮度、亮度→饱和度、饱和度→饱和度、饱和度→亮度；明暗与输出含参数曲线和软剪裁。

参数范围与作用
参数 / 操作范围 / 默认影响
主曲线、R、G、B 控制点输入 / 输出均为 0–1；默认端点 (0,0)、(1,1)主曲线改变整体亮度映射；通道曲线分别改变红、绿、蓝通道。
六条 Hue / Sat / Luma 曲线横轴 0–1；默认中性直线按横轴语义改变目标色相、饱和度或亮度；Hue 域首尾连续。
参数曲线阴影、暗部、亮部、高光 -1–1 / 0按固定亮度区塑造明暗，不需要新增控制点。
软剪裁黑位边界 0–0.25；黑位柔化 0–1；白位边界 0.75–1；白位柔化 0–1在黑白端点附近建立平滑滚降，减少硬裁切。
控制点操作每条最多 12 点单击添加；拖动或方向键移动；Shift / Ctrl 框选后联动移动或删除；吸管按当前曲线语义取样。

12. 色彩扭曲

3 个饱和度环 × 6 个色相区，共 18 个局部节点；吸管会定位最接近当前取样颜色的节点。

参数范围与作用
参数范围 / 默认影响
节点色相位移 H-0.25–0.25 / 0在当前饱和度环与色相区附近旋转色相，邻近节点平滑插值。
节点饱和度位移 S-0.33–0.33 / 0提高或降低当前局部颜色的饱和度，并保持网格在合法半径内。
混合强度0–1 / 1在原图与完整扭曲结果之间混合。

双击或“复位节点”只恢复当前点；重置工具恢复全部 18 点并旁路阶段。网格节点变化会真实进入 Bridge 参数，不是装饰图。

13. 色度–亮度网格

包含“黄↔蓝·亮度”和“青↔红·亮度”两个 4×4 截面，共 32 个节点、64 个节点参数。

参数范围与作用
参数范围 / 默认影响
节点色度位移 C-0.22–0.22 / 0横向移动对应黄蓝或青红色度轴，邻近网格点平滑插值。
节点亮度位移 L-0.20–0.20 / 0纵向提高或降低对应色度与亮度区域。
混合强度0–1 / 1在原图与双截面网格结果之间混合。

窄窗口会把两个截面改为上下排列。复位节点只恢复当前点；重置工具恢复全部节点并旁路阶段。

14. 限定器

rc177 限定器
范围与取样优先；遮罩微调和区域校正按需展开。
参数范围与作用
参数范围 / 默认影响
色相中心 / 宽度 / 柔化0–1 / 0；0.01–0.5 / 0.15；0–0.5 / 0.08建立环形色相范围。
饱和度下/上限 / 柔化0–1 / 0、1；0–0.5 / 0.04限制颜色浓度范围。
亮度下/上限 / 柔化0–1 / 0、1；0–0.5 / 0.04限制明暗范围。
目标 R/G/B0–1 / 0.5RGB 距离模式的目标颜色。
颜色半径 / 柔化0.01–1 / 0.25；0–0.5 / 0.10目标颜色距离与过渡。
色相偏移 / 饱和修正 / 亮度修正-1–1 / 0；-1–2 / 0；-1–1 / 0只对限定区域做快速校正。
遮罩净化 / 混合强度-1–1 / 0；0–1 / 1收缩/扩展净化遮罩并控制效果混合。

支持 HSL、仅色相、仅饱和度、仅亮度和 RGB 距离模式；“肤色范围”、反转、黑白遮罩与高亮用于选区检查。限定器和区域窗口同时启用时取交集。

15. 区域窗口

2.3.14-rc176 区域窗口工具
rc176：用位置、形状和柔化限制调整区域。
参数范围与作用
参数范围 / 默认影响
水平 / 垂直位置0–1 / 0.5移动窗口中心。
旋转角度-180°–180° / 0°旋转形状；线性渐变尤其依赖角度。
宽度 / 高度0.02–2 / 0.75控制覆盖尺寸，可超出画面边界。
羽化0–1 / 0.15柔化窗口边缘。
窗口强度0–1 / 1控制遮罩不透明度。
搜索范围0.02–0.30 / 0.08跟踪每帧搜索半径；越大越耗时。
最低置信度0.50–0.98 / 0.72低于阈值时不接受不可靠位移。

可切换圆/椭圆、矩形和线性渐变；显示轮廓只用于操作提示；反转会交换窗口内外。跟踪有开始、暂停、重新初始化、停止四种动作。

16. 色彩分区

红、黄、绿、青、蓝、洋红六个分区各自保存完整参数；选择哪一种颜色，就只编辑该颜色的范围、色相、浓度和明暗结构。

参数范围与作用
参数范围 / 默认影响
分区中心0–1 / 六色内置中心移动该分区在连续色相环上的目标中心。
分区范围0.02–0.50 / 内置分区宽度控制受影响颜色宽度；相邻分区权重平滑重叠。
色相-1–1 / 0只旋转该分区覆盖颜色的色相。
饱和度-1–2 / 0降低或增强该分区颜色浓度。
明度-1–1 / 0以连续权重降低或提高该分区亮度，内部使用中间精度和输出抖动减少色阶断层。
密度-1–1 / 0改变当前颜色的视觉含量；正值更厚实，负值更轻薄，不等同于简单提高饱和度。
密度深度0–1 / 0决定密度更多进入暗部还是均匀覆盖。
饱和度深度0–1 / 0决定饱和度增强的层次深浅，减少只推表面颜色造成的塑料感。
平衡-1–1 / 0在当前颜色的明暗两侧分配密度和饱和度作用；负值偏暗部，正值偏亮部。

这些参数都归属于当前选中的六色分区。左键按住遮罩或高亮临时检查，松开立即恢复；右键可锁定，再次右键恢复。

17. 分离色调

参数范围与作用
参数范围 / 默认影响
暗部色相 / 饱和度0–1 / 0.62；0–1 / 0向暗部加入所选颜色；饱和度为 0 时保持中性。
高光色相 / 饱和度0–1 / 0.10；0–1 / 0向高光加入所选颜色；饱和度为 0 时保持中性。
平衡-1–1 / 0移动暗部与高光作用的交界。
过渡柔和0.05–1 / 0.35控制暗部色与高光色之间的混合宽度。
混合强度0–1 / 1在原图与分离色调结果之间混合。

18. 色温滤镜

参数范围与作用
参数范围 / 默认影响
滤镜色相0–1 / 0.10选择覆盖画面的滤镜颜色。
颜色饱和度0–1 / 0.70控制滤镜颜色浓度。
滤镜密度0–1 / 0.25控制颜色覆盖量；越高滤镜效果越明显。
保亮度0–1 / 1减少加色造成的整体明暗漂移。
混合强度0–1 / 1在原图与滤镜结果之间混合。

19. 黑白混合

参数范围与作用
参数范围 / 默认影响
红 / 绿 / 蓝贡献-1–2 / 0.299、0.587、0.114改变对应原始颜色转成灰度后的亮度；负值会压暗该颜色贡献。
着色色相0–1 / 0.10选择黑白画面的统一着色方向。
着色强度0–1 / 0控制着色量；0 保持中性灰度。
效果混合0–1 / 1在彩色原图与黑白结果之间混合。

20. 可选颜色

九个目标组为红、黄、绿、青、蓝、洋红、白、中性和黑，每组只影响与其接近的颜色或亮度区域。

参数范围与作用
参数范围 / 默认影响
各目标组的青 / 洋红 / 黄-1–1 / 0在目标颜色中增加或减少对应印刷色分量。
各目标组的黑-1–1 / 0改变目标组的明暗密度，白 / 中性 / 黑组尤其明显。
整体混合0–1 / 1在原图与全部可选颜色修正结果之间混合。

21. 特殊调整

参数范围与作用
参数范围 / 默认影响
反相强度0–1 / 0原图与反相结果混合。
亮度阈值 / 阈值柔化 / 阈值强度0–1 / 0.5；0–0.5 / 0.02；0–1 / 0生成柔和阈值效果并混合。
分离级数 / 分离强度2–32 / 8；0–1 / 0减少色阶级数形成 posterize 效果。

22. 渐变映射

参数范围与作用
参数范围 / 默认影响
暗部色相 / 饱和度0–1 / 0.62；0–1 / 0.75定义渐变低端颜色。
高光色相 / 饱和度0–1 / 0.10；0–1 / 0.45定义渐变高端颜色。
平衡-1–1 / 0移动暗部色与高光色的交界位置。
过渡柔和0.05–1 / 0.45控制两端颜色的混合宽度。
混合强度0–1 / 1在原图与渐变映射结果之间混合。

23. LUT

2.3.14-rc177 历史 LUT 工具
历史 rc177 截图：rc181 增加独立原创风格库，与个人导入分开。

“原创风格”提供 16 款金易独立配方，每个安装用户都可离线选用，首次选择在后台生成并校验文件；无需复制开发电脑上的文件。这些是原创色彩风格，不是 YY 或直播伴侣官方滤镜，也不包含人脸识别、磨皮或美型。用于正常显示的 SDR/sRGB 画面，Log 素材应先进行技术转换。

参数范围与作用
参数 / 状态范围 / 默认影响
CUBE 文件未加载 / 默认有效文件定义 3D 颜色映射；未加载或校验失败时阶段不能启用。
混合量0–1 / 10 为进入此 LUT 前的画面，1 为完整 LUT 效果；其他调色工具不受影响。
阶段电源关闭 / 默认旁路或启用当前节点的 LUT；不会删除已选文件。
本地校验 / OBS 状态未加载 → 已校验 → OBS 已加载只有 OBS 确认已加载并实时渲染，才表示 LUT 真正进入输出。

“个人导入 LUT”保留自有文件选择。浏览有效 .cube 后会校验维度、采样点、TITLE 与 DOMAIN；支持中文路径。文件夹索引最多递归记录 2000 个 CUBE。仅显示文件名不代表 GPU 已使用。强度调整不重新生成或解析文件，重复选择可复用缓存。

24. 输出管理

2.3.14-rc177 输出管理工具
rc177：统一检查输出电平、裁切和曝光辅助显示。
参数范围与作用
参数范围 / 默认影响
黑场下限0–0.20 / 16÷255限制最低视频电平。
白场上限0.80–1 / 235÷255限制最高视频电平。
软裁切0–1 / 0.35在到达上下限前平滑滚降。
色度限制0–1 / 0.75约束过高色度，降低直播越界。
峰值 / 起点 nit100–4000 / 1000；80–3900 / 600HDR 高光滚降上限和开始点。
HDR 滚降0–1 / 0.65控制峰值附近过渡柔和度。
斑马纹阈值 / 强度0.5–1 / 0.95；0–1 / 0.80标记接近过曝区域。
假色强度0–1 / 1控制曝光假色覆盖。

“直播安全”和“HDR 1000 nit”是快速预设。裁切、斑马纹、假色属于不同模式；开播前确认分析覆盖已经关闭。

六、节点工作流与影响范围

2.3.14-rc177 节点工作流
rc177：节点决定处理顺序；选中节点后编辑它的参数。
节点承载内容逻辑
Input技术输入边界不保存创意调色。
Corrector一套完整 GradeState24 个工具、限定器、窗口和节点 LUT 都属于当前 Corrector。
Parallel Mixer多路并行合成分支共享同一上游输入后分别处理，再合成。
Layer Mixer按端口层级合成端口顺序代表层级；支持 12 种混合模式。
Key Mixer键/遮罩混合按键值组合输入。
Output技术输出边界汇总最终结果，不保存创意调色。

画布操作：双击 Corrector 打开工具；右键节点可打开、重置、在前/后添加、添加混合器输入、复制、删除；右键连线删除；滚轮缩放，中键或空格拖动画布，F 适合窗口。“自动整理”只改变布局，不改变处理拓扑。

工具页不是节点外阶段：降噪、HDR、细节、基础校正、通道混合、CDL、色轮、色阶、曲线、色彩扭曲、限定器、色彩分区和 LUT 等左侧图标只是当前调色节点内的工具分类。切换到另一个 Corrector 后，同一批工具会显示该节点自己的参数。

Mixer 的 A/B：新增 Mixer 时，A 路是当前已有画面，B 路是自动创建的中性调色分支。先在 B 路调色，再选中 Mixer 调参与量：并行模式控制 B 路参与量，图层模式控制 B 路不透明度，键控模式控制 B 路键控强度。

新增节点不会清空旧效果：新 Corrector 按中性参数创建，同时编辑焦点会切到这个新节点，所以右侧参数看起来会恢复默认；前一个节点仍在原连线上继续渲染。若 OBS 输出真的回到原图，请立刻打开“OBS → 运行日志（当前 / 历史）”并导出诊断包，当前版本会保留最后一份验证通过的节点图，拒绝用破损或写入一半的节点 JSON 旁路整条调色链。

遮罩边界：限定器与窗口限制当前 Corrector 内的创意处理；输入管理与输出保护是技术边界，不受节点遮罩限制。两个遮罩同时启用时取交集。

七、示波器全部模式与显示设置

2.3.14-rc176 亮度波形界面
rc176：示波器辅助检查亮度和色彩；开播前关闭检查覆盖。

亮度波形RGB 叠加波形RGB 分量YRGB 分量矢量示波器CIE xy 色度RGB 直方图亮度直方图YRGB 叠加直方图YRGB 分离直方图四联示波器

显示设置选项说明
轨迹亮度25%–200%，默认 100%只改轨迹可见度。
余辉关 / 短 / 长保留前几帧轨迹观察抖动和峰值。
刻度视频 / 全范围视频刻度标记 16–235 合法范围；左右显示 IRE 与 8bit 码值。
矢量增益0.75× / 1× / 1.5× / 2×只放大轨迹，参考靶位不变。
肤色线显示/隐藏；90°–150°，默认 123°Rec.709 肤色方向参考。
四联内容四格各自选择任一单视图保存为当前用户显示偏好。
复位显示一键恢复显示偏好不会重置任何调色参数。

八、连接 OBS 与实时桥接

OBS 32.0.1 中真实的金易音视教程场景和人物来源
真实 OBS 32.0.1 窗口：场景“金易音视教程演示”、来源“教程人物素材”和竖屏人物画面均来自本轮独立教程场景，不覆盖用户原场景。
先启动 OBS。OBS 29–32 安装 Bridge 后，“控制按钮”区域会在“设置”下方显示“金易音视·调色大师”，点击即可启动已安装客户端；“工具”菜单保留同名后备入口。连接设置位于“WebSocket 服务器设置”。
在 WebSocket 设置中启用服务器；默认本机端口通常为 4455。身份认证开启时只在本机输入密码，教程、截图和诊断包都不应保存明文密码。
给要调色的摄像机、采集卡或媒体源添加“金易音视·调色大师”滤镜。不要把滤镜误加到其他来源。
启动调色大师并登录；顶部“重新识别 OBS”会读取本机配置并连接，不会关闭 OBS。在“来源”页选择同名来源和滤镜。
打开“OBS → 连接与滤镜诊断”，确认来源、滤镜类型 jyys_color_master_bridge_v1、插件版本、Schema 36 和渲染活动。
调一个明显参数，用“查看原图 / 恢复效果”验证真实像素变化，再恢复中性检查基准。
真实 OBS 32 控制按钮区域中的金易音视调色大师快捷入口
真实 OBS 32.0.1：快捷入口位于“设置”下方，点击启动已安装客户端。
OBS 工具菜单中的金易音视调色大师和 WebSocket 设置
OBS“工具”菜单中的插件入口与 WebSocket 设置，作为控制区结构变化时的后备。
OBS WebSocket 服务器设置
WebSocket 已启用、端口 4455；密码始终遮罩显示。
OBS 来源滤镜窗口中的金易音视·调色大师
真实 OBS 来源滤镜窗口：左侧选中“金易音视·调色大师”，右侧人物预览正常；参数由已登录的独立客户端控制。

用同一帧灰片确认调色确实进入 OBS 输出

对比图必须来自同一人物、同一构图和同一张高分辨率灰片：左侧只关闭“金易音视·调色大师”滤镜，右侧只开启该滤镜。这样才能直接判断灰片恢复、黑白层次、肤色与色卡有没有被真实处理，不能用两张不同照片冒充调色前后。

同一张高分辨率灰片关闭 OBS 调色滤镜时的原始人物帧
调色前：滤镜关闭，低对比、低饱和灰片原样输出。
同一张高分辨率灰片启用 OBS 调色滤镜后的实际输出帧
调色后：滤镜开启，真实 OBS 节点恢复曝光、对比度、色彩和中性肤色；人物、机位与构图未更换。
状态含义下一步
等待 OBS尚未连上 WebSocket。确认 OBS 已启动、WebSocket 已启用、地址/端口/密码正确。
正在确认调色只连上了 OBS 控制端口，专业滤镜还未核验。等待来源和滤镜读取完成；此时不能把连接当成调色可用。
OBS 已连接来源、专业滤镜、插件版本和 Schema 已核验，参数写入通道正常。可开始调色，并用“查看原图”做一次真实像素 A/B。
检测到多个 OBS电脑同时运行两个 OBS 进程，端口可能属于另一个实例。保存工作后只保留一个 OBS，再重新识别。
来源为空OBS 当前没有可调来源或刷新未完成。在 OBS 创建来源，回到客户端按 F5。
滤镜缺失来源没有 Bridge 滤镜。点击创建专业调色或在 OBS 手动添加。
Schema / 插件不兼容客户端与 OBS 实际加载的 Bridge 不是同一版本。完全退出所有 OBS 后，用同一安装包更新客户端与插件，再只启动一个 OBS。
显示已连接但无变化可能选错来源/滤镜、滤镜旁路、旧插件、多个 OBS 或节点图被外部旧版本写坏。打开连接诊断和当前日志，核对版本、Schema、进程数量、滤镜类型与节点图修复记录，然后导出诊断包。

九、预设、版本、恢复与多来源

功能正确用法保护逻辑
单节点预设只替换当前节点的创意调色。保留其他节点和输入输出技术设置。
全部节点预设恢复整套节点与连接。会替换当前节点图；应用前核对范围。
保存名称默认 JYYS-年-月日-时分-秒，可修改。例如 JYYS-2026-0909-1525-58；内置与我的预设分开标注。
LUT 随预设保存保存所引用的有效 LUT，可随预设迁移。文件损坏或超限会明确提示，不会静默丢掉 LUT。
重置节点点击预设区唯一的“重置节点”按钮；不再保留重复的“无滤镜”预设。只恢复当前节点的创意参数，不需要全局重置，也不会删除节点或改动输入输出边界。
A/B 原图临时旁路当前 OBS 滤镜比较原图。不清空参数；滤镜旁路时静帧输出会先安全关闭。
快照 A/B记录两个临时状态，快速恢复比较。与原图旁路不同，快照保存的是调色状态。
命名版本保存带名称的调色版本并从历史恢复。恢复操作进入撤销历史。
本地恢复异常退出后恢复最近自动保存状态。恢复数据与预设分开存储。
多来源同步把当前完整调色发送到多个选定来源。执行前核对目标；不同来源已有参数会被覆盖。
当前 / 历史日志打开“OBS → 运行日志（当前 / 历史）”查看本次和最近 20 次运行，可刷新或打开日志文件夹。记录连接、滤镜、节点、重置、撤销、性能与失败原因；密码、令牌和手机号自动隐藏。
导出诊断包一键打包脱敏的软件日志、近期 OBS 日志、版本、连接与渲染状态。不包含账号密码、WebSocket 明文密码或画面帧；可选是否包含调色参数。

十、常见问题与排错顺序

现象按顺序检查
安装后 OBS 找不到插件确认安装时 OBS 已完全退出 → 确认 OBS 是 29 或更高的 x64 版本 → 高于 32 时确认安装中已选择继续 → 查看 OBS 日志中的 Bridge 版本 → 重新安装同版本组件。
顶部绿色但画面没变来源名称 → 滤镜名称 → 滤镜是否启用 → 类型 ID → Schema → 当前节点是否旁路 → 参数是否为中性 → A/B 像素差。
LUT 没效果CUBE 本地校验 → 阶段电源 → 混合量 → OBS 运行状态 → 文件路径仍存在 → A/B。
限定器影响全画面确认限定器阶段启用 → 黑白遮罩范围 → 是否反转 → 柔化是否过大 → 当前调整是否属于该 Corrector。
节点切换后参数不同这是正常节点语义；每个 Corrector 有独立 GradeState。确认顶部/底部显示当前节点编号。
付款窗口没有二维码先阅读窗口中的支付渠道错误，不要重复关闭重开。保持套餐和付款方式不变时，“重新生成付款码”会重试同一订单，不会新增重复订单；切换套餐或付款方式后才开始新的付款尝试。
窗口跟踪丢失重新初始化 → 增大搜索范围 → 降低但不要过度降低最低置信度 → 确保目标有纹理且移动不超出范围。
GPU 占用高关闭无用并行分支 → 旁路无用工具 → 降低降噪半径/强度 → 隐藏不需要的示波器 → 检查 4K/HDR 路径。
监看帧率低于 OBS先看底栏传输类型和目标 fps。代理监看或 WebSocket 截图帧率不等于 OBS 输出帧率。
界面窄时找不到工具使用“调整”页顶部搜索下拉，或“调色”菜单；竖向布局需要滚动，不会删除功能。
更新失败旧版若提示更新清单签名失败，请从官网下载并安装 rc183 或更新版本；无需删除已有配置。其他更新失败先确认包签名/哈希、磁盘与权限；不要混装不同版本 DLL。

十一、正式开播前检查单

□ 客户端账号和设备授权有效
□ OBS 29–32 已验证，或更高版本已完成测试场景验证
□ 来源和滤镜目标正确
□ 诊断显示 Schema 36 与活动渲染
□ 明显参数产生真实像素变化
□ 节点串行/并行路由符合预期
□ LUT 显示 OBS 已加载
□ 限定器/窗口只影响目标区域
□ 黑白遮罩和彩色高亮已关闭
□ 斑马纹、假色、查看原图已关闭
□ 锁定不希望直播中变化的参数
□ 录制 30 秒，音画和跳帧正常

完成检查后再开始正式直播。遇到无法解释的状态，先导出诊断包，不要在直播中反复重装或强制结束 OBS。