中文 · 控灵

控灵桌面端操作手册

Guide version V1 · 2026-10-15Chinese-language guide · Select an image to view full size

控灵桌面端用于集中查看机器人、地点、地图、任务和告警，并连接机器人完成现场部署与日常运维。本手册依次介绍登录与连接、状态观察、地图准备、任务操作、告警查询和个人设置。

本手册截图中的用户身份、机器人身份与地点信息已脱敏。文中的“演示机器人”为示例名称。界面会根据账户权限、机器人型号、配套硬件和软件能力显示相应功能；如果某个入口没有显示，请先核对授权及设备能力。

1. 安装与使用准备

1.1 安装客户端

从官网下载中心取得与电脑系统、处理器架构相符的安装包。控灵提供 Windows、macOS 和 Linux 桌面客户端；macOS 版本适用于 Apple Silicon 电脑。具体可用安装包以下载页面为准。

Windows 用户运行安装程序，并按提示完成安装。
macOS 用户打开磁盘映像，将控灵放入应用程序目录后启动。
Linux 用户根据系统选择对应安装包，完成安装或运行授权后启动。
首次启动时，如操作系统请求本地网络、蓝牙等访问权限，请根据需要使用的连接方式授权。

预期结果：出现控灵登录界面，或恢复已有的登录会话。

1.2 准备账户和机器人

准备已开通的账户及可访问的机器人。机器人应完成交付配置并正常上电，电脑应能访问所需网络。使用局域网直连时，让电脑与机器人处于可相互访问的网络中；网络隔离可能影响发现或连接。

仅查看设备列表与连接后的状态不会创建运动任务。执行移动、巡逻、回充、遥控和建图前，应核对目标设备及现场环境，确保操作人员能够观察机器人并及时处理异常。

2. 登录与认识工作界面

2.1 登录

在“邮箱”中输入已开通账户的邮箱地址。
输入密码，点击“登录”。
按提示完成安全验证；如要求重置密码，依照页面规则设置并确认新密码。
登录成功后进入“欢迎”页面。

预期结果：页面显示当前账户有权访问的数据和功能入口。登录失败时，先检查邮箱和密码，再确认账户状态；验证图案加载失败时可刷新后重试。

2.2 阅读欢迎页面

欢迎页面的“数据概览”汇总地点数、异常告警、累计里程、任务时长及设备和任务统计。“最近访问的设备”便于再次打开常用机器人，“最近执行任务”用于回看近期任务。阅读统计时应留意对应状态、时间以及当前账户的数据范围；最近访问记录不代表机器人此刻一定在线。

左侧导航用于进入设备管理等常用功能。用户菜单包含“设置”“关于”和“退出登录”，可用入口会根据账户权限显示。离开共享电脑前，可通过用户菜单退出登录。

欢迎页面：从数据概览了解设备和任务情况，通过最近访问记录进入常用设备。

3. 查找设备与连接本地机器人

3.1 查找设备

进入“设备管理”，打开“设备列表”；使用个人授权设备的账户也可进入“我的设备”。
按设备编号搜索，或结合所属产品、所在地点、在线状态、服务状态、任务状态缩小范围。
在目标设备行查看服务状态、电量、地点、最后心跳等信息。
需要进一步了解设备时，打开详情；准备观察实时状态时，点击“连接”。

预期结果：找到目标机器人，并明确它当前是否在线、是否正在作业及是否有异常。电量、位置等内容以机器人实际回报为准；没有数据不应理解为数值为零。

设备列表：按条件查找目标机器人，查看服务状态、电量与连接入口。

3.2 使用局域网连接

确认电脑和目标机器人处于可直连的网络中。
在设备列表中找到目标机器人，查看是否显示“附近设备”。桌面客户端也可通过“附近设备”入口发现已授权设备。
点击“连接”，阅读连接确认信息。检测到同一局域网中的设备时，页面会说明将使用局域网直连。
确认目标设备正确后建立连接，等待状态进入“已连接”并开始接收数据。

