weaver-e10-builder 1.5.14 → 1.5.15

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

@@ -247,9 +247,9 @@
 
 | 命令 | 说明 |
 |------|------|
-| `e10-cli workflow authset <get\|create\|update> <workflowId>` | 工作流基础权限：维护、统计、统计导出；修改用 `--data`，先读后合并并回读 |
-| `e10-cli workflow shareset <get\|create\|update\|default\|rule\|condition\|field-permission\|system-field-permission>` | 共享开关、默认共享、条件规则及字段权限；详见 `references/workflow/guide-base-auth-share-remind.md` |
-| `e10-cli workflow remind <get\|create\|update\|detail\|nodes\|templates>` | 提醒方式、渠道详情、指定节点及邮件/短信/系统模板；按环境能力限制短信审核模板，详见同一指南 |
+| `e10-cli workflow base auth-set <get\|create\|update> <workflowId>` | 工作流基础权限：维护、统计、统计导出；修改用 `--data`，先读后合并并回读 |
+| `e10-cli workflow base share-set <get\|create\|update\|default\|rule\|condition\|field-permission\|system-field-permission>` | 共享开关、默认共享、条件规则及字段权限；详见 `references/workflow/guide-base-auth-share-remind.md` |
+| `e10-cli workflow base remind-set <get\|create\|update\|detail\|nodes\|templates>` | 提醒方式、渠道详情、指定节点及邮件/短信/系统模板；按环境能力限制短信审核模板，详见同一指南 |
 | `e10-cli workflow create <appId> <formObjId> <name> [desc]` | 创建 EB 流程，当前命令按固定模式创建并自动设置所有人可发起。**默认不加菜单**，要入口传 `--menu`（发起菜单 LAYOUT，指向表单新建页 `/sp/ebdfpage/card/1/<formObjId>/0`，点开即触发流程）；漏加 `e10-cli menu add-start <appId> <formObjId>` 补 |
 | `e10-cli workflow create-workflow <name>` | **非默认路径**。仅当用户明确强调「用流程表单 / 工作流程 / 流程中心建流程、不在应用下」时才用；默认走上一条 `workflow create`（eb 应用内）。关联流程表单：不传 `--form-id` 自建（`relateForm=0`，服务端建表回吐 `data.formId`）/ `--form-id <已有>` 绑定（`relateForm=1`）。`--odoc` 创建公文流程（两种表单方式均支持，增加 `bridgeService=odoc`）；`--workflow-type`（默认 -1=其它）、`--sub-company <机构>`、`--belong-type <0个人/1团队>`（默认 1）、`--table-name`、`--desc`、`--is-free`、`--layout <FLOW流式(默认)/EXCEL表格式>`（自建模式下 EXCEL 走 formmanage/saveForm 建表后绑定；建表后不可切换）。不带 source/messageParams |
 | `e10-cli workflow auth-resp <list\|create\|update\|read\|configure\|save-design>` | 独立权责表管理。`configure <id> --config @json` 从零创建变量、开始/结束节点、中间节点及操作者、分支条件和路径并保存回读；条件支持统一的 `system` / `form` 业务来源与原始 `childrens`；`save-design` 用于完整设计结构的保留式保存 |
@@ -316,7 +316,7 @@
 | `e10-cli workflow node layout unbind <wf> <nodeId>` | 摘下独立布局，回落表单默认布局；幂等 |
 | `e10-cli workflow node layout create <wf> --name [--layout-type FLOW\|EXCEL] [--nodes <id...>] [--from <布局ID>\|--empty]` | 新建布局。**默认复制表单默认布局**（`--from` 换来源）；`--empty` 才是空白布局。类型不写则跟随来源，**建后不可切换**。⚠ **复制会锁类型**：从流式来源复制却要求表格式，平台仍会建成流式，命令会**直接拒绝** —— 要建另一种类型请改用 `--empty`。要复制 PC 默认布局去建移动端布局是常见场景，来源按**两个终端的并集**找，不受目标终端限制。删布局用 `wf-form layout delete` |
 | `e10-cli workflow node layout init <wf> <布局ID> [--fields <名...>] [--list-fields] [--style-template] [--required\|--readonly\|--single-row]` | 重建某套布局的排版（**只动这一套**）。`--fields` = 只摆这些字段（不传=全摆，没摆的字段在表单上仍在）；`--list-fields` 看可摆清单。`create --init [--fields …]` 可建完直接排。**原生流程表单（不挂应用）与 eb 表关联流程的表单走两套不同路由，命令自动识别**，不需要额外参数 |
