weaver-e10-builder 1.5.13 → 1.5.15

package/skill-docs/_catalog.md

@@ -1,97 +1,106 @@
-# Skill Ebcoder 目录索引
-
-> 此文件列出所有子文档的加载条件，供 Agent 按需加载。不要一次性加载全部。
->
-> 以下所有路径统一写作 `references/...`：相对工作区根目录（`skill copy` 拷出的位置），或本机 skill 根目录（完整安装自带）。
-
-## Guides（编码指南）
-
-| 用户意图关键词 | 加载文档 |
-|---------------|---------|
-| 表单CRUD、增删改查、getSimpleData、withDisplayNames、getFieldOptions、saveFormData、updateFormData、deleteFormData、字段类型 | `references/coding/guide-form-crud.md`（前端代码） |
-| 编辑、修改、回显、handleEdit、getAllData、rawData、selectedPerson、editForm、数据回填 | `references/coding/guide-edit-backfill.md`（前端代码） |
-| 显隐联动、条件显示、form linkage、为空/不为空条件、NULL 算子 | `references/form/guide-form-linkage.md` |
-| 函数联动、本表字段公式赋值、赋值式公式、EXCEL 公式联动、字段自动计算、form formula-linkage、wf-form formula-linkage、流程表单函数联动、值改变时、载入时触发、当前工作流生效 | `references/form/guide-formula-linkage.md` |
-| 字段联动、跨表带出、field-linkage、多跳带出、带出字段赋值、Text 字段取名称 | `references/form/guide-field-linkage.md` |
-| 新建表单、form create、EB 表单标准创建流程 | `references/form/guide-create-form.md` |
-| 二级明细、子明细、父级行标识、子级行标识、多级明细 | `references/form/guide-form-sub-detail.md` |
-| 物理表、多物理表、附属物理表、saveFormTable、getFormAGroupList、字段管理其他页签、字段超过100、add-physical-table、add-physical-field | `references/form/guide-form-physical-table.md` |
-| 虚拟表、虚拟表单、数据源表单、业务表展示、数据加工结果 | `references/form/guide-virtual-form.md` |
-| 字段定义、字段类型、关联字段码表、DateRange、multiple | `references/form/ref-form-fields.md` |
-| FLOW/EXCEL、布局样表、布局蓝图、字段分组、singleRow | `references/form/guide-form-layout-planning.md` |
-| 布局样式模板、换配色、form layout init | `references/form/style-templates.md`（流式/表格式两套，同名不同 id） |
-| 图片/XLSX源样式还原、imageStyles、pageLayouts、已有字段绑定、字体字号颜色确认、style-review、layout extract/compile/apply/verify/style-audit | `references/form/guide-form-layout-source.md` |
-| 已有表单加字段、改必填/只读、布局被重建、add-field --reinit、别动别人的表、布局组件、associatedId、字段标题取不到 | `references/form/guide-form-layout-incremental.md` |
-| 表单复杂编号、serial-mark、流水号、代字 | `references/form/guide-form-serial-mark.md` |
-| 分类搜索、分类筛选、list-search-group、选项配置、日期粒度、选项排序 | `references/common/ref-cli-commands.md` |
-| 表单消息提醒、数据变动提醒、form message、提醒对象、推送渠道、IM提醒 | `references/form/guide-form-message.md` |
-| 表单数据读写、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` |
-| 列表自定义文本列、富文本列、列里插入字段、form nlist、列表式视图 | `references/form/guide-list-custom-text.md` |
-| 流程、审批、workflow、提交流程、flowpage、预填、URL传参、节点、操作者、审批人、连线 | `references/workflow/guide-workflow.md` |
-| 撤回管理、加审管理、减审管理、接收人范围、指定流转接收人范围、转发传阅抄送收回、功能管理 | `references/workflow/guide-function-management.md` |
-| 拟签意见、draft-opinion、节点转发、forward-setting、节点签字意见、必须签批签名、隐藏意见输入框、意见显示类型 | `references/workflow/guide-opinion-settings.md` |
-| 流程绑的表、流程关联表单、workflow info、workflowId 查表单、formId 不是 objId | `references/common/ref-cli-commands.md`（`workflow info` 一行） |
-| 权责表、权责矩阵、权责表方式流程、分支场景、变量映射 | `references/workflow/guide-workflow-auth-resp.md` + `references/workflow/guide-workflow-condition.md` |
-| 公文流程、公文审批、收文、发文、公文设置、正文设置 | `references/workflow/guide-workflow-odoc.md` + `references/workflow/guide-workflow.md` |
-| 分支条件、出口条件、条件JSON、save-condition、连线条件、condition add | `references/workflow/guide-workflow-condition.md` |
-| 条件操作符编码、字段类型矩阵、关系符 | `references/workflow/operator-matrix.md` |
-| 动作流、跨表单、写入台账、ActionEbAdd/ActionEbUpdate/ActionEbDelete、提交事件、自定义事件触发、内置MQ监听/发送、HTTP/HTTPS、DML/数仓 | `references/workflow/guide-workflow-action.md`；复杂动作流组件契约按需读取 `actionflows/SKILL.md` 及其 `references/components/` |
-| 鉴权、登录、auth、ETEAMSID、多环境、profile、切换环境 | `references/auth/guide-auth.md` |
-| HRM矩阵、条件矩阵、部门矩阵、分部矩阵、matrix、映射表、行 id、rowId、syncType | `references/hrm/guide-matrix.md` |
-| 报表、设计器报表、EDC报表、新建报表、report build、数据集、报表列、父格、合并、冻结、tableName | `references/report/guide-report-build.md`（建表主干）· `guide-report-modify.md`（改已有）· `ref-report-pitfalls.md`（先扫坑） |
-| 报表查询条件、高级搜索、筛选、queryType、默认值三件套 | `references/report/guide-report-query.md`；细则 `query-condition-api-guide.md` |
-| 报表命令、report 子命令、report build/verify/fix/scope/snapshot | `references/report/ref-report-commands.md` |
-| 报表接口、saveReportDevInfo、addDataset、getReportDevInfo、报表落库流程 | `references/report/api-report-build-fast-path.md` · `report-config-schema.md`（配置结构） · `report-data-model.md`（枚举） |
-| 报表单元格模型、cellType、displayType、expandType、groupType、countType | `references/report/report-data-model.md` · `report-config-schema.md` |
-| 报表权限、共享范围、viewRight、权责矩阵 | `references/report/report-permission-guide.md` |
-| 报表版本、快照、生命周期、回收站、复制挂菜单 | `references/report/report-lifecycle-api-guide.md` |
-| 报表条件格式、数据条、图标集 | `references/report/condition-format-guide.md` |
-| 新页面、导出、路由、entry.js、regOvProps、regReactChildren、asyncImport、publicUrl、Suspense | `references/coding/guide-page-export.md`（前端代码） |
-| 写页面、页面代码、React编码、组件、entry.js模板 | `references/coding/guide-page-code.md`（前端代码） |
-| 页面设计器、配置式页面、仪表盘、看板页、designer、page create、comp-add、工厂模板、factory、组件模板、页面布局、designer layout/save、页面版本、version revert、发布页面菜单、publish-menu、自定义CSS、组件样式、选择器、DOM结构、样式不生效 | `references/ebuilder-designer/guide-designer.md`（布局层主干）· `guide-designer-components.md`（组件 config）· `guide-designer-factory.md`（工厂模板）· `guide-designer-version.md`（版本）· `guide-designer-css.md`（自定义 CSS 与 DOM 结构索引） |
-
-## Reference（参考手册）
-
-| 用户意图关键词 | 加载文档 |
-|---------------|---------|
-| CLI、命令、打包、build、import、创建应用、创建表单、菜单、project、form create、app create、matrix | `references/common/ref-cli-commands.md` |
-| 应用发布、启用应用、停用应用、发布到前台、取消发布、应用发布信息、前台入口、应用名多语言、app enable/disable/publish/unpublish/publish-info、app lang | `references/app/guide-app-publish.md` |
-| 完整实施方案、规划能力地图、资源依赖、需求映射、plan 前预检、平台架构、Ecode、默认台账与菜单 | `references/common/map.md`，随后使用 `references/common/guide-plan-template.md` |
-| 安装、升级、装不上、skill 重装、skill remove、skill sync、references 文档缺失、WorkBuddy | `references/common/guide-install.md` |
-| 能力边界、支不支持、能不能做、不支持的能力 | `references/common/capability-boundaries.md` |
-| 接口文档导入、Postman、系统接口、连接器接口、createSystemInterfaceByAi、接口批量创建 | `references/esb-interface/guide-import.md` |
-| 系统菜单、内置菜单、挂系统页面到菜单、menuUrl、pageType、工作流菜单、独立页面菜单、菜单改名、menu rename、重命名菜单、找不到菜单、二级菜单、子菜单、父菜单、菜单层级、menu add-table --parent、menu add-start --parent | `references/menu/system-menus.md` + `references/common/ref-cli-commands.md` |
-| 编译、语法、报错、不支持、babel、打包、var、const、let、es2015、stage-2 | `references/coding/ref-compile-rules.md`（前端代码） |
-
-## Components（组件文档）
-
-| 用户意图关键词 | 加载文档 |
-|---------------|---------|
-| Button、按钮 | `references/components/@weapp-Button.md` |
-| Table、表格 | `references/components/display-Table.md` |
-| List、列表 | `references/components/display-List.md` |
-| Pagination、分页 | `references/components/display-Pagination.md` |
-| Icon、图标 | `references/components/display-Icon.md` |
-| Avatar、头像 | `references/components/display-Avatar.md` |
-| EChart、图表、Echarts | `references/components/generic-Echarts.md` |
-| 文件预览、CorsComponent | `references/components/display-FilePreview.md` |
-| Input、输入框、文本框 | `references/components/form-Input.md` |
-| 人员选择、Browser Employee、resource | `references/components/form-EmployeeBrowser-api.md` |
-| 部门选择、Browser Department、department | `references/components/form-DepartmentBrowser-api.md` |
-| Upload、文件上传、附件、FileComponent | `references/components/form-Upload.md` |
-| Badge、徽标 | `references/components/base-Badge.md` |
-| Tag、标签 | `references/components/base-Tag.md` |
-
-## 组合场景
-
-| 场景 | 需加载的文档 |
-|------|-------------|
-| CRUD 列表页 | `references/coding/guide-form-crud.md`（前端代码） + `references/components/display-Table.md` + `references/components/display-Pagination.md` |
-| 表单新增/编辑弹窗 | `references/coding/guide-form-crud.md`（前端代码） + `references/coding/guide-edit-backfill.md` + 对应表单组件文档 |
-| 新建完整应用 | `references/common/ref-cli-commands.md` + `references/form/guide-create-form.md` + `references/coding/guide-page-export.md`（前端代码） |
-| 流程触发页面 | `references/workflow/guide-workflow.md` + `references/coding/guide-form-crud.md`（前端代码） |
-| 流程分支条件 | `references/workflow/guide-workflow.md` + `references/workflow/guide-workflow-condition.md` |
-| 跨表单动作流 | `references/workflow/guide-workflow.md` + `references/workflow/guide-workflow-action.md` |
-| 编译报错排查 | `references/coding/ref-compile-rules.md`（前端代码） |
+# Skill Ebcoder 目录索引
+
+> 此文件列出所有子文档的加载条件，供 Agent 按需加载。不要一次性加载全部。
+>
+> 以下所有路径统一写作 `references/...`：相对工作区根目录（`skill copy` 拷出的位置），或本机 skill 根目录（完整安装自带）。
+
+## Guides（编码指南）
+
+| 用户意图关键词 | 加载文档 |
+|---------------|---------|
+| 表单布局源码、布局 CSS、表单级 ecode、JSSDK、表单代码块、保存前代码校验、字段事件脚本、明细汇总脚本、字段组件局部复写 | `form code layout/read/set`、`wf-form code layout/read/set`、`form code ecode/list/add`、`wf-form code ecode/list/add`；先读 `references/code-block/guide-code-block.md`，布局 CSS 另读 `references/code-block/guide-layout-css.md`，再按效果读取 JSSDK 专题，不与页面 `entry.js` 编码混用；**布局源码 ecode 必须 `encodeURI`，不能用 `encodeURIComponent`** |
+| 表单CRUD、增删改查、getSimpleData、withDisplayNames、getFieldOptions、saveFormData、updateFormData、deleteFormData、字段类型 | `references/coding/guide-form-crud.md`（前端代码） |
+| 编辑、修改、回显、handleEdit、getAllData、rawData、selectedPerson、editForm、数据回填 | `references/coding/guide-edit-backfill.md`（前端代码） |
+| 显隐联动、条件显示、form linkage、为空/不为空条件、NULL 算子 | `references/form/guide-form-linkage.md` |
+| 浏览数据定义、浏览字段可配置能力、高级搜索默认条件、人员可选范围、浏览 Tab | `references/form/guide-browser-definition.md` |
+| 函数联动、本表字段公式赋值、赋值式公式、EXCEL 公式联动、字段自动计算、form formula-linkage、wf-form formula-linkage、流程表单函数联动、值改变时、载入时触发、当前工作流生效 | `references/form/guide-formula-linkage.md` |
+| 字段联动、跨表带出、field-linkage、多跳带出、带出字段赋值、Text 字段取名称 | `references/form/guide-field-linkage.md` |
+| 新建表单、form create、EB 表单标准创建流程 | `references/form/guide-create-form.md` |
+| 二级明细、子明细、父级行标识、子级行标识、多级明细 | `references/form/guide-form-sub-detail.md` |
+| 物理表、多物理表、附属物理表、saveFormTable、getFormAGroupList、字段管理其他页签、字段超过100、add-physical-table、add-physical-field | `references/form/guide-form-physical-table.md` |
+| 虚拟表、虚拟表单、数据源表单、业务表展示、数据加工结果 | `references/form/guide-virtual-form.md` |
+| 字段定义、字段类型、关联字段码表、DateRange、multiple | `references/form/ref-form-fields.md` |
+| FLOW/EXCEL、布局样表、布局蓝图、字段分组、singleRow | `references/form/guide-form-layout-planning.md` |
+| 布局样式模板总览、公共规则、form layout init | `references/form/form-template/style-templates.md`（分类入口） |
+| 表格式简易模板新增、编辑、预览 | `references/form/form-template/style-templates-easy.md` |
+| 表格式高级模板结构、重复规则、图片样式迁移 | `references/form/form-template/style-templates-advanced.md` |
+| 表格式高级模板 CSS、主题变量、明细表隔行、组件选择器 | `references/form/form-template/style-templates-advanced-css-guide.md` |
+| 流式布局模板 | `references/form/form-template/style-templates-flow.md` |
+| 图片/XLSX源样式还原、imageStyles、pageLayouts、已有字段绑定、字体字号颜色确认、style-review、layout extract/compile/apply/verify/style-audit | `references/form/guide-form-layout-source.md` |
+| 已有表单加字段、改必填/只读、布局被重建、add-field --reinit、别动别人的表、布局组件、associatedId、字段标题取不到 | `references/form/guide-form-layout-incremental.md` |
+| 表单复杂编号、serial-mark、流水号、代字 | `references/form/guide-form-serial-mark.md` |
+| 分类搜索、分类筛选、list-search-group、选项配置、日期粒度、选项排序 | `references/common/ref-cli-commands.md` |
+| 表单消息提醒、数据变动提醒、form message、提醒对象、推送渠道、IM提醒 | `references/form/guide-form-message.md` |
+| 表单数据读写、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` |
+| 列表自定义文本列、富文本列、列里插入字段、form nlist、列表式视图 | `references/form/guide-list-custom-text.md` |
+| 流程、审批、workflow、提交流程、flowpage、预填、URL传参、节点、操作者、审批人、连线 | `references/workflow/guide-workflow.md` |
+| 撤回管理、加审管理、减审管理、接收人范围、指定流转接收人范围、转发传阅抄送收回、功能管理 | `references/workflow/guide-function-management.md` |
+| 工作流基础设置、权限设置、auth-set、共享设置、share-set、按条件共享、共享字段权限、提醒设置、remind-set、指定节点提醒、邮件短信模板 | `references/workflow/guide-base-auth-share-remind.md` |
+| 拟签意见、draft-opinion、节点转发、forward-setting、节点签字意见、必须签批签名、隐藏意见输入框、意见显示类型 | `references/workflow/guide-opinion-settings.md` |
+| 流程绑的表、流程关联表单、workflow info、workflowId 查表单、formId 不是 objId | `references/common/ref-cli-commands.md`（`workflow info` 一行） |
+| 权责表、权责矩阵、权责表方式流程、分支场景、变量映射 | `references/workflow/guide-workflow-auth-resp.md` + `references/workflow/guide-workflow-condition.md` |
+| 公文流程、公文审批、收文、发文、公文设置、正文设置 | `references/workflow/guide-workflow-odoc.md` + `references/workflow/guide-workflow.md` |
+| 分支条件、出口条件、条件JSON、save-condition、连线条件、condition add | `references/workflow/guide-workflow-condition.md` |
+| 条件操作符编码、字段类型矩阵、关系符 | `references/workflow/operator-matrix.md` |
+| 动作流、跨表单、写入台账、ActionEbAdd/ActionEbUpdate/ActionEbDelete、提交事件、自定义事件触发、内置MQ监听/发送、HTTP/HTTPS、DML/数仓 | `references/workflow/guide-workflow-action.md`；复杂动作流组件契约按需读取 `actionflows/SKILL.md` 及其 `references/components/` |
+| 鉴权、登录、auth、ETEAMSID、多环境、profile、切换环境 | `references/auth/guide-auth.md` |
+| HRM矩阵、条件矩阵、部门矩阵、分部矩阵、matrix、映射表、行 id、rowId、syncType | `references/hrm/guide-matrix.md` |
+| 报表、设计器报表、EDC报表、新建报表、report build、数据集、报表列、父格、合并、冻结、tableName | `references/report/guide-report-build.md`（建表主干）· `guide-report-modify.md`（改已有）· `ref-report-pitfalls.md`（先扫坑） |
+| 报表查询条件、高级搜索、筛选、queryType、默认值三件套 | `references/report/guide-report-query.md`；细则 `query-condition-api-guide.md` |
+| 报表命令、report 子命令、report build/verify/fix/scope/snapshot | `references/report/ref-report-commands.md` |
+| 报表接口、saveReportDevInfo、addDataset、getReportDevInfo、报表落库流程 | `references/report/api-report-build-fast-path.md` · `report-config-schema.md`（配置结构） · `report-data-model.md`（枚举） |
+| 报表单元格模型、cellType、displayType、expandType、groupType、countType | `references/report/report-data-model.md` · `report-config-schema.md` |
+| 报表权限、共享范围、viewRight、权责矩阵 | `references/report/report-permission-guide.md` |
+| 报表版本、快照、生命周期、回收站、复制挂菜单 | `references/report/report-lifecycle-api-guide.md` |
+| 报表条件格式、数据条、图标集 | `references/report/condition-format-guide.md` |
+| 新页面、导出、路由、entry.js、regOvProps、regReactChildren、asyncImport、publicUrl、Suspense | `references/coding/guide-page-export.md`（前端代码） |
+| 写页面、页面代码、React编码、组件、entry.js模板 | `references/coding/guide-page-code.md`（前端代码） |
+| 页面设计器、配置式页面、仪表盘、看板页、designer、page create、comp-add、工厂模板、factory、组件模板、页面布局、designer layout/save、页面版本、version revert、发布页面菜单、publish-menu、自定义CSS、组件样式、选择器、DOM结构、样式不生效 | `references/ebuilder-designer/guide-designer.md`（布局层主干）· `guide-designer-components.md`（组件 config）· `guide-designer-factory.md`（工厂模板）· `guide-designer-version.md`（版本）· `guide-designer-css.md`（自定义 CSS 与 DOM 结构索引） |
+
+## Reference（参考手册）
+
+| 用户意图关键词 | 加载文档 |
+|---------------|---------|
+| CLI、命令、打包、build、import、创建应用、创建表单、菜单、project、form create、app create、matrix | `references/common/ref-cli-commands.md` |
+| 应用发布、启用应用、停用应用、发布到前台、取消发布、应用发布信息、前台入口、应用名多语言、app enable/disable/publish/unpublish/publish-info、app lang | `references/app/guide-app-publish.md` |
+| 完整实施方案、规划能力地图、资源依赖、需求映射、plan 前预检、平台架构、Ecode、默认台账与菜单 | `references/common/map.md`，随后使用 `references/common/guide-plan-template.md` |
+| 安装、升级、装不上、skill 重装、skill remove、skill sync、references 文档缺失、WorkBuddy | `references/common/guide-install.md` |
+| 能力边界、支不支持、能不能做、不支持的能力 | `references/common/capability-boundaries.md` |
+| 接口文档导入、Postman、系统接口、连接器接口、createSystemInterfaceByAi、接口批量创建 | `references/esb-interface/guide-import.md` |
+| 系统菜单、内置菜单、挂系统页面到菜单、menuUrl、pageType、工作流菜单、独立页面菜单、菜单改名、menu rename、重命名菜单、找不到菜单、二级菜单、子菜单、父菜单、菜单层级、menu add-table --parent、menu add-start --parent、菜单排序、菜单顺序、放第一个、menu order、showOrder、--first | `references/menu/system-menus.md` + `references/common/ref-cli-commands.md` |
+| 编译、语法、报错、不支持、babel、打包、var、const、let、es2015、stage-2 | `references/coding/ref-compile-rules.md`（前端代码） |
+
+## Components（组件文档）
+
+| 用户意图关键词 | 加载文档 |
+|---------------|---------|
+| Button、按钮 | `references/components/@weapp-Button.md` |
+| Table、表格 | `references/components/display-Table.md` |
+| List、列表 | `references/components/display-List.md` |
+| Pagination、分页 | `references/components/display-Pagination.md` |
+| Icon、图标 | `references/components/display-Icon.md` |
+| Avatar、头像 | `references/components/display-Avatar.md` |
+| EChart、图表、Echarts | `references/components/generic-Echarts.md` |
+| 文件预览、CorsComponent | `references/components/display-FilePreview.md` |
+| Input、输入框、文本框 | `references/components/form-Input.md` |
+| 人员选择、Browser Employee、resource | `references/components/form-EmployeeBrowser-api.md` |
+| 部门选择、Browser Department、department | `references/components/form-DepartmentBrowser-api.md` |
+| Upload、文件上传、附件、FileComponent | `references/components/form-Upload.md` |
+| Badge、徽标 | `references/components/base-Badge.md` |
+| Tag、标签 | `references/components/base-Tag.md` |
+
+## 组合场景
+
+| 场景 | 需加载的文档 |
+|------|-------------|
+| CRUD 列表页 | `references/coding/guide-form-crud.md`（前端代码） + `references/components/display-Table.md` + `references/components/display-Pagination.md` |
+| 表单新增/编辑弹窗 | `references/coding/guide-form-crud.md`（前端代码） + `references/coding/guide-edit-backfill.md` + 对应表单组件文档 |
+| 新建完整应用 | `references/common/ref-cli-commands.md` + `references/form/guide-create-form.md` + `references/coding/guide-page-export.md`（前端代码） |
+| 流程触发页面 | `references/workflow/guide-workflow.md` + `references/coding/guide-form-crud.md`（前端代码） |
+| 流程分支条件 | `references/workflow/guide-workflow.md` + `references/workflow/guide-workflow-condition.md` |
+| 跨表单动作流 | `references/workflow/guide-workflow.md` + `references/workflow/guide-workflow-action.md` |
+| 编译报错排查 | `references/coding/ref-compile-rules.md`（前端代码） |
+
+- 流程功能设置（batch-set/auto-approve/other-set/水印/导入/事项赋权/文档权限）：`references/workflow/guide-function-settings.md`

