跳到主要内容

设备信息管理

核心概念：设备管理 | 设备信息管理 | 概览

设备信息管理是设备管理模块的核心功能，用于维护所有设备的基础信息和状态。

核心概念：设备管理 | 设备信息管理 | 设备数据从哪里来

设备数据从哪里来​

设备记录既包含后台维护的信息，也包含设备自动上报的信息。渠道、地区、型号、订单和备注等通常来自人工录入、导入或批量修改；CPU、内存、存储、系统版本、UOTA 版本、构件、IP、界面版本和最后心跳等通常来自设备注册、激活或后续上报。设备尚未上报、版本较旧或历史资料不完整时，这些字段可能为空，空值不一定表示设备异常。

设备列表为了支持大量数据的快速查询，搜索结果和详情信息的更新时间可能有极短的先后差异。刚新增或修改设备后如果暂时搜索不到，可稍后刷新；持续不一致时再联系管理员排查数据同步情况。

“最后心跳时间”不是人工维护字段，而是设备最近一次成功上报心跳的时间。系统使用“MAC + CPU”共同定位设备的最后一次心跳。因此，同一 MAC 下存在不同 CPU 记录时，必须同时核对 CPU，不能只凭 MAC 判断是哪一台设备。

核心概念：设备管理 | 设备信息管理 | 导入和对比应怎样理解

导入和对比应怎样理解​

  • 普通导入会检查重复 MAC。“覆盖导入”可以更新已有设备；“不可重复导入”遇到重复 MAC 时会给出失败清单，不会悄悄覆盖原数据。
  • 设备对比导入会读取 Excel 中的 MAC，并与现有设备进行匹配。同一 MAC 如果对应多条设备记录，这些记录都会列入对比结果。系统保留的是文件信息和匹配结果，不长期保留原始 Excel 文件。
  • “总行数”是 Excel 实际读取的行数；“匹配数”是本次新建立的匹配关系数。格式错误的 MAC 会跳过，已经存在的匹配关系不会重复增加，因此两者可能不相等。
  • 删除对比文件只会删除本次对比的文件信息和匹配结果，不会删除设备资料。
核心概念：设备管理 | 设备信息管理 | 快速访问

快速访问​

设备管理的快速访问：在设备信息管理页面，您可以快速访问在线系统。

在线访问入口：打开设备信息管理

核心概念：设备管理 | 设备信息管理 | 功能说明

功能说明​

设备管理的功能说明：设备管理主要用于：

  • 查看所有设备的详细信息
  • 新增设备记录
  • 修改设备信息
  • 删除设备记录
  • 查看设备运行状态
  • 导入导出设备数据
  • 批量修改设备渠道
  • 批量删除设备
关联模块
核心概念：设备管理 | 设备信息管理 | 操作指南

操作指南​

以下是设备信息管理的具体操作指南。

核心概念：设备管理 | 设备信息管理 | 查询设备

查询设备​

查询设备的操作：在设备信息管理中，系统提供多种条件组合查询设备信息。

设备列表查询

搜索条件说明：

条件名称说明
MAC输入完整或部分MAC地址进行搜索
激活状态筛选已激活或未激活设备
所属渠道选择特定渠道筛选设备
设备型号按设备型号筛选
UOTA版本按UOTA固件版本筛选
设备名称按设备名称筛选
系统版本按操作系统版本筛选
构件按构件信息筛选
CPUID按CPUID筛选
地区按地区筛选
订单号按订单号筛选
IP按设备最近上报的 IP 查询
UI按UI版本筛选
客户码按客户码筛选
激活时间按设备激活的时间范围筛选

所属渠道和地区支持多选，选项分别来自渠道资料和地区资料，不是数据字典。UI 和客户码也可以增加多个输入项，用于一次查询多组值。激活状态来自数据字典 device_activate_type，其余文本条件由用户输入。

点击"搜索"按钮执行查询，点击"重置"按钮清空所有查询条件。

设备列表查询更多条件

核心概念：设备管理 | 设备信息管理 | 自定义显示字段

自定义显示字段​

在设备信息列表页面，支持自定义显示字段，点击列表右上角的设置按钮可以选择要显示的字段。

显示字段筛选

列设置按当前登录用户保存。默认显示：复选框、MAC、CPU ID、所属渠道、订单号、客户码、激活状态、地区、设备型号、构件、系统版本、UOTA 版本、UI、创建时间、激活时间、更新时间、最后心跳时间和操作。其余字段仍然可在列设置中打开，并不是页面没有返回。

