用途
Edit Sanitizer 是用户反馈/标注与图像编辑执行之间的失败即关闭（fail-close）边界。它存在的原因是生成式图像编辑器可能比用户预期更多地重新诠释源图。在它产出就绪的 EditContract 之前，不应将局部编辑请求直接发送给 prompt-compiler。
核心规则：将反馈转换为能满足请求的最小显式变更。当存在多个可能目标时，不要将随手涂鸦、箭头、选区、边界框或“修这个”之类短语视为不言自明。
主要能力
- 识别已批准的源检查点（source checkpoint）
- 根据源图尺寸解析标注坐标
- 将标注映射到一个语义目标
- 将用户反馈拆分为原子化的请求变更
- 当请求包含 only、just、this area 等词或暗示有界编辑时，拒绝或否决无关的全局重绘
- 锁定裁剪、画布、透视、身份、精确文字、光照和未受影响的构图，除非用户明确针对其中之一
- 从可编辑目标的补集加上语义锁派生受保护区域
- 设置保守的变更预算
- 阿拉伯语文案修正需要阿拉伯语审查
- 产出类型化的 EditContract
- 仅当状态为 ready 时，才将契约转发给 prompt-compiler
使用方式
标注处理将标注几何与语义意图视为两类独立证据：
- bbox：校验正面积与源边界
- polygon：要求围绕目标区域的有效多边形
- mask_ref：要求实际的掩码引用
- semantic：要求一个清晰可识别的对象或文本区域
- normalized：执行前将坐标转换为原生像素
若两个可能目标的置信度相近，返回 clarify 而非猜测。
防漂移：每次重试都从 source_checkpoint 开始，它必须是最后批准的源。绝不要从失败或明显漂移的渲染结果链式发起第二次修正编辑。最大编辑循环为 3 次。若同一缺陷持续存在或附带改动增加，停止并返回证据，而不是继续破坏性编辑。
有界编辑否决条件：
- 局部编辑同时要求重绘整张图
- 存在多个不相关、本应分开编辑的变更
- 目标在源图之外或面积为零
- 标注无法被有把握地映射
- 文案修正缺少精确的替换文案
- 重试源不是已批准的检查点
保留性表述：不要承诺生成式编辑器能实现字面上的像素一致。要求编辑目标之外保持实质稳定，并在执行后校验附带改动。
运行辅助命令：
python3 ../../shared/scripts/sanitize_edit.py < edit-request.json
输出
返回 EditContract 以及简短的执行判定：
- ready：可以进入 Prompt Compiler
- clarify：提出一个关于目标/范围的问题，不执行
- reject：几何/源/文案契约无效，不执行
- veto：变更请求冲突或范围过宽，不执行
适用场景
适用于标注引导的编辑、inpainting、文案修正、局部修图和对象替换等局部图像编辑场景，尤其是需要防止生成式编辑器过度改写源图、需要将模糊反馈收敛为明确变更契约的场合。
限制
- 不承诺生成式编辑器实现字面像素一致
- 同一缺陷持续或附带改动增加时最多尝试 3 次编辑循环，之后停止
- 阿拉伯语文案修正需要阿拉伯语审查
- 具体安装方式、收费与平台支持等信息暂未提供