预期结果：进入机器人实时面板，能持续看到设备状态更新。未发现局域网设备时，系统可能提示使用云端连接；该方式可能消耗机器人的移动网络流量，应先确认现场网络条件。

连接确认：核对目标设备和连接方式后，再进入机器人面板。

3.3 手动添加局域网设备

自动发现没有找到目标设备时，可在桌面客户端的“附近设备”页面点击“手动添加”。使用前先确认电脑与机器人处于同一可互通网络，或者电脑已经连接机器人的热点。

在“手动添加设备”窗口中填写目标机器人的“设备 SN”。
在“主机 / IP”中填写该机器人的局域网主机名或地址。信息应由现场管理人员提供，不要照抄其他设备的值。
核对两项信息后点击“添加并连接”，等待设备验证结果。
验证成功后核对设备列表中的目标设备；如仍停留在列表，使用该设备的连接入口进入实时面板。

预期结果：目标设备被识别，并能够按授权范围建立连接。若验证超时或设备身份不匹配，先检查网络、地址和设备编号；手动添加不会绕过账户的设备访问权限。

手动添加设备：填写设备编号和局域网地址，验证目标身份后再连接。

3.4 连接异常处理

“离线”“已关机”和“关机中”等状态会影响连接；部分服务异常也会使连接入口不可用。先确认设备已开机、网络正常及账户拥有访问权限。若面板显示正在重连，等待连接恢复并观察数据是否重新更新；连接恢复后，重新检查地图、定位和任务状态，再进行后续操作。

4. 观察实时状态与调整面板

4.1 先看状态，再看画面

进入机器人面板后，先核对设备名称、连接状态、电量、当前导航地图、任务状态及急停状态。地图中的机器人图标、方向和相关图层用于辅助理解位置；只有设备持续上报且定位有效时，才能据此判断当前状态。

常见状态包括空闲、任务中、遥控中、建图中、标定中、回充中和异常。状态变化会影响可用操作。若出现“需要重新定位”，或观察到数据长时间不再更新，应先恢复定位或通信，不要继续依赖旧画面下发运动任务。

机器人实时面板：集中查看机器人视图、连接状态、电量和任务信息。

4.2 添加与排列信息面板

通过“查看”菜单中的“面板”入口选择所需视图，例如机器人视图、日志、摄像头、电池状态或电机状态。可按工作需要调整布局，并使用“保存布局”保留常用组合；需要恢复时使用“重置布局”。可选面板由设备能力决定。

日常值守可同时观察机器人视图、电池与日志；排查问题时再添加对应状态面板。摄像头没有画面时，应检查设备是否配备并启用了相关摄像头，不要把缺少画面直接判断为整机故障。

4.3 运动相关入口

具有相应权限和设备能力时，可使用键盘遥控或手柄遥控。操作前应确认目标设备、现场人员与障碍物，并遵循当前界面给出的按键及限速提示。机器人处于急停、充电或其他限制状态时，部分操作会不可用。

暂停任务、取消任务和急停用途不同。暂停用于暂时中断当前任务；取消表示结束该任务；急停用于及时停止运动。软件急停依赖有效通信，现场紧急情况应使用机器人自身的急停装置。解除急停前应确认导致急停的原因已经排除。

5. 管理地点与设备归属

“地点”用于组织同一场所的地图、楼层和设备。需要管理地点的账户可在“设备管理”中进入“地点列表”，按地点名称或地址搜索，并结合状态筛选。列表汇总所属客户、地图数、楼层数、点位数与设备数，便于找到要管理的场所。

搜索地点名称或地址，打开目标地点详情。
在“基本信息”中查看名称、地址、所属客户及联系信息。
在“地图管理”中查看该地点的地图与楼层信息。
在“设备绑定”中核对该地点关联的设备；具有编辑权限时再执行新增、调整或解除绑定。

预期结果：地点、地图和机器人归属一致，后续能够找到正确的地图资源。新建或修改地点时，应填写易于辨认的名称。地址和联系人属于实际业务信息，向外部提供截图前应先作适当处理。

