文件级权限打开之后,可见性由三件事共同决定:成员身份、文件集合、检索时的鉴权路径。目录结构只是文件集合的组织方式,不额外授予权限。判断顺序是先确认身份,再确认文件集合,最后看检索是否按身份过滤;顺序颠倒,就会出现“能进目录但打不开文件”或“检索结果随账号变化”这类看起来矛盾的现象。
三件事一起决定可见性
成员身份决定他能进入哪些团队与知识库,文件集合决定他实际可读哪些材料,按成员身份鉴权的检索只从该成员可读的集合返回候选。三者是串联关系,前一步不成立,后一步不会发生。
文件级权限开关默认关闭,存量行为与升级前一致;开启是一次显式动作,开启后列表、详情与检索召回都按文件权限逐条鉴权。这一条决定了排查思路:同一知识库里两个人看到不同结果,先查身份与文件权限,不要先怀疑检索参数。
继承与独立:授权的两层
创建文件夹时可以选择是否继承父级权限。继承态的文件夹随父级协作者变化,独立态自己维护协作者,两种态可以在同一棵树上混用,继承也可以恢复。改动作用于该文件夹下的全部文件,范围按层级传导。
这一层最容易出错的地方在改动之前:说不清哪些子树是独立态,事后就说不清覆盖范围。盘点结果可以落成一张表:目录路径、继承或独立、协作者清单、最近改动时间。改之前更新这张表,改完再核一遍。
授权时还有一条操作与权限的对应关系:修改知识库配置、改文件名或标签、启用与禁用文件属于管理动作,需要管理权限;内容编辑沿用原编辑权限。把“能改名”当成“能改库配置”,是权限分层生效后被误报成缺陷的常见来源。
父目录只作导航
仅持有子资源权限的成员进入父目录时,看到的是导航入口,不会因此获得父目录的管理能力。这一条在 4.17.3 里写得明确。验证方式是拿这类账号试一次改名或删除,确认被拒绝;不要以“能进目录”推断“有目录权限”。两个账号交叉验证更稳:一个有子资源权限,一个只有父目录导航,同一操作在两边分别试,结果差异就是授权边界。
导航与授权分开之后,目录规划的空间更大:可以按部门分层、按项目建目录、按文件配例外。三层混在同一个目录里,改一次授权要连带检查三处,出错概率高于多建两个目录。
检索按身份逐条鉴权
检索召回按成员可读文件逐条过滤,过滤发生在按当前成员身份鉴权的调用里。这一条有两个边界需要记住:预选知识库但未按成员身份鉴权的调用,文件级过滤不适用;分享链接与免登录窗口走各自的鉴权路径,不能拿成员账号的结果去推断它们的表现。
核对动作是让两个成员用同一句问题各检索一次,比较返回条数与片段来源,再与各自的文件集合比对。结果一致不代表配置正确,两人文件集合本来就相同时,检索看不出差异。
三种鉴权路径的边界
成员账号走的是逐条鉴权:列表、详情、检索都按文件权限过滤。分享链接与免登录窗口走各自的鉴权路径,它们的可见范围与成员账号不是同一套规则,拿成员账号的结果去推断这两类入口的表现,结论会反过来。
还有一类容易被忽略:预选知识库但未按成员身份鉴权的调用。这类调用不做文件级过滤,返回的是知识库层面的召回结果。做对外接口的权限评估时,先确认调用属于哪一类,再判断需要补哪一层控制。
发布快照与运行身份
应用发布时,静态资源按发布时的快照校验,动态资源按实际运行用户校验。两套校验在权限调整之后可能给出不同结果:改完目录授权,发布后的应用的静态部分仍按旧快照走,动态部分已经跟着新授权走。
排查这类问题时先分清资源类别,再查授权。把两者混在一起,会得出“权限改了没生效”的结论,实际是一半生效、一半没生效。
对比测试怎么固定身份
做引用一致性对比时,固定三件事:账号、知识库、问题。账号固定,才能排除文件权限差异;知识库固定,才能排除切换库带来的召回差异;问题固定,才能比较片段。三项都固定之后,两次结果的差异才是检索或索引的问题。
反过来,如果对比目的是验证权限,就把问题固定、账号变化,看结果是否随权限收窄。两类对比的目的不同,测试设计不能通用。
失败表现与排查顺序
列表为空:查成员身份与文件读权限。列表有条目但打不开:查该文件的独立授权。检索缺文档:查文件集合与检索鉴权路径。检索混入他人文件:查是否走到了未按身份鉴权的调用。删除失败:按目标资源核对该操作需要的权限,并保存接口错误。
排查顺序始终是身份、集合、检索、动作四步。跳步会重复劳动,也会把配置问题误判成产品缺陷。每一步都留一条证据:账号、文件集合截图、检索结果条数、操作返回码,四条证据齐了,问题就不在谁的说法里。留证据的另一个作用是交接:换人排查时按这四条复现,不必从头问一遍现象。
用同题异权验证目录访问与检索
在隔离的测试库放两份短文档。第一份供两名测试成员读取,写入一个只出现在该文档的术语。第二份只授权给其中一名成员,写入另一组便于定位的标记。让两名成员分别从目录入口找文件,再从同一个按成员身份鉴权的应用发出相同查询。将目录中看到的条目、实际可打开的文件与引用来源分开记录。一个账号看得到父目录但无法修改目录时,单独记录为导航行为。
如果两名成员的引用都只出现公共文档,先让有权账号用私有标记做一次对照搜索。若仍检索不到,核对索引状态、检索配置与查询词,再继续判断鉴权。若无权账号返回私有文档,保存调用入口、会话身份及引用标识,重点查本次是否实际采用成员身份鉴权。上线前使用发布版本重新走同一组步骤,并把成员入口、分享入口与未登录入口的结果分开保存。后续调整继承方式时可重复这组对照。
数据来源
技术版本:FastGPT v4.17.3。
| 主题 | 来源 |
|---|---|
| 目录继承、父目录导航、管理权限与编辑权限 | 官方更新说明 4.17.3 |
| 文件级权限与发布快照 | 官方更新说明 4.17.1 |