weaver-work-cli 0.1.24 → 0.1.26

package/skills/weaver-e10-builder/actionflows/references/function_rules.md

@@ -0,0 +1,15 @@
+# 标准函数规则
+
+`custom`（自定义 JS）和 `code`（编码函数）不支持跨环境生成。其余标准函数内置名称、类别和参数约束。
+
+需要计算、转换或拼接时，函数树可用于组件明确支持的公式属性：e-builder 的 `formula` 字段、流程/文档的 `formula_or_reference` 字段，以及 `ApproveCreate.requestName`。写法统一为：
+
+```json
+{"kind":"function","name":"CONCAT","args":[{"kind":"fixed","value":"项目-"},{"kind":"context","paramKey":"<真实字段paramKey>","label":"项目名称"}]}
+```
+
+函数参数可为 `fixed`、`context`、`variable`、`constant`、`system_variable` 或嵌套 `function`。其中 `variable`/`constant` 必须先按 `references/dynamic_resources.md` 解析为当前租户的真实资源 ID；不能把名称或默认值当作引用。
+
+生成时仅对实际使用的函数调用当前租户接口，校验可用性并获取当次函数 ID。
+
+消息标题/内容、循环和条件各有专用 DTO；只有对应组件说明明确支持函数树时才使用，不能因为它们也显示“动态赋值”就套用通用函数结构。

package/skills/weaver-e10-builder/actionflows/references/trigger_runtime_notes.md

