中文 · 控灵

控灵移动端操作手册

手册版本 V1 · 2026-10-15点击截图查看完整图片

本手册以 iOS 界面为例，其他平台请以实际发布版本为准。截图中的账号身份、权限标识、设备及地点信息已脱敏，地图轮廓保持原样。

1. 开始使用

控灵机器人管理移动端软件用于在手机上查看和管理获得授权的机器人、场地、地图、任务及告警，并提供消息通知和 AI 助手。日常使用可从首页了解运行概况，从设备页进入指定机器人，从场地页查看作业地点，从“我的”调整个人设置。

1.1 使用前准备

准备组织开通或认可的账号，安装与手机系统匹配的控灵应用，并保持可用网络。机器人应已完成部署并可供当前账号访问。需要近场直连时，让手机与机器人连接同一局域网，或按应用提示连接机器人热点。

手机系统、应用发布配置、账号权限和机器人能力会影响可见入口。某项功能未显示、不可选择或提示设备不支持时，应按页面说明处理；不要把灰色按钮理解为已经执行成功。

应用会在相关功能使用时说明权限用途。蓝牙用于附近设备发现和连接，局域网用于发现同一网络中的机器人，麦克风用于主动语音输入，通知用于消息提醒。场地定位只用于附近排序，拒绝后仍可搜索和浏览有权访问的场地。

1.2 操作机器人前的核对

查看状态、缩放地图和打开任务表单不会代替任务提交。创建任务、遥控、切换当前地图、校准定位、建图和保存地图内容会改变机器人状态或数据。执行这些操作前，应核对设备、场地和地图，确认现场允许作业，并保证能够使用机器人急停。

界面中的地图、点云和路径用于辅助观察。网络中断、定位失效或数据未更新时，应先恢复状态，不能依据旧画面继续作业。任务是否执行及是否完成，以机器人返回的状态和现场情况为准。

2. 登录账号

2.1 首次登录

打开应用，在登录页阅读“用户协议”和“隐私政策”。
输入用户名或邮箱以及密码，勾选同意协议。
点击“登录”，按提示拖动滑块完成验证。
验证通过后等待登录结果。成功后进入首页；失败时根据提示检查账号、密码或网络后重试。

仅勾选协议而未提交登录，不会保存本次同意。首次使用尚未同意时，应用保留登录、协议和帮助入口，不启动附近设备发现。

图 1　登录页：账号、密码与协议确认。登录前核对账号并阅读协议，验证码在提交后按提示完成。

2.2 需要修改初始密码时

如果登录过程提示必须重置密码，按弹窗要求设置新密码并完成确认，再根据结果继续登录。普通密码遗忘、账号停用或组织访问问题，请联系组织管理员处理。如果账号需要额外身份验证而页面提示移动端流程暂不可用，也应联系组织管理员。

已经同意协议且会话仍有效时，应用可恢复登录状态。需要更换账号时，进入“我的”选择“退出登录”，再使用另一账号登录。

3. 首页与消息

3.1 查看运行概况

首页显示场地、当前告警、设备和任务等统计，以及里程、任务时长、最近访问设备和最近执行任务。点击最近访问的设备卡片可打开设备详情，点击最近任务旁的“查看全部”可查询任务记录。下拉首页可刷新数据。

统计缺失或加载失败时，页面可能显示横线或错误提示，应刷新后核实。最近访问设备来自当前手机的访问记录；没有记录时，不代表组织中没有设备。

图 2　首页：运行统计和最近访问入口。在首页了解概况，再从最近访问设备或任务列表继续查看。

3.2 查看消息中心

点击首页右上角铃铛，或进入“我的 → 消息中心”。该功能需当前版本启用。
默认查看“最近消息”。点击顶部“设备告警”“任务通知”或“连接提醒”卡片筛选内容；再次点击已选卡片可返回最近消息。
需要集中查看未读内容时，选择“仅看未读”。消息按日期排列，点击消息可查看详情，再按其中的入口查看相关设备、任务或告警。
使用“全部已读”可整理阅读状态；右上角齿轮可进入通知设置。

