1. 功能与应用目标
“工具箱”模块为设备运维与安全管理提供了多项实用功能，涵盖 日志采集与管理、调试权限控制、设备在线状态检测 等核心能力，旨在帮助管理员更高效地排查问题、保障调试安全、并及时掌握设备运行状况。
特别说明：该模块目前只适用于 iMin 的设备。
模块构成：
操作项 | 说明 |
日志任务 | 创建、配置并下发日志采集任务，可设定采集范围、采集延时或定时执行方式。 |
设备日志 | 查看与管理设备上传的日志文件，支持预览与批量下载操作。 |
我的调试员 | 管理调试员账户与授权方式，控制设备 USB 调试模式的开启权限。 |
离线检测 | 配置设备离线检测策略与通知联系人，支持自动邮件告警。 |
典型应用场景
在故障发生时通过定时日志任务抓取设备关键运行信息，定位异常原因；
在生产或售后场景中，通过USB 调试保护防止非授权人员接入设备；
对重要业务设备启用离线检测，提前发现并处理网络中断问题；
集中管理各类设备日志，减少跨系统查询和传输的时间成本。
2. 日志任务
用于创建并下发设备日志采集任务，支持两种开始方式：延时与定时。任务在设备端执行完成后会生成 ZIP 日志文件，列表页可按状态进行下载、重试、强制终止等管理操作。
2.1 创建日志任务
操作说明
该功能用于在平台中创建新的设备日志采集任务，并下发至目标设备执行。管理员可设置延时执行或定时采集，以便在设备发生异常时快速获取对应时间点的日志文件进行排查。
日志任务列表支持按设备 SN、任务状态、时间范围进行筛选与定位，便于运维人员在批量设备管理中快速操作与跟踪任务状态。
注意事项
同一设备同一时间仅允许执行一个日志任务，发起新任务会终止旧任务；
“强制终止”任务后不产生日志文件，且设备端将自动删除已生成的临时日志；
建议在问题发生时立即执行或定时执行任务，以提高日志有效性；
下载的日志文件为 zip 格式，需本地解压查看；
设备无响应时可重试任务，但应检查设备在线状态与网络连接。
操作流程
进入任务管理页面
在「日志任务」页面点击右上角【创建任务】按钮；
弹出任务配置窗口，进入任务创建流程。
配置任务参数
设置任务执行方式：
延时执行：设置延迟时间后开始采集（如果填 0 这代表立即执行）；
定时采集：选择具体日期和时间执行任务；
日志结束操作：是否上传后自动删除本地日志文件（可选）。
选择目标设备
支持通过以下方式筛选设备：
设备名称：输入设备名称，支持模糊搜索；
SN：输入设备 SN，支持模糊搜索；
在列表中勾选目标设备，可多选。
下发任务
点击【发布任务】后任务进入“任务发布中”状态：
系统循环推送任务指令至设备，最长 10 分钟；
若 10 分钟内未收到设备接收反馈，状态自动转为“设备无响应”。
任务执行与状态变化
任务发布中 (In the release)：任务已下发，等待设备接收；
进行中 (In progress)：设备已开始采集日志；
已完成 (Done)：任务完成，日志文件已上传，可下载；
设备无响应 (No Response)：设备未在规定时间内响应；
强制终止 (Force termination)：任务被管理员或系统终止，不生成日志文件。
查看与后续操作
在任务列表中可执行以下操作（视任务状态而定）：
强制终止：适用于“任务发布中”与“进行中”状态，立即终止任务；
下载：适用于“已完成”状态，下载日志 zip 文件；
重试：适用于“设备无响应”状态，重新按原任务信息下发任务。
2.2 下载
操作说明
该功能用于在日志任务执行完成后，将设备端上传的日志文件下载到本地进行分析。下载的日志文件为 ZIP 压缩包。
注意事项
下载按钮仅在任务状态为 已完成 时可用；
下载的日志文件为压缩包格式，需解压后查看；
建议下载后将文件妥善保存，便于后续问题定位与记录归档；
若任务状态非 已完成（如“发布中”、“进行中”、“设备无响应”、“强制终止”），则无法下载日志文件；
日志文件内容可能包含设备运行信息，请注意保密与权限管理。
操作流程
进入日志任务页面
在「工具箱」>「日志任务」页面查看任务列表；
通过 SN、型号、任务状态、时间范围筛选目标任务（可选）。
确认任务状态
在任务列表中找到状态为 已完成（Done） 的任务；
确认右侧操作栏显示【下载】按钮。
下载日志文件
点击【下载】按钮；
系统开始下载 ZIP 文件，文件名以“日志任务 + 时间戳”命名（示例：
日志任务2025-08-12T11-08-07.zip）；文件将保存至浏览器默认下载目录。
查看日志内容
在本地找到已下载的 ZIP 文件并解压；
打开日志文件进行分析和故障排查。
2.3 强制终止
操作说明
终止当前处于 “发布中” 或 “进行中” 状态的设备日志任务。强制终止后，任务会立即停止，不会生成或上传任何日志文件。
注意事项
该操作不可恢复，一旦执行强制终止，任务将无法继续。
强制终止仅适用于 “发布中” 或 “进行中” 状态的任务。
强制终止后的处理结果：
发布中：立即停止向设备下发任务信息。
进行中：
立即停止任务执行。
通知设备端终止日志采集。
删除设备端已生成但未上传的本地日志文件。
常见强制终止场景：
用户手动停止任务，终止日志采集。
同一设备在上一任务未完成时再次发起新的日志任务，旧任务会被系统自动强制终止。
设备端上报异常终止（例如配置的开始/结束时间早于设备系统时间）。
操作流程
在 日志任务 列表中，找到状态为 “发布中” 或 “进行中” 的目标任务。
点击 强制终止 按钮。
在弹出的确认窗口中：
核对提示信息中的 设备 SN 是否正确。
点击 终止任务 以确认终止，或点击 取消 放弃操作。
确认终止后：
任务状态变为 “强制终止”。
系统停止日志任务的下发或采集。
（仅“进行中”任务）设备端会删除当前任务的本地日志文件。
2.4 重试
操作说明
当日志任务状态为 “设备无响应” 时，可通过 重试 功能重新下发日志采集任务，避免因设备未及时响应而导致日志缺失。重试操作会按照原有任务参数（开始时间、时长、结束后操作等）重新执行任务下发。
注意事项
仅 状态为“设备无响应” 的任务支持重试操作。
重试会覆盖当前设备的相同日志任务，如果设备端已存在同类任务，将会被新任务替换。
设备端需处于在线状态才能正常接收重试下发的任务。
重试不会修改任务的其他配置项（如延时/定时设置、日志保存策略等）。
操作流程
在 日志任务 列表中，筛选或找到状态为 “设备无响应” 的任务记录。
点击对应任务右侧的 “重试” 按钮。
在弹出的 确认弹窗 中，核对提示信息（包含设备 SN）。
点击 “重试” 确认按钮，系统将按原任务参数重新下发日志采集任务。
任务状态将更新为 “发布中”，等待设备端接收并执行。
3. 设备日志
操作说明
集中查看与管理设备主动上传或通过日志任务采集上传的日志文件。
支持按 SN / 客户名称 / 时间范围 查询定位目标日志记录；
iMin 设备可在 设置 → 实验室 → 设备日志 中主动抓取并上传日志文件，适用于即时排障。
注意事项
日志文件以 ZIP 压缩包格式保存，文件名包含生成时间，例如：
日志任务2025-08-12T11-08-07.zip；时间筛选条件中，结束日期需大于等于开始日期；
日志文件可能包含敏感设备信息，下载与共享需遵循数据安全与隐私规范；
当设备处于弱网或离线状态时，主动上传的日志会延迟出现在列表，上传成功后方可查看或下载。
操作流程
进入设备日志页面
路径：工具箱 → 设备日志；
页面默认显示最近上传的日志文件列表。
筛选目标日志
在搜索栏输入 SN（支持模糊匹配）；
输入 客户名称（如适用）；
设置 开始日期 – 结束日期 后点击 查询；
可点击 重置 清空所有筛选条件。
下载日志文件
在目标行点击 下载 按钮，将日志 ZIP 文件保存至本地（文件名含时间戳，便于溯源）；
在本地解压后查看日志内容。
设备端主动上传日志（iMin 设备）
在设备进入 设置 → 实验室 → 设备日志；
选择所需日志类型（如系统日志、trace、bugreport 等）；
执行抓取并上传，上传成功后可在平台 设备日志 页面下载查看。
4. 我的调试员
操作说明
“我的调试员”功能用于管理可在启用 USB 调试保护 后，对设备执行调试授权的人员名单。 当 KMA 设备策略中启用了“USB 调试保护”后，设备通过 USB 进行调试前，必须由已授权的调试员通过邮箱验证码方式完成身份验证，以保障设备调试安全。
本功能支持以下操作：
添加调试员：录入调试员的姓名和邮箱，并完成邮箱验证码验证。
修改调试员信息：可变更调试员姓名或邮箱。
删除调试员：将已注册的调试员从授权名单中移除。
功能配套关系
“我的调试员”与 KMA 设备策略 → 权限设置 → USB 调试保护 搭配使用。
当设备启用 USB 调试保护后，若用户在 iMin 设备中进入 设置 → 系统 → 开发者选项 → USB 调试 并尝试开启 USB 调试功能，系统会要求输入调试员邮箱并接收验证码，验证通过后方可开启调试模式。
注意事项
调试员邮箱唯一：同一邮箱不可重复添加为不同调试员。
邮箱有效性：调试员需使用有效邮箱以接收验证码，否则无法完成授权。
策略优先级：若 KMA 设备策略未启用 USB 调试保护，则“我的调试员”功能不会生效。
实时生效：调试员信息变更后立即生效，无需设备重启。
操作流程
1. 添加调试员
在“我的调试员”页面点击 添加调试员。
输入调试员 姓名 和 邮箱地址。
点击 发送邮箱验证码，并在验证码有效期内输入收到的验证码。
点击 提交 完成添加。
2. 修改调试员
在调试员列表中找到目标调试员，点击 修改。
更新姓名或邮箱信息（如修改邮箱需重新验证）。
点击 保存。
3. 删除调试员
在调试员列表中找到目标调试员，点击 删除。
在确认弹窗中点击 确定，该调试员即从授权名单中移除。
5. 离线检测
操作说明
“离线检测”功能用于在指定的营业时间段内，周期性检测设备的在线状态，并在发现设备离线时，向预设的联系人发送邮件通知，以便业务人员及时处理，恢复设备的正常运行状态。
本功能支持以下操作：
创建策略：可为每个策略配置最多 3 个互不重叠的检测时间段，设置检测频率、检测对象和通知规则。
查看策略详情：查看策略的时间段配置、检测频率、关联设备及通知邮箱。
查看检测记录：查看每次检测的执行结果，包括离线设备的详细信息与通知记录。
编辑策略：修改现有策略的时间段、检测参数、检测对象及通知规则。
检测状态 启用/停用：用于快速控制离线检测策略的运行状态。
删除策略：移除不再需要的检测策略。
5.1 创建策略
操作说明
“创建策略”用于新建离线检测规则，系统会周期性检测指定设备或设备分组的在线状态，并在检测到设备离线时根据配置的通知方式进行告警提醒，确保设备运行状态可控和问题可及时响应。 该功能支持设置检测时间段、检测间隔、通知方式及通知对象，并可按设备或设备分组进行检测范围限定。
注意事项
检测时间段
检测时间段可配置多个区间，系统仅在时间段内进行离线检测。
检测时间段需基于所选时区设置。
检测间隔与通知规则
检测间隔最短可设置为 5/10/15/30/60 分钟，最长不超过 1 小时。
支持“每次检测记录”与“单次离线记录”两种记录规则：
每次检测记录：每次检测到离线都会记录并发送通知。
单次离线记录：首次检测到设备离线发送通知，在下一次检测到在线之前不会再进行记录和通知。
通知方式
当前支持邮件通知，至少需配置一个有效邮箱地址。
邮箱地址必须为有效格式，否则无法保存策略。
检测设备
支持按设备分组或单台设备添加检测范围。
当选择设备分组时，该分组下所有设备均纳入检测范围。
策略生效
策略创建成功后即可生效，检测状态可在策略列表中开启或关闭。
其他规则
当检测到设备离线时，系统将在检测间隔结束后再次检测并确认状态。
如果设备在检测时间段结束前恢复在线，则不再发送离线告警。
操作流程
在 离线检测 页面，点击 创建策略。
填写基本信息：
输入策略名称（必填，最长 256 个字符）。
选择策略所属的 所在地 与 时区。
设置一个或多个 检测时间段（必填）。
点击 下一步，进入 检测配置：
设置检测状态（开启/关闭）。
设置检测间隔（必填）。
选择检测对象（设备分组或单台设备），并勾选目标设备/分组。
设置记录/通知规则。
选择通知方式，并添加通知邮箱（必填）。
填写备注信息（可选）。
点击 提交 保存策略，系统将在配置的检测时间段内执行检测任务。
5.2 详情
操作说明
“详情”用于查看离线检测策略的完整配置信息，包括策略的基本信息、检测配置、检测设备及通知方式等内容。该功能方便用户快速确认策略的生效状态、检测范围及告警通知对象，以便进行后续管理或调整。
操作流程
在 离线检测 页面，找到需要查看的策略，点击对应行的 详情 按钮。
系统将进入策略详情页面，按模块显示以下内容：
基本信息：策略名称、所在地、时区、检测时间段。
检测配置：检测状态、检测间隔、记录/通知规则。
检测设备：按设备分组或单台设备列出检测对象，包含设备名称与序列号。
通知方式：通知类型（邮件）及邮箱列表，备注信息。
根据需要核对各项配置信息，并决定是否返回列表页面执行编辑或其他操作。
5.3 检测记录
操作说明
“检测记录”用于集中查看指定离线检测策略在检测时间段内的执行结果，包括检测的设备总数、离线设备数量、以及离线设备的详细信息与通知记录。 通过该功能，用户可追溯设备离线事件及通知发送情况，确保及时获知设备状态并采取相应措施。
注意事项
仅展示已创建且执行过的离线检测策略的检测数据。
检测记录按时间倒序排列，可根据检测时间段、设备SN等条件查询。
离线设备详情包含设备SN、型号、离线时间、离线时长及是否触发通知。
通知记录显示通知方式、接收邮箱及发送状态。
操作流程
进入“离线检测”模块，点击目标策略右侧的【检测记录】按钮。
在列表中查看各检测时间段的执行情况，包括设备总数与离线数量。
点击【详情】，可在“离线设备”页签查看具体设备的离线信息。
切换至“通知记录”页签，可查看本次检测触发的通知发送详情。
可通过顶部查询栏按条件筛选历史检测记录。
5.4 编辑
操作说明
“编辑”功能用于修改已有离线检测策略的全部信息，包括策略名称、检测时间段、关联设备（或设备分组）、检测间隔、通知方式、邮箱列表及备注等内容。该功能适用于策略需求发生变化或需优化监控配置的场景，可确保策略在最新业务需求下持续有效运行。
注意事项
编辑操作会直接影响当前策略的执行规则，保存后立即生效，请在确认修改内容正确后再提交。
若调整检测时间段，请确保总时长和业务需求匹配，避免监控空档。
若修改检测间隔或通知规则，可能影响邮件发送频率与告警触发时效性。
编辑策略不会清除已有的检测记录，但后续记录将按新配置生成。
若修改邮箱列表，请确保邮箱地址有效且收件人有权限接收告警邮件。
操作流程
在 离线检测 列表中找到需修改的策略，点击 编辑 按钮。
在 基本信息 页签中，可修改以下内容：
策略名称
所在地
时区
检测时间段（支持添加、删除或调整时间）
点击 下一步 进入 检测配置 页签，调整以下参数：
检测状态（开启/关闭）
检测间隔
检测设备（可按设备分组或单台设备选择）
记录/通知规则
通知方式及邮箱列表
备注信息
修改完成后，点击 保存 提交更改。
系统提示保存成功后，新配置立即生效。
5.5 检测状态 启用/停用
操作说明
用于快速控制离线检测策略的运行状态。启用后，系统将按照策略设定周期检测设备在线状态，并在检测到离线时执行通知规则；停用后，系统将暂停该策略的检测与通知。
注意事项
启用/停用操作即时生效，无需额外保存。
停用策略不会删除策略配置，后续可再次启用。
在策略停用期间，系统不进行离线检测，也不会产生通知记录。
操作流程
在离线检测列表中找到需要修改检测状态的策略。
在检测状态列，通过切换开关按钮选择：
开启（绿色）：启用离线检测策略。
关闭（灰色）：停用离线检测策略。
系统即时应用更改并更新检测状态。
5.6 删除
操作说明
用于删除已创建的离线检测策略。删除操作会移除该策略及其检测计划，系统将不再对该策略中关联的设备进行离线状态检测，也不会发送相关的离线通知邮件。
注意事项
删除操作不可撤销，请在确认该策略不再使用后再执行删除。
删除策略后，原检测记录仍会保留在系统中，可在检测记录中查看历史数据。
若需要再次启用相同检测逻辑，需重新创建策略并进行配置。
操作流程
在离线检测列表中找到需要删除的策略。
点击该策略行右侧的【操作】按钮，选择删除。
系统会弹出确认删除对话框，提示“确定要删除吗？”。
点击【确定】完成删除；点击【取消】则中止操作。