weaver-e10-builder 1.6.16 → 1.7.0

package/skill-docs/references/form/ref-list-filter-date-params.md

@@ -1,83 +1,83 @@
-# 条件里的日期系统参数占位符
-
-适用于视图数据条件（`form list-filter`，写入 `saveNListConfig` 的 `config.filter`）里的**日期字段**。
-日期字段的算子为**等于（`func: "eq"`）**时，右值可以直接写平台系统参数占位符；平台把占位符**原样存成字符串**，查询时按当时时间求值，不会像 `quick` 那样展开成死日期。
-
-```json
-{"fieldId":"<日期字段fieldId>","func":"eq","value":"{curryear}","text":"本年"}
-```
-
-- `value`：占位符原文（含花括号），原样保存，不要自己先算成日期。
-- `text`：界面显示名（如「本年」）。设计器回读时用它渲染条件，建议一并给出。
-- 已确认只用于 `eq`；其它算子请走普通值或 `quick`。命令对日期字段的非 `eq` 占位符会直接报错。
-- `n` 为整数，`:+n` / `:-n` 表示当前值之后 / 之前 n 个单位。
-
-> `quick`（今天 / 本周 / 今年…）与占位符是两条路：`quick` 是区间快捷档，保存时算成固定起止日期；占位符是动态右值，运行期才求值。要「每年自动跟进」用占位符，不要用 `quick`。
-
-## 占位符清单
-
-| 占位符 | 含义 |
-|---|---|
-| `{date}` | 当前日期（`yyyy-MM-dd`） |
-| `{date:+n}` | 当前日期后 n 天 |
-| `{date:-n}` | 当前日期前 n 天 |
-| `{time}` | 当前时间（`HH:mm:ss`） |
-| `{thisweek}` | 当前周所在的日期区间 |
-| `{thismonth}` | 当前月所在的日期区间 |
-| `{thisyear}` | 当前年所在的日期区间 |
-| `{lastweek}` | 上一周所在的日期区间 |
-| `{lastmonth}` | 上个月所在的日期区间 |
-| `{lastquarter}` | 上一季度所在的日期区间 |
-| `{lastyear}` | 上一年所在的日期区间 |
-| `{recentdays:-n}` | 距当前日期近 n 天的日期区间 |
-| `{recentmonths:-n}` | 距当前日期近 n 个月的日期区间 |
-| `{recentyears:-n}` | 距当前日期近 n 年的日期区间 |
-| `{year}` | 当前年 |
-| `{year:+n}` | 当前年的后 n 年 |
-| `{year:-n}` | 当前年的前 n 年 |
-| `{half}` | 当前半年度（`01-01` ~ `06-30`） |
-| `{yearhalf}` | 当前年的当前半年度 |
-| `{yearhalf:+n}` | 当前半年度的后 n 个半年 |
-| `{yearhalf:-n}` | 当前半年度的前 n 个半年 |
-| `{quarter}` | 当前季度 |
-| `{yearquarter}` | 当前年的当前季度 |
-| `{yearquarter:+n}` | 当前季度的后 n 个季度 |
-| `{yearquarter:-n}` | 当前季度的前 n 个季度 |
-| `{thisquarter}` | 当前季度是当前年的第几季度 |
-| `{firstdayinthismonth}` | 当前月的第一天 |
-| `{lastdayinthismonth}` | 当前月的最后一天 |
-| `{month}` | 当前月（`01`~`12`） |
-| `{yearmonth:+n}` | 当前年月的后 n 个月（`yyyy-MM`） |
-| `{yearmonth:-n}` | 当前年月的前 n 个月（`yyyy-MM`） |
-| `{day}` | 当前日 |
-| `{hour}` | 当前时 |
-| `{minute}` | 当前分 |
-| `{second}` | 当前秒 |
-| `{dateweek}` | 当前日期的星期（如「星期三」） |
-| `{weekinmonth}` | 当前日期在本月的第几周 |
-| `{weekinyear}` | 当前日期在本年的第几周 |
-| `{weekinyear:+n}` | 当前日期在本年的周数往后加 n 周 |
-| `{weekinyear:-n}` | 当前日期在本年的周数往前减 n 周 |
-| `{week}` | 当前周（`01-01` ~ `01-07` 这种月日区间） |
-| `{mon}` / `{tue}` / `{wed}` / `{thu}` / `{fri}` / `{sat}` / `{sun}` | 当前周的周一 / 周二 / … / 周日所在日期 |
-| `{mon:+n}` 等 | 对应星期几所在日期的后 n 天 |
-| `{mon:-n}` 等 | 对应星期几所在日期的前 n 天 |
-| `{curryear}` | 当前年（设计器「本年」条件实测使用；与 `{year}` 同类） |
-
-## 命令示例
-
-```bash
-# 台账只显示「等于本年」的数据
-e10-cli form list-filter <objId> <appId> <listId> \
-  --add '{"conditions":[{"fieldId":"<日期字段fieldId>","func":"eq","value":"{curryear}","text":"本年"}]}'
-
-# 近 7 天
-e10-cli form list-filter <objId> <appId> <listId> \
-  --add '{"conditions":[{"fieldId":"<日期字段fieldId>","func":"eq","value":"{recentdays:-7}","text":"近7天"}]}'
-
-# 当前日期后 3 天
-e10-cli form list-filter <objId> <appId> <listId> \
-  --add '{"conditions":[{"fieldId":"<日期字段fieldId>","func":"eq","value":"{date:+3}","text":"3天后"}]}'
-```
-
-保存后 `--json` 回读，`conditions.value` 应仍是 `{...}` 原文；被展开成具体日期说明走错了路径（多半是用了 `quick`）。
+# 条件里的日期系统参数占位符
+
+适用于视图数据条件（`form list-filter`，写入 `saveNListConfig` 的 `config.filter`）里的**日期字段**。
+日期字段的算子为**等于（`func: "eq"`）**时，右值可以直接写平台系统参数占位符；平台把占位符**原样存成字符串**，查询时按当时时间求值，不会像 `quick` 那样展开成死日期。
+
+```json
+{"fieldId":"<日期字段fieldId>","func":"eq","value":"{curryear}","text":"本年"}
+```
+
+- `value`：占位符原文（含花括号），原样保存，不要自己先算成日期。
+- `text`：界面显示名（如「本年」）。设计器回读时用它渲染条件，建议一并给出。
+- 已确认只用于 `eq`；其它算子请走普通值或 `quick`。命令对日期字段的非 `eq` 占位符会直接报错。
+- `n` 为整数，`:+n` / `:-n` 表示当前值之后 / 之前 n 个单位。
+
+> `quick`（今天 / 本周 / 今年…）与占位符是两条路：`quick` 是区间快捷档，保存时算成固定起止日期；占位符是动态右值，运行期才求值。要「每年自动跟进」用占位符，不要用 `quick`。
+
+## 占位符清单
+
+| 占位符 | 含义 |
+|---|---|
+| `{date}` | 当前日期（`yyyy-MM-dd`） |
+| `{date:+n}` | 当前日期后 n 天 |
+| `{date:-n}` | 当前日期前 n 天 |
+| `{time}` | 当前时间（`HH:mm:ss`） |
+| `{thisweek}` | 当前周所在的日期区间 |
+| `{thismonth}` | 当前月所在的日期区间 |
+| `{thisyear}` | 当前年所在的日期区间 |
+| `{lastweek}` | 上一周所在的日期区间 |
+| `{lastmonth}` | 上个月所在的日期区间 |
+| `{lastquarter}` | 上一季度所在的日期区间 |
+| `{lastyear}` | 上一年所在的日期区间 |
+| `{recentdays:-n}` | 距当前日期近 n 天的日期区间 |
+| `{recentmonths:-n}` | 距当前日期近 n 个月的日期区间 |
+| `{recentyears:-n}` | 距当前日期近 n 年的日期区间 |
+| `{year}` | 当前年 |
+| `{year:+n}` | 当前年的后 n 年 |
+| `{year:-n}` | 当前年的前 n 年 |
+| `{half}` | 当前半年度（`01-01` ~ `06-30`） |
+| `{yearhalf}` | 当前年的当前半年度 |
+| `{yearhalf:+n}` | 当前半年度的后 n 个半年 |
+| `{yearhalf:-n}` | 当前半年度的前 n 个半年 |
+| `{quarter}` | 当前季度 |
+| `{yearquarter}` | 当前年的当前季度 |
+| `{yearquarter:+n}` | 当前季度的后 n 个季度 |
+| `{yearquarter:-n}` | 当前季度的前 n 个季度 |
+| `{thisquarter}` | 当前季度是当前年的第几季度 |
+| `{firstdayinthismonth}` | 当前月的第一天 |
+| `{lastdayinthismonth}` | 当前月的最后一天 |
+| `{month}` | 当前月（`01`~`12`） |
+| `{yearmonth:+n}` | 当前年月的后 n 个月（`yyyy-MM`） |
+| `{yearmonth:-n}` | 当前年月的前 n 个月（`yyyy-MM`） |
+| `{day}` | 当前日 |
+| `{hour}` | 当前时 |
+| `{minute}` | 当前分 |
+| `{second}` | 当前秒 |
+| `{dateweek}` | 当前日期的星期（如「星期三」） |
+| `{weekinmonth}` | 当前日期在本月的第几周 |
+| `{weekinyear}` | 当前日期在本年的第几周 |
+| `{weekinyear:+n}` | 当前日期在本年的周数往后加 n 周 |
+| `{weekinyear:-n}` | 当前日期在本年的周数往前减 n 周 |
+| `{week}` | 当前周（`01-01` ~ `01-07` 这种月日区间） |
+| `{mon}` / `{tue}` / `{wed}` / `{thu}` / `{fri}` / `{sat}` / `{sun}` | 当前周的周一 / 周二 / … / 周日所在日期 |
+| `{mon:+n}` 等 | 对应星期几所在日期的后 n 天 |
+| `{mon:-n}` 等 | 对应星期几所在日期的前 n 天 |
+| `{curryear}` | 当前年（设计器「本年」条件实测使用；与 `{year}` 同类） |
+
+## 命令示例
+
+```bash
+# 台账只显示「等于本年」的数据
+e10-cli form list-filter <objId> <appId> <listId> \
+  --add '{"conditions":[{"fieldId":"<日期字段fieldId>","func":"eq","value":"{curryear}","text":"本年"}]}'
+
+# 近 7 天
+e10-cli form list-filter <objId> <appId> <listId> \
+  --add '{"conditions":[{"fieldId":"<日期字段fieldId>","func":"eq","value":"{recentdays:-7}","text":"近7天"}]}'
+
+# 当前日期后 3 天
+e10-cli form list-filter <objId> <appId> <listId> \
+  --add '{"conditions":[{"fieldId":"<日期字段fieldId>","func":"eq","value":"{date:+3}","text":"3天后"}]}'
+```
+
+保存后 `--json` 回读，`conditions.value` 应仍是 `{...}` 原文；被展开成具体日期说明走错了路径（多半是用了 `quick`）。

