weaver-work-cli 0.1.24 → 0.1.25

package/skills/weaver-e10-builder/references/form/guide-ebuilder-scope.md

@@ -0,0 +1,82 @@
+# 关联浏览数据范围设置（浏览数据定义 → 数据范围）
+
+配置表单中 EBuilder 关联字段的**数据范围设置**——决定关联浏览弹窗里**哪些被关联数据可选**（如关联客户时只选"客户状态=启用"的客户）。对应设计器「浏览数据定义 → 数据范围设置」面板。
+
+走平台 `browserDataScope` 接口（selectPage 读 / batchSave 写+清），设计器能识别、浏览时生效。
+
+## 命令
+
+```bash
+# 读取已设数据范围
+e10-cli form ebuilder-scope get <源objId> <appId> <EBuilder字段fieldId>
+
+# 设置数据范围：被关联数据须满足条件才可选
+e10-cli form ebuilder-scope set <源objId> <appId> <EBuilder字段fieldId> \
+  --rules @scope-rules.json --logic and
+
+# 清空
+e10-cli form ebuilder-scope clear <源objId> <appId> <EBuilder字段fieldId>
+```
+
+- `<源objId>`：含关联浏览字段的表单 objId
+- `<appId>`：应用 ID
+- `<EBuilder字段fieldId>`：关联浏览字段的 fieldId（`form read` 获取，类型为 Ebuilder）
+- `--logic and|or`：多规则关系（默认 `and`）
+- `--fill-null`：关联字段为空时是否填充（默认关闭）
+
+## 规则格式
+
+```json
+[
+  {"field":"客户状态","operator":"eq","value":"启用"},
+  {"field":"客户名称","operator":"like","value":"上海"}
+]
+```
+
+| 字段 | 说明 |
+|------|------|
+| `field` | 目标表单字段名或 fieldId（CLI 自动解析） |
+| `operator` | `eq`(等于)/`neq`(不等于)/`like`(包含)/`isnull`(为空)/`notnull`(不为空) |
+| `value` | 选项类用**选项名**，CLI 自动解析 valueKey；文本/数字/日期用字面值。`isnull`/`notnull` 不需要 value |
+
+> 选项类字段（Select/Radio/CheckBox）：`value` 填选项名，CLI 自动反查目标表该字段的选项、解析出 valueKey，填 `selectValue`/`customBrowserValue`/`config.options`。选项名必须在目标表选项中存在，否则报错并列出可选值。
+
+## 示例
+
+**关联客户只选启用状态**（典型场景：客户状态=启用才可选）：
+
+```bash
+e10-cli form ebuilder-scope set <源objId> <appId> <EBuilder字段fieldId> \
+  --rules '[{"field":"客户状态","operator":"eq","value":"启用"}]'
+```
+
+**多条件**（启用且名称含上海）：
+
+```bash
+e10-cli form ebuilder-scope set <源objId> <appId> <EBuilder字段fieldId> \
+  --rules '[{"field":"客户状态","operator":"eq","value":"启用"},{"field":"客户名称","operator":"like","value":"上海"}]' \
+  --logic and
+```
+
+**清空恢复全部可选**：
+
+```bash
+e10-cli form ebuilder-scope clear <源objId> <appId> <EBuilder字段fieldId>
+```
+
+## 验证
+
+- `set` 命令保存后自动回读校验规则数是否一致
+- 设计器打开「数据范围设置」面板应显示所设条件
+- 关联浏览时被关联数据应按条件过滤（不满足的不可选）
+
+## 与旧 `ebuilder-filter` 的区别
+
+| | `ebuilder-scope`（推荐） | `ebuilder-filter`（已废弃，保留兼容） |
+|---|---|---|
+| 接口 | `browserDataScope`（数据范围专用） | 字段布局 `filterParams` |
+| 设计器识别 | ✅ | ❌ |
+| 浏览时生效 | ✅ | 不保证 |
+| 用途 | 关联浏览筛选 | 旧机制，已被 scope 取代 |
+
+> ⚠️ `ebuilder-filter` 的旧配置不保证被设计器识别；新建关联浏览筛选一律用 `ebuilder-scope`。

package/skills/weaver-e10-builder/references/form/guide-field-linkage.md

