elementor-site-initialize · diff
git:20260905.7f6ea1e to git:20260908.7224954
10 added, 9 removed. Audit A to A.
---
name: elementor-site-initialize
- description: Initialize a local custom Elementor Widget plugin and design handoff workspace, choosing a Flat or Grouped plugin structure from expected Widget scale. Use once before the first custom Widget when no plugin scaffold exists; theme context is optional and read-only. Do not use for visual design, Widget implementation, deployment, WordPress-root discovery, or Elementor installation checks.
+ description: Initialize a local custom Elementor Widget plugin, design handoff workspace, and pending site-style context, choosing a Flat or Grouped plugin structure from expected Widget scale. Use once before the first custom Widget when no plugin scaffold exists; theme context is optional and read-only. Do not map Elementor Site Settings, design visuals, implement Widgets, deploy, or inspect a live WordPress installation.
---
# Elementor Site Initialize
初始化自定义 Elementor Widget 的本地开发基础。默认 Elementor 已安装；插件源代码可以放在用户确认的任意本地路径，正式使用时再把完整插件目录放入 WordPress `wp-content/plugins/`。
## 执行
- 1. 把当前目录视为项目工作区，不向上寻找 WordPress 根目录。当前目录有主题 `style.css`，或用户明确提供主题目录时，才只读扫描主题；没有主题也可以继续初始化。
- 2. 读取 [初始化契约](references/initialization-contract.md)，推导插件命名、目标路径、预计 Widget 规模和 `Flat / Grouped` 结构。
- 3. 在写文件前展示一张确认卡。用户必须确认本地路径、结构 Profile；Grouped 还必须确认业务分组。用户可修改任意值。
- 4. 确认后创建项目配置、设计交接目录和所选插件骨架；只有发现主题上下文时才创建主题扫描摘要。
+ 1. 把当前目录视为项目工作区，不向上寻找 WordPress 根目录。主题上下文只用于插件命名和技术集成事实；不尝试从本地主题文件推断 Elementor Site Settings 或视觉冲突。
+ 2. 读取 [初始化契约](references/initialization-contract.md)，推导插件命名、目标路径、预计 Widget 规模、`Flat / Grouped` 结构、Site Mode 与 Style Authority。
+ 3. 在写文件前展示一张确认卡。用户必须确认本地路径、结构 Profile、Site Mode 和 Style Authority；Grouped 还必须确认业务分组。用户可修改任意值。
+ 4. 确认后创建项目配置、设计交接目录和所选插件骨架；只有主题技术上下文确有复用价值时才创建只读摘要。
5. 目标插件或配置已存在时先检查并保留，不覆盖、不重建，也不借初始化迁移 Flat/Grouped 结构。
- 6. 核对 PHP、JSON、目录和配置一致性，返回创建清单、结构决策和可选主题扫描结论；然后返回调用它的总控或原始任务，根据原始目标继续。
+ 6. 核对 PHP、JSON、目录和配置一致性，返回创建清单、结构决策和可选主题技术摘要；然后返回调用它的总控或原始任务，根据原始目标继续。
## 默认产物
- `elementor-project.json`
- `docs/elementor/theme-profile.md`（仅存在主题证据时）
- `docs/design-system/`
- `设计稿/modules/` 与 `设计稿/pages/`
- - 用户确认路径下可被 `elementor-widget-pipeline` 扩展的 Flat 或 Grouped 插件骨架
+ - 用户确认路径下可被 `elementor-widget-pipeline` 扩展的 Flat 或 Grouped 插件骨架，包含项目专属 Elementor 分类与编辑器角标资产
空目录只需在本地创建，不添加装饰性占位文档。Design System 未建立时只标记 `pending`，不要替用户设计。
## 边界
- 不扫描 WordPress 根目录，不检查或安装 Elementor。
- 不初始化 CSS/JS 构建工具，默认原生 PHP、CSS、JS。
- - 主题扫描始终只读；不修改 `functions.php`、主题资源或线上 `wp-content/plugins/`。
+ - 可选主题读取始终只读，只服务于命名和技术集成；不扫描或预判视觉冲突，不修改 `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` 或原始任务：已有确认版设计稿时可直接进入 `elementor-widget-pipeline`；需要视觉规则时进入 `website-design-system-architect`；其他情况由现有依赖决定。
+ - 不固定推荐 Design System。完成后返回 `elementor-site-team-manager` 或原始任务：已有确认版设计稿与 Confirmed Style Contract 时可直接进入 `elementor-widget-pipeline`；需要视觉规则时进入 `website-design-system-architect`；已有 Design System 但缺 Elementor 映射时进入 `elementor-site-style-adapter`；其他情况由现有依赖决定。