weaver-e10-builder 1.6.9 → 1.6.11

package/skill-docs/references/report/report-permission-guide.md

@@ -12,20 +12,20 @@
 
 ```mermaid
 flowchart TB
- subgraph dialog["报表权限弹窗"]
- U["使用范围 Tab"]
- D["禁用范围 Tab"]
- end
- subgraph sub["各 Tab 下"]
- G["通用 — shareBrowser 对象列表"]
- M["矩阵相关 — 引用矩阵表 / e-Builder 表单"]
- end
- U --> G
- U --> M
- D --> G
- D --> M
- G --> API1["table/list/new + savePermissions.viewRight / disableRight"]
- M --> API2["matrix/list + savePermissions.viewMatrixRight / matrix/save"]
+  subgraph dialog["报表权限弹窗"]
+    U["使用范围 Tab"]
+    D["禁用范围 Tab"]
+  end
+  subgraph sub["各 Tab 下"]
+    G["通用 — shareBrowser 对象列表"]
+    M["矩阵相关 — 引用矩阵表 / e-Builder 表单"]
+  end
+  U --> G
+  U --> M
+  D --> G
+  D --> M
+  G --> API1["table/list/new + savePermissions.viewRight / disableRight"]
+  M --> API2["matrix/list + savePermissions.viewMatrixRight / matrix/save"]
 ```
 
 | UI 区域 | 读接口 | 写接口 | 说明 |
@@ -39,7 +39,7 @@ flowchart TB
 
 ```
 可查看 = (后台查看 ∨ 前台查看 ∨ 使用矩阵 ∨ 使用权限组)
- ∧ ¬(禁用通用 ∨ 禁用矩阵 ∨ 禁用权限组)
+      ∧ ¬(禁用通用 ∨ 禁用矩阵 ∨ 禁用权限组)
 ```
 
 ---
@@ -65,17 +65,16 @@ flowchart TB
 | UI 名称 | objType | obj_id 字段 | _entityType | targetType | targetId | 备注 |
 |---------|---------|-------------|-------------|------------|----------|------|
 | 人员 | `resource` | `obj_id` | `resource` | `1` | 人员 ID | 可加 `user_type`（1 当前人员…） |
-| 部门 | `department` | `obj_id_department` | `dept` | `2` | 部门 ID | Live `本地工作目录` |
 | 分部 | `subcompany` | `obj_id_subcompany` | `subcompany` | `4` | 分部 ID | 可加 `department_attribute` |
 | 角色 | `role` | `obj_id_role` | `role` | **`10`** | 角色 ID | 可加 `role_level`（0 总部/1 分部/2 部门） |
 | 群组 | `channel` | `obj_id_channel` | `channel` | **`14`** | 群组 ID | UI 称「群组」，浏览器为 `hrm/.../channel`；非 `group`/`targetType:5` |
 | 群组 | ~~`group`~~ | ~~`obj_id_group`~~ | — | ~~5~~ | — | **勿用**：`5` 会被存成分部 |
 | 岗位 | `position` | `obj_id_position` | `position` | `6` | 岗位 ID | 可加 `position_level` 等 |
-| 所有人 | `all` | （无） | `all` | `11` | `0` | Live copy 脚本 |
+| 所有人 | `all` | （无） | `all` | `11` | `0` | Live 验证 copy 脚本 |
 | 外部联系人 | `external` | `obj_id_external` | `external` | `7` | 外部人 ID | 须 browser 查真实 ID |
 | 所有外部人 | `allExternal` | （无） | `allExternal` | `12` | `0` | 无对象选择框 |
 
-> **targetType 判断依据**（`edc_report_ph_report_view` 的 `org_config.typeEnum`，weaver-edcreportd SQL）：
+> **targetType 金标准**（`edc_report_ph_report_view` 的 `org_config.typeEnum`，weaver-edcreportd SQL）：
 > 人员 `1|17` · 部门 `2|3|4|…` · 分部 `5|6|7|…` · **角色 `10`** · **群组(channel) `14|1411`** · 岗位 `12|13|…` · 外部 `110` · 所有人 `11`
 > 写入前务必 `table/list/new` 回读；**禁止**把角色写成 `targetType:3`、群组写成 `targetType:5`（会分别落库为部门/分部）。
 > **安全级别**：通用项均可带 `seclevel: {"min": -999, "max": 999}`（UI「安全级别」列）。
