weaver-work-cli 0.1.24 → 0.1.26

package/skills/weaver-e10-builder/references/report/cross-dataset-filter-guide.md

@@ -0,0 +1,304 @@
+# 跨数据集筛选配置指南（左父格筛选 & 自定义筛选）
+
+> **适用场景**：单元格字段与左/上父格字段来自不同数据集；或单元格需按固定条件过滤（如核算机构排除、年度参数）。
+>
+> **已验证平台**：e-Builder EDC 报表设计器（2026-08，EBU 经营数据统计报表 `1304979556231593985`）。
+>
+> **与「左侧数据集筛选」区分**：整表/行级预过滤走 **`queryInfoSave`**（`conditionData`），见 **`dataset-query-filter-guide.md`**。本文档面向 **subordination / leftFilterField / customFilterField / datasetFilter**（单元格与多实例副本级）。
+
+## 一、核心结论（必读）
+
+设计器下拉框**按 `fieldKey` 匹配字段**，不是按显示名（`text`）或裸系统名（`field_xxx`）。
+
+**fieldKey 格式**（三段式，用 `.` 连接）：
+
+```
+{dataSetId}.{sourceId}.{fieldName}
+```
+
+| 段 | 含义 | 示例 |
+|----|------|------|
+| dataSetId | 报表内数据集 ID（`ds[].id`） | `1304979556231593994` |
+| sourceId | 数据源/逻辑表 ID（`ds[].sourceId`） | `1299763447342276611` |
+| fieldName | 字段系统名（`fields[].name`） | `field_1299763447342276617` |
+
+**症状对照**：
+
+| 现象 | 常见原因 |
+|------|----------|
+| API 保存成功，设计器筛选区下拉为空白 | `parentField`/`currentField` 用了显示名或裸 `field_xxx` |
+| 筛选条件不生效 | 未配置 `subordination` 或父格坐标错误 |
+| 类型选了但无效 | `type` 用了 `eq`/`uncontains` 而非平台枚举 |
+
+---
+
+## 二、左父格筛选（leftFilterField）
+
+### 2.1 何时需要
+
+当前单元格 `dataSetId` ≠ 左父格单元格 `dataSetId` 时，必须同时配置：
+
+1. **subordination** — VLOOKUP 式字段映射（设计器「从属关系」）
+2. **leftFilterField** — 左父格筛选条件（设计器「左父格筛选」）
+
+两者字段引用**都必须使用 fieldKey**。
+
+### 2.1.1 连续同源区域：只配入口格（强制）
+
+> 完整规则见 **`datasource-selection-and-parent-filter-guide.md` §二**（含 **§2.5 关联键：需求优先 · 推断须用户确认**）。
+
+若连续一片单元格**全部来自同一数据源**，且整体挂在另一数据源父格下：
+
+- **仅该区域第一个字段**：自定义父格指向异源父格 + 配置 `subordination` / `leftFilterField`
+- **同区域其余字段**：父格用**默认**，**不要**逐格再指异源父格、**不要**重复配父格筛选
+- **关联字段**：需求已写明则按需求；未写明则字段匹配推断后 **必须提示用户确认**（CLI：`e10-cli report join-suggest`）
+
+禁止对连续同源列/行「每个字段都配一遍跨源父格筛选」。
+
+### 2.2 数据结构
+
+**workbook 内**（`style.cellType` 上）：
+
+```json
+{
+ "subordination": [
+ "1304979556231593994.1299763447342276611.field_1299763447342276617",
+ "1304979560546713602.1299789221321891842.field_1299789221321891843"
+ ],
+ "leftFilterField": [
+ {
+ "parentField": "1304979556231593994.1299763447342276611.field_1299763447342276617",
+ "currentField": "1304979560546713602.1299789221321891842.field_1299789221321891843",
+ "type": "Equals",
+ "id": "1304979560546713602.1299789221321891842.field_1299789221321891843"
+ }
+ ]
+}
+```
+
+| 字段 | 说明 |
+|------|------|
+| subordination[0] | 父格（左父格）字段 fieldKey |
+| subordination[1] | 当前单元格字段 fieldKey |
+| parentField | 同 subordination[0] |
+| currentField | 同 subordination[1] |
+| type | 匹配关系，跨数据集关联通常用 `Equals` |
+| id | **必须等于 currentField**（设计器回显关键） |
+
+**save 后 fields 表**（`getReportDevInfo`）：`leftFilterField`、`subordination` 出现在字段记录顶层（JSON 字符串或数组），不在 `style` 内。
+
+### 2.3 左父格筛选识别与写入（2026-09 eteams · 必遵）
+
+设计器 F2「左父格筛选」下拉按 **fieldKey 注册表** 解析标签；下列写法会导致回显 **`undefined`** 或下拉空白：
+
+| 错误写法 | 现象 | 正确写法 |
+|----------|------|----------|
+| `parentField: "...field_5"`（截断/臆造字段名） | 父格关联字段显示 undefined | 完整 `{dataSetId}.{sourceId}.field_4746632256695654785` |
+| `id: "c43a895a664140dc"`（随机 UUID） | 筛选行无法匹配字段 | **`id` 必须等于 `currentField`（完整 fieldKey）** |
+| `subordination: ["",""]` | 从属关系丢失 | `[parentField, currentField]` 与 leftFilter 同步 |
+| 仅改 fields 表、workbook 内 `style.cellType` 未同步 | 保存后字段绑定丢失 | workbook + fields **双保存**（见 §4.1） |
+
+**父格坐标（leftX / leftY）**：须指向布局上**真实的左父格单元格**（0-based 列 x、行 y），不能机械套用 `leftY = col - 1`。
+
+**纵向堆叠多数据集示例**（进销存-供应商 + 采购进货单，同列 B）：
+
+- 供应商字段：y=0~4（供应商等级 → 联系方式），根格 y=0 左父格无
+- 采购字段：y=5~9，`leftX=1`, **`leftY=4`**（指向 E2「联系方式」所在行）
+- 关联：`parentField` = 供应商.供应商名称；`currentField` = 进货单.供应商
+
+**生成 helper**（Skill 内置）：
+
+```python
+from scripts.left_filter_builder import build_cross_dataset_filter
+
+lf, sub = build_cross_dataset_filter(
+ ds_supplier, src_supplier, "field_4746632256695654785",
+ ds_purchase, src_purchase, "field_4746633026496455388",
+)
+# lf[0]["id"] == lf[0]["currentField"] # 必须
+```
+
+**保存后验证**（`getReportDevInfo` 抽检首个跨表格，如进货单编号 y=5）：
+
+```bash
+# parentField / currentField 各含两个 '.' 段；subordination 与 leftFilterField 一致
+```
+
+参考实现：`本地工作目录`、`restore_and_fix_left_filter.js`。
+
+### 2.4 业务映射示例（EBU 报表）
+
+| 子表类型 | 父格字段 | 当前字段 | 含义 |
+|----------|----------|----------|------|
+| 直销合同列 | EBU团队·责任人 | 直销合同业绩表·销售经理 | 按责任人关联合同 |
+| 收款明细列 | EBU团队·责任人 | 收款明细表·销售经理 | 按责任人关联收款 |
+
+根格（如 F3 责任人）设置 `leftX=-1, leftY=-1`；子格/公式格 `leftX=2, leftY=5` 指向根格列（0-based：行 2、列 5）。
+
+### 2.5 Python 辅助函数
+
+```python
+def field_key_ref(ds_id, src_id, field):
+ return f"{ds_id}.{src_id}.{field['name']}"
+
+def make_subordination(p_ds_id, p_src_id, p_field, c_ds_id, c_src_id, c_field):
+ return [
+ field_key_ref(p_ds_id, p_src_id, p_field),
+ field_key_ref(c_ds_id, c_src_id, c_field),
+ ]
+
+def make_left_filter(p_ds_id, p_src_id, p_field, c_ds_id, c_src_id, c_field):
+ ck = field_key_ref(c_ds_id, c_src_id, c_field)
+ pk = field_key_ref(p_ds_id, p_src_id, p_field)
+ return [{"parentField": pk, "currentField": ck, "type": "Equals", "id": ck}]
+```
+
+参考实现：`本地工作目录`。
+
+---
+
+## 三、单元格自定义筛选（customFilterField）
+
+### 3.1 与数据集级筛选的区别
+
+| 层级 | 配置位置 | 用途 |
+|------|----------|------|
+| **单元格 customFilterField** | `style.cellType.customFilterField` | 该单元格取数时的行级条件 |
+| **数据集 datasetFilter** | `saveReportWithCacheConfig` 的 `datasetFilter` 参数 | 整个数据集的基础过滤 |
+
+单元格自定义筛选同样必须使用 **fieldKey** 作为 `currentField` 和 `id`。
+
+### 3.2 数据结构
+
+```json
+{
+ "customFilterField": [
+ {
+ "currentField": "1304979560546713602.1299789221321891842.field_1299789221321891843",
+ "type": "NotContain",
+ "value": "某核算机构",
+ "id": "1304979560546713602.1299789221321891842.field_1299789221321891843"
+ },
+ {
+ "currentField": "1304979560546713602.1299789221321891842.field_1299789221321891844",
+ "type": "Null",
+ "value": "",
+ "id": "1304979560546713602.1299789221321891842.field_1299789221321891844"
+ }
+ ]
+}
+```
+
+### 3.3 type 枚举（平台值）
+
+**必须使用下列枚举**，不要用简写：
+
+| 平台 type | 错误写法（无效） | 说明 |
+|-----------|------------------|------|
+| `Equals` | `eq` | 等于 |
+| `NotContain` | `uncontains` | 不包含 |
+| `Null` | `empty` | 为空 |
+| `NotNull` | `nempty` | 不为空 |
+| `Contain` | — | 包含 |
+| `Include` | — | 属于（多值逗号分隔） |
+
+完整枚举见 `report-data-model.md` §2.5。
+
+### 3.4 需求文档到配置的映射
+
+需求 Excel 中常见写法 → API 配置：
+
+```
+核算机构 不包含 机构A,机构B → type: NotContain, value: 机构A（多条则多个 filter 项）
+核算机构 为空 → type: Null, value: ""
+年度={year} → type: Equals, value: "{year}"（系统参数原样保留）
+```
+
+```python
+FILTER_TYPE_MAP = {
+ "eq": "Equals", "uncontains": "NotContain",
+ "empty": "Null", "nempty": "NotNull",
+}
+```
+
+---
+
+## 四、保存与验证流程
+
+### 4.1 双保存（API 脚本必做）
+
+1. `POST /api/bs/edc/report/saveReportWithCacheConfig` — workbook + dataset + datasetFilter
+2. `POST /api/bs/edc/report/saveReportDevInfo` — 同 workbook（需带 `designKey`）
+
+仅保存其一可能导致设计器回显异常或筛选丢失。
+
+### 4.2 验证清单
+
+保存后调用 `getReportDevInfo`，检查 L3（或目标数据行）字段：
+
+- [ ] `subordination` 为两段 fieldKey，非 `["",""]`
+- [ ] `leftFilterField` 非空，且 `parentField`/`currentField` 含两个 `.`
+- [ ] `customFilterField`（若有）的 `type` 为平台枚举
+- [ ] 设计器打开后左父格筛选、自定义筛选下拉**有选中项**（非空白）
+
+### 4.3 配置校验脚本
+
+```bash
+python e10-cli report validate <配置文件路径>
+```
+
+脚本会检查 fieldKey 格式、type 枚举、customFilterField 结构。
+
+---
+
+## 五、常见错误定位
+
+### 5.1 设计器筛选下拉空白
+
+1. 确认 `parentField`/`currentField`/`id` 均为 `{dataSetId}.{sourceId}.{fieldName}`
+2. 确认 `dataSetId` 是报表内数据集 ID，不是 appId / reportId
+3. 确认 `fieldName` 来自 `ds/fields` 接口的 `name` 字段
+4. 双保存后刷新设计器
+
+### 5.2 父格循环引用
+
+子格 `leftY` 指向错误列会导致父格环（如根格在 F 列却设 `leftY=6` 指向 G）。根格用 `leftX=-1, leftY=-1`。
+
+### 5.3 style 与 fields 表不一致
+
+`getAllSheets` 的 `dtTable` 可能为空；**以 `getReportDevInfo.fields` 为准**。workbook 内筛选写在 `style.cellType`，平台解析后同步到 fields 表。
+
+---
+
+## 六、生成配置时的 Agent 检查项
+
+生成或修改含跨数据集字段的报表时，Agent 必须：
+
+1. 从 `ds/list` + `ds/fields` 获取真实 `dataSetId`、`sourceId`、`field.name`
+2. 对每个跨数据集列生成 `subordination` + `leftFilterField`（fieldKey + `id`）
+3. 对需求中的过滤条件生成 `customFilterField`（fieldKey + 平台 type）
+4. 含 Formula 单元格时遵守 `formula-cell-api-guide.md`（cellText 无前导 `=`）
+5. 运行 `validate_report_config.py` 预检
+6. 若通过 API 保存，执行双保存并用 `getReportDevInfo` 验证
+
+---
+
+## 八、公式单元格（另见专篇）
+
+含 Formula 单元格且通过 **API / 脚本保存** 时，必须遵守 `formula-cell-api-guide.md`：
+
+- `cellText` / 顶层 `formula` **不带前导 `=`**
+- `countType: count`、`displayType: Group`、`groupType: null`
+- 双保存 + `getReportDevInfo` 回读验证
+
+公式格本身通常 **不需要** subordination / leftFilterField；它引用同表内已配好筛选的 Field 汇总格。
+
+---
+
+## 九、相关文档
+
+- `formula-cell-api-guide.md` — 公式单元格 API 写入规范（完整）
+- `report-config-schema.md` §2.4–2.5 — 过滤与 Formula Schema
+- `report-data-model.md` §2.4–2.5 — TypeScript 类型与枚举
+- `ai-report-workflow.md` §4.4、§六 — 交叉表工作流与公式规则
+- `report-knowledge-base.md` §2.1、§2.5 — 父格与自定义筛选概念

