weaver-e10-builder 1.6.16 → 1.7.0

package/skill-docs/references/workflow/guide-base-auth-share-remind.md

@@ -1,126 +1,126 @@
-# 工作流基础设置：权限、共享、提醒
-
-命令名取自前端目录 `pathset-base-authset`、`pathset-base-shareset`、`pathset-base-remind`。配置的是工作流定义，参数使用 `workflowId`，不是流程实例 requestId。当前验证环境为 107，原生工作流；不据此宣称 EB、公文及个人工作流已验证。
-
-## 共同规则
-
-- `get --schema` 读取实时表单、枚举、浏览范围及默认值。所有命令输出 JSON，支持 `--out 文件`。
-- `create/update --data '{...}'` 或 `--data @文件.json`。单份配置的 create 是读取默认/现有配置后保存，不重复建第二份。
-- 修改先读后合并，只改明确的键；`false` 和 `[]` 是有效修改。拒绝未知字段、无效选项和跨流程节点，保存一次后回读；失败不自动重复写入。
-- ID 用字符串。节点浏览值用名称或 ID 数组，重名时改用 ID。组织对象用 `[{"_entityType":"user","id":"人员ID"}]`；支持 user/dept/subcompany/group/role/all，以该位置允许类型为准。错误提醒人只支持 user/role/employeeManager。非 all 对象会从服务端按 ID 核实。
-- 初始化可能创建配置记录；回读比较的是业务设置，记录 ID、创建/更新时间可变化。没有服务端并发版本控制，编辑期间应避免多人同时保存同一配置。
-
-## 权限设置
-
-```bash
-e10-cli workflow base auth-set get <workflowId> --schema
-e10-cli workflow base auth-set update <workflowId> --data '{"statistics":[{"_entityType":"user","id":"人员ID"}]}'
-```
-
-| 字段 | 设置 |
-|---|---|
-| maintenance | 维护权限；不包含删除工作流权限 |
-| statistics | 统计权限 |
-| statisticsExport | 统计数据导出权限，也影响统计导入 |
-| containSubDept | 包含下级部门，boolean |
-
-每组组织对象支持 `[]` 清空；没有指定的组保持原值。
-
-## 共享设置
-
-```bash
-e10-cli workflow base share-set get <workflowId> --schema
-e10-cli workflow base share-set update <workflowId> --data '{"defSharerCanViewComment":false}'
-e10-cli workflow base share-set default get <workflowId> --schema
-e10-cli workflow base share-set default update <workflowId> --data '{"commonTiming":"1","commonMultiNode":["审批节点ID"]}'
-```
-
-基础字段：`defSharerCanViewComment`（默认共享人查看意见/评论）、`allowAddNoDefShare`（允许添加非默认共享）、`sendRemindTiming`（数组，1 添加默认共享时、2 添加非默认共享时）。
-
-默认共享字段：`defaultShareType` 为 0 通用 / 1 按条件共享；`commonTiming` 为 0 创建 / 1 到达节点 / 2 离开节点；`commonMultiNode` 为节点；`shareUsers` 为组织对象。到达/离开模式必须指定节点。切换共享模式是显式操作，不随规则新增隐式切换。不会执行“更新/删除历史流程默认共享”。
-
-### 按条件共享
-
-```bash
-e10-cli workflow base share-set default update <workflowId> --data '{"defaultShareType":"1"}'
-e10-cli workflow base share-set rule create <workflowId> --data '{"isEnable":false,"shareMultiNode":["节点ID"],"shareConditionUsers":[{"_entityType":"user","id":"人员ID"}],"condition":{"rules":["system:流程标题:包含:申请"],"relation":"AND"}}'
-e10-cli workflow base share-set rule get <workflowId> --schema
-e10-cli workflow base share-set rule update <workflowId> --rule-id <规则行ID> --data '{"shareTiming":"2"}'
-e10-cli workflow base share-set condition get <workflowId> --rule-id <规则行ID>
-```
-
-字段：`shareConditionUsers`、`shareMultiNode`、`shareTiming`（1 到达 / 2 离开）、`isEnable`、`condition` 或 `shareCondition`。
-
-新增时 `shareTiming` 取实时列默认值，`isEnable` 优先取列默认值，服务端未声明时继承前端程序 `newAddTableList` 的 true。示例特意设 false，便于先核对规则再启用。
-
-`condition.rules` 使用已有条件编译器的 `system:字段:关系:值` / `form:字段名或ID:关系:值` 语法；`relation` 为 AND/OR，默认采用条件编辑器服务端 relation。表单字段、数字范围、明细量词等语法见[条件指南](guide-workflow-condition.md)。本命令始终使用共享条件 source=24，不能拿出口 source=2 替代。输入新 condition 时生成新条件引用，只替换该行；不会原地修改可能被其他行引用的条件。规则保存失败可能留下尚未绑定的条件，勿盲目重试。
-
-`shareCondition:{}` 表示无条件；非空 `shareCondition` 只允许复用此流程已有共享行的 conditionKey。公共规则引用向导、任意嵌套表达式和条件多语言编辑未在此命令实现。
-
-### 共享字段权限
-
-```bash
-e10-cli workflow base share-set field-permission get <workflowId>
-e10-cli workflow base share-set field-permission update <workflowId> --data '{"fields":[{"name":"单行文本","display":false}]}'
-e10-cli workflow base share-set system-field-permission get <workflowId>
-e10-cli workflow base share-set system-field-permission update <workflowId> --data '{"fields":[{"fieldType":"REQUEST_NAMEL","isview":false}]}'
-```
-
-普通字段支持 id 或唯一 name，只改 display。系统字段使用 get 返回的 fieldType，只改 isview；编辑/必填等属性及其他字段保持原值，不同步到节点。
-
-共享字段权限固定使用 legacy，不提供 `--renderer` 参数，也不保留新版权限写入分支。工作流程和 EB 均先读取 `frame/getPathFrameInfo`，根据 `relateType=wea_form/wea_ebuilder` 判断类型；缺失、未知类型、业务失败或 formId 不一致时停止，禁止通过接口成功/失败推断类型。旧版接口读取完整明细，只修改明确指定字段的显示权限并回读，保留其他属性。
-
-共享字段权限 legacy 接口契约：
-
-| 类型 | 读取 | 保存 |
-|---|---|---|
-| `wea_form` | `/api/workflow/core/bridgeform/getFieldPermissionViewDataById` | `/api/workflow/core/form/formFieldPermission/saveNodeExtSet` |
-| `wea_ebuilder` | `/api/ebuilder/flow/core/bridgeform/getFieldPermissionViewDataById` | `/api/workflow/core/form/formFieldPermission/saveNodeExtSet` |
-
-读取参数为 `workflowId/formId/permissionId/nodeFormRelateId=-1`；保存携带 `share:true`、`nodeFormRelate.workflowId`、完整 `fieldPermission.permissionDetails`。EB 的旧接口可能没有 `initPermissionDetails`，按旧前端组件从 `fieldList/readFieldIds/writeFieldIds` 还原明细：复合控件 ComboSelect、DateInterval、MatrixComponent 的子字段继承父字段权限，Paragraph/SubTableControl 不可写；缺少必要列表则停止。已有明细保留原属性，不自行补默认权限。保存由 workflow/core 后端根据关联类型分发，不能将它替换为节点新版 `saveFieldPermission`。
-
-## 提醒设置
-
-```bash
-e10-cli workflow base remind-set get <workflowId> --schema
-e10-cli workflow base remind-set update <workflowId> --data '{"forceEndReceiver":[]}'
-e10-cli workflow base remind-set detail get <workflowId> --src emailAndSmsRemind --schema
-e10-cli workflow base remind-set detail update <workflowId> --src sysRemind --data '{"sysCcNoRemind":true}'
-```
-
-主设置：`remindType` 为数组（0 短信、1 邮件、2 系统）；`isCustomContent` 自定义内容；`forceEndReceiver` 为数组（0 结束节点操作者、1 未操作已查看、2 未操作未查看、3 发起人）；`errRemindCustom`、`errReminder` 为错误提醒自定义开关及组织对象。省略字段不清空。
-
-详情渠道必须显式指定 `--src`：
-
-| 渠道 | 字段 |
-|---|---|
-| sysRemind | sysRemindScope（0 全部 / 1 指定）、sysArchiveNoRemind、sysCcNoRemind、messageSenderCustom、messageSenderType（0 发起人 / 1 当前操作者） |
-| emailAndSmsRemind | remindScope（0 全部 / 1 指定）、defaultRemindType（0/1 数组）、archiveNoRemind、ccNoRemind、chooseReminder、alterNodesType（0 全部 / 1 选择）、alterNodesBrowser |
-
-默认渠道不能超出主设置已启用的渠道。指定节点模式需要先新增节点规则，不会隐式添加节点。详情两组完整读取并保留另一组。
-
-### 指定节点提醒
-
-```bash
-e10-cli workflow base remind-set nodes get <workflowId> --src emailAndSmsRemind --schema
-e10-cli workflow base remind-set nodes create <workflowId> --src emailAndSmsRemind --data '{"alterNodesBrowser":["节点ID"],"remindType":["0","1"]}'
-e10-cli workflow base remind-set nodes update <workflowId> --src emailAndSmsRemind --rule-id <规则ID> --data '{"ccNoRemind":true}'
-e10-cli workflow base remind-set detail update <workflowId> --src emailAndSmsRemind --data '{"remindScope":"1"}'
-```
-
-新增字段为 alterNodesBrowser/remindType/ccNoRemind，未指定项从服务端新增表单继承。修改字段为 reminders（渠道数组）、ccNoRemind、remindContentType（0 默认 / 1 自定义）。规则ID与节点ID不同；CLI 核实流程与渠道归属。
-
-### 邮件、短信、系统消息模板
-
-```bash
-e10-cli workflow base remind-set templates get <workflowId> --content-type 1
-# 流程级保存会被后端联动开启自定义；必须先明确设置该开关
-e10-cli workflow base remind-set update <workflowId> --data '{"isCustomContent":true}'
-e10-cli workflow base remind-set templates update <workflowId> --content-type 1 --event 10 --data '{"title":"待审批：[-313]"}'
-# 节点模板需要先有该渠道节点提醒规则；省略 --node-id 是流程级
-e10-cli workflow base remind-set templates get <workflowId> --content-type 0 --node-id <节点ID>
-```
-
-content-type：0 短信 / 1 邮件 / 2 系统。`--event` 取 get 返回的 remindType，不猜事件编号。模板字段为 content，邮件另有 title/isFormData/isSignData/isAttachmentData，后面三项以环境能力为准。字段占位符用 `[code]`，从 fields 获取，校验事件 hideSysFields。修改会保留其他事件、未指定属性及现有多语言元数据；本命令不提供多语言翻译编辑。
-
-107 租户启用需审核的短信服务，产品本身不支持工作流或节点自定义短信内容，仅支持应用全局默认设置（前端 smsTemplateCheckFlag 对 WORKFLOW/NODE 返回 2）。CLI 查询返回 editable:false 和入口说明，写入明确拒绝；不会显示未生效的普通短信正文冒充有效模板。未开启审核的环境支持普通短信正文，但该分支尚无远端写入验证。邮件、系统消息已在关闭渠道且未启用的临时节点上原值保存并回读；流程级开关未改变，临时节点规则已移除。全局模板修改测试曾被自动审批拒绝，已改用这一安全验证；没有执行被拒绝脚本。
+# 工作流基础设置：权限、共享、提醒
+
+命令名取自前端目录 `pathset-base-authset`、`pathset-base-shareset`、`pathset-base-remind`。配置的是工作流定义，参数使用 `workflowId`，不是流程实例 requestId。当前验证环境为 107，原生工作流；不据此宣称 EB、公文及个人工作流已验证。
+
+## 共同规则
+
+- `get --schema` 读取实时表单、枚举、浏览范围及默认值。所有命令输出 JSON，支持 `--out 文件`。
+- `create/update --data '{...}'` 或 `--data @文件.json`。单份配置的 create 是读取默认/现有配置后保存，不重复建第二份。
+- 修改先读后合并，只改明确的键；`false` 和 `[]` 是有效修改。拒绝未知字段、无效选项和跨流程节点，保存一次后回读；失败不自动重复写入。
+- ID 用字符串。节点浏览值用名称或 ID 数组，重名时改用 ID。组织对象用 `[{"_entityType":"user","id":"人员ID"}]`；支持 user/dept/subcompany/group/role/all，以该位置允许类型为准。错误提醒人只支持 user/role/employeeManager。非 all 对象会从服务端按 ID 核实。
+- 初始化可能创建配置记录；回读比较的是业务设置，记录 ID、创建/更新时间可变化。没有服务端并发版本控制，编辑期间应避免多人同时保存同一配置。
+
+## 权限设置
+
+```bash
+e10-cli workflow base auth-set get <workflowId> --schema
+e10-cli workflow base auth-set update <workflowId> --data '{"statistics":[{"_entityType":"user","id":"人员ID"}]}'
+```
+
+| 字段 | 设置 |
+|---|---|
+| maintenance | 维护权限；不包含删除工作流权限 |
+| statistics | 统计权限 |
+| statisticsExport | 统计数据导出权限，也影响统计导入 |
+| containSubDept | 包含下级部门，boolean |
+
+每组组织对象支持 `[]` 清空；没有指定的组保持原值。
+
+## 共享设置
+
+```bash
+e10-cli workflow base share-set get <workflowId> --schema
+e10-cli workflow base share-set update <workflowId> --data '{"defSharerCanViewComment":false}'
+e10-cli workflow base share-set default get <workflowId> --schema
+e10-cli workflow base share-set default update <workflowId> --data '{"commonTiming":"1","commonMultiNode":["审批节点ID"]}'
+```
+
+基础字段：`defSharerCanViewComment`（默认共享人查看意见/评论）、`allowAddNoDefShare`（允许添加非默认共享）、`sendRemindTiming`（数组，1 添加默认共享时、2 添加非默认共享时）。
+
+默认共享字段：`defaultShareType` 为 0 通用 / 1 按条件共享；`commonTiming` 为 0 创建 / 1 到达节点 / 2 离开节点；`commonMultiNode` 为节点；`shareUsers` 为组织对象。到达/离开模式必须指定节点。切换共享模式是显式操作，不随规则新增隐式切换。不会执行“更新/删除历史流程默认共享”。
+
+### 按条件共享
+
+```bash
+e10-cli workflow base share-set default update <workflowId> --data '{"defaultShareType":"1"}'
+e10-cli workflow base share-set rule create <workflowId> --data '{"isEnable":false,"shareMultiNode":["节点ID"],"shareConditionUsers":[{"_entityType":"user","id":"人员ID"}],"condition":{"rules":["system:流程标题:包含:申请"],"relation":"AND"}}'
+e10-cli workflow base share-set rule get <workflowId> --schema
+e10-cli workflow base share-set rule update <workflowId> --rule-id <规则行ID> --data '{"shareTiming":"2"}'
+e10-cli workflow base share-set condition get <workflowId> --rule-id <规则行ID>
+```
+
+字段：`shareConditionUsers`、`shareMultiNode`、`shareTiming`（1 到达 / 2 离开）、`isEnable`、`condition` 或 `shareCondition`。
+
+新增时 `shareTiming` 取实时列默认值，`isEnable` 优先取列默认值，服务端未声明时继承前端程序 `newAddTableList` 的 true。示例特意设 false，便于先核对规则再启用。
+
+`condition.rules` 使用已有条件编译器的 `system:字段:关系:值` / `form:字段名或ID:关系:值` 语法；`relation` 为 AND/OR，默认采用条件编辑器服务端 relation。表单字段、数字范围、明细量词等语法见[条件指南](guide-workflow-condition.md)。本命令始终使用共享条件 source=24，不能拿出口 source=2 替代。输入新 condition 时生成新条件引用，只替换该行；不会原地修改可能被其他行引用的条件。规则保存失败可能留下尚未绑定的条件，勿盲目重试。
+
+`shareCondition:{}` 表示无条件；非空 `shareCondition` 只允许复用此流程已有共享行的 conditionKey。公共规则引用向导、任意嵌套表达式和条件多语言编辑未在此命令实现。
+
+### 共享字段权限
+
+```bash
+e10-cli workflow base share-set field-permission get <workflowId>
+e10-cli workflow base share-set field-permission update <workflowId> --data '{"fields":[{"name":"单行文本","display":false}]}'
+e10-cli workflow base share-set system-field-permission get <workflowId>
+e10-cli workflow base share-set system-field-permission update <workflowId> --data '{"fields":[{"fieldType":"REQUEST_NAMEL","isview":false}]}'
+```
+
+普通字段支持 id 或唯一 name，只改 display。系统字段使用 get 返回的 fieldType，只改 isview；编辑/必填等属性及其他字段保持原值，不同步到节点。
+
+共享字段权限固定使用 legacy，不提供 `--renderer` 参数，也不保留新版权限写入分支。工作流程和 EB 均先读取 `frame/getPathFrameInfo`，根据 `relateType=wea_form/wea_ebuilder` 判断类型；缺失、未知类型、业务失败或 formId 不一致时停止，禁止通过接口成功/失败推断类型。旧版接口读取完整明细，只修改明确指定字段的显示权限并回读，保留其他属性。
+
+共享字段权限 legacy 接口契约：
+
+| 类型 | 读取 | 保存 |
+|---|---|---|
+| `wea_form` | `/api/workflow/core/bridgeform/getFieldPermissionViewDataById` | `/api/workflow/core/form/formFieldPermission/saveNodeExtSet` |
+| `wea_ebuilder` | `/api/ebuilder/flow/core/bridgeform/getFieldPermissionViewDataById` | `/api/workflow/core/form/formFieldPermission/saveNodeExtSet` |
+
+读取参数为 `workflowId/formId/permissionId/nodeFormRelateId=-1`；保存携带 `share:true`、`nodeFormRelate.workflowId`、完整 `fieldPermission.permissionDetails`。EB 的旧接口可能没有 `initPermissionDetails`，按旧前端组件从 `fieldList/readFieldIds/writeFieldIds` 还原明细：复合控件 ComboSelect、DateInterval、MatrixComponent 的子字段继承父字段权限，Paragraph/SubTableControl 不可写；缺少必要列表则停止。已有明细保留原属性，不自行补默认权限。保存由 workflow/core 后端根据关联类型分发，不能将它替换为节点新版 `saveFieldPermission`。
+
+## 提醒设置
+
+```bash
+e10-cli workflow base remind-set get <workflowId> --schema
+e10-cli workflow base remind-set update <workflowId> --data '{"forceEndReceiver":[]}'
+e10-cli workflow base remind-set detail get <workflowId> --src emailAndSmsRemind --schema
+e10-cli workflow base remind-set detail update <workflowId> --src sysRemind --data '{"sysCcNoRemind":true}'
+```
+
+主设置：`remindType` 为数组（0 短信、1 邮件、2 系统）；`isCustomContent` 自定义内容；`forceEndReceiver` 为数组（0 结束节点操作者、1 未操作已查看、2 未操作未查看、3 发起人）；`errRemindCustom`、`errReminder` 为错误提醒自定义开关及组织对象。省略字段不清空。
+
+详情渠道必须显式指定 `--src`：
+
+| 渠道 | 字段 |
+|---|---|
+| sysRemind | sysRemindScope（0 全部 / 1 指定）、sysArchiveNoRemind、sysCcNoRemind、messageSenderCustom、messageSenderType（0 发起人 / 1 当前操作者） |
+| emailAndSmsRemind | remindScope（0 全部 / 1 指定）、defaultRemindType（0/1 数组）、archiveNoRemind、ccNoRemind、chooseReminder、alterNodesType（0 全部 / 1 选择）、alterNodesBrowser |
+
+默认渠道不能超出主设置已启用的渠道。指定节点模式需要先新增节点规则，不会隐式添加节点。详情两组完整读取并保留另一组。
+
+### 指定节点提醒
+
+```bash
+e10-cli workflow base remind-set nodes get <workflowId> --src emailAndSmsRemind --schema
+e10-cli workflow base remind-set nodes create <workflowId> --src emailAndSmsRemind --data '{"alterNodesBrowser":["节点ID"],"remindType":["0","1"]}'
+e10-cli workflow base remind-set nodes update <workflowId> --src emailAndSmsRemind --rule-id <规则ID> --data '{"ccNoRemind":true}'
+e10-cli workflow base remind-set detail update <workflowId> --src emailAndSmsRemind --data '{"remindScope":"1"}'
+```
+
+新增字段为 alterNodesBrowser/remindType/ccNoRemind，未指定项从服务端新增表单继承。修改字段为 reminders（渠道数组）、ccNoRemind、remindContentType（0 默认 / 1 自定义）。规则ID与节点ID不同；CLI 核实流程与渠道归属。
+
+### 邮件、短信、系统消息模板
+
+```bash
+e10-cli workflow base remind-set templates get <workflowId> --content-type 1
+# 流程级保存会被后端联动开启自定义；必须先明确设置该开关
+e10-cli workflow base remind-set update <workflowId> --data '{"isCustomContent":true}'
+e10-cli workflow base remind-set templates update <workflowId> --content-type 1 --event 10 --data '{"title":"待审批：[-313]"}'
+# 节点模板需要先有该渠道节点提醒规则；省略 --node-id 是流程级
+e10-cli workflow base remind-set templates get <workflowId> --content-type 0 --node-id <节点ID>
+```
+
+content-type：0 短信 / 1 邮件 / 2 系统。`--event` 取 get 返回的 remindType，不猜事件编号。模板字段为 content，邮件另有 title/isFormData/isSignData/isAttachmentData，后面三项以环境能力为准。字段占位符用 `[code]`，从 fields 获取，校验事件 hideSysFields。修改会保留其他事件、未指定属性及现有多语言元数据；本命令不提供多语言翻译编辑。
+
+107 租户启用需审核的短信服务，产品本身不支持工作流或节点自定义短信内容，仅支持应用全局默认设置（前端 smsTemplateCheckFlag 对 WORKFLOW/NODE 返回 2）。CLI 查询返回 editable:false 和入口说明，写入明确拒绝；不会显示未生效的普通短信正文冒充有效模板。未开启审核的环境支持普通短信正文，但该分支尚无远端写入验证。邮件、系统消息已在关闭渠道且未启用的临时节点上原值保存并回读；流程级开关未改变，临时节点规则已移除。全局模板修改测试曾被自动审批拒绝，已改用这一安全验证；没有执行被拒绝脚本。

