# Skill: eip4-acl-manage ## 触发场景 - 给角色授菜单、管理用户组 / 角色成员、查看菜单树。 > 调用方式:经 REST(无对应 CLI 子命令),或经 `platform-mcp`(MCP)。非 local 环境需带 `Authorization: Bearer `,取 token 见 `eip4-env-manage`。 ## 菜单 - `GET {{EIP4_BASE_URL}}/api/admin/menu-all` — 管理视角全量菜单树(`roots[]` 两级,含 `templateId`)。 - `GET {{EIP4_BASE_URL}}/api/menu` — 当前用户可见菜单树。 - `GET {{EIP4_BASE_URL}}/api/admin/user/{userId}/menu` — 指定用户可见菜单。 - 菜单写:`POST {{EIP4_BASE_URL}}/api/admin/menus/create`、`/api/admin/menus/{id}/update`、`/api/admin/menus/{id}/delete`。 ## 角色授权 - `POST {{EIP4_BASE_URL}}/api/admin/roles/{id}/set-menus`,body `{"menuIds": ["..."]}`(整存差量,空数组=清空)。 - `GET {{EIP4_BASE_URL}}/api/admin/roles/{roleId}/users` — 角色成员。 ## 用户 / 用户组 - `GET {{EIP4_BASE_URL}}/api/admin/users?page=1&perPage=20&keyword=` — 用户分页(密码列不下发)。 - `POST {{EIP4_BASE_URL}}/api/admin/usergroups/create`,body `{"name","description"}`。 - `POST {{EIP4_BASE_URL}}/api/admin/usergroups/{id}/update | /delete`。 - `POST {{EIP4_BASE_URL}}/api/admin/usergroups/{id}/add-user | /remove-user`(幂等)。 - `POST {{EIP4_BASE_URL}}/api/admin/usergroups/{id}/add-role | /remove-role`。 ## 红线 - 写操作仅管理员,事务性。 - 授权走「用户组 → 角色 → 菜单」链(`sys_usergrouprole` / `sys_usergroupuser`),不直接给单用户授菜单。