weaver-e10-builder 1.6.5 → 1.6.7

package/skill-docs/references/form/layout/workflow-layout.md

@@ -23,6 +23,51 @@ e10-cli wf-form layout init-reviewed <formId> --layout-id <布局ID> --style-tem
 
 不传 `--layout-id` 时处理默认布局。当前审阅式模板应用只支持 PC；移动端仍按现有布局初始化和编辑能力操作。此命令会重建目标布局，应用后仍需检查实际页面；`templateEffectVerified` 不代表浏览器最终呈现已核对。公文流程使用同一原生流程表单 `formId` 和上述命令，其公文专属设置另行维护。
 
+修改布局名称或描述使用 `wf-form layout rename`。布局内容、引用节点和默认设置都保持不变，不需要删掉重建：
+
+```bash
+e10-cli wf-form layout rename <formId> <布局ID或名称> --name "新名称" --describe "用途说明"
+```
+
+`--name`、`--describe` 至少给一个；不传的那项保持原值。按名称定位时若同名多套会报歧义并列出 ID。**默认布局也可以改名** —— 布局列表里它的 `isSys`/`readOnly` 为 true 是平台常态，不代表不能改。原生流程表单与 eb 表关联流程的表单都适用：传 `--workflow-id`，命令按工作流自动判定走哪套接口。命令写完回读布局列表，确认名称与描述落库，且终端、布局类型、默认标记没有被一起改掉。
+
+把某套布局设为默认：
+
+```bash
+e10-cli wf-form layout set-default <formId> <布局ID或名称>
+```
+
+默认布局是**表单维度**的，PC 与移动端各自一套；终端按目标布局自身判定，不用额外指定。原生流程表单与 eb 表关联流程的表单都适用：传 `--workflow-id`，命令按工作流自动判定走哪套接口。尚未单独绑定布局的节点都读默认布局，切换后它们会一起换到新布局。目标本来就是默认时命令不做改动；写完回读确认它是默认，且同终端没有第二套默认。
+
+## 往布局里摆流程系统字段
+
+流程系统字段（提交人、流程编号、流程状态等）可以直接摆进指定布局，字段写中文名、key 或组件类型都行：
+
+```bash
+e10-cli wf-form layout add-system-field <formId> 提交人 流程编号 流程状态 --layout-id <布局ID>
+e10-cli wf-form layout add-system-field <formId> --all          # 目录里的全部字段
+```
+
+不传 `--layout-id` 就加到 PC 默认布局；`--single-row` 让新增字段各占一行。**已经在该布局里的字段自动跳过**，重复执行不会重复添加、也不会打乱原有组件顺序。写的是整份布局，完成后会回读确认新字段在、原有组件一个没少。
+
+| 字段 | key | 组件类型 | 样式 |
+|---|---|---|---|
+| 流程标题 | `REQ_REQUEST_NAME` | `FlowPageSysFieldReqName` | 可输入 |
+| 流程编号 | `REQUEST_NO` | `FlowPageSysFieldMarkReserved` | 只读 |
+| 紧急程度 | `REQUEST_LEVEL` | `FlowPageSysFieldRequestlevel` | 可输入 |
+| 密级 | `REQUEST_SECRET_LEVEL` | `FlowPageSysFieldSeclevel` | 可输入 |
+| 提交人 | `CREATE_USER` | `FlowPageSysFieldCreator` | 只读 |
+| 提交人部门 | `CREATE_DEPT` | `FlowPageSysFieldCreatorDept` | 只读 |
+| 提交人分部 | `CREATE_SUB` | `FlowPageSysFieldCreatorSubCompany` | 只读 |
+| 提交时间 | `CREATE_DATETIME` | `FlowPageSysFieldCreateTime` | 只读 |
+| 结束时间 | `FINISH_DATETIME` | `FlowPageSysFieldFinishTime` | 只读 |
+| 到期时间 | `FlowPageSysFieldExpiryTime` | `FlowPageSysFieldExpiryTime` | 可输入 |
+| 打印次数 | `PRINT_COUNT` | `FlowPageSysFieldPrintCount` | 只读 |
+| 工作流名称 / 类型 / 描述 | `WORKFLOW_NAME` / `WORKFLOW_TYPE` / `WORKFLOW_DESC` | `FlowPageSysFieldWorkflowName` / `Type` / `Desc` | 只读 |
+| 流程状态 | `FLOW_STATUS_COMP` | `FlowPageFlowStatus` | 无内容 |
+
+原生流程表单与 eb 表关联流程的表单都适用：传 `--workflow-id`，命令按工作流自动判定走哪套接口。
+
 删除指定流程表单布局使用：
 
 ```bash

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

@@ -2,7 +2,8 @@
 
 通过 `savePublishMenu` API 挂载系统内置页面到应用菜单。menuUrl 格式固定，禁止瞎编。
 
-> **暂不支持 H5/移动端菜单**。移动端是独立体系（不同 URL + 不同 pageId），目前尚未整理完整，禁止 AI 自行编造。
+> **移动端菜单是另一套记录**：同一个 `savePublishMenu` 接口，只把 `terminalType` 换成 `H5`；页面绑定与 `menuUrl` 与 PC 相同。菜单命令统一用 `--terminal mobile` 指定移动端（缺省 PC），两端互不影响。
+> 移动端**内置系统页**的 URL 尚未整理，不要自行编造。
 
 ---
 
@@ -85,3 +86,45 @@
 - 已建好的菜单调整：`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`。命令写完回读**同一栏**确认生效。

package/skill-docs/references/workflow/guide-workflow-node-layout.md

@@ -2,7 +2,7 @@
 
 > **命令**：`e10-cli workflow node layout list | get | bind | unbind | create`
 > **同族功能**：`e10-cli workflow node field-permission`（节点字段权限）
-> **相关**：`wf-form layout add` / `wf-form layout delete`（表单自己的多套布局）
+> **相关**：`wf-form layout add` / `wf-form layout rename` / `wf-form layout delete`（表单自己的多套布局）
 
 表单布局的新增、初始化与节点引用如何衔接，先读[流程表单布局与节点独立布局](../form/layout/workflow-layout.md)；本篇保留节点绑定的详细规则。
 
@@ -101,7 +101,8 @@ e10-cli workflow node layout init <workflowId> <布局ID> --fields 报销单号
 字段名写错会**直接报错并列出可用字段**，不会闷头建出一套空布局。
 `--list-fields` 可以先看清单。
 
-删除布局用 `wf-form layout delete <formId> <layoutId>`。
+删除布局用 `wf-form layout delete <formId> <layoutId>`；只改名称或描述用 `wf-form layout rename <formId> <布局ID或名称> --name <新名>`，不必删掉重建。
+换默认布局用 `wf-form layout set-default <formId> <布局ID或名称>`（PC / 移动端各一套，未单独绑定布局的节点跟着切换）。
 
 ---