Platform · users & FAQ | 机器人技术学习笔记

7 系统管理模块

7.1 用户管理

7.1.1 功能概述

用户管理是具身数据平台的核心权限管理模块，提供集中管理账户、角色与项目归属的完整功能。通过支持批量创建、筛选与过期时间设置，实现组织级用户与角色治理，确保平台用户体系的安全性和可管理性，为不同角色提供相应的权限控制和管理功能。

7.1.2 适用角色

角色	职责
管理员	作为平台管理员，您可以进行组织级用户与角色治理，管理所有用户账户，配置系统权限，并监控用户活动。这些功能确保平台的用户管理体系安全高效
项目经理	项目经理可以维护项目成员，分配项目权限，管理项目用户，并协调项目团队。通过用户管理，项目经理能够有效控制项目的用户资源

7.1.3 主要功能

7.1.3.1 用户账户管理

用户创建

支持单个和批量创建用户账户，包括基本信息设置、密码配置、角色分配等。通过标准化的用户创建流程，确保账户信息的完整性和准确性。

用户信息管理

提供用户信息的全面管理功能，包括基本信息修改、联系方式更新、头像设置等。通过信息管理，保持用户数据的时效性和准确性。

账户状态管理

支持用户账户的状态管理，包括激活、禁用、锁定、删除等操作。通过状态管理，确保账户安全，防止未授权访问。

7.1.3.2 角色权限管理

角色定义

支持定义多种用户角色，包括管理员、项目经理、标注员、审核员等。每个角色都有相应的权限配置，确保权限的细粒度控制。

权限分配

为不同角色分配相应的权限，包括功能权限、数据权限、操作权限等。通过权限分配，实现基于角色的访问控制。

权限继承

支持权限的继承机制，子角色可以继承父角色的权限。通过权限继承，简化权限管理，提高管理效率。

7.1.3.3 项目归属管理

项目分配

支持将用户分配到不同的项目，包括项目成员添加、移除、角色调整等。通过项目分配，实现项目级的权限控制。

项目权限

为项目成员设置项目内的权限，包括数据访问权限、操作权限、功能权限等。通过项目权限，确保项目数据的安全。

权限继承

支持项目权限的继承机制，用户可以从项目角色继承相应的权限。通过权限继承，简化项目权限管理。

7.1.3.4 批量操作功能

批量创建

支持批量创建用户，包括从Excel、CSV文件导入用户信息。通过批量创建，大大提高用户管理效率。

批量修改

支持批量修改用户信息，包括角色调整、权限变更、状态更新等。通过批量修改，快速完成大量用户的管理操作。

批量删除

支持批量删除用户，包括用户账户、相关数据、权限记录等。通过批量删除，快速清理不需要的用户数据。

7.1.3.5 时间管理

过期时间设置

支持为用户设置账户过期时间，包括临时账户、试用账户、定期续期等。通过过期时间设置，实现账户的生命周期管理。

自动提醒

提供账户过期提醒功能，包括邮件通知、系统提醒、自动续期等。通过自动提醒，确保用户及时处理账户问题。

过期处理

支持账户过期后的自动处理，包括账户禁用、数据清理、权限回收等。通过过期处理，确保系统安全。

8 常见问题

问题类型	问题	解答
账号与登录	忘记密码怎么办？	请联系管理员在后台重置密码。连续5次输入密码错误，系统会将账号和IP暂时禁止。
	可以注册新账号吗？	平台是否开放注册由管理员决定。如需新账号，请联系管理员创建。
	登录后看不到某些功能怎么办？	这通常是因为权限不足。请确认您的角色和项目权限，或联系管理员调整权限。
数据管理	如何上传数据？	在"数据上传"页面选择项目与云存储，支持视频、音频、ROS数据等多种格式。
	支持哪些数据格式？	支持Mcap、Bag、Mp4、音频等ROS标准格式文件，支持在线转码为Mcap格式。视频和音频文件可以在浏览器中自动转换为MCAP格式。
	视频转换功能支持哪些浏览器？	视频转MCAP功能需要浏览器支持MediaStreamTrackProcessor API，目前仅支持最新版本的Chrome（94+）和Edge（94+）浏览器。使用其他浏览器时会有明确提示。
	音频文件可以上传吗？	可以。平台支持MP3、WAV、AAC、OGG等音频格式，会自动转换为MCAP格式的AudioData消息，方便用于机器人训练。
	数据上传失败怎么办？	检查文件格式是否正确、网络连接是否稳定、云存储配置是否正确。如果上传的是视频文件，请确保使用Chrome或Edge浏览器。失败的任务可以重试上传。
	重新上传已删除的数据集会怎样？	系统会自动检测是否存在同名的软删除数据集。如果存在，您可以选择恢复现有数据集（保留所有历史信息）或创建新数据集。
