> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 企业知识引擎

<Info>
  适用版本：Teams / Enterprise
</Info>

企业知识引擎让团队的工程知识「一处生成、全队可见」。它聚合 Qoder Desktop 上生成的三类知识，并按仓库与分支组织，供团队成员浏览、搜索与复用。

<Frame>
  <img src="https://mintcdn.com/qoder/TAvYJ6UWkXEIFXbj/images/enterprise/knowledge-engine-flow.png?fit=max&auto=format&n=TAvYJ6UWkXEIFXbj&q=85&s=2e336991aa915b81ec5ed15b80fe1a0c" alt="企业知识引擎数据流" width="1442" height="404" data-path="images/enterprise/knowledge-engine-flow.png" />
</Frame>

<Warning>
  企业知识引擎默认关闭。必须由团队管理员在「知识库配置（Knowledge Base Configuration）」中开启「团队知识采集（Team Knowledge Collection）」开关，采集与共享才会生效。
</Warning>

## 知识来源

企业知识引擎只同步在 Qoder Desktop 客户端上生成的以下三类知识，引擎侧不单独生成内容：

| 知识类型                      | 说明                                                                                                      |
| ------------------------- | ------------------------------------------------------------------------------------------------------- |
| **RepoWiki**              | 基于代码仓库自动生成的工程 Wiki，呈现仓库的整体结构与说明                                                                         |
| **知识卡片（Knowledge Cards）** | 从代码仓库、spec、对话历史、plan、commit message 等来源抽取的原子知识单元，类型包括 overview、tech stack、convention、setup & commands 等 |
| **记忆卡片（Memory Cards）**    | 基于团队成员与 Qoder 的对话历史，沉淀总结出的团队知识，并附带评分等信息                                                                 |

## 浏览知识库

**进入路径：** 组织 Organization → 知识库 Knowledge Base

知识库列表页每个仓库以一张卡片呈现，显示图标、仓库名，底部展示「Updated at xxx · N cards」，并按更新时间倒序排列。

* 顶部左侧为**搜索框**（Search repository name…），按仓库名过滤并高亮命中
* 右侧显示仓库总数（如 40 repositories）
* 点击任意卡片，进入对应仓库的详情页

<Frame>
  <img src="https://mintcdn.com/qoder/TAvYJ6UWkXEIFXbj/images/enterprise/knowledge-base-list.jpg?fit=max&auto=format&n=TAvYJ6UWkXEIFXbj&q=85&s=8678846e0dcbfcb8633a921a02343393" alt="知识库列表" width="1600" height="818" data-path="images/enterprise/knowledge-base-list.jpg" />
</Frame>

## 仓库详情与分支

详情页以**分支**为根上下文，分支选择器位于仓库名右侧。

**三个 Tab：** RepoWiki、知识卡片、记忆卡片。切换 Tab 不会重置已选分支。

**切换分支：** RepoWiki 与知识卡片内容一并刷新，保留当前所在 Tab 并清空 Tab 内搜索。记忆卡片 Tab 下不支持切换分支。

**搜索（两类语义）：**

* 在 RepoWiki 下为「内容定位」，在正文高亮匹配并支持上/下逐处跳转
* 在知识卡片 / 记忆卡片下为「列表过滤」，按标题或内容筛选列表并显示命中条数

**类型筛选：** 仅知识卡片 Tab 提供，按 overview / tech stack / convention / setup & commands 等类型（含数量）筛选。

## 团队知识采集与共享

**入口：** 列表页右上角齿轮图标 → 知识库配置 Knowledge Base Configuration

核心配置项为「**团队知识采集 Team Knowledge Collection**」开关：

* 仅团队管理员可修改，默认关闭
* 开启后，将从客户端收集团队成员生成的 RepoWiki、知识卡片与记忆卡片，并在团队内共享（采集与共享同时生效）
* 开启与关闭均有二次确认弹窗

<Frame>
  <img src="https://mintcdn.com/qoder/TAvYJ6UWkXEIFXbj/images/enterprise/knowledge-base-config.jpg?fit=max&auto=format&n=TAvYJ6UWkXEIFXbj&q=85&s=820dc0cef75189e808a461fa242fdc26" alt="知识库配置" width="1600" height="819" data-path="images/enterprise/knowledge-base-config.jpg" />
</Frame>

**列表内容与开关绑定：**

* 采集未开启时，列表页展示空态并提供「前往设置开启」入口
* 开启后列表才会出现知识库
* 开关刚开启、内容尚未同步完成时，会显示「采集中」的中间态

## 端侧同步与数据保留

团队成员在 Qoder Desktop 端通过「同步团队知识」开关与引擎联动：

* 当成员打开本地项目、且本地尚无知识时，若云端存在该分支的知识，会**自动拉取**到本地
* 本地已有知识时，云端版本更新则覆盖本地
* 「同步团队知识」开关**默认开启**；首次使用 `/knowledge` 修改知识后会自动关闭同步（之后由用户手动控制）
* 仓库无 git remote 信息时该开关不可用

<Warning>
  关闭企业知识引擎后会暂停采集与更新。已采集的数据只会保留一段时间，超过一定时间后将被删除，并非永久保留。如需保留这些知识，请在关闭前做好备份。
</Warning>
