docs(permission): 统一校准权限节点措辞,消除更新节点误解

admin:permission:nodes 是查看型命令(实时扫描注解、不写库、改注解即生效),但文档/注释多处用一键更新/自动更新/生成等动作词描述,导致开发者系统性误以为它是更新权限节点命令。本次校准 8 个文件 10 处误导措辞,并在命令输出末尾追加机制提示。@NodeAnotation 拼写保持不变(框架故意少一个 t)。
This commit is contained in:
augushong
2026-08-08 18:21:25 +08:00
parent 7341268ceb
commit ad96755ff5
8 changed files with 11 additions and 8 deletions

View File

@@ -15,6 +15,8 @@ description: "解释并指导 RBAC 权限体系与相关 CLI 命令admin:role
## 概念速览
> **机制声明**:权限节点由框架动态扫描控制器 @NodeAnotation 注解实时生成,**不持久化到数据库**,修改注解后立即生效。不存在"更新/刷新节点"的命令,`admin:permission:nodes` 仅用于查看核对。
- 权限节点:基于控制器/方法注解生成的权限标识(用于授权与鉴权)。
- 角色:权限节点的集合(`SystemAuth`)。
- 用户:后台用户(`SystemAdmin`),通过 `auth_ids`(逗号分隔)绑定角色 ID 列表。