@@ -87,12 +86,12 @@ POST /api/bs/edc/report/permission/table/list/new
 Content-Type: application/json
 
 {
- "permissionId": "report_view",
- "id": "<reportId>",
- "current": 1,
- "pageSize": 50,
- "permissionType": 1,
- "params": { "appId": "<appId>" }
+  "permissionId": "report_view",
+  "id": "<reportId>",
+  "current": 1,
+  "pageSize": 50,
+  "permissionType": 1,
+  "params": { "appId": "<appId>" }
 }
 ```
 
@@ -106,11 +105,11 @@ Content-Type: application/json
 
 ```json
 {
- "<reportId>": {
- "viewRight": [ /* permissionType: 1 的 shareBrowser 行 */ ],
- "disableRight": [ /* permissionType: -1 的 shareBrowser 行 */ ],
- "viewMatrixRight": [ /* 使用范围 · 矩阵行，见 §四 */ ]
- }
+  "<reportId>": {
+    "viewRight": [ /* permissionType: 1 的 shareBrowser 行 */ ],
+    "disableRight": [ /* permissionType: -1 的 shareBrowser 行 */ ],
+    "viewMatrixRight": [ /* 使用范围 · 矩阵行，见 §四 */ ]
+  }
 }
 ```
 
@@ -136,41 +135,39 @@ Content-Type: application/json
 
 ```json
 {
- "sourceId": "<reportId>",
- "permissionId": "report_view",
- "permissionType": 1,
- "targetType": 11,
- "targetId": 0,
- "sourceType": 1,
- "objType": "all",
- "objTypeSpan": "所有人",
- "_entityType": "all",
- "obj_id_all": [{ "content": "所有人", "icon": "Icon-all02", "id": "0" }],
- "obj_id_span": "所有人",
- "objIdList": ["所有人"],
- "seclevel": { "min": -999, "max": 999 },
- "shareKey": "tmp_all_0_abc123"
+  "sourceId": "<reportId>",
+  "permissionId": "report_view",
+  "permissionType": 1,
+  "targetType": 11,
+  "targetId": 0,
+  "sourceType": 1,
+  "objType": "all",
+  "objTypeSpan": "所有人",
+  "_entityType": "all",
+  "obj_id_all": [{ "content": "所有人", "icon": "Icon-all02", "id": "0" }],
+  "obj_id_span": "所有人",
+  "objIdList": ["所有人"],
+  "seclevel": { "min": -999, "max": 999 },
+  "shareKey": "tmp_all_0_abc123"
 }
 ```
 
-**部门（使用范围）** — 见 `本地工作目录`：
-
 ```json
 {
- "sourceId": "<reportId>",
- "permissionId": "report_view",
- "permissionType": 1,
- "targetType": 2,
- "targetId": "<deptId>",
- "sourceType": 1,
- "objType": "department",
- "objTypeSpan": "部门",
- "_entityType": "dept",
- "obj_id_department": [{ "id": "<deptId>", "name": "总经办", "content": "总经办", "title": "总经办" }],
- "obj_id_span": "总经办",
- "objIdList": ["总经办"],
- "seclevel": { "min": -999, "max": 999 },
- "shareKey": "tmp_dept_<deptId>_abc123"
+  "sourceId": "<reportId>",
+  "permissionId": "report_view",
+  "permissionType": 1,
+  "targetType": 2,
+  "targetId": "<deptId>",
+  "sourceType": 1,
+  "objType": "department",
+  "objTypeSpan": "部门",
+  "_entityType": "dept",
+  "obj_id_department": [{ "id": "<deptId>", "name": "总经办", "content": "总经办", "title": "总经办" }],
+  "obj_id_span": "总经办",
+  "objIdList": ["总经办"],
+  "seclevel": { "min": -999, "max": 999 },
+  "shareKey": "tmp_dept_<deptId>_abc123"
 }
 ```
 
@@ -186,7 +183,7 @@ Content-Type: application/json
 | 部门 | `POST /api/workflow/pathdef/common/browser/complete/department` | body 含 `searchValue` |
 | 角色 | `POST /api/hrm/common/browser/complete/role` | body 含 `searchValue` |
 | **群组** | **`POST /api/hrm/common/browser/data/channel`** | **勿用** `/.../group`（返回 browser not found）；UI 称群组，API 类型为 `channel` |
-| 分部/岗位 | 设计器 shareBrowser 实际请求为准 | 报表弹窗 browser 常仅注册 resource/role/department/subcompany |
+| 分部/岗位 | 设计器 shareBrowser 接口返回为准 | 报表弹窗 browser 常仅注册 resource/role/department/subcompany |
 
 **Live 示例**（eteams · 进销存应用）：
 
@@ -205,7 +202,7 @@ UI：**引用矩阵表**（矩阵表 / e-Builder 表单）→ **条件** → **
 
 | 字段 | 说明 |
 |------|------|
-| `selectedType` | 组织/矩阵类型，传入 `OrgType.valueOf(...)`（如矩阵表、e-Builder 表单，**实际请求为准**） |
+| `selectedType` | 组织/矩阵类型，传入 `OrgType.valueOf(...)`（如矩阵表、e-Builder 表单，**接口返回为准**） |
 | `dataId` | JSON 字符串，矩阵/表单引用，如 `[{"id":"<matrixOrFormId>","name":"..."}]` |
 | `matrixConditionData` | 矩阵值**条件**（平台矩阵条件 DSL，JSON 字符串） |
 | `matrixValueRelation` | 矩阵值**关系/取值字段**映射（JSON 字符串） |
@@ -230,22 +227,22 @@ POST /api/bs/edc/report/permission/matrix/list
 
 ```json
 {
- "<reportId>": {
- "viewRight": [],
- "disableRight": [],
- "viewMatrixRight": [
- {
- "id": "tmp_matrix_001",
- "targetId": "<reportId>",
- "selectedType": "<OrgType枚举名>",
- "dataId": "[{\"id\":\"<matrixId>\",\"name\":\"矩阵表名\"}]",
- "matrixConditionData": "<条件JSON字符串>",
- "matrixValueRelation": "<取值字段JSON字符串>",
- "rightsType": "1",
- "rightsName": "矩阵权限说明"
- }
- ]
- }
+  "<reportId>": {
+    "viewRight": [],
+    "disableRight": [],
+    "viewMatrixRight": [
+      {
+        "id": "tmp_matrix_001",
+        "targetId": "<reportId>",
+        "selectedType": "<OrgType枚举名>",
+        "dataId": "[{\"id\":\"<matrixId>\",\"name\":\"矩阵表名\"}]",
+        "matrixConditionData": "<条件JSON字符串>",
+        "matrixValueRelation": "<取值字段JSON字符串>",
+        "rightsType": "1",
+        "rightsName": "矩阵权限说明"
+      }
+    ]
+  }
 }
 ```
 
@@ -260,19 +257,19 @@ POST /api/bs/edc/report/permission/matrix/save
 Content-Type: application/json
 
 [
- {
- "id": "tmp_disable_matrix_001",
- "targetId": "<reportId>",
- "selectedType": "<OrgType>",
- "dataId": "[{...}]",
- "matrixConditionData": "...",
- "matrixValueRelation": "...",
- "rightsType": "-1"
- }
+  {
+    "id": "tmp_disable_matrix_001",
+    "targetId": "<reportId>",
+    "selectedType": "<OrgType>",
+    "dataId": "[{...}]",
+    "matrixConditionData": "...",
+    "matrixValueRelation": "...",
+    "rightsType": "-1"
+  }
 ]
 ```
 