@@ -0,0 +1,123 @@
+# 字段联动（跨表带出赋值）指南
+
+## 概述
+
+字段联动（FormDataLinkage）：表单字段值改变时，自动查询**另一张表**（按数据ID=触发字段值过滤），把查到的字段值**带出赋值**到本表单字段。支持单跳（一次直接带出）和多跳链式（多次中转后带出）。
+
+背后是一个 ESB FieldLinkage 动作流（触发 + N 个 EnquiryForm 查询 + Output 赋值），CLI 自动完成建 ESB app + saveDesign + 绑定。
+
+## 三种联动对比
+
+| | 属性联动（显隐） | 关联表带出（form relate） | **字段联动（field-linkage）** |
+|---|---|---|---|
+| 命令 | `form linkage add` | `form relate` | `form field-linkage add` |
+| 接口 | viewlinkage | ffRelateField module:hrm | saveFormDataLinkage + saveDesign（ESB） |
+| 作用 | 改字段显示属性（hide/show/required） | 换 Employee/Department→带 HRM 属性 | **查任意表→带出任意字段赋值** |
+| 源 | 表单字段值条件 | Employee/Department（HRM 源） | 任意字段→任意表查询 |
+| 复杂度 | 简单 | 简单（单源单属性） | 复杂（跨表多跳，ESB 动作流） |
+| 关系 | — | — | **字段联动是关联表带出的进阶版** |
+
+> 本文讲的是**跨表**带出。本表字段之间用公式互相计算赋值的是**函数联动**（eb 表 `form formula-linkage`、流程表单 `wf-form formula-linkage`），见 `guide-formula-linkage.md` —— 两者 `linkageType` 不同（`excel` vs `template`），`form field-linkage list/delete` 看不到也删不掉函数联动。
+
+## 何时用多跳
+
+**Text 字段赋值必须用名称（多跳），不能直接赋 ID。**
+
+| 场景 | 跳数 | 示例 |
+|------|------|------|
+| 带出字段是 EBuilder（存 ID）→ 目标也是 EBuilder | 单跳 | 关联合同→查合同信息表→带出关联客户（ID→EBuilder 字段） |
+| 带出字段存 ID → 目标是 Text（要名称） | **多跳** | 关联客户→查客户信息表→客户类型(ID)→查客户类型表→类型名称(Text)→填 Text 字段 |
+
+**判断原则**：目标字段是 EBuilder/Select（存 ID）→ 单跳即可；目标字段是 Text（要展示名称）→ 必须多跳到名称表取名称。
+
+## CLI 命令
+
+```bash
+# 列出
+e10-cli form field-linkage list <appId> <objId>
+
+# 回读单条
+e10-cli form field-linkage read <appId> <objId> <linkageId>
+
+# 查源表可带出字段
+e10-cli form field-linkage fields <appId> <formId>
+
+# 删除（批量）
+e10-cli form field-linkage delete <appId> <objId> <linkageId...>
+```
+
+### 新增（add）
+
+**单跳**（一次直接带出）：
+```bash
+e10-cli form field-linkage add <appId> <objId> \
+  --trigger <触发字段名> \
+  --source-form <目标表objId> \
+  --query-field <目标表带出字段名> \
+  --target <本表目标字段名>
+```
+
+**多跳**（多次中转后带出）：
+```bash
+e10-cli form field-linkage add <appId> <objId> \
+  --trigger <触发字段名> \
+  --target <本表目标字段名> \
+  --hops "<源表objId:带出字段名,源表objId:带出字段名,...>"
+```
+
+`--hops` 格式：每跳 `objId:字段名`，逗号分隔。前一跳的带出值 = 下一跳的过滤值（数据ID=前一跳结果）。最后一跳的带出值赋给 `--target`。
+
+## 配置示例
+
+### 示例1：单跳——关联合同→合同信息表→关联客户
+
+```
+关联合同(EBuilder→合同信息表) 值改变
+→ 查合同信息表 by 数据ID=关联合同
+→ 带出关联客户(EBuilder→客户信息表，存ID)
+→ 赋值到本表.关联客户(EBuilder字段，存ID)
+```
+
+```bash
+e10-cli form field-linkage add <appId> <objId> \
+  --trigger 关联合同 --source-form <合同信息表objId> --query-field 关联客户 --target 关联客户
+```
+
+### 示例2：多跳——关联客户→客户信息表→客户类型→客户类型表→类型名称→填Text
+
+```
+关联客户(EBuilder→客户信息表) 值改变
+→ Step1: 查客户信息表 by 数据ID=关联客户 → 带出客户类型(EBuilder→客户类型表，存ID)
+→ Step2: 查客户类型表 by 数据ID=客户类型(Step1结果) → 带出类型名称(Text)
+→ 赋值到本表.客户类型(Text字段，要名称不要ID)
+```
+
+```bash
+e10-cli form field-linkage add <appId> <objId> \
+  --trigger 关联客户 --target 客户类型 \
+  --hops "<客户信息表objId>:客户类型,<客户类型表objId>:类型名称"
+```
+
+### 示例3：链式联动（两条独立 linkage 串联）
+
+关联合同→(linkage1)→关联客户→(linkage2)→客户类型→(linkage3)→类型名称
+
+每条 linkage 的 `--trigger` 是上一条的 `--target`。分开 `add` 多次即可。
+
+## 查源表字段
+
+```bash
+# 查某表单有哪些可带出字段
+e10-cli form field-linkage fields <appId> <formId>
+```
+
+或用 `e10-cli form read <objId> --app-id <appId>` 取字段 fieldId（配置 --hops 时需知道字段名）。
+
+## 注意事项
+
+1. **Text 字段必须多跳取名称**：目标字段是 Text → 带出值必须是名称（文本），不能是 ID。如果源表存的是 ID（EBuilder/Select），需多跳到名称表取名称。
+2. **orgId 必须正确**：CLI 自动从 getForm 取 orgId，传给 application/save 建 ESB app。没有 orgId 的 app 不完整，saveDesign 会 500。
+3. **多跳 EnquiryForm 需要 sources**：非首跳的查询动作必须有 `sources` 指向前一跳，否则服务器报"有两个起始执行组件"（CLI 已处理）。
+4. **FormData 引用格式**：触发字段 `FormData.<本表formId>.<触发字段id>`；查询结果 `FormData.<源表objId>[].field_<带出字段id>`。
+5. **--hops 的 objId 是表单 objId**（不是 formId）。CLI 内部自动解析 objId→formId。
+6. **联动名称**：不传 `--name` 时自动生成 `<本表名>.<触发字段>→<最后源表名>.<最后带出字段>`。