-| `e10-cli workflow setting tabs <wf> [选项]` | 查看/配置**流程详情页页签**（显示哪些页签、默认打开哪个、移动端）。`--only <页签名...>` **PC 端只显示这些、其余全部不显示**（需求里「显示页签：A/B/C，其余不显示」就用它）、`--show`/`--hide` 单独开关、`--mobile <页签名...>` 移动端只显示这些、`--mobile-menu <...>` 移动端菜单、`--default-open <页签名>`（单选）。页签名可用**名称或类型码**（1 流程表单 / 2 流程图 / 3 流程状态 / 4 共享 / 6 主流程 / 7 子流程 / 8 平行流程 / 12 外部流程）；同流程类型页签集合不同（「正文」只在公文流程上有）。保存后自动回读比对 |
+| `e10-cli workflow base tabs-set <wf> [选项]` | 查看/配置**流程详情页页签**（显示哪些页签、默认打开哪个、移动端）。`--only <页签名...>` **PC 端只显示这些、其余全部不显示**（需求里「显示页签：A/B/C，其余不显示」就用它）、`--show`/`--hide` 单独开关、`--mobile <页签名...>` 移动端只显示这些、`--mobile-menu <...>` 移动端菜单、`--default-open <页签名>`（单选）。页签名可用**名称或类型码**（1 流程表单 / 2 流程图 / 3 流程状态 / 4 共享 / 6 主流程 / 7 子流程 / 8 平行流程 / 12 外部流程）；同流程类型页签集合不同（「正文」只在公文流程上有）。保存后自动回读比对；另支持 `--tab --name --locales --get-locales --order --create --pc-url --mobile-url --delete`，用于名称、多语言、排序及自定义地址页签增删改 |
 | `e10-cli workflow node-reject get <wf> <nodeId>` | 查看节点退回设置（退回提醒 / 退回方式 / 默认选中 / 退回后提交） |
 | `e10-cli workflow node-reject set <wf> <nodeId> [选项]` | 设置节点退回规则。`--reject-type free\|step\|range\|byLink\|preApprover`（自由/逐级/指定范围/按出口/上一审批人）、`--submit-type step\|direct\|fork\|operator`、`--reject-remind none\|all\|nodes\|user`、`--default-node prev\|start\|custom`、`--remind-node-ids`（提醒节点）、`--range-node-ids`（退回范围节点）、`--default-node-id`、`--to-create-node`（出口未配时退发起节点）；`--custom` / `--no-custom` 显式指定是否启用自定义退回设置，**缺省保留节点当前值**。⚠ `--no-custom` 时平台会忽略全部节点级退回值，读回看到的是全局默认回显——不是没保存 |
 | `e10-cli workflow node-overtime list <wf> <nodeId>` | 查看节点超时规则（含启用状态与规则描述）。新规则平台默认「未启用」，需跑一遍 `set` 才会启用 |
@@ -343,12 +343,16 @@
 | `e10-cli workflow node empty-handle get <wf> <nodeId>` | 查看节点**流程异常处理**（无可处理人时怎么办） |
 | `e10-cli workflow node empty-handle set <wf> <nodeId> --handle-way <1-5>` | 设置节点流程异常处理：1=指定人员(`--person 名称/ID`) / 2=用户指定 / 3=发起人 / 4=自动流转下一节点 / 5=提交指定节点(`--assign-node <节点ID>`)；`--off` 关闭；`--sync` 同步所有节点 |
 | `e10-cli workflow setting title <wf>` | 流程标题规则（发起后标题按规则生成，如"发起人-提交日期-客户名称"→真实数据）。缺省列出可用变量（发起人/部门/日期/表单字段）；`--rule "发起人\|提交日期\|客户名称"` 竖线分隔字段名设置；`--sep <分隔符>` 默认 `-`；`--disable` 关闭自动生成（标题回退流程名+系统默认）。占位符 `$code$`，平台发起时替换为真实值 |
