SuperAPI AI 工具集

matlab-discover-hardware

编程与开发

查看项目

更新于 10-16 02:28

技能介绍

用途:这是 MATLAB Agentic Toolkit 中的硬件发现技能,用于以自然语言完成硬件发现任务,包括列出已连接设备、按能力搜索、查看指定设备的详情与能力,以及检查所需支持包或附加组件是否安装。

主要能力:提供 4 个公开辅助函数(位于 scripts/ 目录):listHardwareDevices 列出设备(默认仅已连接);getDeviceDetails 返回指定设备的完整信息(能力、支持包、技术细节);getDeviceSetupInfo 返回所需包及安装状态;isRequiredAddOnsInstalled 返回所需附加组件是否已全部安装的逻辑值。辅助函数内部共享 60 秒 TTL 缓存。

使用方式:激活前自动执行一次性路径引导,将捆绑的 scripts/ 文件夹加入 MATLAB 路径:addpath(fullfile("<skill-root>", "scripts"))。之后不得再调用 addpath、rmpath 或 cd,不得 clear all,不得新建 .m 文件。仅使用上述公开辅助函数,不得直接调用内部函数或自行复现辅助逻辑(hardwareDeviceCache.m、getDeviceAddOns.m、getAddOnDetails.m 不可直接调用)。建议将多个调用合并到最少的 evaluate_matlab_code 调用中以减少往返,例如先 listHardwareDevices() 确认设备,再在同一批次中调用 getDeviceDetails 与 isRequiredAddOnsInstalled。仅当用户明确要求刷新(“重新扫描”“刷新”)时才传 Refresh=true。

适用场景:查询已连接或可用硬件、按能力查找设备(如“哪些设备支持 CAN”)、了解某设备详情、查询某设备需要安装哪些包、判断附加组件是否安装。

限制:不适用于非硬件 MATLAB 工作、数据采集与流传输、设备配置或编程,以及无硬件上下文的全部产品与支持包列表。发现后若用户要继续使用设备,需转向对应的设备专用技能;若无匹配技能,只能提供发现级输出,不得编写设备专用代码、连接示例或排障脚本。不得凭训练数据推断能力或安装状态,也不得猜测缺失包。能力搜索无结果时应列出全部已连接设备并请用户确认。同名多设备需先以纯文本编号列表请用户消歧,不得调用阻塞式 input()。面向用户时使用 FriendlyName 标识设备,不暴露插件名称、内部检测机制或原始基础代码;列表类回答中不要提及支持包。若辅助函数报 Undefined function,可重跑一次引导,仍失败则报告错误,不得自创变通方案。安装支持包需依赖具备安装能力的技能,否则提示用户在 MATLAB 附加功能资源管理器中搜索。