weaver-e10-builder 1.5.12 → 1.5.14

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

@@ -179,3 +179,9 @@ e10-cli workflow node layout unbind <workflowId> <nodeId>
 
 节点布局与字段权限是**叠加**的：布局管「字段怎么排」，字段权限管「字段能不能改」。
 两者都挂在同一条节点表单关联记录上，互不覆盖，可以同时用。
+
+字段权限的界面约束由命令自动收口：
+
+- 勾选**编辑**（`--editable`）必定勾选**显示**；
+- **禁止手动编辑**（`--disable-manual-edit`）只有在编辑勾选时才可设，命令会自动补上编辑与显示；
+- 设为**只读**（`--readonly`）会清除「禁止手动编辑」——只读字段不存在这一项。

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
@@ -198,8 +198,11 @@ e10-cli workflow operator-sign <workflowId> <nodeId> --sign-order 竞签 --group
 # 矩阵对应（查矩阵表动态获取审批人）
 e10-cli workflow set-operator <workflowId> <nodeId> --type matrix \
   --matrix-id <矩阵ID> --value-config-id <值字段configId> \
-  --matrix-rule "<条件configId>:1:1" \
-  --batch-condition "(申请人 等于 '张三')"
+  --matrix-rule "<条件configId>:1:1"
+# 批次条件独立配置（适用于所有操作者类型，不改变矩阵规则）
+e10-cli workflow operator-batch list <workflowId> <nodeId>
+e10-cli workflow operator-batch set-condition <workflowId> <nodeId> <groupId> <operatorSetId> \
+  --rule "form:金额:范围:10000:100000"
 # matrix-rule 格式: 条件configId:来源type:operate（operate可省略）
 # type: 1=发起人部门/分部，3=当前节点未操作者部门/分部，5=当前操作人部门/分部；或真实表单字段ID。
 # operate: 部门1/2/3/49/67，分部4/5/6/50；省略为本级（部门1，分部4）。
@@ -519,9 +522,32 @@ e10-cli workflow auto-layout <workflowId> --dry-run
 - **会覆盖手工摆放**。它是整图重排，人在浏览器里拖过的坐标一律按算法结果重置。手工调过就别再跑，或跑完重新调。
 - **不保证消除交叉**。分层算法只对「跨 ≥2 层的长跳线」把**目标**节点下移一档；跨层连线的水平段仍可能穿过中间层节点。**跑完看一眼流程图**，有交叉只能手工调坐标（或试 `--direction ttb` 换个走线方向）。
 
+### 导出流程（export）
+
+```bash
+# 导出到当前目录（文件名由平台给出）
+e10-cli workflow export <workflowId>
+
+# 指定文件或目录
+e10-cli workflow export <workflowId> -o D:/backup/
+e10-cli workflow export <workflowId> -o D:/backup/上会申请.zip
+```
+
+平台导出是**异步打包**（`POST packing` 建任务 → 轮询 `packingStatus` → 下载 zip），打包内容包含流程绑定的 e-builder 应用，通常要几十秒到几分钟。命令按 `--interval`（默认 2 秒）轮询、`--timeout`（默认 600 秒）封顶，打包期间打印进度；成功写出 zip 后打印本地路径与字节数。
+
+- `--name <名称>`：自定义导出名（只影响任务展示与平台文件名），缺省取流程名称。
+- `--json`：输出任务 ID、本地文件、字节数与平台文件名，便于脚本消费。
+- 导出的 zip 是平台的迁出包，可原样用于平台的导入/迁入。
+
 ---
 
 ## 相关指南
 
 - **分支条件 / 出口条件 / 条件 JSON** → `workflow/guide-workflow-condition.md`
 - **动作流（跨表单写入）/ 提交事件 / 角色管理** → `workflow/guide-workflow-action.md`
+
+## 基础设置：权限、共享、提醒
+
+`workflow authset`、`workflow shareset`、`workflow remind` 的字段、默认值、条件共享、字段权限、节点提醒和模板，见[基础设置指南](guide-base-auth-share-remind.md)。
+
+已有流程统一通过 `frame/getPathFrameInfo.relateType` 判断关联类型：`wea_form` 为原生工作流表单，`wea_ebuilder` 为 EB。节点字段权限、节点布局及流程字段赋值共用该判断，不试探表单接口。共享字段权限两类均固定 legacy，无 `--renderer` 参数。纯 EB 表单未关联流程时，由已知 EB 入口明确传入类型，无须调用 frame。

package/skill-docs/references/form/style-templates.md

