菜单管理与系统菜单使用说明

构建时间2026-06-26 20:10:33（Asia/Shanghai）来源项目中间件文档 / 中间件后端来源仓../cl-midserver-2026来源提交号69b951a07311e75887b57e0400d888f89dd72cac

查看文档来源信息

• 来源目录：addons/sys_base/docs
• 来源文件：功能说明/菜单管理与系统菜单使用说明.md

## 功能用途 用于查看和维护当前模块 `system_menu` 的正式菜单版本、当前生效版本、运行态结构以及版本切换结果。

入口位置

• PCWEB 权限 -> 菜单管理

使用前提

1. 当前模块已经接入正式菜单清单治理链路。
2. 打开菜单管理页需要页面权限 system.menu.manage。
3. 执行上传、提交版本、发布、切换当前版本、更新显示状态等操作，需要动作权限 menu.publish。

页面结构

1. 首页默认展示当前模块当前生效的系统菜单结构。
2. 首页重点展示父子层级、页面标识、动作标识、默认页、来源版本和当前漂移状态。
3. 发布工作台负责处理版本操作，不再把上传入口直接铺满首页。

正式操作流程

1. 打开菜单管理页，系统会读取当前生效菜单结构。
2. 如需调整，进入发布工作台。
3. 选择 JSON 清单后，页面立即执行本地结构检查和服务端预校验。
4. 如果存在阻断项，页面展示字段、原因和修复建议，保存草稿按钮保持不可用；例如根字段写成 seeds 时，应改为正式字段 menuSeeds 后重新选择文件。
5. 预校验通过后，页面展示程序解析结果和与当前生效版本的差异，再允许保存草稿。
6. 按“保存草稿 -> 提交版本 -> 发布”完成正式发布。
7. 如需回到历史正式版本，在版本列表中对历史已提交版本或历史已发布版本执行“切换为当前版本”。
8. 切换成功后，当前生效菜单结构会立即刷新为目标版本。

版本列表说明

1. 版本列表会区分“当前生效”“待发布”“历史已发布”“草稿”“已阻断”。
2. 当前生效版本会在列表和首页摘要中明确标识。
3. 版本详情优先展示程序解释后的菜单结构和差异摘要，不再把原始 JSON 作为主视图。

运行规则

1. 系统菜单运行态始终以最新成功发布记录对应的版本为准。
2. 切换当前版本会沿用正式发布链路同步系统菜单承载表。
3. 运行态显示开关只允许作用于当前生效菜单中的真实承载节点。
4. 普通角色缺少页面权限或动作权限时，由后端正式拒绝访问。
5. 保存草稿前后端都会校验菜单清单；存在 blocking 阻断项时不会创建新的草稿版本。

维护提示

1. 如果首页为空，先确认当前范围下是否已有成功发布记录。
2. 如果版本不能切换为当前版本，先确认该版本是否已经提交，以及是否存在阻断项。
3. 如果角色授权或默认页结果异常，先刷新当前生效结构，再核对版本详情与差异摘要。