weaver-e10-builder 1.5.14 → 1.5.16

package/skill-docs/references/form/ref-form-fields.md

@@ -23,7 +23,7 @@
 | --- | --- |
 | `componentKey` | 字段类型标识 |
 | `fieldName` | 字段名称 |
-| `dataKey` / `columnName` | 字段编码 / 数据库列名。**两者是两个独立的东西**，可分别指定；都不写则同为字段名拼音首字母，只写 `dataKey` 时列名跟随。建后由 `add-field --data-key/--column-name`、`edit-field --column-name` 调整 |
+| `dataKey` / `columnName` | 字段编码 / 数据库列名。**两者是两个独立的东西**，可分别指定；都不写则同为字段名拼音首字母，只写 `dataKey` 时列名跟随。建后由 `add-field --data-key/--column-name`、`edit-field --data-key/--column-name` 调整；**明细字段同样可用 `edit-field` 修改**（按 fieldId 自动定位所属明细表） |
 | `required` / `readOnly` / `hidden` | 必填、只读、隐藏 |
 | `singleRow` | 独占一行 |
 | `group` | 所属分组 |

package/skill-docs/references/report/cross-dataset-filter-guide.md

@@ -166,29 +166,43 @@ def make_left_filter(p_ds_id, p_src_id, p_field, c_ds_id, c_src_id, c_field):
 | **单元格 customFilterField** | `style.cellType.customFilterField` | 该单元格取数时的行级条件 |
 | **数据集 datasetFilter** | `saveReportWithCacheConfig` 的 `datasetFilter` 参数 | 整个数据集的基础过滤 |
 
-单元格自定义筛选同样必须使用 **fieldKey** 作为 `currentField` 和 `id`。
-
-### 3.2 数据结构
+`currentField` 必须是 **fieldKey**；`id` 平台可接受但设计器回写**不带**（2026-10 抓包），所以
+新写入以设计器形状为准：
 
 ```json
-{
- "customFilterField": [
- {
- "currentField": "1304979560546713602.1299789221321891842.field_1299789221321891843",
- "type": "NotContain",
- "value": "某核算机构",
- "id": "1304979560546713602.1299789221321891842.field_1299789221321891843"
- },
- {
- "currentField": "1304979560546713602.1299789221321891842.field_1299789221321891844",
- "type": "Null",
- "value": "",
- "id": "1304979560546713602.1299789221321891842.field_1299789221321891844"
- }
- ]
-}
+[
+ { "index": 1,
+   "currentField": "{dataSetId}.{sourceId}.{fieldName}",
+   "type": "Equals",
+   "value": ["1"] }
+]
 ```
 
+**选项类字段**（Select / RadioBox / CheckBox / …）的 `value` 是**选项 valueKey 数组**；
+文本/数字/日期写字符串。手工拼报文时容易只写选项显示名 —— 平台有时能按名称兜底，
+但设计器回显会变成空，按 valueKey 写最稳。
+
+### 3.2 用 CLI 写入（推荐）
+
+```bash
+# 自定义筛选：分类 等于 甲（选项名自动换成 valueKey）
+e10-cli report cell-filter set <reportId> --app-id <appId> \
+  --cell 1,0 --op 等于 --value 甲
+
+# 指定同一数据集里的其他字段，追加第二条条件
+e10-cli report cell-filter set ... --field 金额 --op 大于 --value 100 --append
+
+# 结果筛选（前多少个 / 后多少个 / 奇数 / 偶数 / 特定）
+e10-cli report cell-filter set ... --cell 1,1 --kind result --op 前几个 --value 1
+
+# 读回 / 清除
+e10-cli report cell-filter list <reportId> --app-id <appId>
+e10-cli report cell-filter remove <reportId> --app-id <appId> --cell 1,0
+```
+
+命令会改 `fields[]` + workbook `style.cellType`、双保存并回读比对；`designKey` 过期
+（code=200 + `data:"您当前的数据不是最新的…"`）会自动重读重写一次。
+
 ### 3.3 type 枚举（平台值）
 
 **必须使用下列枚举**，不要用简写：

package/skill-docs/references/report/event-hreflink-guide.md

