用途:在 Shopware 6 的 Administration 与 Storefront UI 开发中,先核实已安装源码,再编写使用组件的标记。核心原则是:任何 slot、prop、枚举值、token、图标名、snippet key 或 CSS 假设,都必须在已安装源码中读到过,并能给出 file:line;不依赖训练记忆、相邻组件推断或在线文档(其描述的补丁版本可能与实际运行版本不同)。
主要能力与用法: 1)用 node scripts/contracts.mjs 建立磁盘上的组件契约索引,支持 --risk、--component mt-card、--rank --uncovered 等参数,读取已安装组件的 slots、props、必填项、默认值、带样式枚举、局部自定义属性、scoped styles、wrapper 与注册信息,输出到 .contracts/index.json。该脚本无依赖、无需模型与网络。 2)按 component-contracts.md、silent-failures.md、measuring.md、form-fields.md、version-deltas.md、contract-tests.md 等参考文件核查契约、静默缺陷、运行时测量、表单绑定与版本差异。 3)区分 6.7 中并存的 sw-* 旧组件集与 Meteor mt-* 组件集,注意其 v-model 绑定差异、变体命名与 DOM 类差异;检查组件是否真的被 Administration 注册,以及拿到的是否为 Shopware wrapper。 4)在登录后的 Administration 中测量结果,并锁定为契约测试。
适用场景:Shopware 6 插件或主题的界面开发、组件问题排查、升级(尤其 6.6 到 6.7)后界面异常诊断。
限制:不涉及插件架构(DAL、DI、subscribers、migrations、Store API)等,仅在与 UI 相关时提及迁移;也不决定产品设计。缺少登录会话时应标记布局判断为未验证,不要索取或输入凭据。定价、平台支持范围等资料暂未提供。