明暗失衡时应调整shade_factor、启用双边滤波、分区域掩膜及切换灰度算法：shade_factor调至0.03~0.07适配图像类型；开启双边滤波（直径9，sigma75）抑制噪点；上传匹配分辨率的单通道掩膜实现局部tone mapping；逆光人像优选YUV灰度化以保留阴影细节。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您在使用ShadeAI处理图像时发现画面明暗失衡、局部过曝或阴影细节丢失，则可能是由于明暗色调映射参数未适配当前图像的光照分布。以下是实现明暗色调平衡的多种技术路径：
一、调整shade_factor参数控制阴影强度
shade_factor是ShadeAI中直接影响明暗对比的核心参数，其数值越小，阴影层越柔和、整体明暗过渡越平缓；数值越大，阴影越浓重、暗部细节越易被压暗。该参数直接作用于OpenCV pencilSketch()函数的底层阴影生成逻辑。
1、在Web UI界面上传图像后，点击“高级参数”展开区域。
2、找到shade_factor滑块，初始默认值为0.05。
3、对人像类图像，将值调至0.03~0.04以保留面部阴影层次；对高对比建筑图像，可提升至0.06~0.07增强结构纵深感。
4、每次调整后点击“实时预览”，观察灰度图中颈部、眼窝、屋檐下等典型阴影区域是否出现细节断裂或泛灰。
二、启用双边滤波预处理抑制明暗噪点
原始图像若存在传感器噪声或压缩伪影，会在阴影区域被shade_factor放大，导致颗粒感过强或色阶跳变。通过前置双边滤波（bilateralFilter），可在不模糊边缘的前提下平滑明暗过渡带，为shade_factor提供更干净的输入基础。
1、在参数面板中开启“启用预处理滤波”开关。
2、设置滤波直径为9，空间sigma为75，色彩sigma为75。
3、确认滤波仅作用于灰度通道，避免彩色铅笔风格输出出现色偏。
三、分区域应用明暗权重掩膜
全局统一的shade_factor难以兼顾图像中不同光照条件的子区域。通过加载自定义掩膜（mask），可对天空、人脸、地面等区域分别指定明暗响应权重，实现局部tone mapping。
1、使用任意绘图工具创建单通道PNG掩膜：白色区域代表高权重（增强阴影），黑色区域代表低权重（抑制阴影），灰色为线性插值过渡。
2、在ShadeAI上传区下方点击“上传明暗掩膜”按钮，选择该PNG文件。
3、确保掩膜分辨率与原图严格一致，否则系统将自动拒绝并提示“掩膜尺寸不匹配”错误。
四、切换灰度映射算法类型
ShadeAI内置两种灰度化策略：cv2.COLOR_BGR2GRAY（标准加权平均）与cv2.COLOR_BGR2YUV后取Y通道（亮度感知更符合人眼）。后者对暗部敏感度更高，在低照度图像中能保留更多阴影纹理，但可能弱化高光锐度。
1、在“色彩处理”下拉菜单中选择“YUV亮度通道灰度化”。
2、对比两种模式下同一张逆光人像的耳后阴影与发丝边缘——若后者呈现更自然的渐变而非块状死黑，则说明该模式更适配当前图像。
3、注意该选项仅影响素描与彩铅风格，油画与水彩风格强制使用BGR2GRAY以保障色彩保真度。
