weaver-e10-builder 1.6.6 → 1.6.7

package/skill-docs/SKILL.md

@@ -1,162 +1,162 @@
----
-name: weaver-e10-builder
-display_name: 泛微E10智能搭建Skill
-display_name_en: E10 Builder
-description: 泛微E10智能搭建skill v2（通用版），辅助编写泛微Ebuilder自定义应用，对应CLI版本1.6.6
-description_zh: 泛微Ebuilder低代码应用智能搭建工具 v2（通用版），辅助编写自定义应用（表单/流程/列表/动作流/权限/分组/编号等），与 e10-cli 配套使用，当前对应 CLI 版本 1.6.6。
-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.6.6.
-category: coding
-version: 1.6.6
-author: 泛微网络科技股份有限公司
-auto: true
----
-
-# Ebuilder 智能搭建 Skill
-
-## 使用前提
-
-- **版本必须匹配**：`e10-cli --version` 应与 frontmatter 的 `version` 一致；不一致时命令/选项/文档可能对不上。
-- **鉴权**：仅在即将远程查询或写入前运行 `e10-cli auth status`；同一连续阶段不重复检查，切换系统地址、profile 或凭证后必须重新确认。
-- **文档随 CLI 分发**：读 `references/...` 提示文件不存在时，跑 `e10-cli skill sync` 或重跑 `e10-cli auth status`。
-- 安装/升级、skill 重装、WorkBuddy 注意事项 → `references/common/guide-install.md`。
-
-## 核心理念
-
-> **默认一份完整业务方案落在一个主应用。** 需求明确指定已有应用、跨应用资源或独立业务边界时，按实际范围处理，并在 `plan.md` 中标明每项资源的所属应用和跨应用关系。
-
-```
-一份完整业务方案 → 一个主应用（默认）
- └→ 应用下的资源: 表单 → 流程 → 菜单 → 页面
-跨应用/已有应用增强 → 按实际边界规划并明确资源归属
-```
-
-接到需求不要一上来就写页面代码。先想清楚这一个应用下需要哪些表单、字段怎么设计、流程怎么走。
-
-**能力范围**：应用与资源、表单与字段、视图与按钮、流程与动作流、设计器报表、权限、页面、数据操作，以及从接口文档批量创建 ESB 系统接口。具体能力、命令与限制以本页决策树路由到的 `_catalog.md` 和 `references/` 为准；规划时应一次覆盖需求中已明确的配置项，不因主文档未枚举某条命令而遗漏。
-
----
-
-## 流程类型与默认路径
-
-默认使用 **EB 表单**及应用内流程。只有需求明确要求原生流程表单、工作流程或流程中心建流程时，才切换到 `wf-form` / `workflow create-workflow`；不确定且选择会改变资源归属时，先向用户确认。EB 流程与原生工作流程的表单、资源 ID、接口不可混用；公文流程是原生工作流程的特殊类型。详见 `references/workflow/guide-workflow.md`。
-
----
-
-## 执行流程
-
-面向非编程用户：主动把模糊需求翻译成精确的资源设计。
-
-0. **环境**：仅在即将远程查询/写入前跑 `e10-cli auth status`；切已有环境用 `auth profile use <name>`，新环境用 `auth set --eteamsid "<ETEAMSID>" --base-url <url>`（ETEAMSID 从浏览器 Cookies 复制，不走 `auth login`）。
-1. **判断复杂度**：涉及 2+ 模块（应用/表单/流程/页面）→ 进入规划；单步改字段、查数据 → 直接执行。
-2. **规划**（复杂需求必经）：
-   - 先写 **0.1 方案澄清与可行性预检**：需求理解、待确认项（问题/选项/建议/影响/决策）、可做/部分可做/做不到及证据等级、验收判据；按 `references/common/capability-boundaries.md` 判定，不得把「CLI 没暴露」写成「平台不支持」。
-   - 每张表单建表前确认初始布局类型 **FLOW / EXCEL**（该初始类型建后不可切换；已有表单可另建不同类型的视图布局）；出现布局样表时按 `references/form/layout/planning.md` 解析。
-   - 按 `references/common/map.md` 识别资源与依赖，按 `references/common/guide-plan-template.md` 写 `plan.md`；每条要求有归属和来源，布局样表逐行保留，禁止预勾。
-   - 写完打开 `plan.md` 与用户**一次集中确认**（此时所有 `[ ]` 保持未勾；只有新的实质业务选择才再次询问）。
-3. **执行**：最多三段，每段结束停下确认。
-   - 段① 应用、角色、表单与视图；段② 流程与自动化；段③ 报表、菜单与页面。
-   - 以 plan 为唯一清单，按功能批次执行，逐项销号并回填真实 ID；无法完成的保留 `[ ]` 并注明原因。
-   - 0.1 中 P0/阻断项未解决、或用户未确认前不进入写入；执行中出现新的实质业务选择才再次确认。
-   - 布局样表：仍由 CLI 创建字段与初始布局；明确要求还原图片/XLSX 样式时读 `references/form/layout/source-restoration.md`（先实际观察、经用户确认样式，再 compile/apply）。
-
-**关键约束**
-- 配置必须通过当前 `e10-cli` 支持的命令完成；没有对应命令就如实告知，不得写临时 `.mjs` 脚本或让用户操作浏览器代做。能力边界见 `references/common/capability-boundaries.md`；结论必须带证据等级（实测/回读字段/命令表/未证实）。
-- Windows 环境，注意命令行兼容性；少说废话，直接干活。
-- 写代码按模板直接出完整代码，写完用 `e10-cli check` 验证。
-- 解析 Word 用 `e10-cli docx read`，禁止自写 python-docx；必须逐张 Read `_images/` 图片并写回 md，布局表格保留空白、同排与合并关系。
-
----
-
-## 决策树
-
-> **根据用户需求自动加载对应子文档，不要一次性读取全部 reference。**
->
-> **动作流两种用法**：动作流「生成」一律走 native `e10-cli actionflow generate`（语义 plan → 编译 → preflight → 保存并启用 → 正式回读，event 节点自带流程节点触发绑定，**推荐**）；`e10-cli workflow action` 仅作动作流管理（`list-node`/`clear-node` 查清节点绑定、`delete`/`disable`/`batch-delete` 禁用删除动作流 app）。本表字段赋值/节点附加操作（actionType=0）用 `e10-cli workflow save-action`。
-> ```bash
-> e10-cli actionflow component-list                          # 列已登记组件
-> e10-cli actionflow component-describe <type>               # 读组件契约
-> e10-cli actionflow generate '{"planFile":"@plan.json","appName":"AI-名称"}'  # 生成+保存并启用+正式回读；planFile 必须以 @ 引用文件（@plan.json 或 @绝对路径），CLI 强制要求 @ 前缀
-> e10-cli workflow action list-node <wf> <node>             # 查节点绑定；clear-node 清；delete/disable 删动作流
-> ```
-
-| 用户关键词 | 加载文档 |
-|-----------|---------|
-| 表单布局源码、表单级 ecode、表单 JS 代码块、JSSDK、代码校验、明细代码汇总、字段事件脚本、表单组件复写 | 先读 `references/form/layout/code-block/code-block-guide.md` 选代码层级和 CLI 写入命令，再按效果读取该目录对应 JSSDK 专题；**布局源码 ecode 由 CLI 编码，不要手改 `sourceCode.ecode`；手工调接口必须用 `encodeURI`，不能用 `encodeURIComponent`（设计器用 `decodeURI` 读取）** |
-| 写plan、搭建计划、plan.md、资源梳理、搭建模板、必做项清单、完整实施方案、需求映射、能力地图、跨资源依赖、**方案澄清、可行性预检、哪些做不到**、平台架构、Ecode、Ebuilder应用、默认台账与菜单 | 先读 `references/common/map.md` 识别资源、配置与依赖；做 0.1 方案澄清与可行性预检时同时读 `references/common/capability-boundaries.md`；再按 `references/common/guide-plan-template.md` 写资源清单与功能批次 plan |
-| 安装、升级、装不上、skill remove、skill sync、references 文档缺失、WorkBuddy | `references/common/guide-install.md` |
-| 支不支持、能不能做、能力边界、不支持的能力、**证据等级、CLI 没暴露** | `references/common/capability-boundaries.md`（结论必须带证据等级，命令表不能当平台不支持） |
-| 建应用、创建应用、app、应用列表、应用详情、应用目录、app read/list/folder/edit/delete | `references/common/ref-cli-commands.md` |
-| 启用应用、停用应用、发布到前台、发布应用、取消发布、应用发布信息、前台入口、应用名多语言、应用英文名、app enable/disable/publish/unpublish/publish-info、app lang | `references/app/guide-app-publish.md`（启用→发布→改发布信息→取消发布的先后关系 + 停用会收回发布态 + 多语言整份写回） |
-| 字段联动、字段值带出、HRM 属性带出、relateFrom、form relate、跨表带出赋值、FormDataLinkage、多跳带出、关联客户带出客户类型、field-linkage、Text字段赋值名称 | `references/form/guide-field-linkage.md`（按来源选择直接带出、HRM 带出或跨表查询赋值；含单跳/多跳与 --hops 格式） |
-| 函数联动、本表字段间公式赋值、赋值式公式、EXCEL 公式联动、字段自动计算、form formula-linkage、wf-form formula-linkage、流程表单函数联动、触发事件、模块字段不能作目标 | `references/form/guide-formula-linkage.md`（四套联动对比 + 赋值式语法 + 触发事件表 + 模块字段 + 流程表单那条路由 + 常见报错） |
-| 鉴权、登录、ETEAMSID、多环境、profile、切换环境 | `references/auth/guide-auth.md` |
-| 表单数据读写、formClient、list/get/save/update/remove、values/display/items、options、optionId、optionIds、optionMap、detailRows、subFormId、回读校验、字段类型 | `references/coding/guide-form-crud.md`（前端代码；一个表单一个 client） |
-| form data add、form data list、form data delete、写入数据、查询数据、删除数据 | `references/form/guide-form-data.md` |
-| 编辑回显、handleEdit、row.values、row.display、row.items、Browser/Upload 回填、数据回填 | `references/coding/guide-edit-backfill.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/layout/layout-overview.md`（先按任务选择独立能力） |
-| 流程表单多套布局、节点独立布局、布局绑定和回落默认 | `references/form/layout/workflow-layout.md`（表单布局与节点引用的关系；具体节点操作继续读流程指南） |
-| Excel样式、表格式布局、布局样表、布局蓝图、标签字段交替、合并单元格 | `references/form/layout/planning.md` |
-| 完整布局 JSON、布局文档导出、整体编辑差异预览、formLayout 大范围调整 | `references/form/layout/document.md`（导出底稿、预览完整差异、单次应用并回读） |
-| 还原图片样式、还原Excel样式、XLSX布局、源网格、pageLayouts、layout extract/compile/apply/verify/style-audit、已有字段位置匹配 | `references/form/layout/source-restoration.md`（图片 imageStyles 三层投影与样式诊断；已有字段复用，纯布局编译、单次保存和独立回读） |
-| 流程、审批、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-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` |
-| 分支条件、出口条件、条件JSON、save-condition、连线条件 | `references/workflow/guide-workflow-condition.md` |
-| 动作流、跨表单、写入台账、ActionEbAdd/ActionEbUpdate/ActionEbDelete、提交事件、数据来源、requestId、按流程定位、回写数据ID、HTTP/HTTPS、DML/数仓、自定义事件、内置 MQ | `references/workflow/guide-workflow-action.md`（动作流生成走 `e10-cli actionflow generate`；`workflow action` 仅查/清/删/禁用；本表字段赋值走 `save-action`；复杂组件契约按需读取 `actionflows/SKILL.md` 及其 `references/components/`） |
-| 菜单、导航、左侧菜单、系统页面、待办、已办、流程监控、菜单改名、重命名菜单、菜单排序、菜单顺序、放第一个、menu order、showOrder、--first | `references/menu/system-menus.md` |
-| 新页面、导出、路由、entry.js、asyncImport、${appId} 固定写法、appId 填数字 | `references/coding/guide-page-export.md`（前端代码） |
-| 写页面、页面代码、React编码、组件、entry.js模板、formClient、字段常量 | `references/coding/guide-page-code.md`（前端代码） |
-| HTML 原型还原、HTML 转 React、原型 CSS、复用样式、不写 CSS、class/className、内联 style、浮层、Portal、CSS 作用域 | `references/coding/guide-html-to-react.md`（前端代码） |
-| CLI命令、打包、build、import、创建应用/表单/菜单 | `references/common/ref-cli-commands.md` |
-| 编译报错、语法不支持、babel | `references/coding/ref-compile-rules.md`（前端代码） |
-| Word文档、docx、需求文档、解析文档 | `e10-cli docx read` 一键转换，禁止自己写脚本 |
-| 接口文档、Postman、系统接口、批量导入接口、创建连接器接口 | `references/esb-interface/guide-import.md`；使用 `e10-cli interface import` |
-| 新建视图、表格视图、看板、日历、思维导图、form view、台账显示列、显示列、list-columns、搜索条件、排序、list-sort、上下级、父级、树形展示、上级类型、list-hierarchy、视图数据条件、list-filter、日期占位符、{date}、{curryear}、动态日期 | `references/form/guide-form-view.md` |
-| 视图权限、查看布局、修改共享权限、view permission | `references/form/guide-form-view-permission.md` |
-| EBuilder关联、关联表单、数据过滤设置、ebuilder-filter、EBuilder显示列、ebuilder-columns、去掉系统字段、只留业务字段 | `references/form/guide-ebuilder-filter.md` |
-| 浏览数据定义、浏览弹窗高级搜索、浏览数据范围、浏览 Tab、可配置浏览字段 | `references/form/guide-browser-definition.md`；包含高级搜索、数据范围、浏览 Tab 三部分，关联 EBuilder 字段的简便范围规则也在该指南中 |
-| 字段分组、分组容器、字段分段、基本信息/合同信息分段、Collapse、Fold、字段归组 | `references/form/layout/planning.md`（**按需**：用户明确要求字段分组才在 fields.json 写 `group`，默认不加分组） |
-| 独占一行、整行显示、字段换行、singleRow、--single-row | `references/form/layout/planning.md`（fields.json 字段写 `"singleRow":true`；add-field 用 `--single-row`） |
-| 布局样式模板分类、公共规则、layout init、style-template | `references/form/layout/template/template-guide.md`（简易、高级、流式分别链接） |
-| 给已有表单加字段、改必填/只读、表单不是自己建的、--reinit、布局被重建、字段在布局里对不上、字段标题显示不出来 | `references/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(开始,结束)`**） |
-| 显示列批量设置、批量加列、列宽、列顺序、list-columns --set | `references/form/guide-list-columns.md` |
-| 顶部统计、明细统计、付款记录数、list-stats、子表计数 | `references/form/guide-list-stats.md` |
-| 关联页签、关联视图、association、页签显示布局、关联数据筛选、set-filter | `references/form/guide-form-association.md` |
-| 表单按钮、button、自定义按钮、视图按钮、行上、行末下拉、右上、打开视图、打开布局、发起流程、按钮预填、按钮字段映射、action-set | `references/form/guide-form-button.md`；`references/common/ref-cli-commands.md` |
-| 表单消息提醒、消息提醒、表单数据提醒、数据变动提醒、新增数据提醒、form message、提醒对象、推送渠道、IM提醒、云桥、短信提醒 | `references/form/guide-form-message.md`（表单数据新建/修改/删除时提醒人；列表是应用级、`--obj-id` 本地收口；提醒对象四类写法与同名歧义处理） |
-| 流程消息、编号规则、超时处理、退回设置、指定流转、投票、机器人节点、公用流转片段、子流程、人员范围、节点菜单、流程设置、流程存档、节点校验、提交校验、角色/权限/成员 | `references/common/ref-cli-commands.md` |
-| 签署顺序、会签、非会签、竞签、或签、依次处理、抄送、operator-sign | `references/workflow/guide-workflow.md`；命令速查 `references/common/ref-cli-commands.md` |
-| 分类搜索、表单权限、编译/build/compile/check、skill 文档/skill sync/copy/root、CLI 命令速查 | `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、映射表、行 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`（空白行与表头合并） |
-
-> 组件文档（Button/Table/Input/Upload 等）在 `references/` 中按文件名查找。完整索引见 `_catalog.md`。
-
-> **表单自带默认台账** — 普通列表需求先查询并复用已有默认台账，记录实际名称/listId；“客户信息表／客户信息”这类简称差异不构成新建理由，默认保留原名，不统一去掉“表”字。仅名称需对齐时应改名而非另建。用户明确要求额外表格视图时，用 `form table-view create` 原子完成 `nListView` 创建、显示列配置和回读；禁止用 `form view create --type tableView` 创建空壳。`formView` 使用 `form view create` 后必须执行 `form view populate`。
-
----
-
-## 能力边界
-
-> 不支持的能力、以及「CLI 没有命令时怎么办」的判定方式 → `references/common/capability-boundaries.md`。预检结论写进 `plan.md` 0.1，证据不足时标「待环境核查/未证实」；不得把「CLI 没暴露」写成「平台不支持」。禁止声称平台/CLI 支持实际不支持的能力，禁止用临时脚本或浏览器操作绕行。
-
----
-
-## 页面编码
-
-页面是搭建的最后一步，动手前确保应用、表单、流程已建好。默认情况优先用设计器配置式页面（`page create` → `designer comp-add --template` → 绑数据 → `designer save` → `page publish-menu`），详见 `references/ebuilder-designer/guide-designer.md`；只有设计器无法满足的深度定制才用 Ecode React。
-
-**用户明确要求 Ecode、还原 HTML 原型，或说明不要设计器时，直接走 Ecode，不要再建议改用设计器。** 编码主路径见 `references/coding/guide-page-code.md`，完整样例在 `assets/sample/`；HTML 原型还原另读 `references/coding/guide-html-to-react.md`。注意 `entry.js` 里 `asyncImport('${appId}', ...)` 的第一个参数是固定字符串，不是 Ebuilder 应用 ID 或任何数字。
+---
+name: weaver-e10-builder
+display_name: 泛微E10智能搭建Skill
+display_name_en: E10 Builder
+description: 泛微E10智能搭建skill v2（通用版），辅助编写泛微Ebuilder自定义应用，对应CLI版本1.6.7
+description_zh: 泛微Ebuilder低代码应用智能搭建工具 v2（通用版），辅助编写自定义应用（表单/流程/列表/动作流/权限/分组/编号等），与 e10-cli 配套使用，当前对应 CLI 版本 1.6.7。
+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.6.7.
+category: coding
+version: 1.6.7
+author: 泛微网络科技股份有限公司
+auto: true
+---
+
+# Ebuilder 智能搭建 Skill
+
+## 使用前提
+
+- **版本必须匹配**：`e10-cli --version` 应与 frontmatter 的 `version` 一致；不一致时命令/选项/文档可能对不上。
+- **鉴权**：仅在即将远程查询或写入前运行 `e10-cli auth status`；同一连续阶段不重复检查，切换系统地址、profile 或凭证后必须重新确认。
+- **文档随 CLI 分发**：读 `references/...` 提示文件不存在时，跑 `e10-cli skill sync` 或重跑 `e10-cli auth status`。
+- 安装/升级、skill 重装、WorkBuddy 注意事项 → `references/common/guide-install.md`。
+
+## 核心理念
+
+> **默认一份完整业务方案落在一个主应用。** 需求明确指定已有应用、跨应用资源或独立业务边界时，按实际范围处理，并在 `plan.md` 中标明每项资源的所属应用和跨应用关系。
+
+```
+一份完整业务方案 → 一个主应用（默认）
+ └→ 应用下的资源: 表单 → 流程 → 菜单 → 页面
+跨应用/已有应用增强 → 按实际边界规划并明确资源归属
+```
+
+接到需求不要一上来就写页面代码。先想清楚这一个应用下需要哪些表单、字段怎么设计、流程怎么走。
+
+**能力范围**：应用与资源、表单与字段、视图与按钮、流程与动作流、设计器报表、权限、页面、数据操作，以及从接口文档批量创建 ESB 系统接口。具体能力、命令与限制以本页决策树路由到的 `_catalog.md` 和 `references/` 为准；规划时应一次覆盖需求中已明确的配置项，不因主文档未枚举某条命令而遗漏。
+
+---
+
+## 流程类型与默认路径
+
+默认使用 **EB 表单**及应用内流程。只有需求明确要求原生流程表单、工作流程或流程中心建流程时，才切换到 `wf-form` / `workflow create-workflow`；不确定且选择会改变资源归属时，先向用户确认。EB 流程与原生工作流程的表单、资源 ID、接口不可混用；公文流程是原生工作流程的特殊类型。详见 `references/workflow/guide-workflow.md`。
+
+---
+
+## 执行流程
+
+面向非编程用户：主动把模糊需求翻译成精确的资源设计。
+
+0. **环境**：仅在即将远程查询/写入前跑 `e10-cli auth status`；切已有环境用 `auth profile use <name>`，新环境用 `auth set --eteamsid "<ETEAMSID>" --base-url <url>`（ETEAMSID 从浏览器 Cookies 复制，不走 `auth login`）。
+1. **判断复杂度**：涉及 2+ 模块（应用/表单/流程/页面）→ 进入规划；单步改字段、查数据 → 直接执行。
+2. **规划**（复杂需求必经）：
+   - 先写 **0.1 方案澄清与可行性预检**：需求理解、待确认项（问题/选项/建议/影响/决策）、可做/部分可做/做不到及证据等级、验收判据；按 `references/common/capability-boundaries.md` 判定，不得把「CLI 没暴露」写成「平台不支持」。
+   - 每张表单建表前确认初始布局类型 **FLOW / EXCEL**（该初始类型建后不可切换；已有表单可另建不同类型的视图布局）；出现布局样表时按 `references/form/layout/planning.md` 解析。
+   - 按 `references/common/map.md` 识别资源与依赖，按 `references/common/guide-plan-template.md` 写 `plan.md`；每条要求有归属和来源，布局样表逐行保留，禁止预勾。
+   - 写完打开 `plan.md` 与用户**一次集中确认**（此时所有 `[ ]` 保持未勾；只有新的实质业务选择才再次询问）。
+3. **执行**：最多三段，每段结束停下确认。
+   - 段① 应用、角色、表单与视图；段② 流程与自动化；段③ 报表、菜单与页面。
+   - 以 plan 为唯一清单，按功能批次执行，逐项销号并回填真实 ID；无法完成的保留 `[ ]` 并注明原因。
+   - 0.1 中 P0/阻断项未解决、或用户未确认前不进入写入；执行中出现新的实质业务选择才再次确认。
+   - 布局样表：仍由 CLI 创建字段与初始布局；明确要求还原图片/XLSX 样式时读 `references/form/layout/source-restoration.md`（先实际观察、经用户确认样式，再 compile/apply）。
+
+**关键约束**
+- 配置必须通过当前 `e10-cli` 支持的命令完成；没有对应命令就如实告知，不得写临时 `.mjs` 脚本或让用户操作浏览器代做。能力边界见 `references/common/capability-boundaries.md`；结论必须带证据等级（实测/回读字段/命令表/未证实）。
+- Windows 环境，注意命令行兼容性；少说废话，直接干活。
+- 写代码按模板直接出完整代码，写完用 `e10-cli check` 验证。
+- 解析 Word 用 `e10-cli docx read`，禁止自写 python-docx；必须逐张 Read `_images/` 图片并写回 md，布局表格保留空白、同排与合并关系。
+
+---
+
+## 决策树
+
+> **根据用户需求自动加载对应子文档，不要一次性读取全部 reference。**
+>
+> **动作流两种用法**：动作流「生成」一律走 native `e10-cli actionflow generate`（语义 plan → 编译 → preflight → 保存并启用 → 正式回读，event 节点自带流程节点触发绑定，**推荐**）；`e10-cli workflow action` 仅作动作流管理（`list-node`/`clear-node` 查清节点绑定、`delete`/`disable`/`batch-delete` 禁用删除动作流 app）。本表字段赋值/节点附加操作（actionType=0）用 `e10-cli workflow save-action`。
+> ```bash
+> e10-cli actionflow component-list                          # 列已登记组件
+> e10-cli actionflow component-describe <type>               # 读组件契约
+> e10-cli actionflow generate '{"planFile":"@plan.json","appName":"AI-名称"}'  # 生成+保存并启用+正式回读；planFile 必须以 @ 引用文件（@plan.json 或 @绝对路径），CLI 强制要求 @ 前缀
+> e10-cli workflow action list-node <wf> <node>             # 查节点绑定；clear-node 清；delete/disable 删动作流
+> ```
+
+| 用户关键词 | 加载文档 |
+|-----------|---------|
+| 表单布局源码、表单级 ecode、表单 JS 代码块、JSSDK、代码校验、明细代码汇总、字段事件脚本、表单组件复写 | 先读 `references/form/layout/code-block/code-block-guide.md` 选代码层级和 CLI 写入命令，再按效果读取该目录对应 JSSDK 专题；**布局源码 ecode 由 CLI 编码，不要手改 `sourceCode.ecode`；手工调接口必须用 `encodeURI`，不能用 `encodeURIComponent`（设计器用 `decodeURI` 读取）** |
+| 写plan、搭建计划、plan.md、资源梳理、搭建模板、必做项清单、完整实施方案、需求映射、能力地图、跨资源依赖、**方案澄清、可行性预检、哪些做不到**、平台架构、Ecode、Ebuilder应用、默认台账与菜单 | 先读 `references/common/map.md` 识别资源、配置与依赖；做 0.1 方案澄清与可行性预检时同时读 `references/common/capability-boundaries.md`；再按 `references/common/guide-plan-template.md` 写资源清单与功能批次 plan |
+| 安装、升级、装不上、skill remove、skill sync、references 文档缺失、WorkBuddy | `references/common/guide-install.md` |
+| 支不支持、能不能做、能力边界、不支持的能力、**证据等级、CLI 没暴露** | `references/common/capability-boundaries.md`（结论必须带证据等级，命令表不能当平台不支持） |
+| 建应用、创建应用、app、应用列表、应用详情、应用目录、app read/list/folder/edit/delete | `references/common/ref-cli-commands.md` |
+| 启用应用、停用应用、发布到前台、发布应用、取消发布、应用发布信息、前台入口、应用名多语言、应用英文名、app enable/disable/publish/unpublish/publish-info、app lang | `references/app/guide-app-publish.md`（启用→发布→改发布信息→取消发布的先后关系 + 停用会收回发布态 + 多语言整份写回） |
+| 字段联动、字段值带出、HRM 属性带出、relateFrom、form relate、跨表带出赋值、FormDataLinkage、多跳带出、关联客户带出客户类型、field-linkage、Text字段赋值名称 | `references/form/guide-field-linkage.md`（按来源选择直接带出、HRM 带出或跨表查询赋值；含单跳/多跳与 --hops 格式） |
+| 函数联动、本表字段间公式赋值、赋值式公式、EXCEL 公式联动、字段自动计算、form formula-linkage、wf-form formula-linkage、流程表单函数联动、触发事件、模块字段不能作目标 | `references/form/guide-formula-linkage.md`（四套联动对比 + 赋值式语法 + 触发事件表 + 模块字段 + 流程表单那条路由 + 常见报错） |
+| 鉴权、登录、ETEAMSID、多环境、profile、切换环境 | `references/auth/guide-auth.md` |
+| 表单数据读写、formClient、list/get/save/update/remove、values/display/items、options、optionId、optionIds、optionMap、detailRows、subFormId、回读校验、字段类型 | `references/coding/guide-form-crud.md`（前端代码；一个表单一个 client） |
+| form data add、form data list、form data delete、写入数据、查询数据、删除数据 | `references/form/guide-form-data.md` |
+| 编辑回显、handleEdit、row.values、row.display、row.items、Browser/Upload 回填、数据回填 | `references/coding/guide-edit-backfill.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/layout/layout-overview.md`（先按任务选择独立能力） |
+| 流程表单多套布局、节点独立布局、布局绑定和回落默认 | `references/form/layout/workflow-layout.md`（表单布局与节点引用的关系；具体节点操作继续读流程指南） |
+| Excel样式、表格式布局、布局样表、布局蓝图、标签字段交替、合并单元格 | `references/form/layout/planning.md` |
+| 完整布局 JSON、布局文档导出、整体编辑差异预览、formLayout 大范围调整 | `references/form/layout/document.md`（导出底稿、预览完整差异、单次应用并回读） |
+| 还原图片样式、还原Excel样式、XLSX布局、源网格、pageLayouts、layout extract/compile/apply/verify/style-audit、已有字段位置匹配 | `references/form/layout/source-restoration.md`（图片 imageStyles 三层投影与样式诊断；已有字段复用，纯布局编译、单次保存和独立回读） |
+| 流程、审批、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-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` |
+| 分支条件、出口条件、条件JSON、save-condition、连线条件 | `references/workflow/guide-workflow-condition.md` |
+| 动作流、跨表单、写入台账、ActionEbAdd/ActionEbUpdate/ActionEbDelete、提交事件、数据来源、requestId、按流程定位、回写数据ID、HTTP/HTTPS、DML/数仓、自定义事件、内置 MQ | `references/workflow/guide-workflow-action.md`（动作流生成走 `e10-cli actionflow generate`；`workflow action` 仅查/清/删/禁用；本表字段赋值走 `save-action`；复杂组件契约按需读取 `actionflows/SKILL.md` 及其 `references/components/`） |
+| 菜单、导航、左侧菜单、系统页面、待办、已办、流程监控、菜单改名、重命名菜单、菜单排序、菜单顺序、放第一个、menu order、showOrder、--first | `references/menu/system-menus.md` |
+| 新页面、导出、路由、entry.js、asyncImport、${appId} 固定写法、appId 填数字 | `references/coding/guide-page-export.md`（前端代码） |
+| 写页面、页面代码、React编码、组件、entry.js模板、formClient、字段常量 | `references/coding/guide-page-code.md`（前端代码） |
+| HTML 原型还原、HTML 转 React、原型 CSS、复用样式、不写 CSS、class/className、内联 style、浮层、Portal、CSS 作用域 | `references/coding/guide-html-to-react.md`（前端代码） |
+| CLI命令、打包、build、import、创建应用/表单/菜单 | `references/common/ref-cli-commands.md` |
+| 编译报错、语法不支持、babel | `references/coding/ref-compile-rules.md`（前端代码） |
+| Word文档、docx、需求文档、解析文档 | `e10-cli docx read` 一键转换，禁止自己写脚本 |
+| 接口文档、Postman、系统接口、批量导入接口、创建连接器接口 | `references/esb-interface/guide-import.md`；使用 `e10-cli interface import` |
+| 新建视图、表格视图、看板、日历、思维导图、form view、台账显示列、显示列、list-columns、搜索条件、排序、list-sort、上下级、父级、树形展示、上级类型、list-hierarchy、视图数据条件、list-filter、日期占位符、{date}、{curryear}、动态日期 | `references/form/guide-form-view.md` |
+| 视图权限、查看布局、修改共享权限、view permission | `references/form/guide-form-view-permission.md` |
+| EBuilder关联、关联表单、数据过滤设置、ebuilder-filter、EBuilder显示列、ebuilder-columns、去掉系统字段、只留业务字段 | `references/form/guide-ebuilder-filter.md` |
+| 浏览数据定义、浏览弹窗高级搜索、浏览数据范围、浏览 Tab、可配置浏览字段 | `references/form/guide-browser-definition.md`；包含高级搜索、数据范围、浏览 Tab 三部分，关联 EBuilder 字段的简便范围规则也在该指南中 |
+| 字段分组、分组容器、字段分段、基本信息/合同信息分段、Collapse、Fold、字段归组 | `references/form/layout/planning.md`（**按需**：用户明确要求字段分组才在 fields.json 写 `group`，默认不加分组） |
+| 独占一行、整行显示、字段换行、singleRow、--single-row | `references/form/layout/planning.md`（fields.json 字段写 `"singleRow":true`；add-field 用 `--single-row`） |
+| 布局样式模板分类、公共规则、layout init、style-template | `references/form/layout/template/template-guide.md`（简易、高级、流式分别链接） |
+| 给已有表单加字段、改必填/只读、表单不是自己建的、--reinit、布局被重建、字段在布局里对不上、字段标题显示不出来 | `references/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(开始,结束)`**） |
+| 显示列批量设置、批量加列、列宽、列顺序、list-columns --set | `references/form/guide-list-columns.md` |
+| 顶部统计、明细统计、付款记录数、list-stats、子表计数 | `references/form/guide-list-stats.md` |
+| 关联页签、关联视图、association、页签显示布局、关联数据筛选、set-filter | `references/form/guide-form-association.md` |
+| 表单按钮、button、自定义按钮、视图按钮、行上、行末下拉、右上、打开视图、打开布局、发起流程、按钮预填、按钮字段映射、action-set | `references/form/guide-form-button.md`；`references/common/ref-cli-commands.md` |
+| 表单消息提醒、消息提醒、表单数据提醒、数据变动提醒、新增数据提醒、form message、提醒对象、推送渠道、IM提醒、云桥、短信提醒 | `references/form/guide-form-message.md`（表单数据新建/修改/删除时提醒人；列表是应用级、`--obj-id` 本地收口；提醒对象四类写法与同名歧义处理） |
+| 流程消息、编号规则、超时处理、退回设置、指定流转、投票、机器人节点、公用流转片段、子流程、人员范围、节点菜单、流程设置、流程存档、节点校验、提交校验、角色/权限/成员 | `references/common/ref-cli-commands.md` |
+| 签署顺序、会签、非会签、竞签、或签、依次处理、抄送、operator-sign | `references/workflow/guide-workflow.md`；命令速查 `references/common/ref-cli-commands.md` |
+| 分类搜索、表单权限、编译/build/compile/check、skill 文档/skill sync/copy/root、CLI 命令速查 | `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、映射表、行 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`（空白行与表头合并） |
+
+> 组件文档（Button/Table/Input/Upload 等）在 `references/` 中按文件名查找。完整索引见 `_catalog.md`。
+
+> **表单自带默认台账** — 普通列表需求先查询并复用已有默认台账，记录实际名称/listId；“客户信息表／客户信息”这类简称差异不构成新建理由，默认保留原名，不统一去掉“表”字。仅名称需对齐时应改名而非另建。用户明确要求额外表格视图时，用 `form table-view create` 原子完成 `nListView` 创建、显示列配置和回读；禁止用 `form view create --type tableView` 创建空壳。`formView` 使用 `form view create` 后必须执行 `form view populate`。
+
+---
+
+## 能力边界
+
+> 不支持的能力、以及「CLI 没有命令时怎么办」的判定方式 → `references/common/capability-boundaries.md`。预检结论写进 `plan.md` 0.1，证据不足时标「待环境核查/未证实」；不得把「CLI 没暴露」写成「平台不支持」。禁止声称平台/CLI 支持实际不支持的能力，禁止用临时脚本或浏览器操作绕行。
+
+---
+
+## 页面编码
+
+页面是搭建的最后一步，动手前确保应用、表单、流程已建好。默认情况优先用设计器配置式页面（`page create` → `designer comp-add --template` → 绑数据 → `designer save` → `page publish-menu`），详见 `references/ebuilder-designer/guide-designer.md`；只有设计器无法满足的深度定制才用 Ecode React。
+
+**用户明确要求 Ecode、还原 HTML 原型，或说明不要设计器时，直接走 Ecode，不要再建议改用设计器。** 编码主路径见 `references/coding/guide-page-code.md`，完整样例在 `assets/sample/`；HTML 原型还原另读 `references/coding/guide-html-to-react.md`。注意 `entry.js` 里 `asyncImport('${appId}', ...)` 的第一个参数是固定字符串，不是 Ebuilder 应用 ID 或任何数字。