地点列表：搜索目标场所，核对地图、楼层和设备数量，再进入详情。

6. 管理地图、点位与区域

6.1 认识两类地图入口

连接机器人后，可通过“地图”菜单进入“地图管理”，查看“本机地图”“云端地图”和“同步任务”。地点详情中的“地图管理”则用于围绕该地点管理共享地图资源。

“本机地图”指机器人上的地图；“云端地图”用于保留和分发地点地图版本。浏览其他地图不会自动把它设为机器人正在使用的导航地图。执行导航前，应核对面板中的“当前导航地图”。

地图管理：区分本机地图、云端地图与同步任务，并核对当前导航地图。

6.2 查找与查看地图

打开“地图管理”，按地图名称或楼层筛选。
选择目标地图，查看地图形状、点位、区域及版本信息。
如需使用该地图导航，先确认它对应机器人实际所在场所与楼层，再按界面提供的“设为导航地图”流程操作。
等待地图加载和定位状态就绪后，再创建导航任务。

预期结果：当前导航地图与现场一致，机器人位置能够在地图中正确显示。切换或退出导航地图会改变后续任务条件，应在现场允许的情况下操作。

6.3 在地图上放置点位

进入目标地图的编辑界面后，先核对地图和楼层。普通点位用于表示机器人需要到达的位置；充电桩等专用点位应与现场设备对应。

在左上方工具栏选择“点位”工具，将鼠标移入地图，看到“单击绘制点”提示。
在需要停靠的位置单击，进入朝向设置。
移动鼠标调整点位朝向，再次单击确认方向，打开“创建点位”窗口。
若选错位置，可取消本次绘制后重新选择。

预期结果：选定位置与朝向，进入点位属性填写窗口。位置应处于可通行空间，不能落在障碍物、禁行区或地图范围之外。

放置点位：选择点位工具，在地图中确定位置，再设置机器人到达时的朝向。

面板中的“创建点位”入口还可选择“使用机器人当前位置”。使用这一方式前，应确认机器人定位准确，并已处于期望的实际位置和朝向。

6.4 填写并确认点位属性

在“创建点位”窗口中填写名称，按用途选择类型，并核对下方坐标信息。名称应便于现场人员识别，同一地图中避免使用容易混淆的名称。

填写“名称”，选择“类型”。普通导航目标使用普通点位；专用点位按实际用途配置。
根据作业需要选择“到达策略”。选择普通到达时，核对“允许停靠半径”及其厘米单位；不要直接把示例图中的数值当作所有场所的推荐值。
按实际情况设置“是否存在货架”。涉及货架的目标还需完成该类型要求的配置，不能仅靠打开开关代替现场部署。
确认位置、朝向及属性正确后，点击“确定”。

预期结果：窗口关闭，地图中出现对应点位。点位创建只是保存导航目标，不会让机器人自动前往。创建失败时，按提示修正名称、属性或连接条件，再确认结果。

确认点位属性：核对名称、类型、到达策略和停靠半径后，创建地图点位。

6.5 修改已有点位

在地图中找到需要修改的点位，双击打开“编辑点位”。
修改名称、类型或到达策略；需要调整位置时，核对 X、Y 与朝向输入框。
按现场位置和方向检查修改值，再点击“确认”。
返回地图核对显示结果；需要移除点位时，先确认没有后续作业依赖它，再使用“删除此点位”。

预期结果：所选点位的属性或位置被更新。修改坐标和朝向会改变后续任务的目标，尤其要复核充电桩等专用点位是否仍与实体设备一致。

编辑点位：在原有点位上修改属性与位置，确认前检查 X、Y 和朝向。

6.6 创建区域与绘制禁行区

区域用于表达具有特定通行要求的地图范围。以下以“禁行区”为例：

在“添加区域”菜单中选择“禁行区”。
在地图上按住并拖动，框选需要限制进入的范围，松开后打开“创建区域”。
填写区域名称，核对“区域类型”为“禁行区”，并检查“启用”开关。
确认范围与属性后点击“确认”。

