用途:面向西门子 Modular Application Creator(MAC)模块的源码级开发与审查,基于 Module Builder 框架,而非直接使用 TIA Portal Openness。审计基线为 MAC V21.0.5、TIA Portal V21、.NET Framework 4.8,仅作为已知兼容基线,不代表最新版本。
主要能力:覆盖模块生命周期编排、模型/用例代码、生成资源封装、UI 与帮助资源、包构建及合格性证据。参考文件按需加载:architecture-and-lifecycle.md(TiaEquipmentModule、阶段顺序、模型/用例结构、生成与自定义归属)、project-and-dependencies.md(项目创建、V21 引用、NuGet 依赖、版本迁移、构建诊断)、resources-packaging-and-trust.md(.tiares、生成库封装、XAML/帮助本地化、.nuspec、.nupkg、许可与包来源)、testing-and-qualification.md(MacFunctionTest、MacGenerationTest、测试设计、生成合格性、证据声明)。
使用方式:先确立权威依据,定位目标解决方案/项目、MAC 与 Module Builder 版本、TIA Portal 主版本、目标框架、包源及证明文件,不得从邻近示例推断兼容性;再分类任务(生命周期/模型代码、生成资源集成、打包、静态审查或授权生成);编辑前映射归属,区分生成文件与自定义扩展点,禁止手改生成输出以通过构建;仅加载匹配任务的参考条目;做最小源码改动,保留阶段边界、命名、资源、包元数据与既有扩展模式;分层验证,先跑项目/静态测试,仅在环境与授权明确时运行 Module Builder 或 TIA 生成,并分别报告静态、生成与实机证据。
生成归属门:除非目标项目另有证明,Base*GeneratedItems.cs、TiaImports/ResourceManagement.cs、TiaImports/GeneratedClasses 及其子项视为生成文件;典型自定义扩展点包括具体模块入口类、Model/UseCases、UI/视图模型代码、TiaImports/CustomLibraryClasses,编辑前须确认本地项目约定。若生成文件有误,应修复其来源(.tiares、模型/资源定义、模板输入或受支持的 partial/自定义扩展),用匹配工具链重新生成并审查差异。
限制:源码编辑、打包与静态测试不授权打开、修改、生成、保存或关闭 TIA Portal 项目;任何打开或改动 TIA 项目的 Module Builder 操作需明确实机授权、确切项目与模块/目标标识、预期保存/关闭行为及恢复计划。包还原或执行需经批准的来源与出处。本地西门子二进制与示例仅为证据,不构成再分发专有包或客户生成物的许可。静态检查、编译与模拟测试不能证明实机 TIA 行为,生成运行也不证明调试或硬件行为。不得臆造 .tiares 键、包 ID、生命周期签名、资源标识或测试运行器开关,须从目标版本项目、已安装负载或权威文档推导。若任务涉及直接 Siemens.Engineering 对象访问,应同时加载 tia-csharp-common 及由 tia-openness-roadmap 路由的相应领域技能。