package/skill-docs/_catalog.md

@@ -22,7 +22,7 @@
 | 虚拟表、虚拟表单、数据源表单、业务表展示、数据加工结果 | `references/form/guide-virtual-form.md` |
 | 字段定义、字段类型、关联字段码表、DateRange、multiple | `references/form/ref-form-fields.md` |
 | 表单布局管理、编辑、初始化、代码块、模板与源样式还原 | `references/form/layout/layout-overview.md`（统一入口） |
-| 流程表单多套布局、节点绑定、节点回落默认 | `references/form/layout/workflow-layout.md`（节点细节继续读流程指南） |
+| 流程表单多套布局、节点绑定、节点回落默认、布局改名、修改布局名称/描述、wf-form layout rename、设置默认布局、切换默认布局、wf-form layout set-default、流程系统字段、系统字段摆进布局、提交人/提交人部门/提交时间/流程编号/流程标题/紧急程度/流程状态/工作流名称、add-system-field | `references/form/layout/workflow-layout.md`（节点细节继续读流程指南） |
 | FLOW/EXCEL、布局样表、布局蓝图、字段分组、singleRow | `references/form/layout/planning.md` |
 | 布局样式模板总览、公共规则、form layout init | `references/form/layout/template/template-guide.md`（分类入口） |
 | 表格式简易模板新增、编辑、预览 | `references/form/layout/template/easy.md` |

