Elementor Site Style Adapter
把已确认的 Design System 转译为 Elementor 平台实施契约。只生成本地 docs/elementor/elementor-style-contract.md,不连接或修改 WordPress。
输入门禁
必须确认:
docs/design-system/design-system.md为当前 Active Baseline;设计稿/design-system/style-board.html已由用户确认;- Site Mode 为
greenfield、rebuild或existing-extension; - Style Authority 为
project-design-system或existing-site。
existing-extension 且用户要求保持现站风格时,还必须具备:
- 网站 URL 与真实渲染审计;
- Elementor Site Settings 截图、可信 Kit 导出或等价后台证据。
URL 只能证明最终视觉,不能证明后台 Global Token。缺少后台证据时可以整理 Observed Only 合同,但不得进入精确继承确认门禁。
执行
- 读取 Style Contract,确定模式、证据状态和样式权威。
- 建立 Elementor Site Settings Mapping,确认 Global Colors、Global Fonts、Theme Style 与 Layout 的角色和值。
- 映射 Typography、Buttons、Form Fields 与 Layout;只映射 Design System 已确认的规则。
- 定义 Widget 的继承、fallback、局部覆盖和禁止修改规则。Motion 不映射为 Elementor Global Style;只记录它继续由确认 HTML、UI Motion Intent 与 Widget 交互合同负责。
- 在对话中展示 Mapping Proposed 摘要,等待用户确认;确认前不写成
Confirmed。 - 生成或更新
docs/elementor/elementor-style-contract.md,并同步elementor-project.json.siteStyle状态;合同的Pending Evidence / Mapping Proposed对应项目pending,Observed Only对应observed,Confirmed对应confirmed。目标文件已有人工内容时保留并做最小更新。 - 完成合同一致性检查,返回总控或原始任务。
状态
Pending Evidence:缺少 Active Baseline、Board、URL 或必要证据。Observed Only:已观察最终渲染,但无法确认 Elementor Token 或覆盖来源。Mapping Proposed:证据足够,已提出平台映射,等待用户确认。Confirmed:用户明确确认当前映射,可交给 Widget Pipeline。
模式规则
Greenfield / Rebuild
- Style Authority 固定为
project-design-system。 - 项目 Design System 决定 Elementor Site Settings;Elementor Site Settings 是 Widget 的平台执行层。
- GeneratePress、子主题或其他主题只作技术底座,不进行默认视觉冲突扫描,也不因主题文件存在改变 Style Authority。
- 仅当真实页面出现与已确认 Site Settings 不一致的可观察异常时,才把主题 CSS、页面 Custom CSS 或其他覆盖层记录为专项诊断线索;该诊断不阻塞正常映射。
rebuild不继承旧站历史视觉,除非用户明确把某条旧规则加入新 Design System。
Existing Extension
- Style Authority 默认
existing-site。 - Elementor Site Settings、可信 Kit 或等价后台证据用于确认可绑定的 Global Token;最终渲染用于验证这些设置是否真实生效。
- 不默认扫描主题或子主题。只有后台设置与真实渲染出现明确偏差时,才按需检查页面局部设置、Custom CSS 或用户提供的主题代码。
- 不借新增模块批量清理、规范化或覆盖老站 Site Settings。
- 渲染结果与后台设置不一致时,记录实际生效值、已知证据与待诊断项;无法访问相关代码时不得声称已定位来源。
边界
- 不创建或修改 Design System、Design Board、页面设计或 HTML。
- 不实现 Widget,不决定业务字段。
- 不调用 REST API、MCP、WP-CLI,不上传 Kit,不写线上 Site Settings。
- 不把手动设置完成等同于已验证;只记录用户提供的确认与证据。
需要验证路由与合同状态时,读取 工作流用例。