-> **矩阵字段 JSON 结构**因「矩阵表 vs e-Builder 表单」及租户配置而异，**必须以设计器 Network 实际请求为准**；Skill 禁止臆造 `matrixConditionData` / `matrixValueRelation` 内部键名。
+> **矩阵字段 JSON 结构**因「矩阵表 vs e-Builder 表单」及租户配置而异，**必须以设计器 Network 接口返回为金标准**；Skill 禁止臆造 `matrixConditionData` / `matrixValueRelation` 内部键名。
 
 ---
 
@@ -287,12 +284,12 @@ Content-Type: application/json
 
 | 能力 | Node | Python |
 |------|------|--------|
-| 复制 + 所有人 + 加菜单 | `report_lifecycle.js` | `copy_sheet` / `save_permissions` / `add_report_to_menu` |
-| **任意使用范围** | **`set_report_view_scope.js`** | `build_share_entry` + `save_permissions` |
-| 存为新版本 | `save_as_version.js`（`--list-only` 只读） | `save_as_version()` |
+| 复制 + 所有人 + 加菜单 | `e10-cli report lifecycle` | `copy_sheet` / `save_permissions` / `add_report_to_menu` |
+| **任意使用范围** | **`e10-cli report scope`** | `build_share_entry` + `save_permissions` |
+| 存为新版本 | `e10-cli report version`（`--list-only` 只读） | `save_as_version()` |
 | 构建 share 行 | — | `ReportApiClient.build_share_entry()`（`group`→`channel`） |
 | 列表/矩阵读 | — | `list_permission_table` / `list_matrix_rights` |
