1. 功能与应用目标
“注册管理”用于统一管理已导入设备在接入 KiwiCloud 前后的注册全流程：在已管理与待管理两个视图中，管理员可以批量或逐条设置注册方式、执行 IMA 批量/单台注册，并对已管理设备执行“撤销配置”，以确保注册过程高效、可控、可追溯。
特别说明：
模块包含两个功能页签：已管理、待管理。
已管理支持对已注册并受控的设备执行撤销配置。
待管理支持批量设置与逐条设置注册方式，并提供 IMA 批量注册 / IMA 注册 / 删除设备 等操作。
常见注册方式示例：零接触注册、二维码注册、手动、自动（实际可用项以设备类型与企业配置为准）。
待管理页签主要操作：
操作项 | 说明 |
设置注册方式（单条/多条） | 在列表中为单台或多台设备指定具体的注册方式。 |
批量设置 | 对多台设备一次性设置注册方式，提高批量上线效率。 |
IMA 注册 | 对单台/多台 IMA 设备执行注册。 |
IMA 批量注册 | 选择多台 IMA 设备并一键注册，适用于大规模部署。 |
删除设备 | 从“待管理”列表移除选中设备，清理无效/误导入数据。 |
已管理页签主要操作：
操作项 | 说明 |
撤销配置 | 取消当前设备的已下发配置，便于重新登记或更换接入策略。 |
典型应用场景：
新批次设备入库后，使用“待管理”视图批量设置注册方式并执行IMA 批量注册，快速完成上线。
门店更换网络或策略，需要对已管理设备执行撤销配置后重新注册并应用新策略。
集成商在交付前，对少量设备进行单台注册与现场验收，确认通过后再批量注册。
清理测试或重复导入的记录，使用删除设备保持“待管理”视图的准确性。
2. 待管理页签
2.1 设置注册方式（单条/多条）
操作说明
用于在“待管理”列表中为设备指定注册方式，支持单条设置与多条设置（列表快捷设置）。适用于 KMA / GMA / IMA 管控方式。 可选注册方式：
手动：对于KMA/GMA管控方式的设备，需在设备侧 KC App 点击【注册】触发流程；对于 IMA 管控方式的设备，需要在KiwiCloud的控制台端执行【IMA注册】或者【IMA批量注册】。
自动：对于KMA/GMA管控方式的设备，设备联网后 KC App 自动触发注册流程，无需人工干预。对于 IMA 管控方式的设备，设备激活后自动完成注册流程，无需人工干预。
注意事项
仅对“待管理”中的设备生效；已管理设备不支持修改。
多条设置为列表页快捷方式：勾选多台后，通过列表上方“请选择注册方式”一次性应用。
针对 IMA：若注册方式被设为自动，设备激活后将自动完成注册，无需再执行【IMA注册】/【IMA批量注册】；成功后数据自动移入已管理并置为使用中。
注册方式仅决定触发方式，不改变最终的 KMA/GMA/IMA 管控属性。
操作流程
单条设置
1）在“待管理”列表定位目标设备；
2）点击该行注册方式下拉框，选择 手动 或 自动；
3）系统即时保存并在列表中显示最新结果。
多条设置（列表快捷设置）
1）勾选需要设置的多台设备；
2）在列表顶部点击“请选择注册方式”下拉框，选择 手动 或 自动；
3）系统将所选注册方式一次性应用到已勾选设备。
2.2 批量设置
操作说明
通过批量设置弹窗，以输入 SN或模板导入两种方式导入多台设备，统一选择注册方式并一次性提交。适用于大批量上线或异地导入场景。适用 KMA / GMA / IMA。
注意事项
支持文件格式 xls/xlsx，单文件 ≤5MB；导入后系统先进行格式与有效性校验，仅“校验成功”的 SN 会进入列表。
可在弹窗表头复选框全选/反选；提交后立即生效。
针对 IMA：若注册方式被设为自动，设备激活后将自动完成注册，无需再执行【IMA注册】/【IMA批量注册】；成功后数据自动移入已管理并置为使用中。
自动/手动仅影响注册触发方式，不改变设备的 GMA/KMA/IMA 管控属性。
操作流程
A. 输入 SN
1）点击顶部 【批量设置】，进入批量设置弹窗。
2）在左上角 “SN 输入框” 粘贴多个 SN（支持：逗号、空格、换行符）。
3）点击 【添加设备】，系统执行校验；弹出“批量导入校验结果”，在 “成功/失败” 页签中查看结果。
4）返回批量设置弹窗：
可勾选表头复选框一次性全选；
展开底部 【批量设置注册方式】，选择 自动 或 手动。
5）点击 【提交】，批量生效；页面回到“待管理”列表显示最新结果。
B. 模板导入
1）在批量设置弹窗点击 【下载模板】 获取 Excel 模板 "ImportDeviceTemplate.xlsx"。
2）按模板在 SN 列逐行填写设备序列号并保存。
3）将文件拖拽到右侧上传区或点击上传（支持 xls/xlsx，≤5MB）。
4）系统弹出 “批量导入校验结果”，在“成功/失败”页签查看校验情况。如有失败，按提示修正后重新上传。
5）返回批量设置弹窗，勾选需要设置的设备，或点击表头复选框全选。
6）在底部 【批量设置注册方式】 选择 自动 或 手动。
7）点击 【提交】 应用设置，返回“待管理”列表查看结果。
2.3 IMA 注册
操作说明
用于对IMA 管控方式的设备在控制台直接发起后台注册，仅在该 IMA 设备的注册方式为“手动”时使用。若 IMA 设备的注册方式是自动，系统将自动完成注册并将设备移入已管理（状态：使用中），无需再点击此功能。
注意事项
仅适用于 IMA 管控方式设备，KMA / GMA 不提供该入口。
IMA 设备的默认注册方式可能为“手动”，管理员可通过 2.1/2.2 操作调整为“自动”。
成功：移入已管理、状态使用中；失败请检查是否为 IMA、SN 有效性、设备是否联网等。
操作流程
选择设备，进入「注册管理 → 待管理」，将目测 管控方式=IMA 的设备，勾选目标设备。
发起注册，点击工具栏 【IMA 注册】。
查看结果，注册成功后，设备移入“已管理”，设备状态=使用中；若失败，请核对设备是否已完成 IMA 标记、SN 有效、以及是否已接入阿里 IoT。
2.4 IMA 批量注册
操作说明
用于对IMA 管控方式的设备执行批量后台注册，仅在这些 IMA 设备的注册方式为“手动”时使用。支持两种导入方式：输入 SN与模板导入 SN。若导入的 IMA 设备已被设置为自动，则其在联网后会自动完成注册，无需提交本批量注册。
模板导入仅支持 xls/xlsx，单文件 ≤5MB；导入后会先进行校验，仅校验成功的 SN 会进入待注册列表。
入口仅对 IMA 设备开放；提交后系统立即处理。
批量提交后，成功的设备自动移入已管理并置为使用中。
操作流程
A. 输入 SN 批量注册
1）在「注册管理 → 待管理」点击 【IMA 批量注册】，进入弹窗。
2）在左侧 SN 输入框粘贴多个 SN（支持：逗号、空格、换行符），点击 【添加设备】。
3）查看 “批量导入校验结果”，返回弹窗后确认列表。
4）点击 【批量注册】 发起批量注册；成功后设备移入“已管理”，状态=使用中。
B. 模板导入批量注册
1）在弹窗点击 【下载模板】 获取 Excel 模板 "ImportDeviceTemplate.xlsx"，按模板在 SN 列逐行填写并保存。
2）将文件拖拽到右侧 上传区 或点击上传，系统完成校验并展示结果。
3）确认列表无误后，点击 【批量注册】 批量注册；成功后设备移入“已管理”，状态=使用中。
3. 已管理页签
3.1 撤销配置
操作说明
“撤销配置”用于将设备从当前受管状态中解除控制，并按业务需要选择是否擦除数据与设置设备后续状态。常见于设备报废、退役、维修或重新部署等场景。该操作在已管理页签对单台设备执行。
两种模式：
模式一：擦除设备数据
执行恢复出厂设置，清除设备本地存储；
设置设备状态为：
未注册：记录仍保留，后续可重新初始化与注册；
退役：表示停用或报废，不再纳入注册与管控。
模式二：不擦除设备数据
不清除本地数据；
将设备状态设为维修，表示设备可继续使用但现有配置被重置；
平台自动下发默认策略，保证设备处于最基本的受控状态。
注意事项
执行恢复出厂需设备在线；断网或离线将导致操作失败。
退役为长期停用状态，不可再次注册，谨慎选择。
恢复出厂后的数据不可恢复；如需保留数据，应选择“不擦除”。
未注册状态的设备仍保留平台记录，后续可按注册流程重新纳入管理。
维修适用于返修、诊断、临时停用等场景，系统会为设备下发默认策略以保持基本受控。
操作流程
1）选择目标设备
在“已管理”列表，找到目标设备，点击【撤销配置】。
2）配置撤销方式
是否擦除设备：选择“是 / 否”；
设置目标状态：
选择“擦除”时：设为未注册 / 退役（可勾选“删除设备”以移除平台记录）；
选择“不擦除”时：设为维修（系统将自动下发默认策略）。
3）填写操作原因
在“操作说明/原因”中简要描述撤销原因，便于审计追溯（必填）。
4）提交并确认
点击【撤销配置】后，系统弹出二次确认提示；确认后立即生效并按所选模式执行。
执行完成后，设备状态将更新为所选目标状态，并在相应列表中展示。
4. 注册流程说明
本章说明“注册管理”的关键配置项，并给出 KMA / GMA / IMA 三类设备的完整注册流程。
4.1 注册前准备
项 | 说明 |
设备来源 | iMin 正式设备：由 iMin 系统自动同步到 KiwiCloud，无需手动导入。非 iMin 或测试设备：需在「注册 → 设备导入」完成导入后方可注册。 |
基本要求 | 设备联网可用；SN 唯一、可识别；KC App（或 Google ADP / iMinkit）按机型要求预装并可启动。 |
注册方式 | 可配置为手动或自动： - 手动：对于KMA/GMA管控方式的设备，需在设备侧 KC App 点击【注册】触发流程；对于 IMA 管控方式的设备，需要在KiwiCloud的控制台端执行【IMA注册】或者【IMA批量注册】。 - 自动：对于KMA/GMA管控方式的设备，设备联网后 KC App 自动触发注册流程，无需人工干预。对于 IMA 管控方式的设备，设备激活后自动完成注册流程，无需人工干预。 |
4.2 KMA 注册流程
适用：经过KiwiCloud App适配和测试认证过的设备。
触发方：KC App（手动或自动，取决于设备注册方式）。
流程：
1）KC App 启动，若检测“未注册”，先上报 制造商/型号/SN。
2）Console 返回本机注册方式（手动/自动）。
3）若为自动：KC App 立即发起注册；若为手动：用户在设备端点【注册】发起。
4）发起时，App 同步上报“是否存在 ADP 包”。
5）后台按上报结果判定：无 ADP→KMA 注册。
6）后台优先匹配配额超出记录（命中则更新）；其次匹配未注册记录（命中则更新）。
7）若均未命中：KMA 返回错误，注册失败（需核对导入/配额等前置数据）。
8）成功后，设备进入“已管理/使用中”。
4.3 GMA 注册流程
适用：经过GMS认证的设备，恢复出厂设置后使用Google Zero-touch / QR Code 发起注册流程。详情请查看：
触发方：Google Zero-touch / QR Code 发起注册流程 → KC App 接力上报并注册。
流程：
1）Google Zero-touch / QR Code 发起注册流程。
2）KC App 随后启动检测“未注册”，上报 制造商/型号/SN 与“存在 ADP 包”。
3）Console 返回注册方式（手动/自动），并识别为 GMA 管控。
4）KC App 按注册方式触发：自动则直接注册，手动需点【注册】。
5）后台同样先匹配配额超出，再匹配未注册并更新。
6）若均未命中：GMA 将为该设备创建数据并注册成功。
7）成功后，设备进入“已管理/使用中”。
4.4 IMA 注册流程
适用：iMin 机型（Android 13 以下），走 iMinkit + KC 的 IMA 管控链路。 触发方：设备激活接入阿里 IoT 后由 系统自动标记为 IMA。
默认标记
iMinkit 调用 KC 接口，将设备在 KC 中标记为 IMA 管控；注册方式通常为手动，但可在平台通过 2.1/2.2 将其改为自动。
两种触发
自动：若 IMA 设备注册方式=自动，设备联网后 自动完成注册，无需【IMA注册】/【IMA批量注册】，并直接进入“已管理/使用中”。
手动：若注册方式=手动，运维可在「待管理」使用 【IMA注册】/【IMA批量注册】 触发后台注册。
后台处理
统一按照“配额超出→未注册”的顺序匹配与更新；处理完成后状态为“使用中”。