package/skill-docs/references/workflow/guide-layout-components.md

@@ -1,26 +1,26 @@
-# 流程布局系统字段、签字意见、拟签控件
-
-在从图片/文字形成布局和建字段计划之前，对每个控件调用 `workflow layout-component classify --data '{"title":"...","description":"该控件自身的描述"}'`。
-必须先分流，再创建普通字段；`createPhysicalField:false` 的结果禁止送入 form/wf-form 物理字段新增命令。不能把相邻“拟签意见”标题或整页描述复制为每个控件的描述。
-
-- 提交人、提交人分部、提交人部门、提交时间、结束时间（需求图中蓝色区域所指类别）仅描述明确带“流程系统字段”才识别为系统字段，不依赖截图像素颜色。
-- 工作流名称、工作流类型、工作流描述、流程标题、流程编号、紧急程度、密级、流程状态、签字意见：描述与标题对应时默认系统控件。
-- “不使用”“不作为流程系统字段”等否定说明优先，返回 custom-field（这不是隐藏布局的 display=false）。
-- 意见输入框识别为 FlowPageSignInput，不是拟签，也不是 NodeRequestLog。
-- 拟签意见/拟签控件仅按自身描述识别 FlowPageDraftOpinion；1级审批、领导审批等标题本身不能推断为拟签。
-
-已有布局的真实类型按 comp.type 判定，不因标题相同就把已有自定义字段转为系统字段。
-`form layout describe` 的 workflowComponents 会独立输出系统/签字/拟签组件，普通字段列表不再混入这些组件。
-
-```bash
-e10-cli workflow layout-component classify --data '{"title":"提交人","description":"提交人（流程系统字段）"}'
-e10-cli workflow layout-component get <workflowId> --layout-id <layoutMultiId>
-e10-cli workflow layout-component ensure-draft <workflowId> --layout-id <layoutMultiId> --title '拟签意见' --description '拟签控件' --row 16 --col 3
-# 新建返回 widgetId 后按现有能力修改业务配置
-e10-cli workflow draft-opinion update <workflowId> --widget-id <widgetId> --data '{"opinionType":"1"}'
-```
-
-ensure-draft：仅原生流程独立EXCEL布局，位置为0起始；先查当前终端页面，已有同标题拟签则复用并校验业务记录，不修改位置/配置；重名阻断。缺失才读取程序默认配置、分配业务ID、插入组件并保存，不创建物理字段。不要通过clone复制他人的widgetId或直接复制拟签config。
-现有范围：系统字段本次补识别与查询；不提供系统字段自动插入。拟签新增支持PC/MOBILE中存在的EXCEL页；FLOW及EB桥接新增尚未接入，明确报错。创建后高级配置复用draft-opinion，人员范围子弹窗限制仍适用。
-
-节点意见控件现已接入：描述包含节点意见/流转意见/意见放表单且指定节点范围，识别为NodeRequestLog；缺范围返回requiresConfirmation，不建字段。使用独立 workflow node-opinion 命令，详见[guide-node-opinion.md](guide-node-opinion.md)。
+# 流程布局系统字段、签字意见、拟签控件
+
+在从图片/文字形成布局和建字段计划之前，对每个控件调用 `workflow layout-component classify --data '{"title":"...","description":"该控件自身的描述"}'`。
+必须先分流，再创建普通字段；`createPhysicalField:false` 的结果禁止送入 form/wf-form 物理字段新增命令。不能把相邻“拟签意见”标题或整页描述复制为每个控件的描述。
+
+- 提交人、提交人分部、提交人部门、提交时间、结束时间（需求图中蓝色区域所指类别）仅描述明确带“流程系统字段”才识别为系统字段，不依赖截图像素颜色。
+- 工作流名称、工作流类型、工作流描述、流程标题、流程编号、紧急程度、密级、流程状态、签字意见：描述与标题对应时默认系统控件。
+- “不使用”“不作为流程系统字段”等否定说明优先，返回 custom-field（这不是隐藏布局的 display=false）。
+- 意见输入框识别为 FlowPageSignInput，不是拟签，也不是 NodeRequestLog。
+- 拟签意见/拟签控件仅按自身描述识别 FlowPageDraftOpinion；1级审批、领导审批等标题本身不能推断为拟签。
+
+已有布局的真实类型按 comp.type 判定，不因标题相同就把已有自定义字段转为系统字段。
+`form layout describe` 的 workflowComponents 会独立输出系统/签字/拟签组件，普通字段列表不再混入这些组件。
+
+```bash
+e10-cli workflow layout-component classify --data '{"title":"提交人","description":"提交人（流程系统字段）"}'
+e10-cli workflow layout-component get <workflowId> --layout-id <layoutMultiId>
+e10-cli workflow layout-component ensure-draft <workflowId> --layout-id <layoutMultiId> --title '拟签意见' --description '拟签控件' --row 16 --col 3
+# 新建返回 widgetId 后按现有能力修改业务配置
+e10-cli workflow draft-opinion update <workflowId> --widget-id <widgetId> --data '{"opinionType":"1"}'
+```
+
+ensure-draft：仅原生流程独立EXCEL布局，位置为0起始；先查当前终端页面，已有同标题拟签则复用并校验业务记录，不修改位置/配置；重名阻断。缺失才读取程序默认配置、分配业务ID、插入组件并保存，不创建物理字段。不要通过clone复制他人的widgetId或直接复制拟签config。
+现有范围：系统字段本次补识别与查询；不提供系统字段自动插入。拟签新增支持PC/MOBILE中存在的EXCEL页；FLOW及EB桥接新增尚未接入，明确报错。创建后高级配置复用draft-opinion，人员范围子弹窗限制仍适用。
+
+节点意见控件现已接入：描述包含节点意见/流转意见/意见放表单且指定节点范围，识别为NodeRequestLog；缺范围返回requiresConfirmation，不建字段。使用独立 workflow node-opinion 命令，详见[guide-node-opinion.md](guide-node-opinion.md)。

