weaver-e10-builder 1.5.15 → 1.6.0

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-function-settings.md

@@ -1,55 +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"}]`。列表修改替换指定字段的整个列表，其他字段保持不变。
-
-## 完整字段
-
-- 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/字段定义开放能力，不单凭版本号或返回数字推断。
+# 工作流功能设置
+
+统一入口 `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 当前不提供水印页面预览。