package/skill-docs/references/common/ref-cli-commands.md

@@ -94,7 +94,7 @@
 | `e10-cli form serial-mark set <objId> <appId> <fieldId> --segments @<json>` | **表单编号**（纯建模表）：用 JSON 数组组合任意编号规则，数组顺序即拼接顺序。段类型 `fixed`/`year`/`serial`/`field`/`system`/`date`；field 段可 inline `shortName` 代字映射。子命令组：`set`(配置,--segments) / `add-segment`(增量追加段) / `short-name`(代字 list/set) / `read`(查看) / `fields`(查可绑定字段) / `enable`(启用) / `disable`(停用，可加 `--field <fieldId>` 只停某一个字段的编号) / `clear`(解除绑定)。**`disable` 停用 ≠ `clear` 解除**：停用只关开关（`isUse=0`），绑定记录与组成段原样保留、可 `enable` 恢复；解除走删除接口，绑定不可逆。要「暂时不生成编号」一律用 `disable`。被编码字段平台自动只读。**⚠ 仅对未绑流程的纯建模表有效——eb表单绑流程后表单编号字段在流程提交时不生效，编号改走流程编号（`workflow numbering`，落到 REQUEST_NO 系统字段）** |
 | `e10-cli form field-options <objId> <appId> <fieldId> --options @<json> [--default <key>]` | 设选项/默认值。options.json: `[{"name":"选项名","valueKey":"可选"}]`；`--default` 用平台生成的长 valueKey（`form read --app-id` 获取），不是 name |
 | `e10-cli form option-template <list\|read\|create\|copy\|delete>` | **Select 选项预设模板管理**（下拉选项复用：多个表单共享一套选项，模板改了各表单跟着变）。`list [--system]` 列模板（默认自定义模板，--system 看系统内置）；`read <模板ID> [--flat]` 看选项树；`create <名称> --options @<json> [--level 1] [--describe 文本]` 建模板（options.json: `[{"name":"低","valueKey":"10","children":[]}]`，**valueKey 必须数字**，children 嵌套=多级）；`copy <模板ID>` 复制（系统 default 模板不可复制）；`delete <模板ID>` 删模板（被引用时平台拒绝）。**字段引用模板**：`form add-field --option-template <模板ID或名>` 或 fields.json 写 `"optionTemplate":"模板名"`（Select 专有，选项不内联） |
