weaver-e10-builder 1.6.14 → 1.6.16

package/skill-docs/references/report/add-dataset-registration-guide.md

@@ -1,161 +1,161 @@
-# addDataset 注册契约 · `field_` 前缀门禁（强制）
-
-> **事故（已验证 · 报表 `1312765120721813505`）**
-> 同一 `sourceId=972019393600233477`（轻资产信息）：
-> - **Agent/API 加的数据集** `1312765120721813506`：`type=form` + `sourceGroup=<appId>` → `fieldsKey.name` 业务字段为**裸雪花**（无 `field_`）
-> - **设计器手动「+」加的数据集** `1312794545670627330`：`type=logic` + `sourceGroup=weaver-ebuilder-form-service` → `fieldsKey.name` 业务字段为 **`field_{雪花}`**
->
-> **遗漏点不在「写 Field 时忘加 field_」**，而在 **`addDataset` 注册参数与设计器不一致**，导致权威 `fieldsKey` 本身就没有 `field_`。
-> 后续若按设计器习惯臆造 `field_`，或绑错到「裸雪花」那份 dataset，会出现保存 500 / 取数失败 / 与用户手动数据集字段名对不齐。
-
----
-
-## 一、两种注册形态（必须分清）
-
-| 形态 | 典型 `addDataset` | `dataset/list` 特征 | 业务字段 `fieldsKey.name` | `tableName` 后缀 | 何时用 |
-|------|-------------------|---------------------|---------------------------|------------------|--------|
-| **A. 设计器默认（logic，小写）** | `sourceType=logic`（**必须小写**；大写 `LOGIC` 会让报表复制 500）+ `sourceGroup=weaver-ebuilder-form-service` + `appid=<appId>` | `type:"logic"`，`sourceGroup:"weaver-ebuilder-form-service"` | **`field_{雪花}`** | **`(业务模块)`** | **普通应用表单（默认强制）** |
-| **B. 共享表 / form 契约** | `sourceType=form` + `sourceGroup=<appId>` | `type:"form"`，`sourceGroup` 等于 appId | 常为**裸雪花** | **`(表单)`** | 仅「xxx-共享表」类应用且已验证必须用此契约时（见 MEMORY/共享表笔记） |
-| **C. 数据加工 SQL 视图** | `sourceType=eteams`（**必须小写**）+ `sourceGroup=sql` + `appid=<appId>` | `type:"eteams"`，`sourceGroup:"sql"` | 视图原字段名（如 `title`/`zymc`/`major_no`，**无 `field_` 前缀**） | **`(数据加工)`** | 数据集来自「数据加工」SQL 视图 |
-
-**禁止**：在普通应用里误用形态 B，再抱怨「没有 field_」——那是注册错了，不是 fieldsKey 坏了。
-
-> ⚠️ **形态 C 大小写门禁（2026-10-09 实证 · 应用 `1323883777452843010`）**：
-> `sourceType` **必须小写 `eteams`** + `sourceGroup=sql`，落库 `type="eteams"` → 面板/单元格显示 **`X(数据加工)`** ✅。
-> 若传大写 `ETEAMS`（或 sourceGroup 用 `-98`）→ 落库 `type="ETEAMS"`/`sourceGroup:"-98"` → 被当成 **`X(业务模块)`** ❌。
-> 同应用验证：`eteams`/`sql` 的 5 张表单元格全为 `X(数据加工)`；`ETEAMS`/`-98` 的 2 张表全为 `X(业务模块)`。
-
-> ⚠️ **`tableName` 后缀必须与注册形态一致**：形态 A → `(业务模块)`，形态 B → `(表单)`，形态 C → `(数据加工)`。
-> 后缀缺失或写错会导致左侧数据源不显示模块类型。
-> 详见 **`dataset-table-field-contract-guide.md`**（含 `FieldCellType` 必需字段全表 + 落库门禁）。
-
----
-
-## 二、设计器兼容的 addDataset（默认强制）
-
-```
-POST /api/bs/edc/report/addDataset
-Content-Type: multipart/form-data
-
-reportId     = {reportId}
-sourceType   = logic              // ★★ 必须小写！大写 LOGIC 会让报表「复制」500（见下方红框）
-sourceIds    = {sourceId}          // 表单/数据源 ID
-sourceName   = {裸名}              // ★ 传**裸名** `轻资产信息`（不带后缀）
-                                  //   面板显示名 = sourceName + (添加类型标签)，标签由平台按添加类型自动拼
-                                  //   旧口径「必须传 {表单名}(业务模块)」已于 2026-09-16 推翻（注意点 BUILD-36）
-appid        = {appId}             // 注意小写 appid（与设计器一致）
-sourceGroup  = weaver-ebuilder-form-service
-```
-> ★★ **`sourceType` 必须小写 `logic`（2026-09-15 实证 · 注意点 BUILD-29）**
-> 服务端会把入参**原样**写进 `edc_dataset_dev.type`：
-> - `sourceType=logic` → `type="logic"`（= 设计器口径）→ 报表「复制」**200**
-> - `sourceType=LOGIC` → `type="LOGIC"`（大写）→ 报表「复制」**500「报表内部错误」**（HTTP 仍 200）
->
-> 决定性实验：同应用同表单两张空壳，唯一差别就是这里的大小写 → 200 / 500。
-> CLI 侧已把默认值统一为小写（`dataset add --source-type` 默认 `logic`），**不要显式传大写**。
-> 存量注意报表：`e10-cli report copy-health`（诊断）→ `e10-cli report dataset heal --purge --apply`（原地换型修复）。
-
-> **回显名（2026-09-16 更正 · 注意点 BUILD-36）**：`sourceName` 写入 `edc_dataset_dev.name`，面板显示时为
-> **`{sourceName} + (添加类型标签)`** —— 所以 `sourceName` 要传**裸名** `轻资产信息`，面板才会显示 `轻资产信息(业务模块)`。
-> **旧说法「只传裸表单名会缺后缀、必须传 `轻资产信息(业务模块)`」已推翻**：那样写会让面板显示 **`轻资产信息(业务模块)(业务模块)`**。
-> 决定性对照（报表 `1315265856934289408`，同 sourceId 两条）：脚本建那条 `name="采购入库(业务模块)"` → 双后缀 ❌；
-> 设计器「+」那条 `name="采购入库"` → `采购入库(业务模块)` ✅。
-> 源合并后的 `tableText` 可能仍是 `轻资产信息(uf_xxx)`，与回显名不是同一字段——**以 `name` 为准**。
-> 存量脏值清理：`e10-cli report fix dataset-name --report-id <rid> --app-id <appId> [--apply]`。
-
-可选字段以设计器接口返回为准；**不得**把 `sourceGroup` 写成 appId，除非走 §一 形态 B。
-
-`addDataset` **不返回** datasetId → 短轮询：
-
-```
-GET /api/bs/edc/dataset/list?hasField=true&reportId={reportId}
-```
-
-按 **sourceId** 命中；若同 sourceId 多条，**优先选** `sourceGroup=weaver-ebuilder-form-service` / `type=logic` 那条。
-
-### 2.1 同源只挂一次（**强制 · 2026-09-11 事故**）
-
-构建层 在 `addDataset` **之前**先查 `dataset/list`：
-
-| 场景 | 行为 |
-|------|------|
-| 本报表已有同 `sourceId` 数据集 | **复用**（`datasetReused=true`），**不再 addDataset** |
-| 发现同源 ≥2 条 | 回传 `datasetDuplicates[]` + WARN（左侧会出现重复分组） |
-| 传了别的报表的 `datasetId` | 忽略 + WARN（禁止跨报表复用） |
-
-> 事故：同一表单被 `addDataset` 挂载两次（`type=LOGIC` 与 `type=logic` 各一条），
-> 且画布上两个单元格引用第二条 → 设计器左侧出现**两个同名数据源分组**。
-> 未先去重就继续绑字段，会让「绑到哪一份数据源」变得不可预测。
-> 清理顺序见 `dataset-sidebar-ops-guide.md §5.3`（**先改绑/清单元格 → 再 delDataset**）。
-
----
-
-## 三、addDataset 后强制门禁（遗漏即本事故）
-
-`fieldsAndOriginFields?isFront=true` 拿到 `fieldsKey` 后立刻检查：
-
-```javascript
-const biz = fieldsKey.filter(
-  (f) => /^\d{15,}$/.test(f.name) || /^field_\d{15,}$/.test(f.name)
-);
-const withPrefix = biz.filter((f) => String(f.name).startsWith('field_')).length;
-const bare = biz.filter((f) => /^\d{15,}$/.test(f.name)).length;
-
-// 普通应用（非共享表 form 契约）：业务字段应多数带 field_
-if (!isSharedFormContract && biz.length > 0 && bare > withPrefix) {
-  throw new Error(
-    'addDataset 注册错误：fieldsKey 业务字段为裸雪花（无 field_）。' +
-      '应使用 sourceType=LOGIC + sourceGroup=weaver-ebuilder-form-service；' +
-      'delDataset 后重建，禁止在 Field 上凭记忆加 field_ 前缀凑数。'
-  );
-}
-```
-
-| 检查 | 通过标准 |
-|------|----------|
-| 普通应用 | 业务字段 `field_` 数量 **≥** 裸雪花数量（通常裸雪花应为 0） |
-| 共享表 form 契约 | 允许裸雪花；**禁止**再擅自加 `field_` |
-| 同 sourceId 已有手动 LOGIC 数据集 | **绑定/取 fieldsKey 必须用那条**；勿继续用旧的 form+appId 脏注册 |
-
-失败处理：
-
-1. `POST /api/bs/edc/report/delDataset` 删掉错误注册
-   - form：`reportId=<报表ID>` · **`sourceIds=<datasetId>`**（参数名历史遗留，**不是**表单 sourceId）
-   - 建议先 `GET /api/bs/edc/dataset/checkDataSetUsed?reportId=&datasetId=`；CLI：`e10-cli report dataset delete`
-   - 完整侧栏操作见 `dataset-sidebar-ops-guide.md`
-2. 按 §二 重新 `addDataset`
-3. 再拉 `fieldsKey`，确认出现 `field_*`
-4. 再写 Field / `saveReportDevInfo`
-
----
-
-## 四、与「字段精确绑定」的关系
-
-| 步骤 | 规则 |
-|------|------|
-| 1 注册 | 本指南：让 `fieldsKey` **先**变成设计器同款（含 `field_`） |
-| 2 绑定 | `field-bind-exact-match-guide.md`：`name` **逐字等于** 当前 dataset 的 `fieldsKey.name` |
-| 3 禁止 | 注册错了却在 cell 上「手工补 `field_`」；或注册对了却去前缀 |
-
-**一句话**：`field_` 不是 Agent 写 Field 时发明的，是 **正确 addDataset 之后 fieldsKey 自带的**。
-
----
-
-## 五、自检清单
-
-- [ ] `addDataset` 使用 `sourceType=LOGIC` + `sourceGroup=weaver-ebuilder-form-service`（除非共享表契约）
-- [ ] `dataset/list` 回读该条 `type/sourceGroup` 与设计器一致
-- [ ] `fieldsKey` 业务字段已出现 `field_*`（普通应用）
-- [ ] Field.`name` / fieldKey 末段 ∈ **该** dataset 的 fieldsKey（`e10-cli report verify bind`）
-- [ ] 同 sourceId 多实例时，未误绑到旧的 form+appId 裸雪花数据集
-
----
-
-## 六、相关文档
-
-| 文档 | 关系 |
-|------|------|
-| `field-bind-exact-match-guide.md` | 绑定名权威来源；前置依赖本指南的注册正确 |
-| `api-report-build-fast-path.md` | 建表流程步骤 2 / 2.1 门禁 |
-| `report-designer-feature-map.md` §六 | 设计器「+」对应 addDataset 参数 |
-| `e10-cli report verify bind` | 交付校验；并对「裸雪花 fieldsKey」给出注册错误提示 |
+# addDataset 注册契约 · `field_` 前缀门禁（强制）
+
+> **事故（已验证 · 报表 `1312765120721813505`）**
+> 同一 `sourceId=972019393600233477`（轻资产信息）：
+> - **Agent/API 加的数据集** `1312765120721813506`：`type=form` + `sourceGroup=<appId>` → `fieldsKey.name` 业务字段为**裸雪花**（无 `field_`）
+> - **设计器手动「+」加的数据集** `1312794545670627330`：`type=logic` + `sourceGroup=weaver-ebuilder-form-service` → `fieldsKey.name` 业务字段为 **`field_{雪花}`**
+>
+> **遗漏点不在「写 Field 时忘加 field_」**，而在 **`addDataset` 注册参数与设计器不一致**，导致权威 `fieldsKey` 本身就没有 `field_`。
+> 后续若按设计器习惯臆造 `field_`，或绑错到「裸雪花」那份 dataset，会出现保存 500 / 取数失败 / 与用户手动数据集字段名对不齐。
+
+---
+
+## 一、两种注册形态（必须分清）
+
+| 形态 | 典型 `addDataset` | `dataset/list` 特征 | 业务字段 `fieldsKey.name` | `tableName` 后缀 | 何时用 |
+|------|-------------------|---------------------|---------------------------|------------------|--------|
+| **A. 设计器默认（logic，小写）** | `sourceType=logic`（**必须小写**；大写 `LOGIC` 会让报表复制 500）+ `sourceGroup=weaver-ebuilder-form-service` + `appid=<appId>` | `type:"logic"`，`sourceGroup:"weaver-ebuilder-form-service"` | **`field_{雪花}`** | **`(业务模块)`** | **普通应用表单（默认强制）** |
+| **B. 共享表 / form 契约** | `sourceType=form` + `sourceGroup=<appId>` | `type:"form"`，`sourceGroup` 等于 appId | 常为**裸雪花** | **`(表单)`** | 仅「xxx-共享表」类应用且已验证必须用此契约时（见 MEMORY/共享表笔记） |
+| **C. 数据加工 SQL 视图** | `sourceType=eteams`（**必须小写**）+ `sourceGroup=sql` + `appid=<appId>` | `type:"eteams"`，`sourceGroup:"sql"` | 视图原字段名（如 `title`/`zymc`/`major_no`，**无 `field_` 前缀**） | **`(数据加工)`** | 数据集来自「数据加工」SQL 视图 |
+
+**禁止**：在普通应用里误用形态 B，再抱怨「没有 field_」——那是注册错了，不是 fieldsKey 坏了。
+
+> ⚠️ **形态 C 大小写门禁（2026-10-09 实证 · 应用 `1323883777452843010`）**：
+> `sourceType` **必须小写 `eteams`** + `sourceGroup=sql`，落库 `type="eteams"` → 面板/单元格显示 **`X(数据加工)`** ✅。
+> 若传大写 `ETEAMS`（或 sourceGroup 用 `-98`）→ 落库 `type="ETEAMS"`/`sourceGroup:"-98"` → 被当成 **`X(业务模块)`** ❌。
+> 同应用验证：`eteams`/`sql` 的 5 张表单元格全为 `X(数据加工)`；`ETEAMS`/`-98` 的 2 张表全为 `X(业务模块)`。
+
+> ⚠️ **`tableName` 后缀必须与注册形态一致**：形态 A → `(业务模块)`，形态 B → `(表单)`，形态 C → `(数据加工)`。
+> 后缀缺失或写错会导致左侧数据源不显示模块类型。
+> 详见 **`dataset-table-field-contract-guide.md`**（含 `FieldCellType` 必需字段全表 + 落库门禁）。
+
+---
+
+## 二、设计器兼容的 addDataset（默认强制）
+
+```
+POST /api/bs/edc/report/addDataset
+Content-Type: multipart/form-data
+
+reportId     = {reportId}
+sourceType   = logic              // ★★ 必须小写！大写 LOGIC 会让报表「复制」500（见下方红框）
+sourceIds    = {sourceId}          // 表单/数据源 ID
+sourceName   = {裸名}              // ★ 传**裸名** `轻资产信息`（不带后缀）
+                                  //   面板显示名 = sourceName + (添加类型标签)，标签由平台按添加类型自动拼
+                                  //   旧口径「必须传 {表单名}(业务模块)」已于 2026-09-16 推翻（注意点 BUILD-36）
+appid        = {appId}             // 注意小写 appid（与设计器一致）
+sourceGroup  = weaver-ebuilder-form-service
+```
+> ★★ **`sourceType` 必须小写 `logic`（2026-09-15 实证 · 注意点 BUILD-29）**
+> 服务端会把入参**原样**写进 `edc_dataset_dev.type`：
+> - `sourceType=logic` → `type="logic"`（= 设计器口径）→ 报表「复制」**200**
+> - `sourceType=LOGIC` → `type="LOGIC"`（大写）→ 报表「复制」**500「报表内部错误」**（HTTP 仍 200）
+>
+> 决定性实验：同应用同表单两张空壳，唯一差别就是这里的大小写 → 200 / 500。
+> CLI 侧已把默认值统一为小写（`dataset add --source-type` 默认 `logic`），**不要显式传大写**。
+> 存量注意报表：`e10-cli report copy-health`（诊断）→ `e10-cli report dataset heal --purge --apply`（原地换型修复）。
+
+> **回显名（2026-09-16 更正 · 注意点 BUILD-36）**：`sourceName` 写入 `edc_dataset_dev.name`，面板显示时为
+> **`{sourceName} + (添加类型标签)`** —— 所以 `sourceName` 要传**裸名** `轻资产信息`，面板才会显示 `轻资产信息(业务模块)`。
+> **旧说法「只传裸表单名会缺后缀、必须传 `轻资产信息(业务模块)`」已推翻**：那样写会让面板显示 **`轻资产信息(业务模块)(业务模块)`**。
+> 决定性对照（报表 `1315265856934289408`，同 sourceId 两条）：脚本建那条 `name="采购入库(业务模块)"` → 双后缀 ❌；
+> 设计器「+」那条 `name="采购入库"` → `采购入库(业务模块)` ✅。
+> 源合并后的 `tableText` 可能仍是 `轻资产信息(uf_xxx)`，与回显名不是同一字段——**以 `name` 为准**。
+> 存量脏值清理：`e10-cli report fix dataset-name --report-id <rid> --app-id <appId> [--apply]`。
+
+可选字段以设计器接口返回为准；**不得**把 `sourceGroup` 写成 appId，除非走 §一 形态 B。
+
+`addDataset` **不返回** datasetId → 短轮询：
+
+```
+GET /api/bs/edc/dataset/list?hasField=true&reportId={reportId}
+```
+
+按 **sourceId** 命中；若同 sourceId 多条，**优先选** `sourceGroup=weaver-ebuilder-form-service` / `type=logic` 那条。
+
+### 2.1 同源只挂一次（**强制 · 2026-09-11 事故**）
+
+构建层 在 `addDataset` **之前**先查 `dataset/list`：
+
+| 场景 | 行为 |
+|------|------|
+| 本报表已有同 `sourceId` 数据集 | **复用**（`datasetReused=true`），**不再 addDataset** |
+| 发现同源 ≥2 条 | 回传 `datasetDuplicates[]` + WARN（左侧会出现重复分组） |
+| 传了别的报表的 `datasetId` | 忽略 + WARN（禁止跨报表复用） |
+
+> 事故：同一表单被 `addDataset` 挂载两次（`type=LOGIC` 与 `type=logic` 各一条），
+> 且画布上两个单元格引用第二条 → 设计器左侧出现**两个同名数据源分组**。
+> 未先去重就继续绑字段，会让「绑到哪一份数据源」变得不可预测。
+> 清理顺序见 `dataset-sidebar-ops-guide.md §5.3`（**先改绑/清单元格 → 再 delDataset**）。
+
+---
+
+## 三、addDataset 后强制门禁（遗漏即本事故）
+
+`fieldsAndOriginFields?isFront=true` 拿到 `fieldsKey` 后立刻检查：
+
+```javascript
+const biz = fieldsKey.filter(
+  (f) => /^\d{15,}$/.test(f.name) || /^field_\d{15,}$/.test(f.name)
+);
+const withPrefix = biz.filter((f) => String(f.name).startsWith('field_')).length;
+const bare = biz.filter((f) => /^\d{15,}$/.test(f.name)).length;
+
+// 普通应用（非共享表 form 契约）：业务字段应多数带 field_
+if (!isSharedFormContract && biz.length > 0 && bare > withPrefix) {
+  throw new Error(
+    'addDataset 注册错误：fieldsKey 业务字段为裸雪花（无 field_）。' +
+      '应使用 sourceType=LOGIC + sourceGroup=weaver-ebuilder-form-service；' +
+      'delDataset 后重建，禁止在 Field 上凭记忆加 field_ 前缀凑数。'
+  );
+}
+```
+
+| 检查 | 通过标准 |
+|------|----------|
+| 普通应用 | 业务字段 `field_` 数量 **≥** 裸雪花数量（通常裸雪花应为 0） |
+| 共享表 form 契约 | 允许裸雪花；**禁止**再擅自加 `field_` |
+| 同 sourceId 已有手动 LOGIC 数据集 | **绑定/取 fieldsKey 必须用那条**；勿继续用旧的 form+appId 脏注册 |
+
+失败处理：
+
+1. `POST /api/bs/edc/report/delDataset` 删掉错误注册
+   - form：`reportId=<报表ID>` · **`sourceIds=<datasetId>`**（参数名历史遗留，**不是**表单 sourceId）
+   - 建议先 `GET /api/bs/edc/dataset/checkDataSetUsed?reportId=&datasetId=`；CLI：`e10-cli report dataset delete`
+   - 完整侧栏操作见 `dataset-sidebar-ops-guide.md`
+2. 按 §二 重新 `addDataset`
+3. 再拉 `fieldsKey`，确认出现 `field_*`
+4. 再写 Field / `saveReportDevInfo`
+
+---
+
+## 四、与「字段精确绑定」的关系
+
+| 步骤 | 规则 |
+|------|------|
+| 1 注册 | 本指南：让 `fieldsKey` **先**变成设计器同款（含 `field_`） |
+| 2 绑定 | `field-bind-exact-match-guide.md`：`name` **逐字等于** 当前 dataset 的 `fieldsKey.name` |
+| 3 禁止 | 注册错了却在 cell 上「手工补 `field_`」；或注册对了却去前缀 |
+
+**一句话**：`field_` 不是 Agent 写 Field 时发明的，是 **正确 addDataset 之后 fieldsKey 自带的**。
+
+---
+
+## 五、自检清单
+
+- [ ] `addDataset` 使用 `sourceType=LOGIC` + `sourceGroup=weaver-ebuilder-form-service`（除非共享表契约）
+- [ ] `dataset/list` 回读该条 `type/sourceGroup` 与设计器一致
+- [ ] `fieldsKey` 业务字段已出现 `field_*`（普通应用）
+- [ ] Field.`name` / fieldKey 末段 ∈ **该** dataset 的 fieldsKey（`e10-cli report verify bind`）
+- [ ] 同 sourceId 多实例时，未误绑到旧的 form+appId 裸雪花数据集
+
+---
+
+## 六、相关文档
+
+| 文档 | 关系 |
+|------|------|
+| `field-bind-exact-match-guide.md` | 绑定名权威来源；前置依赖本指南的注册正确 |
+| `api-report-build-fast-path.md` | 建表流程步骤 2 / 2.1 门禁 |
+| `report-designer-feature-map.md` §六 | 设计器「+」对应 addDataset 参数 |
+| `e10-cli report verify bind` | 交付校验；并对「裸雪花 fieldsKey」给出注册错误提示 |