“连接提醒”显示当前手机记录的连接中断提示，与来自服务器的任务、告警消息分开。消息过期、被删除或当前账号已无访问权限时，详情可能无法打开。通知出现不等于当前账号一定有权查看其中资源，打开后仍会核验权限。

图 3　消息中心：设备告警、任务通知和连接提醒。从最近消息开始浏览，按顶部分类或未读条件查找事件。

4. 查找与连接机器人

4.1 查找设备

点击底部“设备”。
输入设备名称或序列号进行搜索，或按在线、离线、任务中等状态筛选。
点击设备卡片进入详情，核对产品、设备状态、电量、所属场地和当前地图。
从详情页选择“实时查看”“任务列表”“地图管理”或“设置”。

进入在线设备时，应用可能先检查机器人软件更新，并显示待更新模块或进行中的状态。暂不更新时，在页面允许的情况下选择稍后继续；开始更新会改变机器人软件，需确认维护安排。更新中不能将其他操作入口暂不可用理解为应用已失去设备记录。

设备列表可下拉刷新，并在滚动时加载更多。局域网设备和蓝牙可见状态反映不同发现方式；云端显示在线，也不代表手机已完成与机器人的实时连接。

图 4　设备列表：搜索与状态筛选。先缩小设备范围，再选择需要查看的机器人。

图 5　设备详情：状态与功能入口。在设备详情中核对对象，并选择实时查看、地图或任务记录。

4.2 同一局域网连接

将手机与机器人接入同一局域网，进入设备列表或详情后，应用会在前台尝试发现附近机器人。找到匹配设备后，进入“实时查看”等功能，等待连接完成。

局域网发现与蓝牙开关相互独立。没有发现设备时，先检查网络是否相同、机器人是否启动以及系统是否允许局域网访问，再刷新列表。应用切到后台时，发现会暂停；回到前台后，以重新获得的连接状态为准。

4.3 蓝牙发现与热点连接

在设备页点击“蓝牙发现”，阅读用途提示。
根据系统提示允许相关权限，并确认蓝牙已开启。
点击“开始蓝牙扫描”，在结果中核对要连接的机器人。
选择连接并确认后，按页面步骤完成蓝牙连接、身份验证、热点准备和 Wi-Fi 连接。
系统请求加入网络时，核对提示并确认。连接成功后返回相应设备功能。

图 6　蓝牙发现：开始扫描前的说明页。阅读连接说明后，按需要主动开始蓝牙扫描。

仅允许蓝牙权限不会自动开始扫描。自动加入热点失败时，页面可能显示供手动连接使用的网络信息，应按提示在手机系统设置中操作。这些连接信息只应交给获授权的使用人员。

如果从设备详情进入功能时出现“连接机器人热点？”提示，可选择“连接热点”，也可“暂不连接”并继续尝试当前可用连接。是否可实时查看，仍取决于实际网络与设备状态。

5. 实时查看机器人

5.1 观察状态与地图

进入设备详情的“实时查看”，等待机器人视图建立连接。页面显示连接状态、机器人画面、运动状态、电量以及当前任务等信息。存在故障时，可看到对应告警提示。

可在 3D 场景和 2D 地图之间切换，使用缩放、拖动或跟随视角观察机器人与周边地图。按需要显示雷达点云、空间体素等图层；具体可见内容取决于设备上报和连接条件。弱网下部分图层可能暂停。

图 7　机器人视图：实时状态与三维场景。结合连接状态和机器人数据判断当前是否具备操作条件。

图 8　二维地图：机器人位置、点位与点云。切换二维地图后，可缩放查看点位和机器人位置关系。

定位尚未就绪或地图不一致时，页面会限制依赖有效定位的操作。连接中断后，应用可能保留最后画面并提示重连；保留画面不代表机器人仍在该位置。

5.2 遥控与急停

机器人视图提供遥控入口。具备相应条件时，打开遥控面板并操作虚拟摇杆，可控制机器人移动或旋转；释放摇杆后停止该次遥控输入。不同机型支持的方向不同，不能根据其他机型界面假定当前机器人支持横向移动。

急停入口会先要求确认。解除急停也需核对机器人状态和现场条件。应用急停受网络与设备连接影响，不能替代机器人硬件急停。

