一、安装部署：多系统环境配置
1. 克隆仓库
克隆仓库：git clone ``https://github.com/CVHub520/X-AnyLabeling
二、核心功能操作：从标注到导出
1. 界面快速认知
左侧面板：文件管理、手动标注工具、标签编辑、自动标注模型区
中央画布：标注主区域，支持缩放（Ctrl + 滚轮）与导航（F9 打开缩略图）
右侧面板：标签属性编辑、图像描述输入、筛选器
状态栏：实时显示光标坐标、标注数量统计
2. 数据导入
单图导入：拖拽图像至画布或通过「文件→添加图像」
批量导入：选择「文件→添加文件夹」，支持 JPG/PNG 等主流格式
视频导入：直接添加 MP4 等视频文件，自动解析为帧序列
3. 手动标注：7 种样式全覆盖
| 标注类型 | 快捷键 | 操作方法 | 适用场景 |
|---|---|---|---|
| 矩形框 | W/R | 拖拽鼠标框选目标，松开确认 | 基础目标检测 |
| 旋转框 (OBB) | O | 框选后拖动角点旋转，Z/X/V/C 调角度 | 航拍目标、倾斜物体检测 |
| 多边形 | P | 依次点击顶点，双击闭合 | 实例分割、不规则目标 |
| 点 | 无 | 点击标记关键点 | 姿态估计、特征点检测 |
| 线段 | 无 | 两点确定直线 | 道路标线、边缘标注 |
| 折线段 | 无 | 连续点击创建折线，双击结束 | 车道线、曲线轮廓 |
| 圆形 | 无 | 拖拽确定圆心与半径 | 圆形目标（轮胎、瞳孔等） |
编辑技巧：选中标注后按
Ctrl+J进入顶点编辑模式，支持增删点；右键可修改标签或调整属性。
4. AI 自动标注（核心优势功能）
（1）模型配置
点击左侧「自动标注」→「没有模型」→ 选择.yaml 配置文件
自定义模型配置示例（yolov8-seg.yaml）：
type: yolov8 name: yolov8n provider: spring display_name: 自定义水果分割模型 model_path: ./models/best.onnx # 模型文件路径 iou_threshold: 0.45 # 交并比阈值 conf_threshold: 0.25 # 置信度阈值 classes: [watermelon, wintermelon] # 标签列表（2）标注流程
加载模型：点击「加载模型」，支持 YOLO/SAM/Florence 2 等 ONNX 格式模型
启动标注：
单图标注：点击「运行」按钮
批量标注：选择「一次运行所有图片」
- 结果修正：
删除误检：选中标注按 Del 键
调整位置：直接拖拽标注框 / 掩膜
修改标签：右键→「编辑标签」重新选择
（3）高级 AI 功能
多模态标注：基于 Florence 2 模型，支持文本提示（如输入 “红色汽车” 定位目标）、区域描述生成
交互式分割：结合 SAM 2 模型，点击目标内部即可生成精确掩膜
视频跟踪：导入视频后开启「连续帧推理」，自动插值生成关键帧间标注
5. 标注导出：多格式适配
导出路径：「文件→导出标注」，默认生成 labels 文件夹
格式选择：
目标检测：YOLO（.txt）、VOC（.xml）、COCO（.json）
分割任务：COCO Segmentation、Mask R-CNN 格式
旋转检测：DOTA 格式
- 导出配置：选择标签配置文件（含类别列表），确保与训练框架匹配
三、高级技巧：效率倍增方案
1. 快捷键大全（常用）
撤销 / 重做：Ctrl+Z / Ctrl+Y
全选标注：Ctrl+A（v3.2.4 + 支持）
复制标注：Ctrl+C / Ctrl+V
小目标筛查：标注后按快捷键循环查看放大的目标区域
图像描述：Ctrl+E 进入编辑模式，点击空白区输入描述
2. 模型热切换
点击工具栏「模型管理器」
拖放新模型.yaml 文件至加载区
实时生效，无需重启软件，支持检测→分割→OCR 任务快速切换
3. 自定义优化
在这里插入图片描述
十字准星设置：「视图→设置十字准星」调整颜色与粗细
标签样式：在右侧面板修改标注框颜色、透明度
自动保存：软件默认实时保存，标注文件与图像同目录（.json 格式）
四、常见问题与解决方案
| 问题现象 | 解决方法 |
|---|---|
| 模型加载失败 | 1. 检查 onnx 文件完整性；2. 修正 yaml 中 model_path 相对路径；3. 确认 CUDA 版本匹配 |
| GPU 加速未生效 | 1. 卸载 CPU 版重新安装 GPU 版；2. 运行nvidia-smi检查驱动 |
| 标注崩溃丢失数据 | 1. 开启自动保存；2. 恢复同目录下的.backup 文件 |
| 导出 YOLO 格式无文件 | 1. 确认已创建标注；2. 检查导出目录权限；3. 验证标签配置文件格式 |
| 视频标注卡顿 | 1. 降低视频分辨率；2. 减少关键帧间隔；3. 使用 CPU→GPU 切换 |