-| `e10-cli form linkage add <appId> <objId> <name> --config @<json> [--disabled]` | 新增显示属性联动，默认启用。条件可用 `conditions[]`（含字段对字段和结构化常量），或布尔 `formula` / `formulaId`；`detailType` 为 AND/OR，`effect` 可指定表单或布局。动作对象支持字段、选项、明细表及布局组件。详见 `form/guide-form-linkage.md` |
+| `e10-cli form linkage add <appId> <objId> <name> --config @<json> [--disabled]` | 新增显示属性联动，默认启用。条件按**字段 ID**（`conditions[].fieldId`，用 `form read` 查）或布尔 `formula` / `formulaId`；算子仅 EQUAL/GREATER/LESS/GREATER_EQUAL/LESS_EQUAL/NULL/NOT_NULL（不等于/包含/不包含平台写不进，改用公式），未知或不可用算子本地报错。`detailType` 为 AND/OR，`effect` 可指定表单或布局。动作对象支持字段、选项、明细表及布局组件（字段目标同样要 `fieldId`）。详见 `form/guide-form-linkage.md` |
 | `e10-cli form linkage list|get|layout-targets|state|update|delete ...` | `list` 查列表，`get <appId> <objId> <id> --json` 读详情，`layout-targets <appId> <objId>` 查可选布局组件，`state <appId> <objId> <id> --set on\|off` 启停，`update <appId> <objId> <id> [--name] [--config @json]` 读-改-写，`delete <appId> <objId> <id>` 删除并回读。更新只替换显式提供的部分；`actions` 为整组替换 |
 | `e10-cli form-engine linkage fields|targets|add|list|get|state|update|delete ... --module workflow\|biaoge` | 非 EB 表单引擎模块的显示属性联动。先查系统/表单触发字段及可变更目标；`add <formId> <名称> --config @json`，其余命令按 `<formId> [规则ID]` 定位。原生流程的流程／节点生效范围可加 `--workflow-id`；具体 JSON 与支持边界见 `form/guide-form-linkage.md` |
 | `e10-cli form relate <appId> <objId> <目标字段> --from <源字段>` | **HRM 值带出联动**：源字段为表内 Employee（人员）或 Department（部门）类型，换源自动填目标字段（换申请人→填邮箱/工号/部门；换所属部门→填部门编号/上级部门）。`--key` 从平台清单校验（默认 Employee=department、Department=name），`--title` 指定显示名（默认属性中文名）。详见 `form/guide-form-linkage.md` |