5.3 地图长按操作

在可用的二维地图或三维地图地面上长按，可打开“导航到这里”和“在此创建点位”。前者在确认后创建移动任务，后者打开点位表单。仅长按、查看菜单或查看候选位置，不会自动导航。

机器人连接、地图或定位发生变化后，应重新选择位置。不要依据已失效的候选位置重复提交。

6. 管理机器人地图

6.1 查看地图列表

从设备详情进入“地图管理”，按楼层筛选地图，查看地图名称、缩略图、点位和区域数量。当前机器人正在使用的地图会有相应标记。点击地图卡片中的“编辑”进入编辑页，可缩放查看已保存内容。

图 9　地图列表：楼层筛选与当前地图。查看机器人本地地图，并核对当前导航使用的地图。

“设为当前”会切换机器人的导航地图，需确认操作后再等待结果；切换后还应核实定位。删除地图会移除该地图，不能把删除作为刷新手段。

6.2 创建地图与增加楼层

在地图管理中点击“+ 新建”。
选择“创建新地图”，输入地图名称、楼层及可选描述；或选择“给已有地图加楼层”，选择已有地图和新的楼层。
确认现场具备建图条件后，点击“下一步 · 开始建图”。机器人将进入建图流程。
按建图页面提示控制机器人扫描所需区域，并观察建图状态。
完成后使用“完成建图”，等待返回结果，再到地图列表核对地图。

楼层应填写实际地上或地下楼层，不能使用 0 层，也不能重复已有楼层。建图涉及真实运动，应由熟悉现场和机器人操作的人员完成。

6.3 创建与编辑导航点

在地图编辑页点击右下角加号，再选择“导航点”，根据提示在地图上选择位置，填写点位名称、类型和方向，再点击保存。点位类型包括普通、充电、电梯和门，按实际用途选择。

图 10　地图编辑器：点位与区域操作。在机器人本地地图上查看和编辑导航点、禁行区等内容。

已有点位可双击打开编辑表单，调整名称、坐标和朝向。长按拖动点位后，需确认位置更新。删除点位前应核对它是否仍被任务使用。

普通点位可按设备能力选择“沿用系统默认”“普通到点”或“精确到点”。精确策略可涉及位置与方向容差、遇障处理和等待时间；支持相应能力的机器人还可设置尝试次数。设备不支持的已有配置会保留，不应把未显示字段当作已经清空。

保存前应核对点位用途和到达要求，充电点应与实际充电桩匹配。

也可在机器人视图底部“更多 → 添加点位”中，选择根据机器人当前位置或当前地图创建。按当前位置创建时，应用取选中时的位置，之后不会自动跟随机器人移动；定位失效时需重新选取。保存点位只更新对应地图，不会同时创建导航任务。

6.4 编辑区域与禁行线

点击地图编辑页右下角加号，选择禁行区、狭窄区或禁行线。多边形区域依次选择至少三个点；禁行线选择两个或更多点。点击“完成绘制”后核对区域属性，再确认保存。

支持坡道区域的机器人可添加上坡或下坡区域，并填写参考行进方向。坡度未知时保留为空，不要填写 0 代替未知。只读区域或不受当前设备支持的区域，应按页面提示由适当工具处理。

地图内容保存后，应重新查看结果。机器人本地地图编辑与场地云端地图不是同一操作；当前编辑流程不会自动上传到场地云端地图，需要云端复用时请由具备权限的人员通过支持的桌面端流程处理。

6.5 校准机器人定位

当机器人在已知地图中的位置或方向不正确时，从机器人视图“更多 → 校准地图”，或当前地图卡片的校准入口进入。

核对页面显示的地图与楼层，并查看机器人静止、激光数据等状态提示。
在“移动点云”模式下，用单指拖动青色点云轮廓，使其与地图墙体重合。双指可缩放和移动地图；切换到“浏览地图”后，单指拖动也只移动视图。
使用“朝向调整”滑杆或加减按钮调整方向，再核对点云与现场结构。需要更细的位置调整时，展开“位置精调”使用方向按钮。
需要重新确定起始位置时，点击“重新选择位置”，再在地图上选择实际位置并继续对齐；可用“看全图”恢复全图视野。
在机器人静止、无活动任务且页面允许提交时，点击“确认位置与朝向”，等待结果验证。