创建区域：核对区域类型与启用状态，使绘制范围对应正确的通行要求。

预期结果：地图中显示对应区域及边界。完成后切回选择工具，检查区域没有覆盖正常作业目标或必经通道。需要临时保留而不启用的区域，应核对其开关状态，不能只凭图形是否存在判断通行限制。

检查禁行区：查看区域边界与覆盖范围，避免误封目标位置或必要通道。

6.7 绘制禁行线

禁行线用于在地图上标记不允许穿越的边界。与框选区域不同，它由起点和终点确定。

在工具栏选择“绘制禁行线”。
在地图中单击起点，再单击终点，完成一段禁行线。
检查线段位置、端点及覆盖的通道；误选时取消当前绘制并重新操作。
切回选择工具，结合已有区域和点位复核通行空间。

预期结果：地图中出现禁行线。绘制前应确认边界与现场要求一致，不要把机器人和任务目标隔在无法互通的两侧。

绘制禁行线：用两个端点确定通行边界，并检查线段是否误封作业路线。

6.8 核对修改与保存编辑

点位和区域在各自窗口确认后会写入机器人，因此不要将关闭编辑页面当作撤销操作。完成编辑后，检查地图中的点位、区域与禁行线，再使用右上方“保存编辑”完成保存确认；需要同步云端时，按保存窗口提供的选项继续操作。

预期结果：确认本机地图的编辑结果，并按所选方式完成后续保存或同步。若页面提示仍有未保存草稿、连接异常或同步未完成，先按提示处理；地图上传或部署的进度还需到“同步任务”核对。

6.9 同步与版本

地图同步状态可能显示“已同步”“本地有更新”“云端有更新”“本地与云端均有更新”“本地修改未保存”或“同步异常”。先根据状态处理保存、上传、更新或冲突，再判断哪个版本应该投入使用。

上传云端或向机器人部署地图后，在“同步任务”中查看进度和结果。任务已创建不等于地图已经在机器人上生效。涉及审核的版本，应由有权限的人员完成审核并通过部署检查。需要回到旧版本时，先核对该版本内容及影响，再进行版本切换或回滚。

6.10 新建地图

需要重新采集场所地图时，在“地图管理”中使用“添加地图”，填写地图名称和楼层；为已有地图补充楼层时，选择相应方式。进入建图界面后，按提示开始建图并观察地图逐步形成。

由现场操作人员缓慢带领机器人覆盖需要使用的区域，保持环境相对稳定。完成采集后保存地图，等待明确的保存结果，再进行点位和区域编辑。若出现“保存结果待核对”或类似提示，应保留当前页面并按提示核对，不要重复新建或直接关闭客户端。

7. 矫正定位与设置起始位置

当机器人显示位置与现场不符，或提示需要重新定位时，先确认所选导航地图和楼层正确。地图选择错误时，单纯调整位置不能解决问题。

在机器人面板中打开“矫正地图”或按重新定位提示进入相应界面。
根据现场固定结构确定机器人的实际位置和朝向。
矫正时，拖动实时激光轮廓，并用“旋转”滑杆调整方向，使其与地图中的固定结构对齐；需要平移视图时，可按住 Shift 或使用右键拖动。
如果页面要求设置起始位置，先点击机器人实际所在位置，再调整朝向。
检查叠加效果后，点击“完成矫正”或“确认起始位置”，等待定位验证完成。

预期结果：显示矫正已生效或起始位置已生效，机器人位置与现场对应，定位恢复可用。若没有实时激光数据、地图发生变化或匹配失败，应先检查原因。出现结果不确定提示时，使用页面提供的查询或重试入口，不要不断更换位置重复提交。

矫正地图：调整激光轮廓与地图的对齐关系，核对后再点击“完成矫正”。

8. 创建移动任务

8.1 选择目标并预览