@@ -114,8 +114,8 @@
 | `e10-cli form list-click <objId> <appId> <listId> <fieldId> [--target <formObjId>] [--open-mode <模式>] [--win-size <尺寸>] [--clear] [--pc-only]` | 设置台账列**点击跳转**。`--open-mode` 支持当前页面/新窗口/弹出窗口/右侧滑出/右侧推出；`--win-size` 仅用于滑出/推出，具体数值按需求填写：百分比使用 `%`（0～100），像素使用 `px`，两种单位不可混用。缺省 `800px` |
 | `e10-cli form ebuilder-columns <objId> <appId> <fieldId> [字段名/ID...] [--clear]` | 设置 EBuilder 关联字段的**浏览显示列**（存在字段配置 `ffDisplayColumns:{id,name}[]`）。**缺省查看**：列出当前显示列 + 目标表单全部**业务字段候选**（系统字段已自动过滤，不设显示列时浏览走平台默认列会带系统字段）；**传目标表业务字段名/ID 设置**，系统字段会被拦截提示"系统字段不能设为显示列"；`--clear` 清空。关联浏览显示哪些字段（只留业务字段） |
 | `e10-cli form ebuilder-scope <get\|set\|clear> <objId> <appId> <fieldId>` | **浏览数据定义 → 数据范围设置**（关联浏览字段，限定被关联数据须满足条件才可选，如关联客户只选"客户状态=启用"的）。走 `browserDataScope` 接口（独立于字段布局）。`set --rules '[{"field":"客户状态","operator":"eq","value":"启用"}]'`（选项类 value 用选项名，CLI 自动解析 valueKey）；`--logic and/or` 多规则关系；`--fill-null` 关联字段为空时填充；`get` 读已设条件；`clear` 清空。**这是关联浏览筛选的正解**，旧 `ebuilder-filter` 走 layout/save 不被设计器识别 |
