SuperAPI AI 工具集

roadrunner-core

办公与效率

查看项目

更新于 10-16 00:21

技能介绍

用途:RoadRunner Core 是所有 RoadRunner 智能体工作流的基础技能,负责从 MATLAB 建立并管理 RoadRunner 连接,处理项目、场景(scene)与场景方案(scenario)的创建、打开、保存和关闭,设置世界原点与场景范围,检查状态,并生成供下游技能使用的 rrApp 句柄。

主要能力:通过 rrCoreInitialize 完成首次配置(两级解析:设置有效且 roadrunner 类在路径上则跳过;否则用 installFolder 与 projectPath 以编程方式配置,无 GUI 对话框)。支持连接已有实例或启动新实例,创建/打开/保存项目、场景、场景方案,列出可用场景与场景方案,设置 WorldOrigin、SceneCenter、SceneExtents,清除世界投影,查询状态,安全关闭 RoadRunner。

使用方式:所有 MATLAB 代码通过 evaluate_matlab_code MCP 工具执行,禁止使用 matlab -batch。首次调用需先 addpath("<absolute-path-to-this-skill>/scripts"),再运行 rrCoreInitialize;若报 PathsRequired,向用户询问 installFolder 与 projectPath 后重试。后续调用先检查 exist('rrApp','var'),再按 rrCoreCommands.m 中对应 %% 段落复制模式并替换占位符执行,不要凭记忆猜测 API。

适用场景:需要从 MATLAB 连接或启动 RoadRunner、管理项目/场景/场景方案、设置世界设置、检查状态或安全关闭,以及任何下游 RoadRunner 技能需要 rrApp 初始化时。

限制:需已安装 RoadRunner,本技能无法安装该产品;MATLAB 需 R2022a 及以上,changeWorldSettings 需 R2023b 及以上。路径不支持 Unicode。close(rrApp) 会终止 RoadRunner 进程,之后 connect 会失败;重新启动后场景不会自动恢复,需显式重新打开。保存前必须询问用户,不得自动保存。启动需用户明确许可,每个会话只保留一个 rrApp。未提供的信息暂未说明。