概述

July 19, 2026 · View on GitHub

X-AnyLabeling 的图像分类器是独立的图像分类标注窗口，支持多类分类（单标签）和多标签分类。用户可以管理标签、对单张或多张图像进行 AI 辅助分类、查看数据集统计信息，并将已分类图像按类别导出到对应目录。

启动

要打开图像分类器窗口，请先在主窗口加载图像目录，然后点击左侧工具栏中的图像分类器图标（布偶猫头像），或使用以下快捷键：

  • Windows/Linux：Ctrl + 3
  • macOS：⌘ + 3

Note

打开图像分类器窗口时主窗口会自动隐藏。如果最小化本窗口后任务栏图标消失，可使用 Alt + Tab（Windows）或 ⌘ + Tab（macOS）切换回窗口。关闭分类器窗口后主窗口会重新显示。

教程

图像分类器采用双面板设计，左侧为图像预览区，右侧为标注控制区。

左侧面板：图像预览区

  • 文件名与进度指示：显示当前图像文件名及其在数据集中的位置（如 husky.png (1/3)）。
  • 图像预览区域：居中显示图像，支持自适应缩放。当选中标签时，标签文字会实时显示在预览区域右上角，便于快速查看和确认。

Tip

✅ 表示当前图像已标注，❌ 表示当前图像未标注。

右侧面板：标注控制区

  • 功能组件区：
功能按钮说明
Export将已分类的图像按类别导出到文件夹中（仅支持 MultiClass 模式）
MultiClass多类分类模式，每张图片只能选择一个标签
MultiLabel多标签分类模式，每张图片可以选择多个标签
AutoRun使用 AI 模型批量分类所有图像

Note

  • MultiClass 模式：适用于互斥分类任务，如动物种类识别（一张图片只能是一种动物）
  • MultiLabel 模式：适用于多属性标注任务，如图片标签标注（一张图片可以同时具有多个属性）
  • 需要注意的是，当从 MultiLabel 切换到 MultiClass 模式时，系统只会保留每张图片的第一个勾选标签
classified/
├── husky/
│   ├── husky_playing.jpg
│   └── husky_sleeping.jpg
├── psyduck/
│   ├── psyduck_swimming.png
│   └── psyduck_standing.png
└── ragdoll/
    ├── ragdoll_grooming.jpg
    └── ragdoll_sitting.jpg
  • 标注组件区：

右侧中间面板包含标题和以下 5 个标注组件。

AI 助手

如需使用 AI 辅助功能，请先按照聊天机器人文档完成模型配置。

完成配置后，点击标注组件区右侧的魔法棒图标即可打开 AI 对话框。

软件内置了一套标准的提示词模板，会根据当前选择的模式（MultiClass 或 MultiLabel）自动调整提示内容。你可以直接使用或根据实际需求自定义。

MultiClass 模式示例：

@image
You are an expert image classifier. Your task is to perform multi-class classification.

Task Definition: Analyze the given image and classify it based on the provided categories.

Available Categories: ["husky", "psyduck", "ragdoll"]

Instructions:
1. Carefully examine the image and identify the main subject and their activity
2. Be precise - only select categories that clearly match what you observe

Return your result in strict JSON format:
{"husky": false, "psyduck": false, "ragdoll": false}

Set exactly ONE category to 'true' that best matches the image, keep all others as 'false'.

MultiLabel 模式示例：

@image
You are an expert image classifier. Your task is to perform multi-label classification.

Task Definition: Analyze the given image and classify it based on the provided categories.

Available Categories: ["outdoor", "sunny", "people", "building"]

Instructions:
1. Carefully examine the image and identify the main subject and their activity
2. Be precise - only select categories that clearly match what you observe

Return your result in strict JSON format:
{"outdoor": false, "sunny": false, "people": false, "building": false}

Set ALL applicable categories to 'true', keep non-applicable ones as 'false'.

有关特殊引用和提示模板库等用法，请参考视觉问答文档。

添加标签

软件提供了两种添加标签的方式：

  1. 手动输入：适用于少量标签的情况，直接在编辑框中输入标签名称，每行一个，且标签名之间不允许重复。
  2. 文件导入：标签较多时，可提前准备 classes.txt（每行一个标签），再通过左侧的上传按钮导入。文件内容会自动解析到编辑框中。

确认标签列表无误后，点击添加按钮完成标签添加。

Note

此处仅支持添加新标签，不支持修改已有标签，如需编辑或删除现有标签，请参考后续小节。

删除标签

删除标签组件用于移除已有的标签。你可以通过点击选择一个或多个标签（被选中的标签会以高亮显示），然后点击删除按钮。在确认对话框中再次确认后，系统将自动遍历当前任务中的所有标签文件，并删除所选标签相关的所有内容。

编辑标签

标签编辑组件以表格形式展示，左侧列显示当前标签（只读），右侧列用于输入新的标签名称。要修改标签，只需双击右侧单元格进入编辑模式，输入新的标签名称即可。完成所有修改后，点击保存按钮使更改生效。

数据统计

数据统计组件提供了当前任务的数据集统计信息，包括：

  1. 总体统计：显示数据集中的总样本数、已标注数量和未标注数量。
  2. 标签分布：以水平条形图的形式展示每个标签的使用频次及占比。图中使用不同颜色区分不同标签，每个标签后显示具体的数量和百分比。
  • 导航组件区

支持用户手动点击左/右箭头来手动切换上/下一张图片，或通过中间页码输入框输入指定数字跳转到指定图片。此外，提供以下快捷键方便快速切换图片：

快捷键功能
A上一张图片
D下一张图片
Ctrl+A 或 ⌘+A上一张未标注的图片
Ctrl+D 或 ⌘+D下一张未标注的图片

数据

图像分类器的标注信息保存在 X-AnyLabeling 标签文件的 flags 字段中，详情参见《用户手册》中的保存标签数据。

{
  "version": "4.0.0",
  "flags": {
    "husky": true,
    "psyduck": false,
    "ragdoll": false
  },
  "shapes": [],
  "imagePath": "husky.png",
  "imageData": null,
  "imageHeight": 200,
  "imageWidth": 200,
  "description": ""
}