weaver-e10-builder 1.6.13 → 1.6.15

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.6.13
-description_zh: 泛微Ebuilder低代码应用智能搭建工具 v2（通用版），辅助编写自定义应用（表单/流程/列表/动作流/权限/分组/编号等），与 e10-cli 配套使用，当前对应 CLI 版本 1.6.13。
-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.13.
+description: 泛微E10智能搭建skill v2（通用版），辅助编写泛微Ebuilder自定义应用，对应CLI版本1.6.15
+description_zh: 泛微Ebuilder低代码应用智能搭建工具 v2（通用版），辅助编写自定义应用（表单/流程/列表/动作流/权限/分组/编号等），与 e10-cli 配套使用，当前对应 CLI 版本 1.6.15。
+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.15.
 category: coding
-version: 1.6.13
+version: 1.6.15
 author: 泛微网络科技股份有限公司
 auto: true
 ---
@@ -97,6 +97,8 @@ auto: true
 | 新建表单、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/detail-settings.md`（布局容器设置，区别于子字段属性与 JSSDK） |
+| 明细合计、过滤已选数据、批量添加、合并字段、分组、操作按钮、排序、快捷搜索 | `references/form/layout/detail-advanced.md`（字段候选、码表、增量修改与关闭方式） |
 | 流程表单多套布局、节点独立布局、布局绑定和回落默认 | `references/form/layout/workflow-layout.md`（表单布局与节点引用的关系；具体节点操作继续读流程指南） |
 | Excel样式、表格式布局、布局样表、布局蓝图、标签字段交替、合并单元格 | `references/form/layout/planning.md` |
 | 完整布局 JSON、布局文档导出、整体编辑差异预览、formLayout 大范围调整 | `references/form/layout/document.md`（导出底稿、预览完整差异、单次应用并回读） |
@@ -162,3 +164,11 @@ auto: true
 页面是搭建的最后一步，动手前确保应用、表单、流程已建好。默认情况优先用设计器配置式页面（`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 或任何数字。
+
+`page permission`：页面使用范围、禁用范围、矩阵相关权限及码表见 [页面权限指南](references/ebuilder-designer/guide-page-permission.md)。
+
+组合页面及页签目标、参数、可见/禁用范围、复制：阅读 [组合页面指南](references/ebuilder-designer/guide-page-combination.md)。
+
+普通页面设计器源码 JS/CSS、页面 SDK、页面/组件加载事件、组件实例、列表勾选和插件、图表 option、页面内表单组件：阅读 [页面源码指南](references/ebuilder-designer/page-source/page-source-guide.md)，按 [SDK 索引](references/ebuilder-designer/page-source/sdk-index.md) 查接口。使用 `designer source read/check/set/sdk`；与表单 JSSDK、组件自由 CSS、独立 ecode 工程分开。
+
+页面/组件的单击与加载完成动作配置：阅读 [事件指南](references/ebuilder-designer/events/guide-events.md)，使用 `designer event get/set/enable/remove/schema/lookup`。**同一对象两种事件各最多一条，每条最多一个动作，替换不追加。** 页面跳转、条件、组件显隐、菜单、刷新和集成动作按该入口自己的参数与码表配置。

package/skill-docs/_catalog.md

@@ -23,6 +23,8 @@
 | 虚拟表、虚拟表单、数据源表单、业务表展示、数据加工结果 | `references/form/guide-virtual-form.md` |
 | 字段定义、字段类型、关联字段码表、DateRange、multiple | `references/form/ref-form-fields.md` |
 | 表单布局管理、编辑、初始化、代码块、模板与源样式还原 | `references/form/layout/layout-overview.md`（统一入口） |
+| 明细整体显示／编辑／必填行数、行操作权限、操作者过滤 | `references/form/layout/detail-settings.md` |
+| 明细合计、过滤已选、批量添加、合并、分组、按钮、排序、搜索 | `references/form/layout/detail-advanced.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`（分类入口） |
@@ -38,6 +40,7 @@
 | 表单数据读写、form data、写入数据、查询数据、删除数据 | `references/form/guide-form-data.md` |
 | 关联页签、关联视图、数据关联、association、页签显示布局、关联数据筛选、删除关联页签 | `references/form/guide-form-association.md` |
 | 流程归档权限、归档查看/编辑/删除、归档附件权限、form permission archive、创建人相关、字段相关、矩阵相关、归档卡片 | `references/form/guide-form-archive-permission.md` |
+| 创建权限、共享权限、兼职岗位、职级、外部联系人、政务单位相关、PC移动统一布局、权限描述、优先级、权限条件、同步至其他表单、附件赋权类型 | `references/form/guide-form-permission.md` |
 | 列表自定义文本列、富文本列、列里插入字段、form nlist、列表式视图 | `references/form/guide-list-custom-text.md` |
 | 流程、审批、workflow、提交流程、flowpage、预填、URL传参、节点、操作者、审批人、连线、节点批量设置、批量字段权限、多节点配置、workflow node batch | `references/workflow/guide-workflow.md` |
 | 撤回管理、加审管理、减审管理、接收人范围、指定流转接收人范围、转发传阅抄送收回、功能管理 | `references/workflow/guide-function-management.md` |
@@ -118,3 +121,7 @@
 | 编译报错排查 | `references/coding/ref-compile-rules.md`（前端代码） |
 
 - 流程功能设置（batch-set/auto-approve/other-set/水印/导入/事项赋权/文档权限）：`references/workflow/guide-function-settings.md`
+| 页面权限、页面使用范围、页面禁用范围、页面矩阵授权、page permission | `references/ebuilder-designer/guide-page-permission.md` |
+| 组合页面、组合页签、页签可见范围、页签禁用范围、组合页头、组合复制、page combination | `references/ebuilder-designer/guide-page-combination.md` |
+| 普通页面源码、页面 JS/CSS、页面SDK、ebSdk、pageSdk、pageLoad、compLoad、compBeforeMount、getExports、列表插件、页面组件实例、designer source | `references/ebuilder-designer/page-source/page-source-guide.md`（功能、编写、保存）· `references/ebuilder-designer/page-source/sdk-index.md`（11 类 61 条 SDK 接口） |
+| 页面事件、组件事件、单击、加载完成、事件动作、打开页面、刷新组件、条件控制、显示隐藏组件、显示菜单、执行ESB、执行逻辑流、企业微信会话、扫描上传、报表事件、designer event | `references/ebuilder-designer/events/guide-events.md`（单事件单动作、命令与范围）· `references/ebuilder-designer/events/actions-interaction.md` · `references/ebuilder-designer/events/actions-integration.md` |

package/skill-docs/actionflows/SKILL.md

@@ -18,6 +18,8 @@ description: "将业务需求编译为 Weaver ESB 动作流，或读取已有动
 
 ## 生成 SOP
 
+复用表单设置协议的组件（包括 e-builder、人员、文档、会议和日程等）统一遵循选项赋值规则：普通动态赋值可指定 `assignType: "name"` 或 `"id"`；依据值下级通过 `fieldSet.matchMode` 指定 `"optionName"` 或 `"optionId"`，并保持 `switchType: "sub"`。名称匹配应引用实时上下文返回的名称字段；不支持或取不到对应字段时不得伪造。组件是否提供该设置及可选字段仍以当前组件契约和实时元数据为准。
+
 按顺序推进；只读取当前步骤需要的信息。每个场景是独立事务。
 
 ### 1. 识别与选择
@@ -56,7 +58,7 @@ description: "将业务需求编译为 Weaver ESB 动作流，或读取已有动
 5. 不把 `Output` 写入 `actions`。需要配置终止状态、提示或页面动作时使用顶层 `finalOutput.params`；提醒内容使用前端富文本组件对应的 `reminderContent`（`ContestSettingDTO`，动态片段放在 `formulaBeans`），不要使用旧的 `reminderMsgFormula`。流程触发（`ApproveTrigger`）只支持提醒，不支持页面交互、页面动作或跳转地址；页面动作仅可用于 `EventButton`。平台内部 FormulaBean 由 CLI 生成，只有组件契约明确要求前端原对象时才传原生 DTO。
 5.1. 所有 CLI 生成或继续编译的 FormulaBean，只要包含 `frontId`，允许使用空串；非空时必须使用平台真实字段 ID 的纯数字字符串。`field_<数字>` 仅可在生成时规范化为 `<数字>`。禁止把字段名、paramKey 尾段、临时公式 ID 或其他包含字母/符号的值写入 `frontId`；非空值无法解析为纯数字时必须直接报错。
 6. 定时组件优先使用平台原生频率：`rate=1` 一次、`2` 按小时、`3` 按日、`4` 按周、`5` 按月，并按需提供 `cycle`、`hour`、`day`、`week`、`atWeek`、`atWeekDetail` 或 `lastWeek`；只有明确选择 `rate=6` 时才传 `cornString`。图形化频率必须提供 `startTime`。
