weaver-e10-builder 1.6.16 → 1.7.0

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` 别随手写。

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

@@ -1,185 +1,185 @@
-# 表单创建权限 / 共享权限
-
-表单权限分两块：
-
-- **创建权限**：谁能新建这张表单的记录（`codeType=obj`）。
-- **共享权限**：谁能看到、编辑、删除已有记录，以及附件、布局、条件和跨表单同步（`codeType=obj_data_admin` 等）。
-
-共享权限除了「通用对象」，还支持**创建人相关 / 字段相关 / 矩阵相关 / 政务单位相关**四类；归档权限按流程单独配置，见 `guide-form-archive-permission.md`，不要和这里混用。
-
-## 命令
-
-```bash
-# 查看全部权限（创建 + 共享 + 评论 + 导入导出 + 归档）
-e10-cli form permission list <objId> <appId>
-
-# 创建权限
-e10-cli form permission create add <objId> <appId> \
-  --org-type <类型> [--org-id <id>] [--org-name <名称>] \
-  [--layout <布局id>] [--same-layout on|off] [--layout-order 0] [--desc "描述"]
-
-e10-cli form permission create update <objId> <appId> --right-id <权限id> [同上设置项]
-e10-cli form permission create show <objId> <appId> --right-id <权限id>
-
-# 共享权限
-e10-cli form permission data add <objId> <appId> \
-  --target <general|creator|field|matrix|govern> \
-  --rights <view/edit/delete/comment...> [设置项]
-
-e10-cli form permission data update <objId> <appId> --right-id <权限id> [要改的项]
-e10-cli form permission data show <objId> <appId> --right-id <权限id>
-
-# 删除（创建/共享/其余分类通用）
-e10-cli form permission remove <objId> <appId> --right-id <id[,id...]>
-```
-
-修改采用「读整行 → 只改点名项 → 整体回写 → 回读点名键」，没点名的布局、条件、同步列表保持原样。
-
-## 授权对象类型
-
-### 通用对象（`--target general`，默认）
-
-| `--org-type` | 含义 |
-|---|---|
-| `all` | 所有人（orgId 自动 0） |
-| `employee` | 人员 |
-| `department` | 部门 |
-| `company` | 分部 |
-| `role` | 角色 |
-| `group` | 群组 |
-| `post` | 岗位 |
-| `partTime` | 兼职岗位 |
-| `grade` | 职级 |
-| `external` | 外部联系人 |
-| `externalAll` | 所有外部联系人（orgId 自动 0） |
-
-除 `all` / `externalAll` 外都要给 `--org-id`，名称只用于回显，缺省用类型名。
-人员/部门/分部授权可加 `--creator-related 0~7` 指定上下级关系；岗位/角色等可加
-`--contain-extra on` 表示含兼职人员。
-
-### 创建人相关（`--target creator`）
-
-```bash
-e10-cli form permission data add <objId> <appId> --target creator \
-  --creator-related 1 --rights view edit
-```
-
-`--creator-related`：0 本人/本部门/本分部；1 直接上级及所有下级；2 所有上级；
-3 所有下级；4 所有上级；5 本岗位；6 直接下属；7 上级部门。
-
-### 字段相关（`--target field`）
-
-```bash
-e10-cli form permission data add <objId> <appId> --target field \
-  --field 负责人 --rights view edit
-```
-
-`--field` 可给字段 id 或字段名（重名会报错，改用 id）。字段属于明细表时补 `--sub-form-id`。
-`orgType` 由字段组件类型推出（人员/部门/分部/岗位/关联 ebuilder 等）；其余字段类型用
-`--org-type field_xxx` 显式指定，可选值见 `form permission archive` 文档。
-
-### 矩阵相关（`--target matrix`）
-
-```bash
-# 真矩阵：取值字段按名称取矩阵自己配置的值字段
-e10-cli form permission data add <objId> <appId> --target matrix \
-  --matrix 部门负责人矩阵 --matrix-value 负责人 --rights view
-
-# e-Builder 表单当矩阵：默认取「创建者」，也可指定人员字段
-e10-cli form permission data add <objId> <appId> --target matrix \
-  --eb-form 项目任务 --matrix-value 负责人 --rights view
-
-# 取值字段/条件特殊时用原始 JSON
---matrix-value-raw '[{"valueId":"...","valueName":"...","valueType":"resource"}]'
---matrix-condition-raw '{"...":"..."}'
-```
-
-### 政务单位相关（`--target govern`）
-
-```bash
-e10-cli form permission data add <objId> <appId> --target govern --rights view \
-  --govern-json '{"objectType":"1","object":"1","dimensionId":"<维度id>","relationType":"1"}'
-```
-
-`governDataRelation` 直接按条件 JSON 写入；`objectType`：1 指定单位、2 指定职务、3 表单字段。
-
-## 通用设置
-
-| 选项 | 权限字段 | 说明 |
-|---|---|---|
-| `--layout <id>` | `layoutId` | 关联 PC 布局 |
-| `--mobile-layout <id>` | `mobileLayoutId` | 关联移动布局 |
-| `--edit-layout <id>` | `editLayoutId` | 编辑布局 |
-| `--mobile-edit-layout <id>` | `mobileEditLayoutId` | 移动端编辑布局 |
-| `--same-layout on\|off` | `isPcMobileSameLayout` | PC 移动统一布局；开时移动布局自动沿用 PC 布局 |
-| `--layout-order <n>` | `layoutOrder` | 优先级，0 最高；同一个人命中多条权限时按它决定用哪个布局 |
-| `--desc <文本>` | `rightDesc` | 权限描述 |
-| `--desc-label-id <id>` | `rightDescLabelId` | 多语言描述标签；纯文本描述留空 |
-| `--condition <json>` | `conditionData` | 权限条件（条件树 JSON 或 `@文件`）；写入前按平台算法压缩 |
-| `--clear-condition` | `conditionData` | 清空条件 |
-| `--org-virtual-type <type>` | `orgVirtualType` | 组织维度 |
-| `--contain-extra on\|off` | `containExtra` | 岗位/角色等授权时是否含兼职人员 |
-| `--min-seclevel <n>` / `--max-seclevel <n>` | `minShowlevel` / `maxShowlevel` | 安全级别范围 0~100 |
-| `--exclude-obj <json\|@file>` | `excludeObj` | 排除项 |
-| `--file-rights view download edit` | `fileRight` | 附件权限 401 查看 / 402 下载 / 403 编辑；给下载或编辑会自动补查看 |
-| `--file-right-type temporary\|insert` | `fileRightType` | 临时赋权（不插入权限数据）/ 插入赋权 |
-| `--sync-forms <objId...>` | `syncPermissionList` | 同步至其他表单（整体替换） |
-
-创建权限没有附件权限；共享权限默认 `401,402`（查看 + 下载）、`temporary`。
-
-### 权限条件
-
-`--condition` 的内容就是权限页「条件设计器」保存的条件树，原样给 JSON 即可：
-
-```bash
-e10-cli form permission data update <objId> <appId> --right-id <id> \
-  --condition '{"type":"and","children":[...]}'
-```
-
-长条件建议落文件：`--condition @condition.json`。命令负责按平台算法压缩后再提交，读回时会解压比较，确保没有被改写或吞掉。
-
-### 同步至其他表单
-
-```bash
-e10-cli form permission data update <objId> <appId> --right-id <id> \
-  --sync-forms <目标表单objId> [更多objId...]
-```
-
-这是**整体替换**：给几个就同步到几个，之前同步过但这次没给的会被移除。
-`data show` 会列出当前同步到哪些表单。
-
-## 导入导出权限
-
-导入导出是**独立分类**（`data_imp_exp`），不在共享权限里。命令：
-
-```bash
-e10-cli form permission imp-exp list <objId> <appId>
-
-e10-cli form permission imp-exp add <objId> <appId> \
-  --org-type <类型> [--org-id <id>] \
-  --rights export import delete-import \
-  [--update-import] [--export-details] [--export-attachment] \
-  [--export-field-range listShowField|allField]
-
-e10-cli form permission imp-exp update <objId> <appId> --right-id <id> [要改的项]
-e10-cli form permission imp-exp show <objId> <appId> --right-id <id>
-```
-
-- `rights`：`export=8` 导出、`import=9` 导入、`delete-import=93` 删除导入数据；93 必须与 9 同选。
-- `--update-import`：允许更新导入（`importType` 加 1）；勾 93 时自动带更新导入。
-- 授权对象与共享权限同一套 11 种通用对象（含兼职岗位、职级、外部联系人、所有外部联系人）。
-- `--export-field-range`：`listShowField` 列表显示字段（默认）/ `allField` 全部字段。
-- `--export-details` / `--export-attachment`：导出明细、导出附件。
-- 修改只改点名项，整行回写并回读。
-
-导入导出权限**不提供**权限描述、更新导入校验数据编辑权限、导入关联布局、优先级、同步至其他表单这些配置项。
-
-## 保存后重构
-
-某些改动（尤其是字段相关、矩阵相关和条件）会让平台标记 `isShowRebuild=2`。命令会提示：
-
-```bash
-e10-cli form permission rebuild <objId> <appId> <权限id>
-```
-
-重构只影响权限数据的生效计算，不改权限配置本身。
+# 表单创建权限 / 共享权限
+
+表单权限分两块：
+
+- **创建权限**：谁能新建这张表单的记录（`codeType=obj`）。
+- **共享权限**：谁能看到、编辑、删除已有记录，以及附件、布局、条件和跨表单同步（`codeType=obj_data_admin` 等）。
+
+共享权限除了「通用对象」，还支持**创建人相关 / 字段相关 / 矩阵相关 / 政务单位相关**四类；归档权限按流程单独配置，见 `guide-form-archive-permission.md`，不要和这里混用。
+
+## 命令
+
+```bash
+# 查看全部权限（创建 + 共享 + 评论 + 导入导出 + 归档）
+e10-cli form permission list <objId> <appId>
+
+# 创建权限
+e10-cli form permission create add <objId> <appId> \
+  --org-type <类型> [--org-id <id>] [--org-name <名称>] \
+  [--layout <布局id>] [--same-layout on|off] [--layout-order 0] [--desc "描述"]
+
+e10-cli form permission create update <objId> <appId> --right-id <权限id> [同上设置项]
+e10-cli form permission create show <objId> <appId> --right-id <权限id>
+
+# 共享权限
+e10-cli form permission data add <objId> <appId> \
+  --target <general|creator|field|matrix|govern> \
+  --rights <view/edit/delete/comment...> [设置项]
+
+e10-cli form permission data update <objId> <appId> --right-id <权限id> [要改的项]
+e10-cli form permission data show <objId> <appId> --right-id <权限id>
+
+# 删除（创建/共享/其余分类通用）
+e10-cli form permission remove <objId> <appId> --right-id <id[,id...]>
+```
+
+修改采用「读整行 → 只改点名项 → 整体回写 → 回读点名键」，没点名的布局、条件、同步列表保持原样。
+
+## 授权对象类型
+
+### 通用对象（`--target general`，默认）
+
+| `--org-type` | 含义 |
+|---|---|
+| `all` | 所有人（orgId 自动 0） |
+| `employee` | 人员 |
+| `department` | 部门 |
+| `company` | 分部 |
+| `role` | 角色 |
+| `group` | 群组 |
+| `post` | 岗位 |
+| `partTime` | 兼职岗位 |
+| `grade` | 职级 |
+| `external` | 外部联系人 |
+| `externalAll` | 所有外部联系人（orgId 自动 0） |
+
+除 `all` / `externalAll` 外都要给 `--org-id`，名称只用于回显，缺省用类型名。
+人员/部门/分部授权可加 `--creator-related 0~7` 指定上下级关系；岗位/角色等可加
+`--contain-extra on` 表示含兼职人员。
+
+### 创建人相关（`--target creator`）
+
+```bash
+e10-cli form permission data add <objId> <appId> --target creator \
+  --creator-related 1 --rights view edit
+```
+
+`--creator-related`：0 本人/本部门/本分部；1 直接上级及所有下级；2 所有上级；
+3 所有下级；4 所有上级；5 本岗位；6 直接下属；7 上级部门。
+
+### 字段相关（`--target field`）
+
+```bash
+e10-cli form permission data add <objId> <appId> --target field \
+  --field 负责人 --rights view edit
+```
+
+`--field` 可给字段 id 或字段名（重名会报错，改用 id）。字段属于明细表时补 `--sub-form-id`。
+`orgType` 由字段组件类型推出（人员/部门/分部/岗位/关联 ebuilder 等）；其余字段类型用
+`--org-type field_xxx` 显式指定，可选值见 `form permission archive` 文档。
+
+### 矩阵相关（`--target matrix`）
+
+```bash
+# 真矩阵：取值字段按名称取矩阵自己配置的值字段
+e10-cli form permission data add <objId> <appId> --target matrix \
+  --matrix 部门负责人矩阵 --matrix-value 负责人 --rights view
+
+# e-Builder 表单当矩阵：默认取「创建者」，也可指定人员字段
+e10-cli form permission data add <objId> <appId> --target matrix \
+  --eb-form 项目任务 --matrix-value 负责人 --rights view
+
+# 取值字段/条件特殊时用原始 JSON
+--matrix-value-raw '[{"valueId":"...","valueName":"...","valueType":"resource"}]'
+--matrix-condition-raw '{"...":"..."}'
+```
+
+### 政务单位相关（`--target govern`）
+
+```bash
+e10-cli form permission data add <objId> <appId> --target govern --rights view \
+  --govern-json '{"objectType":"1","object":"1","dimensionId":"<维度id>","relationType":"1"}'
+```
+
+`governDataRelation` 直接按条件 JSON 写入；`objectType`：1 指定单位、2 指定职务、3 表单字段。
+
+## 通用设置
+
+| 选项 | 权限字段 | 说明 |
+|---|---|---|
+| `--layout <id>` | `layoutId` | 关联 PC 布局 |
+| `--mobile-layout <id>` | `mobileLayoutId` | 关联移动布局 |
+| `--edit-layout <id>` | `editLayoutId` | 编辑布局 |
+| `--mobile-edit-layout <id>` | `mobileEditLayoutId` | 移动端编辑布局 |
+| `--same-layout on\|off` | `isPcMobileSameLayout` | PC 移动统一布局；开时移动布局自动沿用 PC 布局 |
+| `--layout-order <n>` | `layoutOrder` | 优先级，0 最高；同一个人命中多条权限时按它决定用哪个布局 |
+| `--desc <文本>` | `rightDesc` | 权限描述 |
+| `--desc-label-id <id>` | `rightDescLabelId` | 多语言描述标签；纯文本描述留空 |
+| `--condition <json>` | `conditionData` | 权限条件（条件树 JSON 或 `@文件`）；写入前按平台算法压缩 |
+| `--clear-condition` | `conditionData` | 清空条件 |
+| `--org-virtual-type <type>` | `orgVirtualType` | 组织维度 |
+| `--contain-extra on\|off` | `containExtra` | 岗位/角色等授权时是否含兼职人员 |
+| `--min-seclevel <n>` / `--max-seclevel <n>` | `minShowlevel` / `maxShowlevel` | 安全级别范围 0~100 |
+| `--exclude-obj <json\|@file>` | `excludeObj` | 排除项 |
+| `--file-rights view download edit` | `fileRight` | 附件权限 401 查看 / 402 下载 / 403 编辑；给下载或编辑会自动补查看 |
+| `--file-right-type temporary\|insert` | `fileRightType` | 临时赋权（不插入权限数据）/ 插入赋权 |
+| `--sync-forms <objId...>` | `syncPermissionList` | 同步至其他表单（整体替换） |
+
+创建权限没有附件权限；共享权限默认 `401,402`（查看 + 下载）、`temporary`。
+
+### 权限条件
+
+`--condition` 的内容就是权限页「条件设计器」保存的条件树，原样给 JSON 即可：
+
+```bash
+e10-cli form permission data update <objId> <appId> --right-id <id> \
+  --condition '{"type":"and","children":[...]}'
+```
+
+长条件建议落文件：`--condition @condition.json`。命令负责按平台算法压缩后再提交，读回时会解压比较，确保没有被改写或吞掉。
+
+### 同步至其他表单
+
+```bash
+e10-cli form permission data update <objId> <appId> --right-id <id> \
+  --sync-forms <目标表单objId> [更多objId...]
+```
+
+这是**整体替换**：给几个就同步到几个，之前同步过但这次没给的会被移除。
+`data show` 会列出当前同步到哪些表单。
+
+## 导入导出权限
+
+导入导出是**独立分类**（`data_imp_exp`），不在共享权限里。命令：
+
+```bash
+e10-cli form permission imp-exp list <objId> <appId>
+
+e10-cli form permission imp-exp add <objId> <appId> \
+  --org-type <类型> [--org-id <id>] \
+  --rights export import delete-import \
+  [--update-import] [--export-details] [--export-attachment] \
+  [--export-field-range listShowField|allField]
+
+e10-cli form permission imp-exp update <objId> <appId> --right-id <id> [要改的项]
+e10-cli form permission imp-exp show <objId> <appId> --right-id <id>
+```
+
+- `rights`：`export=8` 导出、`import=9` 导入、`delete-import=93` 删除导入数据；93 必须与 9 同选。
+- `--update-import`：允许更新导入（`importType` 加 1）；勾 93 时自动带更新导入。
+- 授权对象与共享权限同一套 11 种通用对象（含兼职岗位、职级、外部联系人、所有外部联系人）。
+- `--export-field-range`：`listShowField` 列表显示字段（默认）/ `allField` 全部字段。
+- `--export-details` / `--export-attachment`：导出明细、导出附件。
+- 修改只改点名项，整行回写并回读。
+
+导入导出权限**不提供**权限描述、更新导入校验数据编辑权限、导入关联布局、优先级、同步至其他表单这些配置项。
+
+## 保存后重构
+
+某些改动（尤其是字段相关、矩阵相关和条件）会让平台标记 `isShowRebuild=2`。命令会提示：
+
+```bash
+e10-cli form permission rebuild <objId> <appId> <权限id>
+```
+
+重构只影响权限数据的生效计算，不改权限配置本身。