核心概念：设备管理 | 设备信息管理 | 新增设备

新增设备​

在设备信息管理中，新增设备的步骤如下：

  1. 点击"新增"按钮
  2. 填写设备基本信息：
    • MAC：必填，格式如 AA:BB:CC:DD:EE:FF
    • 所属渠道：必填，选项来自渠道资料，不是数据字典
    • 订单号：可选；填写时必须是 XSDD 加 9 位数字
    • 客户码：可选；填写时必须是 5 位数字
  3. 点击"确定"保存

新增表单只有上述四个字段。激活状态默认按未激活保存，设备型号、版本和硬件信息要等设备后续上报，不要求人工补齐。

新增设备

核心概念：设备管理 | 设备信息管理 | 编辑设备

编辑设备​

在设备信息管理中，编辑现有设备信息的步骤如下：

  1. 找到需要修改的设备
  2. 点击操作列的"编辑"按钮
  3. 在对话框中修改可编辑字段
    • 所属渠道、订单号、客户码：可修改
    • MAC、CPU ID、激活状态、设备型号、UOTA 版本、设备名称、品牌、系统版本、DDR/Flash、DDR、Flash、生产订单号、CPU、PCBA、IP、地区、构件、UI：仅用于查看，当前编辑表单不可修改
  4. 点击"确定"保存

编辑设备

核心概念：设备管理 | 设备信息管理 | 复杂操作

复杂操作​

在设备信息管理中，点击操作列的"更多"按钮，可以进行更多操作。

更多操作

匹配业务​

点击目标设备操作列中的“匹配业务”，系统会自动带入该设备的 MAC 和 CPU。选择业务类型并确认后，可查看该设备当前按规则能够匹配到的业务 ID 集合。

匹配业务

匹配业务结果

该结果用于核查规则配置，不会修改设备或业务数据。规则为何命中、业务如何绑定规则，参见规则中心：业务侧集成。

核心概念：设备管理 | 设备信息管理 | 正常导入设备

正常导入设备​

正常导入设备的操作：在设备信息管理中，支持通过Excel批量导入设备数据。

  1. 点击"更多" -> "导入设备信息"
  2. 下载导入模板
  3. 按模板填写设备信息
  4. 上传Excel文件
  5. 系统校验并导入数据(如果库中已有同mac，则更修改同mac下其它字段)

导入设备

设备比对导入​

设备比对导入用于上传一份 Excel 设备清单，并在设备列表中筛出与该清单匹配的设备。

  1. 点击“设备比对导入”。
  2. 选择一个 .xls 或 .xlsx 文件；每次只能上传一个，文件名会作为比对记录名称。
  3. 点击“确定”创建比对任务。
  4. 在“选择比对记录”下拉框中查看处理状态。只有状态为“完成”的记录可以用于筛选设备列表。
  5. 不再需要的完成或失败记录可以从下拉选项中删除。

设备比对导入

“设备比对导入”弹窗本身只有“比对文件”一个字段。页面不另外生成一张结果字段表；选择完成的比对记录后，匹配结果直接复用当前设备列表的列设置展示。比对记录下拉项只显示文件名和处理状态，状态来自数据字典 device_import_file_status。

核心概念：设备管理 | 设备信息管理 | 不可重复导入

不可重复导入​

在设备信息管理中，进行不可重复导入的操作说明如下：

注意

如果导入的MAC地址已存在，该记录会导入失败并返回失败清单。

  1. 点击"更多" -> "导入不可重复的设备信息"
  2. 下载导入模板
  3. 按模板填写设备信息
  4. 上传Excel文件
  5. 系统校验并导入数据(如果库中已有同mac，则划入导入失败清单)
  6. 系统返回导入失败的设备清单

导入失败清单

核心概念：设备管理 | 设备信息管理 | 导出设备

导出设备​

在设备信息管理中，导出设备数据的步骤如下：

  1. 设置筛选条件（可选）
  2. 点击"更多" -> "导出设备信息"
  3. 系统生成Excel文件供下载

导出设备

核心概念：设备管理 | 设备信息管理 | 按条件批量修改渠道

按条件批量修改渠道​

在设备信息管理中，支持按查询条件批量修改设备所属渠道。

  1. 设置筛选条件，筛选出需要修改的设备
  2. 点击"更多" -> "条件批量修改设备信息"
  3. 选择目标渠道
  4. 确认执行修改

