科研自动驾驶物理引擎【免费下载链接】webotsWebots Robot Simulator项目地址https://gitcode.com/gh_mirrors/web/webots点击查看免费下载本指南围绕 Webots 的 Community Projects 生态展开当你在 官方示例与设备库 中找不到所需机器人模型时如何从社区项目仓库中获取他人已转换好的模型、示例世界与控制器并通过「Extra project path」机制将其无缝接入本机 Webots同时也会深入讲解该机制在源码层面的实现原理src/webots/core/WbProject.cpp以及如何按照社区规范反向贡献自己的成果。读完本文你将掌握从下载、配置到贡献社区项目的完整闭环操作。什么时候需要 Community ProjectsWebots 官方安装包内置了数量庞大的机器人模型、PROTO 节点、示例世界与控制器分布在仓库的 projects/robots 与 projects/objects 目录中并且官方文档已经按示例类型做了系统归纳见 示例 Webots 应用总览。但现实中的机器人型号五花八门官方库不可能覆盖所有型号。Community Projects 正是为此而生它是一个由 Cyberbotics 官方维护、面向全体 Webots 用户开放贡献的共享仓库专门存放官方发行版之外、由社区成员自行建模与分享的各类资源。正如原始文档所强调的如果你正在使用的机器人并未被官方收录进 Webots先到社区项目仓库里找一找——很可能已经有人完成了转换并乐于分享给所有人。根据仓库内发布记录docs/blog/Webots-2020-b-release.md社区仓库是在 Webots R2020b 时代正式推出用于让社区共享 PROTO 节点、控制器、世界等资源并邀请用户提交贡献。仓库内早期讨论如 docs/discord/technical-questions-2020.md也印证了社区仓库的实际用途例如把 Robotiq 夹爪等第三方设备的 PROTO 节点放入仓库供他人直接复用。社区仓库可贡献的内容并不局限于机器人模型也可以是某个真实机器人的 PROTO 节点模型含几何、物理属性、传感器配置完整的示例世界.wbt文件配套的控制器C / C / Python / Java / MATLAB 等纹理、材质等附属资源。第一步获取社区项目仓库接入社区资源的第一步是把社区项目仓库拿到本地。官方推荐的方式是下载压缩包或使用git clone将仓库克隆到一个你方便管理的文件夹中例如~/webots/community-projects。仓库本身遵循 Webots 标准项目目录组织方式因此克隆后不需要任何安装步骤也不要求放在 Webots 安装目录内部——它完全以独立路径的形式挂载到 Webots 中挂载机制见下文源码分析。提示建议使用 Git 克隆而非仅下载快照这样后续可以通过git pull持续同步社区新增的模型与修复也便于你以 Pull Request 方式贡献自己的成果。第二步通过「Extra project path」将社区项目挂载进 Webots获取仓库后需要在 Webots 偏好设置中把仓库路径登记为「额外项目路径Extra project path」。图形界面操作步骤打开 Webots进入菜单Tools Preferences工具 偏好设置。在General通用标签页中找到Extra project path输入框。填入你刚才下载/克隆社区项目仓库所在的文件夹路径指向仓库根目录而不是其中某个子目录。点击OK保存。Webots 会提示是否需要重启以应用该设置偏好设置中部分改动需要重启生效见 src/webots/gui/WbPreferencesDialog.cpp。环境变量方式自动化场景除了图形界面Webots 还支持通过环境变量WEBOTS_EXTRA_PROJECT_PATH声明额外项目路径。这在 CI、脚本化启动、Docker 容器等无界面场景下非常实用export WEBOTS_EXTRA_PROJECT_PATH/path/to/community-projects webots两个来源可以同时生效如果Extra project path偏好设置与环境变量同时设置两者都会被考虑其中以偏好设置中填写的路径优先级更高依据 docs/guide/preferences.md 的说明。多路径与分隔符Extra project path支持同时挂载多个独立路径用分隔符隔开类 Unix 系统Linux / macOS使用冒号:分隔例如/home/user/webots/community-projects:/home/user/my-own-protosWindows使用分号;分隔例如D:\webots\community-projects;E:\my-protos。这与源码中的解析逻辑一致Webots 在收集额外项目时会按系统的路径列表分隔符把偏好设置字符串拆分成多个条目见下文源码分析。源码层面的实现原理「Extra project path」并非一个导入操作而是运行时动态收集的只读资源搜索路径。核心实现位于 src/webots/core/WbProject.cpp 的WbProject::extraProjects()方法其逻辑可以概括为读取偏好设置键General/extraProjectPath由 WbPreferencesDialog.cpp 在对话框初始化时载入、并在点击 OK 时写回按QDir::listSeparator()即:或;拆分出若干路径读取环境变量WEBOTS_EXTRA_PROJECT_PATH同样按列表分隔符拆分将两处来源的路径统一放入QSetQString中去重避免重复条目将去重后的每个路径实例化为一个WbProject对象构成额外项目列表。这意味着只要路径指向的是一个符合 Webots 项目目录结构的文件夹Webots 就会像对待WEBOTS_HOME/projects一样去其中查找 PROTO 节点、控制器、世界、纹理等资源。从代码结构可以推断额外项目与默认项目WbProject::defaultProject()、系统项目WbProject::system()一起构成了 Webots 的资源查找体系它们分别对应不同的资源来源层级。此外偏好设置文档docs/guide/preferences.md还明确了额外项目路径的两条关键行为这些路径优先于其他搜索路径当不同来源出现重复的 PROTO 节点时重复项会在Add node添加节点菜单中被自动禁用以避免歧义。第三步在场景中添加社区 PROTO 节点完成路径配置后即可像使用官方模型一样在场景中实例化社区提供的 PROTO 节点。操作步骤在场景树Scene Tree视图中点击Add new object添加新对象按钮或直接按快捷键Ctrl Shift AmacOS 上为 Cmd Shift A。在弹出的添加节点对话框中展开PROTO nodes (Extra Projects)分类。从该分类下列出的节点中选择你要添加的社区 PROTO例如某个社区转换的机器人模型点击确认即可将其插入当前世界。界面背后的实现PROTO nodes (Extra Projects) 这个分类并非硬编码在对话框里的单一选项而是 Webots 的 PROTO 管理器WbProtoManager在枚举所有可用 PROTO 节点时依据其来源动态生成的一个节点组。在仓库源码中可以找到三处一致的实现添加节点对话框 src/webots/scene_tree/WbAddNodeDialog.cppnew QTreeWidgetItem(QStringList(tr(PROTO nodes (Extra Projects))), WbProtoManager::PROTO_EXTRA);插入外部 PROTO 节点对话框 src/webots/scene_tree/WbInsertExternProtoDialog.cpp新建 PROTO 向导 src/webots/gui/WbNewProtoWizard.cpp。三个对话框都使用WbProtoManager::PROTO_EXTRA这个枚举来标记来自额外项目的 PROTO 节点说明 Webots 在加载 PROTO 时已经按来源官方 / 额外项目 / 外部引用等对节点做了分类管理因此社区 PROTO 会被统一收纳在 Extra Projects 分组下展示。为什么 PROTO 能被直接识别社区仓库中的 PROTO 节点之所以能被 Webots 自动识别并出现在该分类下是因为它们遵循 Webots 标准的 PROTO 文件格式详见 PROTO 定义规范PROTO 文件是以.proto结尾的纯文本文件首行必须是版本声明头例如#VRML_SIM 2025 utf8文件体采用PROTO protoName [ protoFields ] { protoBody }结构定义接口字段与内部节点树PROTO 文件必须放在项目目录的protos/子目录中Webots 扫描额外项目路径时即按此约定定位节点。只要社区仓库内的目录组织符合规范挂载后无需任何额外配置节点就会自动出现在添加节点对话框的PROTO nodes (Extra Projects)分组中。社区项目的目录结构要求要让 Webots 正确挂载社区项目仓库仓库根目录需要遵循 Webots 的标准项目文件层次见 项目标准目录结构。Webots 项目根目录下通常包含以下子目录子目录用途worlds/存放世界文件.wbt以及项目文件、纹理通常放在worlds/textures/子目录controllers/存放各世界文件可用的控制器程序每个控制器一个子目录内含源码与 Makefileprotos/存放当前项目所有世界文件可用的 PROTO 文件plugins/存放物理插件、远程控制插件、机器人窗口插件等扩展libraries/存放项目共享库社区项目仓库的顶层目录也正是按robots/、devices/、controllers/、worlds/等功能域划分、再在内部遵循上述子目录约定来组织的。这也是为什么克隆下来的仓库可以整体作为一个额外项目路径挂载——它在结构上等价于一个标准的 Webots 项目集合。反向贡献把你的作品加入 Community Projects社区仓库的价值在于共享与迭代。如果你把某个机器人转换成了 Webots 模型或者编写了有价值的示例世界与控制器欢迎回馈社区。原始文档给出的行动号召非常明确Be awesome and add things to the Community Projects repository——贡献的内容不限于机器人模型示例世界或控制器同样受欢迎。贡献时请留意社区仓库的贡献规范仓库根目录通常包含CONTRIBUTING.md等说明文件并尽量保证模型/世界遵循 标准项目目录结构 组织PROTO 文件符合 PROTO 定义规范包含正确的版本声明头与字段接口附带简要说明如设备型号、作者、使用方式方便他人理解与复用。在提交贡献前推荐先在本地通过本文介绍的 Extra project path 机制完整测试一遍你的模型挂载你的开发目录、新建世界、从PROTO nodes (Extra Projects)中实例化并运行仿真确认一切正常后再提交。常见问题与排障要点添加节点对话框中看不到社区 PROTO检查Tools Preferences General Extra project path填写的路径是否正确指向仓库根目录含protos/子目录的层级若使用环境变量确认其拼写为WEBOTS_EXTRA_PROJECT_PATH且与偏好设置一样使用正确的分隔符最后确认 Webots 已重启使设置生效。PROTO 节点在菜单中被禁用变灰说明该 PROTO 名称与其它来源官方库或其他额外项目重复依据 docs/guide/preferences.md 的规则重复节点会被自动禁用此时应移除重复来源或改名。多个额外项目之间的优先级冲突以偏好设置中填写的路径为准优先级更高环境变量路径作为补充两处来源都会被收集并去重。挂载后不影响现有仿真额外项目是只读资源搜索路径不会修改官方库内容也不影响已打开世界的加载行为你只是为 Webots 增加了额外的可搜索资源来源。小结Community Projects 与「Extra project path」共同构成了 Webots 官方生态之外的资源共享通道前者是内容集合后者是接入机制。通过本文的四个步骤——获取仓库、登记路径、添加节点、回馈贡献——你可以复用社区中成千上万用户积累的模型与仿真资源同时把 Webots 内置的 标准项目目录结构 与 PROTO 定义规范 应用到自己的项目中让每一次建模与分享都具备良好的可移植性与可维护性。赞分享科研自动驾驶物理引擎【免费下载链接】webotsWebots Robot Simulator项目地址https://gitcode.com/gh_mirrors/web/webots点击查看免费下载相关推荐FastStream消息 Community社区生态与贡献指南FastStream消息 Community社区生态与贡献指南 前言为什么选择FastStream 在当今微服务架构盛行的时代消息队列Message后端消息队列微服务gh_mirrors/pr/Projects社区贡献流程详解gh_mirrors/pr/Projects社区贡献流程详解 项目概述 gh_mirrors/pr/Projects是一个收集了大量实用编程项目的开源仓库任何教程cann/asc-devkit Layout层次化表述法Layout和层次化表述法 Layout 我们使用Shape和Stride来表示Layout排布格式例如下图中的行优先和列优先排布。 Shape用于表达Ten人工智能深度学习算子库CANNAscend上一篇rhwp-edit 实战指南用 k-skill-rhwp CLI 对 HWP/HWPX 文档做 round-trip 安全的编辑下一篇cann-recipes-infer 实战GLM-5.2 在 Atlas A3 上的推理优化与共享 Indexer KV Cache Offload 指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Webots 社区项目（Community Projects）接入、使用与贡献实战指南
科研自动驾驶物理引擎【免费下载链接】webotsWebots Robot Simulator项目地址https://gitcode.com/gh_mirrors/web/webots点击查看免费下载本指南围绕 Webots 的 Community Projects 生态展开当你在 官方示例与设备库 中找不到所需机器人模型时如何从社区项目仓库中获取他人已转换好的模型、示例世界与控制器并通过「Extra project path」机制将其无缝接入本机 Webots同时也会深入讲解该机制在源码层面的实现原理src/webots/core/WbProject.cpp以及如何按照社区规范反向贡献自己的成果。读完本文你将掌握从下载、配置到贡献社区项目的完整闭环操作。什么时候需要 Community ProjectsWebots 官方安装包内置了数量庞大的机器人模型、PROTO 节点、示例世界与控制器分布在仓库的 projects/robots 与 projects/objects 目录中并且官方文档已经按示例类型做了系统归纳见 示例 Webots 应用总览。但现实中的机器人型号五花八门官方库不可能覆盖所有型号。Community Projects 正是为此而生它是一个由 Cyberbotics 官方维护、面向全体 Webots 用户开放贡献的共享仓库专门存放官方发行版之外、由社区成员自行建模与分享的各类资源。正如原始文档所强调的如果你正在使用的机器人并未被官方收录进 Webots先到社区项目仓库里找一找——很可能已经有人完成了转换并乐于分享给所有人。根据仓库内发布记录docs/blog/Webots-2020-b-release.md社区仓库是在 Webots R2020b 时代正式推出用于让社区共享 PROTO 节点、控制器、世界等资源并邀请用户提交贡献。仓库内早期讨论如 docs/discord/technical-questions-2020.md也印证了社区仓库的实际用途例如把 Robotiq 夹爪等第三方设备的 PROTO 节点放入仓库供他人直接复用。社区仓库可贡献的内容并不局限于机器人模型也可以是某个真实机器人的 PROTO 节点模型含几何、物理属性、传感器配置完整的示例世界.wbt文件配套的控制器C / C / Python / Java / MATLAB 等纹理、材质等附属资源。第一步获取社区项目仓库接入社区资源的第一步是把社区项目仓库拿到本地。官方推荐的方式是下载压缩包或使用git clone将仓库克隆到一个你方便管理的文件夹中例如~/webots/community-projects。仓库本身遵循 Webots 标准项目目录组织方式因此克隆后不需要任何安装步骤也不要求放在 Webots 安装目录内部——它完全以独立路径的形式挂载到 Webots 中挂载机制见下文源码分析。提示建议使用 Git 克隆而非仅下载快照这样后续可以通过git pull持续同步社区新增的模型与修复也便于你以 Pull Request 方式贡献自己的成果。第二步通过「Extra project path」将社区项目挂载进 Webots获取仓库后需要在 Webots 偏好设置中把仓库路径登记为「额外项目路径Extra project path」。图形界面操作步骤打开 Webots进入菜单Tools Preferences工具 偏好设置。在General通用标签页中找到Extra project path输入框。填入你刚才下载/克隆社区项目仓库所在的文件夹路径指向仓库根目录而不是其中某个子目录。点击OK保存。Webots 会提示是否需要重启以应用该设置偏好设置中部分改动需要重启生效见 src/webots/gui/WbPreferencesDialog.cpp。环境变量方式自动化场景除了图形界面Webots 还支持通过环境变量WEBOTS_EXTRA_PROJECT_PATH声明额外项目路径。这在 CI、脚本化启动、Docker 容器等无界面场景下非常实用export WEBOTS_EXTRA_PROJECT_PATH/path/to/community-projects webots两个来源可以同时生效如果Extra project path偏好设置与环境变量同时设置两者都会被考虑其中以偏好设置中填写的路径优先级更高依据 docs/guide/preferences.md 的说明。多路径与分隔符Extra project path支持同时挂载多个独立路径用分隔符隔开类 Unix 系统Linux / macOS使用冒号:分隔例如/home/user/webots/community-projects:/home/user/my-own-protosWindows使用分号;分隔例如D:\webots\community-projects;E:\my-protos。这与源码中的解析逻辑一致Webots 在收集额外项目时会按系统的路径列表分隔符把偏好设置字符串拆分成多个条目见下文源码分析。源码层面的实现原理「Extra project path」并非一个导入操作而是运行时动态收集的只读资源搜索路径。核心实现位于 src/webots/core/WbProject.cpp 的WbProject::extraProjects()方法其逻辑可以概括为读取偏好设置键General/extraProjectPath由 WbPreferencesDialog.cpp 在对话框初始化时载入、并在点击 OK 时写回按QDir::listSeparator()即:或;拆分出若干路径读取环境变量WEBOTS_EXTRA_PROJECT_PATH同样按列表分隔符拆分将两处来源的路径统一放入QSetQString中去重避免重复条目将去重后的每个路径实例化为一个WbProject对象构成额外项目列表。这意味着只要路径指向的是一个符合 Webots 项目目录结构的文件夹Webots 就会像对待WEBOTS_HOME/projects一样去其中查找 PROTO 节点、控制器、世界、纹理等资源。从代码结构可以推断额外项目与默认项目WbProject::defaultProject()、系统项目WbProject::system()一起构成了 Webots 的资源查找体系它们分别对应不同的资源来源层级。此外偏好设置文档docs/guide/preferences.md还明确了额外项目路径的两条关键行为这些路径优先于其他搜索路径当不同来源出现重复的 PROTO 节点时重复项会在Add node添加节点菜单中被自动禁用以避免歧义。第三步在场景中添加社区 PROTO 节点完成路径配置后即可像使用官方模型一样在场景中实例化社区提供的 PROTO 节点。操作步骤在场景树Scene Tree视图中点击Add new object添加新对象按钮或直接按快捷键Ctrl Shift AmacOS 上为 Cmd Shift A。在弹出的添加节点对话框中展开PROTO nodes (Extra Projects)分类。从该分类下列出的节点中选择你要添加的社区 PROTO例如某个社区转换的机器人模型点击确认即可将其插入当前世界。界面背后的实现PROTO nodes (Extra Projects) 这个分类并非硬编码在对话框里的单一选项而是 Webots 的 PROTO 管理器WbProtoManager在枚举所有可用 PROTO 节点时依据其来源动态生成的一个节点组。在仓库源码中可以找到三处一致的实现添加节点对话框 src/webots/scene_tree/WbAddNodeDialog.cppnew QTreeWidgetItem(QStringList(tr(PROTO nodes (Extra Projects))), WbProtoManager::PROTO_EXTRA);插入外部 PROTO 节点对话框 src/webots/scene_tree/WbInsertExternProtoDialog.cpp新建 PROTO 向导 src/webots/gui/WbNewProtoWizard.cpp。三个对话框都使用WbProtoManager::PROTO_EXTRA这个枚举来标记来自额外项目的 PROTO 节点说明 Webots 在加载 PROTO 时已经按来源官方 / 额外项目 / 外部引用等对节点做了分类管理因此社区 PROTO 会被统一收纳在 Extra Projects 分组下展示。为什么 PROTO 能被直接识别社区仓库中的 PROTO 节点之所以能被 Webots 自动识别并出现在该分类下是因为它们遵循 Webots 标准的 PROTO 文件格式详见 PROTO 定义规范PROTO 文件是以.proto结尾的纯文本文件首行必须是版本声明头例如#VRML_SIM 2025 utf8文件体采用PROTO protoName [ protoFields ] { protoBody }结构定义接口字段与内部节点树PROTO 文件必须放在项目目录的protos/子目录中Webots 扫描额外项目路径时即按此约定定位节点。只要社区仓库内的目录组织符合规范挂载后无需任何额外配置节点就会自动出现在添加节点对话框的PROTO nodes (Extra Projects)分组中。社区项目的目录结构要求要让 Webots 正确挂载社区项目仓库仓库根目录需要遵循 Webots 的标准项目文件层次见 项目标准目录结构。Webots 项目根目录下通常包含以下子目录子目录用途worlds/存放世界文件.wbt以及项目文件、纹理通常放在worlds/textures/子目录controllers/存放各世界文件可用的控制器程序每个控制器一个子目录内含源码与 Makefileprotos/存放当前项目所有世界文件可用的 PROTO 文件plugins/存放物理插件、远程控制插件、机器人窗口插件等扩展libraries/存放项目共享库社区项目仓库的顶层目录也正是按robots/、devices/、controllers/、worlds/等功能域划分、再在内部遵循上述子目录约定来组织的。这也是为什么克隆下来的仓库可以整体作为一个额外项目路径挂载——它在结构上等价于一个标准的 Webots 项目集合。反向贡献把你的作品加入 Community Projects社区仓库的价值在于共享与迭代。如果你把某个机器人转换成了 Webots 模型或者编写了有价值的示例世界与控制器欢迎回馈社区。原始文档给出的行动号召非常明确Be awesome and add things to the Community Projects repository——贡献的内容不限于机器人模型示例世界或控制器同样受欢迎。贡献时请留意社区仓库的贡献规范仓库根目录通常包含CONTRIBUTING.md等说明文件并尽量保证模型/世界遵循 标准项目目录结构 组织PROTO 文件符合 PROTO 定义规范包含正确的版本声明头与字段接口附带简要说明如设备型号、作者、使用方式方便他人理解与复用。在提交贡献前推荐先在本地通过本文介绍的 Extra project path 机制完整测试一遍你的模型挂载你的开发目录、新建世界、从PROTO nodes (Extra Projects)中实例化并运行仿真确认一切正常后再提交。常见问题与排障要点添加节点对话框中看不到社区 PROTO检查Tools Preferences General Extra project path填写的路径是否正确指向仓库根目录含protos/子目录的层级若使用环境变量确认其拼写为WEBOTS_EXTRA_PROJECT_PATH且与偏好设置一样使用正确的分隔符最后确认 Webots 已重启使设置生效。PROTO 节点在菜单中被禁用变灰说明该 PROTO 名称与其它来源官方库或其他额外项目重复依据 docs/guide/preferences.md 的规则重复节点会被自动禁用此时应移除重复来源或改名。多个额外项目之间的优先级冲突以偏好设置中填写的路径为准优先级更高环境变量路径作为补充两处来源都会被收集并去重。挂载后不影响现有仿真额外项目是只读资源搜索路径不会修改官方库内容也不影响已打开世界的加载行为你只是为 Webots 增加了额外的可搜索资源来源。小结Community Projects 与「Extra project path」共同构成了 Webots 官方生态之外的资源共享通道前者是内容集合后者是接入机制。通过本文的四个步骤——获取仓库、登记路径、添加节点、回馈贡献——你可以复用社区中成千上万用户积累的模型与仿真资源同时把 Webots 内置的 标准项目目录结构 与 PROTO 定义规范 应用到自己的项目中让每一次建模与分享都具备良好的可移植性与可维护性。赞分享科研自动驾驶物理引擎【免费下载链接】webotsWebots Robot Simulator项目地址https://gitcode.com/gh_mirrors/web/webots点击查看免费下载相关推荐FastStream消息 Community社区生态与贡献指南FastStream消息 Community社区生态与贡献指南 前言为什么选择FastStream 在当今微服务架构盛行的时代消息队列Message后端消息队列微服务gh_mirrors/pr/Projects社区贡献流程详解gh_mirrors/pr/Projects社区贡献流程详解 项目概述 gh_mirrors/pr/Projects是一个收集了大量实用编程项目的开源仓库任何教程cann/asc-devkit Layout层次化表述法Layout和层次化表述法 Layout 我们使用Shape和Stride来表示Layout排布格式例如下图中的行优先和列优先排布。 Shape用于表达Ten人工智能深度学习算子库CANNAscend上一篇rhwp-edit 实战指南用 k-skill-rhwp CLI 对 HWP/HWPX 文档做 round-trip 安全的编辑下一篇cann-recipes-infer 实战GLM-5.2 在 Atlas A3 上的推理优化与共享 Indexer KV Cache Offload 指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考