数据标注	如何创建标注任务？	在"数据"页面筛选目标数据并勾选，点击底部"标注"按钮，填写任务信息后创建。
	标注任务状态有哪些？	包括：待开始（PENDING）、进行中（IN_PROGRESS）、待检查（PENDING_REVIEW）、检查合格（REVIEWED）、提交数据（SUBMITTED）等状态。
	如何查看任务的详细信息？	在任务列表中点击任务名称或ID，进入任务详情页。详情页包含多个标签页：标注数据、批量标注、问题标注，可以全面了解任务情况。
	可以批量删除任务吗？	可以。在任务列表中多选任务，点击底部的"批量删除"按钮，确认后即可批量删除选中的任务。删除操作不可恢复，请谨慎操作。
	标注数据被审核员打回怎么办？	查看审核员的反馈意见，根据要求修改标注内容后重新提交。可以在任务详情页的"问题标注"标签页查看所有无效标注。
数据导出	如何导出标注数据？	在"数据导出"页面选择要导出的数据，支持JSON、CSV、HDF5、LeRobot、MCAP等多种格式。导出任务会自动加入队列处理，可以在导出历史中查看进度。
	HDF5导出如何配置？	HDF5导出需要设置两个参数：分组数量（每个HDF5文件包含的原始文件数量）和数据刷新频率（每秒数据采集次数，默认30Hz）。详细说明请参考HDF5导出文档。
	如何查看导出进度和历史？	在数据导出页面的"导出历史"区域可以查看所有导出任务的列表和状态。处理中的任务会显示实时进度条，已完成的任务可以下载结果文件。
	如何管理标注字典？	在"字典管理"页面可以维护技能、目标、对象等标注标签。
模型训练	如何选择合适的模型?	选择建议: 1. 确定任务类型:是理解指令、模仿学习还是强化学习? 2. 查看模型说明:每个模型都有详细说明，了解适用场景 3. 参考应用案例:查看模型的应用案例，选择最接近你任务的模型 4. 从小规模开始:先用小数据集测试，确认模型效果后再大规模训练
	训练需要多长时间?	时间估算: 训练时间取决于: - 数据量:数据越多，训练时间越长 - 模型复杂度:复杂模型需要更长时间 - 计算资源:GPU 性能越好，训练越快 - 训练步数:步数越多，训练时间越长一般情况: - 小数据集(1000 条以下):1-3 小时 - 中等数据集(1000-10000 条):3-12 小时 - 大数据集(10000 条以上):12 小时以上优化建议: - 使用多 GPU 并行训练可以显著缩短时间 - 适当降低 batch_size 可以加快单步速度 - 使用更强大的 GPU 可以提升训练速度
	如何判断训练是否正常?	正常训练的指标: - 损失下降:训练损失应该逐渐下降 - 验证指标提升:验证集上的性能应该逐渐提升 - 资源稳定:GPU 利用率应该保持稳定，不会频繁波动 - 无错误日志:日志中不应该有大量错误信息异常情况: - 损失不下降:可能是学习率过大或过小，需要调整 - 损失震荡:可能是 batch_size 太小，需要增大 - 显存溢出:需要降低 batch_size 或使用更大的 GPU - 训练卡住:检查数据加载是否正常，网络是否稳定
	训练失败怎么办?	处理步骤: 1. 查看错误日志:在训练详情页面查看详细的错误信息 2. 分析失败原因:根据错误信息判断是数据问题、参数问题还是资源问题 3. 修复问题:根据原因采取相应措施 4. 重新训练:修复后重新创建训练任务常见错误: - 显存不足:降低 batch_size 或使用更大的 GPU - 数据格式错误:检查数据格式是否符合要求 - 参数配置错误:检查参数设置是否合理 - 网络问题:检查网络连接是否稳定
移动端支持	平台支持移动端吗？	平台基于Web技术开发，支持在移动设备浏览器中访问，但建议使用桌面端获得最佳体验。
移动端支持	移动端有哪些功能限制？	移动端主要支持查看和简单操作，复杂的标注任务建议使用桌面端。
使用技巧	如何提高标注效率？	- 熟悉快捷键操作 - 使用标注模板 - 批量处理相似数据 - 定期与团队沟通优化流程
	如何保证标注质量？	- 仔细阅读标注规范 - 使用统一的标注标准 - 定期进行质量检查 - 及时反馈和改进
	如何管理大量数据？	- 合理使用标签和分类 - 建立清晰的文件命名规范 - 定期整理和归档 - 利用平台的批量操作功能
技术支持	遇到技术问题如何获得帮助？	可以通过以下方式获得帮助： 1. 查看本文档 2. 查看功能模块详细说明 3. 联系管理员 4. 联系技术支持团队