-| `e10-cli workflow setting submit <wf>` | 提交确认设置。`--confirm`/`--node-range`/`--show-way` |
-| `e10-cli workflow setting sign <wf>` | 签字意见设置。`--show-order`/`--inform-range` |
-| `e10-cli workflow setting comment <wf>` | 评论功能开关。`--enable` |
-| `e10-cli workflow setting batch <wf>` | 批量操作设置。`--enable-batch`/`--enable-turn-todo`/`--enable-consult`/`--enable-reject` |
-| `e10-cli workflow setting auto <wf>` | 自动处理设置。`--enable`/`--way`/`--follow-type` |
-| `e10-cli workflow setting other <wf>` | 其他设置。`--message-op`/`--auto-save`/`--switch-identity` |
+| `e10-cli workflow base submit-confirm <wf>` | 提交确认设置。`--confirm`/`--node-range`/`--nodes`/`--show-cc`/`--show-way`（0所有/1下一/2可到达）；先读后合并并回读验证 |
+| `e10-cli workflow base sign-set <wf>` | 签字意见设置（不含 PC/移动样式）。排序、关联与分享可见性、关联范围、附件目录、位置/表情/@及范围；`--schema`/`--candidates` 查看实时能力，详见流程指南 |
+| `e10-cli workflow base comment-set <wf>` | 评论功能开关。`--enable` |
+| `e10-cli workflow function batch-set <wf>` | 批量操作完整配置；`--schema`、`--data JSON/@file`、`--candidates` |
+| `e10-cli workflow function auto-approve <wf>` | 自动处理；`--schema`、`--data`、`--cross` |
+| `e10-cli workflow function other-set <wf>` | 其他设置；`--schema`、`--data`、`--candidates` |
+| `e10-cli workflow function water-mark-set <wf>` | 水印；`--schema`、`--data`、`--candidates` |
+| `e10-cli workflow function import-approval-set <wf>` | 导入流程；`--schema`、`--data`、`--candidates` |
+| `e10-cli workflow function resource-share-set <wf>` | 关联事项赋权；`--schema`、`--data`、`--candidates` |
+| `e10-cli workflow function doc-share-set <wf>` | 文档/附件权限；`--schema`、`--data`、`--candidates` |
 | `e10-cli workflow advanced doc <wf>` | 流程存档设置。`--enable`/`--dir-select`/`--doc-types` |
 | `e10-cli workflow advanced schedule <wf> [选项]` | 定时触发审批。**没有参数=查看**；配置分两次保存：详细配置（`--frequency` 频率 / `--begin-date` 开始日期 / `--weekday-only` / `--sms` / `--email` / `--message`）与开关（`--enable` 总开关 / `--limit-creator` 限制发起人范围）。`--frequency` 只需写要改的档位（如 `{"item1":"1","item2":"3"}`=按日每 3 天），缺的档位自动补全；item1: 1=日/2=周/3=月/4=季/5=年，item2=每几个周期。**⚠ 触发时间由平台固定，不可配置**（平台上该项为只读，帮助文案「固定晚上触发，不支持修改触发时间」）——没有 `--time` 选项。配完范围用 `workflow plan-range` |
 | `e10-cli workflow plan-range list <planId> [--page-size <n>]` | 查看定时计划的人员范围。`<planId>` 是定时计划 ID（`workflow advanced schedule` 输出里的「计划ID」） |
@@ -687,3 +691,5 @@ e10-cli workflow action list-node <wf> <nodeId>
 | `workflow node forward-setting get/create/update <wf> <node>` | 待办/已办/结束转发、接收人可提交意见/继续转发 |
 
 写入使用 `--data JSON/@文件`，未指定项保留，单次保存后回读。详见 [参数、范围与自然语言示例](../workflow/guide-opinion-settings.md)。
