返回更新记录
v1.6.0

成员级知识库授权:同一个工作区,不同的人看不同的知识 (v1.6.0)

管理员现在可以把成员的知识库可见范围限定为「仅指定知识库」——产品手册、法务合同、会议纪要共存于一个工作区,各自只对被授权的人可见。越界访问一律 404 不暴露存在性;管理员与所有者不受影响;程序化访问(API Key / MCP)行为完全不变。

权限多租户Web ConsoleREST

琅嬛的隔离单元一直是 workspace:跨工作区天然隔离,但工作区内部此前没有边界——任何成员都能看到全部知识库。当产品手册、法务合同、会议纪要共存于一个工作区时,唯一的解法是拆工作区,而拆分要重复承担模型配置、检索设置与成员管理。v1.6.0 把答案放到更细的粒度:管理员可以把成员的知识库可见范围限定为「仅指定知识库」。

在哪里配置

成员管理页新增「知识库范围」列(全部 / N 个知识库)。成员行的操作里多了一个「知识库授权」入口(管理员及以上可见):选择「全部知识库」或「仅指定知识库」,后者用勾选列表配置——一个都不勾等于该成员暂时看不到任何知识库。程序化接口对应 PUT /workspaces/:slug/members/:user_id/kb-grants。

边界语义,四条说清楚

  • 只约束成员角色:管理员与所有者隐含全部知识库——管理面必须能看到全貌,接口也会拒绝为他们设置限定范围,避免出现「设置了但不生效」的困惑状态。
  • 越界即不存在:未授权的知识库不出现在列表与检索选择器里;直接访问其 URL 或手打 ID 调 API,得到的 404 与「知识库不存在」完全一致,不泄漏任何存在性信息。
  • 我建的库我可见:被限定的成员创建新知识库时,新库自动进入其可见范围——不会出现「建完自己看不到」的情况。
  • 默认开放,按需收紧:新成员加入时默认可见全部,之后由管理员按需收紧;存量成员升级后行为零变化。

程序化访问与检索不受影响

API Key / MCP 的知识库绑定机制自 v0.6.0 起独立运作,本版零改动。检索链路本身也没有任何变化——过滤发生在入口(列表与选择器),混合检索与引用血缘的行为逐位不变。文档级权限明确不在本版范围:「部分文档可见」类需求更适合用检索时的元数据过滤承载,而不是把访问控制打进检索热路径。