图 11　校准地图：移动点云并调整朝向。将青色点云与墙体对齐后再确认位置与朝向；该操作修正定位，不改变地图轮廓。

提交超时或结果不确定时，先按页面提示核实上次请求，不要连续重复确认。完成定位核实前，应用可能限制运动、建图和新任务操作。

7. 创建与管理任务

7.1 任务前提与目标预览

从机器人视图点击“新任务”，在“创建任务”面板选择移动、回充或巡逻。机器人离线、急停中或已有任务运行时，创建入口会受到限制。

依赖地图的任务还要求当前地图与定位可用。选择目标时，可按地图、楼层和点位名称、别名或编号查找。其他地图的目标可以预览，但当前版本不能直接创建跨地图执行任务；需先激活目标地图并完成定位。

路径预览是创建前的参考。预览失败、缺失或过期时不会代表存在可行路线，任务创建时机器人还会重新检查和规划。连接或点位改变后，应刷新并重新选点。

7.2 移动任务

选择“移动任务”，点击“目标点位”。
选择当前导航地图中的目标，核对名称、楼层及地图位置。
查看“导航路径预览”及提示，确认现场允许机器人移动。
点击“创建移动任务”，等待创建结果，再通过机器人视图观察执行状态。

图 12　移动任务：目标位置与路径预览状态。示例已选择目标，但尚未获得规划路线；页面提示检查定位与导航状态后刷新。

7.3 巡逻任务

选择“巡逻任务”，依次填写途经点。
使用“添加途经点”增加路线位置；需要调整顺序时，重新选择相应序号的目标。相邻点不能相同。
设置循环次数，范围为 1-99 次；当前界面最多添加 20 个途经点。
按需要选择“完成后自动回充”和“低电量自动回充”。
核对所有点位属于当前可执行地图后，点击“创建巡逻任务”。

图 13　巡逻任务：途经点与循环参数。示例显示途经点和循环次数，当前尚未获得规划路线；应先检查定位与导航状态后刷新。

当前移动端表单不提供 0 次无限循环或逐点停留时间编辑。路线中的预览与最终机器人执行路径可能不同，应持续观察任务状态。

7.4 回充任务

“回充任务”提供两种方式。

“对接附近充电桩”：由机器人执行就近搜索和对接，不依赖地图导航；需要现场满足对应充电桩和对接条件。
“指定充电桩点位回充”：先选择当前地图内的充电点，查看路径，再导航至指定充电桩并对接，需要有效地图和定位。

选定方式并核对对象后，点击“创建回充任务”，通过电量、充电状态和任务反馈确认结果。创建成功不代表已经接触充电桩或开始充电。

图 14　回充任务：就近对接与指定充电点。按现场条件选择回充方式，指定回充需核对充电点位置。

7.5 暂停、继续与取消

任务执行时，机器人视图的任务卡显示目标及状态，并提供相应的“暂停”“继续”和取消入口。点击后阅读确认提示，操作完成后再核对状态。取消后不能将旧任务卡当作可继续执行的任务。

请求失败或结果未确认时，应查看当前状态和任务列表，再决定是否重试，避免把网络超时直接理解为机器人未收到指令。

8. 查询任务与告警

8.1 查询任务记录

从首页任务入口查看云端任务历史，或从设备详情进入该设备的任务列表。设备任务记录和云端记录可能因上传进度不同而暂时不一致。

输入起点或目标点位关键词，或打开“筛选”。
按创建时间范围、任务类型和任务状态筛选。
查看任务卡中的起点、目标、地图与楼层、耗时、创建及结束时间，失败任务可查看可用的失败原因。
没有结果时清除条件再查；加载更多失败时使用重试。

图 15　任务列表：类型、状态和时间筛选。结合任务状态和时间范围查找运行记录。

“未记录”表示该任务没有相应历史快照，不应自行推断位置。需要协助排查时，可使用“复制任务 ID”。“上传回放”只在相应权限、连接和记录条件满足时可用；受理上传请求不等于上传完成，应观察后续进度。

