用途:在 MathWorks 示例数据库中检索随产品发布的示例模型,帮助定位演示某概念、模块或应用领域的官方示例,并给出打开命令。
主要能力:通过随技能提供的 invokeModelFinder 辅助脚本搜索覆盖所有产品的示例数据库。该搜索针对数据库而非本地磁盘,命中表示示例存在于 MathWorks 数据库并附带打开命令,与本地是否已打开或保存无关。打开命中项需安装所属产品,返回的 open_command(如 openExample(...))会处理这一点。
使用方式:因面向用户的 modelfinder 函数是交互式的(在终端弹出 Selection: 菜单并阻塞),无法编程驱动,故使用非交互包装脚本 invokeModelFinder,通过 evaluate_matlab_code 调用,并将 project_path 设为技能的 scripts/ 文件夹以便 MATLAB 解析函数(不要使用 addpath):invokeModelFinder('<query>', '<filters_json>', '<max_results>', '<view>')。query 为自由文本,如 'motor control'、'PID'、'battery','*' 列出全部;filters_json 为可选过滤的 JSON 对象,字段有 match、product、location、block、reference,无过滤用 '{}';max_results 为返回上限字符串,默认 '20',上限 100;view 为结果布局,'Categorized'(默认)按示例分组并给出示例级 openExample(...) 命令,'Models' 逐个列出底层模型文件。返回 YAML 字符串,含每个匹配项的 name、open_command 和 description。
适用场景:用户要求查找、展示或打开随产品发布的示例模型;需要指向演示某概念或领域的示例;在进一步操作前需确认哪个官方示例匹配描述。
限制:仅搜索随 MathWorks 发布的示例,不搜索用户自己的项目模型,不查找、列出或打开用户工作目录或已打开项目中的模型。搜索行为视为黑盒,不要假设其排序或词项组合方式。结果过多或偏离时应收窄查询或加过滤;无结果时放宽条件。R2025a 之前版本会忽略 filters 与 view,退化为普通关键词搜索,但仍需传入全部四个参数。所有匹配项视为只读,可查看但不得编辑、删除或 save_system 到官方示例;如需修改应先另存为新文件名再操作。