-| `e10-cli form-engine browser-definition inspect\|describe <formId> [<fieldId>] --module ebuilderform\|workflow\|biaoge [--app-id <appId>] [--workflow-id <id>]` | 先列出表单内可配置的浏览字段、各字段高级搜索／范围／Tab 的平台支持和 CLI 适配状态；再查询指定字段的候选项与当前配置。EB 表单须提供 `--app-id`。工作流程表单在表单引擎中没有独立入口，须到所属工作流程的「高级设置 → 浏览数据定义」配置；CLI 用关联表单 ID 加 `--module workflow --workflow-id <流程ID>`。详见 `form/guide-browser-definition.md` |
-| `e10-cli form-engine browser-definition search\|scope\|tabs get\|set <formId> <fieldId> --module ...` | 按字段已开放的能力分别配置高级搜索、数据范围和浏览 Tab；`get` 先读候选结构与现值，`set` 写入并回读。不同浏览来源走不同适配器，未适配项明确拒绝。详见 `form/guide-browser-definition.md` |
+| `e10-cli form-engine browser-definition inspect\|describe <formId> [<fieldId>] --module ebuilderform\|workflow\|biaoge [--app-id <appId>] [--workflow-id <id>]` | 先列出表单内可配置的浏览字段、各字段高级搜索／范围／Tab 的平台支持和 CLI 适配状态；再查询指定字段的候选项与当前配置。EB 表单须提供 `--app-id`。**表单绑定工作流程时，浏览数据定义必须在流程的「高级设置 → 浏览数据定义」配置；表单级记录与流程记录是两套数据，流程只读自己的记录，表单上的同名字段配置对流程等于无效，不是被流程配置覆盖。** CLI 用关联表单 formId 加 `--module workflow --workflow-id <流程ID>`。详见 `form/guide-browser-definition.md` |
+| `e10-cli form-engine browser-definition search\|scope\|tabs get\|set <formId> <fieldId> --module ...` | 按字段已开放的能力分别配置高级搜索、数据范围和浏览 Tab；`get` 先读候选结构与现值，`set` 写入并回读。不同浏览来源走不同适配器，未适配项明确拒绝。**流程场景必须带 `--module workflow --workflow-id <流程ID>`；`form ebuilder-scope` 的表单级配置不会写入流程高级设置，也不会在流程中生效。** 详见 `form/guide-browser-definition.md` |
 | `e10-cli form validate list <objId> <appId>` | 查看表单**查重规则**（字段重复校验，多字段 AND）。`add <objId> <appId> <字段名...> [--help 提示] [--remind]` 新增（缺省禁止提交 NOSUBMISSION，`--remind` 仅提醒）。**`--help` 会建成多语言标签、存的是标签 id**（平台只收 id，传文本会被拒「提示内容格式不正确」；`list` 会解回文本显示，缓存原因刚建完约 10 秒内可能仍显示 id）；`update <objId> <appId> <ruleId> [--fields <名...>] [--help <文本>] [--remind\|--no-remind]` **修改**（只改传入项，其余保持；**checkFields 是整组替换**，命令内部会把完整字段一起回传，不会丢字段；`--help` 支持 `#[字段名]#` 插入变量，自动转成平台片段 `<a>#[字段id]#</a>`，也支持 `@文件`）；`delete <objId> <appId> <ruleId>` 删除。项目名称重名/工时日期重复不允许 |
 | `e10-cli form add-detail-table <objId> <appId> <明细表名> [首字段名] [--no-place] [--init]` | 给**已存在的主表**加明细子表（saveSubForm 建子表 + 加首字段使其可见），**默认增量放进现有布局**（复制临时布局取平台生成的容器组件，原布局不重建）。`--data-key <物理表名>`、`--first-field-type <类型>`（默认 Text）、`--first-field-data-key <编码>`（首字段字段编码，缺省取首字段名拼音首字母，与 `add-field` 一致）。⚠ **空子表平台会过滤掉、布局里看不见**，首字段名强烈建议传；`--no-place` 只建表不排布局；`--init` 改用整表重建（会换样式模板并重排已有位置）。后续往明细里加字段用 `form add-field --sub-form-id <subFormId>`：建表时一次性带明细用 `form create` 的 fields.json `DetailTable`+`formFields`。详见 `references/form/layout/incremental.md` |
 | `e10-cli form rename-detail-table <objId> <appId> <subFormId\|明细表名> <新名称> [--describe <描述>]` | **修改明细表名称**（同步子表标题、字段引用名与布局 DetailTable 标题）。按 subFormId 或当前名称定位；保存后回读子表标题与布局标题。当前名称与旧值同名、明细表重名、读不到物理表记录 id 或回读不一致会报错；`--describe` 可选同时改描述。流程表单暂不提供 |
@@ -294,7 +294,7 @@
 | `e10-cli wf-form formula-linkage columns <formId> --workflow-id <id>` | 列出可引用/可触发的字段，按「可作 / 不可作赋值目标」分桶。字段清单取自 `findFormDrivingColumns`，**不依赖 getFormLayout**（后者在部分流程表单上会 500） |
 | `e10-cli wf-form formula-linkage add <formId> --workflow-id <id> --target <字段> --expression <函数体>` | 新增。**`--event <事件...>` 可给多个**（一条联动能挂多个触发时机），每个可自带触发字段：`--event EVENT_FORWARD --event changeField:数量,单价`。`--trigger <字段...>` 作用于没自带字段的字段级事件。`--effect form\|formLayout\|workFlow\|includeNode`（后两者需 `--workflow-id`，`includeNode` 另需 `--node`）、`--name`。表达式只给右侧，左侧自动拼。详见 `form/guide-formula-linkage.md` |
 | `e10-cli wf-form formula-linkage update <formId> --workflow-id <id> <linkageId> [--event...] [--trigger...] [--effect] [--node] [--name] [--state on\|off]` | 改触发时机/生效维度/名称/启停。**不给 `--event`/`--trigger` 就原样沿用现有的触发时机**。生效维度在「表单/布局 ↔ 工作流/节点」之间切换时**必须**同时给 `--event` |
-| `e10-cli wf-form linkage <formId> <联动名> --config '{"conditions":[{"field":"请假天数","operator":"EQUAL","value":"3"}],"actions":[{"prop":"hide","fields":["请假事由"]}]}'` | 显隐联动。`--config` 写字段名（自动解析 fieldId/dataKey）；**为空写 `NULL`（或 `EMPTY`，会归一）、不为空写 `NOT_NULL`**（写错平台报的是一句与条件无关的写库异常）。prop: hide/show/edit/readonly/required/hideLine；operator 另有 EQUAL/NOT_EQUAL/CONTAIN/GREATER/LESS 等。顶层可选 `"detailType":"AND\|OR"`（界面「所有/任一」）。**`"effect"` 指定生效维度**（这条路由有四种）：不写=当前表单、`"formLayout"`=**表单布局**、`"workFlow"`=**当前工作流**、`"includeNode"`+`"nodeId"`=**选择节点**（后两者需配 `--workflow-id`） |
+| `e10-cli wf-form linkage <formId> <联动名> --config '{"conditions":[{"field":"请假天数","operator":"EQUAL","value":"3"}],"actions":[{"prop":"hide","fields":["请假事由"]}]}'` | 显隐联动。`--config` 写字段名（自动解析 fieldId/dataKey）；**为空写 `NULL`（或 `EMPTY`，会归一）、不为空写 `NOT_NULL`**（写错平台报的是一句与条件无关的写库异常）。prop: hide/show/edit/readonly/required/hideLine；operator 可用 EQUAL/GREATER/LESS/GREATER_EQUAL/LESS_EQUAL/NULL/NOT_NULL（**不等于/包含/不包含平台写不进去，改用 `formula` 布尔公式**；中文与符号写法自动归一，未知算子本地报错）。流程绑的是 EB 卡片表单时这条命令不适用，改用 `form linkage <appId> <objId>`（`workflow info` 会给出这两个 ID）。顶层可选 `"detailType":"AND\|OR"`（界面「所有/任一」）。**`"effect"` 指定生效维度**（这条路由有四种）：不写=当前表单、`"formLayout"`=**表单布局**、`"workFlow"`=**当前工作流**、`"includeNode"`+`"nodeId"`=**选择节点**（后两者需配 `--workflow-id`） |
 | `e10-cli wf-form validate add <formId> <字段名...> [--remind] [--help <提示>]` | 字段查重规则（多字段 AND，重复禁止提交/提醒）。`list` / `update <ruleId> [--fields <名...>] [--help <文本>] [--remind\|--no-remind]` / `delete <ruleId>`。`update` 只改传入项，其余保持；**checkFields 是整组替换**，内部会把完整字段一起回传；本组的提示内容是**纯文本**（不走多语言标签）。字段名自动 getConfig 解析（含明细子字段） |
 | `e10-cli wf-form relate <formId> <目标字段> --from <Employee/Department源字段> [--key email/department/code/name] [--title <名>]` | 值带出：换表内 Employee/Department 字段自动填目标字段（HRM 属性带出）。`--key` 默认 Employee=department/Department=name。机制同 eb 表（ffRelateField，Employee 源 module=hrm） |
 | `e10-cli wf-form permission get <formId>` | 查看流程表单字段权限（display/readOnly/required/disableEdit）。**写字段权限用 `workflow node field-permission`**（节点级，流程表单表单级写平台多返 500） |