@@ -162,6 +162,36 @@ https://www.baidu.com/s?zclb=D7&zcmc=E7&cx={searchfield001}
 }
 ```
 
+### 用 CLI 写入（推荐）
+
+```bash
+# 弹出页（新窗口）
+e10-cli report cell-event set <reportId> --app-id <appId> \
+  --cell 1,0 --pc "https://www.baidu.com/s?zclb=D7&zcmc=E7" --open 弹出页
+
+# 当前页（同页跳转）
+e10-cli report cell-event set <reportId> --app-id <appId> \
+  --cell 1,0 --pc "/sp/ebdfpage/list/xxx?dept=B5" --open 当前页
+
+# 执行 js 代码
+e10-cli report cell-event set <reportId> --app-id <appId> \
+  --cell 1,0 --pc "window.open('/sp/ebdfpage/list/xxx')" --open 执行js代码
+
+# 读回 / 清除
+e10-cli report cell-event list <reportId> --app-id <appId>
+e10-cli report cell-event clear <reportId> --app-id <appId> --cell 1,0
+```
+
+命令会改 `fields[]` + workbook `style.cellType`、双保存并回读比对。两条硬规则：
+
+- **全角 `？＆＝` 直接报错** —— 这类链接写进去设计器能显示，但预览点击无反应。
+- `saveReportDevInfo` 在 `designKey` 过期时返回 **code=200 + `data:"您当前的数据不是最新的…"`**。
+  手工调接口时看到 200 就收工会得到「链接写进去了但点了没反应」；命令已识别并自动重读重写。
+
+> 运行时平台会把带链接的格子换成 `BlankHerflinkCellType` / `SelfHerflinkCellType` /
+> `JSScriptHerflinkCellType`（分别对应 `blank|self|jsscript`）。若设计器里看得到链接、
+> 预览里单元格没有变成超链接样式，先确认 fields 与 workbook 两边是否都写到了。
+
 ---
 
 ## 六、Agent 检查清单

package/skill-docs/references/report/ref-report-commands.md

@@ -56,6 +56,20 @@
 | `report fix query-style <reportId> --app-id [--id ...] [--delete-id ...] [--apply]` | 清未点名的展示样式 |
 | `report validate query --map-show-where "顶部筛选"` | 显示方式说法映射 |
 
+## 单元格筛选 / 事件
+
+| 命令 | 用途 |
+|---|---|
+| `report cell-filter list <reportId> --app-id` | 列出所有带筛选的单元格（自定义筛选 / 结果筛选） |
+| `report cell-filter set <reportId> --app-id --cell <行,列> --op <算子> [--field <字段>] [--value <值>] [--kind custom\|result] [--append]` | 写入单元格筛选。`--cell` 坐标与 `fields[].x,y` 一致（**x=行，y=列**）；`--field` 缺省为该格自己的字段；选项类字段的值写选项名或 valueKey（逗号分隔多个） |
+| `report cell-filter remove <reportId> --app-id --cell <行,列> [--kind custom\|result]` | 清空该格筛选（缺省两类都清） |
+| `report cell-event list <reportId> --app-id` | 列出配置了链接的单元格 |
+| `report cell-event set <reportId> --app-id --cell <行,列> (--pc <链接> \| --h5 <链接>) [--open 弹出页\|当前页\|执行js代码]` | 写入单元格事件链接；`--pc` 可写 URL 或 JS（`--open 执行js代码`）；`--open` 缺省**保持原值**（新链接为弹出页）。全角 `？＆＝` 会直接报错 |
+| `report cell-event clear <reportId> --app-id --cell <行,列> [--pc\|--h5]` | 清链接（缺省 PC+H5 都清，打开方式复位为弹出页） |
+
+> **落库契约**：两组的写入都会改 `fields[]` 与 workbook `style.cellType`，双保存后**回读比对**，不一致即报错。
+> `saveReportDevInfo` 在 `designKey` 过期时会返回 **code=200 + `data:"您当前的数据不是最新的…"`**（静默失败）；命令会识别该文案并自动重读重写一次。
+
 ## 权限
 
 | 命令 | 用途 |

package/skill-docs/references/report/report-designer-feature-map.md

@@ -322,7 +322,7 @@ flowchart TB
 | 显示方式 | 分组 / 排列 / 汇总 / 树形 | 汇总含求和/计数/平均等 |
 | 日期分组 | 年 / 年月 / 不设置 | — |
 | 分组排序 | 升序 / 降序 / 不排序 | — |
-| **筛选** | 父格筛选 / 自定义筛选 / 结果筛选 | `cross-dataset-filter-guide.md` |
+| **筛选** | 父格筛选 / 自定义筛选 / 结果筛选 | `cross-dataset-filter-guide.md` · CLI `report cell-filter set\|remove` |
 | **字段转换** | 人员/部门/部门全路径/checkbox/选择框/颜色/分值图标/斜线/关联/图片 | **`cell-transform-guide.md`** · `transType`+`browserType` |
 | **HTML转换** | 是/否 | `isHtml` `"1"|"0"` |
 | **前缀/后缀** | 文本 | `prefixAndSuffix:["前","后"]` |
@@ -332,7 +332,7 @@ flowchart TB
 
 ### 7.2 「事件」Tab
 
-> **完整**：`event-hreflink-guide.md` · CLI `validate href`
+> **完整**：`event-hreflink-guide.md` · 写入 CLI `report cell-event set|clear` · 写法校验 `validate href`
 
 | 属性 | 落库 | 说明 |
 |------|------|------|

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,112 @@
+# 工作流功能设置
+
+统一入口 `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"}]`。列表修改替换指定字段的整个列表，其他字段保持不变。
+
+## 自动处理：先理解业务语义，再选择模式
+
+| 用户描述的业务含义 | 模式 | 配置 |
+|---|---|---|
+| 同一人员前面审批过，后面不用再次审批；后续再次到达此人时按规则自动处理 | 前置审批/前置处理 | `handWay:"0"` |
+| 同一人员需要审批多个节点，只需要最后一个节点审批；跳过前面的节点，保留最后一个非结束节点人工处理 | 后置审批/后置处理 | `handWay:"1"` |
+
+不能把“自动处理前面的节点”理解成“前置”；应根据人工审批保留在前面还是最后来判断。“后续节点自动处理”属于前置规则，不等于后置处理。描述只有“自动审批/避免重复审批”而未说明保留哪次审批时，应向用户确认模式，不能照抄示例默认选0。
+
+```sh
+# 前面已审批，后续不重复审批：前置；还需按需求配置相邻/后续规则
+e10-cli workflow function auto-approve <wf> --data '{"autoHandle":true,"handWay":"0"}'
+# 多个节点只审批最后一个非结束节点：后置；其他规则保留当前值/程序默认值
+e10-cli workflow function auto-approve <wf> --data '{"autoHandle":true,"handWay":"1"}'
+```
+
+这两个示例只开启自动处理并选择模式，不代表已经配置好所有跳过条件、人员及节点范围。先用 `--schema` 查询；保存后的 `verified:true` 只证明回读与提交配置一致，不证明自然语言需求被正确理解或实际流转已通过验收。
+
+### 后置审批的现有 CLI 能力
+
+| 业务设置 | 字段/写入方式 |
+|---|---|
+| 自动处理总开关、后置模式 | `autoHandle:true`、`handWay:"1"` |
+| 节点可修改流程内容时关闭自动处理 | `backHandle` 包含 `"0"`；必须同时包含 `"2"` |
+| 存在必填项时关闭自动处理 | `backHandle` 包含 `"2"` |
+| 仅当节点操作者为本人一人时自动跳过 | `backHandle` 包含 `"1"` |
+| 后续节点操作者为发起人时自动处理 | `backHandle` 包含 `"3"` |
+| 必须人工处理、不能后置的节点 | `mustHandNodeBrowser`：节点ID/唯一名称数组 |
+| 允许后置处理的人员范围 | `allowHandleUserBrowser`：带 `_entityType` 的组织对象数组；为空表示所有人都不允许后置 |
+| 离开哪些节点后预测后置处理 | `backHandleForecastNodeBrowser`：节点ID/唯一名称数组；必须保留程序指定的发起节点 |
+| 流程结束前弹出补充审批提示 | `compensateTip`：true/false |
+| 后置处理意见留痕 | `signMark`：true/false |
+| 留痕意见内容 | `signContent`：字符串，支持提交富文本内容；按实际schema使用 |
+
+`backHandle` 是完整选项数组，修改时先读原值，仅增删用户要求的选项；其他列表同样是整字段替换。支持新增时读取默认值、已有配置先读后合并、保存后回读验证。组织范围当前支持人员、部门、分部、群组、角色和所有人（实际可用范围以服务端为准）。
+
+### 后置审批的语义边界
+
+- `compensateTip:false` 仅关闭弹窗，流程仍会自动进行必要的补充审批。
+- 从 `backHandle` 去掉 `"3"`：发起人在后续仅出现一次时不自动处理；出现多次仍可能按后置规则跳过前面的节点。因此“发起人绝不自动处理”不能仅靠取消此选项实现，应进一步确认人员范围/必审节点要求。
+- 自由流程不支持后置；CLI 在程序返回 `isViewBackHandle=false` 时拒绝设置后置。节点候选按当前程序过滤，不能假定发起、结束等节点均可作为必审节点。
+- 切换前置/后置及关闭后置对新流程数据生效，不改变已在流转中的数据（管理员指南说明）。
+- `--cross` 是另一套跨流程规则入口，不是启用后置的必要参数；旧环境未开放的字段不能强行写入。
+
+## 完整字段
+
+- 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/字段定义开放能力，不单凭版本号或返回数字推断。
+
+## 动态文本水印
+
+```sh
+e10-cli workflow function water-mark-set <wf> --candidates variables
+e10-cli workflow function water-mark-set <wf> --data '{"enabled":true,"waterType":"1","waterMarkData":{"wmClassify":"text","textTemplate":"{{金额}}{{当前时间}}水印"}}'
+```
+
+`textTemplate` 中 `{{名称}}` 必须完整且唯一，也可使用 `{{ID}}`。CLI 查询实时变量并生成实际模板与编辑器回显 HTML，保留未指定的宽高、旋转、不透明度等设置。变量仅支持接口返回的系统变量及主表字段。
+
+高级输入 `wmText` 使用 `$字段ID`（不是邮件的 `[字段ID]`），CLI 自动生成 `wmOriginText`；单独修改回显模板不允许。两者同时传入时校验内容及变量顺序一致，HTML 须为有效片段。`textTemplate` 不可与两项原始模板混用。含 `$` 的 shell 参数请用单引号或 `@文件`，避免 shell 展开。
+
+`verified:true` 只表示配置回读一致，输出 verificationScope 明确说明未验证实际页面渲染；不要据此声称已验证真实金额显示。CLI 当前不提供水印页面预览。