文件级权限打开之后,知识库的可见性由两层决定:目录结构怎么继承,以及列表、详情、检索分别按谁的身份鉴权。这两层没对齐,就会出现“能看到文件夹、点进去没内容”的情况。
创建文件夹时的继承选项
入口在知识库的文件树与新建文件夹对话框。核对动作是新建时确认是否勾选继承父级权限;继承态的文件夹跟随父级的协作者变化,独立态的需要单独配置。失败表现是父级加了协作者,子文件夹里的文件对新人仍不可见。边界:继承可以恢复,也可以改成独立态,改动会作用于该文件夹下的全部文件。
继承态与独立态可以在同一棵树上混用。改父级之前先标出哪些子文件夹是独立态,否则会出现“改了全部”的错觉,实际只覆盖了一部分。
父目录的导航边界
入口在文件树的面包屑与目录页。核对动作是确认仅持有子资源权限的成员,进入父目录时只看到导航入口,不会因此获得父目录的管理能力;用这类账号试一次改名与删除操作,确认被拒绝。失败表现是能进目录也能改目录。边界:导航入口与授权是两件事,4.17.3 明确父目录导航不附带管理授权。
给新成员授权时从目标文件往上逐层确认,能落在文件上的就不放宽到目录。目录级授权会作用到之后放进该目录的文件,范围比当下看到的更大。
三类操作的权限差异
入口在知识库设置与文件操作菜单。核对动作是分别用管理权限与编辑权限的账号试三类操作:修改库配置、改文件名或标签、启用与禁用文件。前者需要管理权限,内容编辑沿用原编辑权限;后者按同一套编辑权限判断。失败表现是编辑者能改名却改不了库配置,被当成缺陷上报,实际是权限分层生效。
检索与发布快照的运行身份
入口在检索测试与应用的发布记录。核对动作是打开文件级权限后,用两个不同成员身份各跑一次同样的检索,比较结果条数;再检查发布后的应用里的静态资源是否按发布时快照校验,动态资源是否按实际运行用户校验。失败表现是同一问题两个账号看到不同引用,或发布后资源权限随协作者变化而漂移。边界:固定的身份才有一致的引用结果,做对比测试时要先固定账号。
权限设计最终落到目录规划:按部门分层、按项目建目录、按文件配例外。三层混在同一个目录里,改一次授权要连带检查三处,出错概率高于多建两个目录。
数据来源
| Source | Version | Document |
|---|---|---|
| FastGPT | v4.17.3 | self-host/upgrading/4-17/4173 |
| FastGPT | v4.17.1 | self-host/upgrading/4-17/4171 |