-| **矩阵增删 CLI** | **`report_list_ops.js` / `e10-cli report scope matrix`** | `delete_use_matrix_by_replace` / `soft_delete_matrix_row` / `save_matrix_rights` |
+| **矩阵增删 CLI** | **`e10-cli report group` / `e10-cli report scope matrix`** | `delete_use_matrix_by_replace` / `soft_delete_matrix_row` / `save_matrix_rights` |
 
 **Node — 矩阵列表 / 添加 / 删除**：
 
@@ -302,17 +299,17 @@ e10-cli report scope matrix save --app-id <appId> --report-id <id> --file matrix
 e10-cli report scope matrix delete --app-id <appId> --report-id <id> --matrix-id <mid> --type 1
 ```
 
-> 使用矩阵删除走 `savePermissions` 全量替换剩余行；禁用矩阵删除走 `matrix/save` + `deleteType:1`。条件 DSL 须实际请求，见 §4.2/4.3。
+> 使用矩阵删除走 `savePermissions` 全量替换剩余行；禁用矩阵删除走 `matrix/save` + `deleteType:1`。条件 DSL 须接口返回，见 §4.2/4.3。
 > 列表页分组/移动/转移见 **`report-list-page-ops-guide.md`**。
 
 **Node — 角色 + 群组使用范围**：
 
 ```bash
-node e10-cli report scope set \
- --host https://<your-e10-host> \
- --app-id <your-app-id> \
- --report-id 1310967397636390912 \
- --scope "role:eb分权管理员,channel:测试-zc0813"
+e10-cli report scope \
+  --host https://<your-e10-host> \
+  --app-id <your-app-id> \
+  --report-id 1310967397636390912 \
+  --scope "role:eb分权管理员,channel:测试-zc0813"
 ```
 
 **Python 示例**：
@@ -323,11 +320,11 @@ from report_api_client import ReportApiClient
 client = ReportApiClient(...)
 rid = "1310967397636390912"
 client.save_permissions(rid, {
- "viewRight": [client.build_share_entry("all", report_id=rid)],
- "disableRight": [client.build_share_entry("department", "123", "总经办", report_id=rid, permission_type=-1)],
- "viewMatrixRight": [],
+    "viewRight": [client.build_share_entry("all", report_id=rid)],
+    "disableRight": [client.build_share_entry("department", "123", "总经办", report_id=rid, permission_type=-1)],
+    "viewMatrixRight": [],
 })
-client.list_permission_table(rid, "report_view", permission_type=-1) # 回读禁用范围
+client.list_permission_table(rid, "report_view", permission_type=-1)  # 回读禁用范围
 ```
 
 ---
@@ -353,7 +350,7 @@ client.list_permission_table(rid, "report_view", permission_type=-1) # 回读禁
 | 群组写成 `targetType:5` 或 `objType:group` | 落库成**分部** | 群组 = **`channel` + targetType `14`** |
 | 搜群组用 `/browser/.../group` | browser not found | 改用 **`/hrm/.../data/channel`** |
 | 部门 targetType 写成 3 | 与角色混淆 | 部门 = **`2`** |
