weaver-e10-builder 1.6.14 → 1.6.16

package/skill-docs/references/form/guide-form-archive-permission.md

@@ -1,201 +1,201 @@
-# 流程归档权限
-
-「流程归档权限」管的是**某个流程归档之后**，它的数据对谁可见、可改、可删。它和表单的共享权限是两套：
-共享权限按表单配一次，归档权限**按流程各配一套**（同一张表单的不同流程可以不一样），并且多一档「归档附件」权限。
-
-## 命令
-
-```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`）：候选来自**该表单自己的字段**（与设计器字段选择器一致）：
-  - **创建者**（系统值，`valueType=system_creator`）
-  - **人员 / 部门 / 人员范围 / 人员条件 / 人员组织**类型的字段；其中人员字段（Employee）`valueType=resource`
-  - 可直接按字段名指定，如 `--matrix-value 负责人`；其余仍可用 `<id>:<名称>:<valueType>` 明写，
-    或用 `--matrix-value-raw '<JSON 数组>'` 整体透传
-
-### 矩阵相关的「条件」
-
-矩阵相关比另外三类多一层**条件**：拿矩阵自己的**条件列**去比「固定值」或「本表单字段」，只有命中的行才生效。
-落库是行报文里的 `matrixConditionData`（一棵条件树的 JSON 串）。
-真矩阵的条件列来自矩阵配置；**e-Builder 表单的条件列就是它自己的主表字段**（自动从字段表取）。
-
-```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
-
-# e-Builder 表单当矩阵：负责人 不为空
-e10-cli form permission archive add <objId> <appId> --workflow <workflowId> \
-  --target matrix --eb-form 项目任务 \
-  --matrix-value 负责人 \
-  --matrix-condition '{"column":"负责人","func":"不为空"}' \
-  --rights view
-
-# e-Builder 表单当矩阵：所属项目 = 当前记录（「当前项目信息」）
-e10-cli form permission archive add <objId> <appId> --workflow <workflowId> \
-  --target matrix --eb-form 项目任务 \
-  --matrix-value 负责人 \
-  --matrix-condition '{"column":"所属项目","func":"等于","field":"数据ID"}' \
-  --rights view
-```
-
-> 「当前记录」用本表单的系统字段 **数据ID**（`field:"数据ID"`，即 `id=5`）表示，不要写固定值。
-> 关联列（Ebuilder）引用数据ID 是设计器实证的跨类型例外（关联列按字符串比）。
-
-| 参数 | 说明 |
-|---|---|
-| `--matrix-condition <json>` | 一条条件，**可重复**；也可 `@文件` 给一个数组。对象三件套：`column`（条件列的 id 或列名）+ `func` + 右值 |
-| `--matrix-condition-relation` | 条件之间的关系：`and`=所有（默认）/ `or`=任一 |
-| `--matrix-condition-comp-type` | 条件列的组件键。**仅真矩阵需要**（列类型的组件键目前只实证了「部门」→`Department`，其余类型会报错要求显式给）；e-Builder 表单由字段类型自动取 |
-| `--matrix-condition-raw <json>` | 整棵树透传（不做校验），形状以设计器请求为准 |
-
-**右值三选一**：
-
-- `"value": "字面值"` —— 固定值。**6 个算子都能配**。
-- `"field": "字段名或 id"` —— 引用**本表单字段**，按字段表解析。
-- `"fieldRef": {"id":"…","compType":"…","text":"…"}` —— 直接给字段描述符。**「创建人部门」这类运行时变量必须用这个** ——
-  它出现在设计器的字段选择器里，但 `ds/fields` 与 `getFormFieldPage` 都查不到；描述符从设计器报文里抄。
-
-> ⚠ **引用本表字段（`field` / `fieldRef`）平台卡两条**，CLI 会当场拦下而不是发出去：
-> ① **算子只能是「等于」**；② **字段类型必须与条件列一致** —— 部门列只能引用部门类型的字段，
-> 文本字段在设计器里根本选不到。所以「所属门店（部门）等于 [创建人部门]」成立，
-> 「所属门店（部门）等于 [名称（文本）]」和「所属门店 不等于 [创建人部门]」都会报错。
-> 例外：关联列（Ebuilder）可以引用本表单的 **数据ID**（当前记录），用于「所属项目 = 当前项目信息」这类限定。
-
-算子只有界面下拉那 6 个：**等于 / 不等于 / 属于 / 不属于 / 为空 / 不为空**（`eq` / `neq` / `aggregate` / `unaggregate` / `empty` / `nempty`）。
-其中**只有「等于」是对着真机报文核实的**，其余 5 个是按同一族条件树的码表推的 —— 内容平台会原样存下、回读也一模一样，
-**只会在设计器里露馅**（渲染成 `undefined`）。用它配完请在设计器里过一眼。
-
-两条限制：
-
-- **e-Builder 表单也能配条件** —— 条件列取自该表单自己的主表字段，不需要 `--matrix-condition-comp-type`。
-- **右值不能引用明细表字段**（只支持主表字段）。
-
-台账那边的矩阵权限（`form list-permission --add-matrix`）**同一套参数与语义**。
-
-## 权限码
-
-归档权限 `--rights`（可组合，逗号或空格分隔，也可用编号）：
-
-| 编号 | 别名 | 含义 |
-|---|---|---|
-| 5 | `view` / `read` | 归档查看（**系统必选**） |
-| 6 | `edit` / `update` | 归档编辑 |
-| 7 | `delete` | 归档删除 |
-
-> **归档查看是系统默认勾选、界面上不能取消的**。所以 `--rights` 只写 `edit delete` 时，命令会自动把 `view` 并进去（5,6,7），并在输出里提示。
-
-归档附件权限 `--file-rights`（与上面的查看/编辑/删除**互相独立**，是另一处勾选）：
-
-| 编号 | 别名 | 含义 |
-|---|---|---|
-| 501 | `view` / `read` | 归档附件查看（**系统必选**） |
-| 502 | `download` | 归档附件下载 |
-| 503 | `edit` | 归档附件编辑 |
-
-> 归档附件用的是 `501/502/503`，**不是**共享权限的 `401/402/403`，两套别混。
-
-> **归档附件查看同样是系统默认勾选、界面上不能取消的**。所以 `--file-rights` 只写 `download` 时会自动并成 `501,502`；
-> 完全不给 `--file-rights` 时也带 `501` —— 每条归档权限行始终有附件查看。
-
-早先创建、缺少附件查看的行不会自动改写；需要时先 `remove` 再 `add`。
-
-## 幂等与回读
-
-- 添加前先查一遍：同一个授权对象 + 同一权限组合已存在时直接跳过并报「已存在」，不会重复创建。
-- 保存后按新增 ID 回读，逐项核对 `codeType` / `orgType` / `rightType` / `fileRight` / 创建人关系 / 取值字段映射；
-  `rightType` 与 `fileRight` 按**集合**比对（平台保留提交时的顺序，但顺序不承载语义）。
-- 回读的 `orgTypeName` 会和该类别的预期名称对照（如 `field_employee` 对应「人员字段」）。对不上直接报错 ——
-  那意味着授权对象写错了，不能静默放过。
-- 字段相关这类计算型授权，平台会回 `isShowRebuild=2`，此时按提示执行
-  `e10-cli form permission rebuild <objId> <appId> <权限ID>` —— 等价于在权限行上点【重构】。
-  这一步不做，权限列表是不完整的（界面上表现为该行还要重构）。
-
-## 归档卡片
-
-每个流程还有一个「归档卡片」开关（`0` 关 / `1` 开）。不带 `--set` 时只读；带 `--set` 时先写再回读，以回读值为准。
+# 流程归档权限
+
+「流程归档权限」管的是**某个流程归档之后**，它的数据对谁可见、可改、可删。它和表单的共享权限是两套：
+共享权限按表单配一次，归档权限**按流程各配一套**（同一张表单的不同流程可以不一样），并且多一档「归档附件」权限。
+
+## 命令
+
+```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`）：候选来自**该表单自己的字段**（与设计器字段选择器一致）：
+  - **创建者**（系统值，`valueType=system_creator`）
+  - **人员 / 部门 / 人员范围 / 人员条件 / 人员组织**类型的字段；其中人员字段（Employee）`valueType=resource`
+  - 可直接按字段名指定，如 `--matrix-value 负责人`；其余仍可用 `<id>:<名称>:<valueType>` 明写，
+    或用 `--matrix-value-raw '<JSON 数组>'` 整体透传
+
+### 矩阵相关的「条件」
+
+矩阵相关比另外三类多一层**条件**：拿矩阵自己的**条件列**去比「固定值」或「本表单字段」，只有命中的行才生效。
+落库是行报文里的 `matrixConditionData`（一棵条件树的 JSON 串）。
+真矩阵的条件列来自矩阵配置；**e-Builder 表单的条件列就是它自己的主表字段**（自动从字段表取）。
+
+```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
+
+# e-Builder 表单当矩阵：负责人 不为空
+e10-cli form permission archive add <objId> <appId> --workflow <workflowId> \
+  --target matrix --eb-form 项目任务 \
+  --matrix-value 负责人 \
+  --matrix-condition '{"column":"负责人","func":"不为空"}' \
+  --rights view
+
+# e-Builder 表单当矩阵：所属项目 = 当前记录（「当前项目信息」）
+e10-cli form permission archive add <objId> <appId> --workflow <workflowId> \
+  --target matrix --eb-form 项目任务 \
+  --matrix-value 负责人 \
+  --matrix-condition '{"column":"所属项目","func":"等于","field":"数据ID"}' \
+  --rights view
+```
+
+> 「当前记录」用本表单的系统字段 **数据ID**（`field:"数据ID"`，即 `id=5`）表示，不要写固定值。
+> 关联列（Ebuilder）引用数据ID 是设计器实证的跨类型例外（关联列按字符串比）。
+
+| 参数 | 说明 |
+|---|---|
+| `--matrix-condition <json>` | 一条条件，**可重复**；也可 `@文件` 给一个数组。对象三件套：`column`（条件列的 id 或列名）+ `func` + 右值 |
+| `--matrix-condition-relation` | 条件之间的关系：`and`=所有（默认）/ `or`=任一 |
+| `--matrix-condition-comp-type` | 条件列的组件键。**仅真矩阵需要**（列类型的组件键目前只实证了「部门」→`Department`，其余类型会报错要求显式给）；e-Builder 表单由字段类型自动取 |
+| `--matrix-condition-raw <json>` | 整棵树透传（不做校验），形状以设计器请求为准 |
+
+**右值三选一**：
+
+- `"value": "字面值"` —— 固定值。**6 个算子都能配**。
+- `"field": "字段名或 id"` —— 引用**本表单字段**，按字段表解析。
+- `"fieldRef": {"id":"…","compType":"…","text":"…"}` —— 直接给字段描述符。**「创建人部门」这类运行时变量必须用这个** ——
+  它出现在设计器的字段选择器里，但 `ds/fields` 与 `getFormFieldPage` 都查不到；描述符从设计器报文里抄。
+
+> ⚠ **引用本表字段（`field` / `fieldRef`）平台卡两条**，CLI 会当场拦下而不是发出去：
+> ① **算子只能是「等于」**；② **字段类型必须与条件列一致** —— 部门列只能引用部门类型的字段，
+> 文本字段在设计器里根本选不到。所以「所属门店（部门）等于 [创建人部门]」成立，
+> 「所属门店（部门）等于 [名称（文本）]」和「所属门店 不等于 [创建人部门]」都会报错。
+> 例外：关联列（Ebuilder）可以引用本表单的 **数据ID**（当前记录），用于「所属项目 = 当前项目信息」这类限定。
+
+算子只有界面下拉那 6 个：**等于 / 不等于 / 属于 / 不属于 / 为空 / 不为空**（`eq` / `neq` / `aggregate` / `unaggregate` / `empty` / `nempty`）。
+其中**只有「等于」是对着真机报文核实的**，其余 5 个是按同一族条件树的码表推的 —— 内容平台会原样存下、回读也一模一样，
+**只会在设计器里露馅**（渲染成 `undefined`）。用它配完请在设计器里过一眼。
+
+两条限制：
+
+- **e-Builder 表单也能配条件** —— 条件列取自该表单自己的主表字段，不需要 `--matrix-condition-comp-type`。
+- **右值不能引用明细表字段**（只支持主表字段）。
+
+台账那边的矩阵权限（`form list-permission --add-matrix`）**同一套参数与语义**。
+
+## 权限码
+
+归档权限 `--rights`（可组合，逗号或空格分隔，也可用编号）：
+
+| 编号 | 别名 | 含义 |
+|---|---|---|
+| 5 | `view` / `read` | 归档查看（**系统必选**） |
+| 6 | `edit` / `update` | 归档编辑 |
+| 7 | `delete` | 归档删除 |
+
+> **归档查看是系统默认勾选、界面上不能取消的**。所以 `--rights` 只写 `edit delete` 时，命令会自动把 `view` 并进去（5,6,7），并在输出里提示。
+
+归档附件权限 `--file-rights`（与上面的查看/编辑/删除**互相独立**，是另一处勾选）：
+
+| 编号 | 别名 | 含义 |
+|---|---|---|
+| 501 | `view` / `read` | 归档附件查看（**系统必选**） |
+| 502 | `download` | 归档附件下载 |
+| 503 | `edit` | 归档附件编辑 |
+
+> 归档附件用的是 `501/502/503`，**不是**共享权限的 `401/402/403`，两套别混。
+
+> **归档附件查看同样是系统默认勾选、界面上不能取消的**。所以 `--file-rights` 只写 `download` 时会自动并成 `501,502`；
+> 完全不给 `--file-rights` 时也带 `501` —— 每条归档权限行始终有附件查看。
+
+早先创建、缺少附件查看的行不会自动改写；需要时先 `remove` 再 `add`。
+
+## 幂等与回读
+
+- 添加前先查一遍：同一个授权对象 + 同一权限组合已存在时直接跳过并报「已存在」，不会重复创建。
+- 保存后按新增 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/skill-docs/references/form/guide-form-base-setting.md

