用途:对已固化的位图做可控的小范围局部编辑,只处理指定矩形区域,避免整图 AI 重绘。
主要能力:按矩形区域做像素级覆盖;未指定覆盖色时从覆盖框周围采样中位数颜色;可写入新文字并设置颜色、字号、字体、描边;支持 padding 扩张覆盖框;可生成红色像素遮罩辅助定位红色文字或标注。
使用方式:先安装依赖 pip install -r resources/requirements.txt;创建 JSON 配置,每个替换项含 file、cover([left, top, right, bottom]),可选 text、text_xy、font_size、font、fill、background、padding、stroke_width、stroke_fill;先输出到预览目录 python3 scripts/apply_local_replacements.py ./images replacements.json -o ./preview-images,确认后用 --overwrite 覆盖原图;定位红色标注可加 --red-mask-dir ./red-mask。
适用场景:替换图中编号、标签、日期、小段文字;遮盖局部敏感信息;清理旧字符残影;修补地图、工程图、截图中的小块错误。
限制:不适合需要理解复杂语义、重建大面积背景、补全缺失物体、改变风格或生成新画面的任务;坐标均为像素坐标,需先预览定位最小矩形区域,并逐张检查残留、遮挡与颜色突兀问题。输出图应与原图宽高一致、文件名不变、未选中区域保持不变。