+
+| `e10-cli workflow base file-set <workflowId>` | 附件删除开关：`--create-delete 0/1`、`--async-delete 0/1`；先读后合并，保存后回读。 |

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 authset get <workflowId> --schema
-e10-cli workflow authset update <workflowId> --data '{"statistics":[{"_entityType":"user","id":"人员ID"}]}'
-```
-
-| 字段 | 设置 |
-|---|---|
-| maintenance | 维护权限；不包含删除工作流权限 |
-| statistics | 统计权限 |
-| statisticsExport | 统计数据导出权限，也影响统计导入 |
-| containSubDept | 包含下级部门，boolean |
-
-每组组织对象支持 `[]` 清空；没有指定的组保持原值。
-
-## 共享设置
-
-```bash
-e10-cli workflow shareset get <workflowId> --schema
-e10-cli workflow shareset update <workflowId> --data '{"defSharerCanViewComment":false}'
-e10-cli workflow shareset default get <workflowId> --schema
-e10-cli workflow shareset 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 shareset default update <workflowId> --data '{"defaultShareType":"1"}'
-e10-cli workflow shareset rule create <workflowId> --data '{"isEnable":false,"shareMultiNode":["节点ID"],"shareConditionUsers":[{"_entityType":"user","id":"人员ID"}],"condition":{"rules":["system:流程标题:包含:申请"],"relation":"AND"}}'
-e10-cli workflow shareset rule get <workflowId> --schema
-e10-cli workflow shareset rule update <workflowId> --rule-id <规则行ID> --data '{"shareTiming":"2"}'
-e10-cli workflow shareset 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 shareset field-permission get <workflowId>
-e10-cli workflow shareset field-permission update <workflowId> --data '{"fields":[{"name":"单行文本","display":false}]}'
-e10-cli workflow shareset system-field-permission get <workflowId>
-e10-cli workflow shareset 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 remind get <workflowId> --schema
-e10-cli workflow remind update <workflowId> --data '{"forceEndReceiver":[]}'
-e10-cli workflow remind detail get <workflowId> --src emailAndSmsRemind --schema
-e10-cli workflow remind 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 remind nodes get <workflowId> --src emailAndSmsRemind --schema
-e10-cli workflow remind nodes create <workflowId> --src emailAndSmsRemind --data '{"alterNodesBrowser":["节点ID"],"remindType":["0","1"]}'
-e10-cli workflow remind nodes update <workflowId> --src emailAndSmsRemind --rule-id <规则ID> --data '{"ccNoRemind":true}'
-e10-cli workflow remind detail update <workflowId> --src emailAndSmsRemind --data '{"remindScope":"1"}'
-```
-
-新增字段为 alterNodesBrowser/remindType/ccNoRemind，未指定项从服务端新增表单继承。修改字段为 reminders（渠道数组）、ccNoRemind、remindContentType（0 默认 / 1 自定义）。规则ID与节点ID不同；CLI 核实流程与渠道归属。
-
-### 邮件、短信、系统消息模板
-
-```bash
-e10-cli workflow remind templates get <workflowId> --content-type 1
-# 流程级保存会被后端联动开启自定义；必须先明确设置该开关
-e10-cli workflow remind update <workflowId> --data '{"isCustomContent":true}'
-e10-cli workflow remind templates update <workflowId> --content-type 1 --event 10 --data '{"title":"待审批：[-313]"}'
-# 节点模板需要先有该渠道节点提醒规则；省略 --node-id 是流程级
-e10-cli workflow remind 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-function-settings.md