-| 权限 ID 末位漂移 | JS JSON.parse | 用 `json_snowflake.js` / `json_snowflake.py` |
+| 权限 ID 末位漂移 | JS JSON.parse | 用 `` / `` |
 | savePermissions 后旧行还在 | 误解为增量 | 接口为**全量替换**，需提交完整 viewRight/disableRight |
 
 ---

package/skill-docs/references/report/report-requirement-analysis-template.md

@@ -1,6 +1,6 @@
 # 报表需求分析交付规范（仅用户要「分析」时必做）
 
-> **冷启动禁止通读（纯搭表）**：见 `cold-start-scan-guide.md`。
+> **冷启动禁止通读（纯搭表）**：见 `api-report-build-fast-path.md`。
 > **适用范围**：凡用户**明确要求**「需求分析」「报表需求分析」「根据效果图/截图分析」「报表搭建指导 / 图示」时，按本规范输出完整分析 + **报表搭建图示**。
 > **不适用**：用户只要「搭建 / 创建报表 / 生成报表」—— **跳过本模板**，直接走 `api-report-build-fast-path.md` + `report-delivery-contract.md` **模式 A**（交设计器地址即结束）。
 > **HTML 手册**：非强制；仅用户点名要 HTML/指导文档时才 `build_guide_html.py`。
@@ -9,6 +9,31 @@
 
 ---
 
+## 〇、场景识别（**先判定，再套配置** · SKILL A0.13）
+
+> 本节规则**优先级高于原有报表规则**，但**仅在识别命中时启用**；
+> **不满足识别条件的普通需求 → 完全沿用原有报表逻辑**，不执行任何特殊配置。
+
+**识别方式**：解析需求文件**内容结构**（**不依赖关键词**）—— `e10-cli report scene detect --req <需求文件>`。
+
+| 场景 | 识别条件（结构特征） | 命中后的强制配置（分析报告必须写明） |
+|------|---------------------|-----------------------------------|
+| **A · 同 sheet 多报表** | 同一个 sheet 存在**多行数据源字段单元格** → 上下放置多个独立报表 | ① Sheet 左上角**公共父格**（自定义文本 + `isActiveParent`）；② 各独立报表的**扩展父格**左父格**统一绑定**它；③ 其余格父格**维持不变** |
+| **B · 自增序号** | 单元格标注**【自增序号单元格】** | 统一用系统序号 `{seq}`（`SequenceNumber` · **纵向扩展**）；**禁止**公式生成序号 |
+| **C · 单元格跳转 Sheet 页** | 需求描述含「**点击跳转sheetX / 点击可跳转到sheetX**」 | 当前格加**点击跳转事件**：`pcHreflink` = 报表预览页 `/sp/edc/report/view/<reportId>` + **`sheetIndex=<N-1>`**（sheet1→0，**从 0 起**）；打开方式默认**弹出页** `openType="blank"` |
+
+**识别边界（防过度触发）**：① 仅**同一 sheet 多组独立数据源字段**才算多报表，**单报表单数据源 sheet 不加公共父格**；
+② 公共父格**只**做本 sheet 多报表的父格归集，**不改**单报表内部原有左父格；③ 只有**明确标注**「自增序号单元格」才用 `{seq}`，
+**普通序号 / 手工编号不触发**；④ 跳转 Sheet **仅当**出现「点击跳转sheetX」这类描述才触发，`sheetIndex` **从 0 起**计数。
+
+**判据纪律**：交叉表的「列维表头」(`Horizontal`) 与「行维入口」(`Vertical`) 属**同一矩阵**，
+**不是**两个独立报表 —— 场景 A 只认**纵向扩展根**，且必须**分布在不同行**。
+
+> 分析报告请**单独列出「场景识别」小节**：命中场景 / 结构证据（数据区数、标注位置、跳转描述）/ 对应强制配置 / 未命中则写明「沿用原有规则」。
+> 细则：`branch-scene-guide.md` · `expansion-block-parent-config-guide.md`（场景 A 细化：三类单元格口径/泛化禁令）；注意点 `BUILD-43` / `BUILD-44` / `BUILD-45` / `BUILD-46` / `BUILD-47` / `BUILD-48`。
+
+---
+
 ## 一、交付清单（缺一不可）
 
 每次报表需求分析必须包含以下 **8 个章节**（顺序固定）：