package/skills/weaver-e10-builder/references/report/dataset-query-filter-guide.md

@@ -0,0 +1,235 @@
+# 数据集筛选（queryInfoSave）API 写入规范
+
+> **适用场景**：设计器左侧「数据集 → 筛选条件」、行级数据权限、整表预过滤。 
+> **参考报表**：`1304979556231593985`（EBU 经营数据统计） 
+> **代码实现**：`本地工作目录` → `build_*_dataset_query_filter()` / `ensure_*_dataset_filter()` 
+> **执行**：`python 本地工作目录`
+
+---
+
+## 一、三种「筛选」机制（必区分）
+
+| 机制 | 设计器入口 | API | 持久化形态 | 典型用途 |
+|------|-----------|-----|-----------|----------|
+| **高级搜索** | 页面 → 查询设置 | `saveQueryItem` / `getQueryItem` | QueryItem JSON | 用户运行时输入筛选 |
+| **数据集筛选** | 左侧数据集 → 筛选条件 | **`queryInfoSave` / `queryInfoGet`** | `conditionData` + `otherData` | 行级权限、整表预过滤 |
+| **单元格/实例筛选** | 单元格自定义筛选 / 多数据集副本 | `saveReportWithCacheConfig` → `datasetFilter` / `customFilterField` | filterList + fieldKey | 列级差异化汇总 |
+
+**Agent 硬约束**
+
+- 用户说「左侧数据集筛选」「行级权限」「数据集过滤条件」→ **只用 `queryInfoSave`**，禁止写 `saveQueryItem`。
+- 用户说「高级搜索」「查询条件」→ **`saveQueryItem`**，禁止写 `queryInfoSave`。
+- 用户说「自定义筛选」「核算机构不包含」且针对**某一列/某一数据集实例**→ `datasetFilter` / `customFilterField`（见 `cross-dataset-filter-guide.md`）。
+
+---
+
+## 二、API
+
+| 操作 | 方法 | 参数 |
+|------|------|------|
+| 保存 | `POST /api/bs/edc/dataset/queryInfoSave` | `datasetId`, `filterData`（conditionData JSON 字符串）, `otherData`（JSON 字符串） |
+| 读取 | `GET /api/bs/edc/dataset/queryInfoGet` | `datasetId` |
+
+回读路径：`data.conditionData`、`data.otherData`（均为 JSON 字符串，需二次 `json.loads`）。
+
+---
+
+## 三、conditionData 顶层结构
+
+```json
+{
+ "key": "<毫秒时间戳>",
+ "relationship": "1",
+ "isParent": true,
+ "isNewFilter": true,
+ "parentNode": "",
+ "datas": [ /* 条件节点数组 */ ],
+ "version": 1
+}
+```
+
+| 字段 | 值 | 说明 |
+|------|-----|------|
+| `relationship` | **`"1"`** | 且（AND） |
+| `relationship` | **`"0"`** | 或（OR） |
+| `otherData.rootStr` | 人类可读表达式 | 设计器展示用，须与 datas 语义一致 |
+| `otherData.filterIsNull` | **`true`** | **变量值为空时不参与条件过滤**（平台 `QueryFilterBiz.analysisConfigFilter`）；与设计器「空值不筛」对齐，写入变量条件时**必须**为 `true` |
+| `otherData.rootStr` | 人类可读表达式 | 设计器展示用，须与 datas 语义一致 |
+| `otherData.version` | `1` | 与手动 save 对齐 |
+
+### 5.4 自定义变量（如 `{cs}`）
+
+| 场景 | func | value | otherData |
+|------|------|-------|-----------|
+| 创建者等于自定义变量 cs | `eq` | `{cs}` | **`filterIsNull: true`** |
+| 固定字面量（如资产名称=办公用品） | `eq` | `办公用品` | 同上（整组筛选共用 otherData） |
+
+> 变量名写在花括号内，与运行时请求参数 / 页面入参键一致。`filterIsNull=true` 时，`{cs}` 解析为空则**整条条件跳过**，不会误筛成「等于空」。
+
+---
+
+## 四、单条条件节点（datas[]）
+
+```json
+{
+ "type": "condition",
+ "fieldName": "field_1299789221321891852",
+ "fieldType": "String",
+ "compType": "Text",
+ "text": "产品类型",
+ "objId": "<sourceId>",
+ "conditions": {
+ "func": "nempty",
+ "value": "",
+ "type": "",
+ "text": "",
+ "isEsb": false
+ },
+ "formInfo": { "fieldId": "<字段 id>" },
+ "config": { "fieldId": "<字段 id>" }
+}
+```
+
+`conditions` 三要素：**func** + **value** + **type**（字段对比时为 `"formField"`）。
+
+---
+
+## 五、需求语义 → func / value 对照表
+
+### 5.1 字面量条件（type 为空）
+
+| 设计器 / 需求描述 | func | value 示例 | 备注 |
+|------------------|------|-----------|------|
+| 不为空 | **`nempty`** | `""` | 保存用 `nempty`，勿写 `isNotNull` |
+| 为空 | **`empty`** | `""` | |
+| 等于 | **`eq`** | 固定值或 `{lastname}` | 人员当前登录见 §5.3 |
+| 不等于（固定文本） | **`notEq`** | `"新签合同"` | 与字段对比的 `neq` 不同 |
+| 包含 | `like` / `contains` | 文本 | |
+| 不包含 | `uncontains` | 文本 | datasetFilter 常用 |
+| 开头包含 | **`startWith`** | `{thisyear}` | 按年份前缀筛 datetime / yyyy-MM |
+| 结尾包含 | `endWith` | 文本 | |
+| 介于 | **`between`** | `["{thisyear}",""]` | 完整日期区间；**不**适用于 yyyy-MM 等于当前月 |
+
+### 5.2 字段对比（type = `"formField"`）
+
+左字段为当前节点 `fieldName`；右字段写在 `value.compareFormField`（目标字段完整 `originField` + `showName` + `changeTrigger`）。
+
+| 设计器 / 需求描述 | func | value 结构 |
+|------------------|------|-----------|
+| **不属于**（字段 A 不属于字段 B） | **`unaggregate`** | `{ "compareFormField": <字段B originField> }` |
+| **不等于**（字段 A ≠ 字段 B） | **`neq`** | `{ "compareFormField": <字段B originField> }` |
+
+```python
+def _build_compare_form_field(origin_field):
+ field = dict(origin_field or {})
+ field["showName"] = field.get("name") or field.get("showName") or ""
+ field["changeTrigger"] = field.get("changeTrigger") or "1"
+ return field
+```
+
+**常见错误**
+
+| 错误写法 | 正确理解 |
+|----------|----------|
+| `notEq` + 字符串 `"核算机构"` | 排除产品类型**枚举值**为「核算机构」，不是字段对比 |
+| `unaggregate` 用于「不等于」 | 「不等于」用 **`neq`**；「不属于」用 **`unaggregate`** |
+| `isNotNull` 写入 queryInfoSave | 平台归一化为 **`nempty`** |
+
+### 5.3 系统参数（dataset 筛选已验证）
+
+| 场景 | func | value |
+|------|------|-------|
+| 当前用户姓名 | `eq` | `{lastname}` |
+| 当前登录人员 ID | **`eq`** | `{userid}`（设计器显示「等于」，勿用 `in`） |
+| 当前年月（format=`yyyy-MM`） | `eq` | **`{year}-{month}`** |
+| 今年（yyyy-MM / datetime 前缀） | `startWith` | **`{thisyear}`** |
+| 今年（高级搜索日期区间） | `between` | `["{thisyear}",""]` | 仅 saveQueryItem，非左侧 dataset |
+
+**无效占位符**：`{username}`、`{today}`、`{currmonth}`。
+
+---
+
+## 六、日期字段 format 与写法
+
+| 字段 format | 需求 | 推荐写法 | 勿用 |
+|-------------|------|----------|------|
+| `yyyy-MM` | 当前年月 | `eq` + `{year}-{month}` | `between` + `{thismonth}` |
+| `yyyy-MM` | 今年 | `startWith` + `{thisyear}` | `between`（完整日期语义） |
+| `yyyy-MM-dd` / `yyyy-MM-dd HH:mm:ss` | 今年 | `startWith` + `{thisyear}` | — |
+| 高级搜索日期区间 | 本月 | — | 见 `query-condition-api-guide.md` §五 |
+
+---
+
+## 七、EBU 参考示例
+
+报表 `1304979556231593985`
+
+### 7.1 EBU团队 · AND（`relationship: "1"`）
+
+数据集 `1304979556231593994`
+
+| 字段 | func | value |
+|------|------|-------|
+| 负责人姓名 | `eq` | `{lastname}` |
+| 创建者 | **`eq`** | `{userid}` |
+
+rootStr：`( 负责人姓名 等于 '{lastname}' ) AND ( 创建者 等于 '{userid}' )`
+
+### 7.2 直销合同业绩表 · OR（`relationship: "0"`）
+
+数据集 `1304979560546713602`
+
+| 字段 | func | type | value |
+|------|------|------|-------|
+| 核算机构 | **`neq`** | **`formField`** | compareFormField → 合同种类 |
+| 创建时间 | **`startWith`** | — | `{thisyear}` |
+
+rootStr：`(( 核算机构 不等于合同种类 ) 或 ( 创建时间 开头包含 '{thisyear}' ))`
+
+### 7.3 其他可用写法（按需）
+
+| 场景 | func | value |
+|------|------|-------|
+| 产品类型 不属于 核算机构 | `unaggregate` + formField | compareFormField → 核算机构 |
+| 合同业绩年月 = 当前年月 | `eq` | `{year}-{month}` |
+
+---
+
+## 八、写入与验证流程
+
+1. `fieldsAndOriginFields` / `get_fields` 取字段 **originField**（字段对比右侧必填）。
+2. 组装 `conditionData` + `otherData`（含 `rootStr`）。
+3. `POST queryInfoSave`。
+4. **`GET queryInfoGet` 回读**，核对：
+ - [ ] `relationship` 与 AND/OR 一致
+ - [ ] 每条 `conditions.func` / `conditions.type` / `conditions.value`
+ - [ ] 字段对比：`value.compareFormField.name` 为右字段 fieldName
+ - [ ] `otherData.rootStr` 与设计器一致
+5. 设计器刷新左侧数据集 → 筛选条件，确认操作项与默认值回显。
+
+**禁止**：未回读 `queryInfoGet` 即声称配置正确（手动 save 与脚本形态可能不同）。
+
+---
+
+## 九、与 queryInfoSave 无关的筛选
+
+以下场景**不要**使用本章 API：
+
+| 需求 | 文档 |
+|------|------|
+| 报表顶部高级搜索 | `query-condition-api-guide.md` §二–§六 |
+| 单元格 customFilterField | `cross-dataset-filter-guide.md` §三 |
+| 多数据集实例 datasetFilter | `cross-dataset-filter-guide.md` §3.4 |
+| 左父格 subordination / leftFilterField | `cross-dataset-filter-guide.md` §二 |
+
+---
+
+## 十、相关文件
+
+| 文件 | 用途 |
+|------|------|
+| `本地工作目录` | `_dataset_filter_condition_node`、`_dataset_filter_form_field_compare_node`、`build_*_dataset_query_filter` |
+| `本地工作目录` | 一键写入高级搜索 + 数据集筛选 |
+| `query-condition-api-guide.md` | saveQueryItem 高级搜索（与本文互补） |
+| `cross-dataset-filter-guide.md` | datasetFilter / customFilterField / fieldKey |
+| `report-knowledge-base.md` | FuncType 枚举摘要 |