weaver-e10-builder 1.6.16 → 1.7.0

package/skill-docs/references/ebuilder-designer/guide-page-permission.md

@@ -1,147 +1,151 @@
-# 页面使用权限与禁用范围
-
-本指南用于页面管理中的页面权限。使用 `page permission`，不要与菜单可见范围、组件权限、列表数据权限或表单权限混用。
-
-## 整体功能介绍
-
-页面权限用于设置一张页面的使用对象，通过使用范围和禁用范围控制页面访问资格。可以直接按人员和组织身份授权，也可以根据矩阵或 EB 表单中的业务记录取得授权对象，使页面使用范围随来源数据变化。
-
-使用范围包含通用授权和矩阵相关授权。通用授权可选择人员、部门、分部、角色、岗位、所有人及所有外部人，并按主体类型进一步配置组织层级、兼职、角色级别、岗位所属机构等属性。矩阵相关授权可选择来源、筛选记录，再从符合条件的记录中取人员或组织字段，并按本人、直接上级、直接下属等取值关系形成授权对象。禁用范围用于设置需要禁用的指定人员或组织对象。
-
-CLI 支持查询页面现有权限、读取当前环境的可选配置，以及新增、修改、删除通用使用规则、禁用规则和矩阵使用规则。矩阵规则支持多个取值字段和嵌套的条件组合。修改单条规则时保留其他权限配置，默认预览，显式保存后回读检查配置。
-
-这部分配置控制页面的使用资格。菜单是否展示、页面内组件是否可用，以及列表可查看哪些数据，分别由菜单权限、组件权限和数据权限控制，需要按各自的设置维护。
-
-## 功能入口与配置内容
-
-在应用的页面管理中，针对目标页面打开权限设置，配置谁可以使用页面，以及哪些对象需要禁用。先确定目标页面，再选择授权方式：
-
-- **通用使用范围**：直接选择人员、部门、分部、角色、岗位、所有人或所有外部人。适合授权对象可以通过组织身份直接表达的需求。
-- **矩阵相关使用权限**：从矩阵或 EB 表单中筛选记录，再使用记录中的人员、部门等取值确定授权对象。适合“来源记录里的负责人可以使用页面”等随业务数据变化的需求。
-- **禁用范围**：指定需要禁用的人员、部门、分部、角色或岗位。适合在使用范围之外进一步表达排除对象的需求；它不是撤销某一条使用授权规则的命令。撤销规则应删除对应使用规则。
-
-通用授权可以设置多条；矩阵授权也可以设置多条，每条分别选择来源、筛选条件及授权取值。页面权限负责页面使用资格；列表里能看到哪些业务数据，还需要配置列表数据权限。
-
-部门、分部可通过组织属性扩展授权范围，例如包含下级、上级或兼职人员；岗位可限定总部、指定分部或指定部门，并设置是否包含兼职；角色可按总部、分部、部门等角色级别限定范围。具体选项以当前环境提供的配置表为准。
-
-部门、分部按 ID 解析时，若平台按 ID 取对象的接口对该组织返回异常（常见为 `tenant_key` 为空的空指针），CLI 会自动改用 HRM 组织接口并按需回退到组织列表端点解析；人员、角色、岗位等其它主体不走这条回退。回退后仍取不到对象时，先确认该组织真实存在且当前账号可以看到它。
-
-## 矩阵规则如何理解
-
-每条矩阵规则按“选择来源 → 筛选记录 → 从记录取授权对象”组织：
-
-1. **来源**决定在哪里查找记录，可选矩阵或 EB 表单。
-2. **条件**决定哪些来源记录参与授权，可使用固定值、来源表内字段比较及 and/or 组合。未配置条件表示不额外筛选来源记录，不等于对所有人授权。
-3. **取值字段**决定从符合条件的记录中取出哪些人员或组织对象。候选字段通过 `matrix fields` 查询。
-4. **取值关系**决定直接使用字段对应对象，还是使用人员的直接上级、直接下属等关系。可选关系取决于取值字段类型。
-
-条件字段用于筛选来源记录，取值字段用于确定授权对象，两者分别配置。修改条件会改变参与授权的记录范围，修改取值字段或取值关系会改变授权对象的获取方式。
-
-## 读取与保存
-
-```bash
-e10 page permission get <pageId>
-e10 page permission schema <pageId>
-e10 page permission common add <pageId> --scope use --config @permission.json
-e10 page permission common add <pageId> --scope use --config @permission.json --apply
-e10 page permission common update <pageId> --scope use --rule <shareKey> --config @patch.json --apply
-e10 page permission common remove <pageId> --scope disabled --rule <shareKey> --apply
-```
-
-命令前缀使用当前安装的 CLI 可执行文件；源码运行可用 `node --import tsx src/index.ts`。全局环境参数沿用 CLI 的 `--profile`。
-
-默认只预览，`--apply` 才保存。`--scope use` 是使用范围，`disabled` 是禁用范围。通用规则修改、删除使用 `get` 返回的 **shareKey**，不是人员、角色等主体 ID。修改配置只传需要变化的属性，未传属性保留。更换主体类型用删除后新增。
-
-平台保存接口整体替换通用使用范围、矩阵使用范围和禁用范围。命令先读取全量，合并单条变化，保存前再次检查并发变化，保存后独立回读比较授权语义；不会用单条配置覆盖其他规则。至少保留一条通用或矩阵使用规则。响应丢失或回读不一致时，先 `get` 检查真实状态，再决定后续操作，勿直接重复新增。
-
-## 通用主体与码表
-
-新增使用真实组织对象 ID，CLI 从浏览接口补齐对象名称及平台元数据。先读 `schema`，具体可选项以当前环境表单为准。
-
-| type | 主体 | 配置 |
-|---|---|---|
-| resource | 人员 | `id` |
-| department | 部门 | `id`、可选 `attributes` |
-| subcompany | 分部 | `id`、可选 `attributes` |
-| role | 角色 | `id`、`roleLevel` |
-| position | 岗位 | `id`、`positionLevel`、对应机构及 `positionAttributes` |
-| all | 所有人 | 不需要 id，仅用于使用范围 |
-| allExternal | 所有外部人 | 不需要 id，仅用于使用范围 |
-
-指定外部人员不在本命令支持的主体中。
-
-| 属性 | 值及含义 |
-|---|---|
-| roleLevel | `"4"` 所有级别；`"3"` 分部及总部；`"0"` 总部；`"1"` 分部；`"2"` 部门 |
-| positionLevel | `"1"` 总部；`"2"` 指定分部，配 `subcompanies:["分部ID"]`；`"3"` 指定部门，配 `departments:["部门ID"]` |
-| attributes | 数组：`subordinate` 含下级、`include_superior` 含上级、`partTimeStaff` 含兼职；适用部门及分部，以 schema 选项为准 |
-| positionAttributes | 数组：`partTimeStaff` 含兼职 |
-| security | `{ "min":0, "max":100 }`；仅当前环境开启安全级别时可显式设置 |
-
-数组传 `[]` 可关闭对应组织属性。机构数组必须与岗位级别匹配且非空。示例：
-
-```json
-{"type":"position","id":"岗位ID","positionLevel":"2","subcompanies":["分部ID"],"positionAttributes":["partTimeStaff"]}
-```
-
-## 矩阵相关使用权限
-
-来源可选矩阵或 EB 表单，先查询条件列和取值列：
-
-```bash
-e10 page permission matrix fields <pageId> --source-type matrix --source-id <matrixId>
-e10 page permission matrix fields <pageId> --source-type ebuilder_form --source-id <objId>
-e10 page permission matrix add <pageId> --config @matrix.json --apply
-e10 page permission matrix update <pageId> --rule <matrixRuleId> --config @patch.json --apply
-e10 page permission matrix remove <pageId> --rule <matrixRuleId> --apply
-```
-
-矩阵规则使用持久化的 **id**，不是 shareKey，也不是取值行的临时 ID。矩阵规则只配置使用权限。EB 来源 ID 是 objId，不是 formId。
-
-```json
-{
-  "source":{"type":"ebuilder_form","id":"来源表单objId"},
-  "values":[{"field":"来源取值字段ID","relation":"SELF"}],
-  "condition":{
-    "logic":"and",
-    "children":[
-      {"field":"来源文本字段ID","operator":"eq","value":"公开"},
-      {"logic":"or","children":[
-        {"field":"来源说明字段ID","operator":"contains","value":"共享"},
-        {"field":"来源说明字段ID","operator":"empty"}
-      ]}
-    ]
-  }
-}
-```
-
-`values` 至少一项，字段必须来自 `fields` 返回的取值候选。关系默认 `SELF`。人员取值支持 `SELF` 本人、`IMMEDIATE_SUPERIOR` 直接上级、`IMMEDIATE_SUBORDINATE` 直接下属；创建者另支持 `DEPARTMENT` 本部门、`COMPANY` 所在分部；其他取值类型仅支持 `SELF`，表示直接使用来源值。
-
-更新时省略 `condition` 保留条件，`condition:null` 清空条件。更换来源必须同时重新提供 `values` 和 `condition`。删除整条规则用 `matrix remove`。
-
-## 条件树与右值
-
-组使用 `logic:and/or` 和非空 `children`，可以混合嵌套；叶子使用 `field`、`operator`。字段必须来自同一个来源的条件候选，不是当前页面字段。树最多 12 层、500 个节点。
-
-| 输入操作符 | 保存码 | 含义 |
-|---|---|---|
-| eq | eq | 等于 |
-| neq / notEq | neq | 不等于 |
-| in / aggregate | aggregate | 属于 |
-| notIn / unaggregate | unaggregate | 不属于 |
-| isNull / empty | empty | 为空 |
-| isNotNull / nempty | nempty | 不为空 |
-| contains | contains | 包含，仅文本 |
-
-操作符别名只解决保存码转换，不表示每种字段均支持所有操作符。按左侧字段及设计器提供的条件能力选择，不要把包含与属于混淆。
-
-右值 `value` 和 `fieldRef` 二选一；为空、不为空均不传右值。
-
-- 文本、多行文本、关联 EBuilder 的固定值：字符串 `value`。
-- 部门、分部固定值：真实浏览对象数组 `value:[{"id":"机构ID","name":"机构名称"}]`，使用浏览接口取得完整对象。
-- 来源表内文本字段之间比较：`fieldRef:"来源文本字段ID"`。两侧限文本或多行文本，不是页面变量，也不是其他表单字段。
-- 其他字段的非空右值协议不在当前编译器支持范围内；候选中存在字段并不代表所有右值写法都可用。
-
-## 检查配置与实际访问
-
-`get` 展示完整原始规则，并为矩阵规则展开 `values` 和 `condition`。保存后的回读检查能核对配置是否持久化；实际可访问性另用使用范围内、范围外及禁用范围中的账号打开目标页面检查，同时留意菜单自身的可见权限。测试矩阵时准备满足和不满足条件的来源记录，检查取值对应人员的页面访问结果。
+# 页面使用权限与禁用范围
+
+本指南用于页面管理中的页面权限。使用 `page permission`，不要与菜单可见范围、组件权限、列表数据权限或表单权限混用。
+
+## 整体功能介绍
+
+页面权限用于设置一张页面的使用对象，通过使用范围和禁用范围控制页面访问资格。可以直接按人员和组织身份授权，也可以根据矩阵或 EB 表单中的业务记录取得授权对象，使页面使用范围随来源数据变化。
+
+使用范围包含通用授权和矩阵相关授权。通用授权可选择人员、部门、分部、角色、岗位、所有人及所有外部人，并按主体类型进一步配置组织层级、兼职、角色级别、岗位所属机构等属性。矩阵相关授权可选择来源、筛选记录，再从符合条件的记录中取人员或组织字段，并按本人、直接上级、直接下属等取值关系形成授权对象。禁用范围用于设置需要禁用的指定人员或组织对象。
+
+CLI 支持查询页面现有权限、读取当前环境的可选配置，以及新增、修改、删除通用使用规则、禁用规则和矩阵使用规则。矩阵规则支持多个取值字段和嵌套的条件组合。修改单条规则时保留其他权限配置，默认预览，显式保存后回读检查配置。
+
+这部分配置控制页面的使用资格。菜单是否展示、页面内组件是否可用，以及列表可查看哪些数据，分别由菜单权限、组件权限和数据权限控制，需要按各自的设置维护。
+
+## 功能入口与配置内容
+
+在应用的页面管理中，针对目标页面打开权限设置，配置谁可以使用页面，以及哪些对象需要禁用。先确定目标页面，再选择授权方式：
+
+- **通用使用范围**：直接选择人员、部门、分部、角色、岗位、所有人或所有外部人。适合授权对象可以通过组织身份直接表达的需求。
+- **矩阵相关使用权限**：从矩阵或 EB 表单中筛选记录，再使用记录中的人员、部门等取值确定授权对象。适合“来源记录里的负责人可以使用页面”等随业务数据变化的需求。
+- **禁用范围**：指定需要禁用的人员、部门、分部、角色或岗位。适合在使用范围之外进一步表达排除对象的需求；它不是撤销某一条使用授权规则的命令。撤销规则应删除对应使用规则。
+
+通用授权可以设置多条；矩阵授权也可以设置多条，每条分别选择来源、筛选条件及授权取值。页面权限负责页面使用资格；列表里能看到哪些业务数据，还需要配置列表数据权限。
+
+部门、分部可通过组织属性扩展授权范围，例如包含下级、上级或兼职人员；岗位可限定总部、指定分部或指定部门，并设置是否包含兼职；角色可按总部、分部、部门等角色级别限定范围。具体选项以当前环境提供的配置表为准。
+
+部门、分部按 ID 解析时，若平台按 ID 取对象的接口对该组织返回异常（常见为 `tenant_key` 为空的空指针），CLI 会自动改用 HRM 组织接口并按需回退到组织列表端点解析；人员、角色、岗位等其它主体不走这条回退。回退后仍取不到对象时，先确认该组织真实存在且当前账号可以看到它。
+
+## 矩阵规则如何理解
+
+每条矩阵规则按“选择来源 → 筛选记录 → 从记录取授权对象”组织：
+
+1. **来源**决定在哪里查找记录，可选矩阵或 EB 表单。
+2. **条件**决定哪些来源记录参与授权，可使用固定值、来源表内字段比较及 and/or 组合。未配置条件表示不额外筛选来源记录，不等于对所有人授权。
+3. **取值字段**决定从符合条件的记录中取出哪些人员或组织对象。候选字段通过 `matrix fields` 查询。
+4. **取值关系**决定直接使用字段对应对象，还是使用人员的直接上级、直接下属等关系。可选关系取决于取值字段类型。
+
+条件字段用于筛选来源记录，取值字段用于确定授权对象，两者分别配置。修改条件会改变参与授权的记录范围，修改取值字段或取值关系会改变授权对象的获取方式。
+
+## 读取与保存
+
+```bash
+e10 page permission get <pageId>
+e10 page permission schema <pageId>
+e10 page permission common add <pageId> --scope use --config @permission.json
+e10 page permission common add <pageId> --scope use --config @permission.json --apply
+e10 page permission common update <pageId> --scope use --rule <shareKey> --config @patch.json --apply
+e10 page permission common remove <pageId> --scope disabled --rule <shareKey> --apply
+```
+
+命令前缀使用当前安装的 CLI 可执行文件；源码运行可用 `node --import tsx src/index.ts`。全局环境参数沿用 CLI 的 `--profile`。
+
+默认只预览，`--apply` 才保存。`--scope use` 是使用范围，`disabled` 是禁用范围。通用规则修改、删除使用 `get` 返回的 **shareKey**，不是人员、角色等主体 ID。修改配置只传需要变化的属性，未传属性保留。更换主体类型用删除后新增。
+
+平台保存接口整体替换通用使用范围、矩阵使用范围和禁用范围。命令先读取全量，合并单条变化，保存前再次检查并发变化，保存后独立回读比较授权语义；不会用单条配置覆盖其他规则。至少保留一条通用或矩阵使用规则。响应丢失或回读不一致时，先 `get` 检查真实状态，再决定后续操作，勿直接重复新增。
+
+## 通用主体与码表
+
+新增使用真实组织对象 ID，CLI 从浏览接口补齐对象名称及平台元数据。先读 `schema`，具体可选项以当前环境表单为准。
+
+| type | 主体 | 配置 |
+|---|---|---|
+| resource | 人员 | `id` |
+| department | 部门 | `id`、可选 `attributes` |
+| subcompany | 分部 | `id`、可选 `attributes` |
+| role | 角色 | `id`、`roleLevel` |
+| position | 岗位 | `id`、`positionLevel`、对应机构及 `positionAttributes` |
+| all | 所有人 | 不需要 id，仅用于使用范围 |
+| allExternal | 所有外部人 | 不需要 id，仅用于使用范围 |
+
+指定外部人员不在本命令支持的主体中。
+
+| 属性 | 值及含义 |
+|---|---|
+| roleLevel | `"4"` 所有级别；`"3"` 分部及总部；`"0"` 总部；`"1"` 分部；`"2"` 部门 |
+| positionLevel | `"1"` 总部；`"2"` 指定分部，配 `subcompanies:["分部ID"]`；`"3"` 指定部门，配 `departments:["部门ID"]` |
+| attributes | 数组：`subordinate` 含下级、`include_superior` 含上级、`partTimeStaff` 含兼职；适用部门及分部，以 schema 选项为准 |
+| positionAttributes | 数组：`partTimeStaff` 含兼职 |
+| security | `{ "min":0, "max":100 }`；仅当前环境开启安全级别时可显式设置 |
+
+数组传 `[]` 可关闭对应组织属性。机构数组必须与岗位级别匹配且非空。示例：
+
+```json
+{"type":"position","id":"岗位ID","positionLevel":"2","subcompanies":["分部ID"],"positionAttributes":["partTimeStaff"]}
+```
+
+## 矩阵相关使用权限
+
+来源可选矩阵或 EB 表单，先查询条件列和取值列：
+
+```bash
+e10 page permission matrix fields <pageId> --source-type matrix --source-id <matrixId>
+e10 page permission matrix fields <pageId> --source-type ebuilder_form --source-id <objId>
+e10 page permission matrix add <pageId> --config @matrix.json --apply
+e10 page permission matrix update <pageId> --rule <matrixRuleId> --config @patch.json --apply
+e10 page permission matrix remove <pageId> --rule <matrixRuleId> --apply
+```
+
+矩阵规则使用持久化的 **id**，不是 shareKey，也不是取值行的临时 ID。矩阵规则只配置使用权限。EB 来源 ID 是 objId，不是 formId。
+
+```json
+{
+  "source":{"type":"ebuilder_form","id":"来源表单objId"},
+  "values":[{"field":"来源取值字段ID","relation":"SELF"}],
+  "condition":{
+    "logic":"and",
+    "children":[
+      {"field":"来源文本字段ID","operator":"eq","value":"公开"},
+      {"logic":"or","children":[
+        {"field":"来源说明字段ID","operator":"contains","value":"共享"},
+        {"field":"来源说明字段ID","operator":"empty"}
+      ]}
+    ]
+  }
+}
+```
+
+`values` 至少一项，字段必须来自 `fields` 返回的取值候选。关系默认 `SELF`。人员取值支持 `SELF` 本人、`IMMEDIATE_SUPERIOR` 直接上级、`IMMEDIATE_SUBORDINATE` 直接下属；创建者另支持 `DEPARTMENT` 本部门、`COMPANY` 所在分部；其他取值类型仅支持 `SELF`，表示直接使用来源值。
+
+更新时省略 `condition` 保留条件，`condition:null` 清空条件。更换来源必须同时重新提供 `values` 和 `condition`。删除整条规则用 `matrix remove`。
+
+## 条件树与右值
+
+组使用 `logic:and/or` 和非空 `children`，可以混合嵌套；叶子使用 `field`、`operator`。字段必须来自同一个来源的条件候选，不是当前页面字段。树最多 12 层、500 个节点。
+
+| 输入操作符 | 保存码 | 含义 |
+|---|---|---|
+| eq | eq | 等于 |
+| neq / notEq | neq | 不等于 |
+| in / aggregate | aggregate | 属于 |
+| notIn / unaggregate | unaggregate | 不属于 |
+| isNull / empty | empty | 为空 |
+| isNotNull / nempty | nempty | 不为空 |
+| contains | contains | 包含，仅文本 |
+
+操作符别名只解决保存码转换，不表示每种字段均支持所有操作符。按左侧字段及设计器提供的条件能力选择，不要把包含与属于混淆。
+
+右值 `value` 和 `fieldRef` 二选一；为空、不为空均不传右值。
+
+- 文本、多行文本、关联 EBuilder 的固定值：字符串 `value`。
+- 部门、分部固定值：真实浏览对象数组 `value:[{"id":"机构ID","name":"机构名称"}]`，使用浏览接口取得完整对象。
+- 来源表内文本字段之间比较：`fieldRef:"来源文本字段ID"`。两侧限文本或多行文本，不是页面变量，也不是其他表单字段。
+- 其他字段的非空右值协议不在当前编译器支持范围内；候选中存在字段并不代表所有右值写法都可用。
+
+## 检查配置与实际访问
+
+`get` 展示完整原始规则，并为矩阵规则展开 `values` 和 `condition`。保存后的回读检查能核对配置是否持久化；实际可访问性另用使用范围内、范围外及禁用范围中的账号打开目标页面检查，同时留意菜单自身的可见权限。测试矩阵时准备满足和不满足条件的来源记录，检查取值对应人员的页面访问结果。
+
+群组与指定外部联系人：普通权限配置使用 `{"type":"group","id":"<groupId>"}` 或 `{"type":"external","id":"<externalId>"}`，适用于使用范围和禁用范围。以当前入口 schema 的可用类型为准；对象由当前入口浏览接口解析，不能跨环境复用 ID。
+
+群组的权限主体码为 `group`，浏览对象接口类型为 `channel`；外部联系人两处均为 `external`。CLI 自动转换浏览类型，不要将主体码直接拼成群组浏览接口。

