Labelme Point 高效标注器

独立的 Python 小工具，用来高效编辑 Labelme JSON 里的 Point 标注。矩形、多边形等其它形状会原样保留。

使用方法

1. 确认已安装 Python 3。首次使用如果缺少 Pillow，在命令行运行：python -m pip install Pillow。
2. 双击 启动工具.bat，或运行：python labelme_point_batch_delete.py。
3. 打开文件夹、Labelme JSON，或直接打开图片（同名 .json 会自动带上；没有则新建空标注）。
4. 打开文件夹后，右侧会列出文件夹内所有图片，双击文件名或点击“上一张/下一张”即顺序标注；同名 .json 自动加载。
5. 程序会按 JSON 内嵌图、imagePath、以及与 JSON 同名的图片依次找图；找不到时再点“选择对应图片”。

操作

• 左键空白处：连续加点（使用顶部当前 Label，不弹窗）；Ctrl 或 Shift + 点击空白处不加点，避免误操作
• P 或工具栏「划线加点」：进入划线模式，按住左键在图上拖动自由划线，相邻点按设置的间距自动连成一片点（手抖/回笔不会叠加出多余点），松开后整段作为一次操作（Ctrl+Z 可整段撤销）；单击加一个点；Esc 退出。
  • Shift + 拖动：画直线，起点和终点使用鼠标实际位置；拖动过程中只显示虚线预览，松开后按设置间距均匀补点
  • 是否直线只看按下时是否按住 Shift：拖动中途按/放 Shift 不会改变本次划线，提前松开 Shift 直线也会正常完成
• Shift + 点击两次：画两点间的直线点阵——第一次点击锁定起点，移动鼠标显示虚线预览与像素距离，第二次点击画出整条直线；画完后自动以终点为下一次起点，可连续接着画。第二次点击若落在起点附近（画布上 ≤8px）会视为重复点击，不会破坏已锁定的起点，也不会画出偏移短线
• 拖动/预览时底部状态栏实时显示「起点→光标 像素距离」「期望点距」「均分点距」「段数/总点数/补间点数」；计算基准在「设置」里调整
  • 直线点阵除起点外，中间点按设定间距均匀排布，末端即点击处；残段不会短于设定间距的一半，避免末端出现近似重叠的两个点
  • 松开后状态栏会报告本段新增点数、整段总长与点距
• 左键拖点：单点微调；若点已选中则整体移动所选点
• 空白拖框：重新框选；Shift + 拖框 追加；Ctrl + 拖框 移除
• Ctrl + 点击：单点加减选择
• Ctrl+C / Ctrl+V：复制后预览跟随鼠标，左键确认；可连续盖章
• 粘贴 Group：默认保留原 group_id，也可改为新建或不分组
• Delete：删除选中点
• Ctrl+Z / Ctrl+Y：撤销 / 重做
• A / Ctrl+A：全选当前所有 Point
• 右键或右侧 Groups：设置、新建、检查 Group（选择组与 group_id 是分开的）
• 滚轮：以鼠标为中心缩放；中键拖动平移；F 适应窗口
• 打开文件夹后：← / → 上一张 / 下一张；右侧文件列表双击跳转，✓ 表示该图已有含点的标注
• 放大镜：默认关闭，可随时在工具栏切换 2x / 4x / 8x 开启；按下默认快捷键 M 可在「关 ↔ 默认档位」间切换
• Ctrl+S：保存到当前 JSON；另存为不会强制加后缀
• 关闭未保存文件时会提示，但不对 .json 做任何自动保存
• 底部状态栏显示点数、已选数、Group、缩放比例；操作后短暂提示结果（如"已添加 Point"、"已撤销"）

设置

• 菜单「设置 → 设置…」（快捷键 Ctrl+,）可配置：
  • 放大镜默认档位：关 / 2x / 4x / 8x，决定启动时和快捷键打开时用的档位
  • 放大镜快捷键：如 M、F2、Ctrl+M，按下即在「关 ↔ 默认档位」间切换；留空则不绑定
  • 期望点距：按起终距离除以期望点距四舍五入计算段数，起点和终点固定，其余点均匀分布
• 设置保存在程序同目录的 settings.json（首次保存时自动生成），也可以手动编辑

说明

• 只编辑 shape_type 为 point 的标注；其它字段和形状保持原样。
• 保存结果仍是标准 Labelme JSON。
• 关闭未保存文件时会提示。