Brain Document Access（GDrive 权限继承）

背景：Brain 的两层访问控制

Brain 访问控制分两层，Document access 是第二层。默认 source scope 是唯一门禁：能看到源的人能检索源里一切。Document access 让 Google Drive 源可进一步按每份文档自己的 Drive 权限约束检索。

┌──────────────────────────────────────────────────────────────────────┐
│                  Brain 访问控制 — 两层模型                             │
├──────────────────────────────────────────────────────────────────────┤
│  第 1 层：Source scope（所有源都有）                                   │
│  ┌──────────────────────────────────────────────────────────────┐   │
│  │  决定"谁能看到并搜索这个源"：Personal / Team / Organization     │   │
│  └──────────────────────────────────────────────────────────────┘   │
│         │  默认：scope 是唯一门禁                                       │
│         ▼                                                             │
│  第 2 层：Document access（仅 Google Drive 源，v10.10.0 新）            │
│  ┌──────────────────────────────────────────────────────────────┐   │
│  │  Gumloop access（默认）/ Original source（权限继承）             │   │
│  └──────────────────────────────────────────────────────────────┘   │
└──────────────────────────────────────────────────────────────────────┘

两种模式

模式	行为	适用
Gumloop access（默认）	源 scope 内任何人可检索全部文档，忽略原始权限	无文档级权限边界的小团队
Original source（v10.10.0 新）	只有在 Drive 里有访问权的人才能经 Brain 检索到该文档，逐文档检查	有文档级权限边界的企业

目标

1. 消除数据越权——检索结果不含用户在源系统无权查看的机密文档
2. 尊重源系统 ACL——Brain 检索权限与企业既有文档权限对齐
3. 通过企业安全审查——满足 SOC2/ISO27001 对"AI 检索尊重源 ACL"的要求
4. Fail-closed 保守姿态——宁可漏检，不可越权

2.1 同步时快照 + 检索时强制

「Original source」分两阶段工作：同步时快照每份文档的 Drive 权限（按邮箱）；检索时按用户连接的 Google 邮箱逐文档检查快照。权限不是实时查 Drive，而是同步快照——Drive 权限变更要等下一次同步才生效。

┌──────────────────────────────────────────────────────────────────────┐
│  阶段 1 — 同步时（Sync time）：权限快照                                 │
│  Gumloop 读取每份文档，快照其当前 Drive 权限（谁有访问权，按邮箱）        │
│         │  权限快照随索引一起存储                                        │
│         ▼                                                             │
│  阶段 2 — 检索时（Search time）：逐文档强制                             │
│  用户检索 → 对每个候选文档检查该用户是否有权                              │
│  匹配依据：用户【连接的 Google 账户邮箱】                                 │
│         │                                                             │
│    ┌────┴────┐                                                        │
│    ▼         ▼                                                        │
│   有权       无权                                                      │
│    │          │                                                       │
│    ▼          ▼                                                       │
│  返回内容   文档不浮现（fail-closed）                                    │
└──────────────────────────────────────────────────────────────────────┘

2.2 Fail-closed 设计（关键安全姿态）

Gumloop 原则："fails closed rather than over-share"（宁可少给也不过度分享）。并非所有 Drive 授予方式都能被强制：

Drive 权限授予方式	Brain 行为
直接用户访问	✅ 遵守——有权用户可检索
组织/域访问（匹配已验证邮箱域）	✅ 遵守——同域用户可检索
"任何拥有链接的人"	❌ 视为无权限，不浮现
Google Group 共享	❌ 视为无权限，不浮现

2.3 模式切换触发重新同步

改变源的 Document access 设置会排队重新同步，按新模式重新快照权限。切到 Original source → 重新快照所有文档权限；切到 Gumloop access → 丢弃快照、回到 scope-only 门禁。

2.4 支持范围（当前仅 Google Drive）

Document access 选项只出现在支持它的源上。Google Drive 是当前唯一支持的源；其他源（Notion/Slack/GitHub/Confluence/Zendesk/文件上传）始终用 Gumloop access。Gumloop access 模式下不检查逐文档权限——能看到源的人能检索源里任何内容，文档建议把此类源 scope 到预期受众。

模块 A — Document access 配置

ID	触发场景	系统行为	优先级
A1	添加 GDrive 源时	出现 Document access 选项（其他源不出现）	P0
A2	选 Original source	启用权限继承：同步快照 + 检索逐文档强制	P0
A3	选 Gumloop access（默认）	仅 scope 门禁，不检查逐文档权限	P0
A4	编辑源设置	可修改 Document access 模式	P0

模块 B — 权限快照与强制

ID	触发场景	系统行为	优先级
B1	Original source 模式同步	快照每份文档 Drive 权限（按邮箱），随索引存储	P0
B2	用户检索	按用户连接 Google 邮箱逐文档检查快照权限	P0
B3	用户对文档无权	文档不浮现（fail-closed）	P0
B4	文档为 link/Group 共享	一律视为无权限，不浮现	P0
B5	文档为直接用户/域授权	遵守，有权用户可检索	P0

模块 C — 模式切换

ID	触发场景	系统行为	优先级
C1	切换 Document access	排队重新同步，按新模式重新快照	P0
C2	切到 Gumloop access	丢弃权限快照，回到 scope-only	P0