package/skill-docs/actionflows/references/components/document/GetDocumentInfo.md

@@ -1,17 +1,17 @@
-# 获取文档信息（`GetDocumentInfo`）
-
-## 何时使用
-
-读取文档详情供后续节点使用。
-
-## 先查询
-
-确认文档 ID 来源与操作人。
-
-## 不可猜测
-
-固定文档应使用真实 Browser 对象，上游值使用真实上下文。
-
-## 最小计划
-
-`docId`、`operatorId`。
+# 获取文档信息（`GetDocumentInfo`）
+
+## 何时使用
+
+读取文档详情供后续节点使用。
+
+## 先查询
+
+确认文档 ID 来源与操作人。固定文档名称会通过当前租户的 `doc/document` Browser 接口补全为真实文档对象；动态 `docId` FormulaBean 不走 Browser 查询。
+
+## 不可猜测
+
+固定文档应使用真实 Browser 对象，上游值使用真实上下文。
+
+## 最小计划
+
+`docId`、`operatorId`。

package/skill-docs/actionflows/references/components/logic/LogicFlowSet.md

@@ -1,17 +1,23 @@
-# 规则集（`LogicFlowSet`）
-
-## 何时使用
-
-引用当前租户已有规则集完成复杂规则判断或计算。
-
-## 先查询
-
-获得当前租户规则 Browser 原对象。
-
-## 不可猜测
-
-不在动作流中创建或编辑规则定义；没有真实规则对象即停止。
-
-## 最小计划
-
-`logicFlow`；可选 `inputParams` 必须为平台回读结构。
+# 规则集（`LogicFlowSet`）
+
+## 何时使用
+
+创建动作流中的规则集节点，引用当前租户已有规则集完成复杂规则判断或计算。
+
+## 先查询
+
+获得当前租户规则 Browser 原对象。
+
+## 不可猜测
+
+不在动作流中创建或编辑规则定义；没有真实规则对象即停止。
+
+## 最小计划
+
+`logicFlow`；可选 `inputParams` 必须为前端规则参数设计器回读的单表 `ParamMappingBean`。
+
+`logicFlow` 是固定 Browser 动态赋值对象，不支持上下文、变量、常量或公式。规则名称会通过当前租户的 `/api/logicflow/common/browser/complete/rule` 查询，并必须唯一匹配真实规则对象；计划中可使用 `{"kind":"fixed","value":["规则名称"]}`，生成后会回填为规则 Browser 对象数组。
+
+`logicFlow` 不是规则定义本身，而是当前租户规则 Browser 原对象数组，至少包含真实 `id` 和 `name`。`inputParams.tableData` 使用规则集外部设计器的 `ParamBean` 字段类型：`paramType` 表示字段类型，`dataType` 表示 `attribute/node`，结构化字段通过 `parentId` 关联，动态赋值放在行的 `formulaData` 中；参数设计器返回的展示字段也要原样保留，不能套用其他组件的参数归一化规则。
+
+规则 Browser 解析出真实规则 ID 后，CLI 会请求 `/api/component/logicflow/esb/info/{ruleId}`，使用响应 `data.input` 的 `tableData` 生成 `inputParams`。因此不需要手工猜测规则的输入参数结构；如果计划中已经为同一个 `paramKey` 提供 `formulaData`，CLI 会把该赋值合并回详情接口返回的对应参数行。