package/skill-docs/references/report/advanced-crosstab-tree-guide.md

@@ -1,82 +1,82 @@
-# 高阶交叉表与折叠树报表 · 场景 H / I（SKILL A0.18）
-
-> 案例一「销售额等级分析」：多级行维度（一级品类→二级品类→品牌）× 多指标列组（销量对比/销售额/
-> 销售额年别/无人区/违杀率…，组内 2014/2015/占比/合计多列）+ 每级小计行 + 环比涨跌红绿条件色。
-> 案例二「江苏地区截止应收账款汇总表」：左侧折叠树（地区→区县→等级→分类，▶/▼ 可收起）+
-> 多层列组（合同销售/产品费用/实施费用，组内小计/已上线/未上线 + 个数/金额子列）+ 底部合计行。
-
----
-
-## 一、案例 H：高阶交叉表（多级行维度 × 多指标列组）
-
-| # | 特性 | 机制 | 落点 |
-|---|---|---|---|
-| ① | 多级行维度（品类→子类→品牌，逐级缩进） | 每级一个 Field（`Vertical+Group`），**子级左父格自定义→上级格**（链式缩进）；最末级左父格挂上一级 | rebuild 直构路径（crosstab guide §2），**build spec 单列平铺表达不了多级行维度** |
-| ② | 每级小计行（计/合计） | 小计 Formula 行左父格自定义→**该级维度格**，上父格→列维度；整行公式禁默认左父格（crosstab guide §4.2 ★） | 同上 |
-| ③ | 多指标列组（组内 年份/占比/合计） | 第一层列维度 `Horizontal+Group` 横向扩展；组内子表头 Const 上父格→列维度；占比/环比 = Formula（上父格→列维度，`SUM()` 引扩展格=对全部实例求和） | 知识库 §4.8 多横向维度交叉（两层横向维度的父格定案） |
-| ④ | 环比涨跌红绿（▲绿 ▼红 百分比） | `conditionRule.highlightDatas[]`：greater→红 / less→绿（或反之），relation highlight | build spec `columns[].rule` / 直构 `cellType.conditionRule` |
-
-**列组直构坐标模板**（列维度两组：年份组 + 无人区组）：
-
-```
-x=0  A1 行维度1(Vertical/Group)   B1 列维度1(Horizontal/Group)      F1 列维度2(Horizontal/Group)
-x=1  B2..E2 子表头Const(上父→B1)  F2..H2 子表头(上父→F1)
-x=2  A3 二级行维度(左父→A1)        B3.. 数值/占比(左父→A1/上级, 上父→B1/F1)
-x=3  A4 「计」小计行(左父→A1)      B4.. SUM公式(上父→B1/F1)
-```
-
-## 二、案例 I：折叠树报表（树形扩展）
-
-| # | 特性 | 机制 | 落点 |
-|---|---|---|---|
-| ① | 左侧树形层级（▶/▼ 收起展开） | 树形字段：**左父格无、上父格无、纵向扩展、`displayType:'Tree'`**（枚举定案 `AnalysisDisplayType: Group/List/Count/Tree`，knowledge-base §2/§4.6） | **`build spec` 已内置**：`columns[].display:'tree'` → 自动 Tree + 左父格 [-1,-1] + isActiveParent |
-| ② | 上下级从属关系 | 树形字段按**字段值上下级**（id 匹配上级）分叉；多数据集时配 `subordination`（VLOOKUP 映射） | 数据集单源自包含层级（如 组织表 pid）直接可树；跨表层级配 subordination |
-| ③ | 默认收起 / 默认展开 | 默认收起；展开 = 设计器「页面 → 页面布局 → 数据展开 → 树形」（sheetConfig） | spec 落库默认收起；默认展开=设计器确认项（sheetConfig 键名待确认回填） |
-| ④ | 多层列组（费用类型→状态→个数/金额） | 同案例 H ③：两层横向维度父格定案（知识库 §4.8） | rebuild 直构路径 |
-| ⑤ | 底部合计行 | `COMB_GRAND_TOTAL` → `SUM(...)`；左父格挂合计标签格 | crosstab guide §4.2 |
-
-**build spec 树形最小示例**：
-
-```json
-{
-  "appId": "<appId>", "sourceId": "<sid>", "sourceName": "<组织/地区表>",
-  "reportName": "江苏地区应收汇总",
-  "columns": [
-    { "title": "公司/项目/形态", "field": "组织层级", "display": "tree" },
-    { "title": "合同销售-个数", "field": "合同个数", "format": "value" },
-    { "title": "合同销售-金额", "field": "合同金额", "format": "huobi" }
-  ],
-  "layout": { "title": "江苏地区截止应收账款汇总表", "showLocation": "left", "freezeRows": 1, "freezeCols": 1 }
-}
-```
-
-## 三、能力边界（如实）
-
-1. **折叠按钮（▶/▼）由 `displayType=Tree` 引擎渲染**，API 侧只需树形字段+父格规则；`sheetConfig` 默认展开键名待确认回填。
-2. **多级行维度 / 多层列组**超出 build spec 表达力 → 走 rebuild 直构（`e10-cli report build` / `rebuild from-blueprint`），坐标模板见 §一。
-3. 树形列**必须**在数据源里有明确的上下级关系字段（自引用 pid 或 subordination 映射）；纯平铺字段强上 Tree 无层级效果。
-4. 渲染展开形态设计器确认为准（渲染接口取不到展开数据，crosstab guide §5.4）。
-
-## 四、搭建提示语句
-
-**案例 H（高阶交叉）**：
-
-> 按高阶交叉格式搭一张销售额等级分析：行维度三级「一级品类→二级品类→品牌」逐级缩进，
-> 每级带小计行，底部总计；列侧多指标组「销量对比/销售额/…」（组内 2014/2015/占比/合计）；
-> 环比列红绿条件色（`columns[].rule`）；数据源 `<sid>`（appId `<appId>`）；
-> 多级行维度+多列组走 rebuild 直构路径（crosstab + 本指南 §一坐标模板），落库后回读验收父格拓扑与 Formula 存活。
-
-**案例 I（折叠树）**：
-
-> 按折叠树格式搭一张地区应收汇总：左侧「组织层级」树形列（可收起展开，`display:"tree"`），
-> 列侧多层费用组（组内小计/已上线/未上线 → 个数/金额子列），底部合计行；
-> 数据源 `<sid>`（自包含层级；跨表层级给 subordination 映射），appId `<appId>`；
-> 冻结左 1 列+上方表头、居左；单源用 `build spec`、多源列组用 rebuild 直构，
-> 落库后回读验收：树形格 displayType=Tree 且左父格 -1,-1、冻结锚点唯一、check-ids 干净。
-
-## 五、验证清单
-
-1. 树形列回读：`displayType === 'Tree'`、`leftX/leftY === -1`、`isActiveParent === true`、`expandType === 'Vertical'`
-2. 案例 H：小计行 Formula 左父格=该级维度格；多列组子表头 Const 上父格→列维度格
-3. 条件色：`conditionRule.highlightDatas[]` 关系/颜色逐条回读
-4. 树形折叠表现、默认展开 = 设计器确认；验证后回填 sheetConfig 键名
+# 高阶交叉表与折叠树报表 · 场景 H / I（SKILL A0.18）
+
+> 案例一「销售额等级分析」：多级行维度（一级品类→二级品类→品牌）× 多指标列组（销量对比/销售额/
+> 销售额年别/无人区/违杀率…，组内 2014/2015/占比/合计多列）+ 每级小计行 + 环比涨跌红绿条件色。
+> 案例二「江苏地区截止应收账款汇总表」：左侧折叠树（地区→区县→等级→分类，▶/▼ 可收起）+
+> 多层列组（合同销售/产品费用/实施费用，组内小计/已上线/未上线 + 个数/金额子列）+ 底部合计行。
+
+---
+
+## 一、案例 H：高阶交叉表（多级行维度 × 多指标列组）
+
+| # | 特性 | 机制 | 落点 |
+|---|---|---|---|
+| ① | 多级行维度（品类→子类→品牌，逐级缩进） | 每级一个 Field（`Vertical+Group`），**子级左父格自定义→上级格**（链式缩进）；最末级左父格挂上一级 | rebuild 直构路径（crosstab guide §2），**build spec 单列平铺表达不了多级行维度** |
+| ② | 每级小计行（计/合计） | 小计 Formula 行左父格自定义→**该级维度格**，上父格→列维度；整行公式禁默认左父格（crosstab guide §4.2 ★） | 同上 |
+| ③ | 多指标列组（组内 年份/占比/合计） | 第一层列维度 `Horizontal+Group` 横向扩展；组内子表头 Const 上父格→列维度；占比/环比 = Formula（上父格→列维度，`SUM()` 引扩展格=对全部实例求和） | 知识库 §4.8 多横向维度交叉（两层横向维度的父格定案） |
+| ④ | 环比涨跌红绿（▲绿 ▼红 百分比） | `conditionRule.highlightDatas[]`：greater→红 / less→绿（或反之），relation highlight | build spec `columns[].rule` / 直构 `cellType.conditionRule` |
+
+**列组直构坐标模板**（列维度两组：年份组 + 无人区组）：
+
+```
+x=0  A1 行维度1(Vertical/Group)   B1 列维度1(Horizontal/Group)      F1 列维度2(Horizontal/Group)
+x=1  B2..E2 子表头Const(上父→B1)  F2..H2 子表头(上父→F1)
+x=2  A3 二级行维度(左父→A1)        B3.. 数值/占比(左父→A1/上级, 上父→B1/F1)
+x=3  A4 「计」小计行(左父→A1)      B4.. SUM公式(上父→B1/F1)
+```
+
+## 二、案例 I：折叠树报表（树形扩展）
+
+| # | 特性 | 机制 | 落点 |
+|---|---|---|---|
+| ① | 左侧树形层级（▶/▼ 收起展开） | 树形字段：**左父格无、上父格无、纵向扩展、`displayType:'Tree'`**（枚举定案 `AnalysisDisplayType: Group/List/Count/Tree`，knowledge-base §2/§4.6） | **`build spec` 已内置**：`columns[].display:'tree'` → 自动 Tree + 左父格 [-1,-1] + isActiveParent |
+| ② | 上下级从属关系 | 树形字段按**字段值上下级**（id 匹配上级）分叉；多数据集时配 `subordination`（VLOOKUP 映射） | 数据集单源自包含层级（如 组织表 pid）直接可树；跨表层级配 subordination |
+| ③ | 默认收起 / 默认展开 | 默认收起；展开 = 设计器「页面 → 页面布局 → 数据展开 → 树形」（sheetConfig） | spec 落库默认收起；默认展开=设计器确认项（sheetConfig 键名待确认回填） |
+| ④ | 多层列组（费用类型→状态→个数/金额） | 同案例 H ③：两层横向维度父格定案（知识库 §4.8） | rebuild 直构路径 |
+| ⑤ | 底部合计行 | `COMB_GRAND_TOTAL` → `SUM(...)`；左父格挂合计标签格 | crosstab guide §4.2 |
+
+**build spec 树形最小示例**：
+
+```json
+{
+  "appId": "<appId>", "sourceId": "<sid>", "sourceName": "<组织/地区表>",
+  "reportName": "江苏地区应收汇总",
+  "columns": [
+    { "title": "公司/项目/形态", "field": "组织层级", "display": "tree" },
+    { "title": "合同销售-个数", "field": "合同个数", "format": "value" },
+    { "title": "合同销售-金额", "field": "合同金额", "format": "huobi" }
+  ],
+  "layout": { "title": "江苏地区截止应收账款汇总表", "showLocation": "left", "freezeRows": 1, "freezeCols": 1 }
+}
+```
+
+## 三、能力边界（如实）
+
+1. **折叠按钮（▶/▼）由 `displayType=Tree` 引擎渲染**，API 侧只需树形字段+父格规则；`sheetConfig` 默认展开键名待确认回填。
+2. **多级行维度 / 多层列组**超出 build spec 表达力 → 走 rebuild 直构（`e10-cli report build` / `rebuild from-blueprint`），坐标模板见 §一。
+3. 树形列**必须**在数据源里有明确的上下级关系字段（自引用 pid 或 subordination 映射）；纯平铺字段强上 Tree 无层级效果。
+4. 渲染展开形态设计器确认为准（渲染接口取不到展开数据，crosstab guide §5.4）。
+
+## 四、搭建提示语句
+
+**案例 H（高阶交叉）**：
+
+> 按高阶交叉格式搭一张销售额等级分析：行维度三级「一级品类→二级品类→品牌」逐级缩进，
+> 每级带小计行，底部总计；列侧多指标组「销量对比/销售额/…」（组内 2014/2015/占比/合计）；
+> 环比列红绿条件色（`columns[].rule`）；数据源 `<sid>`（appId `<appId>`）；
+> 多级行维度+多列组走 rebuild 直构路径（crosstab + 本指南 §一坐标模板），落库后回读验收父格拓扑与 Formula 存活。
+
+**案例 I（折叠树）**：
+
+> 按折叠树格式搭一张地区应收汇总：左侧「组织层级」树形列（可收起展开，`display:"tree"`），
+> 列侧多层费用组（组内小计/已上线/未上线 → 个数/金额子列），底部合计行；
+> 数据源 `<sid>`（自包含层级；跨表层级给 subordination 映射），appId `<appId>`；
+> 冻结左 1 列+上方表头、居左；单源用 `build spec`、多源列组用 rebuild 直构，
+> 落库后回读验收：树形格 displayType=Tree 且左父格 -1,-1、冻结锚点唯一、check-ids 干净。
+
+## 五、验证清单
+
+1. 树形列回读：`displayType === 'Tree'`、`leftX/leftY === -1`、`isActiveParent === true`、`expandType === 'Vertical'`
+2. 案例 H：小计行 Formula 左父格=该级维度格；多列组子表头 Const 上父格→列维度格
+3. 条件色：`conditionRule.highlightDatas[]` 关系/颜色逐条回读
+4. 树形折叠表现、默认展开 = 设计器确认；验证后回填 sheetConfig 键名