@@ -1,97 +0,0 @@
-# 表单布局样式模板
-
-`form layout init --style-template <名|id>` 用这些模板初始化布局。
-
-## ⚠ 流式和表格式是**两套独立模板**，不能混用
-
-同一个名字在两套里往往是**不同的 id**（紧凑版 / 轻便版 / 碧海蓝天 / 极简白 / 极简淡蓝 /
-清新蓝绿 / 商务蓝 / 淡雅丁香 两套都有），而且各自还有对方没有的模板。所以**解析模板名必须
-先知道表单的布局类型**。
-
-| 表单布局 | 接口 | 内置模板数 |
-|---|---|---|
-| 流式 `FLOW` | `/api/form/flow/template/list` | 24（本环境另有若干用户导入的） |
-| 表格式 `EXCEL` | `/api/form/form/layout/template/listTemplateAdvancedByPage` | 20 |
-
-**拿错一套不会报错**——平台收到一个不属于该布局类型的 id，直接忽略；命令照常打印"已初始化"，
-样式却纹丝不动。这是最容易踩的坑：改了没效果，还以为模板名写错了。
-
-CLI 已按布局类型自动选接口并校验：传了不属于当前布局那一套的名字或 id 会直接报错，并列出该
-布局类型下可用的模板。
-
-## 用法
-
-```bash
-# 按名字（按当前表单的布局类型实时解析，推荐）
-e10-cli form layout init <objId> <appId> --style-template 碧空如洗
-
-# 按 id（同样会校验它属于当前布局那一套）
-e10-cli form layout init <objId> <appId> --style-template 830000000000000022
-
-# 不传则用该布局类型的缺省模板：流式=标准版、表格式=表格版
-e10-cli form layout init <objId> <appId>
-
-# 指定视图 + 只读/必填
-e10-cli form layout init <objId> <appId> --view-id <viewId> --style-template 紧凑版 --read-only
-```
-
-## 内置模板
-
-> 模板列表**按租户动态**（用户可以自行导入模板，本环境流式那套就多出十几个带「(导入)」的
-> 副本），**以命令输出为准**；下表是验证环境的内置项，供参考。
-
-### 流式（FLOW）
-
-| styleTemplateId | 模板名 |
-|---|---|
-| `820000000000000001` | 标准版（**缺省**） |
-| `820000000000000002` | 标准版（无表头） |
-| `820000000000000011` | 表格版 |
-| `810000000001000004` | 轻量设置版 |
-| `810000000001000001` / `002` / `003` | 分区卡片版 1 / 2 / 3 |
-| `830000000000000010` | 紧凑版 |
-| `830000000000000011` | 轻便版 |
-| `830000000000000012` | word版 |
-| `830000000000000015` / `016` / `017` | 轻量紫 / 轻量白 / 轻量蓝 |
-| `830000000000000018` | 简约瀑布流 |
-| `830000000000000019` | 半透蒙版 |
-| `830000000000000021` | 碧海蓝天 |
-| `830000000000000022` | 碧空如洗 |
-| `830000000000000023` | 淡雅丁香 |
-| `830000000000000024` | 极简白 |
-| `830000000000000025` | 极简淡蓝 |
-| `830000000000000026` | 简洁现代 |
-| `830000000000000027` | 清新蓝绿 |
-| `830000000000000028` | 深蓝商务 |
-| `830000000000000029` | 商务蓝 |
-
-### 表格式（EXCEL）
-
-| styleTemplateId | 模板名 |
-|---|---|
-| `700000000000000007` | 标准版 |
-| `700000000000000008` | 表格版（**缺省**，生成的 comps 默认只读） |
-| `700000000000000009` | 紧凑版 |
-| `700000000000000010` | 轻便版 |
-| `830421425497325568` | 靛青线条 |
-| `830662158415355904` | 简约深蓝 |
-| `830714355284320256` | 极简淡蓝 |
-| `830718787623460864` | 现代简约 |
-| `830722618751066113` | 商务淡蓝 |
-| `830743788745531393` | 极简白 |
-| `830749075757998081` | 极简灰 |
-| `830751622581329920` | 清新蓝绿 |
-| `830764108161785857` | 淡蓝水晶 |
-| `830765800429674496` | 银光浅灰 |
-| `831747419499700225` | 暗夜流光 |
-| `831759140499447809` | 公文样式 |
-| `831897833480421377` | 淡雅丁香 |
-| `917557790734188546` | 商务蓝 |
-| `933871446777094145` | 碧海蓝天 |
-| `1000599952745676801` | 青蓝冰水 |
-
-## 注意
-
-- 模板只影响**布局样式**（间距/边框/配色），不影响字段的 readOnly/required（这俩由 `--read-only`/`--required` 或 fields.json 控制）。
-- `表格版`（EXCEL 008）历史问题：生成的 comps 默认 readOnly=true。`form layout init` 会显式按 `--read-only`（默认 false 可编辑）覆盖，所以即使用 008 也能可编辑。
-- 建表（`form create`）时**不能**指定样式模板，只能建完再 `form layout init --style-template` 换。