package/skill-docs/references/menu/system-menus.md

@@ -1,151 +1,151 @@
-# 系统内置菜单 URL 参考
-
-通过 `savePublishMenu` API 挂载系统内置页面到应用菜单。menuUrl 格式固定，禁止瞎编。
-
-> **移动端菜单是另一套记录**：同一个 `savePublishMenu` 接口，只把 `terminalType` 换成 `H5`；页面绑定与 `menuUrl` 与 PC 相同。菜单命令统一用 `--terminal mobile` 指定移动端（缺省 PC），两端互不影响。
-> 移动端**内置系统页**的 URL 尚未整理，不要自行编造。
-
-## 别把对象页面加成外链
-
-`menu add` 写的是 LINK 菜单。平台自己的页面地址（`/sp/ebdfpage/viewport/<viewId>` 台账、`/sp/ebdfpage/card/1/<objId>/0` 表单新建页）当外链写进去只会存成一串 URL：设计器「链接地址」显示文本而不是「数据列表: 表单名」标签，移动端拿不到视图绑定，打开是空列表。
-
-- 台账（数据列表）入口 → `menu add-table <appId> <表单 objId>`
-- 表单发起入口 → `menu add-start <appId> <表单 objId>`
-
-`menu add` 遇到这两类地址会直接拒绝；确实要当外链才加 `--as-link`。
-
-## 把 PC 菜单同步到移动端
-
-```bash
-e10-cli menu sync <appId>
-```
-
-- 平台原生能力：「是否确认将PC端菜单同步至移动端？（此同步操作会覆盖已添加的菜单配置）」。
-- 同步会**整体覆盖**移动端菜单：移动端单独加过、PC 上没有的菜单会被清掉。
-- 同步范围是 PC 端的**业务菜单**（目录、外链、嵌套都带过去，顺序与层级照搬）；「设置」「回收站」这类系统菜单两端各管各的，不参与同步。
-- 命令保存后会回读移动端，与 PC 端逐条比对路径、层级与顺序；对不上会报错并点名缺失/多余项，不会把「没同步」说成成功。
-- PC 端一条业务菜单都没有时命令会拒跑（否则等于清空移动端）；确认要清空加 `--force`。
-
----
-
-## PC 端菜单
-
-### 工作流页面 (pageType: WORKFLOW)
-
-| 菜单名 | pageId | menuUrl |
-|--------|--------|---------|
-| 待办流程 | todo | `/sp/ebdfpage/workflow/{appId}_todo` |
-| 已办流程 | done | `/sp/ebdfpage/workflow/{appId}_done` |
-| 我提交的流程 | mine | `/sp/ebdfpage/workflow/{appId}_mine` |
-| 共享给我的流程 | share | `/sp/ebdfpage/workflow/{appId}_share` |
-| 下属的待办流程 | subordinates | `/sp/ebdfpage/workflow/{appId}_subordinates` |
-| 全部流程 | all | `/sp/ebdfpage/workflow/{appId}_all` |
-| 草稿流程 | draft | `/sp/ebdfpage/workflow/{appId}_draft` |
-| 流程监控 | monitor | `/sp/ebdfpage/workflow/{appId}_monitor` |
-
-### 独立页面（不跟 appId）
-
-| 菜单名 | pageId | menuUrl |
-|--------|--------|---------|
-| 提交申请 | newflow | `/sp/ebdfpage/ebflowpage/create/` |
-
-### 其他系统页面
-
-| 菜单名 | pageId | pageType | menuUrl |
-|--------|--------|----------|---------|
-| 我的关注 | followList | BASE | `/sp/ebdfpage/followlist/{appId}` |
-| 共享给我的 | shareList | BASE | `/sp/ebdfpage/sharelist/{appId}` |
-
----
-
-## 用法
-
-```json
-{
-  "content": "待办流程",
-  "menuType": "1",
-  "page": {
-    "pageId": "todo",
-    "pageName": "待办流程",
-    "pageType": "WORKFLOW",
-    "appid": "{appId}"
-  },
-  "menuUrl": "/sp/ebdfpage/workflow/{appId}_todo",
-  "shareMap": [{
-    "id": "0",
-    "content": "所有人",
-    "permissionId": "sys_view",
-    "targetType": 11,
-    "sourceType": 1,
-    "objIdList": ["所有人"]
-  }]
-}
-```
-
-> **只有包含工作流的应用**才能挂载工作流系统页面。表单台账会自动挂入菜单，无需手动操作。
-
----
-
-## 菜单是一棵树
-
-应用菜单不止一层：顶层之外还有 `children` 嵌套（例如平台自带的「设置 → 个人设置 → 个人菜单设置」、系统设置下的「基本信息 / 菜单设置」）。
-
-- `menu list <appId>` **递归展开**整棵树，输出带缩进；末尾会注明含多少个嵌套菜单。**这份列表就是全量**，在它里面找不到某个菜单，才能下结论说「该应用没有这个菜单」。
-- `menu rename <appId> <菜单ID或名称> <新名>` 按 ID 或名称定位，**嵌套里的菜单一样能改**。同名多条时命令会报歧义并列出候选 ID，不会替你挑一条。
-- 改名的命令会**重建写报文**再回读比对：名称变了、且「页面绑定 / 菜单 URL / 可见范围」等字段一个都没动，才算成功。改名只动名字，不会顺带改掉已有的筛选条件或页签配置。
-
-**平台系统菜单（回收站、设置及其子项）不能改名** —— 它们由平台维护、指向内置页面，改名没有语义，命令会直接拒绝。
-
----
-
-## 菜单顺序
-
-平台按同级（同一个 `pid`）的 `showOrder` **升序**显示，同值再按菜单 id；系统菜单的 `showOrder` 是 `9999998/9999999`，所以总在最后。新建菜单默认 `showOrder=1`，因此会排到同级最后。
-
-- 创建时直接排第一：`menu add / add-dir / add-table / add-start`、`page publish-menu` 加 `--first`。
-- 创建时指定位置：`--show-order <n>`（整数，越小越靠前）。
-- 已建好的菜单调整：`e10-cli menu order <appId> <菜单ID或名称> --first`，或 `--show-order <n>`。
-
-命令在写完会回读：`showOrder` 必须落成请求值；`--first` 还会确认同级下标为 0。系统菜单不允许调整顺序。
-
----
-
-## 打开方式
-
-菜单点击后在哪儿打开，由 `navigation.openMode` 决定：
-
-| 界面选项 | 值 |
-|---|---|
-| 默认窗口（缺省） | `1` |
-| 新窗口 | `2` |
-
-- 新建时指定：`menu add / add-table / add-start`、`page publish-menu` 加 `--open-mode new-window`。
-- 已建好的菜单：`e10-cli menu open-mode <appId> <菜单ID或名称> new-window`（改回用 `default`）。
-- 上级目录（空链接）没有页面，设置打开方式没有意义，命令会拒绝。
-- 改完回读打开方式，并确认名字、页面、链接等其它字段一个都没动。
-
----
-
-## 可见范围（两栏）
-
-「可见范围」弹窗其实是**两栏**，各自一套授权对象：
-
-| 界面栏位 | 存储差异 |
-|---|---|
-| 可见 | `permissionType = 1` |
-| 可见范围内禁用 | `permissionType = -1` |
-
-两栏的写报文除这个字段外完全相同，所以命令必须显式分清栏位：
-
-```bash
-# 只让某部门可见（自动撤掉「所有人」）
-e10-cli menu permission add <appId> <menuId> 营销部 --type dept
-
-# 在可见人群里排除某人
-e10-cli menu permission add <appId> <menuId> 张三 --type user --scope disabled
-
-# 查看两栏
-e10-cli menu permission list <appId> <menuId>
-```
-
-授权对象五类：人员 `user` / 部门 `dept` / 角色 `role` / 岗位 `position` / 所有人 `all`。命令写完回读**同一栏**确认生效。
+# 系统内置菜单 URL 参考
+
+通过 `savePublishMenu` API 挂载系统内置页面到应用菜单。menuUrl 格式固定，禁止瞎编。
+
+> **移动端菜单是另一套记录**：同一个 `savePublishMenu` 接口，只把 `terminalType` 换成 `H5`；页面绑定与 `menuUrl` 与 PC 相同。菜单命令统一用 `--terminal mobile` 指定移动端（缺省 PC），两端互不影响。
+> 移动端**内置系统页**的 URL 尚未整理，不要自行编造。
+
+## 别把对象页面加成外链
+
+`menu add` 写的是 LINK 菜单。平台自己的页面地址（`/sp/ebdfpage/viewport/<viewId>` 台账、`/sp/ebdfpage/card/1/<objId>/0` 表单新建页）当外链写进去只会存成一串 URL：设计器「链接地址」显示文本而不是「数据列表: 表单名」标签，移动端拿不到视图绑定，打开是空列表。
+
+- 台账（数据列表）入口 → `menu add-table <appId> <表单 objId>`
+- 表单发起入口 → `menu add-start <appId> <表单 objId>`
+
+`menu add` 遇到这两类地址会直接拒绝；确实要当外链才加 `--as-link`。
+
+## 把 PC 菜单同步到移动端
+
+```bash
+e10-cli menu sync <appId>
+```
+
+- 平台原生能力：「是否确认将PC端菜单同步至移动端？（此同步操作会覆盖已添加的菜单配置）」。
+- 同步会**整体覆盖**移动端菜单：移动端单独加过、PC 上没有的菜单会被清掉。
+- 同步范围是 PC 端的**业务菜单**（目录、外链、嵌套都带过去，顺序与层级照搬）；「设置」「回收站」这类系统菜单两端各管各的，不参与同步。
+- 命令保存后会回读移动端，与 PC 端逐条比对路径、层级与顺序；对不上会报错并点名缺失/多余项，不会把「没同步」说成成功。
+- PC 端一条业务菜单都没有时命令会拒跑（否则等于清空移动端）；确认要清空加 `--force`。
+
+---
+
+## PC 端菜单
+
+### 工作流页面 (pageType: WORKFLOW)
+
+| 菜单名 | pageId | menuUrl |
+|--------|--------|---------|
+| 待办流程 | todo | `/sp/ebdfpage/workflow/{appId}_todo` |
+| 已办流程 | done | `/sp/ebdfpage/workflow/{appId}_done` |
+| 我提交的流程 | mine | `/sp/ebdfpage/workflow/{appId}_mine` |
+| 共享给我的流程 | share | `/sp/ebdfpage/workflow/{appId}_share` |
+| 下属的待办流程 | subordinates | `/sp/ebdfpage/workflow/{appId}_subordinates` |
+| 全部流程 | all | `/sp/ebdfpage/workflow/{appId}_all` |
+| 草稿流程 | draft | `/sp/ebdfpage/workflow/{appId}_draft` |
+| 流程监控 | monitor | `/sp/ebdfpage/workflow/{appId}_monitor` |
+
+### 独立页面（不跟 appId）
+
+| 菜单名 | pageId | menuUrl |
+|--------|--------|---------|
+| 提交申请 | newflow | `/sp/ebdfpage/ebflowpage/create/` |
+
+### 其他系统页面
+
+| 菜单名 | pageId | pageType | menuUrl |
+|--------|--------|----------|---------|
+| 我的关注 | followList | BASE | `/sp/ebdfpage/followlist/{appId}` |
+| 共享给我的 | shareList | BASE | `/sp/ebdfpage/sharelist/{appId}` |
+
+---
+
+## 用法
+
+```json
+{
+  "content": "待办流程",
+  "menuType": "1",
+  "page": {
+    "pageId": "todo",
+    "pageName": "待办流程",
+    "pageType": "WORKFLOW",
+    "appid": "{appId}"
+  },
+  "menuUrl": "/sp/ebdfpage/workflow/{appId}_todo",
+  "shareMap": [{
+    "id": "0",
+    "content": "所有人",
+    "permissionId": "sys_view",
+    "targetType": 11,
+    "sourceType": 1,
+    "objIdList": ["所有人"]
+  }]
+}
+```
+
+> **只有包含工作流的应用**才能挂载工作流系统页面。表单台账会自动挂入菜单，无需手动操作。
+
+---
+
+## 菜单是一棵树
+
+应用菜单不止一层：顶层之外还有 `children` 嵌套（例如平台自带的「设置 → 个人设置 → 个人菜单设置」、系统设置下的「基本信息 / 菜单设置」）。
+
+- `menu list <appId>` **递归展开**整棵树，输出带缩进；末尾会注明含多少个嵌套菜单。**这份列表就是全量**，在它里面找不到某个菜单，才能下结论说「该应用没有这个菜单」。
+- `menu rename <appId> <菜单ID或名称> <新名>` 按 ID 或名称定位，**嵌套里的菜单一样能改**。同名多条时命令会报歧义并列出候选 ID，不会替你挑一条。
+- 改名的命令会**重建写报文**再回读比对：名称变了、且「页面绑定 / 菜单 URL / 可见范围」等字段一个都没动，才算成功。改名只动名字，不会顺带改掉已有的筛选条件或页签配置。
+
+**平台系统菜单（回收站、设置及其子项）不能改名** —— 它们由平台维护、指向内置页面，改名没有语义，命令会直接拒绝。
+
+---
+
+## 菜单顺序
+
+平台按同级（同一个 `pid`）的 `showOrder` **升序**显示，同值再按菜单 id；系统菜单的 `showOrder` 是 `9999998/9999999`，所以总在最后。新建菜单默认 `showOrder=1`，因此会排到同级最后。
+
+- 创建时直接排第一：`menu add / add-dir / add-table / add-start`、`page publish-menu` 加 `--first`。
+- 创建时指定位置：`--show-order <n>`（整数，越小越靠前）。
+- 已建好的菜单调整：`e10-cli menu order <appId> <菜单ID或名称> --first`，或 `--show-order <n>`。
+
+命令在写完会回读：`showOrder` 必须落成请求值；`--first` 还会确认同级下标为 0。系统菜单不允许调整顺序。
+
+---
+
+## 打开方式
+
+菜单点击后在哪儿打开，由 `navigation.openMode` 决定：
+
+| 界面选项 | 值 |
+|---|---|
+| 默认窗口（缺省） | `1` |
+| 新窗口 | `2` |
+
+- 新建时指定：`menu add / add-table / add-start`、`page publish-menu` 加 `--open-mode new-window`。
+- 已建好的菜单：`e10-cli menu open-mode <appId> <菜单ID或名称> new-window`（改回用 `default`）。
+- 上级目录（空链接）没有页面，设置打开方式没有意义，命令会拒绝。
+- 改完回读打开方式，并确认名字、页面、链接等其它字段一个都没动。
+
+---
+
+## 可见范围（两栏）
+
+「可见范围」弹窗其实是**两栏**，各自一套授权对象：
+
+| 界面栏位 | 存储差异 |
+|---|---|
+| 可见 | `permissionType = 1` |
+| 可见范围内禁用 | `permissionType = -1` |
+
+两栏的写报文除这个字段外完全相同，所以命令必须显式分清栏位：
+
+```bash
+# 只让某部门可见（自动撤掉「所有人」）
+e10-cli menu permission add <appId> <menuId> 营销部 --type dept
+
+# 在可见人群里排除某人
+e10-cli menu permission add <appId> <menuId> 张三 --type user --scope disabled
+
+# 查看两栏
+e10-cli menu permission list <appId> <menuId>
+```
+
+授权对象五类：人员 `user` / 部门 `dept` / 角色 `role` / 岗位 `position` / 所有人 `all`。命令写完回读**同一栏**确认生效。