package/skills/weaver-e10-builder/references/form/guide-form-archive-permission.md

@@ -0,0 +1,175 @@
+# 流程归档权限
+
+「流程归档权限」管的是**某个流程归档之后**，它的数据对谁可见、可改、可删。它和表单的共享权限是两套：
+共享权限按表单配一次，归档权限**按流程各配一套**（同一张表单的不同流程可以不一样），并且多一档「归档附件」权限。
+
+## 命令
+
+```bash
+# 查看某个流程的归档权限
+e10-cli form permission archive list <objId> <appId> --workflow <workflowId>
+
+# 通用对象：给某个部门开「归档查看」
+e10-cli form permission archive add <objId> <appId> --workflow <workflowId> \
+  --target general --org-type department --org-id <deptId> --rights view --file-rights view download
+
+# 创建人相关：创建人本人及本部门可查看/编辑
+e10-cli form permission archive add <objId> <appId> --workflow <workflowId> \
+  --target creator --creator-related 0 --rights view edit
+
+# 字段相关：以表单里的「负责人」字段取值决定权限
+e10-cli form permission archive add <objId> <appId> --workflow <workflowId> \
+  --target field --field 负责人 --rights view edit delete
+
+# 矩阵相关（真矩阵）
+e10-cli form permission archive add <objId> <appId> --workflow <workflowId> \
+  --target matrix --matrix 门店经理矩阵 --rights view
+
+# 矩阵相关（e-Builder 表单当矩阵用）
+e10-cli form permission archive add <objId> <appId> --workflow <workflowId> \
+  --target matrix --eb-form <表单名或id> --matrix-value 创建者 --rights view
+
+# 矩阵相关 + 条件（真矩阵才有条件列）：所属门店 等于 本表单的「创建人部门」
+e10-cli form permission archive add <objId> <appId> --workflow <workflowId> \
+  --target matrix --matrix 门店经理矩阵 \
+  --matrix-condition '{"column":"所属门店","func":"等于","field":"创建人部门"}' \
+  --rights view
+
+# 删除（按 list 里的权限 ID）
+e10-cli form permission archive remove <objId> <appId> --right-id <id[,id...]>
+
+# 归档卡片开关
+e10-cli form permission archive card <workflowId> <appId>
+e10-cli form permission archive card <workflowId> <appId> --set 1
+```
+
+## 四类授权对象
+
+同一个端点上靠 `codeType` + `orgType` 区分四类，命令层用 `--target` 选择：
+
+| `--target` | 类别 | `codeType` | `orgType` | 主体怎么给 |
+|---|---|---|---|---|
+| `general` | 通用对象 | `obj_data_admin` | `employee` / `department` / `company` / `role` / `group` / `all` … | `--org-type` + `--org-id`（`all` 自动 0） |
+| `creator` | 创建人相关 | `obj_data_creator` | `creatorRelated` | `--creator-related` 0~7 |
+| `field` | 字段相关 | `obj_data` | `field_<字段类型>` | `--field <字段 id 或名称>` |
+| `matrix` | 矩阵相关 | `matrix` / `ebuilder_form` | 同 `codeType` | `--matrix`（真矩阵）或 `--eb-form` |
+
+`--target` 也接受中文名（`通用对象` / `创建人相关` / `字段相关` / `矩阵相关`）。
+
+### 创建人相关的 0~7
+
+`0` 本人、本部门、本分部；`1` 直接上级、本部门及所有下级部门、本分部及所有下级分部；`2` 本分部、本部门及所有上级部门、本分部及所有上级分部；
+`3` 本部门、所有下级部门、所有下级分部；`4` 所有上级、所有上级部门、所有上级分部；`5` 本岗位；`6` 直接下属；`7` 上级部门。
+
+### 字段相关的字段类型
+
+`--field` 既可给字段 id，也可给字段名（重名会报错，改用 id）。字段属于明细表时补 `--sub-form-id`。
+
+`orgType` 由字段的组件类型推出，目前覆盖：
+
+| 组件类型 | `orgType` | 回显名 |
+|---|---|---|
+| `Employee` | `field_employee` | 人员字段 |
+| `Department` | `field_department` | 部门字段 |
+| `SubCompany` | `field_company` | 分部字段 |
+| `Post` | `field_post` | 岗位字段 |
+| `EBuilder` | `field_ebuilder` | 关联ebuilder字段 |
+
+其余字段类型（人员范围选择、人力资源条件、人员组织多选等）不在自动推断表里 —— 组件类型名与 `field_*` 后缀不是一一对应，
+猜错会**静默授错对象**，所以命令会报错而不是替你选。这类请用 `--org-type field_xxx` 显式指定：
+
+`field_employee_condition`（人员范围选择字段）、`field_employee_share_condition`（人力资源条件字段）、`field_employee_organization`（人员组织多选）。
+
+### 矩阵相关的「取值字段」
+
+取值字段决定**用矩阵里的哪一列**去匹配当前用户，必需，且取值来源分两种：
+
+- **真矩阵**（`--matrix`）：值字段自动取该矩阵的值字段配置；也可用 `--matrix-value 名称` 指定其中几个。
+- **e-Builder 表单**（`--eb-form`）：取值字段是**系统值**体系，不是矩阵的值字段配置。
+  目前只有「创建者」可直接用名称指定；其余取值请用 `--matrix-value <id>:<名称>:<valueType>` 明写，
+  或用 `--matrix-value-raw '<JSON 数组>'` 整体透传（数组元素形状以设计器实际请求为准）。
+
+### 矩阵相关的「条件」
+
+矩阵相关比另外三类多一层**条件**：拿矩阵自己的**条件列**去比「固定值」或「本表单字段」，只有命中的行才生效。
+落库是行报文里的 `matrixConditionData`（一棵条件树的 JSON 串）。
+
+```bash
+# 一条：所属门店 等于 固定值
+--matrix-condition '{"column":"所属门店","func":"等于","value":"123测试的"}'
+
+# 一条：所属门店 等于 本表单字段（field 走字段表按 id/名解析）
+--matrix-condition '{"column":"所属门店","func":"eq","field":"创建人部门"}'
+
+# 两条 + 任一
+--matrix-condition '{"column":"所属门店","func":"等于","value":"上海门店"}' \
+--matrix-condition '{"column":"所属门店","func":"不属于","value":"临时门店"}' \
+--matrix-condition-relation or
+```
+
+| 参数 | 说明 |
+|---|---|
+| `--matrix-condition <json>` | 一条条件，**可重复**；也可 `@文件` 给一个数组。对象三件套：`column`（条件列的 id 或列名）+ `func` + 右值 |
+| `--matrix-condition-relation` | 条件之间的关系：`and`=所有（默认）/ `or`=任一 |
+| `--matrix-condition-comp-type` | 条件列的组件键。**列类型的组件键目前只实证了「部门」→`Department`**，其余类型（人员/分部/岗位/客户/项目/自定义浏览框）命令会报错要求显式给 |
+| `--matrix-condition-raw <json>` | 整棵树透传（不做校验），形状以设计器请求为准 |
+
+**右值三选一**：
+
+- `"value": "字面值"` —— 固定值。**6 个算子都能配**。
+- `"field": "字段名或 id"` —— 引用**本表单字段**，按字段表解析。
+- `"fieldRef": {"id":"…","compType":"…","text":"…"}` —— 直接给字段描述符。**「创建人部门」这类运行时变量必须用这个** ——
+  它出现在设计器的字段选择器里，但 `ds/fields` 与 `getFormFieldPage` 都查不到；描述符从设计器报文里抄。
+
+> ⚠ **引用本表字段（`field` / `fieldRef`）平台卡两条**，CLI 会当场拦下而不是发出去：
+> ① **算子只能是「等于」**；② **字段类型必须与条件列一致** —— 部门列只能引用部门类型的字段，
+> 文本字段在设计器里根本选不到。所以「所属门店（部门）等于 [创建人部门]」成立，
+> 「所属门店（部门）等于 [名称（文本）]」和「所属门店 不等于 [创建人部门]」都会报错。
+
+算子只有界面下拉那 6 个：**等于 / 不等于 / 属于 / 不属于 / 为空 / 不为空**（`eq` / `neq` / `aggregate` / `unaggregate` / `empty` / `nempty`）。
+其中**只有「等于」是对着真机报文核实的**，其余 5 个是按同一族条件树的码表推的 —— 内容平台会原样存下、回读也一模一样，
+**只会在设计器里露馅**（渲染成 `undefined`）。用它配完请在设计器里过一眼。
+
+两条限制：
+
+- **`--eb-form` 不能配条件** —— e-Builder 表单当矩阵用时没有条件列，给了会直接报错。
+- **右值不能引用明细表字段**（只支持主表字段）。
+
+台账那边的矩阵权限（`form list-permission --add-matrix`）**同一套参数与语义**。
+
+## 权限码
+
+归档权限 `--rights`（可组合，逗号或空格分隔，也可用编号）：
+
+| 编号 | 别名 | 含义 |
+|---|---|---|
+| 5 | `view` / `read` | 归档查看 |
+| 6 | `edit` / `update` | 归档编辑 |
+| 7 | `delete` | 归档删除 |
+
+归档附件权限 `--file-rights`（与上面的查看/编辑/删除**互相独立**，是另一处勾选）：
+
+| 编号 | 别名 | 含义 |
+|---|---|---|
+| 501 | `view` / `read` | 归档附件查看 |
+| 502 | `download` | 归档附件下载 |
+| 503 | `edit` | 归档附件编辑 |
+
+> 归档附件用的是 `501/502/503`，**不是**共享权限的 `401/402/403`，两套别混。
+
+`--file-rights` 不给就不发生成附件权限键，该行只有数据权限。
+
+## 幂等与回读
+
+- 添加前先查一遍：同一个授权对象 + 同一权限组合已存在时直接跳过并报「已存在」，不会重复创建。
+- 保存后按新增 ID 回读，逐项核对 `codeType` / `orgType` / `rightType` / `fileRight` / 创建人关系 / 取值字段映射；
+  `rightType` 与 `fileRight` 按**集合**比对（平台保留提交时的顺序，但顺序不承载语义）。
+- 回读的 `orgTypeName` 会和该类别的预期名称对照（如 `field_employee` 对应「人员字段」）。对不上直接报错 ——
+  那意味着授权对象写错了，不能静默放过。
+- 字段相关这类计算型授权，平台会回 `isShowRebuild=2`，此时按提示执行
+  `e10-cli form permission rebuild <objId> <appId> <权限ID>` —— 等价于在权限行上点【重构】。
+  这一步不做，权限列表是不完整的（界面上表现为该行还要重构）。
+
+## 归档卡片
+
+每个流程还有一个「归档卡片」开关（`0` 关 / `1` 开）。不带 `--set` 时只读；带 `--set` 时先写再回读，以回读值为准。