批量修改渠道

核心概念：设备管理 | 设备信息管理 | 按条件批量删除设备

按条件批量删除设备​

在设备信息管理中，按条件批量删除设备的操作如下：

高危操作

批量删除是高危操作，删除后数据不可恢复，请谨慎操作！

  1. 设置筛选条件，筛选出需要删除的设备
  2. 点击"更多" -> "条件删除"
  3. 仔细核对筛选条件
  4. 确认执行删除（需输入确认文本）

批量删除设备

核心概念：设备管理 | 设备信息管理 | 字段说明

字段说明​

设备管理的字段说明：以下是设备信息管理中各字段的详细说明。

核心概念：设备管理 | 设备信息管理 | 列表字段

列表字段​

设备信息列表可通过列设置显示以下字段。带“默认”的字段首次进入页面即显示；其他字段需要在列设置中打开。

字段名称默认显示字段说明
复选框是只用于勾选后批量删除；条件删除、导入、导出和条件批量修改不读取勾选状态
ID否设备记录ID
MAC是设备的MAC地址，设备的物理地址标识
所属渠道是设备所属渠道名称，来自渠道资料
激活状态是设备是否已激活（已激活/未激活）
订单号是关联的订单号
客户码是关联的客户码
设备型号是设备的硬件型号
设备名称否设备上报的名称
品牌否设备品牌
系统版本是设备操作系统版本
UOTA版本是设备当前上报的 UOTA 版本
构件是设备上报的构件信息
CPU ID是CPU 标识，与 MAC 一起用于区分设备和心跳
DDR/Flash否设备上报的组合内存/存储信息
DDR否设备上报的实际内存大小
Flash否设备上报的实际存储大小
生产订单号否设备上报或生产资料中的订单号
CPU否主控型号
PCBA否PCBA 型号
IP否设备最近上报的 IP 地址
地区是根据设备信息展示的地区名称
地区ID否对应地区资料的编号
UI是设备上报的 Launcher 包名或界面标识
创建时间是设备记录创建时间
激活时间是设备首次激活的时间
更新时间是设备资料最后更新时间
最后心跳时间是按 MAC + CPU 找到的最近一次成功心跳时间
入网认证码否设备入网认证使用的标识，属于敏感设备信息
设备型号ID否对应型号资料的编号
备注否设备相关备注信息
操作是编辑、匹配业务和删除
核心概念：设备管理 | 设备信息管理 | 设备状态说明

设备状态说明​

以下是设备信息管理中的设备状态说明。

核心概念：设备管理 | 设备信息管理 | 激活状态

激活状态​

设备的激活状态：

  • 未激活：设备信息已录入系统，但设备从未连接过服务器。
  • 已激活：设备已经连接过服务器，并上报了信息。
核心概念：设备管理 | 设备信息管理 | 数据字典

数据字典​

以下字典值来自 2026-08-27 17:48:07（UTC+8）的全量字典快照；当前列出的字典项均为启用状态。

设备激活状态​

字典名称：设备激活状态；字典类型：device_activate_type。

显示名称取值
未激活0
已激活1

设备导入文件匹配状态​

字典名称：设备导入文件匹配状态；字典类型：device_import_file_status。

显示名称取值含义
解析中0正在读取上传文件。
匹配中1正在与设备数据进行比对。
完成2比对完成，可以选择该记录筛选列表。
失败3比对未完成，可删除记录后重新上传。

规则业务类型​

“匹配业务”弹窗使用字典“规则引擎定义的业务类型”，字典类型为 rule_business_type。

显示名称取值
任务推送0
launcher广告配置1
黑名单2
uota升级3
域名分发之域名4
域名分发之UOTA5
核心概念：设备管理 | 设备信息管理 | 常见问题

常见问题​

以下是设备信息管理中的常见问题解答。

核心概念：设备管理 | 设备信息管理 | Q: 如何批量修改设备所属渠道？

Q: 如何批量修改设备所属渠道？​

A: 使用"条件批量修改设备信息"功能，先设置筛选条件选中目标设备，再选择目标渠道执行批量修改。

核心概念：设备管理 | 设备信息管理 | Q: 设备信息多久更新一次？

Q: 设备信息多久更新一次？​

A: 设备信息（如版本号、IP等）通常在设备每次心跳或启动时上报更新。在线状态取决于心跳上报频率。

开发文档
AI 助手
Agent 列表
请选择一个 Agent 开始对话
AI 问答