Elementor Site Initialize
初始化自定义 Elementor Widget 的本地开发基础。默认 Elementor 已安装;插件源代码可以放在用户确认的任意本地路径,正式使用时再把完整插件目录放入 WordPress wp-content/plugins/。
执行
- 把当前目录视为项目工作区,不向上寻找 WordPress 根目录。主题上下文只用于插件命名和技术集成事实;不尝试从本地主题文件推断 Elementor Site Settings 或视觉冲突。
- 读取 初始化契约,推导插件命名、目标路径、预计 Widget 规模、
Flat / Grouped结构、Site Mode 与 Style Authority。 - 在写文件前展示一张确认卡。用户必须确认本地路径、结构 Profile、Site Mode 和 Style Authority;Grouped 还必须确认业务分组。用户可修改任意值。
- 确认后创建项目配置、设计交接目录和所选插件骨架;只有主题技术上下文确有复用价值时才创建只读摘要。
- 目标插件或配置已存在时先检查并保留,不覆盖、不重建,也不借初始化迁移 Flat/Grouped 结构。
- 核对 PHP、JSON、目录和配置一致性,返回创建清单、结构决策和可选主题技术摘要;然后返回调用它的总控或原始任务,根据原始目标继续。
默认产物
elementor-project.jsondocs/elementor/theme-profile.md(仅存在主题证据时)docs/design-system/设计稿/modules/与设计稿/pages/- 用户确认路径下可被
elementor-widget-pipeline扩展的 Flat 或 Grouped 插件骨架,包含项目专属 Elementor 分类与编辑器角标资产
空目录只需在本地创建,不添加装饰性占位文档。Design System 未建立时只标记 pending,不要替用户设计。
边界
- 不扫描 WordPress 根目录,不检查或安装 Elementor。
- 不初始化 CSS/JS 构建工具,默认原生 PHP、CSS、JS。
- 可选主题读取始终只读,只服务于命名和技术集成;不扫描或预判视觉冲突,不修改
functions.php、主题资源或线上wp-content/plugins/。 - 不创建 Design System、HTML 设计稿或具体 Widget。
- 不生成 Elementor Style Contract;初始化只在项目配置中记录
siteStyle.status: pending,正式映射交给elementor-site-style-adapter。 - 不自动把现有 Flat 插件迁移为 Grouped,也不根据后续文件数量偷偷换结构。
- 不固定推荐 Design System。完成后返回
elementor-site-team-manager或原始任务:已有确认版设计稿与 Confirmed Style Contract 时可直接进入elementor-widget-pipeline;需要视觉规则时进入website-design-system-architect;已有 Design System 但缺 Elementor 映射时进入elementor-site-style-adapter;其他情况由现有依赖决定。