weaver-e10-builder 1.6.15 → 1.7.0

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

@@ -1,142 +1,162 @@
-# 组合页面
-
-## 整体功能介绍
-
-组合页面把多个页面组织到同一个带页签的页面中，通过切换页签查看不同内容。它负责聚合已有页面，不负责设计各目标页面内部的布局和组件。入口为 EB 应用内的“页面 → 组合页面”，与普通页面设计器分开。
-
-可以设置组合名称和说明，启用页头并设置标题、图标；添加多个页签，分别设置名称、目标、顺序、打开方式、携带参数及可见和禁用范围。页签可按人员或组织身份控制展示，不改变目标页面自身的访问权限。菜单负责提供前台入口；组合创建后不会自动发布菜单。
-
-使用 `page combination` 管理。当前命令提供 PC 组合的新建、编辑、查询、原生复制和删除；页签支持已有建模页面与表单新建/编辑布局目标。外部 URL 及其他系统地址类型暂不开放结构化写入，编辑已有组合时保留其原始配置。
-
-## 基础信息与页头
-
-`name` 为管理名称，`description` 为说明。`header.enabled` 控制页头，`header.title` 设置显示标题，`header.icon` 设置图标描述。标题和组合名称分别维护。
-
-```bash
-e10-cli page combination list --app-id <appId>
-e10-cli page combination get <combinationId>
-e10-cli page combination create --app-id <appId> --config @combination.json --apply
-e10-cli page combination update <combinationId> --config @patch.json --apply
-e10-cli page combination copy <combinationId> --name "副本名称" --apply
-e10-cli page combination delete <combinationId> --apply
-```
-
-省略 `--apply` 只预览。创建和复制使用唯一名称，以便在平台仅返回 success 时识别真实新 ID。所有 ID 使用字符串。更新只传需要修改的属性，省略项保留。
-
-```json
-{
-  "name":"业务工作台",
-  "description":"集中展示关联页面",
-  "header":{"enabled":true,"title":"业务工作台","icon":{"path":"#图标标识"}},
-  "tabs":[
-    {"name":"概览","target":{"type":"PAGE","id":"目标页面ID","name":"目标页面名称"},"openMode":1}
-  ]
-}
-```
-
-`tabs` 仅用于创建，已有页签通过专门命令维护。新建页签不隐式授权所有人，需按需添加可见范围。
-
-## 页签与跳转目标
-
-每个页签有独立 ID；修改和删除按 ID 定位，不按名称或位置定位。`name` 是页签显示文字，目标 `name` 是目标页面名称，两者独立。可指定目标所属 `appId`，省略时使用组合所在应用。
-
-| target.type | target.id | 目标 |
-|---|---|---|
-| PAGE | 页面 ID | 已有建模页面 |
-| LAYOUT | `1_<objId>` | 表单新建布局 |
-| LAYOUT | `2_<objId>` | 表单编辑布局，需传记录 id |
-
-表单目标可用 `layout:{"id":"布局ID","name":"布局名称","clientType":"PC"}` 指定布局，`layout:null` 取消指定。使用真实目标、字段和布局元数据，不根据 ID 数值关系推算。
-
-```bash
-e10-cli page combination tab add <combinationId> --config @tab.json --apply
-e10-cli page combination tab update <combinationId> --tab <tabId> --config @patch.json --apply
-e10-cli page combination tab remove <combinationId> --tab <tabId> --apply
-e10-cli page combination tab order <combinationId> --config @order.json --apply
-```
-
-排序配置是包含全部页签 ID 的数组，数组顺序就是展示顺序。删除页签保留其他页签，组合至少保留一个页签。更换目标会清除原目标的参数及指定布局，避免把旧表字段和旧布局带入新目标；新参数和布局可在同一配置中重新提供。
-
-## 打开方式与携带参数
-
-`openMode:1` 为默认窗口，`openMode:2` 为新窗口。本入口不使用弹窗、右侧滑出等其他入口的打开方式码表。
-
-`params` 是参数数组，保存到平台的 `pageParam` JSON 字符串。`params:[]` 清空参数，省略则保留。值为字符串，可写固定文本或平台占位表达式，例如 `{userid}` 当前人员、`{date}` 当前日期；表达式仍使用 `type:"fixed"`，CLI 原样传递，由平台运行时解析。
-
-| nameType | name | 用途 |
-|---|---|---|
-| fixed 或省略 | 参数名字符串 | 自定义命名参数 |
-| FORMFIELDS | 目标字段对象，含 id、content、compType | 向目标表单字段传值 |
-| dataId | `id` | 编辑布局的记录 ID |
-
-```json
-{
-  "name":"填写信息",
-  "target":{"type":"LAYOUT","id":"1_表单objId","name":"新建布局名称"},
-  "openMode":2,
-  "params":[
-    {"name":"source","nameType":"fixed","value":"workbench","type":"fixed"},
-    {"name":{"id":"人员字段ID","content":"申请人","compType":"Employee"},"nameType":"FORMFIELDS","value":"{userid}","type":"fixed"}
-  ]
-}
-```
-
-命令保留参数结构并回读，不替代目标页面的参数解析。URL/隐式传参方式没有在当前组合命令中开放切换，不套用其他页面跳转入口的字段。
-
-## 页签可见范围与禁用范围
-
-按每个页签分别配置。可见范围控制谁能看到该页签，禁用范围设置需要禁用的对象。隐藏页签不代替目标页面本身的访问控制；目标页面仍需独立配置页面权限。
-
-```bash
-e10-cli page combination tab permission schema
-e10-cli page combination tab permission get <combinationId> --tab <tabId> --scope use
-e10-cli page combination tab permission get <combinationId> --tab <tabId> --scope disabled
-e10-cli page combination tab permission add <combinationId> --tab <tabId> --scope use --config @subject.json --apply
-e10-cli page combination tab permission remove <combinationId> --tab <tabId> --scope disabled --rule <shareKey> --apply
-```
-
-本入口使用组合页签自己的配置表和保存协议，不能用普通页面的码表代替。`schema` 从 `/api/cusapp/app/component/data/permission/form/query` 读取对象选项及属性，权限标识为 `sys_view`。当前 CLI 可结构化新增的主体与平台提供的主体分别如下：
-
-| type | 平台主体 | CLI 结构化新增 |
-|---|---|---|
-| resource | 人员 | 支持，传 id |
-| grade | 职级 | 尚未开放 |
-| department | 部门 | 支持，传 id，可设置 attributes |
-| subcompany | 分部 | 支持，传 id，可设置 attributes |
-| role | 角色 | 支持，传 id、roleLevel |
-| matrix | 矩阵 | 尚未开放；不能套用普通页面矩阵规则 |
-| position | 岗位 | 支持，传 id、positionLevel 及对应机构，可设置 positionAttributes |
-| all | 所有人 | 支持，不需要 id |
-| external | 外部联系人 | 尚未开放 |
-| allExternal | 所有外部人 | 支持，不需要 id |
-| manager | 管理员账号 | 尚未开放 |
-
-其他已有主体仍可查询和保留。CLI 暂不开放所有人、所有外部人的禁用写入；此为命令支持范围，不据此判断平台选项是否允许。
-
-| 配置属性 | 组合页签取值及含义 |
-|---|---|
-| roleLevel | `"4"` 所有级别；`"3"` 分部及总部；`"0"` 总部；`"1"` 分部；`"2"` 部门 |
-| positionLevel | `"1"` 总部；`"2"` 指定分部，配 subcompanies；`"3"` 指定部门，配 departments |
-| subcompanies | 分部 ID 字符串数组，仅用于岗位级别 2 |
-| departments | 部门 ID 字符串数组，仅用于岗位级别 3 |
-| attributes | 部门/分部属性数组：`subordinate` 包含下级、`partTimeStaff` 包含兼职；不提供 include_superior |
-| positionAttributes | 岗位属性数组：`partTimeStaff` 包含兼职 |
-| security | `{ "min":0,"max":100 }`，环境开启安全级别时方可显式设置 |
-
-属性数组传 `[]` 表示不选择相应属性。指定机构的岗位级别必须提供非空机构数组。角色和岗位级别虽与其他入口部分码值相同，仍由组合页签自己的 schema 校验。
-
-```json
-{"type":"department","id":"部门ID","attributes":["subordinate","partTimeStaff"]}
-```
-
-新增报文的基础主体 `targetType` 使用本入口的数字码：人员 1、部门 2、分部 5、角色 10、岗位 1311、所有人 11、所有外部人 1101。平台读回可能按组织属性转换为扩展数字码，例如部门包含下级及兼职可读回 3002；不把基础码当成所有回读情况的完整枚举。这些原始字段由 CLI 编译，不要求用户混填，也不能直接套用其他入口的 USER/DEPT 等字符串表示。
-
-修改授权属性目前通过删除原规则、重新新增完成，不提供未经定义的原生 update。删除依据权限行 `shareKey`，不是人员 ID。创建组合后取得真实页签 ID，再添加权限。接口失败时先读实际状态，不直接重复新增。
-
-详情中的 `shareMap` 不能作为完整权限依据；查询命令会额外分页读取可见和禁用权限。编辑组合保留现有权限，原生复制通过每个页签的 `copyId` 由平台复制权限，复制后独立回读检查。
-
-## 保存与检查
-
-编辑前读取完整组合及页签权限，保存前检查并发变化，保存后核对标题、页签顺序、目标、打开方式、参数和已有页签权限。保存或复制结果不一致时停止并查看当前状态，避免重复创建。
-
-预览中检查页头和页签顺序，点击确认两种打开方式；在目标页面检查参数接收和字段预填。权限分别用范围内、范围外和禁用对象账号检查，复制后检查副本与原组合的目标及权限。配置回读通过与运行时效果通过分别记录。
+# 组合页面
+
+## 整体功能介绍
+
+组合页面把多个页面组织到同一个带页签的页面中，通过切换页签查看不同内容。它负责聚合已有页面，不负责设计各目标页面内部的布局和组件。入口为 EB 应用内的“页面 → 组合页面”，与普通页面设计器分开。
+
+可以设置组合名称和说明，启用页头并设置标题、图标；添加多个页签，分别设置名称、目标、顺序、打开方式、携带参数及可见和禁用范围。页签可按人员或组织身份控制展示，不改变目标页面自身的访问权限。菜单负责提供前台入口；组合创建后不会自动发布菜单。
+
+使用 `page combination` 管理。当前命令提供 PC 组合的新建、编辑、查询、原生复制和删除；页签可使用平台提供的页面、表单布局、报表、台账、流程等目标类型；目标类型不固定为两个枚举。其他系统目标或链接按平台返回的类型、地址及附加属性配置，不能自行猜测协议。
+
+## 基础信息与页头
+
+`name` 为管理名称，`description` 为说明。`header.enabled` 控制页头，`header.title` 设置显示标题，`header.icon` 设置图标描述。标题和组合名称分别维护。
+
+```bash
+e10-cli page combination list --app-id <appId>
+e10-cli page combination get <combinationId>
+e10-cli page combination create --app-id <appId> --config @combination.json --apply
+e10-cli page combination update <combinationId> --config @patch.json --apply
+e10-cli page combination copy <combinationId> --name "副本名称" --apply
+e10-cli page combination delete <combinationId> --apply
+```
+
+省略 `--apply` 只预览。创建和复制使用唯一名称，以便在平台仅返回 success 时识别真实新 ID。所有 ID 使用字符串。更新只传需要修改的属性，省略项保留。
+
+```json
+{
+  "name":"业务工作台",
+  "description":"集中展示关联页面",
+  "header":{"enabled":true,"title":"业务工作台","icon":{"path":"#图标标识"}},
+  "tabs":[
+    {"name":"概览","target":{"type":"PAGE","id":"目标页面ID","name":"目标页面名称"},"openMode":1}
+  ]
+}
+```
+
+`tabs` 仅用于创建，已有页签通过专门命令维护。新建页签不隐式授权所有人，需按需添加可见范围。
+
+## 页签与跳转目标
+
+每个页签有独立 ID；修改和删除按 ID 定位，不按名称或位置定位。`name` 是页签显示文字，目标 `name` 是目标页面名称，两者独立。可指定目标所属 `appId`，省略时使用组合所在应用。
+
+| target.type | target.id | 目标 |
+|---|---|---|
+| PAGE | 页面 ID | 已有建模页面 |
+| LAYOUT | `1_<objId>` | 表单新建布局 |
+| LAYOUT | `2_<objId>` | 表单编辑布局，需传记录 id |
+
+表单目标可用 `layout:{"id":"布局ID","name":"布局名称","clientType":"PC"}` 指定布局，`layout:null` 取消指定。使用真实目标、字段和布局元数据，不根据 ID 数值关系推算。
+
+```bash
+e10-cli page combination tab add <combinationId> --config @tab.json --apply
+e10-cli page combination tab update <combinationId> --tab <tabId> --config @patch.json --apply
+e10-cli page combination tab remove <combinationId> --tab <tabId> --apply
+e10-cli page combination tab order <combinationId> --config @order.json --apply
+```
+
+排序配置是包含全部页签 ID 的数组，数组顺序就是展示顺序。删除页签保留其他页签，组合至少保留一个页签。更换目标会清除原目标的参数及指定布局，避免把旧表字段和旧布局带入新目标；新参数和布局可在同一配置中重新提供。
+
+## 打开方式与携带参数
+
+`openMode:1` 为默认窗口，`openMode:2` 为新窗口。本入口不使用弹窗、右侧滑出等其他入口的打开方式码表。
+
+`params` 是参数数组，保存到平台的 `pageParam` JSON 字符串。`params:[]` 清空参数，省略则保留。值为字符串，可写固定文本或平台占位表达式，例如 `{userid}` 当前人员、`{date}` 当前日期；表达式仍使用 `type:"fixed"`，CLI 原样传递，由平台运行时解析。
+
+| nameType | name | 用途 |
+|---|---|---|
+| fixed 或省略 | 参数名字符串 | 自定义命名参数 |
+| FORMFIELDS | 目标字段对象，含 id、content、compType | 向目标表单字段传值 |
+| dataId | `id` | 编辑布局的记录 ID |
+
+```json
+{
+  "name":"填写信息",
+  "target":{"type":"LAYOUT","id":"1_表单objId","name":"新建布局名称"},
+  "openMode":2,
+  "params":[
+    {"name":"source","nameType":"fixed","value":"workbench","type":"fixed"},
+    {"name":{"id":"人员字段ID","content":"申请人","compType":"Employee"},"nameType":"FORMFIELDS","value":"{userid}","type":"fixed"}
+  ]
+}
+```
+
+命令保留参数结构并回读，不替代目标页面的参数解析。URL/隐式传参方式没有在当前组合命令中开放切换，不套用其他页面跳转入口的字段。
+
+## 页签可见范围与禁用范围
+
+按每个页签分别配置。可见范围控制谁能看到该页签，禁用范围设置需要禁用的对象。隐藏页签不代替目标页面本身的访问控制；目标页面仍需独立配置页面权限。
+
+```bash
+e10-cli page combination tab permission schema
+e10-cli page combination tab permission get <combinationId> --tab <tabId> --scope use
+e10-cli page combination tab permission get <combinationId> --tab <tabId> --scope disabled
+e10-cli page combination tab permission add <combinationId> --tab <tabId> --scope use --config @subject.json --apply
+e10-cli page combination tab permission remove <combinationId> --tab <tabId> --scope disabled --rule <shareKey> --apply
+```
+
+本入口使用组合页签自己的配置表和保存协议，不能用普通页面的码表代替。`schema` 从 `/api/cusapp/app/component/data/permission/form/query` 读取对象选项及属性，权限标识为 `sys_view`。当前 CLI 可结构化新增的主体与平台提供的主体分别如下：
+
+| type | 平台主体 | CLI 结构化新增 |
+|---|---|---|
+| resource | 人员 | 支持，传 id |
+| grade | 职级 | 尚未开放 |
+| department | 部门 | 支持，传 id，可设置 attributes |
+| subcompany | 分部 | 支持，传 id，可设置 attributes |
+| role | 角色 | 支持，传 id、roleLevel |
+| matrix | 矩阵 | 尚未开放；不能套用普通页面矩阵规则 |
+| position | 岗位 | 支持，传 id、positionLevel 及对应机构，可设置 positionAttributes |
+| all | 所有人 | 支持，不需要 id |
+| external | 指定外部联系人 | 对象 ID；以当前入口 schema 为准 |
+| allExternal | 所有外部人 | 支持，不需要 id |
+| manager | 管理员账号 | 尚未开放 |
+
+其他已有主体仍可查询和保留。CLI 暂不开放所有人、所有外部人的禁用写入；此为命令支持范围，不据此判断平台选项是否允许。
+
+| 配置属性 | 组合页签取值及含义 |
+|---|---|
+| roleLevel | `"4"` 所有级别；`"3"` 分部及总部；`"0"` 总部；`"1"` 分部；`"2"` 部门 |
+| positionLevel | `"1"` 总部；`"2"` 指定分部，配 subcompanies；`"3"` 指定部门，配 departments |
+| subcompanies | 分部 ID 字符串数组，仅用于岗位级别 2 |
+| departments | 部门 ID 字符串数组，仅用于岗位级别 3 |
+| attributes | 部门/分部属性数组：`subordinate` 包含下级、`partTimeStaff` 包含兼职；不提供 include_superior |
+| positionAttributes | 岗位属性数组：`partTimeStaff` 包含兼职 |
+| security | `{ "min":0,"max":100 }`，环境开启安全级别时方可显式设置 |
+
+属性数组传 `[]` 表示不选择相应属性。指定机构的岗位级别必须提供非空机构数组。角色和岗位级别虽与其他入口部分码值相同，仍由组合页签自己的 schema 校验。
+
+```json
+{"type":"department","id":"部门ID","attributes":["subordinate","partTimeStaff"]}
+```
+
+新增报文的基础主体 `targetType` 使用本入口的数字码：人员 1、部门 2、分部 5、角色 10、岗位 1311、所有人 11、所有外部人 1101。平台读回可能按组织属性转换为扩展数字码，例如部门包含下级及兼职可读回 3002；不把基础码当成所有回读情况的完整枚举。这些原始字段由 CLI 编译，不要求用户混填，也不能直接套用其他入口的 USER/DEPT 等字符串表示。
+
+修改授权属性目前通过删除原规则、重新新增完成，不提供未经定义的原生 update。删除依据权限行 `shareKey`，不是人员 ID。创建组合后取得真实页签 ID，再添加权限。接口失败时先读实际状态，不直接重复新增。
+
+部门、分部按 ID 解析时，若平台按 ID 取对象的接口对该组织返回异常（常见为 `tenant_key` 为空的空指针），CLI 会自动改用 HRM 组织接口并按需回退到组织列表端点解析；人员、角色、岗位等其它主体不走这条回退。回退后仍取不到对象时，先确认该组织真实存在且当前账号可以看到它。
+
+详情中的 `shareMap` 不能作为完整权限依据；查询命令会额外分页读取可见和禁用权限。编辑组合保留现有权限，原生复制通过每个页签的 `copyId` 由平台复制权限，复制后独立回读检查。
+
+## 保存与检查
+
+编辑前读取完整组合及页签权限，保存前检查并发变化，保存后核对标题、页签顺序、目标、打开方式、参数和已有页签权限。保存或复制结果不一致时停止并查看当前状态，避免重复创建。
+
+预览中检查页头和页签顺序，点击确认两种打开方式；在目标页面检查参数接收和字段预填。权限分别用范围内、范围外和禁用对象账号检查，复制后检查副本与原组合的目标及权限。配置回读通过与运行时效果通过分别记录。
+
+群组与指定外部联系人：普通权限配置使用 `{"type":"group","id":"<groupId>"}` 或 `{"type":"external","id":"<externalId>"}`，适用于使用范围和禁用范围。以当前入口 schema 的可用类型为准；对象由当前入口浏览接口解析，不能跨环境复用 ID。
+
+群组的权限主体码为 `group`，浏览对象接口类型为 `channel`；外部联系人两处均为 `external`。CLI 自动转换浏览类型，不要将主体码直接拼成群组浏览接口。
+
+## 多类型目标与查询
+
+`page combination targets --app-id <appId> --kind types|menu|pages` 分别读取系统目标浏览类型、系统菜单树、应用页面候选。不要求所有目标都经过同一查询流程：已有可靠目标信息可直接配置；手工地址按其原生链接协议填写。
+
+`target` 支持 `type`、`id`、`name`、可选 `appId` 和 `properties`。类型使用平台实际返回值，区分大小写；ID 或地址为非空字符串，不统一要求数字。确定的类型包括 `PAGE` 页面、`LAYOUT` 表单布局、`REPORT` 报表、`VIEWPORT` 台账、`cus_workflow` 流程。此列表不是类型白名单。
+
+```json
+{"name":"流程入口","target":{"type":"cus_workflow","id":"<workflowId>","name":"流程名称","properties":{"urlLinkType":"2","tabs":"{\"menuBrowserDataId\":\"<workflowId>\"}"}}}
+```
+
+`properties` 保存目标附加属性，如 `urlLinkType`、`tabs`、`corpProps`、`pageExtend`，按实际目标填写，保留其原生值类型。它不能覆盖页签身份、名称、目标基本字段或权限。`VIEWPORT` 可在 `tabs` 中携带 `pageViewType`；流程目标可携带 `menuBrowserDataId`。这些是对应目标的属性，不应自动套给其他目标。
+
+切换目标时清除旧目标的参数、布局选择及链接附加字段，再应用新目标属性。普通改名不会清除这些信息。打开方式仍为本组合入口的 `1` 默认窗口、`2` 新窗口，不能套用其他跳转入口的码表。PC、布局选择和参数简写的其他限制仍按各自协议处理，不因放开目标类型而自动推断可用值。

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

