weaver-e10-builder 1.5.11 → 1.5.13

package/skill-docs/references/form/guide-formula-linkage.md

@@ -87,15 +87,43 @@ e10-cli form formula-linkage add <appId> <objId> \
   --target 销售金额 \
   --expression "VALUE({主表.数量})*VALUE({主表.单价})"
 
-# 改（只传要改的；--event/--trigger 不传就沿用现有的）
+# 改联动（只传要改的；--event/--trigger 不传就沿用现有的）
 e10-cli form formula-linkage update <appId> <objId> <linkageId> --trigger 产品类别
 e10-cli form formula-linkage update <appId> <objId> <linkageId> --state off
 e10-cli form formula-linkage update <appId> <objId> <linkageId> --name "重算金额"
 
+# 关掉「联动出的值继续触发联动」
+e10-cli form formula-linkage update <appId> <objId> <linkageId> --fission off
+
+# 改公式正文（目标不变）
+e10-cli form formula-linkage update <appId> <objId> <linkageId> \
+  --expression "VALUE({主表.数量})*VALUE({主表.单价})*2"
+
+# 连赋值目标一起改
+e10-cli form formula-linkage update <appId> <objId> <linkageId> \
+  --target 含税金额 --expression "VALUE({主表.数量})*VALUE({主表.单价})"
+
+# 只改目标（沿用原公式右侧）
+e10-cli form formula-linkage update <appId> <objId> <linkageId> --target 含税金额
+
 # 删除（批量）
 e10-cli form formula-linkage delete <appId> <objId> <linkageId...>
 ```
 
+### 改公式（`--expression` / `--target`）
+
+**联动和公式是两条记录**：联动里只存 `sourceExcel.excelId`，真正被写入的赋值式在公式记录里。所以：
+
+- 只改触发时机 / 名称 / 启停 → 不碰公式，`updateFormDataLinkage` 就够了；
+- 改表达式或赋值目标 → 走 `--expression` / `--target`，命令读回联动引用的 `excelId`、按新表达式重建参数表，再用 `formulaId` **原地更新那张公式**（`excelId` 不变），不会删掉联动重建。
+
+两种写法都能改：
+
+- `--expression` 只给右侧函数体，或直接贴整段赋值式（左侧与最终目标不一致会报错，不会静默改目标）；含引号/换行时用 `@文件路径`。
+- `--target` 单独给时，沿用原公式右侧，只换左侧目标；与 `--expression` 一起给时按新目标拼左侧。
+
+> `delete` 删除的是**联动记录**，把规则从表单上摘掉。公式记录是另一条记录，本命令不发单独的公式删除请求。
+
 ### add 的参数
 
 | 参数 | 说明 |
@@ -108,6 +136,21 @@ e10-cli form formula-linkage delete <appId> <objId> <linkageId...>
 | `--name <名>` | 联动名。默认 `<公式名> - 公式_<时间戳>` |
 | `--formula-name <名>` | 公式名，默认取表单名 |
 | `--formula-id <id>` | 复用/更新已有公式，不新建 |
+| `--fission on\|off` | **联动出的值继续触发联动**，默认 `on`。关掉后，本规则算出的值不再作为其他联动的触发来源（落库 `linkageExt.fissionState`：on=1 / off=0） |
+
+### 联动出的值继续触发联动（`--fission`）
+
+函数联动与字段联动共用同一个开关，存在 `linkageExt.fissionState`：
+
+```bash
+# 新建时关掉
+e10-cli form formula-linkage add <appId> <objId> ... --fission off
+
+# 改已有规则
+e10-cli form formula-linkage update <appId> <objId> <linkageId> --fission off
+```
+
+`on`（缺省）表示这条规则赋值后产生的字段变化还会继续驱动其他联动；`off` 表示到此为止，避免多条规则相互触发形成循环。`list` / `read` 会显示当前状态。
 
 ### 生效维度（`--effect`）
 

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

@@ -139,7 +139,7 @@ e10-cli workflow nodes <workflowId>
 ```bash
 # 指定人
 e10-cli workflow set-operator <workflowId> <nodeId> 张三
-# 指定角色
+# 指定角色（名称精确优先；子串命中多个时会列出候选，要求改用完整名称或角色 ID）
 e10-cli workflow set-operator <workflowId> <nodeId> 财务主管 --type role
 # 发起人上级
 e10-cli workflow set-operator <workflowId> <nodeId> --type superior