@@ -0,0 +1,53 @@
+# 触发器运行时注意事项（真机验证）
+
+本文沉淀验收 1（11 场景）真机验证得到的、与平台接口客观行为相关的经验，宿主 agent 生成 `semantic_plan` 时必须遵守。这些事实与实现语言无关（Python/Node 版同源）。
+
+## 1. 「数据ID」paramKey 格式因触发器而异（最关键）
+
+「按数据ID更新/引用当前数据」场景中，数据ID 字段的 paramKey **不是统一的 `{formId}.id`**，三种触发器各不相同：
+
+| 触发器 | 数据ID 的 paramKey | 说明 |
+|---|---|---|
+| `TimeBatchTrigger` | `{formId}.id` | 例：`1300502645411717121.id` |
+| `DateTrigger` | `dataResponse.id` | 前缀是 `dataResponse.`，不是表单 id |
+| `EventFormData` | `{formId}.5` | **数据ID 是数字 `5`，不是 `.id`！** 极易踩坑 |
+
+生成 plan 时，`mapping` 源侧引用「数据ID」必须按上表写真实 paramKey，否则 preflight 的源字段校验会报「源字段 paramKey 未在真实上下文中找到」。
+
+> 最稳妥的做法：先跑 `workflow-context-fields` 查该触发器在当前数据源下的真实上下文，从返回里确认「数据ID」的精确 paramKey，再写入 plan，不要凭记忆猜格式。
+
+## 2. queryFields 需包含系统字段
+
+定时/批量/日期触发器的 `queryFields` 全选时，除了业务字段，还必须包含**平台系统字段**（数据ID / 标题 / 创建者 / 创建时间 等 9 个）。否则 `getComponentContext` 返回的上下文中**缺少「数据ID」**，导致「按数据ID更新」引用失败。
+
+系统字段的 `id` 是英文字符串（`id`/`name`/`creator`/`createTime`/`lastUpdateTime`/`lastUpdater`/`dataStatus`/`myTag`/`publicTag`），`content` 是中文名。宿主 agent 侧无需手动列全，但需知晓：**数据ID 属于系统字段，不随业务字段自动出现**。
+
+## 3. 动态人员引用用 `context`，不要用 `{userid}`
+
+触发器/新建流程等节点的 `operator`（操作人）需要动态引用某字段值时，用**上下文引用**而非系统变量：
+
+```json
+{"type": "context", "paramKey": "<formId>.<人员字段id>", "label": "<字段名>"}
+```
+
+`{userid}` 这类系统变量在 `resolveFixedPeople` 阶段会被当作「固定人员」去查浏览器解析，失败即拦截报错。动态人员一律走 context 引用。
+
+## 4. filterCondition 的 `esbAssign.wId` 必须指向「当前节点」（真机验证 2026-08-18）
+
+`ActionEbUpdate` 等数据动作的筛选条件（filterCondition）右值走上下文引用时，条件对象里的 `esbAssign.wId` 字段**必须指向「当前节点」**（filterInput 所属的数据动作节点 id），**不能指向上游 event 节点**。
+
+- 设计器打开「动态赋值」对话框时，用 `esbAssign.wId` 在 `orginFlowDatas` 里定位当前组件；指向 event 节点 → 定位不到 → 右侧「暂无数据」（EmptyView，不可编辑/不可选）。
+- `value.source` / `config.comId` 仍指向 event 节点（公式来源，不变）；只有 `esbAssign.wId` 单独用当前节点 id。
+- 判断口径：读回后 `esbAssign.wId` 应等于该 ActionEbAdd/Update/Delete 节点的 `id`，不等于 `event.id`。
+
+## 4b. 同类问题全量修复：mapping / updateId / basisValue / 明细依据值下级 / updateFieldCondition / requestName 的上下文公式也要 `esbAssign.wId`（真机验证 2026-08-18）
+
+第 4 节最初只修了 `filterCondition`（`buildFilterInput` 路径）。验收 1 重跑时发现：**ActionEbAdd/Update 的字段映射（mapping）、按数据 ID 更新的 `updateId`、批量新增依据值 `basisValueFormula`/`setting.bassisValue`、明细映射的 type=10 依据值下级、`updateFieldCondition` 的 assign、ApproveCreate 的 `requestName`** —— 这些位置的上下文公式（type 3/8/10）**同样必须带 `esbAssign.wId` 指向当前数据动作节点**，否则设计器打开「动态赋值」会把该条显示为「【组件名（已删除）】」（组件未删除，只是 wId 缺失导致前端定位不到当前组件）。
+
+- 修复（2026-08-18）：`formula_service.ts` 新增 `attachEsbAssign(bean, meta, fallbackSource)`，在 `buildSettingEntry` 的 context 分支（含提前 return 的 assignFlatEsbChild 子表路径）与统一 return 前、`workflow_compiler.ts` 的 `_updateId`/`_basisValueFormula`/`handleBasisValue`/`requestName`、`action_eb_update_compiler.ts` 的 `buildUpdateFieldCondition` 处统一调用。wId 取值顺序与 filterInput 一致：`meta._upstream_node_id`（convertNode 设的当前节点 id）→ 公式 `source` → `meta._upstream_w_id` → 时间戳前缀。
+- 固定值（type=1）不加 esbAssign（设计器 fixvalue 不需要定位当前组件）。
+- 真机回归：验收 1 全 12 场景 readBack 通过；抽查 S1（basisValue+主表映射+type10 下级）/S2（filterInput+主表映射+明细 type10）/S10（updateId）/S11（ApproveCreate formData）/S12（updateId+累加 mapping）—— 所有 esbAssign.wId == 当前数据动作节点 id，无一处指向 event。
+- 新增/维护组件时，凡生成上下文公式的地方都要过一遍 `attachEsbAssign`；`references/components/` 下各组件契约 md 与 SKILL.md「esbAssign.wId」条目已同步。
+- 关联字段的身份元数据是另一条独立约束：筛选字段必须保留真实 `sformId`；`refObjId` 只在对应平台 DTO 要求时保留，不能把它当作所有关联字段的统一必填项。`esbAssign.wId` 正确只能保证动态右值能定位当前动作节点；缺少 `sformId` 仍会让设计器把左侧仍存在的字段显示成“已删除”。
+- Workflow 左值还必须带目标表默认布局 `formInfo.layoutId`。`formInfo.formId` 只能填目标表版本 ID，顶层 `sformId` 要填 `workflowPath.formIds` 对应的流程表单对象 ID；Workflow 使用原始数字 `fieldName`、`fieldType:"String"`、空 `module`/`originBrowserType`，不能加 `field_` 前缀或把 `Workflow` 当存储类型。不能把目标表版本 ID当作关联对象；反查不到真实对象时停止生成并报错。
+