8.2 查询设备告警

从设备详情点击“异常告警”进入“设备告警”；消息中心的告警详情也可提供相关入口。选择“当前告警”查看仍在发生的问题，选择“历史告警”查看事件记录。可按地点、设备、时间和紧急程度筛选。

告警卡显示对应设备、错误名称、进行中或已结束状态，以及开始、结束时间和持续时长。没有结束时间时，不应仅凭阅读消息判断故障已经恢复。

图 16　设备告警：当前与历史事件。通过设备、时间和级别定位告警，并核对恢复状态。

查看告警记录不会改变设备的故障状态。实际恢复应结合机器人上报及现场检查。

9. 查看场地与云端地图

9.1 查找场地

点击底部“场地”，搜索名称、地址或客户，按启用状态筛选。首次使用附近排序时，页面会说明定位用途；允许后可按距离优先显示有权访问的场地。选择“暂不使用”或定位失败时，仍可使用默认排序、搜索与筛选。

图 17　场地列表：搜索与启用状态筛选。通过名称、地址或客户搜索场地，按“全部”“已启用”或“已停用”筛选；右上角提供定位与刷新入口。

9.2 查看场地详情

进入场地后，可在“概览”“地图”“设备”之间切换。

“概览”显示基本信息、所属客户、地址、场地编码以及资源数量；缺失信息会显示“未填写地址”“未提供”或横线等提示。
“地图”按地图与楼层展示云端快照，可进入地图预览并查看可用的版本记录。
“设备”显示绑定设备、状态和绑定信息，可搜索、翻页并进入设备详情。

图 18　场地详情：概览、地图与设备。场地概览汇总地图、楼层、设备、点位和区域数量，并提供基本信息供核对。

图 19　场地云端地图：快照与版本查看。查看已保存的云端地图与版本记录，双指缩放、拖动浏览；下方上传时间和来源设备属于该地图的已有记录。

场地地图是云端资源视图，不能替代机器人当前激活地图或实时定位。当前移动端提供云端地图快照和版本查看，不在此处编辑或部署云端地图。

9.3 有权限时管理绑定

有相应管理权限时，可启用或停用场地，并绑定、解绑设备。绑定候选仅包含所属客户下尚未绑定其他场地的设备。选择设备并确认后检查结果，部分失败时只核对失败项再处理。

解绑前核对设备，确认后该设备从当前场地移除。场地尚未绑定客户时，应先按页面提示在桌面端配置客户。当前移动端不提供场地名称、地址等基本资料的新建或编辑表单。

10. 使用 AI 助手

10.1 启用文字助手

点击底部中央的蓝色加号进入 AI 助手，阅读当前“AI 数据处理”说明，包括服务提供方和信息处理范围。选择“同意并启用文字 AI”后进入对话；选择“暂不启用”不会开启文字助手。无法取得处理说明时，可重试，说明确认前不会启用。

图 20　AI 助手：数据处理说明与授权。先阅读独立的 AI 数据处理说明，再决定是否启用文字助手。

启用后，可输入机器人相关问题，例如“帮我查看我的机器人”“今天机器人执行了多少任务”或“最近有没有告警”。助手可用卡片帮助选择场地、机器人与点位，并展示状态、任务概况或告警；卡片提供对应入口时，可继续查看设备实时页、任务记录或告警记录。

选择卡片可能需要点击选项，也可用文字或语音回答。已过期或已回答的选择不能重复使用，应重新提问并使用最新卡片。查询结果仍受账号权限、服务可用性及设备数据影响。

10.2 涉及机器人动作的请求

助手界面包含移动、急停等动作请求引导。当返回动作确认卡时，应逐项核对机器人、目标与动作后果，再决定确认或取消。查询文字或模型回答不能单独作为动作已经完成的证据，应继续查看实际任务和机器人状态。

不确定对象或目标时，先补充选择信息。不要向助手提供与当前请求无关的账号密码、验证码或他人个人信息。

10.3 语音与记录管理

使用语音前，还需单独同意语音处理说明并允许麦克风。切换至语音输入后按住说话，松开发送；不需要发送时，按录音界面的取消提示操作。服务识别后的文字用于助手请求。可播放页面提供的语音回复。

