weaver-e10-builder 1.2.5 → 1.5.2

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "weaver-e10-builder",
-  "version": "1.2.5",
+  "version": "1.5.2",
   "description": "Eteams/Ebuilder CLI — 泛微 OA 命令行工具",
   "type": "module",
   "files": [
     "dist",
     "ecodecmd",
-    "skill-docs"
+    "skill-docs",
+    "assets"
   ],
   "bin": {
     "e10-cli": "./dist/index.js",
@@ -34,10 +35,9 @@
     "mammoth": "^1.12.0",
     "minimist": "^1.2.6",
     "node-html-markdown": "^2.0.0",
-    "request": "^2.88.2",
     "sql.js": "^1.11.0",
     "tiny-pinyin": "^1.3.2",
-    "xlsx": "^0.18.5"
+    "xlsx": "npm:@e965/xlsx@0.20.3"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/skill-docs/SKILL.md

@@ -2,11 +2,11 @@
 name: weaver-e10-builder
 display_name: 泛微E10智能搭建Skill
 display_name_en: E10 Builder
-description: 泛微E10智能搭建skill v2（通用版），辅助编写泛微Ebuilder自定义应用，对应CLI版本1.2.5
-description_zh: 泛微Ebuilder低代码应用智能搭建工具 v2（通用版），辅助编写自定义应用（表单/流程/列表/动作流/权限/分组/编号等），与 e10-cli 配套使用，当前对应 CLI 版本 1.2.5。
-description_en: E10 Ebuilder low-code app builder skill v2 (general) — helps build Weaver E10 custom apps (forms/workflows/lists/actionflows/permissions/groups/numbering) via e10-cli, currently paired with CLI 1.2.5.
+description: 泛微E10智能搭建skill v2（通用版），辅助编写泛微Ebuilder自定义应用，对应CLI版本1.5.2
+description_zh: 泛微Ebuilder低代码应用智能搭建工具 v2（通用版），辅助编写自定义应用（表单/流程/列表/动作流/权限/分组/编号等），与 e10-cli 配套使用，当前对应 CLI 版本 1.5.2。
+description_en: E10 Ebuilder low-code app builder skill v2 (general) — helps build Weaver E10 custom apps (forms/workflows/lists/actionflows/permissions/groups/numbering) via e10-cli, currently paired with CLI 1.5.2.
 category: coding
-version: 1.2.5
+version: 1.5.2
 author: 泛微网络科技股份有限公司
 auto: true
 ---
@@ -15,7 +15,7 @@ auto: true
 
 ## 安装与升级
 
-本 skill 需与 CLI **版本匹配**（当前对应 CLI `1.2.5`）。版本不一致时命令/文档/选项可能对不上——升级前先对齐：
+本 skill 需与 CLI **版本匹配**（当前对应 CLI `1.5.2`）。版本不一致时命令/文档/选项可能对不上——升级前先对齐：
 
 ```shell
 e10-cli --version          # 查 CLI 版本，应与上方 description 标注一致
@@ -75,7 +75,7 @@ npx -y skills add ./weaver-e10-builder.zip --skill -y
 
 流程体系分为 **EB 流程**和**原生工作流程**，两者的表单、资源 ID 与接口不可混用；公文流程是原生工作流程的特殊类型。固定/自由是各类流程的流转模式。
 
-默认使用 **EB 表单**及应用内流程。只有需求明确要求原生流程表单、工作流程或流程中心建流程时，才切换到 `wf-form` / `workflow create-workflow` 路径。不确定且选择会改变资源归属时，再向用户确认。具体规则读取 `references/workflow/guide-workflow.md`；公文专属配置读取 `references/workflow/guide-workflow-odoc.md`。
+默认使用 **EB 表单**及应用内流程。只有需求明确要求原生流程表单、工作流程或流程中心建流程时，才切换到 `wf-form` / `workflow create-workflow` 路径。不确定且选择会改变资源归属时，再向用户确认。具体规则读取 `references/workflow/guide-workflow.md`；公文流程创建读取 `references/workflow/guide-workflow-odoc.md`，公文专属设置读取 `references/workflow/guide-workflow-odoc-setting.md`。
 ---
 
 ## 面向人群
@@ -146,17 +146,20 @@ npx -y skills add ./weaver-e10-builder.zip --skill -y
 | 写plan、搭建计划、plan.md、资源梳理、搭建模板、必做项清单 | `references/common/guide-plan-template.md` |
 | 建应用、创建应用、app、应用列表、应用详情、应用目录、app read/list/folder/edit/delete | `references/common/ref-cli-commands.md` |
 | 字段联动、跨表带出赋值、FormDataLinkage、多跳带出、关联客户带出客户类型、field-linkage、Text字段赋值名称 | `references/form/guide-field-linkage.md`（三种联动对比 + 单跳/多跳 + --hops 格式 + Text 字段必须多跳取名称） |
+| 函数联动、本表字段间公式赋值、赋值式公式、EXCEL 公式联动、字段自动计算、form formula-linkage、wf-form formula-linkage、流程表单函数联动、触发事件、模块字段不能作目标 | `references/form/guide-formula-linkage.md`（四套联动对比 + 赋值式语法 + 触发事件表 + 模块字段 + 流程表单那条路由 + 常见报错） |
 | 鉴权、登录、ETEAMSID、多环境、profile、切换环境 | `references/auth/guide-auth.md` |
 | 表单数据读写、getSimpleData、withDisplayNames、getFieldOptions、saveFormData、updateFormData | `references/coding/guide-form-crud.md`（前端代码） |
 | form data add、form data list、form data delete、写入数据、查询数据、删除数据 | `references/form/guide-form-data.md` |
 | 编辑回显、handleEdit、getAllData、数据回填 | `references/coding/guide-edit-backfill.md`（前端代码） |
-| 字段联动、显隐联动、条件显示、form linkage | `references/form/guide-form-linkage.md` |
+| 字段联动、显隐联动、条件显示、form linkage、为空/不为空条件、NULL 算子 | `references/form/guide-form-linkage.md` |
 | 新建表单、form create、EB表单创建流程、fields.json | `references/form/guide-create-form.md`；确定具体字段参数时再读 `references/form/ref-form-fields.md` |
 | 虚拟表、虚拟表单、绑定数据源、业务表展示、数据加工结果 | `references/form/guide-virtual-form.md`；字段类型按来源映射，不按普通字段重新猜测 |
 | Excel样式、表格式布局、布局样表、布局蓝图、标签字段交替、合并单元格 | `references/form/guide-form-layout-planning.md` |
 | 流程、审批、workflow、提交流程、预填 | `references/workflow/guide-workflow.md` |
+| 流程绑了哪张表、流程对应表单、workflow info、从流程找表单 | 命令速查 `references/common/ref-cli-commands.md` 的 `workflow info` 一行（**流程列表接口不含这个信息**；拿到的是 formId，不是 objId） |
 | 权责表、权责矩阵、权责表方式流程、分支场景、变量映射 | `references/workflow/guide-workflow-auth-resp.md`（操作者和条件同时遵循流程基础指南） |
-| 公文流程、公文审批、收文、发文、公文设置、正文设置 | `references/workflow/guide-workflow-odoc.md`（基础节点/出口/操作者同时遵循 `guide-workflow.md`） |
+| 公文流程、公文审批、收文、发文 | `references/workflow/guide-workflow-odoc.md`（基础节点/出口/操作者同时遵循 `guide-workflow.md`） |
+| 公文设置、正文设置、痕迹、套红、排版、文号、附件区、归档、智能助手 | `references/workflow/guide-workflow-odoc-setting.md` |
 | 流程节点、操作者、审批人、连线、添加节点、删除连线、删除节点、delete-node、节点操作者、set-operator、出口名称、link-rename、节点字段权限、field-permission | `references/workflow/guide-workflow.md` |
 | 节点独立布局、节点换布局、node layout、节点用哪套布局、流程布局、流式/表格式布局、引用节点、updateQuoteNode | `references/workflow/guide-workflow-node-layout.md` |
 | 节点校验、提交校验、node validate、智能审批规则、字面值校验、禁止提交 | `references/common/ref-cli-commands.md` |
@@ -177,6 +180,7 @@ npx -y skills add ./weaver-e10-builder.zip --skill -y
 | 字段分组、分组容器、字段分段、基本信息/合同信息分段、Collapse、Fold、字段归组 | `references/form/guide-form-layout-planning.md`（**按需**：用户明确要求字段分组才在 fields.json 写 `group`，默认不加分组） |
 | 独占一行、整行显示、字段换行、singleRow、--single-row | `references/form/guide-form-layout-planning.md`（fields.json 字段写 `"singleRow":true`；add-field 用 `--single-row`） |
 | 布局样式、样式模板、换配色、表单皮肤、layout init、style-template | `references/form/style-templates.md`（**⚠ 流式与表格式是两套独立模板，同名不同 id**，命令按布局类型实时查；缺省 流式=标准版、表格式=表格版） |
+| 给已有表单加字段、改必填/只读、表单不是自己建的、--reinit、布局被重建、字段在布局里对不上、字段标题显示不出来 | `references/form/guide-form-layout-incremental.md`（**⚠ 不是自己建的表不要用 `--reinit`**；设必填是改布局组件，字段定义里没有 `required`） |
 | 字段类型、字段码表、日期区间、关联浏览、关联订单、关联合同、Order、Contract、字段多选、multiple、--multiple | `references/form/ref-form-fields.md` |
 | 表单复杂编号、serial-mark、流水号、年份编号、代字 | `references/form/guide-form-serial-mark.md` |
 | 函数公式、字段公式、formula、DAYS、日期差、expressId、公式绑定 | `references/form/guide-form-formula-functions.md`（219 个函数速查矩阵，写 `fields.json` 的 `formula` 或 `form formula set --expression` 时查函数格式/示例；**日期差用 `DAYS(开始,结束)`**） |
@@ -201,7 +205,7 @@ npx -y skills add ./weaver-e10-builder.zip --skill -y
 | 流程存档、定时触发、高级设置、advanced | `references/common/ref-cli-commands.md` |
 | 编译、build、compile、代码质量检查、check、skill 文档、skill sync/copy/root | `references/common/ref-cli-commands.md` |
 | 页面设计器、配置式页面、仪表盘、看板页、designer、page create、comp-add、工厂模板、factory、组件模板、页面布局、designer layout/save、页面版本、version revert、发布页面菜单、publish-menu、**自定义CSS、组件样式、改样式、选择器、DOM结构、样式不生效、designer css、designer dom** | `references/ebuilder-designer/guide-designer.md`（布局层）；组件配置见 `guide-designer-components.md`，**自定义 CSS 与 DOM 结构索引见 `guide-designer-css.md`**，工厂模板见 `guide-designer-factory.md`，版本见 `guide-designer-version.md`，命令速查见 `references/common/ref-cli-commands.md`「页面 & 设计器」节 |
-| HRM、矩阵、条件矩阵、matrix、映射表 | `references/hrm/guide-matrix.md` |
+| HRM、矩阵、条件矩阵、部门矩阵、分部矩阵、matrix、映射表、行 id、rowId | `references/hrm/guide-matrix.md` |
 | 报表、设计器报表、EDC 报表、report build、新建报表、数据集、报表列、报表查询条件、报表权限、报表快照、report | `references/report/guide-report-build.md`（建表主干）；改已有报表见 `guide-report-modify.md`，查询条件见 `guide-report-query.md`，命令速查见 `ref-report-commands.md`；踩坑先扫 `ref-report-pitfalls.md` |
 | 报表多数据源、跨数据集、跨表关联、主从报表、两个表单合成一张报表、父格筛选、subordination、leftFilterField、render 渲染回读 | `references/report/guide-report-multisource.md`（spec 写法 + 区域/入口格 + 双保存与关预聚合 + 验证） |
 | 报表单元格、父格、扩展方向、合并、冻结、隐藏行、条件格式、数据条、图标集、tableName、字段三件套 | `references/report/ref-report-pitfalls.md` + `report-data-model.md`（枚举）· `layout-showlocation-freeze-guide.md`（冻结/居左）· `hidden-row-and-header-merge-guide.md`（空白行与表头合并） |

package/skill-docs/_catalog.md

@@ -1,81 +1,86 @@
-# Skill Ebcoder 目录索引
-
-> 此文件列出所有子文档的加载条件，供 Agent 按需加载。不要一次性加载全部。
->
-> 以下所有路径统一写作 `references/...`：相对工作区根目录（`skill copy` 拷出的位置），或本机 skill 根目录（完整安装自带）。
-
-## Guides（编码指南）
-
-| 用户意图关键词 | 加载文档 |
-|---------------|---------|
-| 表单CRUD、增删改查、getSimpleData、withDisplayNames、getFieldOptions、saveFormData、updateFormData、deleteFormData、字段类型 | `references/coding/guide-form-crud.md`（前端代码） |
-| 编辑、修改、回显、handleEdit、getAllData、rawData、selectedPerson、editForm、数据回填 | `references/coding/guide-edit-backfill.md`（前端代码） |
-| 字段联动、显隐联动、条件显示、form linkage | `references/form/guide-form-linkage.md` |
-| 新建表单、form create、EB 表单标准创建流程 | `references/form/guide-create-form.md` |
-| 二级明细、子明细、父级行标识、子级行标识、多级明细 | `references/form/guide-form-sub-detail.md` |
-| 虚拟表、虚拟表单、数据源表单、业务表展示、数据加工结果 | `references/form/guide-virtual-form.md` |
-| 字段定义、字段类型、关联字段码表、DateRange、multiple | `references/form/ref-form-fields.md` |
-| FLOW/EXCEL、布局样表、布局蓝图、字段分组、singleRow | `references/form/guide-form-layout-planning.md` |
-| 布局样式模板、换配色、form layout init | `references/form/style-templates.md`（流式/表格式两套，同名不同 id） |
-| 表单复杂编号、serial-mark、流水号、代字 | `references/form/guide-form-serial-mark.md` |
-| 表单数据读写、form data、写入数据、查询数据、删除数据 | `references/form/guide-form-data.md` |
-| 列表自定义文本列、富文本列、列里插入字段、form nlist、列表式视图 | `references/form/guide-list-custom-text.md` |
-| 流程、审批、workflow、提交流程、flowpage、预填、URL传参、节点、操作者、审批人、连线 | `references/workflow/guide-workflow.md` |
-| 权责表、权责矩阵、权责表方式流程、分支场景、变量映射 | `references/workflow/guide-workflow-auth-resp.md` + `references/workflow/guide-workflow-condition.md` |
-| 公文流程、公文审批、收文、发文、公文设置、正文设置 | `references/workflow/guide-workflow-odoc.md` + `references/workflow/guide-workflow.md` |
-| 分支条件、出口条件、条件JSON、save-condition、连线条件、condition add | `references/workflow/guide-workflow-condition.md` |
-| 条件操作符编码、字段类型矩阵、关系符 | `references/workflow/operator-matrix.md` |
-| 动作流、跨表单、写入台账、ActionEbAdd/ActionEbUpdate/ActionEbDelete、提交事件、自定义事件触发、内置MQ监听/发送、HTTP/HTTPS、DML/数仓 | `references/workflow/guide-workflow-action.md`；复杂动作流组件契约按需读取 `actionflows/SKILL.md` 及其 `references/components/` |
-| 鉴权、登录、auth、ETEAMSID、多环境、profile、切换环境 | `references/auth/guide-auth.md` |
-| HRM矩阵、条件矩阵、matrix、映射表 | `references/hrm/guide-matrix.md` |
-| 报表、设计器报表、EDC报表、新建报表、report build、数据集、报表列、父格、合并、冻结、tableName | `references/report/guide-report-build.md`（建表主干）· `guide-report-modify.md`（改已有）· `ref-report-pitfalls.md`（先扫坑） |
-| 报表查询条件、高级搜索、筛选、queryType、默认值三件套 | `references/report/guide-report-query.md`；细则 `query-condition-api-guide.md` |
-| 报表命令、report 子命令、report build/verify/fix/scope/snapshot | `references/report/ref-report-commands.md` |
-| 报表接口、saveReportDevInfo、addDataset、getReportDevInfo、报表落库流程 | `references/report/api-report-build-fast-path.md` · `report-config-schema.md`（配置结构） · `report-data-model.md`（枚举） |
-| 报表单元格模型、cellType、displayType、expandType、groupType、countType | `references/report/report-data-model.md` · `report-config-schema.md` |
-| 报表权限、共享范围、viewRight、权责矩阵 | `references/report/report-permission-guide.md` |
-| 报表版本、快照、生命周期、回收站、复制挂菜单 | `references/report/report-lifecycle-api-guide.md` |
-| 报表条件格式、数据条、图标集 | `references/report/condition-format-guide.md` |
-| 新页面、导出、路由、entry.js、regOvProps、regReactChildren、asyncImport、publicUrl、Suspense | `references/coding/guide-page-export.md`（前端代码） |
-| 写页面、页面代码、React编码、组件、entry.js模板 | `references/coding/guide-page-code.md`（前端代码） |
-| 页面设计器、配置式页面、仪表盘、看板页、designer、page create、comp-add、工厂模板、factory、组件模板、页面布局、designer layout/save、页面版本、version revert、发布页面菜单、publish-menu、自定义CSS、组件样式、选择器、DOM结构、样式不生效 | `references/ebuilder-designer/guide-designer.md`（布局层主干）· `guide-designer-components.md`（组件 config）· `guide-designer-factory.md`（工厂模板）· `guide-designer-version.md`（版本）· `guide-designer-css.md`（自定义 CSS 与 DOM 结构索引） |
-
-## Reference（参考手册）
-
-| 用户意图关键词 | 加载文档 |
-|---------------|---------|
-| CLI、命令、打包、build、import、创建应用、创建表单、菜单、project、form create、app create、matrix | `references/common/ref-cli-commands.md` |
-| 接口文档导入、Postman、系统接口、连接器接口、createSystemInterfaceByAi、接口批量创建 | `references/esb-interface/guide-import.md` |
-| 系统菜单、内置菜单、挂系统页面到菜单、menuUrl、pageType、工作流菜单、独立页面菜单、菜单改名、menu rename、重命名菜单、找不到菜单 | `references/menu/system-menus.md` |
-| 编译、语法、报错、不支持、babel、打包、var、const、let、es2015、stage-2 | `references/coding/ref-compile-rules.md`（前端代码） |
-
-## Components（组件文档）
-
-| 用户意图关键词 | 加载文档 |
-|---------------|---------|
-| Button、按钮 | `references/components/@weapp-Button.md` |
-| Table、表格 | `references/components/display-Table.md` |
-| List、列表 | `references/components/display-List.md` |
-| Pagination、分页 | `references/components/display-Pagination.md` |
-| Icon、图标 | `references/components/display-Icon.md` |
-| Avatar、头像 | `references/components/display-Avatar.md` |
-| EChart、图表、Echarts | `references/components/generic-Echarts.md` |
-| 文件预览、CorsComponent | `references/components/display-FilePreview.md` |
-| Input、输入框、文本框 | `references/components/form-Input.md` |
-| 人员选择、Browser Employee、resource | `references/components/form-EmployeeBrowser-api.md` |
-| 部门选择、Browser Department、department | `references/components/form-DepartmentBrowser-api.md` |
-| Upload、文件上传、附件、FileComponent | `references/components/form-Upload.md` |
-| Badge、徽标 | `references/components/base-Badge.md` |
-| Tag、标签 | `references/components/base-Tag.md` |
-
-## 组合场景
-
-| 场景 | 需加载的文档 |
-|------|-------------|
-| CRUD 列表页 | `references/coding/guide-form-crud.md`（前端代码） + `references/components/display-Table.md` + `references/components/display-Pagination.md` |
-| 表单新增/编辑弹窗 | `references/coding/guide-form-crud.md`（前端代码） + `references/coding/guide-edit-backfill.md` + 对应表单组件文档 |
-| 新建完整应用 | `references/common/ref-cli-commands.md` + `references/form/guide-create-form.md` + `references/coding/guide-page-export.md`（前端代码） |
-| 流程触发页面 | `references/workflow/guide-workflow.md` + `references/coding/guide-form-crud.md`（前端代码） |
-| 流程分支条件 | `references/workflow/guide-workflow.md` + `references/workflow/guide-workflow-condition.md` |
-| 跨表单动作流 | `references/workflow/guide-workflow.md` + `references/workflow/guide-workflow-action.md` |
-| 编译报错排查 | `references/coding/ref-compile-rules.md`（前端代码） |
+# Skill Ebcoder 目录索引
+
+> 此文件列出所有子文档的加载条件，供 Agent 按需加载。不要一次性加载全部。
+>
+> 以下所有路径统一写作 `references/...`：相对工作区根目录（`skill copy` 拷出的位置），或本机 skill 根目录（完整安装自带）。
+
+## Guides（编码指南）
+
+| 用户意图关键词 | 加载文档 |
+|---------------|---------|
+| 表单CRUD、增删改查、getSimpleData、withDisplayNames、getFieldOptions、saveFormData、updateFormData、deleteFormData、字段类型 | `references/coding/guide-form-crud.md`（前端代码） |
+| 编辑、修改、回显、handleEdit、getAllData、rawData、selectedPerson、editForm、数据回填 | `references/coding/guide-edit-backfill.md`（前端代码） |
+| 显隐联动、条件显示、form linkage、为空/不为空条件、NULL 算子 | `references/form/guide-form-linkage.md` |
+| 函数联动、本表字段公式赋值、赋值式公式、EXCEL 公式联动、字段自动计算、form formula-linkage、wf-form formula-linkage、流程表单函数联动、值改变时、载入时触发、当前工作流生效 | `references/form/guide-formula-linkage.md` |
+| 字段联动、跨表带出、field-linkage、多跳带出、带出字段赋值、Text 字段取名称 | `references/form/guide-field-linkage.md` |
+| 新建表单、form create、EB 表单标准创建流程 | `references/form/guide-create-form.md` |
+| 二级明细、子明细、父级行标识、子级行标识、多级明细 | `references/form/guide-form-sub-detail.md` |
+| 物理表、多物理表、附属物理表、saveFormTable、getFormAGroupList、字段管理其他页签、字段超过100、add-physical-table、add-physical-field | `references/form/guide-form-physical-table.md` |
+| 虚拟表、虚拟表单、数据源表单、业务表展示、数据加工结果 | `references/form/guide-virtual-form.md` |
+| 字段定义、字段类型、关联字段码表、DateRange、multiple | `references/form/ref-form-fields.md` |
+| FLOW/EXCEL、布局样表、布局蓝图、字段分组、singleRow | `references/form/guide-form-layout-planning.md` |
+| 布局样式模板、换配色、form layout init | `references/form/style-templates.md`（流式/表格式两套，同名不同 id） |
+| 已有表单加字段、改必填/只读、布局被重建、add-field --reinit、别动别人的表、布局组件、associatedId、字段标题取不到 | `references/form/guide-form-layout-incremental.md` |
+| 表单复杂编号、serial-mark、流水号、代字 | `references/form/guide-form-serial-mark.md` |
+| 表单数据读写、form data、写入数据、查询数据、删除数据 | `references/form/guide-form-data.md` |
+| 列表自定义文本列、富文本列、列里插入字段、form nlist、列表式视图 | `references/form/guide-list-custom-text.md` |
+| 流程、审批、workflow、提交流程、flowpage、预填、URL传参、节点、操作者、审批人、连线 | `references/workflow/guide-workflow.md` |
+| 流程绑的表、流程关联表单、workflow info、workflowId 查表单、formId 不是 objId | `references/common/ref-cli-commands.md`（`workflow info` 一行） |
+| 权责表、权责矩阵、权责表方式流程、分支场景、变量映射 | `references/workflow/guide-workflow-auth-resp.md` + `references/workflow/guide-workflow-condition.md` |
+| 公文流程、公文审批、收文、发文、公文设置、正文设置 | `references/workflow/guide-workflow-odoc.md` + `references/workflow/guide-workflow.md` |
+| 分支条件、出口条件、条件JSON、save-condition、连线条件、condition add | `references/workflow/guide-workflow-condition.md` |
+| 条件操作符编码、字段类型矩阵、关系符 | `references/workflow/operator-matrix.md` |
+| 动作流、跨表单、写入台账、ActionEbAdd/ActionEbUpdate/ActionEbDelete、提交事件、自定义事件触发、内置MQ监听/发送、HTTP/HTTPS、DML/数仓 | `references/workflow/guide-workflow-action.md`；复杂动作流组件契约按需读取 `actionflows/SKILL.md` 及其 `references/components/` |
+| 鉴权、登录、auth、ETEAMSID、多环境、profile、切换环境 | `references/auth/guide-auth.md` |
+| HRM矩阵、条件矩阵、部门矩阵、分部矩阵、matrix、映射表、行 id、rowId、syncType | `references/hrm/guide-matrix.md` |
+| 报表、设计器报表、EDC报表、新建报表、report build、数据集、报表列、父格、合并、冻结、tableName | `references/report/guide-report-build.md`（建表主干）· `guide-report-modify.md`（改已有）· `ref-report-pitfalls.md`（先扫坑） |
+| 报表查询条件、高级搜索、筛选、queryType、默认值三件套 | `references/report/guide-report-query.md`；细则 `query-condition-api-guide.md` |
+| 报表命令、report 子命令、report build/verify/fix/scope/snapshot | `references/report/ref-report-commands.md` |
+| 报表接口、saveReportDevInfo、addDataset、getReportDevInfo、报表落库流程 | `references/report/api-report-build-fast-path.md` · `report-config-schema.md`（配置结构） · `report-data-model.md`（枚举） |
+| 报表单元格模型、cellType、displayType、expandType、groupType、countType | `references/report/report-data-model.md` · `report-config-schema.md` |
+| 报表权限、共享范围、viewRight、权责矩阵 | `references/report/report-permission-guide.md` |
+| 报表版本、快照、生命周期、回收站、复制挂菜单 | `references/report/report-lifecycle-api-guide.md` |
+| 报表条件格式、数据条、图标集 | `references/report/condition-format-guide.md` |
+| 新页面、导出、路由、entry.js、regOvProps、regReactChildren、asyncImport、publicUrl、Suspense | `references/coding/guide-page-export.md`（前端代码） |
+| 写页面、页面代码、React编码、组件、entry.js模板 | `references/coding/guide-page-code.md`（前端代码） |
+| 页面设计器、配置式页面、仪表盘、看板页、designer、page create、comp-add、工厂模板、factory、组件模板、页面布局、designer layout/save、页面版本、version revert、发布页面菜单、publish-menu、自定义CSS、组件样式、选择器、DOM结构、样式不生效 | `references/ebuilder-designer/guide-designer.md`（布局层主干）· `guide-designer-components.md`（组件 config）· `guide-designer-factory.md`（工厂模板）· `guide-designer-version.md`（版本）· `guide-designer-css.md`（自定义 CSS 与 DOM 结构索引） |
+
+## Reference（参考手册）
+
+| 用户意图关键词 | 加载文档 |
+|---------------|---------|
+| CLI、命令、打包、build、import、创建应用、创建表单、菜单、project、form create、app create、matrix | `references/common/ref-cli-commands.md` |
+| 接口文档导入、Postman、系统接口、连接器接口、createSystemInterfaceByAi、接口批量创建 | `references/esb-interface/guide-import.md` |
+| 系统菜单、内置菜单、挂系统页面到菜单、menuUrl、pageType、工作流菜单、独立页面菜单、菜单改名、menu rename、重命名菜单、找不到菜单 | `references/menu/system-menus.md` |
+| 编译、语法、报错、不支持、babel、打包、var、const、let、es2015、stage-2 | `references/coding/ref-compile-rules.md`（前端代码） |
+
+## Components（组件文档）
+
+| 用户意图关键词 | 加载文档 |
+|---------------|---------|
+| Button、按钮 | `references/components/@weapp-Button.md` |
+| Table、表格 | `references/components/display-Table.md` |
+| List、列表 | `references/components/display-List.md` |
+| Pagination、分页 | `references/components/display-Pagination.md` |
+| Icon、图标 | `references/components/display-Icon.md` |
+| Avatar、头像 | `references/components/display-Avatar.md` |
+| EChart、图表、Echarts | `references/components/generic-Echarts.md` |
+| 文件预览、CorsComponent | `references/components/display-FilePreview.md` |
+| Input、输入框、文本框 | `references/components/form-Input.md` |
+| 人员选择、Browser Employee、resource | `references/components/form-EmployeeBrowser-api.md` |
+| 部门选择、Browser Department、department | `references/components/form-DepartmentBrowser-api.md` |
+| Upload、文件上传、附件、FileComponent | `references/components/form-Upload.md` |
+| Badge、徽标 | `references/components/base-Badge.md` |
+| Tag、标签 | `references/components/base-Tag.md` |
+
+## 组合场景
+
+| 场景 | 需加载的文档 |
+|------|-------------|
+| CRUD 列表页 | `references/coding/guide-form-crud.md`（前端代码） + `references/components/display-Table.md` + `references/components/display-Pagination.md` |
+| 表单新增/编辑弹窗 | `references/coding/guide-form-crud.md`（前端代码） + `references/coding/guide-edit-backfill.md` + 对应表单组件文档 |
+| 新建完整应用 | `references/common/ref-cli-commands.md` + `references/form/guide-create-form.md` + `references/coding/guide-page-export.md`（前端代码） |
+| 流程触发页面 | `references/workflow/guide-workflow.md` + `references/coding/guide-form-crud.md`（前端代码） |
+| 流程分支条件 | `references/workflow/guide-workflow.md` + `references/workflow/guide-workflow-condition.md` |
+| 跨表单动作流 | `references/workflow/guide-workflow.md` + `references/workflow/guide-workflow-action.md` |
+| 编译报错排查 | `references/coding/ref-compile-rules.md`（前端代码） |