SuperAPI AI 工具集

simscape-write-ssc

写作与研究

查看项目

更新于 10-16 09:31

技能介绍

用途:编写或编辑 .ssc(Simscape Language)源文件,包括新建组件、域、函数,为已有 .ssc 文件增改物理、方程或参数化,把控制方程转换为可工作的 Simscape 组件,添加模式图、事件或切换逻辑,构建连接子组件的复合组件,以及修复语法与验证错误。

主要能力:按设计流程组织组件结构,涵盖 nodes、inputs、outputs;parameters 与 variables 的声明、可见性(Access、ExternalAccess);单位声明(Simscape 在编译期校验量纲并自动换算);编译期与运行期条件分支;equations、intermediates、components/connections、for、modecharts、events、annotations 等段落的取舍。参考文件按 composition、equations-and-variables、foundation、language-functions、modecharts-and-events、parameters-and-conditionals、ports-and-nodes、presentation 分类,可按需查阅。

使用方式:写完 .ssc 后用 simscape.agentic.sscIssues 校验,参数为组件的完全限定名(点分命名空间,而非文件路径),例如 simscape.agentic.sscIssues("mylib.components.MyComponent")。运行时可借助 evaluate_matlab_code,并将 project_path 设为该技能 scripts/ 目录,以便 MATLAB 找到包。显示 “No issues found.” 或逐条诊断,需修复至无问题。

不适用场景:在 Simulink 模型中配置或连接已有 Simscape 模块应改用 building-simulink-models;仿真或查看结果改用 simulating-simulink-models;仅从 MATLAB 或脚本设置模块参数而不编辑 .ssc 源码也不属于此技能。

限制:设置 project_path 会改变当前文件夹,可能使工作文件夹及组件引用的文件脱离路径,出现 “not found on the MATLAB search path” 或 Validation failed 指向缺失引用文件时,应先把必要文件夹加入路径再判断诊断是否为真实问题。名称不在路径上或未解析到 .ssc/.sscp 文件时函数会报错。setup 段已弃用,改用 equations 中的 assert。未提供的细节暂未说明。