package/skill-docs/references/workflow/guide-node-opinion.md

@@ -1,58 +1,58 @@
-# 节点意见 / 流转意见 / 意见放表单
-
-命令组：`e10-cli workflow node-opinion`。与拟签 draft-opinion、签字意见输入框不同：这是展示已有流转意见的 NodeRequestLog 控件，不创建物理表字段。
-
-## 布局识别与创建
-
-截图/模板先逐单元格调用 `workflow layout-component classify --data '{"title":"审批意见","description":"节点意见：1级审批，2级审批"}'`。
-结果 `createPhysicalField:false` 不允许送入普通建字段命令。只有描述明确包含节点意见/流转意见/意见放表单/意见展示控件时才分流；没有节点范围返回 requiresConfirmation=true，必须询问用户，禁止猜测全部节点。节点完整名称或字符串ID唯一匹配，缺失/重名停止，由用户确认。
-
-```bash
-e10-cli workflow node-opinion nodes <workflowId>
-e10-cli workflow node-opinion get <workflowId> --layout-id <layoutMultiId>
-e10-cli workflow node-opinion ensure <workflowId> --layout-id <layoutMultiId> --title '审批意见' --description '节点意见：1级审批，2级审批' --row 17 --col 0
-```
-
-row/col从0开始。已有同名控件唯一时复用并合并描述/显式参数，位置不移动；不存在才创建。仅支持原生工作流独立EXCEL布局，PC/MOBILE须实际有对应页面；不会隐式复制默认布局。不覆盖已有单元格。单个当前流程节点自动使用单节点身份nodeId_<ID>，页面显示节点实际名称；多个节点、主子流程或全部节点使用通用控件。已有单节点控件不能改成其他节点/主子流程；应创建通用控件。
-
-描述可用分号附加：`自定义设置；最后一次意见；2栏；不显示空意见；意见按批次分组；操作时间正序；显示内容：处理意见，操作人；意见显示范围：本部门`。
-显示范围描述支持本部门/本分部/本人，保存后独立添加该过滤行，已有同类型行不重复添加；复杂组织范围用range命令。未识别的附加描述停止，要求明确为参数。图外说明同样按这些参数转换，不能遗漏后直接宣称全部识别。
-
-## 配置修改
-
-```bash
-e10-cli workflow node-opinion schema <workflowId>
-e10-cli workflow node-opinion update <workflowId> --layout-id <layoutMultiId> --component-id <布局组件UUID> --data @patch.json
-```
-
-允许字段：
-- title、isHideTitle：布局标题/隐藏标题。
-- workflowOption：0当前、1主流程、2子流程，可使用中文选项；selectedWfid：真实关联流程ID（get返回mainWorfklowIds/subWorfklowIds）。切换主子流程须显式指定节点范围；关联不存在则停止。
-- nodescopeType：0全部、1选择、2排除、3自由节点；nodeScopeBrowser：完整节点名或ID数组。指定数组自动使用选择模式，排除需显式nodescopeType=2。
-- patternOption：0指定节点、1分组左右结构、2分组上下结构；selectedPattern：-1节点、-2部门、-3分部。意见模板分组(-4)暂不支持切换，已有配置仍保留。
-- isDefaultConfig：1读取当前参与身份节点的默认格式，0自定义；修改格式字段必须明确选择0。
-- viewTypeSelect：0全部操作类型、1选择、2排除；viewTypeDto：操作类型名称或ID数组，以schema/实际返回为准。
-- selectFormat：0默认格式、1自定义格式；viewContents：显示内容中文名或ID数组；showDesc/signShowDesc：设计器富文本JSON对象或JSON字符串，保留value/json结构。
-- showType：0每人每节点最后一次意见、1全部；showColumn：1—4；notShowEmpty、isGroup：布尔值。
-- showorder：按顺序排列的`[{"id":"4","order":"desc"}]`；1人员显示顺序、2安全级别、3操作类型、4操作时间、5节点。单节点不能按节点排序。groupOrderType：分组排序0正序、1倒序、2时间正序、3时间倒序。
-
-创建未指定项读程序默认值。修改先读取业务配置及布局，只合并指定部分。componentId、componentKey、业务表id不能互换。重复保存仍核对原控件和业务配置，不只验证HTTP成功。
-
-## 意见显示范围
-
-```bash
-e10-cli workflow node-opinion range-schema <workflowId>
-e10-cli workflow node-opinion range-get <workflowId> --layout-id <layoutId> --component-id <uuid>
-e10-cli workflow node-opinion range-add <workflowId> --layout-id <layoutId> --component-id <uuid> --data '{"objtype":"本部门"}'
-e10-cli workflow node-opinion range-update <workflowId> --layout-id <layoutId> --component-id <uuid> --rule-id <范围行ID> --data '{"objtype":"本分部"}'
-e10-cli workflow node-opinion range-delete <workflowId> --layout-id <layoutId> --component-id <uuid> --rule-id <范围行ID>
-```
-
-类型按range-schema真实选项，支持本部门/本分部等相对类型，指定人员person、部门dept、分部subDept、角色role、岗位job使用真实ID数组；rolelevel、joblevel、joblevelBrowser、seclevel按当前类型和服务端schema适用性校验。此场景不提供relationship。新增读默认值，修改保留未指定项，验证新行后才删除被替换旧行；其他行必须保留。range-get不初始化空范围，首次range-add会初始化scene=11并核对receiverRangeKey回写。
-
-## 节点默认显示格式
-
-- `node-default-get/update <workflowId> --node-id <id> [--data JSON]`：viewTypeSelect、viewType（类型名/ID数组）、showType、showColumn、notShowEmpty、isGroup。
-- `node-content-get/update <workflowId> --node-id <id> [--data JSON]`：selectFormat、viewContents（内容名/ID数组）、showDesc、signShowDesc。
-
-默认格式影响读取该节点默认设置的控件；不自动同步其他节点。当前参与身份节点的默认值，不等于意见范围第一节点的默认值。
+# 节点意见 / 流转意见 / 意见放表单
+
+命令组：`e10-cli workflow node-opinion`。与拟签 draft-opinion、签字意见输入框不同：这是展示已有流转意见的 NodeRequestLog 控件，不创建物理表字段。
+
+## 布局识别与创建
+
+截图/模板先逐单元格调用 `workflow layout-component classify --data '{"title":"审批意见","description":"节点意见：1级审批，2级审批"}'`。
+结果 `createPhysicalField:false` 不允许送入普通建字段命令。只有描述明确包含节点意见/流转意见/意见放表单/意见展示控件时才分流；没有节点范围返回 requiresConfirmation=true，必须询问用户，禁止猜测全部节点。节点完整名称或字符串ID唯一匹配，缺失/重名停止，由用户确认。
+
+```bash
+e10-cli workflow node-opinion nodes <workflowId>
+e10-cli workflow node-opinion get <workflowId> --layout-id <layoutMultiId>
+e10-cli workflow node-opinion ensure <workflowId> --layout-id <layoutMultiId> --title '审批意见' --description '节点意见：1级审批，2级审批' --row 17 --col 0
+```
+
+row/col从0开始。已有同名控件唯一时复用并合并描述/显式参数，位置不移动；不存在才创建。仅支持原生工作流独立EXCEL布局，PC/MOBILE须实际有对应页面；不会隐式复制默认布局。不覆盖已有单元格。单个当前流程节点自动使用单节点身份nodeId_<ID>，页面显示节点实际名称；多个节点、主子流程或全部节点使用通用控件。已有单节点控件不能改成其他节点/主子流程；应创建通用控件。
+
+描述可用分号附加：`自定义设置；最后一次意见；2栏；不显示空意见；意见按批次分组；操作时间正序；显示内容：处理意见，操作人；意见显示范围：本部门`。
+显示范围描述支持本部门/本分部/本人，保存后独立添加该过滤行，已有同类型行不重复添加；复杂组织范围用range命令。未识别的附加描述停止，要求明确为参数。图外说明同样按这些参数转换，不能遗漏后直接宣称全部识别。
+
+## 配置修改
+
+```bash
+e10-cli workflow node-opinion schema <workflowId>
+e10-cli workflow node-opinion update <workflowId> --layout-id <layoutMultiId> --component-id <布局组件UUID> --data @patch.json
+```
+
+允许字段：
+- title、isHideTitle：布局标题/隐藏标题。
+- workflowOption：0当前、1主流程、2子流程，可使用中文选项；selectedWfid：真实关联流程ID（get返回mainWorfklowIds/subWorfklowIds）。切换主子流程须显式指定节点范围；关联不存在则停止。
+- nodescopeType：0全部、1选择、2排除、3自由节点；nodeScopeBrowser：完整节点名或ID数组。指定数组自动使用选择模式，排除需显式nodescopeType=2。
+- patternOption：0指定节点、1分组左右结构、2分组上下结构；selectedPattern：-1节点、-2部门、-3分部。意见模板分组(-4)暂不支持切换，已有配置仍保留。
+- isDefaultConfig：1读取当前参与身份节点的默认格式，0自定义；修改格式字段必须明确选择0。
+- viewTypeSelect：0全部操作类型、1选择、2排除；viewTypeDto：操作类型名称或ID数组，以schema/实际返回为准。
+- selectFormat：0默认格式、1自定义格式；viewContents：显示内容中文名或ID数组；showDesc/signShowDesc：设计器富文本JSON对象或JSON字符串，保留value/json结构。
+- showType：0每人每节点最后一次意见、1全部；showColumn：1—4；notShowEmpty、isGroup：布尔值。
+- showorder：按顺序排列的`[{"id":"4","order":"desc"}]`；1人员显示顺序、2安全级别、3操作类型、4操作时间、5节点。单节点不能按节点排序。groupOrderType：分组排序0正序、1倒序、2时间正序、3时间倒序。
+
+创建未指定项读程序默认值。修改先读取业务配置及布局，只合并指定部分。componentId、componentKey、业务表id不能互换。重复保存仍核对原控件和业务配置，不只验证HTTP成功。
+
+## 意见显示范围
+
+```bash
+e10-cli workflow node-opinion range-schema <workflowId>
+e10-cli workflow node-opinion range-get <workflowId> --layout-id <layoutId> --component-id <uuid>
+e10-cli workflow node-opinion range-add <workflowId> --layout-id <layoutId> --component-id <uuid> --data '{"objtype":"本部门"}'
+e10-cli workflow node-opinion range-update <workflowId> --layout-id <layoutId> --component-id <uuid> --rule-id <范围行ID> --data '{"objtype":"本分部"}'
+e10-cli workflow node-opinion range-delete <workflowId> --layout-id <layoutId> --component-id <uuid> --rule-id <范围行ID>
+```
+
+类型按range-schema真实选项，支持本部门/本分部等相对类型，指定人员person、部门dept、分部subDept、角色role、岗位job使用真实ID数组；rolelevel、joblevel、joblevelBrowser、seclevel按当前类型和服务端schema适用性校验。此场景不提供relationship。新增读默认值，修改保留未指定项，验证新行后才删除被替换旧行；其他行必须保留。range-get不初始化空范围，首次range-add会初始化scene=11并核对receiverRangeKey回写。
+
+## 节点默认显示格式
+
+- `node-default-get/update <workflowId> --node-id <id> [--data JSON]`：viewTypeSelect、viewType（类型名/ID数组）、showType、showColumn、notShowEmpty、isGroup。
+- `node-content-get/update <workflowId> --node-id <id> [--data JSON]`：selectFormat、viewContents（内容名/ID数组）、showDesc、signShowDesc。
+
+默认格式影响读取该节点默认设置的控件；不自动同步其他节点。当前参与身份节点的默认值，不等于意见范围第一节点的默认值。