@@ -44,7 +69,6 @@
 
 **父格**：单数据集且无指定计算时填 **默认**（见 `datasource-selection-and-parent-filter-guide.md` §〇）；勿臆造自定义坐标链。
 
-
 **显示方式**：`列表` · `分组` · `排列` · `汇总` · `隐藏`
 
 **汇总方式**：`—` · `sum` · `count` · `distinctcount` · `avg` · `max` · `min`
@@ -92,23 +116,23 @@
 
 ```text
 ┌─────────────────────────────────────────────────────────────┐
-│ {报表名称} │
+│  {报表名称}                                                  │
 ├─────────────────────────────────────────────────────────────┤
-│ [查询条件区] [搜索] [重置] [导出] [打印] [更多] │
+│  [查询条件区]  [搜索] [重置]              [导出] [打印] [更多] │
 ├─────────────────────────────────────────────────────────────┤
-│ 报表 Sheet 工作区 │
+│                    报表 Sheet 工作区                          │
 └─────────────────────────────────────────────────────────────┘
 ```
 
 ### 5.2 网格与表头合并（R1/R2/R3）
 
 ```text
- A B C …
-R1 ┌─────────┬──────────────── 分组标题1 ────────────────┬──────── 分组标题2 ────────┐
-R2 │ 列名A │ 列名B │ 列名C │ …
-R3 │ ★行基格 │ 指标B │ 指标C │ … ← 数据区起点，行基格纵向扩展
- │ 维度值1 │ … │ … │
- │ 维度值2 │ … │ … │
+        A          B        C        …
+R1  ┌─────────┬──────────────── 分组标题1 ────────────────┬──────── 分组标题2 ────────┐
+R2  │ 列名A   │ 列名B   │ 列名C   │ …
+R3  │ ★行基格 │ 指标B   │ 指标C   │ …   ← 数据区起点，行基格纵向扩展
+    │ 维度值1 │  …      │  …      │
+    │ 维度值2 │  …      │  …      │
 ```
 
 - 标注 **★ 行基格** 坐标（如 A3）
@@ -119,41 +143,41 @@ R3 │ ★行基格 │ 指标B │ 指标C │ … ← 数据区起点，行基
 
 ```mermaid
 flowchart TB
- A3["A3 行基格<br/>纵向扩展"]
- B3["B3 指标列<br/>左父格→A3<br/>纵向+汇总"]
- E3["E3 公式列<br/>左父格→A3<br/>不扩展"]
- A3 --> B3
- A3 --> E3
+    A3["A3 行基格<br/>纵向扩展"]
+    B3["B3 指标列<br/>左父格→A3<br/>纵向+汇总"]
+    E3["E3 公式列<br/>左父格→A3<br/>不扩展"]
+    A3 --> B3
+    A3 --> E3
 ```
 
 ### 5.4 数据集挂载关系
 
 ```mermaid
 flowchart LR
- Q[查询条件] --> DS1[(数据集1)]
- Q --> DS2[(数据集2)]
- DS1 --> C1[列 B~J]
- DS2 --> C2[列 K~S]
- DS2 -.leftFilterField.-> DS1
+    Q[查询条件] --> DS1[(数据集1)]
+    Q --> DS2[(数据集2)]
+    DS1 --> C1[列 B~J]
+    DS2 --> C2[列 K~S]
+    DS2 -.leftFilterField.-> DS1
 ```
 
 ### 5.5 列级筛选叠加示意（可选，多口径报表建议画）
 
 ```text
- [datasetFilter 全局] + [列 customFilter 时间/新客/伙伴] + [父格筛选 跨表关联]
+  [datasetFilter 全局]  +  [列 customFilter 时间/新客/伙伴]  +  [父格筛选 跨表关联]
 ```
 
 ### 5.6 Sheet1 式单元格配置示例（R3 任选一列展示 6 项）
 
 ```text
 ┌──────────────────────────────────────────┐
-│ D3 当前月份新客户伙伴签合同数量 │
+│ D3 当前月份新客户伙伴签合同数量            │
 ├──────────────────────────────────────────┤
-│ 字段： 合同业绩表.合同号 │
-│ 父格： A3（大区/专项） │
-│ 显示方式： 汇总 │
-│ 扩展方向： 纵向扩展 │
-│ 父格筛选： -（同数据集无） │
+│ 字段：     合同业绩表.合同号               │
+│ 父格：     A3（大区/专项）                 │
+│ 显示方式： 汇总                            │
+│ 扩展方向： 纵向扩展                        │
+│ 父格筛选： -（同数据集无）                 │
 │ 自定义筛选：业绩年月=当月 AND 新客 AND 伙伴签 │
 └──────────────────────────────────────────┘
 ```
