企业知识库最怕两件事：该看到的人看不到，不该看到的人看到了。后者尤其麻烦，因为它往往不是从正门进来的，而是绕道智能体、API、分享链接、子任务这些“侧门”。ApeMind 的做法是让所有入口共用同一个授权内核，并且在每一次真实读取时重新判定。
两套角色，各管各的
管部署，不管业务数据
- admin管理用户、系统配置、配额和审计等部署级治理
- rw可以创建自己的资源、管理自己的 API Key
- ro只读已授权的内容，不能创建或修改业务资源
管组织内的控制面和数据面
- Owner组织所有者，唯一，不可分配
- Admin组织设置、成员、角色、模型，以及全部成员能力
- Editor创建、编辑组织知识库和智能体
- Viewer读取和使用组织知识库与智能体
组织还可以自定义角色，按动作逐项组合权限，比如只允许读取知识库、或者只允许管理标签。未列出的权限默认拒绝。
站点管理员可以运维组织，但不会自动获得组织知识库、文档或智能体的业务数据。要读组织数据，同样必须是这个组织的成员并且具备对应动作。
一次访问如何被判定
选一个人、一份资料和一个动作，看判定沿着哪条路径走、停在哪一步。场景里的组织 A 有一个内部知识库和一个已发布到市场的知识库。
判定顺序与产品一致；示例人物与资料为演示。
注意被拒绝时的两种表现：组织成员缺少某个动作，会被明确拒绝；而与这份资料毫无关系的人，得到的是“不存在”。系统不会向无关的人确认某个知识库存在，这本身也是一种数据边界。
资源归属与订阅
- 组织资源归组织。组织知识库由组织共同持有，上传者是谁不改变归属；成员离开，资源留在组织里。
- 订阅只开一扇只读的门。知识库发布到市场后，任何人都能浏览它的目录信息；但要检索和阅读内容，必须订阅。订阅只授予读取，不授予写入或再发布。
- 组织订阅归组织。组织订阅的公开库，对具备读取权限的组织成员可读，不会混进个人订阅或其他组织的订阅。
机器身份：每把密钥钉在一个工作区
API Key 是给程序和智能体用的身份。每把 Key 归一个主体持有，并在创建时固定绑定到一个工作区；之后它能访问的范围不会随持有者切换工作区而变化。
成员手动创建，可设 30、90、365 天过期，可以停用、重新启用和删除。
随智能体的生命周期自动创建和管理，承载智能体访问数据的硬权限，不能被手工误删。
组织为集成系统签发的非人身份，不依赖任何员工；明文只在签发时显示一次。
组织治理面可以看到所有钉定本组织的 Key 及其持有者，有权限的成员可以吊销其中任意一把非受保护的 Key。任何 API Key 都不能用来调用组织治理接口。
智能体能读什么
智能体每读一份资料，都要连续通过三层：组织工作区当前可读的范围、智能体托管密钥的授权范围、这一轮的选材。最后真正能读到的，是三者的交集。切换密钥模式、在输入框里 @ 不同的知识库，看看结果：
示例为一个组织智能体；三层关系与产品一致。
这里最重要的一条规则是：选材提示不是授权。@ 一个知识库、# 一篇文档，告诉智能体“这一轮先看这里”；它只能在已有授权里挑选，不能把一个没有授权的知识库变成可读。反过来，密钥范围也不是一次性快照：组织取消订阅、成员被移除，下一次读取就会被拒绝。
工具也有自己的范围。智能体能调用哪些工具，由它的工具配置决定，和数据权限分开管理：能调用搜索工具，不代表能搜任何知识库。
子智能体与公开入口
读数据时沿用调用链最上层父智能体的身份和实时权限，计量也归到它名下。子智能体可以有自己的模型和工具，但不形成独立的权限边界，委派不会扩大可读范围。
只能绑定当前工作区里独立可见的智能体，并限制允许的网站域名。每个访客会话签发两小时有效的签名令牌；公开回答只投影文字、推理和图片，不暴露来源面板、工具参数和内部 ID。
生成只读快照，去掉内部 ID 和私有路径。令牌只在创建时显示一次，服务端只存哈希，随时可以撤销。
网页组件的访客不需要账号，回答以发布者有权使用的智能体运行。发布前请确认这个智能体能访问的知识和工具适合公开；推理文本会原样对访客可见。
撤销立即生效
- 移除成员。成员关系转为撤销；他钉定该组织的有效 Key 在同一个事务里被停用。重新加入会创建新的成员记录，历史授权不会复活。
- 停用账号。在下一次网页会话、API Key 或流式连接认证时立即生效。
- 暂停组织。组织业务资源的访问全部失败关闭，包括已经发布的网页组件。
- 取消订阅。内容读取被撤销，目录信息仍然可见。
用户、角色、Key 等关键变更都会写入审计日志，记录操作者、动作和时间；智能体和外部 MCP 的工具调用也会进入调用明细账本，可以回答“谁在什么入口调用了什么工具”。
边界
- 权限决定“能不能读”，不决定“该不该说”。智能体能读到的内容都可能出现在回答里，敏感资料应放在单独的知识库并收窄授权。
- 网页组件没有访客级的数据隔离：所有访客共享同一个智能体能访问的范围。
- 配额与限流是另一套机制，它们限制用量，不改变可见范围。
出问题时查哪一环
同事说能看到，我却提示“不存在”
你和这个知识库没有关系：不是它所在组织的成员，或者没有订阅。确认你当前所在的工作区是否正确，再请组织管理员把你加入组织并分配有读取权限的角色。
能打开知识库，但不能上传或修改
你的组织角色缺少写入权限，例如 Viewer。请组织管理员调整角色，或分配包含写入动作的自定义角色。
智能体 @ 了知识库却说查不到
@ 只是选材提示。检查智能体托管密钥的知识库范围是否包含它，以及组织当前是否仍能读取它（例如订阅是否已取消）。
站点管理员看不到某个组织的知识库
这是预期行为。站点管理员没有组织数据面的自动旁路，需要作为成员加入该组织。