package/skill-docs/references/ebuilder-designer/guide-tabbar.md

@@ -0,0 +1,57 @@
+# 移动端标签栏
+
+标签栏 TabBar 在移动页面提供多个菜单入口，每个菜单可以独立绑定点击动作。菜单可打开页面，也可执行已有事件系统提供的条件、JavaScript、组件刷新、显隐、菜单和集成动作。整体事件与单个菜单事件独立配置。
+
+## 组件与菜单
+
+通过 `designer comp-add` 从平台组件模板或已有页面的 TabBar 克隆创建，保留模板自动生成的四个菜单及首页标识，不自行拼装固定菜单列表。TabBar 属于移动端；读取 `designer layout` 获取真实组件 ID。
+
+```sh
+e10-cli designer tabbar schema
+e10-cli designer tabbar get <pageId> --comp <compId>
+e10-cli designer tabbar set <pageId> --comp <compId> --config @settings.json --apply
+e10-cli designer tabbar add <pageId> --comp <compId> --config @item.json --apply
+e10-cli designer tabbar update <pageId> --comp <compId> --item <itemId> --config @item.json --apply
+e10-cli designer tabbar remove <pageId> --comp <compId> --item <itemId> --apply
+e10-cli designer tabbar order <pageId> --comp <compId> --config @order.json --apply
+```
+
+写命令省略 `--apply` 为预览。菜单 ID 从 get 返回值中读取，新增自动生成 ID。排序配置是包含全部菜单 ID 的数组，不能重复或遗漏。
+
+## 整体设置
+
+| 配置 | 作用与码表 |
+|---|---|
+| position | `top` 顶部、`bottom` 底部；原生 fixedArea 分别为 `1`、`2` |
+| overflow | `leftRightSlide` 左右滑动显示更多、`showMoreByClick` 点击更多；底部还支持 `upBottomSlide` 上滑显示更多 |
+| maxDisplay | 直接显示标签数量，为不超过5的正整数；不限制菜单总数 |
+| disableCustomEdit | 点击更多时的禁止自定义编辑开关；开启后更多页隐藏编辑按钮，用户不能调整显示标签及顺序 |
+| remember | 开启优先执行上次选中菜单，没有记录时执行默认菜单；关闭只执行默认菜单 |
+| defaultItem | 默认菜单 ID，空字符串清空；没有默认项时不自动补选首页 |
+
+```json
+{"position":"bottom","overflow":"showMoreByClick","maxDisplay":5,"disableCustomEdit":true,"remember":true,"defaultItem":""}
+```
+
+顶部不支持上滑显示更多。由底部切换顶部时，若原排列为上滑，需同时提供新排列方式。首页不能删除，其他菜单可删除和排序。删除默认菜单时清空默认设置。首页、默认菜单、上次选中菜单分别处理。`syncBuildStyle` 含义尚不明确，编辑时保留原值，不提供推测性的设置别名。
+
+## 菜单属性
+
+add/update 接受 `content` 名称、`icon` 普通图标、`activeIcon` 选中图标、`iconStyle` 普通图标样式对象、`activeIconStyle` 选中图标样式对象、`show` 显示开关。新增需要名称；更新保留未提供的属性及已有事件。
+
+```json
+{"content":"业务操作","icon":"#icon-application-o","activeIcon":"#icon-application","show":true,"iconStyle":{"color":"#666","backgroundColor":"transparent"}}
+```
+
+## 菜单事件
+
+先用 `designer event schema` 查看动作类型，用 `designer event lookup` 查询需要的页面、流程等资源，再按动作结构配置。所有支持的动作均走原有事件编译与校验，不限定为跳转。
+
+```sh
+e10-cli designer event get <pageId> --comp <compId> --collection items --item <itemId> --terminal mobile
+e10-cli designer event set <pageId> --comp <compId> --collection items --item <itemId> --terminal mobile --trigger CLICK --config @action.json --apply
+```
+
+`action.json` 例如 `{"type":"CopyLink"}`；其他动作详见 [事件指南](events/guide-events.md)。单个菜单的事件存于 `items[].eventGroup`。不带 collection/item 时操作组件整体事件；同一触发支持多个顺序动作和递归条件；set {actions:[...]} 整体替换，action/branch 按 ID 编辑。菜单事件可查询、替换、启停或删除。
+
+权限使用 [组件权限命令](component-permission.md)，样式使用通用组件样式能力。标签栏配置不覆盖整体权限、事件、样式或 PC 布局。