连接目标机器人，确认它空闲、定位有效且处于正确导航地图。
打开“任务”中的“创建任务”，选择“移动任务”。
根据地图、楼层及点位名称筛选目标；可从点位列表选择，也可点击地图中的标记。
查看目标位置、朝向和机器人当前位置。使用放大、缩小或“适应地图”检查位置关系。
设备支持时，查看生成的路径预览；需要时使用“刷新路径”重新获取。

预览用于辅助判断目标与路径。选择目标、切换地图视图和刷新路径不会创建任务。倾斜视图用于观察单张地图，不代表已经规划完成多楼层路线。

移动任务预览：先选择目标并检查地图位置与路线，点击“确认创建”才会下发任务。

8.2 确认执行与查看结果

确认目标、现场通道及机器人状态正确后，点击“确认创建”。创建成功后，在机器人面板观察任务状态和进度；需要查看历史结果时，进入“设备管理”的“任务列表”，按设备、类型、状态和时间筛选，再打开“任务详情”。

预期结果：任务按设备反馈进入执行、完成或失败等状态。以最终任务状态判断结果，不要仅凭画面中机器人靠近目标就认为任务已经完成。创建失败时，阅读原因并修正条件，避免连续重复点击。

当前可以查看其他地图或楼层的点位及部分路线信息，但跨地图、跨楼层目标仅供预览，不能按本手册创建跨地图执行任务。货架等专用目标具有额外检查和现场确认流程，不应按普通移动点直接执行后续动作。

9. 创建巡逻与回充任务

9.1 巡逻任务

在“创建任务”中选择“巡逻任务”。
添加途经点，并按照需要的访问次序排列；可使用向上、向下操作调整顺序。
为各点设置停留时间，并填写循环次数。界面中“0 = 无限循环”，需要持续巡逻时应特别核对。
按需要设置“结束后返回充电桩”或“电量低于 20% 时结束巡逻并回充”，并确认存在有效充电桩点位。
查看地图上的途经顺序，核对完成后点击“确认创建”。

预期结果：机器人按照任务顺序访问点位，执行中可在面板查看状态。巡逻预览中的编号表达访问顺序，实际行驶时逐段规划路线。不要将充电桩或货架专用点位作为普通巡逻途经点，也不要设置相邻重复点。

巡逻任务配置：核对途经顺序、停留时间、循环次数和回充选项，再确认创建。

9.2 回充任务

在“创建任务”中选择“回充任务”，根据现场情况选择方式：

“对接附近充电桩”：机器人在附近搜索并对接充电桩，无需激活导航地图。应根据当前车型的指引准备起始位置，保证识别区域无遮挡并留出调整空间。
“导航到指定充电桩”：选择当前导航地图中的有效充电桩点位，机器人先导航到点位附近，再进行对接。应确认点位与实体充电桩的位置、朝向一致。

选择回充方式后，阅读右侧的对接建议，检查机器人与充电桩之间的通道、充电桩供电和固定情况，再确认创建。界面中的 3D 对接动画是动作示意，不是机器人实时状态；只有设备提供经标定的建议距离时，才按对应数值及测量基准操作。

预期结果：任务进入回充过程，并最终由设备回报充电状态。若未能识别或对接，先检查起始位置、遮挡和充电桩状态，排除原因后再重试。

回充任务配置：按现场条件选择附近对接或指定充电桩，并阅读右侧对接建议。

10. 查看告警与故障记录

在机器人面板中打开“异常告警”，核对窗口对应的设备。窗口包含“活跃告警”和“故障记录”两个标签：前者用于关注当前告警，后者用于回溯故障何时发生、持续多久及是否恢复。具有对应权限时，也可从“设备管理”的“告警管理”进入查询。

10.1 查看活跃告警

切换到“活跃告警”。
按需要选择“告警类型”或“错误代码”，点击“查询”。
阅读告警内容及状态，并对照机器人的当前状态和现场情况判断问题。
需要查看其他类型时，可调整筛选条件再次查询；要清除已设条件时，点击“重置”。