-7. `EnquiryForm`、`TimeBatchTrigger`、`DateTrigger` 的 `queryFields` 会裁剪 `getComponentContext` 返回的动态上下文。字段必须来自当前租户的 `showDataSourceFields` 完整字段对象；若后续动态赋值引用了其中字段，预检会按真实字段 ID 匹配并把它并入 `queryFields`，匹配不到就报错，不能按名称或路径尾段造字段。未明确限制输出字段时不传 `queryFields`（或传空数组），CLI 默认全选。查询节点还必须使用自身真实节点 ID 作为 `dataSource.enquiryId`，否则平台可能静默丢弃业务字段。正式回读必须确认每个声明的 `queryFields` 仍存在；缺失即生成失败，不能仅凭接口 `code=200`、`saved=true` 判定成功。e-builder 数据触发后发送消息且未显式给链接时，CLI 自动补 PC/移动端当前记录详情链接；不手写 `{formId}` / `{dataId}` 的 FormulaBean。查询结果字段动态赋值必须按手工设计器对象编译：普通业务字段使用 `FormField.<查询表单ID>.field_<真实字段ID>`，`config.paramKey` 使用 `<查询表单ID>.field_<真实字段ID>`，`config.fieldInfo.tablePrimaryKey` 为 `FormField`；系统字段按平台真实字段键（例如 `id`）保留。禁止使用 `FormData.<表单ID>[临时位置]...`，也禁止把临时公式 ID 当作 `frontId`。
+7. `EnquiryForm`、`TimeBatchTrigger`、`DateTrigger` 的 `queryFields` 会裁剪 `getComponentContext` 返回的动态上下文。字段必须来自当前租户的 `showDataSourceFields` 完整字段对象；若后续动态赋值引用了其中字段，预检会按真实字段 ID 匹配并把它并入 `queryFields`，匹配不到就报错，不能按名称或路径尾段造字段。未明确限制输出字段时不传 `queryFields`（或传空数组），CLI 默认全选。查询节点还必须使用自身真实节点 ID 作为 `dataSource.enquiryId`，否则平台可能静默丢弃业务字段。正式回读必须确认每个声明的 `queryFields` 仍存在；缺失即生成失败，不能仅凭接口 `code=200`、`saved=true` 判定成功。e-builder 数据触发后发送消息且未显式给链接时，CLI 自动补 PC/移动端当前记录详情链接；不手写 `{formId}` / `{dataId}` 的 FormulaBean。查询结果字段动态赋值必须使用 `getComponentContext` 返回的真实 `paramKey` 和字段实例 ID；字段名称缺失或匹配不唯一时停止，不按数字 ID 拼接前缀。禁止使用 `FormData.<表单ID>[临时位置]...`，也禁止把临时公式 ID 当作 `frontId`。
 8. `ActionEbAdd` 批量新增以 `basisValue` 为明细行上下文：来源于该行的字段都用 `mapping`，编译为“依据值下级”（`switchType:"sub"`），下拉字段也同样处理。只有已核实来源/目标选项 ID 不同且语义需要转换时，才使用 `SWITCH`。关联 e-builder 字段应引用查询结果的 `数据ID`，固定格式为 `{target,kind:"query_result",source:"<EnquiryForm ref>",formId,fieldId:"id",index:0}`；`kind:"enquiry"`、`sourceId` 等旧写法会直接报错，绝不降级为空固定值。
 9. 动态赋值可使用或新建动作流变量、租户常量：已有资源必须用真实 ID；计划新建变量写顶层 `variables[]`，新建常量写 `constantDefinitions[]`，常量分组可传 `groupPk` 或 `groupName`。变量按当前 `applicationId + sceneId` 隔离，常量按分组跨动作流复用。生成时先调用真实接口创建/解析资源，再编译为变量 `type:"7"` 或常量 `type:"5"` FormulaBean；详细格式见 `references/dynamic_resources.md`。消息 `SendMessage.msgTitlev/msgContentv/picLink/msgPcLink/msgMobileLink` 的 `parts` 支持 `variable`/`constant` 动态片段，并统一保存为 `ContestSettingDTO`。
 9.1. 每个参数先分为“动态公式属性”“动态人员属性”“固定平台资源属性”三类：上下文、系统变量、变量、常量、函数/公式必须保留为 FormulaBean；动态人员必须使用真实人员字段上下文或系统变量，不得把引用里的 `id` 当人员 Browser ID 查询；工作流、文档目录、按钮、规则等平台资源只有在其组件契约明确提供动态引用时才允许动态化。生成前必须记录本次组件/属性的判定，生成后按属性检查回读结果；具体映射和验证状态见 `references/dynamic_capability_matrix.md`。
