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

@@ -604,7 +604,7 @@ CURD 生成时会将关联模型的全部字段(如 `systemAdmin.*`)输出
1. 检查 HTML 是否声明了对应的 `data-auth-X`(用浏览器开发者工具看 table 元素)
2. 检查 `{:auth('xxx/yyy')}` 的返回值是否为 1用超管账号测试排除权限问题
3. 检查 JS 里 `auth: 'X'` 的 X 与 HTML `data-auth-X` 是否完全一致(大小写)
4. 查权限节点是否已生成`php think admin:permission:nodes`
4.权限节点列表`php think admin:permission:nodes`
**"搜索不生效"排查步骤**

View File

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

View File

@@ -168,7 +168,7 @@ php think tools:http:call --url="/admin/<模块路径>/delete" --method=POST --d
### 功能配套
- **菜单**:用 `admin:menu:*` 新增/调整菜单,与页面路径/节点保持一致。详见 [ulthon-admin-menu-cli](./ulthon-admin-menu-cli/SKILL.md)。
- **权限**:用 `admin:permission:nodes` 生成/核对节点,为角色分配节点并为用户分配角色。详见 [ulthon-permission-cli](./ulthon-permission-cli/SKILL.md)。
- **权限**:用 `admin:permission:nodes` 核对节点(节点由注解动态生成,命令仅查看),为角色分配节点并为用户分配角色。详见 [ulthon-permission-cli](./ulthon-permission-cli/SKILL.md)。
- **数据库排错**:必要时用 `tools:db:*` 做只读检查,详见 [ulthon-db-tools-debug](./ulthon-db-tools-debug/SKILL.md)。
### 交付检查