预期结果：找到需要关注的告警及其含义。如果列表为空，先核对筛选条件和设备连接；空列表不能单独证明设备没有异常。

10.2 查询故障记录

切换到“故障记录”。
根据排查目标选择“告警类型”和“错误代码”。需要更多筛选项时，点击“展开”，按显示的条件继续填写。
点击“查询”，查看符合条件的记录；点击“重置”清除条件后，可重新查询。
按故障发生时间找到相关记录，再核对恢复时间、持续时长和故障状态。
记录右侧提供“查看”入口时，点击打开该条记录的详细诊断信息，阅读后关闭并返回列表。

查询故障记录：按告警类型和错误代码筛选，结合发生、恢复时间与持续时长定位问题。

10.3 理解记录与反馈问题

阅读故障记录时，可依次核对以下信息：

告警类型、错误代码：说明问题类别和具体含义，便于区分不同故障。
发生时间、恢复时间：说明这一条故障的起止时间，可用于对照当时的操作和设备状态。
持续时长：帮助判断问题是短暂出现还是持续存在。
故障状态：区分仍在发生的问题和已经恢复的记录。“已恢复”表示该条记录已结束，不代表其他故障也已排除。
查看：用于读取该条记录的补充诊断信息；没有此入口时，以列表显示内容为准。

预期结果：能够区分当前问题与历史记录，并找到与现场现象相关的时间和错误信息。查询或查看记录不会解除设备故障；处理原因后，还应观察设备状态及告警是否恢复。

反馈问题时，记录发生时间、操作步骤、错误信息和当前客户端版本。比较不同页面的时间前，先核对客户端时区。若机器人出现异常而页面数据长期不更新，应先检查通信。

11. 偏好设置、账户信息与客户端更新

11.1 显示和时间

打开“设置”中的“通用”页面，在“显示设置”选择颜色主题和语言，在“时间设置”选择时区与时间戳格式。颜色主题提供深色、浅色、跟随系统；语言提供中文与英文。按使用环境调整后，检查页面显示是否符合预期。

排查跨地区设备的事件时，应先确认时区，再比较任务和告警时间。切换语言后，菜单名称会相应变化；本手册使用中文界面名称。

通用设置：根据使用习惯选择主题、语言、时区和时间显示格式。

11.2 账户信息与修改密码

需要修改当前账户的登录密码时，打开“设置”中的“账户信息”，进入“编辑密码”窗口。

在“旧密码”中输入当前密码。
在“新密码”中输入准备使用的新密码。
在“确认密码”中再次输入相同的新密码，检查两次输入一致。
点击“保存”，等待保存结果；若页面提示输入有误，按提示修正后重试。
如果暂不修改，点击“取消”关闭窗口，不提交本次输入。

预期结果：保存成功后，使用新密码进行后续登录。仅打开编辑窗口或填写输入框，不代表密码已经修改；应以保存结果为准。

修改密码：依次填写旧密码、新密码和确认密码，点击“保存”提交，或点击“取消”放弃。

11.3 更新桌面客户端

打开“关于”，先查看当前客户端版本；反馈问题时可记录这里显示的版本信息。需要更新时点击“检查更新”，也可按需要设置新版本提醒。发现新版本后，先阅读更新内容再选择下载。

按电脑系统完成安装：

Windows：下载完成后，按提示点击“安装并重启”，等待安装程序完成并启动新版本。
macOS：下载完成后，点击“安装并重启”。客户端会打开磁盘映像并退出；按安装窗口提示将新版本放入应用程序目录，完成后重新启动控灵。
Linux：客户端会打开更新下载地址。下载适用的安装包，按安装说明完成更新后启动控灵。

如出现文件校验失败提示，应重新下载，不要在报错后继续安装。

预期结果：完成安装并重新启动后，“关于”页面显示目标版本。更新前结束正在进行的操作并保存未完成编辑；机器人正在建图、保存地图或执行其他需要当前会话配合的流程时，应先完成相应收尾。

关于控灵：查看当前客户端版本、检查更新，并按需要设置新版本提醒。