@@ -0,0 +1,55 @@
+# 工作流功能设置
+
+统一入口 `e10-cli workflow function`。七项为流程级单份配置，第一次保存读取程序默认值；已有配置先读再局部合并，保存后回读核对。无需另建配置 ID。没有 `--data` 时仅查询。
+
+| 命令 | 功能 |
+|---|---|
+| batch-set | 批量提交/转办/征询/退回、各自节点范围、提交类型及退回发起节点规则 |
+| auto-approve | 自动处理、相邻/后续规则及范围、前置/后置、必审节点、组织范围、预测节点、意见内容、主次账号；--cross 为跨流程规则 |
+| other-set | 消息按钮、节点范围、自动保存及范围、身份切换、日志、默认最大显示、字段变更标记、门户等当前环境开放项 |
+| water-mark-set | 开关、系统/自定义、文本/图片、尺寸、透明度、角度、内容模板 |
+| import-approval-set | 导入开关、数据来源；旧模式另含无需导入字段、只读字段、钻取计算、默认值 |
+| resource-share-set | 表单事项字段、意见事项范围、客户权限、无权限资源过滤、关联搭建表单基本信息共享范围 |
+| doc-share-set | 文档/附件来源、流程参与人及表单字段共享、离开节点触发、禁止编辑、允许下载 |
+
+## 查询与修改
+
+```sh
+e10-cli workflow function batch-set <wf> --schema
+e10-cli workflow function batch-set <wf> --candidates selectNodes
+e10-cli workflow function batch-set <wf> --data '{"enabledBatch":true,"selectOptions":"1","selectNodes":["审批节点ID"]}'
+e10-cli workflow function auto-approve <wf> --data '{"autoHandle":true,"handWay":"0"}'
+e10-cli workflow function auto-approve <wf> --cross --schema
+e10-cli workflow function other-set <wf> --data '{"enableAutoSave":true}'
+e10-cli workflow function doc-share-set <wf> --data @patch.json
+e10-cli workflow function water-mark-set <wf> --candidates variables
+```
+
+参数统一：`--schema`（当前配置及实际字段定义）、`--data JSON/@file`（仅写指定项）、`--candidates 字段名`、`--out 文件`。开关用 true/false；单选用选项字符串 ID 或唯一名称；多选用数组。浏览字段用字符串 ID/唯一名称数组，清空用 []。组织范围用 `[{"_entityType":"user","id":"人员ID"}]`，所有人用 `[{"_entityType":"all","id":"0"}]`。列表修改替换指定字段的整个列表，其他字段保持不变。
+
+## 完整字段
+
+- batch-set：enabledBatch、allowTurnTodo、allowConsult、allowReject；selectOptions/selectNodes、turnTodoOption/turnTodoNodeBrowser、consultOption/consultNodeBrowser、rejectOption/rejectNodeBrowser；submitTypeOption/submitType；rejectToStart。
+- auto-approve：autoHandle、handWay、adjacentCheck、adjacentOptions/adjacentNodes、followUpType、followUpCommit、followUpCheck、followUpOptions/followUpNodes、selectUsers、backHandle、mustHandNodeBrowser、allowHandleUserBrowser、backHandleForecastNodeBrowser、compensateTip、signMark、signContent、mainSecondEnable。
+- auto-approve --cross：mainOperated、mainCommit、mainRangeType/mainRangeKey、associatedOperated、associatedCommit、associatedFieldKey。
+- other-set：followNodeviewRight、allowViewFormLog、messageOperation、nodeRangeOptions/nodeRangeNodes、autoMaxDisplay、enableAutoSave、autoSaveRangeType/autoSaveRangeMultiBrowser、markChangedFieldScene、markFieldRange/markFieldKeyBrowserValue、allowUseInDoor、recordFlowLog、allowUseAndDiverted、formModifyLog。环境未开放字段拒绝修改。
+- water-mark-set：enabled、waterType；waterMarkData 中可局部修改 wmClassify(text/picture)、wmWidth、wmHeight、wmNoTransparent、wmRotate、wmText、wmOriginText、wmImg。数字以字符串输入；wmImg 使用已上传图片的对象数组。本命令不上传本地图片文件。变量 ID 先查询 variables，不猜测。
+- import-approval-set：canImportApproval、importSource；旧模式另有 importReadOnlyField、fieldBrowserValue、relate、defaultValue。
+- resource-share-set：fieldSelect/fieldSelectBrowser、relateRangeSelect/relateRangeBrowser、customerShareType、filterNoPermission、ebShareBasicRangeBrowser。
+- doc-share-set：docShareOption、flowShareOperator、formFieldBrowser、fieldShareDocChange、fieldShareLeaveTrigger、fieldShareLeaveNodesBrowser、forbidEditOption、allowDownload。
+
+## 约束
+
+具体枚举、节点和字段以服务端 schema/candidates 为准，不把普通字段权限与文档/附件共享权限混用。
+
+节点可修改内容时关闭自动处理，必须同时启用存在必填项时关闭的规则；冲突输入拒绝，不静默改动用户未指定设置。预测节点必须保留发起节点。`followUpType` 的不启用不能与其他项并选。
+
+新版导入设置的 fieldValueSet 是表单复制规则的只读入口（前端 isSetting=false），流程设置不保存这些规则；--schema 中 customParameters.formId 指明关联表单。新旧模式以实际返回字段判定，不能仅凭 enableFormCopy 的数值推断。
+
+水印后端忽略空模板，CLI 因此拒绝空串清空请求；可关闭水印或替换有效内容。保存首次默认配置可能产生实体记录；恢复设置值不代表删除初始化记录。
+
+服务端返回成功但回读不一致时，命令失败并列出差异，不能直接当成配置成功，也不会自动重复写入。
+
+移动端布局独立设置（allowMobileLayout）和启用正文（enableOdocText）不提供写入支持；查询可见原值，修改其他配置时保留原值。
+
+导入模式由后端 enableFormCopy(entity) 判定：无配置走新模式；已有配置但 canImportApproval=0 时按新模式；否则 enableFormCopy=1 为新模式、0 为旧模式。CLI 根据实际返回的 fieldValueSet/字段定义开放能力，不单凭版本号或返回数字推断。