@@ -306,12 +306,15 @@
 | `e10-cli wf-form code layout read/set <formId> --layout-id <id> --terminal PC\|MOBILE [--js <文件>] [--css <文件>]` | 读取或写入指定原生工作流程表单布局源码；代码写法读代码块指南。**源码 ecode 必须用 `encodeURI`，不能用 `encodeURIComponent`（设计器 `decodeURI` 读取）** |
 | `e10-cli wf-form code layout preview/apply <formId> --layout-id <id> --terminal PC\|MOBILE [--js <文件>] [--css <文件>]` | 流程表单布局代码块的独立预览与回读写入；预览用 `--out`，应用用 `--preview @<文件>`。 |
 | `e10-cli wf-form code ecode list/read/add/edit/status <formId> ...` | 原生工作流程表单级 ecode 的独立配置，非布局源码 |
+| `e10-cli wf-form layout rename <formId> <布局ID或名称> [--name <新名>] [--describe <描述>] [--workflow-id <id>]` | 修改布局名称或描述；布局内容、引用节点与默认设置保持不变（不用删掉重建）。`--name`/`--describe` 至少给一个，未给的那项保持原值。按名称定位时同名多套会报歧义并列 ID。**默认布局也能改名**（列表里 `isSys`/`readOnly` 为 true 属正常，照改不误）。原生流程表单与 eb 表关联流程的表单都支持；传 `--workflow-id` 由工作流自动判定走哪套路由。写完回读，确认名称与描述落库且终端、类型、默认标记未被改动 |
+| `e10-cli wf-form layout set-default <formId> <布局ID或名称> [--workflow-id <id>]` | 把某套布局设为该终端的**默认布局**。默认布局是表单维度、**PC 与移动端各一套**；终端按目标布局自身判定，不用另传。原生流程表单与 eb 表关联流程的表单都支持（传 `--workflow-id` 自动判定路由）。已经是默认时不做改动。写完回读：目标必须是默认，且同终端不能出现第二套默认。未单独绑定布局的节点都读默认布局，改默认会让它们一起切换 |
+| `e10-cli wf-form layout add-system-field <formId> [字段...] [--layout-id <id或名称>] [--all] [--single-row]` | 把**流程系统字段**摆进布局：提交人 / 提交人部门 / 提交人分部 / 提交时间 / 结束时间 / 流程标题 / 流程编号 / 紧急程度 / 密级 / 到期时间 / 打印次数 / 工作流名称、类型、描述 / 流程状态。字段可写中文名、key（如 `REQUEST_NO`）或组件类型；`--all` 添加目录全部字段。不传 `--layout-id` 用 PC 默认布局。已在该布局里的自动跳过（幂等，不重排）。写入走整份布局保存，写完回读新字段并核对原有组件一个没少 |
 | `e10-cli wf-form layout delete <formId> <layoutId>` | 删除指定流程表单布局。`layoutId` 取自 `layout add` 返回值；可传 `--workflow-id`、`--terminal PC|MOBILE`（默认 PC）。该操作从布局列表移除目标布局 |
 | `e10-cli wf-form field-prop <formId>` | 设置运行时布局字段属性：`--required <字段...>`、`--no-required <字段...>`、`--readonly <字段...>`、`--editable <字段...>`、`--single-row <字段...>`。字段可传名称或 ID；内部 getConfig 读取并由 initLayout 保存，同时保留已有分组和独占一行设置 |
 | `e10-cli wf-form group <formId> --groups '{"基本信息":["字段名/ID",...]}'` | 给**已建好的流程表单**加字段分组（折叠容器，对齐 eb 表 `form group`）。建组 saveFieldGroup → 分配 updateFormFieldGroup → initLayout generateCollapse 渲染。`--groups` 可 `@文件`；同名分组复用不重复建（去重） |
 | `e10-cli workflow list <appId>` | 列出应用下的所有流程 |
 | `e10-cli workflow search` | 通用搜索流程（不依赖 appId）。`--name`/`--id`/`--type`/`--belong`。⚠ 列表只回 id/名称/类型名/描述这一层，**不含「绑了哪张表」** |
-| `e10-cli workflow info <workflowId>` | 单个流程的基础信息 + **它关联的表单**（流程 → 表单反查）。给出 `formId`、表单名、启用状态、是 eb 表还是流程表单。⚠ **formId 不是 objId**，表单类命令要 objId，而平台没有直通的 formId → objId 接口 —— 得先确认表单在哪个应用下再按 formId 匹配 |
+| `e10-cli workflow info <workflowId>` | 单个流程的基础信息 + **它关联的表单**（流程 → 表单反查）。给出 `formId`、表单名、启用状态、是 eb 表还是流程表单。EB 卡片流程会**顺带解出 `appId` 与 `objId`**（`--json` 里在 `form.appId` / `form.objId`），并打印一条可直接照抄的表单命令；原生流程表单不给这两项。⚠ **formId 不是 objId**，表单类命令要 objId |
 | `e10-cli workflow export <workflowId>` | 把流程导出为本地 zip（含流程绑定的表单 / 应用，平台异步打包）。`-o/--out <路径>` 指定文件或目录（缺省用平台返回的文件名）；`--name <名称>` 自定义导出名（缺省取流程名）；`--timeout <秒>` 默认 600、`--interval <秒>` 默认 2。打包期间打印进度，完成后自动下载写入；`--json` 输出任务与文件信息 |
 | `e10-cli workflow nodes <workflowId>` | 查看流程节点详情（名称、类型、操作者、连线含 linkId） |
 | `e10-cli workflow nodes <wf> --mode list` | 列表视图：展示全节点含 nodeAttr、合流方式（比 chart XML 更全） |

package/skill-docs/references/form/guide-browser-definition.md

@@ -16,7 +16,19 @@ e10-cli form-engine browser-definition describe <formId> <fieldId> --module work
 
 `inspect` 对每个字段分别输出 `search/scope/tabs` 的 `platform`（平台是否开放）、`cli`（CLI 是否有该数据源适配）和 `configured`（已配置标记）。`describe` 返回字段原始元数据、支持项的当前配置及候选条件／范围／Tab。只在 `platform=true, cli=true` 时执行对应写入；`platform=true, cli=false` 表示数据源允许设置，但该浏览来源的保存结构尚未纳入 CLI。字段名重名时使用字段 ID。
 
-EB 表单可从表单引擎的表单设置进入。工作流程表单的表单引擎设置页没有独立的“浏览数据定义”；它跟随所属工作流程配置，入口是「流程引擎 → 工作流管理 → 工作流程 → 高级设置 → 浏览数据定义」。先确定工作流程及其关联的表单，再传该表单 ID 和 `--workflow-id <流程ID>`。配置时以流程 ID 定位所属工作流程，以关联表单 ID 定位浏览字段；同一表单若用于不同流程，应按目标流程分别读取和设置。流程表单预览不会按此配置过滤，应在流程实际使用场景核对。其他表单引擎模块按各自入口和实际开放能力配置。
+**表单绑定工作流程时，浏览数据定义必须配置在该工作流程的“高级设置 → 浏览数据定义”上；在表单设置里配置的同名字段范围不会生效。** 这是两套独立记录：流程场景用 `businessId = workflowId`、`businessModule/module = ebuildercard`，`formId` 只是关联表单的 formId；表单场景才用 `businessId = formId`、`module = ebuilderform`。流程高级设置读不到表单级配置，`form ebuilder-scope` 也不能代替流程配置。
+
+这不是“流程配置覆盖表单配置”的优先级关系，而是**流程只读属于自己的流程记录**：表单级记录即使存在也不会被流程读取，因此对流程等于无效。只有同一表单在**不经过流程**的独立表单场景中使用时，表单级配置才按表单场景生效。
+
+工作流程入口：流程引擎 → 工作流管理 → 工作流程 → 高级设置 → 浏览数据定义。CLI 先确定工作流程及其关联表单，再使用：
+
+```bash
+e10-cli form-engine browser-definition inspect <关联表单formId> --module workflow --workflow-id <流程ID>
+e10-cli form-engine browser-definition describe <关联表单formId> <fieldId> --module workflow --workflow-id <流程ID>
+e10-cli form-engine browser-definition scope get/set <关联表单formId> <fieldId> --module workflow --workflow-id <流程ID>
+```
+
+同一表单用于多个流程时，每个流程分别读写；不能复用其他流程或表单级的配置。流程表单预览不会按此配置过滤，应在流程实际使用场景核对。EB 表单的独立表单场景仍从表单设置进入，使用 `--module ebuilderform --app-id <appId>`；其他表单引擎模块按各自入口和实际开放能力配置。
 
 ## 高级搜索
 
@@ -52,7 +64,7 @@ e10-cli form-engine browser-definition scope set <formId> <fieldId> --module <mo
 | 人员 `hrm/resource` | `{"rules":[...],"range":"any"}`；完整配置亦可用 `itemDatas[]` | `get` 返回当下布局码表、表单字段候选、矩阵选项和现存范围。`rules[]` 按当前布局校验并转换，与已有项按范围来源合并。 |
 | 部门 `hrm/department` | `{"rules":[...]}`；完整配置亦可用 `records[]` | 已核对指定部门／分部、创建人、当前操作者、表单部门字段。 |
 | 分部 `hrm/subcompany` | `{"rules":[...]}`；完整配置亦可用 `records[]` | 已核对指定分部、创建人、当前操作者、表单分部字段。 |
