大脑知识库
大脑知识库把组织内所有角色的知识库汇总成一棵「团队大脑」树，可以集中浏览、新建、上传、编辑、删除各角色的知识文档，查看文档之间的双向链接，并设置每个角色在对话时还能检索哪些其他角色的知识库。它与每个角色自己的「知识库」页是同一份数据，在任一处做的修改另一处立即可见。
页面概览
大脑知识库位于左侧导航「主控制台」中，在「角色流转」和「技能市场」之间。页面通常分为两部分：左侧是知识树，右侧是选中文档的详情。
页面提供两种数据来源：
| 数据来源 | 说明 |
|---|---|
| 我的数据 | 本组织各角色的真实知识库，所有操作都会写入角色知识库，并参与角色对话检索 |
| 示例数据 | 内置的演示数据（如财务员、客服助手等虚拟角色的文档），仅供了解页面效果，只读，不影响任何角色 |
「示例数据」只是演示用，系统重启后会恢复原样，也不会被任何角色检索到。日常使用请切换到「我的数据」。
与角色「知识库」页的区别
| 对比项 | 大脑知识库 | 角色的「知识库」页 |
|---|---|---|
| 查看范围 | 组织内所有在用角色，一次看全 | 只看当前这一个角色 |
| 文档数据 | 同一份数据，双向同步 | 同一份数据，双向同步 |
| 新建文档 / 文件夹、上传、删除、重新入库 | ✅ | ✅ |
| 文档间双向链接、反向链接 | ✅ 在文档详情中查看 | — |
| 设置挂载其他角色的知识库 | ✅ 在这里设置 | 只能查看（只读） |
| 检索严格度、注入位置、二次精排、检索测试 | — | ✅ 在角色页设置 |
简单说：想跨角色整理知识、配置「谁能查谁的库」，来大脑知识库；想调某个角色的检索效果，去该角色的知识库页。
知识树
知识树按四层组织：
- 团队大脑：顶层节点，显示组织名称
- 角色：组织内每个在用的角色一个节点，显示文档数量
- 文件夹：角色知识库里的文件夹，可以多级嵌套
- 文档：具体的知识文档
同一层里文件夹排在前、文档排在后，各自按名称排序。已停用的角色不会出现在树里。
文档详情
在知识树中点击一篇文档，可以查看：
| 内容 | 说明 |
|---|---|
| 路径 | 角色 / 文件夹 / 文件名 |
| 来源 | 手动新建、上传、压缩包解包、目录同步或接口导入等 |
| 文件类型、大小、创建时间 | 文档的基本信息 |
| 状态 | 处理中（可看到进度）、已就绪、失败，或「卡住」 |
| 分块 | 文档被切分后的各个片段及其小标题，即角色检索时实际使用的内容 |
| 正文 | 把各分块拼回的完整正文 |
| 链接 / 反向链接 / 未解析链接 | 见下文「双向链接」 |
文档状态
| 状态 | 含义 | 处理方式 |
|---|---|---|
| 处理中 | 正在解析、分块、向量化 | 稍等片刻，页面会显示进度 |
| 已就绪 | 已可被角色检索 | — |
| 失败 | 入库出错 | 可以重新入库 |
| 卡住 | 显示处理中，但后台已经没有任务在跑（例如服务重启后） | 可以重新入库 |
只有「失败」或「卡住」的文档可以重新入库。正在处理的文档会提示「文档正在入库中，请稍候」；已完成的文档会提示「无需重试」。
新建与上传
新建文件夹
选择所属角色，填写文件夹名称，可以选择放在某个已有文件夹下面，形成多级目录。
新建文档（手动编写）
选择所属角色和文件夹，填写标题和正文即可。正文最多约 20 万字。保存后文档进入「处理中」，系统在后台自动分块、向量化，并解析正文中的双向链接。
上传文件
选择所属角色和文件夹后上传文件：
- 支持的格式与角色知识库页完全一致（如 PDF、Word、Excel、PPT、Markdown、TXT、HTML 等），也支持上传 zip 压缩包，系统会在后台解包后逐个入库
- 单个文件默认不超过 50 MB，超过时会提示「文件超过 50 MB」
- 上传后的解析、分块、向量化流程与在角色页上传完全相同
上下文增强（可选）
新建、上传和编辑时可以选择是否开启上下文增强。开启后，系统入库时会借助该角色配置的模型为片段补充上下文，有助于提升检索准确度，但入库更慢，并会消耗模型用量。角色没有可用模型时会自动按不增强处理。
编辑与删除
只有手动新建的文档可以在线编辑
| 文档来源 | 能否在线编辑 |
|---|---|
| 在页面上手动新建 | ✅ 可以改标题和正文 |
| 上传、压缩包、目录同步、接口导入 | ❌ 只读 |
对只读文档尝试编辑时，会提示「该文档来自上传/目录/API，请在源头修改后重新入库；只有手动新建的文档可在线编辑」。这类文档请修改原文件后重新上传。
编辑手动文档（包括只改标题）后，系统会清除旧的分块和链接，重新分块、向量化，期间文档状态回到「处理中」，提示「已保存，正在重新向量化」。
删除文档
删除会同时移除该文档在角色知识库中的记录、分块和原始文件，角色之后不会再检索到它。
删除不可恢复，并且对角色知识库页同步生效。删除前请确认这篇文档没有其他用途，必要时先留存原文件。
双向链接
在文档正文里用 [[文档标题]] 的写法，可以链接到同一角色知识库里的另一篇文档：
- 链接：本篇文档指向的其他文档
- 反向链接：同一角色里有哪些文档链接到了本篇
- 未解析链接：写了
[[...]]但找不到对应文档的链接
匹配规则：
- 按文件名（去掉扩展名）匹配，不区分大小写
- 只在同一角色内匹配，不能跨角色链接
- 同一角色里有重名文档时，以最早创建的那篇为准
看到「未解析链接」时，通常是标题写错了或目标文档在别的角色下。把目标文档建在同一角色下、标题保持一致即可。
挂载其他角色的知识库
默认情况下，每个角色对话时只检索自己的知识库。在大脑知识库里可以为每个角色设置「挂载」，让它对话检索时一并检索其他角色的知识库：
| 挂载方式 | 说明 |
|---|---|
| 仅自己 | 只检索本角色的知识库（默认） |
| 全部 | 检索组织内所有角色的知识库，之后新增的角色也会自动包含 |
| 自选 | 勾选指定的若干角色，本角色自己的知识库始终包含在内 |
页面上还能看到每个角色挂载了谁、以及被谁挂载，便于掌握知识的共享关系。
挂载只扩大检索范围，不会复制文档，也不会给对方编辑权限。在角色自己的知识库页上可以看到它挂载了哪些库，但不能在那里修改挂载设置。
谁能使用
大脑知识库没有单独的管理员限制：本组织内登录的账号都可以查看和操作本组织所有角色的知识文档及挂载设置。所有操作都只作用于当前组织的角色，选择不属于本组织的角色时会提示「角色不存在或不属于当前组织」。
由于任何成员都能在这里删除任意角色的文档或修改挂载，建议团队内约定好由谁维护知识库，重要文档保留原始文件。
常见问题
在角色知识库页上传的文档，大脑知识库里看得到吗？ 看得到。两处是同一份数据，任何一边新建、上传、删除，另一边都同步。
为什么我的文档不能编辑？ 只有在页面上手动新建的文档可以在线编辑。上传或同步来的文档请修改原文件后重新上传。
文档一直显示「处理中」怎么办？ 如果显示为「卡住」，说明后台任务已经中断，可以直接重新入库。大文件或压缩包入库需要一些时间，请先耐心等待进度。
挂载了其他角色的库，但角色回答里没有引用？ 挂载只决定检索范围，最终能否命中取决于检索配置和问题内容。可以到该角色的知识库页用「检索测试」验证，或适当放宽检索严格度。
看到的角色名称、文档是虚构的？ 你可能切换到了「示例数据」，切回「我的数据」即可。