@@ -185,7 +209,6 @@ API 写入约束见 `formula-cell-api-guide.md`（cellText 无前导 `=`）。
 
 ## 八、完整示例索引
 
-- **EBU 37 列分组表**：`本地工作目录` + `outputs/新版需求-EBU经营数据统计_字段映射.json`
 - **新客户伙伴签约 19 列**：对话示例「2026-06 新客户伙伴签约统计报表」需求分析（A~S 列、双分组表头）
 
 ---
@@ -200,3 +223,44 @@ API 写入约束见 `formula-cell-api-guide.md`（cellText 无前导 `=`）。
 - [ ] 公式列是否标注「不扩展」与除零规则？
 - [ ] 三类筛选是否分工清晰、无重复？
 - [ ] 是否列出 **待业务确认项**？
+
+---
+
+## 十、需求文件解析（Excel 合并单元格 · 逐格勾稽）
+
+> **报表结构以需求文件为准逐格还原**：标题跨度、纵向/横向合并、行列数——**禁止凭目测**。
+
+### 10.1 xlrd `merged_cells` 为**半开区间**
+
+用 `xlrd` 解析 `.xls`（`formatting_info=True` 才带合并信息）：
+
+```python
+import xlrd
+wb = xlrd.open_workbook(path, formatting_info=True)   # ★ 必须 formatting_info=True，否则 merged_cells 为空
+sh = wb.sheet_by_index(0)
+for (r1, r2, c1, c2) in sh.merged_cells:              # ★ 半开区间 [r1,r2) × [c1,c2)
+    rows = r2 - r1          # 跨行数 = r2 − r1（不是 r2 − r1 + 1）
+    cols = c2 - c1          # 跨列数 = c2 − c1
+    # 合并左上角 = (r1, c1)
+```
+
+| 易错点 | 正解 |
+|--------|------|
+| 跨行/跨列数 | **`r2 − r1`** / **`c2 − c1`**（半开区间，**不要 +1**） |
+| 不开 `formatting_info` | `merged_cells` **恒为空** → 表头合并全丢 |
+| 行列基准 | xlrd 行列均 **0 基**；落到报表 `style.cellType.x/y` 也 0 基 |
+
+### 10.2 逐格严格比对 + 回读勾稽
+
+1. **搭之前**：把需求文件的**每一处合并区间**（含表头逐格）记录成清单（标题跨度、纵向/横向合并、行列数）。
+2. **搭之后**：用 `getReportDevInfo` 回读，把 `xCount/yCount`（合并跨度）与需求清单**逐条勾稽**，
+   任何一处不一致即视为未还原（`dump cells` 可回看每格 `xCount/yCount`）。
+
+---
+
+## 十一、多独立扩展块（统计块）需求识别（SKILL A0.13 场景 A 细化）
+
+需求文件里**多行数据源字段单元格**、上下放置多个独立统计块时 → 命中 **场景 A**（见 §〇）。
+分析报告须写明：**公共父格 + 三类单元格口径**（入口格/标题·表头行整行 Const 绑公共父格；数据格保持默认链）、
+**合计行按维度合计 / 总计行独立链**、**扩展带公式格父格**。
+> 细则：`expansion-block-parent-config-guide.md`；注意点 `BUILD-46/47/48`。