AI 训练#

一、文档说明（开头必写）#

• 手册版本： v1.0
• 更新日期： 2026-03-02
• 适用软件版本： AIBox Trainer 1.x
• 适用范围： Web 管理端（Chrome/Edge/Firefox）
• 阅读对象： 普通用户 / 管理员 / 运维
• 约定说明：
  • 按钮：使用【按钮名】表示，例如【新建】
  • 菜单：使用“菜单/子菜单”表示，例如“数据集/新建”
  • 图标：使用（图标）描述，例如（搜索）、（删除）

---

二、产品概述#

2.1 软件是什么、解决什么问题#

AIBox Trainer 是一套面向目标检测的训练平台，覆盖“媒体管理—标注—数据集—训练—推理—模型管理”的完整流程，降低训练门槛并提升协作效率。

2.2 主要功能模块简介#

• 媒体管理：图片/视频上传、RTSP 注册、关键帧提取
• 标注工具：在线标注、审核、预设类别
• 数据集：划分、导入导出、统计分析
• 训练：创建训练任务、实时日志与指标监控
• 推理：单图/视频/RTSP 推理
• 模型仓库：模型管理、对比与导出
• 用户与权限：多角色与配额控制

2.3 使用场景举例#

• 工业质检：用历史图片快速训练缺陷检测模型
• 安防场景：基于 RTSP 实时流推理告警
• 数据外包协作：标注人员集中处理并自动生成数据集

---

三、运行环境与准备#

• 支持浏览器： Chrome / Edge / Firefox 最新版本
• 网络要求： 内网或稳定外网（建议 > 20Mbps）
• 分辨率建议： 1920×1080 及以上
• 账号开通： 由管理员创建用户账号
• 权限说明：
  • admin：全权限与系统管理
  • annotator：上传、标注、训练、推理
  • viewer：只读浏览

---

四、登录与退出#

4.1 访问地址#

由运维提供，例如：http://geoai-trainer.your-domain.com/

4.2 登录步骤#

1. 打开访问地址

2. 输入用户名与密码

3. 点击【登录】

4.3 忘记密码 / 重置密码#

• 请联系管理员重置密码

4.4 退出、超时说明#

• 点击头像菜单【退出】
• 长时间无操作可能自动登出，需重新登录

---

五、界面总览（一页看懂）#

5.1 整体布局#

• 顶部：系统名称、语言/主题切换、用户菜单

• 左侧：模块导航栏

• 中间：功能主区域

5.2 导航栏、菜单、常用按钮#

• 导航栏：Dashboard、媒体、标注、数据集、训练、推理、模型、任务、管理
• 常用按钮：【新建】【上传】【导出】【删除】【刷新】

5.3 通用操作#

• 新增：点击【新建】填写表单提交
• 编辑：列表行内操作（编辑）
• 删除：点击（删除）并确认
• 查询：使用搜索框或筛选条件
• 导出：列表顶部【导出】

---

六、核心功能操作（主体部分）#

每个模块按照相同结构说明

6.1 Dashboard（概览）#

• 功能用途： 查看系统整体统计与任务概况
• 操作入口： 导航栏【Dashboard】
• 详细步骤：
  1. 进入 Dashboard
  2. 查看统计卡片与图表
• 注意事项 / 常见问题：

  • 数据统计依赖后台任务，可能略有延迟

6.2 媒体管理#

• 功能用途： 管理图片/视频/RTSP 等媒体资源
• 操作入口： 导航栏【媒体】
• 详细步骤：
  1. 点击【上传】选择文件
  2. 上传完成后在列表中查看
  3. 需要时可执行关键帧提取
• 注意事项 / 常见问题：

  • 大文件上传建议使用稳定网络

6.3 标注工具#

• 功能用途： 对图片进行框选与类别标注
• 操作入口： 导航栏【标注】
• 详细步骤：
  1. 选择图片进入标注编辑器
  2. 绘制框并选择类别
  3. 点击【保存】提交标注
• 注意事项 / 常见问题：

  • 类别列表由数据集或管理员预设

6.4 数据集#

• 功能用途： 生成训练可用的数据集并维护标签
• 操作入口： 导航栏【数据集】
• 详细步骤：
  1. 点击【新建】创建数据集
  2. 关联媒体或导入数据
  3. 进行 train/val/test 划分
  4. 需要时点击【导出】
• 注意事项 / 常见问题：

  • 导出格式为 YOLO

6.5 训练#

• 功能用途： 创建并运行 YOLO 训练任务
• 操作入口： 导航栏【训练】
• 详细步骤：
  1. 点击【新建训练】
  2. 选择数据集、模型架构、超参数
  3. 点击【启动】
  4. 查看日志与指标
• 注意事项 / 常见问题：

  • GPU 资源不足会导致排队或失败

6.6 训练详情#

• 功能用途： 查看训练日志、指标与曲线
• 操作入口： 训练列表中点击任务
• 详细步骤：
  1. 进入任务详情页
  2. 查看实时日志与曲线
• 注意事项 / 常见问题：

  • 需保持 WebSocket 连接正常

6.7 推理#

• 功能用途： 单图/视频/RTSP 推理
• 操作入口： 导航栏【推理】
• 详细步骤：
  1. 选择模型
  2. 上传图片或选择视频/RTSP
  3. 点击【开始推理】
• 注意事项 / 常见问题：

  • RTSP 需保证源地址可访问

6.8 模型管理#

• 功能用途： 管理训练产出的模型
• 操作入口： 导航栏【模型】
• 详细步骤：
  1. 查看模型列表
  2. 点击【导出】下载模型
  3. 可进行推理测试
• 注意事项 / 常见问题：

  • 导出文件较大时耗时较长

6.9 任务管理#

• 功能用途： 查看异步任务状态（训练/预处理/推理）
• 操作入口： 导航栏【任务】
• 详细步骤：
  1. 打开任务列表
  2. 按状态筛选
• 注意事项 / 常见问题：

  • 失败任务可查看错误信息

---

七、管理员 / 后台功能（如有）#

7.1 用户管理#

• 新增用户、禁用用户、分配角色

7.2 权限配置#

• 角色与功能模块访问控制

7.3 系统设置、参数配置#

• 存储配额、并发数、系统参数

7.4 日志 / 数据管理#

• 查看系统日志与任务历史

---

八、常见问题 FAQ#

• 登录不上怎么办？ 检查账号密码，联系管理员重置
• 页面打不开 / 加载慢？ 检查网络与浏览器缓存
• 操作没反应、数据不显示？ 刷新页面或稍后重试
• 导出 / 上传失败？ 检查文件大小与网络稳定性
• 权限不够怎么处理？ 联系管理员提升权限

---

九、附录#

9.1 名词解释#

• RTSP：实时流媒体传输协议
• YOLO：目标检测模型系列

9.2 快捷键 / 常用操作汇总#

• Ctrl/⌘ + F：搜索
• Ctrl/⌘ + R：刷新页面

9.3 联系方式#

• 客服：support@geotwin.cn
• 技术支持：tech@geotwin.cn