-| 关联 EBuilder `ebuilder/form/ebuilder` | `{"records":[{"scopeType":"scopeSql","scopeInfoRender":"..."}]}` | `scopeInfoRender` 为条件树 JSON 字符串；已有 `form ebuilder-scope` 提供按字段名编译的简便方式。 |
+| 关联 EBuilder `ebuilder/form/ebuilder` | `{"records":[{"scopeType":"scopeSql","scopeInfoRender":"..."}]}` | `scopeInfoRender` 为条件树 JSON 字符串；已有 `form ebuilder-scope` 提供按字段名编译的简便方式；操作符码表见下文“浏览范围条件码表”。 |
 | 自定义浏览框 `bcw/customBrowser_*` | `{"records":[{"scopeType":"scopeSql","scopeInfoRender":"..."}]}` | `scope get` 返回该浏览框自己的 `conditionLayout`，从其中选择字段与操作符，按完整条件树写入；字段和操作符在保存前校验。 |
 | 行政区域 `bcw/city` | `{"records":[{"scopeType":"normal_country","scopeInfo":"国家ID","scopeInfoRender":"{...}","type":"normal"}]}` | 例：指定国家为中国；国家 ID 从实际候选列表取得。 |
 
@@ -87,6 +99,8 @@ e10-cli form ebuilder-scope clear <源objId> <appId> <EBuilder字段fieldId>
 
 `源objId` 是包含关联字段的表单对象 ID；`appId` 是应用 ID；`fieldId` 是该关联字段的 ID。规则中的 `field` 指目标表单主表字段，可填字段名或 ID，重名时用 ID。`--logic and|or` 控制所有规则的关系，缺省为 `and`。`--fill-null` 可在需要关联字段为空时填充的场景下使用，缺省关闭。
 
+> `form ebuilder-scope` 只写 **EB 表单级**记录（`module=ebuilderform`）。表单绑定工作流程后，流程实际读取的是流程高级设置记录；此时必须改用 `form-engine browser-definition ... --module workflow --workflow-id <流程ID>`，表单级配置不会生效。
+
 规则文件是 JSON 数组。操作符与条件取值写法如下：
 
 例如，同时按客户状态和名称设置固定值条件：
@@ -100,12 +114,12 @@ e10-cli form ebuilder-scope clear <源objId> <appId> <EBuilder字段fieldId>
 
 | 项目 | 写法 | 含义与限制 |
 | --- | --- | --- |
-| `operator` | `eq`、`neq`、`like`、`isnull`、`notnull` | 等于、不等于、包含、为空、不为空；空值条件不填条件值 |
+| `operator` | `eq`、`neq`、`like`、`isnull`、`notnull`；字段引用可用 `aggregate`、`unaggregate` | 等于、不等于、包含、为空、不为空；`aggregate`/`unaggregate` 为平台保存树里的“属于/不属于” |
 | 固定值 | `"value":"上海"` | 文本、数字、日期填目标值；选项类字段可填选项名或唯一选项值 ID，CLI 按实际选项匹配 |
 | 当前表单字段 | `"valueFrom":"currentFormField","valueField":"相关项目"` | 选择“变量字段”：左侧仍是目标表单字段，右侧引用源表单主表字段的当前值 |
 | 目标表单字段 | `"valueFrom":"targetFormField","valueField":"项目简介"` | 选择“本表字段”：左侧和右侧均来自被浏览的目标表单主表字段，逐条目标记录内部比较 |
 
-字段引用时不填固定 `value`；`valueField` 可填字段名或 ID，重名时用 ID。CLI 先查询字段候选，再分别生成变量字段或本表字段的配置。目前字段引用只验证了**条件左侧为关联浏览字段**的情况；简便规则只读取源表单和目标表单的主表字段，不用于目标明细字段。
+字段引用时不填固定 `value`；`valueField` 可填字段名或 ID，重名时用 ID。CLI 先查询字段候选，再分别生成变量字段或本表字段的配置。目前字段引用只验证了**条件左侧为关联浏览字段**的情况；简便规则只读取源表单和目标表单的主表字段，不用于目标明细字段。用 `aggregate`/`unaggregate` 时，CLI 会按平台结构把 `selectValue` 写成数组；左侧不是关联浏览字段（例如部门字段）时简便命令会拒绝，改用下面的完整条件树。
 
 例如，浏览“关联项目”时，让目标表的“关联合同”等于当前表单的“关联合同”；再让目标表的“关联客户”等于目标表自己的“项目简介”：
 
@@ -164,6 +178,50 @@ e10-cli form ebuilder-scope set <源objId> <appId> <EBuilder字段fieldId> --rul
 
 上面展示的是 `scopeInfoRender` **解码后的条件树**，用于说明嵌套关系；实际 `scope.json` 须把整棵树序列化为 JSON 字符串，放入 `{"records":[{"scopeType":"scopeSql","scopeInfoRender":"<序列化后的条件树>"}]}`。字段 `id/fieldName/fieldType/compType`、`conditions` 的操作符和值结构要按目标字段和 `scope get` 返回的同类条件填写；选项、表单字段、变量字段等值的配置形状与示例的手动文本值不同。更新已有规则时保留其记录 ID（CLI 在未给 ID 时也会按 `scopeType` 查找并沿用已有 ID）。保存后再次 `scope get`，核对树层级、每层 `relationship`、字段和值及记录 ID。工作流程场景还须传 `--workflow-id`，并在所属工作流程的实际使用场景核对筛选效果。
 
+#### 浏览范围条件码表（`scopeInfoRender`）
+
+平台 `getScopeConditionLayout/ebuilder` 返回的字段操作符与保存树里的 `conditions.func` 对应如下。`scope get` / `describe` 现在会返回 EBuilder 的 `conditionLayout`，以目标字段实际返回的 `conditionType` 为准：
+
+| 场景 | `conditions.func` | 值结构 |
+|---|---|---|
+| 等于 / 不等于 | `eq` / `notEq` | 固定值或字段引用；字段引用时 `selectValue` 是对象 |
+| 包含（文本） | `like` / `notLike` | 固定值或字段引用 |
+| 包含（浏览/部门） | `inC` / `notInC` | 字段选项或字段引用；这是“包含”，不是“属于” |
+| 属于 / 不属于（本表字段/变量字段） | `aggregate` / `unaggregate` | `type:"custombyhander"`；`selectValue` 是数组 `[{"id":"tableFields" 或 "varFileds","content":"本表字段" 或 "变量字段","type":"SELECTION_CUSTOM"}]`；`customValue:"field_<被引用字段ID>"`；`value` 填被引用字段名 |
+| 为空 / 不为空 | 保存树用 `empty` / `nempty`；条件布局用 `isNull` / `isNotNull` | 无右侧值 |
+| 介于 | `between` | 日期起止值 |
+
+**关键区别**：`inC` 是“包含”，用于浏览/部门字段的集合包含；本表字段/变量字段比较的“属于/不属于”是 **`aggregate`/`unaggregate`**，并且 `selectValue` 必须是数组，不能沿用 `eq` 的对象形状。
+
+例如“所属部门 属于 经办部门”的条件节点：
+
+```json
+{
+  "id": "field_<左字段ID>",
+  "fieldName": "field_<左字段ID>",
+  "fieldType": "String",
+  "text": "所属部门",
+  "compType": "Department",
+  "type": "condition",
+  "conditions": {
+    "func": "aggregate",
+    "value": "经办部门",
+    "type": "custombyhander",
+    "text": "",
+    "selectValue": [
+      { "id": "tableFields", "content": "本表字段", "type": "SELECTION_CUSTOM" }
+    ],
+    "customValue": "field_<右字段ID>",
+    "customBrowserValue": []
+  },
+  "config": { "name": "所属部门", "title": "所属部门" },
+  "subTableId": "",
+  "key": "<节点key>"
+}
+```
+
+变量字段把 `selectValue[0].id` 换成 `varFileds`、`content` 换成 `变量字段`；其余保持不变。条件布局没有列出的操作符不要凭字面猜测，先读 `conditionLayout` 或抓一次设计器保存报文。
+
 ### 自定义浏览框
 
 先用 `inspect` 找出目标字段及其 `bcw/customBrowser_*` 来源，再用 `describe` 或 `scope get` 读取当前配置和 `conditionLayout`。候选布局按当前浏览框动态返回，每个字段提供 `id/text/type/compType/conditionType` 等信息；条件树叶节点的字段 ID 与操作符须来自这份布局。`scopeInfoRender` 使用平台的完整条件树 JSON 字符串，组节点的 `datas` 可嵌套 AND／OR 条件。日期区间在候选操作符中记作 `between`，已见保存条件采用 `conditions.func="range"` 且 `value` 为两个日期值；其他操作符和值结构按该字段实际候选及现有配置填写。高级搜索同样先读该浏览框返回的 `layout.items`，再构造 `commonLines/commonCells/lines/cells/searchValue`。Tab 是否可配以 `inspect` 的 `tabs.platform` 为准。