package/skills/weaver-e10-builder/assets/dom-structure/Bar.json

@@ -0,0 +1,341 @@
+{
+  "component": "Bar（柱状图）",
+  "usage": "图表组件的 HTML 结构索引，用于样式定位：用户说「给柱状图的 XX 设置样式」时，在这里按语义找节点，用它的 id / class 写选择器。不是完整 DOM 树，只列有 id 或关键 class 的元素。",
+  "legend": {
+    "[cls]": "条件类名：条件满足时才出现，否则该类名不存在",
+    "{a|b}": "多选一：实际只会出现其中一个",
+    "a > b": "合并两层：b 是 a 的直接子元素（中间没有有意义的元素）",
+    "ref": "引用本文件 shared.* 里的复用片段",
+    "<comId>": "尖括号 = 需要替换的占位符。<comId> 是该组件在页面里的实例 id（配置界面叫「组件ID」），写样式时用它限域，例如 #<comId> .ebcoms-charts-total；<contentClass> 等同理。注意花括号 {a|b} 只表示「多选一」，不用来表示占位符。",
+    "ebcom / ebcom-*": "weapp-ebdcoms 引擎加的类，不在图表组件源码里（core/view/createView.tsx + core/utils/comp.ts）",
+    "ebcoms-*": "图表组件源码写的类（clsPrefix = 'ebcoms'）",
+    "ui-*": "@weapp/ui 组件的类：ui-echarts / ui-table-grid-* / ui-spin / ui-empty / ui-pagination / ui-icon / ui-bread-crumb / ui-popover",
+    "weapp-ebdf-*": "筛选搜索组件（@weapp/ebpagedesign）的类，只给挂载点，内部结构不可控"
+  },
+  "pickTree": "按「区域」取树：标题区→header，图表区（合计/轴名/canvas/加载）→chartArea，数据表→dataList，图表左右侧的数值清单→labelDataList。写样式时先 #<comId> 限域再往下找。本类型没有「数值展示列表」区域（不在 isDataOnLeftOrRight 列表）。",
+  "root": {
+    "desc": "引擎外壳，所有图表组件完全一致，由 weapp-ebdcoms 渲染（不在图表源码里）。写样式统一用 #<comId> 限域。",
+    "tree": {
+      "tag": "div",
+      "id": "<comId>",
+      "class": "ebcom ebcom-bar [ebcom-m] ebcom-{grid|flow} ebcom-view ebcom-chart has-no-header",
+      "desc": "组件根。ebcom-bar=类型类（同页多个图表组件靠它区分类型）；ebcom-m 仅移动端；ebcom-{grid|flow}=页面布局；ebcom-chart 来自图表 defaultOpts.render.containerClass；has-no-header 恒有（图表用 renderHeader 自渲染标题，不走引擎的默认 header）。",
+      "children": [
+        {
+          "tag": "div",
+          "class": "header",
+          "when": "config.titleEnabled = true",
+          "desc": "标题区。内容由图表自己的 ChartHeader 接管（见 header 树）。标题关闭时这个节点整个不存在。",
+          "ref": "header.tree"
+        },
+        {
+          "tag": "div",
+          "class": "<contentClass> content",
+          "desc": "引擎内容槽，图表全部内容都在这里。view 模式初始只有 content，其余类名由脚本 classList.toggle 追加；design 模式直接带全。可能追加到 .content 上的类：ebcoms-charts-fl（流式布局）、ebcoms-bar-content（流式布局）、show-data-list、data-list-direction-{top|bottom|left|right}、ebcoms-charts-reloading、ebcoms-charts-grid-mobile、displayFlex。",
+          "ref": "chartArea.tree"
+        },
+        {
+          "tag": "div",
+          "class": "footer",
+          "desc": "引擎底部操作栏。图表默认不开，几乎见不到；开了才会在 .content 之后出现 .ebcoms-footer-btns。"
+        }
+      ]
+    }
+  },
+  "shared": {
+    "desc": "跨区域复用的小片段。同一个 class 在多个区域出现时以这里的定义为准。",
+    "empty": {
+      "tag": "div",
+      "class": "ui-empty",
+      "desc": "@weapp/ui Empty。图表里三种用法：未匹配配置（“请设置图表配置项”）、无数据（type=noData）、词云 IE 提示（多一个 ebcoms-charts-com-WordCloud-IEempty）。紧挨着还有一个 .ebcoms-charts-placeholder 占位块（echarts 未实例化时）。"
+    },
+    "spin": {
+      "tag": "div",
+      "class": "ui-spin [ui-spin-nested-loading > ui-spin-container]",
+      "desc": "@weapp/ui Spin。图表里有 3 处，外层都会再拼一个 ebcoms-* 类：ebcoms-charts-view-loading（图表区首次加载，在 .ebcoms-charts-com 内）、ebcoms-charts-view-reloading（刷新遮罩，绝对定位铺满半透明白，在 .ebcoms-charts-main 下）、数据表内部（ui-table-grid 内自动包一层）。"
+    },
+    "toolbarBtn": {
+      "tag": "span",
+      "desc": "标题区每个操作按钮外层都是一个无 class 的 span（OperationBtns 渲染）。里面要么是图表自己的定制视图（ChartSwitch / YMDSwitch / ChartsToolbarBtn），要么是 @weapp/ui 的 ConfigurableButton（ui-btn）或配置的图标（ui-icon > svg.ui-icon-svg）。想单独选中某个按钮只能靠 :nth-child() 或按内容定位。"
+    },
+    "filterMount": {
+      "tag": "div",
+      "class": "ebcoms-cmf-view [showFilter] [empty] [mobile] [onlyCondition]  或  ebcoms-cms-search [design] [active]",
+      "desc": "筛选条件区的挂载点（CommonFilter / SearchContent）。标题区和图表区各可能出现一个，两者互斥：筛选按钮配置在标题区时只在标题区渲染。内部 DOM 不可控，只在这个挂载点上写样式。"
+    }
+  },
+  "header": {
+    "when": "config.titleEnabled = true。关闭时 #<comId> 上带 has-no-header，.header 节点不存在。",
+    "chain": "#<comId> > .header.ebcoms-charts-custom-header.PC|MOBILE",
+    "tree": {
+      "tag": "div",
+      "class": "ebcoms-charts-custom-header header  PC|MOBILE",
+      "desc": "标题区根。同时带引擎的 .header（布局用的通用类）和组件的 ebcoms-charts-custom-header。末尾的 PC / MOBILE 是 page.client 直接拼上去的，用来控制标题最大宽度（PC 65% / MOBILE 45%），不是类名前缀。",
+      "children": [
+        {
+          "tag": "div",
+          "class": "ebcoms-charts-custom-header-title-content",
+          "desc": "标题文本区。可能先有一个标题图标组件（TitleIconCom，仅配了标题图标时），然后是一个 <div> 承载标题 HTML（dangerouslySetInnerHTML，所以标题里的富文本、动态字段也会渲染进这个 div，别以为只有纯文本）。"
+        },
+        {
+          "tag": "div",
+          "class": "[isDesign]",
+          "desc": "flex:1 的右侧区，按顺序放：操作按钮组、筛选条件、再一个操作按钮组（筛选按钮配置在最后一位时按钮会挪到筛选前面）、design 模式下的遮罩 ebcoms-charts-main-filtertotal-mask。",
+          "children": [
+            {
+              "tag": "div",
+              "class": "ebcoms-header-btns",
+              "desc": "顶部操作按钮组（OperationBtns 的 wrapClass）。左侧按钮和右侧按钮会渲染成两个同 class 的兄弟 div，所以 .ebcoms-header-btns 在标题区可能出现两次，别用 :first-child 猜。",
+              "children": [
+                {
+                  "tag": "div",
+                  "class": "ebcoms-chart-toolbar",
+                  "when": "“图表工具栏”按钮开启（isSupportChartToolsConfig）",
+                  "desc": "图表工具栏。固定 6 个 span 槽位，顺序固定；每个槽位内部再分 .default / .hover 两个 span。.default 和 .hover 是通用类名，写样式必须用 .ebcoms-chart-toolbar 限定，否则会串到别处。",
+                  "children": [
+                    {
+                      "tag": "span",
+                      "class": "btn-boxSelect",
+                      "desc": "区域缩放。槽位恒在，但本类型不渲染图标，是个空 span（要按顺序定位时别数错）。"
+                    },
+                    {
+                      "tag": "span",
+                      "class": "btn-clearBoxSelect",
+                      "desc": "区域缩放还原。槽位恒在，但本类型不渲染图标，是个空 span（要按顺序定位时别数错）。"
+                    },
+                    {
+                      "tag": "span",
+                      "class": "btn-changeLine",
+                      "desc": "切换为折线图。图标存在；里面有 .default 与 .hover 两个 span（默认显示 default，hover 换成 hover，宽度/颜色/底色可由按钮配置写进行内 style），图标是 ui-icon > svg.ui-icon-svg，选中态加 .selected。"
+                    },
+                    {
+                      "tag": "span",
+                      "class": "btn-changeBar",
+                      "desc": "切换为柱状图。图标存在；里面有 .default 与 .hover 两个 span（默认显示 default，hover 换成 hover，宽度/颜色/底色可由按钮配置写进行内 style），图标是 ui-icon > svg.ui-icon-svg，选中态加 .selected。"
+                    },
+                    {
+                      "tag": "span",
+                      "class": "btn-restore",
+                      "desc": "还原。图标存在；里面有 .default 与 .hover 两个 span（默认显示 default，hover 换成 hover，宽度/颜色/底色可由按钮配置写进行内 style），图标是 ui-icon > svg.ui-icon-svg，选中态加 .selected。"
+                    },
+                    {
+                      "tag": "span",
+                      "class": "btn-saveAsImage",
+                      "desc": "保存为图片。图标存在；里面有 .default 与 .hover 两个 span（默认显示 default，hover 换成 hover，宽度/颜色/底色可由按钮配置写进行内 style），图标是 ui-icon > svg.ui-icon-svg，选中态加 .selected。"
+                    }
+                  ]
+                }
+              ]
+            },
+            {
+              "ref": "shared.filterMount",
+              "when": "筛选按钮在标题区"
+            }
+          ]
+        }
+      ]
+    }
+  },
+  "chartArea": {
+    "desc": "引擎 .content 里的全部内容，由 AsyncBaseView + ChartView 渲染。",
+    "tree": {
+      "tag": "div",
+      "class": "ebcoms-charts-main",
+      "desc": ".content 下唯一的内容根。它是个 flex 容器：图表容器 .ebcoms-charts-com 和数据表 .ebcoms-data-list-display-content 是平级兄弟，所以 dataListDisplay.visible 时 .content 加 show-data-list，index.less 用它和 data-list-direction-* 决定图表与数据表是上下还是左右排列。",
+      "children": [
+        {
+          "tag": "div",
+          "class": "ebcoms-charts-main-switchChartType",
+          "when": "“图表类型”按钮开启 && customValue.keepDisplaying && 标题未开启（标题开启时它挪进标题区）",
+          "desc": "常驻在图表上方的图表类型切换条。",
+          "children": [
+            {
+              "tag": "div",
+              "class": "ebcoms-chart-head-chartSwitch",
+              "children": [
+                {
+                  "tag": "span",
+                  "class": "ebcoms-chart-head-chartSwitch-item [active]",
+                  "desc": "每个可切换类型一项，active=当前类型。内含图标（普通类型 ui-icon；Bullet 内联 svg.icon；WordCloud / Facet / HeatMap 是 img）+ 类型名文本。"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "tag": "div",
+          "id": "id_<comId>",
+          "class": "ebcoms-charts-com [ebcoms-charts-preview] [hide]",
+          "desc": "图表容器，图表区所有东西都在这。id 是 id_<comId>（id_ + 组件 id）。ebcoms-charts-preview 仅 stylePre（预览）时；hide 仅 dataListDisplay.onlyTable（只显示数据表）时。容器自带 min-width: 30px（源码注释：宽度过小时气泡图 echart 内部会报错）。",
+          "children": [
+            {
+              "tag": "div",
+              "id": "filtertotal_<comId>",
+              "class": "ebcoms-charts-main-filtertotal [hasRelationStatistics]",
+              "desc": "图表上方一行：左边合计、右边筛选条件（两者独立出现）。hasRelationStatistics 仅关系图且有统计时（左侧让出 150px）。注意它和 .ebcoms-charts-main 是两个不同的 main。",
+              "children": [
+                {
+                  "tag": "ul",
+                  "class": "ebcoms-charts-total",
+                  "when": "showTotal && 有数据 && 配置已初始化（本类型支持合计）",
+                  "desc": "合计区，每个指标一个 li，li 上没有类名（要单独选只能 :nth-child()）。这里会先撑高再触发图表 resize。同比柱状图（barType=yoy）和区间柱状图（barType=region）在这里的算法不同，但 DOM 完全一样，都是 ebcoms-charts-total > li。"
+                },
+                {
+                  "ref": "shared.filterMount",
+                  "when": "配了筛选条件且按钮不在标题区"
+                }
+              ]
+            },
+            {
+              "tag": "div",
+              "id": "chartStatChildren_<comId>",
+              "when": "有维度钻取 或 维度开了“统计下级”",
+              "desc": "下钻 / 统计下级 / 关系图展开的挂载点（面包屑 + 弹出菜单）。不需要时这个 id 节点不存在。",
+              "children": [
+                {
+                  "tag": "div",
+                  "class": "ui-bread-crumb ebcoms-charts-bread-crumb {drilling|...}",
+                  "desc": "面包屑。带 drilling 时样式不同（可点层级为蓝色）。关系图不渲染它。"
+                },
+                {
+                  "tag": "span",
+                  "class": "ebcoms-charts-statChildrenSpan",
+                  "desc": "弹出菜单的定位锚点：1px 绝对定位的隐形 span，left/top 由点击坐标算出来。"
+                },
+                {
+                  "tag": "div",
+                  "class": "ebcoms-charts-statChildrenPop",
+                  "desc": "菜单弹层（Popover）。内部列表项 class 为 ebcoms-charts-list-item；弹层箭头 .ui-popover-arrow 在这里被隐藏。"
+                }
+              ]
+            },
+            {
+              "tag": "div",
+              "class": "ebcoms-charts-axis-name {x|y|secondY}",
+              "when": "有数据。x → y → secondY 三个节点按顺序渲染在 .ebcoms-charts-com 下的同一层（不需要的节点直接不渲染，所以实际可能只有一个）。",
+              "desc": "数值轴是 Y 轴：左侧 .y 挂的是 axisLabel.y 的文案。 三个节点同前缀、靠后缀区分——选左轴要用 .ebcoms-charts-axis-name.y；名字非空时才 display:flex，否则节点在但 display:none。",
+              "children": [
+                {
+                  "tag": "div",
+                  "class": "ebcoms-charts-axis-name x",
+                  "desc": "底部横排的轴名称。绝对定位，bottom 会按图例位置 / dataZoom 高度自动算（写在行内 style 上）。只在该轴名称非空时 display:flex，否则 display:none（节点还在）。文案在 > span 里，颜色取 axisLabel.xColor（行内 style）。"
+                },
+                {
+                  "tag": "div",
+                  "class": "ebcoms-charts-axis-name y",
+                  "desc": "左侧竖排的轴名称。width 12px、span 旋转 -90deg（transform-origin: 0 0），margin-top 按字数算（行内 style）。颜色取 axisLabel.yColor。"
+                },
+                {
+                  "tag": "div",
+                  "class": "ebcoms-charts-axis-name secondY",
+                  "when": "该类型在 supportComposeCharts 内 && 配置了组合图（双轴）",
+                  "desc": "右侧竖排的轴名称（副轴）。样式同 y，但靠右定位。颜色取 axisLabel.secondYColor。"
+                }
+              ]
+            },
+            {
+              "tag": "div",
+              "class": "ui-echarts [ui-echarts-rtl]",
+              "when": "非空数据且没在 loading",
+              "desc": "图表本体。ECharts 用 canvas 渲染，图例 / 坐标轴 / 数据标签 / tooltip / 柱子颜色全在 canvas 里，CSS 选不到——这些只能改图表配置项或图表主题。容器本身可改尺寸、背景、边框、滤镜；RTL 页面会多 ui-echarts-rtl（会 transform: scaleX(-1)）。"
+            },
+            {
+              "tag": "div",
+              "class": "ebcoms-label-data-list-content",
+              "when": "永不出现",
+              "desc": "本类型不在 isDataOnLeftOrRight（Pie / Circular / Nightingale）列表里，图表左右侧不会出现数值展示清单。"
+            },
+            {
+              "ref": "shared.empty"
+            },
+            {
+              "tag": "div",
+              "class": "ebcoms-charts-placeholder",
+              "when": "chartInstance 尚未就绪",
+              "desc": "占位块，撑住高度防止塌陷。"
+            },
+            {
+              "tag": "div",
+              "class": "ui-spin ebcoms-charts-view-loading",
+              "when": "配置还未初始化完成，或正在刷新数据（此时上面那批节点都不渲染，互斥）",
+              "desc": "图表区加载态。"
+            }
+          ]
+        },
+        {
+          "tag": "div",
+          "class": "ui-pagination ebcoms-charts-pagination",
+          "when": "config.showPagination = true（本类型支持分页配置）",
+          "desc": "图表级分页（不是数据表里的分页）。内部 ui-pagination-pager / ui-pagination-pager-item / ui-pagination-pager-active / ui-pagination-pager-page-input。"
+        },
+        {
+          "ref": "dataList.tree"
+        },
+        {
+          "tag": "div",
+          "class": "ui-spin ebcoms-charts-view-reloading",
+          "when": "reloading（切换图表类型 / 切换日期分组 / 强刷）",
+          "desc": "整块刷新遮罩：绝对定位居中铺满 + rgba(255,255,255,.7) 底。要改遮罩底色改这里。"
+        }
+      ]
+    }
+  },
+  "dataList": {
+    "when": "dataListDisplay.visible = true 且非空数据",
+    "chain": ".content > .ebcoms-charts-main > .ebcoms-data-list-display-content.{horizantal|vertical}[.show-total][.isMobile] > .ui-table-grid.ebcoms-datalist-table",
+    "tree": {
+      "tag": "div",
+      "class": "ebcoms-data-list-display-content {horizantal|vertical} [show-total] [isMobile]",
+      "desc": "数据表区域。和图表的 .ebcoms-charts-com 是 .ebcoms-charts-main 下的平级兄弟（不在图表容器里），所以它不会跟着图表一起被 hide。注意类名是 horizantal（源码里的拼写，少一个 o），别写成 horizontal。位置由 .content 上的 data-list-direction-{top|bottom|left|right} 控制；horizantal 表示横向扩展（第一列固定）。",
+      "children": [
+        {
+          "tag": "div",
+          "class": "ui-table-grid ebcoms-datalist-table ui-table-grid-bordered [ui-table-grid-no-pagination] [ui-table-grid-scroll-position-*] [ui-table-grid-table__fixed]",
+          "desc": "数据表（@weapp/ui Table）。下面这些 ui-table-grid-* 是引擎已有样式钩子，可以直接复用；要改文字色 / 表头底色 / 内容底色 / 边框色，优先用组件外观样式里的「数据表」配置（会自动生成这些选择器，见 notes）。",
+          "children": [
+            {
+              "tag": "div",
+              "class": "ui-spin > ui-spin-nested-loading > ui-spin-container",
+              "desc": "表格自带 loading 包裹层，表格内容都在 ui-spin-container 里。"
+            },
+            {
+              "tag": "div",
+              "class": "ui-table-grid-header-warp > .ui-table-grid-header",
+              "desc": "表头。里面 table > thead.ui-table-grid-thead > tr > th.ui-table-grid-th。固定列时还会有一份 ui-table-grid-sticky-header-warp（滚动吸顶）。"
+            },
+            {
+              "tag": "div",
+              "class": "ui-table-grid-body-outer > .ui-table-grid-body",
+              "desc": "表体。table > tbody.ui-table-grid-tbody > tr > td.ui-table-grid-td。合计行在 tfoot.ui-table-grid-tfoot（showTotal && 纵向扩展时）。细分隔行 tr 带 ui-table-grid-tr__gray。"
+            },
+            {
+              "tag": "div",
+              "class": "ui-table-grid-scroll",
+              "desc": "横向滚动容器；只在有固定列或按 table 滚动时出现。"
+            },
+            {
+              "tag": "div",
+              "class": "ui-table-grid-fixed-left / ui-table-grid-fixed-right",
+              "desc": "左右固定列（横向扩展时第一列 fixed: left）。"
+            },
+            {
+              "tag": "div",
+              "class": "ui-table-grid-empty",
+              "desc": "无数据占位。"
+            }
+          ]
+        }
+      ]
+    }
+  },
+  "notes": [
+    "样式作用域：图表样式由「组件外观样式」生成，最终选择器都会被包在 #<comId>.ebcom 下面（自定义源码再套一层 #<comId> .comCodeSource）。自己写选择器也建议 #<comId> .xxx，避免同页多图表互相污染。",
+    "数据表配色有官方生成器：组件外观样式→数据表里的「字体/表头底色/内容底色/边框色」，会直接生成 .ebcoms-data-list-display-content 下的 .ui-table-grid-td/.ui-table-grid-th/.ui-table-grid-thead/.ui-table-grid-header-warp/.ui-table-grid-body-outer/.ui-table-grid-tbody/.ui-table-grid-tfoot 规则。要改数据表颜色优先用这个，不要重复写 CSS。",
+    "canvas 边界：图例、坐标轴刻度、数据标签、tooltip、柱/扇区颜色全部是 ECharts canvas，CSS 选不到。这类需求只能改图表配置项或图表主题，不要试图用选择器命中。",
+    "同名陷阱：引擎的 .header / .content / .footer（无前缀）≠ 组件的 ebcoms-*-content；.ebcoms-charts-main 和 .ebcoms-charts-main-filtertotal 是两个不同层的节点，只差一个后缀；.default / .hover 是工具栏按钮的通用类名，必须用 .ebcoms-chart-toolbar 限定；displayFlex 是无前缀裸类名（全局限定）。",
+    "引擎自动加的修饰类：#<comId> 上恒有 has-no-header；ebcom-chart 来自图表 defaultOpts.render.containerClass；padding=false 时加 content-no-padding；配了点击事件时加 event-action-click。",
+    "移动端：外壳多 ebcom-m 类；网格布局 + 移动端时 .content 多 ebcoms-charts-grid-mobile（内部把加载块高度固定 300px）。",
+    "反查源码：引擎 weapp-ebdcoms/src/components/core/{view,design}/{createView,Base,createDesign}.tsx、core/utils/comp.ts、core/view/operation-btns/OperationBtns.tsx；组件 weapp-ebdchartcoms/src/components/charts/core/{BaseView,ChartView,ChartHeader,AxisLabelName,ChartTotal,ChartStatChildren,getChartsStyles}.ts(x)、core/DataListDisplay/*、core/LabelDataListDisplay.tsx、core/index.less；UI 库 weapp-ui/src/components/{echarts,table,spin,pagination,empty}。",
+    "柱状图最特殊：等价配置可以切换成同比柱状图 / 区间柱状图，DOM 不变，但合计行与工具栏按钮文字含义会变。"
+  ]
+}