diff --git a/docs/共享空间说明.md b/docs/共享空间说明.md index 033188a0..3c511d45 100644 --- a/docs/共享空间说明.md +++ b/docs/共享空间说明.md @@ -189,107 +189,3 @@ - 用户可随时将已停用的共享智能体**恢复**,恢复后该智能体重新在对话下拉等列表中正常显示。 - 停用/恢复仅影响当前租户自己的视图与选择列表,不影响他人,也不影响该用户通过直接链接等方式访问该智能体。 - ---- - -## 七、用户对知识库的最终访问权限 - -用户对某个知识库的访问可能来自两种途径,最终权限取「最宽」的一种。 - -### 7.1 两种访问来源 - -1. **本租户拥有** - 知识库属于用户当前所在租户 → 用户对该知识库拥有**完整权限**(创建者/管理端意义上的「所有者」权限:可编辑、管理设置、删除知识库等),无需也不依赖共享空间。 -2. **通过共享空间共享获得** - 知识库不属于当前租户,但被共享到了用户所在的至少一个共享空间 → 用户通过「成员身份 + 共享设置」得到**受限权限**(见下)。 - -若同时满足 1 和 2(例如先通过空间访问,后来切换到知识库所属租户),系统按「本租户拥有」处理,即完整权限。 - -### 7.2 单条共享下的「有效权限」 - -对**某一条**「知识库 ↔ 空间」的共享而言,用户在该空间内对这份知识库的权限为: - -- **有效权限 = min( 该条共享的权限, 用户在该空间内的角色 )** - -即:取「共享给空间的权限」与「用户在空间内的角色」中**更严格**的一档。 - -- 共享权限与角色均按:**只读(viewer) < 编辑(editor) < 管理员(admin)** 比较。 -- 例如: - - 共享为「可写」,用户在空间内是「只读」→ 有效权限为**只读**; - - 共享为「只读」,用户在空间内是「编辑者」→ 有效权限为**只读**; - - 共享为「可写」,用户在空间内是「编辑者」→ 有效权限为**可写**。 - -### 7.3 同一用户通过多个空间访问同一知识库(取高) - -若用户加入了多个共享空间,且同一知识库被共享到了其中多个空间(可能权限不同),则: - -- 先按 7.2 对每个空间分别算出一条「有效权限」; -- 用户对该知识库的**最终权限** = 这些有效权限中的**最高**一档(不取低、不取交集)。 - -示例: - -- 知识库 K 共享到空间 A(只读)、空间 B(可写); -- 用户同时是 A、B 的成员,在 A、B 内都是编辑者; -- 通过 A 的有效权限 = 只读,通过 B 的有效权限 = 可写; -- 最终用户对 K 的权限 = **可写**。 - -这样设计可以避免:用户因同时在一个「只读共享」的空间里而被整体降级为只读。 - -### 7.4 权限层级与可执行操作 - -| 最终权限 | 可执行操作 | -|----------|------------| -| 本租户拥有 | 完整管理:编辑内容、修改知识库设置、删除知识库、管理共享到哪些空间等 | -| 通过共享获得 · 管理员/编辑 | 在共享范围内:编辑知识库内容(文档/FAQ 等)、检索与问答 | -| 通过共享获得 · 只读 | 仅查看与检索、在对话/智能体中使用该知识库进行问答,不可修改内容 | - -(具体接口层是否区分「编辑」与「只读」以该最终权限为准。) - ---- - -## 八、典型场景小结 - -| 场景 | 结果 | -|------|------| -| 用户是空间内只读成员 | 不能把任何知识库或智能体共享到该空间;只能查看/检索该空间内已共享的知识库、使用已共享的智能体,且知识库每条共享的有效权限不会超过「只读」 | -| 用户是空间内编辑者 | 可把自己的知识库共享到该空间(可设只读或可写)、智能体共享到该空间(仅只读);可编辑空间内已共享的知识库内容(在共享权限允许的前提下);不可管理空间设置与成员 | -| 用户是空间内管理员 | 除编辑者能力外,还可管理空间设置、成员、邀请码、审批加入/升级,以及取消空间内任意知识库共享、智能体共享 | -| 同一知识库共享到多空间且权限不同,用户同属多空间 | 用户对该知识库的最终权限 = 各空间有效权限中的**最高**一档 | -| 用户退出或被移出空间 | 立即失去通过该空间访问任何共享知识库与共享智能体的权限 | -| 用户停用某共享智能体 | 仅影响本租户在对话下拉等处的展示偏好,不取消共享,不影响其他成员 | - ---- - -## 九、与产品术语的对应 - -- 产品与系统中的「共享空间」= Organization。 -- 产品中的「创建者」= 空间创建者 = 自动拥有管理员角色且不可被降级或移出的成员。 -- 知识库「共享到空间」= 建立一条 KnowledgeBaseShare 记录,并指定该空间下的共享权限(只读/可写)。 -- 智能体「共享到空间」= 建立一条 AgentShare 记录,权限固定为只读。 -- 成员在空间内的「权限说明」中「共享知识库/智能体到空间」:仅管理员和编辑者具备,只读不具备;与本文第四、五节规则一致。 -- 智能体「停用」= 当前租户在 tenant_disabled_shared_agents 中记录偏好,仅影响本人对话下拉等展示,与第六节一致。 - ---- - -## 十、附录:权限判定流程(实现参考) - -以下为后端逻辑的简要归纳,便于与实现对照: - -1. **判断是否本租户知识库** - 若 `knowledge_base.tenant_id == current_user.tenant_id` → 直接视为完整权限,不再查共享。 - -2. **收集所有「该知识库 → 某共享空间」的共享** - 查出所有 `kb_id = 该知识库` 的共享记录。 - -3. **对每条共享** - - 若用户不是该空间的成员 → 跳过; - - 否则:`effective = min(share.permission, user_role_in_org)`(按 admin > editor > viewer 比较取低)。 - -4. **合并多条有效权限** - 最终权限 = 所有 `effective` 中的最大值(即取高)。 - -5. **共享到空间的操作权限** - - 发起共享:用户须为空间成员且角色为 admin 或 editor; - - 取消/修改共享:发起人可操作自己的共享;空间管理员可取消任意指向本空间的共享。 - -以上规则与 `internal/application/service/kbshare.go`、`agent_share.go` 及 `organization.go` 中的实现一致。产品界面(如成员列表中的「权限说明」、共享知识库/智能体时的空间筛选、智能体停用偏好)已按相同规则做了展示与限制。