@@ -0,0 +1,78 @@
+# 表单功能设置（字段设置 / 数据设置）
+
+表单管理页「功能设置」里按段保存的表单级设置，通过 `e10-cli form base-setting` 读写。命令作用于平台的 `formmanage/getForm|saveForm`，用 `baseSettingPartType` 区分分段：
+
+```bash
+# 字段设置（--part field，缺省）
+e10-cli form base-setting get <objId> <appId> [--part field]
+e10-cli form base-setting set <objId> <appId> --browser-latest-title on|off
+
+# 数据设置（--part data）
+e10-cli form base-setting get <objId> <appId> --part data
+e10-cli form base-setting set <objId> <appId> --file-permission on|off
+```
+
+`set` 不传 `--part` 时按选项自动推断属于哪一段；同时给两段的选项会直接报错，请分开执行。
+
+## 字段设置
+
+| 开关 | 选项 | 落库键 | 说明 |
+|---|---|---|---|
+| 浏览框数据获取最新标题 | `--browser-latest-title` | `currentRelDetail` | 关联/浏览类字段的标题栏显示字段从 A 改成 B 后，关闭时历史数据仍显示 A，开启后按最新配置显示 B |
+
+```bash
+e10-cli form base-setting set 1308312807294181377 1308312176057171969 --browser-latest-title on
+```
+
+## 数据设置 · 字段联动设置
+
+| 项 | 选项 | 落库键 | 取值 |
+|---|---|---|---|
+| 设置类型 | `--linkage-mode` | `linkageFilePermissionType` | `system` 读取系统设置（缺省）/ `custom` 自定义设置 |
+| 启用附件鉴权 | `--file-permission` | `linkageFilePermission` | on / off |
+| 免登场景执行联动 | `--login-free-execute` | `fdLinkageNoLoginExecute` | on / off |
+
+```bash
+e10-cli form base-setting set <objId> <appId> --file-permission on --login-free-execute on
+```
+
+## 数据设置 · 明细表按钮设置
+
+| 项 | 选项 | 落库键 | 取值 |
+|---|---|---|---|
+| 设置类型 | `--detail-button-mode` | `subBtnType` | `system` 读取系统设置（缺省）/ `custom` 自定义设置 |
+| 批量操作按钮常显 | `--detail-batch-always-visible` | `fixBatchOperate` | on / off |
+| 行操作按钮位置 | `--detail-row-action-position` | `rowActionPosition` | `float` 明细行上 / `inline` 明细行内 |
+
+```bash
+e10-cli form base-setting set <objId> <appId> \
+  --detail-button-mode custom --detail-batch-always-visible on --detail-row-action-position inline
+```
+
+## 数据设置 · 数据日志设置
+
+| 项 | 选项 | 落库键 | 取值 |
+|---|---|---|---|
+| 设置类型 | `--data-log-mode` | `insertDataLogType` | `system` 读取系统设置（缺省）/ `custom` 自定义设置 |
+| 记录表单日志 | `--record-form-log` | `needDataLog` | on / off |
+| 新建数据记录日志 | `--insert-data-log` | `insertDataLog` | on / off |
+
+```bash
+e10-cli form base-setting set <objId> <appId> --record-form-log on --insert-data-log on
+```
+
+⚠ 选项名用 `login-free-execute` 而不是 `no-login-execute`：Commander 会把 `--no-` 开头的长选项当成某个开关的取反。
+
+## 设置类型（读取系统设置 / 自定义设置）
+
+每段上方都有一个「设置类型」：`system`=读取系统设置、`custom`=自定义设置。**段内单项只有在自定义设置下才按本表单的取值生效**；读取系统设置时平台直接忽略这些单项（保存报文里连键都不出现）。
+
+- 改段内单项时，如果该段当前不是自定义设置，命令会连同「设置类型」一起切成 `custom`，并在输出里标注「自动切换」。
+- 想显式切回读取系统设置，用 `--linkage-mode system` / `--detail-button-mode system` / `--data-log-mode system`；此时不能同时修改该段其它单项，命令会直接报错。
+- `get` 在读取系统设置状态下，段内单项显示为「继承系统设置」，不拿表单里存的旧值冒充当前生效值。
+
+## 写入规则
+
+- 命令先读整段设置，只改点名的项，其余键原样回写；保存后逐个回读确认落库。
+- 值未变化时不发保存请求。
+- `--json` 输出完整段对象与本命令已收录项的当前值，便于核对其它键。