通过助手的隐私设置或“我的 → 隐私与权限 → AI 与语音授权”，可分别关闭语音输入或文字 AI。“清空本机聊天记录”仅清除当前手机记录，不会删除服务端对话；需要申请删除时，通过帮助与反馈联系支持。

11. 我的、设置与帮助

11.1 个人信息与密码

“我的”显示当前账号姓名、邮箱及可用的账号类型信息，并集中提供账户安全、偏好和帮助入口。此页用于核对当前登录身份，不提供头像、姓名或邮箱的直接编辑表单。

图 21　我的：账户安全、偏好与帮助入口。在修改设置前核对当前账号，避免在错误账号下操作。

进入“修改密码”，填写旧密码、新密码和确认密码，核对新密码符合页面要求且两次一致后提交。页面提示成功后返回；出现错误时按提示处理，不能仅因返回上一页判断修改成功。

11.2 语言与外观

进入“语言与外观”，选择简体中文或 English，并选择深色、浅色或跟随系统。跟随系统会匹配手机当前的深浅模式。调整外观不改变机器人地图、任务或账号权限。

图 22　语言与外观：界面语言和显示模式。按使用习惯选择语言和显示模式，亦可跟随系统外观。

11.3 隐私与权限

进入“隐私与权限”，可通过“系统权限”“AI 与语音授权”“第三方服务与信息共享清单”和“账号与个人信息请求”查看相应设置与说明。

图 23　隐私与权限：系统权限与服务授权。查看系统权限、服务授权和账号信息请求入口，按需要调整。

撤回隐私同意会停止相关发现、退出登录并清理相应本机记录。该操作不会撤销手机系统权限，也不会自动删除服务器账号及机器人记录；需要更正、删除个人信息或注销账号时，应联系支持核实处理。

11.4 通知设置

当前版本启用消息功能时，进入“通知设置”，核对系统通知权限，选择是否接收云端通知，并分别设置任务完成、取消、失败和设备告警提醒。可在“关注范围”中设置地点或设备规则。

图 24　通知设置：云端通知与本机连接提醒。按实际关注范围选择提醒，关闭提醒后仍可查看消息中心。

设备规则优先于地点规则，“默认”表示继承相关设置，不等于“不关注”。设备或地点转移到其他客户后，应重新确认关注范围。

“连接中断提醒”用于当前手机已连接并验证的机器人。本机提醒依赖应用运行，切到后台、系统回收或强制停止时可能延迟或停止，不能作为实时安全监控的替代。

11.5 机器人设置与版本信息

设备详情的“设置”与“我的”中的个人设置不同。它按机器人能力提供导航参数、语音、网络、转向标定和关于本机等入口。查看数据前先确认连接，设备不支持或尚未提供参数时，按页面提示处理。

导航参数保存后，应核对返回的生效结果；已保存但待应用时，不应认定机器人已经使用新参数。网络设置会影响机器人连接，断开 Wi-Fi 还可能清除保存的该网络凭据。转向标定涉及机器人机械动作，应由具备条件的维护人员依据设备说明实施。

“关于本机”可查看设备信息和有权访问的模块版本、升级状态；看到“可升级”不代表移动端已经下发升级。应用自身版本可在“我的 → 关于控灵”查看，该页还提供公司信息与协议入口。

11.6 帮助与反馈

进入“帮助与反馈”，查看支持邮箱，选择“撰写邮件”或“复制邮箱”。需要更正、删除个人信息或注销账号时，可选择“撰写隐私请求”。撰写入口会尝试打开手机邮件客户端，由你检查内容并发送；点击撰写按钮不等于反馈已提交。

图 25　帮助与反馈：联系支持与个人信息请求。选择邮件或隐私请求入口，检查邮件内容后再发送。

应用不会自动附带日志或账号信息。反馈时说明问题发生页面、操作步骤、时间和可见错误提示。涉及设备时，仅提供排查所需的信息；不要附上密码、验证码、热点密码或他人的个人资料。无法打开邮件应用时，可复制地址到可用的邮件工具。