agenticToolkitInstaller.mltbx 和simulink-agentic-toolkit.mltbx 区别是什么

作者
45 次阅读

本文最后更新于 2026年8月21日。

agenticToolkitInstaller.mltbx vs simulink‑agentic‑toolkit.mltbx

来源：matlab/simulink‑agentic‑toolkit GitHub releases 发布包

文件 角色 内部内容 使用方式
agenticToolkitInstaller (1).mltbx 安装器工具箱（Installer），官方推荐入口 只包含安装脚本函数：setupAgenticToolkit()，不包含实际Simulink Agentic Toolkit业务代码、MCP Server、skills 双击安装这个mltbx；之后在MATLAB执行 setupAgenticToolkit("install")；脚本会联网自动下载完整的simulink‑agentic‑toolkit全套文件到 ~/.matlab/agentic‑toolkits/ 目录，同时部署MCP‑Server、配置AI Agent（Claude Code等）
simulink‑agentic‑toolkit.mltbx 实际功能工具箱包（完整包） 包含satk_initialize、Simulink MCP工具、MBD技能库、校验脚本等全部Simulink‑Agentic业务代码 一般不手动双击安装；由上面installer脚本自动下载部署；也可以手动解压/克隆源码，addpath + satk_initialize 初始化使用

关键区别总结

  1. agenticToolkitInstaller.mltbx = 引导器
    它只是一个很小的“安装向导”，本身不带AI‑Agent操作Simulink的能力。安装完这个工具箱后，必须运行setupAgenticToolkit("install")，才会拉取真正的工具包本体、MCP服务二进制、skill配置文件到本地磁盘。
    支持同时安装 MATLAB Agentic Toolkit + Simulink Agentic Toolkit 两套，也可只选其中一套，支持全局/项目级agent配置，支持update更新、uninstall卸载。

  2. simulink‑agentic‑toolkit.mltbx = 真正干活的本体
    里面才是给AI Agent调用的全部MCP工具（model_read/model_edit/model_check等）、MBD最佳实践skills、校验函数satk_initialize。

    注意：releases页面资产列表里，这个mltbx是被installer脚本自动下载到用户家目录下，不是让你手动双击安装的。如果你直接双击安装这个mltbx，缺少MCP‑Server二进制、agent配置，大概率跑不通。

标准正确流程（官方）

%1. 安装安装器
matlab.addons.toolbox.installToolbox("agenticToolkitInstaller (1).mltbx")
%2. 执行安装，联网下载完整simulink‑agentic‑toolkit本体、MCP‑Server、配置agent
setupAgenticToolkit("install")

% 每次打开MATLAB使用前初始化
addpath("~/.matlab/agentic-toolkits/simulink")
satk_initialize

常见坑

  • 只双击simulink‑agentic‑toolkit.mltbx，跳过installer：缺少MCP服务二进制、agent配置，调用AI Agent会报错连接失败。
  • 安装完installer之后忘记运行setupAgenticToolkit("install")：MATLAB附加功能管理器看到installer已安装，但实际没有任何agent能力。
  • 更新版本：重新下载新版agenticToolkitInstaller.mltbx安装，运行setupAgenticToolkit("update")即可升级本体工具包，不需要手动替换simulink‑agentic‑toolkit.mltbx。

Windows路径对应：%USERPROFILE%\.matlab\agentic‑toolkits\simulink