package/skills/weaver-e10-builder/references/form/guide-form-association.md

@@ -0,0 +1,124 @@
+# 关联页签：目标视图、显示布局与数据筛选
+
+在来源表单的记录页面上新增关联页签，打开已有目标视图，并将当前记录字段作为筛选参数传入。例如：客户信息表 → “全部合同”页签 → 合同信息表的“全部合同”视图。
+
+## 配置前查询
+
+```bash
+e10-cli form association list <objId> <appId>
+e10-cli form association views <objId> <appId>
+e10-cli form association fields <objId> <appId> --view <viewId>
+e10-cli --json form association get <objId> <appId> <associationId>
+```
+
+- `objId` 是放置页签的来源表单，不是目标视图所属表单。
+- `views` 返回目标视图 ID、名称、所属表单。名称重复时必须传 ID。
+- `fields` 分别返回来源字段 `source` 与目标字段 `target`。不要把两端字段 ID 混用。
+- 跨应用通过 `--target-app <appId>` 显式选择，命令验证目标应用菜单树和视图实际归属。
+- `get --json` 的正确写法是全局 `--json`（如上），保留原始权限配置，并额外提供解析后的权限条件 `rules`。
+
+## 创建关联页签
+
+```bash
+e10-cli form association create <objId> <appId> "全部合同" --view <viewId> --layouts 显示 --terminals PC MOBILE --permissions @association-permissions.json --mappings @association-mappings.json
+```
+
+创建时必须明确权限。方案要求所有人可见时，`association-permissions.json` 可写：
+
+```json
+[
+  {
+    "selectedType": "all",
+    "dataid": "0",
+    "levelScope": {"minShowlevel": "", "maxShowlevel": ""},
+    "condition": {"rootdata": ""}
+  }
+]
+```
+
+不要在方案没有要求时默认采用所有人权限。其他组织、角色等权限按平台实际配置提供完整数组；本命令不推断权限对象。
+
+筛选映射文件格式：
+
+```json
+[
+  {"targetField": "关联客户", "sourceField": "客户名称"}
+]
+```
+
+每项含义为“目标视图字段 ← 当前来源记录字段”。支持字段 ID 或唯一显示名称，自动补全 `compType/fieldName/dataIndex` 等元数据。仅支持主表字段到主表字段的映射；明细字段及固定值筛选不在本次支持范围。
+
+上例样本中的配置，不代表所有关联字段都应传名称。目标 EBuilder 字段可能需要记录 ID：应按业务语义选择 `sourceField: "数据ID"` 或指定字段，并用实际记录确认筛选结果。命令不会擅自把用户提供的名称字段改成 ID。
+
+默认启用，默认适用于 PC 和 MOBILE，默认仅显示布局。省略 `--mappings` 表示不添加关联参数；目标视图自身的筛选仍独立生效。创建检测同名页签，重复时停止，改用 `update`。
+
+## 显示布局与其他设置
+
+| 参数 | 含义 |
+|---|---|
+| `--layouts 显示` | `showLayout="0"`：显示布局 |
+| `--layouts 新建` | `showLayout="1"`：新建布局 |
+| `--layouts 编辑` | `showLayout="2"`：仅编辑布局 |
+| `--layouts 显示 新建 编辑` | `showLayout="0,1,2"`：三种布局都显示 |
+| `--layouts none` | 三种布局均不显示 |
+| `--terminals PC MOBILE` | 两端适用；可只传其中一个 |
+| `--enabled true/false` | 启用或停用页签 |
+
+```bash
+e10-cli form association update <objId> <appId> <associationId> --layouts 显示
+e10-cli form association update <objId> <appId> <associationId> --name "相关合同" --terminals PC --enabled true
+e10-cli form association update <objId> <appId> <associationId> --view <newViewId> --mappings @association-mappings.json
+```
+
+`update` 保留未指定属性以及原动作、权限条件和提示。布局、终端参数表示替换对应集合。修改绑定视图且已有映射时必须显式提供新映射（`[]` 可清空），避免原目标表字段被用于新视图。
+
+仅启用或停用页签时，`update --enabled true|false` 使用 `updateIsOpenById` 独立接口并通过列表回读状态，不整包保存关联配置。
+
+## 删除关联页签
+
+```bash
+e10-cli form association delete <objId> <appId> <associationId>
+e10-cli form association delete <objId> <appId> "全部合同"
+```
+
+第 3 个参数可以是关联 ID，也可以是页签名称；按名称删时**名称必须唯一** —— 同名多条会报错并列出各自的 ID，不会替你挑一条删。找不到时同样报错并列出该表单现有的页签。
+
+命令先按列表确认这条页签属于当前表单，删除后回读列表确认它确实消失，成功输出 `verified: true` 和剩余页签数 `remaining`。
+
+删除不可撤销，也没有回收站。删掉后该页签连同它的权限条件一起不再出现在表单上，但**它引用的目标视图本身不受影响**。只想临时下线这个页签时用 `update --enabled false`，不要删。
+
+## 修改和清空关联数据筛选
+
+```bash
+e10-cli form association set-filter <objId> <appId> <associationId> --mappings @association-mappings.json
+e10-cli form association clear-filter <objId> <appId> <associationId>
+```
+
+设置会替换目标动作的全部筛选映射。存在多个视图动作时，用 `--action <actionId>` 明确选择；只修改该动作，其余动作保留。
+
+这里处理的是 `associationActions[].url` 内的 `params`（`nameType/type=FORMFIELDS`），不会修改目标视图的全局过滤，也不会修改页签的权限条件。
+
+## 权限条件是另一项能力
+
+```bash
+e10-cli form association set-condition <objId> <appId> <associationId> --perm 1 --rules @permission-rules.json --logic or
+e10-cli form association clear-condition <objId> <appId> <associationId> --perm 1
+```
+
+这两条操作 `associationPermissions[].condition.rootdata`，规则格式为 `[{"fieldId":"...","func":"contains","value":"..."}]`。`--perm` 为 1 开始的序号或 `selectedType`；支持 `and/or`。此条件按来源表单字段生成，与“目标视图数据筛选映射”分别配置。
+
+平台权限条件读回是明文 JSON，写入需 LZW 压缩。更新布局或数据筛选时也会重新压缩原有权限条件；不要自行传入压缩字符串。
+
+## 验证与计划
+
+保存后回读目标视图、筛选映射、显示布局、终端、动作和权限相关配置，成功输出 `verified: true`。创建响应可能不带顶层 ID，命令通过列表差集和详情确定新关联 ID。若提示已提交但无法匹配，先 `list/get`，不要直接再次创建。
+
+配置回读不等于验证了浏览器展示或实际筛选结果。验收还应打开来源记录的显示/编辑布局，检查页签显示范围，并用已知关联与非关联记录检查目标视图结果。
+
+在计划模板 3.3 中逐项填写：
+
+- 关联页签：来源表单/objId、页签名称/associationId、目标应用/表单/视图 ID、权限依据。
+- 布局与终端：显示布局是否开启、编辑布局是否开启、PC/MOBILE、启用状态。
+- 数据筛选：每条目标字段 ← 来源字段，注明传记录 ID 还是字段值，以及配置回读和实际结果验收情况。
+
+先创建目标视图，再创建依赖它的关联页签；关联 ID、视图 ID、动作 ID 不能互换。未验证的项保留待办，不预先打勾。