@@ -0,0 +1,90 @@
+# 普通页面管理
+
+## 整体功能介绍
+
+页面管理维护一张普通 EB 页面的名称、所属应用、分组及副本。重命名用于调整页面名称；复制生成独立的新页面；转移把现有页面移动到另一应用；删除移除不再需要的页面。组件、事件、源码等页面内容仍使用设计器命令管理。
+
+这些操作针对 `EB_PAGE` 普通页面，不用于组合页面，也不代替表单布局管理。组合页面使用 [组合页面命令](guide-page-combination.md)，页面访问资格使用 [页面权限命令](guide-page-permission.md)，发布导航入口使用 `page publish-menu`。
+
+## 查询页面、分组和目标应用
+
+```bash
+e10-cli page list --app-id <appId>
+e10-cli --json page get <pageId>
+e10-cli page groups --app-id <appId>
+e10-cli page transfer-targets --app-id <sourceAppId> --search <名称关键词> --page 1 --page-size 50
+```
+
+`groups` 查询应用中真实页面分组；`-1` 表示默认未分组，不需要伪造分组对象。`transfer-targets` 使用平台应用选择器，携带当前应用上下文，查询所有发布状态并排除只读目标，返回候选数据和分页信息。列表一页不等于全部应用，按 `total` 及分页继续查询。最终选择真实应用 ID，不按名称或示例固定目标。
+
+## 新建
+
+```bash
+e10-cli page create <name> <appId> --scope PC,MOBILE --layout-type GRID --group-id -1
+```
+
+名称在前、应用 ID 在后。`scope` 为终端范围，`layout-type` 为布局类型，`group-id` 为目标分组。创建后读取页面 ID 和双端布局，再配置组件。已有创建命令直接执行，不使用 `--apply`。
+
+## 重命名
+
+```bash
+e10-cli page rename <pageId> --name <newName>
+e10-cli page rename <pageId> --name <newName> --apply
+```
+
+默认预览，`--apply` 写入。读取已有页面和完整权限，提交 `id/name/nameLabelId/viewRight/disableRight`，不将抓包中的空权限数组当作通用默认值。保存后核对名称、应用归属、通用/禁用/矩阵权限及双端布局和源码。
+
+`--name-label-id <id>` 可显式指定名称多语言标识；省略时保留原值，没有原值时为空。重命名不会同步修改已有菜单名称、事件中保存的目标回显文字或其他资源的名称，相关设置分别维护。
+
+## 复制
+
+```bash
+e10-cli page copy <pageId> --name <copyName> --group-id -1
+e10-cli page copy <pageId> --name <copyName> --group-id <groupId> --apply
+```
+
+默认预览，副本默认放入源应用的未分组；可以选择该应用现有分组。`--name-label-id` 配置副本名称多语言标识，默认空。复制返回真实的新页面 ID，不把源页 ID 当作副本。
+
+复制后检查：
+
+- 新页面名称、所属应用和分组正确。
+- PC/MOBILE 组件、跨端引用、配置、事件及源码与源页相符。
+- 通用使用、禁用、矩阵授权及权限分组相符。
+- 源页面保持不变。
+
+组件机器 ID 可以变化，但真实数据源、字段、记录和业务引用不能仅因都是 ID 就被忽略。源码元数据中的当前页面执行条件可绑定新页面 ID；不替换用户 JS 文本或事件中的业务跳转引用。顶层组件 `pid` 的空字符串、空值和省略视为相同的无父节点状态。
+
+平台复制可能给新副本留下软锁。命令先核对返回的是本次新建页面及正确所属应用，再释放本次副本锁并回读，不解除其他已有页面的锁。
+
+复制已产生新 ID，但后续检查失败时，错误信息会指出该 ID。应先检查该副本，不要反复复制产生重复资源。命令不通过重新创建空页面冒充复制，也不在内容不一致时静默改写源页或副本。
+
+## 转移
+
+```bash
+e10-cli page transfer <pageId> --app-id <targetAppId>
+e10-cli page transfer <pageId> --app-id <targetAppId> --apply
+```
+
+默认预览，`--app-id` 为目标应用。目标必须存在于当前账号、当前来源应用的可转移候选中，且不能等于来源应用。保存前检查页面是否变化；转移后核对页面 ID 不变、详情归属为目标应用、来源列表不再包含该页面且目标列表包含它，同时比较布局和权限。
+
+转移移动页面载体，不自动迁移关联表单、数据源、逻辑流、动作流、菜单或外部系统。页面中这些依赖仍指向原资源，需按目标应用的访问权限检查实际运行。转移也不是复制，原应用不保留第二张相同页面。
+
+## 删除
+
+```bash
+e10-cli page delete <pageId> --preview
+e10-cli page delete <pageId>
+e10-cli page delete <pageId1> <pageId2>
+```
+
+为兼容已有命令，`page delete` 默认直接执行，只有 `--preview` 不写入；它与新增的 rename/copy/transfer 默认预览不同。支持多个不重复 ID，先核对每张页面的身份、权限、锁及基线，再以 multipart 的 `id` 字段提交，最后检查所属应用列表中不再存在目标。
+
+这是平台软删除，不代表 CLI 提供了恢复命令；引用页面的菜单、链接、事件不自动删除或改指向。不要把 HTTP 200 当作删除成功，还要检查业务响应和删除后的列表。
+
+## 保存与功能边界
+
+- 页面锁定或不可编辑时停止，不覆盖其他设计会话。
+- 新增三个管理命令默认预览，使用 `--apply` 写入；已有新建、删除的执行方式分别说明，不混用。
+- 管理命令不修改设计器源码；复制只核对平台复制结果。
+- 权限回读检查配置是否保留；前台能否访问、关联业务依赖是否可用，仍按实际入口检查。
+- 转移和删除接口可能已生效但回读异常，按错误信息查询实际状态后再决定后续操作。