weaver-e10-builder 1.6.15 → 1.6.16

package/skill-docs/references/report/expansion-block-parent-config-guide.md

@@ -1,208 +1,208 @@
-# 多独立扩展块（统计块）父格配置指南（SKILL A0.13 场景 A 细化 · BUILD-46/47/48）
-
-> **适用范围**：同一个 sheet 内存在「**主区 + 多个独立扩展块（统计块）**」——
-> 即需求文件里**多行数据源字段单元格**、上下放置多个独立报表 / 统计块时（场景 A）。
-> **判据**：`e10-cli report scene detect --req <需求文件>`（**不依赖关键词**，只看结构）。
->
-> **优先级**：本规则**优先级高于原有报表规则**，但**仅当识别命中时启用**；未命中 → **完全沿用原有报表逻辑**。
->
-> **CLI**：`e10-cli report scene check|apply --scene A` · **注意点**：`BUILD-48`（父格口径）/ `BUILD-46`（扩展带公式格）/ `BUILD-47`（常规格式）
-
----
-
-## 〇、一句话
-
-**公共父格只归集「块入口 + 标题/表头行」，数据格照旧跟随入口格 —— 父格链与公共父格是两层机制，禁止把公共父格泛化到数据格。**
-
----
-
-## 一、两类概念别混淆
-
-| 机制 | 作用 | 绑定对象 |
-|------|------|----------|
-| **公共父格**（`isActiveParent`） | 把同 sheet 内**多个独立扩展块**归集到同一 sheet，避免各块扩展互相串行/错位 | **块入口格** + **标题行 / 表头行整行 Const** |
-| **父格链**（`leftX/leftY`） | 让**数据格**跟随所在块的**入口格**（同行前一列）一起扩展 | 入口格**右侧的普通 Field 数据格**（保持默认链） |
-
-> ⚠ **泛化禁令**：**不得**把公共父格配置**泛化**到「入口格以右的数据格」。
-
----
-
-## 二、三类单元格口径（命中场景 A 后强制执行）
-
-凡同 sheet 存在「主区 + 多个独立扩展块」时，按**三类**处理：
-
-| 类 | 单元格 | 父格配置 | 形态 |
-|----|--------|----------|------|
-| ① **公共父格** | Sheet 左上角（如 `A1`），自定义文本（如「统计区」，文本可任意） | `left=(-1,-1)` + **`isActiveParent=true`** | `{ cellType:"Const", cellText:"统计区", leftX:-1, leftY:-1, isActiveParent:true }` |
-| ② **入口格 + 标题/表头行整行 Const** | 每带**入口格**（数据带第一格、合计带第一格 = 纵向扩展根）；每块**标题行 / 表头行整行 Const** | 左父格 = **公共父格** | `{ cellType:"Field", expandType:"Vertical", leftX:0, leftY:0 }`（绑 `(0,0)`） |
-| ③ **数据格** | 入口格**右侧**的普通 Field 格 | **保持默认链**（同行前一列），**不动** | `{ cellType:"Field", expandType:"NoExpand", leftX:<入口.x>, leftY:<入口前1列> }` |
-
-> 其余所有单元格的父格配置，**维持原有逻辑不变**（边界②）。
-
-### 2.1 判定纪律（★ 防交叉表误报）
-
-- 场景 A **只认纵向入口**：`Vertical` 且「是根（`left=-1,-1`）**或**已绑公共父格」。
-- **交叉表**的「列维表头」是 `Horizontal` —— **不算**独立报表入口（`entryLikeCells()`）。
-- 且**纵向入口必须分布在不同行**（`looksMultiReport()`）→ 才是「上下多个独立块」。
-- 幂等：入口格绑上公共父格后 `left` 不再是 `-1` → 判据同时接受「已绑公共父格的纵向格」，**重复 check 不会漏判**。
-
----
-
-## 三、合计行 / 总计行口径（易错）
-
-| 行 | 口径 |
-|----|------|
-| **合计行（按维度合计，如按学年/按部门）** | 该行**整行所有格**（标签 + Field + Formula）左父格**统一 = 维度字段所在格**（跟随维度扩展） |
-| **总计行** | **保持独立链**（挂自己的行标签）；**不**跟随维度扩展；公式**引用合计行** |
-
-> 症状：把「按维度合计」的合计行挂成公共父格 / 挂到入口格右侧数据格 → 合计不随维度展开或与明细错位。
-
----
-
-## 四、「常规」数字格式口径（BUILD-47）
-
-> **预览渲染吃 `style.formatter`，不是顶层 `formatterType`。**
-
-| 目标 | ✅ 正确 | ❌ 踩雷 |
-|------|--------|--------|
-| **常规** | `formatterType:["common"]` + **`style.formatter:"General"`** | `style.formatter:"common"` |
-| 货币 | `formatterType:["huobi"]` + `style.formatter:"\"￥\"#,##0.00_);[Red](\"￥\"#,##0.00)"` | `style.formatter:"huobi"` |
-
-- 构建器会把 `formatterType[0]`（短码）**透传**进 `style.formatter`；若 `style.formatter` 落成字面量 `common`，
-  SpreadJS 会把它**当数字格式串解释**（`m`=月份）→ 在 12 月预览显示成 **`co12on`**。
-- 写 `0.00` / `0.##` 功能正常，但设计器会归「**其他数字格式**」；用户要求「保持常规」时**一律用 `General` 口径**。
-- **格式调整范围以用户点名的单元格区域为准**，未点名区域**不顺手改**。
-
-```bash
-e10-cli report validate format --map "常规"                        # 自动纠正 + 告警
-e10-cli report validate format --inline '{"formatter":"common"}'   # 命中断码误写 → 纠正为 General/common
-```
-
----
-
-## 五、扩展数据带内公式格（BUILD-46）
-
-**规则**：扩展数据带内**公式格（Formula）的左父格必须直接挂「块入口格」**，**禁止链到前一列公式格**；
-否则扩展实例**引用解析错位** —— **预览第一行正常（或 `#DIV/0!`）、后续行渲染乱码**。
-
-| 项 | 硬要求 |
-|----|--------|
-| 左父格 | **直接挂块入口格**（入口格 = 数据带第一格）；**禁止**链公式格 → 公式格 |
-| `refX` / `refY` | 必须 **`-1`**（服务端对这两个键的 int **默认补 0**，回读常见 `0,0`，重建会**原样复制** → 后续行乱码） |
-| 落库后处理路径 | `wb.sheets[*].data.dataTable[行][列].style.cellType`（`typeName=FormulaCellType`）—— **不是** `cells` |
-| 自动兜底 | `buildWorkbookFromFields` 出口 + `saveReportDevInfoAuto` 的 500 防御层 **R7** 已自动归 -1 |
-| **行号规则** | 引用**带自身行** = `x+1`；**跨带引用** = **目标带** `x+1` |
-
-### 5.1 蓝图 diff 方法论（渲染异常时）
-
-> **禁止猜测**：与「用户认可的正常报表」`getReportDevInfo` 回读做**逐字段 diff**
-> （`left` / `refX` / `refY` / `style.formatter`），**实证定位**差异，再定点补丁。
-
-```bash
-e10-cli report formula parent check --report-id <rid> --app-id <appId>     # 只读，exit 3 = 不一致/链公式格/ref≠-1
-e10-cli report formula parent align --report-id <rid> --app-id <appId> [--apply]   # 对齐 + 顺带把 refX/refY 归 -1
-`e10-cli report verify all`
-```
-
----
-
-## 六、CLI
-
-```bash
-# 识别（恒 exit 0；不依赖关键词）
-e10-cli report scene rules
-e10-cli report scene detect --req <需求文件> [--json]
-
-# 体检（只读；exit 3 = 不合规）—— 三类口径 + 泛化禁令
-e10-cli report scene check --report-id <rid> --app-id <appId> --scene A [--json]
-# 离线定位：--dev-file <getReportDevInfo 的 data JSON>
-
-# 定点修复（默认 dry-run；--apply 才落库）
-e10-cli report scene apply --report-id <rid> --app-id <appId> --scene A \
-  [--at 0,0] [--text "统计区"] [--anchor "x,y;x,y"] [--header-cells "x,y;x,y"] [--apply]
-```
-
-- `--anchor` / `--header-cells`：
-  - `--anchor` 只接受**纵向入口格**（root 或已绑公共父格）与 **Const 标题/表头格**；
-    传**普通 Field 数据格**会被**拒绑**并告警（泛化禁令）；确需强绑加 `--force`。
-  - `--header-cells "x,y;x,y"`：一并把标题/表头行整行 Const 绑到公共父格。
-- 不给 `--anchor` → 自动取全部纵向入口格（幂等）。
-- 落库通道：`buildWorkbookFromFields`（A0.8 定点补丁）+ `saveReportDevInfoAuto`（BUILD-39/ENV-11 载荷自适应）+ BUILD-42 数据集 id 硬门禁；`--apply` 后自动回读校验。
-
----
-
-## 七、声明式（`build spec` 的 spec）
-
-```jsonc
-{
-  "columns": [ { "title": "序号", "cellType": "seq" }, { "title": "学院", "field": "学院" } ],
-  "scene": {
-    "publicParent": { "x": 0, "y": 0, "text": "统计区" },
-    "anchorCells": ["1,1", "5,1"],                 // 各独立块的入口格坐标
-    "headerCells": ["0,1", "4,1"]                  // 可选：标题/表头行整行 Const
-  }
-}
-```
-
-- `scene.publicParent` → 落库前在指定坐标插入（或复用）公共父格并置 `isActiveParent`。
-- `scene.anchorCells` → 列出的**入口格**左父格统一改到该坐标；**未列出的格一律不动**。
-- 不写 `scene` 段 → **完全不介入**（`applySceneDecl` 返回 null），原单块路径零影响。
-
----
-
-## 八、自检清单（交付前必过）
-
-- [ ] 是否先跑 `scene detect`？**不命中就不加任何特殊配置**（不要「顺手也加上」）。
-- [ ] 公共父格是否在 **Sheet 左上角**、`isActiveParent=true`、有自定义文本、`left=(-1,-1)`？
-- [ ] **入口格 + 标题/表头行整行 Const** 是否都绑了公共父格？
-- [ ] **入口格右侧的普通 Field 数据格**是否**保持默认链**（未被泛化绑公共父格）？（泛化禁令）
-- [ ] 纵向入口是否**分布在不同行**（非交叉表列维/行维）？单报表单数据源**未**加公共父格？
-- [ ] 合计行（按维度合计）是否整行挂**维度字段格**？总计行是否**独立链**、公式引用合计行？
-- [ ] 扩展带内 Formula 格左父格是否**直接挂块入口格**（非公式格）？`refX/refY` 是否 = `-1`？
-- [ ] 「常规」格式是否用 `style.formatter:"General"` + `formatterType:["common"]`（**未**写短码 `common`）？
-- [ ] 格式/父格调整是否**只动点名区域**？（未点名不顺手改）
-- [ ] `scene check --scene A` 是否 **PASS**（exit 0）？`formula parent check` 是否 PASS？`check-ids` 是否合规？
-
----
-
-## 九、相关文档
-
-| 文档 | 关系 |
-|------|------|
-| `SKILL.md` A0.13 / 执行优先级 0.46 | 硬规则正文 |
-| `branch-scene-guide.md` §二 | 场景 A 识别 + 判据纪律（本文是其**细化**） |
-| `formula-cell-api-guide.md` §七 | 公式格父格 / 上父格 / `refX·refY` |
-| `cell-config-echo-guide.md` §二 | 数字格式目录（「常规」= `General`/`common`） |
-| `pitfalls BUILD-46 / 47 / 48` | 扩展带公式格 / 常规格式 / 公共父格泛化 |
-| `datasource-selection-and-parent-filter-guide.md` §2.0 | 既有父格链铁律（A0.7），本规则**不替代**它 |
-
----
-
-## 十、环境归一化兼容 + 行首格自动归集（2026-10-29 · 验证 www.e-cology.com.cn）
-
-### 10.1 环境行为（保存后服务端自动做两件事）
-
-| 行为 | 表现 | 影响 |
-|------|------|------|
-| **坐标整体 +1,+1** | 蓝图 (x,y) → 回读 (x+1,y+1)；服务端在 (0,0) 自动插入一个 `Const "1"`（left=-1,-1） | 回读坐标 ≠ 搭建坐标，**父格绑定一律以回读坐标为准** |
-| **纵向根左父格归一化** | 锚点 `left=(-1,-1)` 被改为 `left=(0,0)`（指向自动插入的「1」格）；回读**不带 `isActiveParent` 键** | 旧判据 `entryLikeCells` 只认 `-1,-1` 或「已绑公共父格」→ 误判「0 入口格 → 场景 A 不适用」 |
-
-### 10.2 e10-cli report scene 三处补丁（本节 = 修复记录）
-
-1. **`findPublicParent` 放宽**：`(0,0)` 处 `Const` 且非纵向扩展即可当公共父格（键存在才要求 `isActiveParent`）；
-2. **`entryLikeCells` 追加一类入口**：纵向格 `left=(0,0)` 且 (0,0) 是 Const 非扩展格 → 视为「已绑」（幂等；**限定 (0,0)** 防误伤块内普通 Const 标签）；
-3. **`blockFirstConsts()` 新增（口径②自动归集）**：所有**行首格**（同行 y 最小）中 `left=(-1,-1)` 的 Const → apply 时统一绑公共父格。覆盖表头行首/合计带首/总计行首/摘要表头首/各块标题条（合并整行也是行首）；行内其余格已有默认链，不绑（泛化禁令不变）。Const 不扩展，绑公共父格只归集扩展上下文、不改变渲染。
-
-### 10.3 命令（幂等，可反复执行）
-
-```bash
-e10-cli report scene check --report-id <rid> --app-id <appId> --scene A   # exit 3 = 有行首格未归集
-e10-cli report scene apply --report-id <rid> --app-id <appId> --scene A --apply
-# 公共父格文本默认「1」（用户口径）；可用 --text "统计区" 覆盖；--header-cells "x,y;x,y" 手工追加
-```
-
-### 10.4 验证留证（chl业务专项统计 1331753785429704735）
-
-- 公共父格 (0,0)「1」+ 4 个块锚点（模块1行①/行②、模块2、摘要）已绑；
-- 13 个行首/标题条 Const（副题、4 条标题条、4 个表头首格、2 个合计行首、1 个总计行首、1 个口径条）统一绑 (0,0)；
-- apply 回读校验 unbound=[]；逐格核对 13/13 OK。
+# 多独立扩展块（统计块）父格配置指南（SKILL A0.13 场景 A 细化 · BUILD-46/47/48）
+
+> **适用范围**：同一个 sheet 内存在「**主区 + 多个独立扩展块（统计块）**」——
+> 即需求文件里**多行数据源字段单元格**、上下放置多个独立报表 / 统计块时（场景 A）。
+> **判据**：`e10-cli report scene detect --req <需求文件>`（**不依赖关键词**，只看结构）。
+>
+> **优先级**：本规则**优先级高于原有报表规则**，但**仅当识别命中时启用**；未命中 → **完全沿用原有报表逻辑**。
+>
+> **CLI**：`e10-cli report scene check|apply --scene A` · **注意点**：`BUILD-48`（父格口径）/ `BUILD-46`（扩展带公式格）/ `BUILD-47`（常规格式）
+
+---
+
+## 〇、一句话
+
+**公共父格只归集「块入口 + 标题/表头行」，数据格照旧跟随入口格 —— 父格链与公共父格是两层机制，禁止把公共父格泛化到数据格。**
+
+---
+
+## 一、两类概念别混淆
+
+| 机制 | 作用 | 绑定对象 |
+|------|------|----------|
+| **公共父格**（`isActiveParent`） | 把同 sheet 内**多个独立扩展块**归集到同一 sheet，避免各块扩展互相串行/错位 | **块入口格** + **标题行 / 表头行整行 Const** |
+| **父格链**（`leftX/leftY`） | 让**数据格**跟随所在块的**入口格**（同行前一列）一起扩展 | 入口格**右侧的普通 Field 数据格**（保持默认链） |
+
+> ⚠ **泛化禁令**：**不得**把公共父格配置**泛化**到「入口格以右的数据格」。
+
+---
+
+## 二、三类单元格口径（命中场景 A 后强制执行）
+
+凡同 sheet 存在「主区 + 多个独立扩展块」时，按**三类**处理：
+
+| 类 | 单元格 | 父格配置 | 形态 |
+|----|--------|----------|------|
+| ① **公共父格** | Sheet 左上角（如 `A1`），自定义文本（如「统计区」，文本可任意） | `left=(-1,-1)` + **`isActiveParent=true`** | `{ cellType:"Const", cellText:"统计区", leftX:-1, leftY:-1, isActiveParent:true }` |
+| ② **入口格 + 标题/表头行整行 Const** | 每带**入口格**（数据带第一格、合计带第一格 = 纵向扩展根）；每块**标题行 / 表头行整行 Const** | 左父格 = **公共父格** | `{ cellType:"Field", expandType:"Vertical", leftX:0, leftY:0 }`（绑 `(0,0)`） |
+| ③ **数据格** | 入口格**右侧**的普通 Field 格 | **保持默认链**（同行前一列），**不动** | `{ cellType:"Field", expandType:"NoExpand", leftX:<入口.x>, leftY:<入口前1列> }` |
+
+> 其余所有单元格的父格配置，**维持原有逻辑不变**（边界②）。
+
+### 2.1 判定纪律（★ 防交叉表误报）
+
+- 场景 A **只认纵向入口**：`Vertical` 且「是根（`left=-1,-1`）**或**已绑公共父格」。
+- **交叉表**的「列维表头」是 `Horizontal` —— **不算**独立报表入口（`entryLikeCells()`）。
+- 且**纵向入口必须分布在不同行**（`looksMultiReport()`）→ 才是「上下多个独立块」。
+- 幂等：入口格绑上公共父格后 `left` 不再是 `-1` → 判据同时接受「已绑公共父格的纵向格」，**重复 check 不会漏判**。
+
+---
+
+## 三、合计行 / 总计行口径（易错）
+
+| 行 | 口径 |
+|----|------|
+| **合计行（按维度合计，如按学年/按部门）** | 该行**整行所有格**（标签 + Field + Formula）左父格**统一 = 维度字段所在格**（跟随维度扩展） |
+| **总计行** | **保持独立链**（挂自己的行标签）；**不**跟随维度扩展；公式**引用合计行** |
+
+> 症状：把「按维度合计」的合计行挂成公共父格 / 挂到入口格右侧数据格 → 合计不随维度展开或与明细错位。
+
+---
+
+## 四、「常规」数字格式口径（BUILD-47）
+
+> **预览渲染吃 `style.formatter`，不是顶层 `formatterType`。**
+
+| 目标 | ✅ 正确 | ❌ 踩雷 |
+|------|--------|--------|
+| **常规** | `formatterType:["common"]` + **`style.formatter:"General"`** | `style.formatter:"common"` |
+| 货币 | `formatterType:["huobi"]` + `style.formatter:"\"￥\"#,##0.00_);[Red](\"￥\"#,##0.00)"` | `style.formatter:"huobi"` |
+
+- 构建器会把 `formatterType[0]`（短码）**透传**进 `style.formatter`；若 `style.formatter` 落成字面量 `common`，
+  SpreadJS 会把它**当数字格式串解释**（`m`=月份）→ 在 12 月预览显示成 **`co12on`**。
+- 写 `0.00` / `0.##` 功能正常，但设计器会归「**其他数字格式**」；用户要求「保持常规」时**一律用 `General` 口径**。
+- **格式调整范围以用户点名的单元格区域为准**，未点名区域**不顺手改**。
+
+```bash
+e10-cli report validate format --map "常规"                        # 自动纠正 + 告警
+e10-cli report validate format --inline '{"formatter":"common"}'   # 命中断码误写 → 纠正为 General/common
+```
+
+---
+
+## 五、扩展数据带内公式格（BUILD-46）
+
+**规则**：扩展数据带内**公式格（Formula）的左父格必须直接挂「块入口格」**，**禁止链到前一列公式格**；
+否则扩展实例**引用解析错位** —— **预览第一行正常（或 `#DIV/0!`）、后续行渲染乱码**。
+
+| 项 | 硬要求 |
+|----|--------|
+| 左父格 | **直接挂块入口格**（入口格 = 数据带第一格）；**禁止**链公式格 → 公式格 |
+| `refX` / `refY` | 必须 **`-1`**（服务端对这两个键的 int **默认补 0**，回读常见 `0,0`，重建会**原样复制** → 后续行乱码） |
+| 落库后处理路径 | `wb.sheets[*].data.dataTable[行][列].style.cellType`（`typeName=FormulaCellType`）—— **不是** `cells` |
+| 自动兜底 | `buildWorkbookFromFields` 出口 + `saveReportDevInfoAuto` 的 500 防御层 **R7** 已自动归 -1 |
+| **行号规则** | 引用**带自身行** = `x+1`；**跨带引用** = **目标带** `x+1` |
+
+### 5.1 蓝图 diff 方法论（渲染异常时）
+
+> **禁止猜测**：与「用户认可的正常报表」`getReportDevInfo` 回读做**逐字段 diff**
+> （`left` / `refX` / `refY` / `style.formatter`），**实证定位**差异，再定点补丁。
+
+```bash
+e10-cli report formula parent check --report-id <rid> --app-id <appId>     # 只读，exit 3 = 不一致/链公式格/ref≠-1
+e10-cli report formula parent align --report-id <rid> --app-id <appId> [--apply]   # 对齐 + 顺带把 refX/refY 归 -1
+`e10-cli report verify all`
+```
+
+---
+
+## 六、CLI
+
+```bash
+# 识别（恒 exit 0；不依赖关键词）
+e10-cli report scene rules
+e10-cli report scene detect --req <需求文件> [--json]
+
+# 体检（只读；exit 3 = 不合规）—— 三类口径 + 泛化禁令
+e10-cli report scene check --report-id <rid> --app-id <appId> --scene A [--json]
+# 离线定位：--dev-file <getReportDevInfo 的 data JSON>
+
+# 定点修复（默认 dry-run；--apply 才落库）
+e10-cli report scene apply --report-id <rid> --app-id <appId> --scene A \
+  [--at 0,0] [--text "统计区"] [--anchor "x,y;x,y"] [--header-cells "x,y;x,y"] [--apply]
+```
+
+- `--anchor` / `--header-cells`：
+  - `--anchor` 只接受**纵向入口格**（root 或已绑公共父格）与 **Const 标题/表头格**；
+    传**普通 Field 数据格**会被**拒绑**并告警（泛化禁令）；确需强绑加 `--force`。
+  - `--header-cells "x,y;x,y"`：一并把标题/表头行整行 Const 绑到公共父格。
+- 不给 `--anchor` → 自动取全部纵向入口格（幂等）。
+- 落库通道：`buildWorkbookFromFields`（A0.8 定点补丁）+ `saveReportDevInfoAuto`（BUILD-39/ENV-11 载荷自适应）+ BUILD-42 数据集 id 硬门禁；`--apply` 后自动回读校验。
+
+---
+
+## 七、声明式（`build spec` 的 spec）
+
+```jsonc
+{
+  "columns": [ { "title": "序号", "cellType": "seq" }, { "title": "学院", "field": "学院" } ],
+  "scene": {
+    "publicParent": { "x": 0, "y": 0, "text": "统计区" },
+    "anchorCells": ["1,1", "5,1"],                 // 各独立块的入口格坐标
+    "headerCells": ["0,1", "4,1"]                  // 可选：标题/表头行整行 Const
+  }
+}
+```
+
+- `scene.publicParent` → 落库前在指定坐标插入（或复用）公共父格并置 `isActiveParent`。
+- `scene.anchorCells` → 列出的**入口格**左父格统一改到该坐标；**未列出的格一律不动**。
+- 不写 `scene` 段 → **完全不介入**（`applySceneDecl` 返回 null），原单块路径零影响。
+
+---
+
+## 八、自检清单（交付前必过）
+
+- [ ] 是否先跑 `scene detect`？**不命中就不加任何特殊配置**（不要「顺手也加上」）。
+- [ ] 公共父格是否在 **Sheet 左上角**、`isActiveParent=true`、有自定义文本、`left=(-1,-1)`？
+- [ ] **入口格 + 标题/表头行整行 Const** 是否都绑了公共父格？
+- [ ] **入口格右侧的普通 Field 数据格**是否**保持默认链**（未被泛化绑公共父格）？（泛化禁令）
+- [ ] 纵向入口是否**分布在不同行**（非交叉表列维/行维）？单报表单数据源**未**加公共父格？
+- [ ] 合计行（按维度合计）是否整行挂**维度字段格**？总计行是否**独立链**、公式引用合计行？
+- [ ] 扩展带内 Formula 格左父格是否**直接挂块入口格**（非公式格）？`refX/refY` 是否 = `-1`？
+- [ ] 「常规」格式是否用 `style.formatter:"General"` + `formatterType:["common"]`（**未**写短码 `common`）？
+- [ ] 格式/父格调整是否**只动点名区域**？（未点名不顺手改）
+- [ ] `scene check --scene A` 是否 **PASS**（exit 0）？`formula parent check` 是否 PASS？`check-ids` 是否合规？
+
+---
+
+## 九、相关文档
+
+| 文档 | 关系 |
+|------|------|
+| `SKILL.md` A0.13 / 执行优先级 0.46 | 硬规则正文 |
+| `branch-scene-guide.md` §二 | 场景 A 识别 + 判据纪律（本文是其**细化**） |
+| `formula-cell-api-guide.md` §七 | 公式格父格 / 上父格 / `refX·refY` |
+| `cell-config-echo-guide.md` §二 | 数字格式目录（「常规」= `General`/`common`） |
+| `pitfalls BUILD-46 / 47 / 48` | 扩展带公式格 / 常规格式 / 公共父格泛化 |
+| `datasource-selection-and-parent-filter-guide.md` §2.0 | 既有父格链铁律（A0.7），本规则**不替代**它 |
+
+---
+
+## 十、环境归一化兼容 + 行首格自动归集（2026-10-29 · 验证 www.e-cology.com.cn）
+
+### 10.1 环境行为（保存后服务端自动做两件事）
+
+| 行为 | 表现 | 影响 |
+|------|------|------|
+| **坐标整体 +1,+1** | 蓝图 (x,y) → 回读 (x+1,y+1)；服务端在 (0,0) 自动插入一个 `Const "1"`（left=-1,-1） | 回读坐标 ≠ 搭建坐标，**父格绑定一律以回读坐标为准** |
+| **纵向根左父格归一化** | 锚点 `left=(-1,-1)` 被改为 `left=(0,0)`（指向自动插入的「1」格）；回读**不带 `isActiveParent` 键** | 旧判据 `entryLikeCells` 只认 `-1,-1` 或「已绑公共父格」→ 误判「0 入口格 → 场景 A 不适用」 |
+
+### 10.2 e10-cli report scene 三处补丁（本节 = 修复记录）
+
+1. **`findPublicParent` 放宽**：`(0,0)` 处 `Const` 且非纵向扩展即可当公共父格（键存在才要求 `isActiveParent`）；
+2. **`entryLikeCells` 追加一类入口**：纵向格 `left=(0,0)` 且 (0,0) 是 Const 非扩展格 → 视为「已绑」（幂等；**限定 (0,0)** 防误伤块内普通 Const 标签）；
+3. **`blockFirstConsts()` 新增（口径②自动归集）**：所有**行首格**（同行 y 最小）中 `left=(-1,-1)` 的 Const → apply 时统一绑公共父格。覆盖表头行首/合计带首/总计行首/摘要表头首/各块标题条（合并整行也是行首）；行内其余格已有默认链，不绑（泛化禁令不变）。Const 不扩展，绑公共父格只归集扩展上下文、不改变渲染。
+
+### 10.3 命令（幂等，可反复执行）
+
+```bash
+e10-cli report scene check --report-id <rid> --app-id <appId> --scene A   # exit 3 = 有行首格未归集
+e10-cli report scene apply --report-id <rid> --app-id <appId> --scene A --apply
+# 公共父格文本默认「1」（用户口径）；可用 --text "统计区" 覆盖；--header-cells "x,y;x,y" 手工追加
+```
+
+### 10.4 验证留证（chl业务专项统计 1331753785429704735）
+
+- 公共父格 (0,0)「1」+ 4 个块锚点（模块1行①/行②、模块2、摘要）已绑；
+- 13 个行首/标题条 Const（副题、4 条标题条、4 个表头首格、2 个合计行首、1 个总计行首、1 个口径条）统一绑 (0,0)；
+- apply 回读校验 unbound=[]；逐格核对 13/13 OK。