package/skill-docs/references/form/guide-form-message.md

@@ -1,74 +1,74 @@
-# 消息提醒（表单数据提醒）
-
-表单数据发生**新建 / 修改 / 删除**时，按配置把消息推给指定的人。位置在 **表单模型 → 消息提醒 → 表单数据提醒**（同一页面还有个「动作流提醒」页签，是另一条链路）。
-
-一条提醒由这几样组成：**触发时机 + 推送渠道 + 标题内容 + 落地页 + 提醒对象**，整体可**启用 / 停用**。
-
-## 命令
-
-| 命令 | 用途 |
-|---|---|
-| `form message list <appId> [--obj-id <objId>] [--keyword <kw>]` | 列出提醒。不传 `--obj-id` 就是把整个应用的列出来 |
-| `form message get <appId> <triggerId>` | 看单条，含**推送渠道**与提醒对象 |
-| `form message add <appId> <objId> --name <名称>` | 新建 |
-| `form message edit <appId> <triggerId> [...]` | 修改，没传的项保持原值 |
-| `form message delete <appId> <triggerId>` | 删除（不可逆） |
-| `form message enable \| disable <appId> <triggerId>` | 启用 / 停用 |
-
-`get` / `edit` / `delete` / `enable` / `disable` 的 `--obj-id` 可以省 —— 不传会自动反查这条提醒挂在哪张表单上。
-
-### `add` / `edit` 的选项
-
-| 选项 | 说明 |
-|---|---|
-| `--type <类型>` | 触发时机：`新建` / `修改` / `删除`，逗号分隔，也可以写 `all`。缺省 `all` |
-| `--channels <渠道>` | 推送渠道：`im`（站内）/ `cloud-bridge`（云桥）/ `email`（邮件）/ `sms`（短信），逗号分隔，也可以写 `all`。**缺省只发 `im`** —— 不会替你打开短信 |
-| `--title` / `--content` | 提醒标题与内容。纯文本会自动包成富文本；不传时标题取提醒名称、内容按触发时机生成一句话（如「数据新建、修改了」） |
-| `--pc-link` / `--mobile-link` | 点开提醒后的落地页，缺省是这条记录的表单卡片页 |
-| `--rule <spec>` | 提醒对象，可重复（写法见下） |
-| `--rule-json '<json>'` | 提醒对象原始报文，逃生口 |
-| `--disabled` | 建成即停用（`edit` 用 `--enable` / `--disable`） |
-
-## 提醒对象怎么写
-
-五类：`user` 人员、`dept` 部门、`role` 角色、`company` 分部、`matrix` 矩阵。
-
-写法是 `<类型>:<值>[,name=<显示名>][,extra=0|1]`：
-
-- **`<类型>:<名字>`** —— 工具按名字去查。**同名多条会报错并列出候选（带 ID）**，不会替你挑一条，免得配错人还看不出来。
-- **`<类型>:<ID>,name=<名字>`** —— 名字有歧义、或手上只有 ID 时用这个：`<值>` 直接当 ID 用，不查。
-
-`extra` 是组织范围上的附加项 —— 页面上部门 / 分部的提醒对象显示成「营销部:本部门含兼职人员」就是它。部门 / 分部缺省开、人员 / 角色 / 矩阵缺省关，需要时显式覆盖。
-
-### 矩阵提醒对象（`matrix`）
-
-```bash
-form message add <appId> <objId> --name 有新数据了 --type 新建 --channels im \
-  --rule matrix:门店经理矩阵
-```
-
-矩阵那条报文的**键集合与其余四类完全不同**（真机报文坐实）：只有 `selectedType` / `containExtra` / `name` /
-`jobLevelText` / `jobLevelTextSpan` / `matrixValueRelation` / `matrixConditionData` / `ruledetail` / `id`，
-**没有** `levelScope` / `fieldtype` / `roleLevel` / `relation` 那一套，而且**不带 `ruletype`** —— 平台靠
-`selectedType='matrix'` 认它。工具会按矩阵的**值字段**自动构造 `matrixValueRelation`
-（决定用哪一列匹配当前用户），矩阵没配值字段时直接报错。
-
-> ⚠ **矩阵的「条件」这一层暂时配不了**。设计器能给矩阵提醒对象再加条件（`matrixConditionData`），
-> 但那个对话框里的右值是一种新形态（`type:"custom"` + 一组选中的对象数组 + `customSelect`），
-> CLI 还没有对应的构造；报文里这个键会发空串。要带条件的，先去设计器里配。
-
-```
-form message add <appId> <objId> --name 有新数据了 \
-  --type 新建 --channels im,email \
-  --rule user:任来仪 \
-  --rule dept:营销部 \
-  --rule role:会议管理员
-```
-
-## 几个容易踩的点
-
-- **列表是应用级的**：这条接口按应用列，`--obj-id` 是命令在**本地按表单收口**（平台不认那个过滤参数，传了也照回全应用）。
-- **渠道勾选要单条看**：列表和详情返回里都不带渠道，`form message get` 会额外读一次补上。
-- **停用不等于删除**：`disable` 只是不再推，配置留着；`delete` 才是真的没了。
-- **修改是整份保存**：`edit` 先读回现有配置再合并你改的项，**没传的项不会被清空**。提醒对象默认保持原样，要整份替换就传 `--rule`，要清空传 `--clear-rules`。
-- **提醒名称**就是列表里显示的那个名字，建的时候起的 `--name` 别随手写。
+# 消息提醒（表单数据提醒）
+
+表单数据发生**新建 / 修改 / 删除**时，按配置把消息推给指定的人。位置在 **表单模型 → 消息提醒 → 表单数据提醒**（同一页面还有个「动作流提醒」页签，是另一条链路）。
+
+一条提醒由这几样组成：**触发时机 + 推送渠道 + 标题内容 + 落地页 + 提醒对象**，整体可**启用 / 停用**。
+
+## 命令
+
+| 命令 | 用途 |
+|---|---|
+| `form message list <appId> [--obj-id <objId>] [--keyword <kw>]` | 列出提醒。不传 `--obj-id` 就是把整个应用的列出来 |
+| `form message get <appId> <triggerId>` | 看单条，含**推送渠道**与提醒对象 |
+| `form message add <appId> <objId> --name <名称>` | 新建 |
+| `form message edit <appId> <triggerId> [...]` | 修改，没传的项保持原值 |
+| `form message delete <appId> <triggerId>` | 删除（不可逆） |
+| `form message enable \| disable <appId> <triggerId>` | 启用 / 停用 |
+
+`get` / `edit` / `delete` / `enable` / `disable` 的 `--obj-id` 可以省 —— 不传会自动反查这条提醒挂在哪张表单上。
+
+### `add` / `edit` 的选项
+
+| 选项 | 说明 |
+|---|---|
+| `--type <类型>` | 触发时机：`新建` / `修改` / `删除`，逗号分隔，也可以写 `all`。缺省 `all` |
+| `--channels <渠道>` | 推送渠道：`im`（站内）/ `cloud-bridge`（云桥）/ `email`（邮件）/ `sms`（短信），逗号分隔，也可以写 `all`。**缺省只发 `im`** —— 不会替你打开短信 |
+| `--title` / `--content` | 提醒标题与内容。纯文本会自动包成富文本；不传时标题取提醒名称、内容按触发时机生成一句话（如「数据新建、修改了」） |
+| `--pc-link` / `--mobile-link` | 点开提醒后的落地页，缺省是这条记录的表单卡片页 |
+| `--rule <spec>` | 提醒对象，可重复（写法见下） |
+| `--rule-json '<json>'` | 提醒对象原始报文，逃生口 |
+| `--disabled` | 建成即停用（`edit` 用 `--enable` / `--disable`） |
+
+## 提醒对象怎么写
+
+五类：`user` 人员、`dept` 部门、`role` 角色、`company` 分部、`matrix` 矩阵。
+
+写法是 `<类型>:<值>[,name=<显示名>][,extra=0|1]`：
+
+- **`<类型>:<名字>`** —— 工具按名字去查。**同名多条会报错并列出候选（带 ID）**，不会替你挑一条，免得配错人还看不出来。
+- **`<类型>:<ID>,name=<名字>`** —— 名字有歧义、或手上只有 ID 时用这个：`<值>` 直接当 ID 用，不查。
+
+`extra` 是组织范围上的附加项 —— 页面上部门 / 分部的提醒对象显示成「营销部:本部门含兼职人员」就是它。部门 / 分部缺省开、人员 / 角色 / 矩阵缺省关，需要时显式覆盖。
+
+### 矩阵提醒对象（`matrix`）
+
+```bash
+form message add <appId> <objId> --name 有新数据了 --type 新建 --channels im \
+  --rule matrix:门店经理矩阵
+```
+
+矩阵那条报文的**键集合与其余四类完全不同**（真机报文坐实）：只有 `selectedType` / `containExtra` / `name` /
+`jobLevelText` / `jobLevelTextSpan` / `matrixValueRelation` / `matrixConditionData` / `ruledetail` / `id`，
+**没有** `levelScope` / `fieldtype` / `roleLevel` / `relation` 那一套，而且**不带 `ruletype`** —— 平台靠
+`selectedType='matrix'` 认它。工具会按矩阵的**值字段**自动构造 `matrixValueRelation`
+（决定用哪一列匹配当前用户），矩阵没配值字段时直接报错。
+
+> ⚠ **矩阵的「条件」这一层暂时配不了**。设计器能给矩阵提醒对象再加条件（`matrixConditionData`），
+> 但那个对话框里的右值是一种新形态（`type:"custom"` + 一组选中的对象数组 + `customSelect`），
+> CLI 还没有对应的构造；报文里这个键会发空串。要带条件的，先去设计器里配。
+
+```
+form message add <appId> <objId> --name 有新数据了 \
+  --type 新建 --channels im,email \
+  --rule user:任来仪 \
+  --rule dept:营销部 \
+  --rule role:会议管理员
+```
+
+## 几个容易踩的点
+
+- **列表是应用级的**：这条接口按应用列，`--obj-id` 是命令在**本地按表单收口**（平台不认那个过滤参数，传了也照回全应用）。
+- **渠道勾选要单条看**：列表和详情返回里都不带渠道，`form message get` 会额外读一次补上。
+- **停用不等于删除**：`disable` 只是不再推，配置留着；`delete` 才是真的没了。
+- **修改是整份保存**：`edit` 先读回现有配置再合并你改的项，**没传的项不会被清空**。提醒对象默认保持原样，要整份替换就传 `--rule`，要清空传 `--clear-rules`。
+- **提醒名称**就是列表里显示的那个名字，建的时候起的 `--name` 别随手写。