@@ -131,7 +133,7 @@ e10-cli actionflow disable '{"appId":"动作流ID"}'                        #
 e10-cli actionflow update '@update-plan.json' --out update-result.json       # 读取后按原 ID 保留式修改；一次保存，失败停止
 ```
 
-常用发现命令：`form-search`、`form-applications`、`form-list`、`form-fields`、`workflow-browser-list`、`workflow-search`、`workflow-nodes`、`workflow-context-fields`、`component-context-fields`、`recipient-search`、`document-statuses`、`hrm-onboarding-fields`、`variable-list`、`variable-create`、`constant-list`、`constant-group-list`、`constant-group-create`、`constant-create`、`http-connectors`、`http-resources`、`http-interfaces`、`http-interface-detail`、`application-list`、`design-versions`、`read-stash`。变量/常量计划定义和引用见 `references/dynamic_resources.md`。
+常用发现命令：`form-search`、`form-applications`、`form-list`、`form-fields`、`data-source-condition-fields`、`workflow-browser-list`、`workflow-search`、`workflow-nodes`、`workflow-context-fields`、`component-context-fields`、`recipient-search`、`document-statuses`、`hrm-onboarding-fields`、`variable-list`、`variable-create`、`constant-list`、`constant-group-list`、`constant-group-create`、`constant-create`、`http-connectors`、`http-resources`、`http-interfaces`、`http-interface-detail`、`application-list`、`design-versions`、`read-stash`。变量/常量计划定义和引用见 `references/dynamic_resources.md`。
 
 执行设置支持 `actuator`（`main` 主执行器 / `low` 慢速执行器）、`controlMode`（`max` 高并发 / `low` 低并发）、`concurrentNum`、`maxExecuteTimeout`（秒）、`maxCycleTimes`、`maxQueryNum`、`memoryKb`（KB）、`streamlineFlag`（布尔值或 0/1）及 `reminders`。提醒 `configType` 1–6 依次为执行失败、执行异常、执行超时、输出失败、其他状态、动作流受影响；每项可传 `enabled`、`remindType`（1 手动选择 / 2 动作流创建人 / 3 维护权限对象）和 `remindUser:[{id,name}]`。提醒数组只 patch 指定类型，其余提醒保留。
 
@@ -175,7 +177,9 @@ e10-cli actionflow update '@update-plan.json' --out update-result.json       #
 - 使用 `Condition` 或 e-builder 筛选条件时，读取 `references/condition_rules.md`。
 - 组件需要计算、转换或函数树时，读取 `references/function_rules.md`；仅在该组件的说明允许函数树时使用。
 
-筛选条件左值的字段身份必须按实时 `componentKey` 生成，不能只按字段 ID 是否为数字判断。普通 e-builder 业务字段才使用 `field_<id>`；`Workflow` 关联流程字段使用原始数字 `fieldName`、`fieldType:"String"`、空 `module`/`originBrowserType`、`formInfo.formId/layoutId`、顶层 `sformId` 和仅含 `fieldId` 的 `config`。Workflow 的 `sformId` 必须由 `workflowPath.formIds` 反查真实流程表单对象；查不到就停止，不能用目标表单版本 ID兜底。保存后正式回读必须检查左值没有出现“已删除”。
+筛选条件输入 `filter.field.id` 使用数据源 `/ds/fields` 返回的字段 `id`；可用 `actionflow data-source-condition-fields` 查询。唯一匹配的接口 `name` 也可兼容解析，重名须使用 id。显示名称和 `component-context-fields` 中每次生成的临时字段 id 不能当筛选 id；输出字段 `queryFields` 使用 `showDataSourceFields` 的 id，下游动态赋值使用 `component-context-fields` 返回的 paramKey。
+
+编译输出的 `filterInput.datas[].fieldName` 与输入 id 是不同口径：优先使用 `ds/fields` 的真实 `name`；不能把 `field_<id>` 等输出形式当输入 id。`Workflow` 关联流程字段还需要真实类型及关联对象；`sformId` 必须由 `workflowPath.formIds` 反查真实流程表单对象，查不到就停止。保存后正式回读检查条件左值没有显示“已删除”。
 
 ## 不变约束
 

package/skill-docs/actionflows/references/components/ebuilder/ActionEbAdd.md

@@ -6,7 +6,11 @@
 
 ## 选择项跨表映射
 
-来源、目标选择字段的选项 ID 经当前租户字段元数据确认一致时，直接 `mapping` 动态赋值；批量新增会生成“依据值下级”（`switchType:"sub"`），这是任务明细字段的默认做法。需求指定固定选项时，不做动态映射；在 `constants` 中传该字段的真实 `valueKey`（可同时带 `label`），例如 `"<任务类型字段id>":{"kind":"fixed","value":"<研发的valueKey>","label":"研发"}`。CLI 会保留目标字段 `Select` 类型，使设计器以下拉项“研发”回显。只有两边选项 ID 不同、且需求明确要求按语义转换时，才在 `formula`（批量明细为 `detail[].formula`）中用 `SWITCH` 显式映射：
+按名称匹配时，`mapping` 的目标写 `{ "target": "<目标字段id>", "assignType": "name" }`，来源必须是组件上下文实际返回的选项名称字段（如 `..._name`）。如果传入的是实时上下文中的选择字段本身，CLI 只会在同一上下文确有唯一对应名称字段时切换过去；找不到时明确报错。名称匹配会同时设置外层和动态公式中的 `switchType: "optionName"`，不要求两表选项 valueKey 相同。普通文本来源可直接作为名称输入。模板或级联字段的可用模式以设计器能力为准。
+
+依据值下级使用另一套设置：保持 `switchType: "sub"` 和 type=10，在 mapping 的目标对象中传 `fieldSet: {"matchMode":"optionName"}` 按名称匹配，或 `fieldSet: {"matchMode":"optionId"}` 按选项 value 匹配。名称模式引用真实上下文中的名称字段；value 模式引用值字段。`fieldSet.assignTypeset` 属于“新建时赋值内容”的设置，不替代 `matchMode`。未明确指定匹配方式时不擅自补写。
+
+来源、目标选择字段的选项 valueKey 经当前租户字段元数据确认逐项一致时，可直接按值动态赋值；批量新增会生成“依据值下级”（`switchType:"sub"`）。需求指定固定选项时，在 `constants` 中传目标字段的真实 `valueKey`（可同时带 `label`）。两边选项名称相同时可以按上面的名称方式匹配；名称不同时，如需求明确给出转换关系，可在 `formula`（批量明细为 `detail[].formula`）中用 `SWITCH` 显式映射：
 
 ```json
 {

package/skill-docs/actionflows/references/components/ebuilder/ActionEbUpdate.md

@@ -2,7 +2,7 @@
 
 ## 何时使用
 
-更新已有 e-builder 数据；新增数据使用 `ActionEbAdd`，删除数据使用 `ActionEbDelete`。
+更新 e-builder 数据；若需要在匹配条件不满足时新增数据，可开启 `needAdd`；删除数据使用 `ActionEbDelete`。
 
 ## 先查询
 
@@ -26,6 +26,10 @@
 
 `basisValue` 只是 `id` 和 `fieldUpdate` 的批量开关，不能用于条件筛选更新。CLI 会在编译前校验这些组合，避免把一个模式的定位参数静默带入另一个模式。
 
+### 条件不满足时插入
+
+`needAdd` 对应平台参数 `EbuilderActionDTO.needAdd`，默认 `false`。设为 `true` 时启用“条件不满足时插入”：匹配到目标记录时更新，未匹配到时新增。需要“存在则更新、否则新增”时应设置 `needAdd: true`，不需要另行组合新增组件。
+
 当 `id` 或 `fieldUpdate` 配置了 `basisValue` 时，如果 `updateId` 或 `updateFieldCondition.updateField[].assign` 的来源字段 `paramKey` 明确位于该依据值下级（例如依据值为 `100.12345[]`，来源字段为 `100.12345[].67890`），CLI 会按前端“依据值下级”协议编译为 `type:"10"`、`config.switchType:"sub"`。只有路径明确以该依据值加 `.` 开头时才会转换；不相关的明细字段仍按普通动态上下文编译，不凭路径形状猜测依据关系。`basisValue` 和来源字段都应使用前置上下文接口返回的真实字段元数据。
 
 ### 明细表策略

package/skill-docs/actionflows/references/components/ebuilder/EnquiryForm.md

@@ -8,6 +8,8 @@
 
 查询数据源、全部字段、筛选字段、输出字段和查询操作人。
 
+`actionflow data-source-condition-fields '{"dataSource":{...}}'` 查询条件左值；`filter.field.id` 使用其中的 `id`。`name` 唯一时可兼容输入，重名必须使用 id。`queryFields` 的 id 来自 `showDataSourceFields`，下游引用使用 `component-context-fields` 的 paramKey；不要把临时上下文 id 当条件字段 id。CLI 输出的条件 `fieldName` 取真实字段 `name`。
+
 ## 不可猜测
 
 筛选、排序、分组和输出字段都必须来自当前数据源；统计结果应作为后续节点上下文使用。

package/skill-docs/actionflows/references/components/personnel/HrmEmployeeUpdate.md

@@ -19,6 +19,7 @@
 - 至少提供一个待更新字段；字段、对象或必填约束无法解析时，停止生成。
 - 生成的 `setting` 统一使用通用 `EsbFormDataDto` 生成逻辑，并使用 `update_original` 模式：主表、明细表都会按实时字段定义生成完整骨架，未修改主表字段为 `{"formFieldKey":"","value":{"original":true}}`，未修改明细字段为 `{"formFieldKey":"","value":{"original":true,"assign":null}}`。
 - `setting` 统一补充 `dataDrWithCalc=false`、`deleteMainFields=[]`，每张输出的明细表带 `deleteFields=[]`；动态赋值字段、原值占位字段和 DTO 外壳都由公共生成器处理。
+- 配置 `fieldAssignments.detail` 时，至少一个字段必须引用真实的来源表单明细上下文；CLI 从该字段已解析的上下文公式自动生成 `setting.detail[].basisValue`。若无法从上下文确认唯一来源明细，生成会报错，不会猜测依据值。设计器回读校验也会检查明细依据值和字段赋值。
 
 ## 语义计划形状
 

package/skill-docs/actionflows/references/components/personnel/PersonnelOnboarding.md

@@ -16,6 +16,7 @@
 - plan 传 `fieldAssignments`，CLI 交给通用 `EsbFormDataDto` 生成器，根据实时字段定义生成平台 `setting`；不允许手写 `setting` / `EsbFormDataDto`。
 - 编译后的 `setting` 统一使用通用 `EsbFormDataDto` 生成逻辑，并使用 `create` 模式：主表、明细表都会按实时字段定义生成完整骨架，未赋值主表字段为 `{"formFieldKey":""}`，未赋值明细字段为 `{"formFieldKey":"","value":{"assign":null}}`。
 - `setting` 统一补充 `dataDrWithCalc=false`、`deleteMainFields:[]`；每张输出的明细表带 `deleteFields:[]`。动态赋值字段和空字段都由公共生成器处理，入职组件不重复实现 DTO 保存逻辑。
+- 配置 `fieldAssignments.detail` 时，至少一个字段必须引用真实的来源表单明细上下文；CLI 从该字段已解析的上下文公式自动生成 `setting.detail[].basisValue`。若无法从上下文确认唯一来源明细，生成会报错，不会猜测依据值。设计器回读校验也会检查明细依据值和字段赋值。
 - 字段可用显示名或字段 ID。当前租户出现同名字段时必须使用字段 ID。
 - Browser 字段（部门、岗位、上级等）只接受其对应选择器返回的真实对象，不能把名称或 ID 当文本填入。
 - 未提供当前租户必填字段、或字段/取值无法解析时，停止生成并报告缺项。

package/skill-docs/actionflows/references/trigger_runtime_notes.md

@@ -37,7 +37,7 @@
 `ActionEbUpdate` 等数据动作的筛选条件（filterCondition）右值走上下文引用时，条件对象里的 `esbAssign.wId` 字段**必须指向「当前节点」**（filterInput 所属的数据动作节点 id），**不能指向上游 event 节点**。
 
 - 设计器打开「动态赋值」对话框时，用 `esbAssign.wId` 在 `orginFlowDatas` 里定位当前组件；指向 event 节点 → 定位不到 → 右侧「暂无数据」（EmptyView，不可编辑/不可选）。
-- `value.source` / `config.comId` 仍指向 event 节点（公式来源，不变）；只有 `esbAssign.wId` 单独用当前节点 id。
+- `value.source` / `config.comId` 指向提供上下文的组件节点；来源是触发器时指向 event，来源是其他组件或循环上下文时指向实际来源节点。`esbAssign.wId` 指向当前节点。
 - 判断口径：读回后 `esbAssign.wId` 应等于该 ActionEbAdd/Update/Delete 节点的 `id`，不等于 `event.id`。
 
 ## 4b. 同类问题全量修复：mapping / updateId / basisValue / 明细依据值下级 / updateFieldCondition / requestName 的上下文公式也要 `esbAssign.wId`（真机验证 2026-08-18）

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

@@ -103,16 +103,22 @@
 | `e10-cli form rename <objId> <appId> <新名称>` | 修改**表单名称**。⚠ 表单名称与**自定义标题**是分开的两套（标题用 `form title`），两者不一致属正常状态，不是漏改。平台该接口是整对象覆盖，命令内部**先读回完整对象、只换名称、再整体回写**，不会清掉其它配置；改完回读校验。改名称**不影响**标题 |
 | `e10-cli form title get <objId> <appId>` | 查看**表单自定义标题**：标题文本、表单页面名、是否隐藏页面头部 / 隐藏表单标题、页面名是否全含 |
 | `e10-cli form title set <objId> <appId> [--show-name <文本>] [--form-page-name <文本>] [--hide-header\|--no-hide-header] [--hide-title\|--no-hide-title] [--page-name-all-in 0\|1]` | 修改自定义标题（至少要给一项）。先读回现有标题、叠上改动再整份提交，改完逐项回读校验。⚠ **标题处于隐藏状态时，改了标题文本界面上也看不出变化**（`get` 会提示） |
-| `e10-cli form permission data add <objId> <appId> --org-type <类型> [--org-id <id>] --rights <view/edit/delete...> [--file-rights <view/download...>]` | **表单数据权限**，`1/view=查看`、`2/edit=编辑`、`3/delete=删除`，可任意组合；附件 `401/view=查看`、`402/download=下载`。固定写入 `obj_data_admin` 并按新增权限 ID 回读。授权对象支持 all/role/department/company/employee/group/post；all 的 orgId 自动为 0 |
-| `e10-cli form permission imp-exp <list\|add> <objId> <appId> ...` | **导入导出权限**（独立分类 `data_imp_exp`，⚠ 勿用 `data add` 加——共享权限只有 查看/编辑/删除 三种，导出/导入不在其中）。`list` 查看；`add --org-type <类型> [--org-id] --rights <export/import/delete-import...> [--update-import] [--export-details] [--export-attachment] [--export-field-range listShowField|all]`。`export=8`、`import=9`、`delete-import=93`（93 须与 import 同选，自动带更新导入）；添加后按权限 ID 回读 `impRightList` 校验。删除同 `permission remove --right-id` |
+| `e10-cli form permission create <add\|update\|show> <objId> <appId> [--right-id <id>] --org-type <类型> [--org-id <id>] [--org-name <名>] [设置项]` | **创建权限**（谁能新建记录）。通用对象支持 all/employee/department/company/role/group/post/partTime/grade/external/externalAll；`all`/`externalAll` 的 orgId 自动 0。`update` 只改点名项并整行回写；`show` 查看布局/优先级/描述/条件/同步列表。设置项见下一行 |
+| `e10-cli form permission data <add\|update\|show> <objId> <appId> [--right-id <id>] --target <general\|creator\|field\|matrix\|govern> --rights <view/edit/delete/comment...> [设置项]` | **共享权限**（查看/编辑/删除/评论；`1/2/3/4`）。`general` 通用对象（同上 11 种类型）；`creator --creator-related 0~7` 创建人相关；`field --field <字段id或名>` 字段相关（`--sub-form-id` 支持明细字段）；`matrix --matrix <矩阵>` 或 `--eb-form <e-Builder表单>` + `--matrix-value`/`--matrix-value-raw`/`--matrix-condition-raw`；`govern --govern-json <json>` 政务单位相关。附件 `--file-rights view/download/edit`（401/402/403）与 `--file-right-type temporary\|insert`（临时/插入赋权）。保存后按权限 ID 回读核对。详见 `form/guide-form-permission.md` |
+| 权限通用设置（`create` / `data` 的 `add\|update`） | `--layout` / `--edit-layout` / `--mobile-layout` / `--mobile-edit-layout`（关联 PC、编辑、移动、移动编辑布局）、`--same-layout on\|off`（PC 移动统一布局）、`--layout-order <n>`（优先级，0 最高）、`--desc <文本>` / `--desc-label-id`（权限描述）、`--condition <json\|@file>` / `--clear-condition`（权限条件，写入前按平台算法压缩）、`--org-virtual-type`（组织维度）、`--contain-extra on\|off`（含兼职人员）、`--min-seclevel` / `--max-seclevel`（安全级别 0~100）、`--exclude-obj <json\|@file>`（排除项）、`--sync-forms <objId...>`（同步至其他表单，整体替换）。修改只改点名项；未点名的布局、条件、同步列表原样保留 |
+| `e10-cli form permission imp-exp <list\|add\|update\|show> <objId> <appId> [--right-id <id>] ...` | **导入导出权限**（独立分类 `data_imp_exp`，⚠ 勿用 `data add` 加——共享权限只有 查看/编辑/删除 三种，导出/导入不在其中）。`list` 查看；`add/update --org-type <类型> [--org-id] --rights <export/import/delete-import...> [--update-import] [--export-details] [--export-attachment] [--export-field-range listShowField\|allField]`；`show` 查看单条。`export=8`、`import=9`、`delete-import=93`（93 须与 import 同选，自动带更新导入）；授权对象与共享权限同一套 11 种通用对象（含兼职岗位/职级/外部联系人/所有外部联系人）。保存后按权限 ID 回读 `impRightList` 校验；修改只改点名项。删除同 `permission remove --right-id`。不支持权限描述/更新导入校验数据编辑权限/导入关联布局/优先级/同步至其他表单 |
 | `e10-cli form permission archive <list\|add\|remove\|card> <objId> <appId> --workflow <workflowId>` | **流程归档权限**（归档后数据对谁可见/可改/可删，**按流程各一套**，与共享权限不同）。`add --target <general/creator/field/matrix>`：`general` 通用对象配 `--org-type`+`--org-id`；`creator` 创建人相关配 `--creator-related 0~7`；`field` 字段相关配 `--field <字段id或名>`（`--sub-form-id` 支持明细字段，未收录的字段类型需 `--org-type field_xxx` 显式指定）；`matrix` 矩阵相关配 `--matrix`（真矩阵）或 `--eb-form`（e-Builder 表单）+ `--matrix-value`（e-Builder 表单按名取它自己的人员字段/创建者，人员字段 valueType=resource），另可加**矩阵条件**（e-Builder 表单的条件列自动取该表单主表字段） `--matrix-condition '<json>'`（可重复 / `@文件` 给数组；右值三选一 `value` 固定值 / `field` 引本表单字段 / `fieldRef` 直给字段描述符）+ `--matrix-condition-relation and\|or`。权限码 `5/view` 归档查看、`6/edit` 归档编辑、`7/delete` 归档删除（**归档查看是系统默认必选，界面不可取消；`--rights` 没传 view 会自动并入**）；归档附件另算 `501/view`、`502/download`、`503/edit`（**不是**共享权限的 401/402；**归档附件查看 501 同属系统必选，不给 `--file-rights` 也会带上**）。保存后按 ID 回读逐项核对；`card <workflowId> <appId> [--set 0\|1]` 读写归档卡片开关。详见 `form/guide-form-archive-permission.md` |
 | `e10-cli form permission <list\|add\|remove\|rebuild> <objId> <appId>` | 权限通用管理及兼容入口。新建权限与数据权限分开；旧 `add --right-type` 保留兼容。`list` 查看全部分类；`remove --right-id <id[,id...]>` 删除一条或多条权限；添加后提示 `isShowRebuild=2` 时执行 `rebuild` |
 | `e10-cli form list-view <objId> <appId>` | 查看台账/数据列表（获取 viewId 用于菜单配置） |
 | `e10-cli form list-columns <objId> <appId> <listId> [--add <fieldId...>] [--remove <fieldId...>] [--set @columns.json] [--terminal pc/mobile] [--pc-only]` | 查看/批量设置台账显示列。增量追加、移除或整组指定顺序/列宽/格式；整组模式与增删互斥。支持主表和明细子字段，保留已有列未指定属性、事件及数据主键；一次保存并回读核对目标列和另一终端。**只作用于表格式 `tableField`**：列表式/卡片视图（NList）会直接报错并指向 `form nlist`。详见 `references/form/guide-list-columns.md` |
-| `e10-cli form list-columns attr show\|set <objId> <appId> <listId> --field <fieldId> [--align left\|center\|right] [--fixed on\|off] [--width N] [--width-unit px\|%] [--editable 0\|1] [--rich-editor on\|off] [--show-name <名>] [--conversion '<json>'] [--terminal pc/mobile]` | 列属性层（`getListFields`/`saveListFields`）：对齐、冻结、列宽、显示名、可编辑、富文本、显示转换。只改目标列，另一端与其它列原样回传，保存后回读目标列断言 |
+| `e10-cli form list-columns field show\|set <objId> <appId> <listId> --field <fieldId> [--text <标题>] [--custom-text <列名称>] [--remark <注释>] [--align left\|center\|right] [--width N] [--width-unit px\|%] [--merge-row on\|off] [--hidden-column on\|off] [--fixed on\|off] [--title-wrap on\|off] [--show-filter on\|off] [--wrap whole\|auto\|disabled] [--color '#RRGGBB'] [--font-size 16px] [--bold on\|off] [--terminal pc/mobile]` | 数据列表「字段设置」抽屉（`config.tableField[]`）：列名称自定义、列注释、对齐、列宽、合并行、隐藏列、冻结、表头换行、列头筛选、换行设置、文字样式（颜色/字号/加粗）。只改点名字段与点名属性，其它字段/配置键/另一端原样回写，保存后只回读被改的键。与 `attr set`（`getListFields` 层）不是同一层 |
+| `e10-cli form list-columns field event show\|set <objId> <appId> <listId> --field <fieldId> [--events '<json\|@file>'] [--terminal pc/mobile]` | 字段事件动作（`tableField[].eventGroup`）：整段读写，外层按触发方式分组（`CLICKDATA`）、内层是依次执行的动作；**动作类型不设白名单**（NewPage / ClosePage / CopyLink / ShowMenu / JsCode 等原样透传），`show --json` 导出后可改完回写。缺 `id` / 触发名 / `disableDelete` 时自动补齐；写入对 PC 与移动端同时生效，保存后逐字回读 |
+| `e10-cli form nlist field show\|set <objId> <appId> <listId> --field <fieldId> [--align left\|center\|right] [--hor-align 0\|1\|2] [--word-wrap on\|off] [--show-trans '<json>'] [--color '#RRGGBB'] [--font-size 14px] [--bold on\|off]` | 列表式字段展示属性（`config.cardLayout.grid` 单元格的 `field`）：列表式没有表头，对齐/水平对齐码/换行/显示转换/文字样式都在这层。同字段多个单元格一并更新，只改点名键，其它单元格与移动端原样回写 |
+| `e10-cli form list-config extend get\|set <objId> <appId> <listId> [--fields <fieldId...>] [--page-size N] [--page-mode <s>] [--clear]` | 拓展显示区域（`config.extendArea`）：主列表之外再挂一组字段，运行时默认不显示。`--fields` 取自主列表 `tableField`、隐藏主键自动带上；新建补齐 `display:"none"` / `extendType:"current"` / `pageSize:"5"` / `pageMode:"part"` 并生成 32 位十六进制 id；`--clear` 写空对象。主列表与移动端配置原样回写 |
+| `e10-cli form list-columns attr show\|set <objId> <appId> <listId> --field <fieldId> [--align left\|center\|right] [--remark <文本>] [--plain-text on\|off] [--view-data-detail on\|off] [--formula-type sum,avg\|none] [--formula-range currentPage,allPage] [--fixed on\|off] [--width N] [--width-unit px\|%] [--wrap whole\|auto\|disabled] [--hidden-column on\|off] [--editable 0\|1] [--rich-editor on\|off] [--show-name <名>] [--conversion '<json>'] [--terminal pc/mobile]` | 列属性层（`getListFields`）：对齐、字段注释、纯文本展示、数据超链接、列统计与统计范围、冻结、列宽、换行设置、隐藏列、显示名、可编辑、富文本、显示转换。PC 写入走平台单字段接口 `saveListFieldById`（**两端同时生效**）；`--terminal mobile` 按终端回写，只支持宽度/冻结/换行/隐藏这类独立属性。只改目标列，保存后回读目标列断言 |
 | `e10-cli form list-filter sql get\|set <objId> <appId> <listId> [--sql @sql.json] [--base-sql <sql>] [--dialect "mysql=<sql>"] [--dataset-id <id>]` | **SQL 条件**（`filter.type=sql_where`）：SQL 正文写进独立的 `sqlfragments` 数据集，视图只记数据集 ID。`sql.json` 键：`base` + `mysql/oracle/sqlserver/pg/dm/kingbase/st/oceanbase`（对应平台 `mysqlSql/oracleSql/sqlserverSql/pgSql/dmSql/kingBaseSql/stSql/oceanbaseMysql`）。主表别名 `t1`、明细 `d1`、`{参数}` 为运行时占位；保存后回读视图条件与数据集正文。`--dataset-id` 只切绑定不新建；`--ignore-empty on|off` 写「变量值为空时不参与过滤」（`filterIsNull`：on→false，off→true）。详见 `form/guide-form-view.md` |
 | `e10-cli form list-filter http get\|set <objId> <appId> <listId> --url <url> [--method GET\|POST] [--param name=value] [--header name=value] [--form name=value] [--payload '<json>'] [--ignore-empty on\|off]` | **自定义接口条件**（`filter.type=http`）：URL + 方法 + Params/Headers/Body(form-data 或 JSON)。落库 `data.{method,contentType,url,urlParams[],headers[],formData[],payload}`，`rootStr="自定义接口"`，PC/移动端同写；保存后回读 URL 与方法。详见 `form/guide-form-view.md` |
-| `e10-cli form list-config get\|set <objId> <appId> <listId> [--head-merge on\|off] [--hide-checkbox on\|off] [--page-size N] [--set-top 1\|0] [--set-top-type <s>] [--set-top-rule '<json>'] [--batch-edit-value on\|off] [--batch-add-fields '<json>'] [--batch-edit-fields '<json>'] [--can-delete on\|off] [--terminal pc/mobile] [--pc-only]` | 视图基础开关（`getNListConfig` 顶层键）：表头合并、隐藏 check 框、分页条数、数据置顶、批量、允许删除。只改点名键、其余原样回写，保存后只回读被改的键；`get` 额外展示操作按钮摘要（只读，本版不写 `buttonConfig`）。`headMerge`/`setTop` 的 UI 文案与极性待真机核对 |
+| `e10-cli form list-config get\|set <objId> <appId> <listId> [选项...] [--terminal pc/mobile] [--pc-only]` | 视图设置（`getNListConfig` 顶层键），选项按平台面板分组：基本信息（`--show-title`/`--hide-checkbox`/`--default-display-edit-modal`/`--operate-column-fixed`/`--spread-top-button`/`--prefix-column`/`--field-choose-width-fixed`/`--quick-search-textarea`/`--sub-form-main`/`--sub-form-show-empty`/`--head-merge`/`--page-size`；数据列表插件另有 `--title`/`--hide-table-header`/`--operate-btn-fixed`/`--group '<json>'`/`--superior '<json>'`）、网格（`--grid-row|col|width|height` + `-type`）、显示数据（`--permission-scope`/`--data-range-type`/`--list-data-range`/`--show-follow`/`--read-state`/`--set-top|type|rule`）、批量（`--batch-add|edit` + `-fields`/`--batch-edit-value`/`--can-delete`）、展示模式（`--open-child-list`/`--sup-field`/`--expand-level`/`--expand-num-limit`/`--expand-page-type`/`--enable-group`/`--group-field`/`--group-enable-count`/`--only-display-data-group`）。只改点名键、其余原样回写，保存后只回读被改的键；`get` 额外展示操作按钮摘要（只读，不写 `buttonConfig`）。键名与平台「视图设置」面板的配置项一一对应 |
 | `e10-cli form list-unit <objId> <appId> <listId> <fieldId> <后缀> [--prefix <前缀>] [--clear] [--pc-only]` | 设置台账列显示**单位**（后缀/前缀）。平台无字段级单位属性，靠列表列配置 `showTrans.ruleConfig.suffix/prefix` 实现。如 `form list-unit ... <fieldId> "（元）"` 让列显示单位；`--clear` 清除 |
 | `e10-cli form list-format <objId> <appId> <listId> <fieldId> [--thousandths] [--no-thousandths] [--decimal <n>] [--clear] [--pc-only]` | 查看/设置台账列**千分位/小数位**（Number/Money 列）。不加参数显示当前；`--thousandths` 开千分位（列 `format:"THOUSANDS"`）、`--no-thousandths` 关、`--decimal <n>` 小数位数（`decimalLength`）、`--clear` 清除恢复默认。与 `list-unit`（单位，走 `showTrans`）是两套不同机制。**自动保留移动端配置** |
 | `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` |
@@ -154,6 +160,7 @@
 | `e10-cli form native <子命令>` | **原生表单引擎**（formdatareport/biaoge，非 Ebuilder；只有 formId、无 objId、无 appId）的命令组：`create <名称>` 建表、`read <formId>` 读字段、`add-field` / `add-detail-table` / `init` / `field-group`，以及 `list [--keyword]`（存活表单，名称模糊搜）、`trash`（回收站）、`delete <formId...>`（停用→检查→删除，进回收站，删后回读确认）。**注意与 EB 表单不通用**：URL 前缀 `/api/formdatareport/...`、body module `biaoge` 或 `formdatareport` 视接口而定 |
 | `e10-cli form layout read <objId> [--view-id <id>] [--raw] [--out <file>]` | 读表单布局结构；raw/out 获取完整原生快照，含 workbook。不传 view-id 读默认布局 |
 | `e10-cli form layout describe <id> [--module ebuilderform\|workflow\|biaoge] [--id-type obj\|form] [--view-id <id>] [--terminal PC\|MOBILE] [--field <名称或ID>] [--out <file>]` | 只读输出目标布局、字段标题和值组件、分组、明细及网格摘要；`--out` 保存完整结构化结果，保留 `layout read --raw` 作为原生快照入口。使用方法见 `form/layout/inspect-edit.md` |
+| `e10-cli form layout detail get\|set <id> <subFormId> --view-id <布局ID> [--module ebuilderform\|workflow] [--config <JSON或@文件>] [--apply]` | 查询或部分更新明细容器属性、行操作权限和操作者过滤；set 默认预览，apply 保存并回读。开启必填需正整数 requiredRows，自动开启显示、编辑；过滤只允许目标明细内的人员／部门／分部字段。完整码表及参数见 `form/layout/detail-settings.md` |
 | `e10-cli form layout diff <id> --terminal PC\|MOBILE --config @layout-edit.json [--module ...] [--view-id <id>] [--out <file>]` | 只读预览表格式布局行高、列宽、已有单元格样式及字段标题／值组件位置的前后差异、关联组件和冲突；不会保存。配置见 `form/layout/inspect-edit.md` |
 | `e10-cli form layout edit <id> --terminal PC\|MOBILE --config @layout-edit.json --preview @layout-diff.json [--module ...] [--view-id <id>] [--out <file>]` | 核对预览报告、配置哈希和最新快照后，单次保存表格式布局网格样式或同网格字段位置调整，并独立回读；旧预览会阻断。见 `form/layout/inspect-edit.md` |
 | `e10-cli form layout document export <id> --out <file> [--module ...] [--view-id <id>]` | 只读导出可编辑的完整 `formLayout` 文档，保留目标、环境、字段与快照指纹。见 `form/layout/document.md` |
@@ -256,8 +263,8 @@
 | `e10-cli role update <roleId> [--name …] [--code …] [--remark …] [--parent <id>]` | 局部修改角色基础信息，保留未指定项，保存后回读；父角色必须存在且不可形成循环 |
 | `e10-cli role create <name>` | 创建角色，`--parent <id>` 指定父角色，`--code` 编码，`--remark` 备注 |
 | `e10-cli role delete <ids...>` | 删除角色（可多个） |
-| `e10-cli role permission list <roleId>` | 查询当前角色功能权限集的编码、名称、选中与禁用状态；权限项来自平台权限树，不使用固定码表 |
-| `e10-cli role permission add\|remove <roleId> <permissionSetCode>` | 按权限集编码授予/移除一项功能权限；先从权限树确认目标，再用增量 `addList/removeList` 保存并回读选中状态，不覆盖其他权限 |
+| `e10-cli role permission list <roleId>` | 查询当前角色功能权限集的 `menuCode`、编码、名称、选中与禁用状态；权限项来自平台权限树，不使用固定码表。**同一编码可能对应多项**，用 `menuCode` 区分 |
+| `e10-cli role permission add\|remove <roleId> <permissionSetCode> [--menu-code <menuCode>]` | 按权限集编码授予/移除一项功能权限；先从权限树确认目标，再用增量 `addList/removeList` 保存并回读选中状态，不覆盖其他权限。编码重码（如 `default`/`export`/`saveConfig`）时必须用 `--menu-code` 指定菜单；未指定且命中多项会列出候选并停止，不会误授 |
 | `e10-cli role add-member <roleId> [<名字...>] [--id <id,id>] [--type <类型>]` | 添加角色成员。**两条入口二选一**：给**名字**（可多个，各自独立搜索）或给 **`--id`**（逗号分隔，直接指定对象）。同名多条时用 `--id` —— 名字入口**精确同名优先**，同名多条、或多条命中却没有同名项，一律**报错不取首条**（取首条会静默加错人），报错里会列出候选及其 id。两条入口**最终走同一个构造器**，平台收到的东西完全一致（`--id` 不是"只发个 id"，而是先按 id 把对象读回来）。`--type` 取 `resource`(人员，缺省) / `department`(部门) / `subcompany`(分部) / `position`(岗位) / `channel`(**群组**) —— 这几项正是平台 `objectTypeFilter` 白名单里**可以逐个选**的对象，白名单另三项 `all`/`external`/`allExternal` 不是逐个选的对象，本命令不支持。五类走**同一个保存端点**，靠 `objType` 选各自数组（`obj_resource` / `obj_department` / `obj_subcompany` / `obj_position` / `obj_channel`）。`--sec-min/--sec-max`、`--is-seclevel` 覆盖安全级别（**这两个值随租户配置变**，缺省 `0`/`100` + false）；`--department-attribute subordinate,partTimeStaff` 给部门/分部指定是否含下级 / 含兼职。**`--level` 设「成员级别」**（总部 / 分部 / 部门，缺省**总部**；本次添加的成员共用同一档）；**`--org-scope` 设「分权范围」**（成员能维护哪些机构，缺省全部机构；可选 同部门 / 同部门的下级部门 / 同部门及下级部门 / 同分部 / 同分部的下级分部 / 同分部及下级分部）。`role member-list` 的输出会带 `级别=` / `范围=` 便于核对。**增量追加**，不会冲掉已有成员。⚠ `--id` 里**有不存在的 id 会直接报错**（平台对取不到的 id 是静默丢弃的，不核对就会"报成功但少加了一个"）|
 | `e10-cli role member-list <roleId>` | 列出角色成员（人员 / 部门 / 分部 / 岗位 / 群组，含成员级别与分权范围） |
 | `e10-cli role add-scope-member <roleId> --type all\|allExternal [--level 总部\|分部\|部门]` | 添加“所有人”或“全部外部联系人”成员；指定外部人员不支持 |
@@ -453,7 +460,7 @@
 > **删连线**: delete-link 直接操作出口列表 API (getWfpNodeLinkTable → saveNodeLinkEditTable, deleteRows)
 > **删节点**: delete-node 直接操作节点列表 API (saveNodeEditTable, deleteRows)，`--bridge` 自动桥接
 > **查看节点/出口**: nodes --mode list / link-list 走列表 API（比 chart XML 更完整）
-> **加分支条件两种方式**: 
+> **加分支条件两种方式**:
 >   - 简化: `condition add` — 一行命令搞定
 >   - 完整: generate-link-id → save-layout → save-condition → set-link-condition-key
 > **加节点提交动作（字段常量赋值）**: save-action @action.json（格式见 `workflow/guide-workflow-action.md`）
@@ -736,3 +743,11 @@ e10-cli workflow action list-node <wf> <nodeId>
 写入使用 `--data JSON/@文件`，未指定项保留，单次保存后回读。详见 [参数、范围与自然语言示例](../workflow/guide-opinion-settings.md)。
 
 | `e10-cli workflow base file-set <workflowId>` | 附件删除开关：`--create-delete 0/1`、`--async-delete 0/1`；先读后合并，保存后回读。 |
+
+页面权限：`page permission get/schema`、`common add/update/remove`、`matrix fields/add/update/remove`；默认预览，`--apply` 保存。配置结构与码表见 [页面权限指南](../ebuilder-designer/guide-page-permission.md)。
+
+组合页面：使用 page combination 的 list/get/create/update/copy/delete、tab add/update/remove/order、tab permission get/schema/add/remove。配置见 [组合页面指南](../ebuilder-designer/guide-page-combination.md)。
+
+普通页面源码：`designer source read <pageId> --terminal pc|mobile [--out file]`；`designer source check --js-file page.js --css-file page.css` 离线检查；`designer source set <pageId> --terminal pc|mobile --js-file page.js --css-file page.css [--apply]` 默认预览，`--clear-js/--clear-css` 显式清空；`designer source sdk [--query 方法名] [--id 接口ID] [--out file]` 查询接口文档。见 [页面源码指南](../ebuilder-designer/page-source/page-source-guide.md) 及 [完整 SDK 索引](../ebuilder-designer/page-source/sdk-index.md)。
+
+页面事件：`designer event schema` 查询动作及码表；`get/set/enable/remove <pageId> [--comp id] [--collection name --item id] --terminal pc|mobile|both` 定位页面、组件或子项；写命令使用 `--trigger CLICK|DIDMOUNT`，`set --config @action.json` 替换唯一动作，`enable --value true|false` 启停，`--apply` 保存。`lookup --kind page|esb|logic|device|person|sign --id id` 读取资源；`condition-create <pageId> --comp id --where-file file [--apply]` 独立创建刷新过滤条件。完整配置见 [事件指南](../ebuilder-designer/events/guide-events.md)。

package/skill-docs/references/ebuilder-designer/events/actions-integration.md

@@ -0,0 +1,88 @@
+# 页面事件集成动作
+
+动作统一以 `{type,enabled?,config}` 保存。config 使用各动作自己的原生字段，CLI 不执行这些动作，保存不等于调用成功。实际资源从对应浏览或设置接口取得，不能用显示名称伪造对象。
+
+## 资源查询
+
+```bash
+e10-cli designer event lookup --kind page --id <pageId>
+e10-cli designer event lookup --kind esb --id <applicationId>
+e10-cli designer event lookup --kind logic --id <logicId> --app-id <appId>
+e10-cli designer event lookup --kind device --id <deviceId>
+e10-cli designer event lookup --kind person --id <resourceId>
+e10-cli designer event lookup --kind sign --id <签署组件ID>
+```
+
+ESB 查询还读取输入表结构，返回 resource 和 inputSchema；逻辑流分页读取候选并按 ID 唯一匹配。没有匹配时检查目标应用和资源 ID。查询对象用于构造各动作配置，不能把查询到对象的 id、userid、applicationId 等不同标识互换。
+
+## 执行 ESB：EsbFlow
+
+config 对应 esbFlow，包含：
+
+- `esbData`：选择的自定义触发动作流完整对象数组，包含 id/applicationId、triggerType 等真实元数据。
+- `params`：输入配置，包含 formType:input、businessModule、tableList 等；每张表记录 setFormId、isMain、orderNum、fieldDatas、extFieldDatas。
+- `extFieldDatas` 按输入参数 paramName 配置，包含 value、switchType、originValue、otherParam、fieldName。固定值/平台表达式可使用 fixvalue，例如 value 和 originValue 均为 `{time}`。
+
+输入定义通过 `/api/bs/esb/setting/customData/application/getCustomDataByApplicationId` 查询，applicationId 为选中动作流的应用 ID，formType 为 input。tableList 内 id 是输入定义表 ID，实际映射中的 setFormId 应指向该定义表；映射记录自身的 id 不与业务字段 ID 混用。命令要求传完整参数结构，不根据名称猜测字段或主明细归属。
+
+配置外壳为 `{"type":"EsbFlow","config":{"esbData":[真实动作流对象],"params":完整输入配置}}`。输入必需字段和类型以该动作流的定义为准，不把 `{time}` 默认适配所有日期、月份字段。
+
+## 执行逻辑流：ExecLogicFlow
+
+config 对应 execLogicFlow：`data` 为完整前端逻辑流对象数组，`inputParams` 为输入映射数组。绑定对象 type 必须为 FRONTEND，来源页和终端等 ref 信息须与逻辑流的设计一致。
+
+```json
+{"type":"ExecLogicFlow","config":{"data":[{"id":"逻辑流ID","type":"FRONTEND","refType":"PAGE","name":"逻辑名称","isEnable":1}],"inputParams":[]}}
+```
+
+它绑定已有逻辑流，不代替创建节点、连线、变量、函数和生成逻辑代码。逻辑流资源与事件引用分别维护，不能只创建空画布就宣称业务逻辑完成。输入映射按目标逻辑流的真实定义提供。
+
+## 企业微信会话：OpenWeComSession
+
+config 对应 openWeComSession：chatidInput 会话标识、chatidInputType 输入来源、userids 人员对象数组、useridsType 人员来源、chatidOutput 输出会话变量名。当前结构化写入支持两种来源字段均为 fixvalue。
+
+```json
+{"type":"OpenWeComSession","config":{"chatidInput":"会话标识","chatidInputType":"fixvalue","userids":[],"useridsType":"fixvalue","chatidOutput":"chatId"}}
+```
+
+人员数组从真实人员浏览取得。会话变量不是页面参数名称的任意别名，需与目标变量设计匹配；实际打开依赖企业微信环境与账号对应关系。CLI 保存不会创建或打开会话。
+
+## 扫描上传：ScanUpload
+
+config 对应 scanUploadInfo。它包含设备和扫描文件处理设置：
+
+| 字段 | 配置内容 |
+|---|---|
+| deviceTypeSelect、deviceType | 设备选择模式和类型对象 |
+| useDevice | 实际设备浏览对象数组 |
+| dataProcess、actionFlow | 数据处理模式及选中的动作流 |
+| isMerge、isAutoCheck、isParallel | 合并、自动检查、并行相关布尔设置 |
+| fileType、uploadPathSelect | 输出文件和上传位置相关设置 |
+| scanFileNameType、scanFileNameCustom、scanFileNameField | 文件名模式、自定义名称、字段来源 |
+
+这些模式字段保留本入口原始字符串码，含义应从对应设备设置读取，不用字段名称推断所有枚举。可用设置接口有 `/api/bs/intdevice/web/eb/device/getBaseSetting`、`getScanSetting`、`getCardSetting`。实际 deviceType 3 的浏览对象标记为身份证阅读器，不把其他设备类型的选项和扫描器设置互换。
+
+需要真实 useDevice；有 actionFlow 时提供完整浏览对象。未提供完整模式设置会被拒绝。配置检查不能替代实体设备、驱动、客户端和文件处理实测。
+
+## 身份识别：LoginAuthentication
+
+config 对应 loginAuthenticationInfo，包括 deviceType 对象数组、useDevice 实际设备对象数组。设备类型浏览可能包含多类设备；识别方式标识与设备对象中的 deviceType 不一定使用同一套编号，不能因都叫 deviceType 就直接对应。读取设备资料后保留完整对象。
+
+本动作仅维护事件配置，不修改登录策略、不关闭鉴权，也不通过普通页面回读证明设备身份识别已通过。
+
+## 发起签署：StartSignAction
+
+原生字段为 startSignAction.signSetting、params。当前接口资料只有空 signSetting 和空 params，未定义非空签署目标的完整保存形状。因此本命令可读取、保留已有动作，并通过 enable/remove 管理；set 新增或替换明确拒绝。需补充选择真实 NewSign 设置、填写参数并保存的报文后再开放，不能保存空目标冒充可用。
+
+## 报表动作
+
+以下动作只提供 type 和可选 enabled，不接收 config：
+
+| type | 功能 |
+|---|---|
+| ReportPrint | 报表打印 |
+| ReportExport | 报表导出 |
+| CreateReportShot | 生成报表快照 |
+| ViewReportShot | 查看报表快照 |
+
+例如 `{"type":"ReportExport","enabled":true}`。它们依赖当前报表页面和运行上下文，不能通过添加到空白普通页面就获得报表数据。保存协议和启停可单独检查；实际打印、导出、生成/查看快照应在对应报表中验收。

package/skill-docs/references/ebuilder-designer/events/actions-interaction.md

@@ -0,0 +1,108 @@
+# 页面事件交互动作
+
+以下 config 放在 `{ "type":"动作类型", "enabled":true, "config":... }` 中。查询当前定义用 `designer event schema`；先读 [事件指南](guide-events.md) 理解单事件单动作和终端规则。
+
+## 打开页面 NewPage
+
+设置目标页面、打开形式、参数以及窗口外观。config 对应平台 linkInfo，目标信息通过 `designer event lookup --kind page --id <页面ID>` 获取。目标页面名称、所属应用等使用真实元数据。
+
+| openMode | 本事件入口的含义 |
+|---|---|
+| `"4"` | 当前页面 |
+| `"0"` | 新窗口 |
+| `"5"` | 弹出窗口 |
+| `"1"` | 右侧滑出 |
+| `"7"` | 右侧推出 |
+
+本码表不等于组合页面 openMode 或 ebSdk.openPage 的 openType。实际打开方式在 linkInfo.openMode；目标 page 中可能也保留 openMode 元数据，不能拿它覆盖本动作设置。
+
+```json
+{
+  "type":"NewPage",
+  "config":{
+    "page":{"pageId":"目标页面ID","pageName":"目标名称","pageType":"PAGE","parentId":"pages","appid":"目标应用ID","terminalScopes":"PC,MOBILE"},
+    "openMode":"5",
+    "name":"打开详情",
+    "params":[{"name":"source","value":"workbench","type":"fixed"}],
+    "modalWidth":"70%","modalHeight":"70%",
+    "pageTitle":{"nameAlias":"详情"},
+    "isBlankClose":false
+  }
+}
+```
+
+附加设置有 `icon` 图标描述、`flatToBottom`、`isRelationCustomPage`、`winSize`/`winSizeNew` 等。它们是否生效与窗口形式有关，读取对应设置后保留，不把所有尺寸字段当成同义字段。参数数组支持多个命名参数，本轮结构化参数为 name/value/type:fixed，值可包含平台表达式；不将其等同普通字符串替换。
+
+`paramsMode` 可保留本入口的 `"1"`/`"2"`。两值与界面传参模式的逐项含义尚需独立核清，命令不按其他入口的码表转换；未指定时不自动补值。存在此字段不意味着可以宣称“隐式传参无限长”。
+
+## 刷新组件 RefreshComp
+
+设置 `selectedCom` 目标组件数组；`filterIsNull`、`isOverrideFilter` 为本动作过滤选项布尔值；有过滤时携带完整 `dataset` 和 `conditionSet`。目标必须属于配置终端，both 会映射组件 ID。
+
+```json
+{"type":"RefreshComp","config":{"selectedCom":["列表组件ID"],"filterIsNull":true,"isOverrideFilter":true}}
+```
+
+SQL WHERE 条件独立存储，不能把条件文本直接放进 condition ID：
+
+```bash
+e10-cli designer event condition-create <pageId> --comp <触发组件ID> --where-file where.txt --apply
+```
+
+where.txt 是条件文本，例如 `1=1`。命令将文本 LZW 压缩，以 multipart 的 compId、conditionValue 创建条件并返回 ID；它不执行查询，也不替代数据库字段、表达式有效性及权限检查。创建是独立写入，之后保存事件失败时可能留下未引用条件，先记录 ID 再检查，不反复创建。
+
+引用形式：
+
+```json
+{"type":"sql_where","isNewFilter":true,"version":1,"data":{"condition":"返回条件ID","formDw":false,"sourceId":"目标数据源ID"}}
+```
+
+该对象放在 config.conditionSet 中，同时提供与目标组件一致的 dataset。条件创建接口没有在本命令中定义删除能力。
+
+## 关闭页面 ClosePage / 复制链接 CopyLink
+
+这两种动作不需要 config：`{"type":"ClosePage"}`、`{"type":"CopyLink"}`。关闭效果取决于页面宿主，复制效果取决于浏览器剪贴板能力，不用数据保存成功替代运行检查。
+
+## 条件控制 IF
+
+有规则判断和确认框两种模式，控制本次事件的条件结果；本入口不能在其后追加多个动作作为流程。
+
+```json
+{"type":"IF","config":{"mode":"dialog","title":"确认","content":"是否继续？","confirmText":"是","cancelText":"否"}}
+```
+
+规则使用明确的逻辑组和条件，不写平台机器 key：
+
+```json
+{"type":"IF","config":{"mode":"rule","condition":{"logic":"and","rules":[{"left":"{userid}","operator":"eq","right":"人员ID"},{"logic":"or","rules":[{"left":"20","operator":"gt","right":"15"}]}]}}}
+```
+
+本事件规则保存 `relationship:"1"` 为 AND、`"0"` 为 OR。CLI 同时生成条件树和条件显示文字；不沿用其他范围条件的逻辑码。当前可结构化编译 eq 等于、gt 大于；right 使用字符串。left 按平台表达式或输入文字原样写入，不把字段标题擅自转换为组件引用。规则模式保存 Rule；确认框保存 Dialog，切换模式移除原规则遗留字段。树最多 12 层、500 节点。
+
+## JavaScript JsCode
+
+```json
+{"type":"JsCode","config":{"code":"ebSdk.msg('操作完成');"}}
+```
+
+命令生成 compiledCode；编译失败不保存。脚本只影响当前事件环境，不在这里写页面 load 外壳或 import/export。可调用页面源码导出的函数：`pageSdk.getExports().方法名()`，前提是源码中存在对应 export。
+
+## 显示/隐藏组件 ShowHideComponent
+
+config 为数组，每项 id 是目标组件 ID，display 为 show 显示、hide 隐藏、switchover 切换：
+
+```json
+{"type":"ShowHideComponent","config":[{"id":"列表组件ID","display":"switchover"},{"id":"导航组件ID","display":"show","children":[{"id":"导航项ID","display":"hide"}]}]}
+```
+
+children 用于组件内部真实子项，并非任意 DOM 节点；不把显示隐藏当成权限控制。
+
+## 显示菜单 ShowMenu
+
+`menuType`：dropDownMenu 下拉菜单、footerMenu 底部菜单；`displayMode`：vertical 纵向、horizontal 横向；本次可用位置字段 menuPosition 包括 bottom、right，其他位置需读取本入口设置后再用。
+
+```json
+{"type":"ShowMenu","config":{"menuType":"dropDownMenu","menuPosition":"bottom","displayMode":"vertical","menuItems":[{"menuName":"显示提示","menuIcon":"","action":{"type":"JsCode","config":{"code":"ebSdk.msg('菜单执行');"}}}]}}
+```
+
+每项可配置独立 id、menuName、menuIcon。新增时省略 id 由 CLI 生成；action 编译为该菜单项的 CLICK 事件，仍只有一个动作。读取原有菜单时可见原生 menuEvent；action 与 menuEvent 二选一，不同时填。嵌套菜单事件最多 8 层，不能利用嵌套数组绕过单事件单动作限制。

package/skill-docs/references/ebuilder-designer/events/guide-events.md

@@ -0,0 +1,57 @@
+# 页面与组件事件配置
+
+## 整体功能介绍
+
+事件配置把页面或组件的触发时机与一个动作绑定，可实现打开/关闭页面、刷新、条件判断、JavaScript、组件显隐、菜单、集成及其他交互。它保存于页面布局的事件设置中，与页面源码 JS/CSS 分别维护。
+
+**同一配置对象的单击 CLICK 和加载完成 DIDMOUNT 各最多一条，每条最多一个动作。两种事件可以同时存在。** 修改事件是替换该动作，不追加动作列表；没有动作的事件不承担业务行为。条件控制不是包含多个动作的流程编排，需要复杂步骤时绑定已经配置好的逻辑流或使用相应事件脚本。
+
+配置对象可为页面、组件，或组件中的导航/按钮子项。每个对象独立维护事件；显示菜单的菜单项也可有自己的单击事件。页面事件位于 `layout.config.eventGroup`，组件事件位于 `comp.config.eventGroup`，子项事件位于对应子项。它们采用双层 `eventGroup`，条目内 `events` 只包含一个动作，不把平台数组形式理解为支持多个动作。
+
+## 查询与命令
+
+```bash
+e10-cli designer event schema
+e10-cli designer event get <pageId> --comp <compId> --terminal pc
+e10-cli designer event get <pageId> --terminal pc
+e10-cli designer event set <pageId> --comp <compId> --trigger CLICK --config @action.json
+e10-cli designer event set <pageId> --comp <compId> --trigger CLICK --config @action.json --apply
+e10-cli designer event enable <pageId> --comp <compId> --trigger CLICK --value false --apply
+e10-cli designer event remove <pageId> --comp <compId> --trigger DIDMOUNT --apply
+```
+
+默认预览，`--apply` 保存。`set` 在没有该事件时新增，在已有该事件时替换唯一动作，保留另一种事件。`enable` 只改动作启用标记；`remove` 删除指定触发事件。不存在事件时删除会报错，不将其当成成功。
+
+省略 `--comp` 操作页面事件。操作直接子项时传 `--comp`、`--collection menuConfig|btnGroup|navMenus|newButtons`、`--item <子项ID>`，按真实 ID 定位，不按显示名称或数组下标猜测。
+
+配置统一为：
+
+```json
+{"type":"JsCode","enabled":true,"config":{"code":"ebSdk.msg('操作完成');"}}
+```
+
+`type` 为本入口动作类型，`enabled` 默认为 true，`config` 为该动作的设置。普通动作配置见 [交互动作](actions-interaction.md)，外部资源和宿主相关动作见 [集成动作](actions-integration.md)。
+
+## 终端与保存
+
+`--terminal pc|mobile|both`，默认 pc。单端修改保留另一端；both 以 PC 组件为源，通过双向 `refCompId` 定位 MOBILE 组件。刷新目标、显隐目标会转换为对应终端的组件 ID，缺少配对则拒绝。子项必须在对应终端存在相同真实子项 ID；不按名称猜测子项映射。
+
+JavaScript 和集成参数属于不透明业务内容，不在字符串内部替换组件 ID。两端需要不同代码或打开方式时，分别设置 pc/mobile，不使用 both 强行覆盖。打开方式只控制对应动作，不改变目标页面的布局或权限。
+
+保存前读取整页双端布局和编辑状态；页面已锁定时停止，不解除他人编辑锁。保存前再次检查并发变化，保存后核对组件、事件、页面配置和源码，再释放本次保存软锁。其他事件、其他组件、源码和主题配置均保留。失败或响应丢失时先 get 查询状态，不重复盲写。
+
+修改动作类型时仅生成新类型的配置，移除上一类型遗留的参数。更新同一事件仍需提供完整 config，不对缺少的动作参数作隐式继承。
+
+## 编写边界
+
+事件 JavaScript 的 `code` 与 `compiledCode` 同步维护；这里只编译脚本片段，不使用页面源码的 JSONP/load 外壳，不使用 import/export。`ebSdk`、`pageSdk` 和事件环境由平台提供。异步动作衔接可使用仅适用于事件动作的 `asyncFn`，见 [页面 SDK 基础](../page-source/sdk-foundations.md)。
+
+页面源码 `pageSdk.on('pageLoad')` 与事件配置 `DIDMOUNT` 是不同入口，不混写名称。涉及组件内部数据时按页面 SDK 的 compLoad 等时机处理；不要在加载完成动作中无条件刷新自身，造成重复加载。
+
+配置保存检查和前台行为检查分别判断。设备、企业微信、签署和报表依赖对应资源及运行宿主；不能因动作成功写入普通页面就认定这些外部功能已经执行成功。
+
+## 当前支持范围
+
+18 种动作可识别、查询和保留；其中 17 种支持本指南所列结构的新增/替换。StartSignAction 仅支持已有动作的查询、启停、删除，非空签署目标的新增结构需补充后开放。规则条件结构化编译当前支持 eq、gt 和 and/or 嵌套；不将其他模块的操作符或逻辑码直接拿来填。
+
+原有导航专用命令只覆盖其特定跳页配置，不代表通用事件能力；统一事件设置使用本组命令。新增事件或动作排序不适用于这里。