package/skill-docs/references/esb-interface/guide-import.md

@@ -1,34 +1,38 @@
-# 接口文档导入 ESB 系统接口
-
-当用户要求“从接口文档创建系统接口”“接口文档转 Postman 并导入 ESB”时，使用 e10-cli 的原生命令：
-
-```bash
-e10-cli interface import "<文档路径>" --out collection.json
-e10-cli interface import "<文档路径>" --system-pool-name "<连接器/系统池名称>" --apply --out collection.json
-```
-
-支持 `.docx`、`.pdf`、`.md`、`.txt`、`.xlsx`、`.xls`。默认只解析预览；只有用户明确要求创建时才加 `--apply`。PDF 解析依赖当前机器可用的 `pdftotext`（Poppler）。
-
-`.xlsx` 是表格版接口文档（按「接口目录」+ 每接口一个工作表组织）；`.xls` 是旧版二进制格式，客户/厂商的老文档里常见 —— **别把它当不支持、让用户先转格式**。
-
-## 处理规则
-
-1. 一份文档中的全部接口合并为一个 Postman Collection v2.1，统一调用平台的 `createSystemInterfaceByAi`。
-2. `--system-pool-name` 优先使用用户明确指定的连接器/系统池名称；未传时从本次文档文件名去扩展名、去尾部 `(1)`/`（1）` 推导。不能复用旧环境名称，也不能臆造名称。
-3. Collection 的 `info.name` 与请求体中的 `systemPoolName` 保持一致且不能为空。
-4. 每个接口必须有请求定义和至少一个 `response[]` 示例；平台输出参数来自响应示例的 `body`，不能只写到 description。
-5. 文档中的密码、token、Authorization、secret、apiKey 等敏感示例值在本地生成 Collection 时脱敏；不要把 Eteamsid 写进文件。
-6. 创建成功必须同时满足外层 `code=200` 和 `data.res=true`，并报告 `systemPk`、接口名称和接口 ID；不能只看 HTTP 200。
-7. 创建接口是新增语义，不提供更新/去重；格式校验先在本地完成，避免重复调用在线接口留下重复系统。
-8. Excel 文档按**不可信输入**对待，解析限额：单文件 ≤ 20 MB、工作表 ≤ 50 个、单表 ≤ 5000 行、单元格总数 ≤ 50 万。超限**直接报错中止**，**不会截断后继续解析** —— 截断会算出一份看不出错的接口清单，比直接失败坏得多。真遇到超限，先跟用户确认是不是拿错了文件（接口文档通常几行到几十行），再谈拆分。
-
-## 文档提取重点
-
-- 按“接口地址”切分接口区块，提取接口名称、请求方式、URL、请求 JSON 和返回 JSON。
-- 请求字段取参数表、请求示例和示例代码中的请求体字段并集，避免漏掉只出现在示例代码中的字段。
-- 返回字段取“返回结果/返回示例/响应结果”等示例，按原有嵌套结构写入 Postman `response[].body`，不得扁平化或额外编造字段。
-- 解析结果有缺失时，在预览输出的 `warnings` 中明确列出；不要静默按猜测补字段。
-
-## 与动作流 HTTP 组件的边界
-
-这里的 `interface import` 是“从文档创建连接器下的系统接口”；动作流里的 `Http` 是“调用当前租户已经存在的连接器 → 连接信息 → 执行接口”。两者可以串联使用，但不能把接口导入命令当成 HTTP 动作节点配置命令。
+# 接口文档导入 ESB 系统接口
+
+当用户要求“从接口文档创建系统接口”“接口文档转 Postman 并导入 ESB”时，使用 e10-cli 的原生命令：
+
+```bash
+e10-cli interface import "<文档路径>" --out collection.json
+e10-cli interface import "<文档路径>" --system-pool-name "<连接器/系统池名称>" --apply --out collection.json
+```
+
+支持 `.docx`、`.pdf`、`.md`、`.txt`、`.xlsx`、`.xls`。默认只解析预览；只有用户明确要求创建时才加 `--apply`。PDF 解析依赖当前机器可用的 `pdftotext`（Poppler）。
+
+`.xlsx` 是表格版接口文档（按「接口目录」+ 每接口一个工作表组织）；`.xls` 是旧版二进制格式，客户/厂商的老文档里常见 —— **别把它当不支持、让用户先转格式**。
+
+## 处理规则
+
+1. 一份文档中的全部接口合并为一个 Postman Collection v2.1，统一调用平台的 `createSystemInterfaceByAi`。
+2. `--system-pool-name` 优先使用用户明确指定的连接器/系统池名称；未传时从本次文档文件名去扩展名、去尾部 `(1)`/`（1）` 推导。不能复用旧环境名称，也不能臆造名称。
+3. Collection 的 `info.name` 与请求体中的 `systemPoolName` 保持一致且不能为空。
+4. 每个接口必须有请求定义和至少一个 `response[]` 示例；平台输出参数来自响应示例的 `body`，不能只写到 description。
+5. 文档中的密码、token、Authorization、secret、apiKey 等敏感示例值在本地生成 Collection 时脱敏；不要把 Eteamsid 写进文件。
+6. 创建成功必须同时满足外层 `code=200` 和 `data.res=true`，并报告 `systemPk`、接口名称和接口 ID；不能只看 HTTP 200。
+7. 创建接口是新增语义，不提供更新/去重；格式校验先在本地完成，避免重复调用在线接口留下重复系统。
+8. Excel 文档按**不可信输入**对待，解析限额：单文件 ≤ 20 MB、工作表 ≤ 50 个、单表 ≤ 5000 行、单元格总数 ≤ 50 万。超限**直接报错中止**，**不会截断后继续解析** —— 截断会算出一份看不出错的接口清单，比直接失败坏得多。真遇到超限，先跟用户确认是不是拿错了文件（接口文档通常几行到几十行），再谈拆分。
+9. **调用创建接口前先做存在性预检**（`--apply` 已内置，无需额外命令）：只读 `GET <环境地址>/api/bs/esb/setting/aiconnector/createSystemInterfaceByAi`，不得用 POST 试探（创建接口无幂等，试探一次就留下一个真实系统）。
+   - 预检返回 404 / 响应体 `code:404` / 「无此路由」→ **直接失败并停止提交**，提示：`目标环境未部署 AI 生成连接器接口（createSystemInterfaceByAi）。weaver-esb-setting 必须为 260701 基线 1.76.0-hotfix7 及以上，或 0901 基线 1.77.0-hotfix1 及以上`。
+   - 预检返回 401（`token为空或失效`）或 5xx（`/error_500`）→ 分别是凭证/环境问题，**不要**报成「版本过低」；无 token 时任何 `/api` 路径都回同一个 401，不能当作接口存在的证据。
+   - 405 / 400 / 415 / 业务 JSON 等「路由已注册」的响应 → 视为存在，继续创建。
+
+## 文档提取重点
+
+- 按“接口地址”切分接口区块，提取接口名称、请求方式、URL、请求 JSON 和返回 JSON。
+- 请求字段取参数表、请求示例和示例代码中的请求体字段并集，避免漏掉只出现在示例代码中的字段。
+- 返回字段取“返回结果/返回示例/响应结果”等示例，按原有嵌套结构写入 Postman `response[].body`，不得扁平化或额外编造字段。
+- 解析结果有缺失时，在预览输出的 `warnings` 中明确列出；不要静默按猜测补字段。
+
+## 与动作流 HTTP 组件的边界
+
+这里的 `interface import` 是“从文档创建连接器下的系统接口”；动作流里的 `Http` 是“调用当前租户已经存在的连接器 → 连接信息 → 执行接口”。两者可以串联使用，但不能把接口导入命令当成 HTTP 动作节点配置命令。