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

# 使用知识库

> 将文档按主题组织为独立的知识库，实现更精准的搜索和更高效的知识管理。

## 什么是知识库

知识库（Library）是 Linkly AI 中用于组织文档的容器。你可以将相同主题的文档放到一个知识库中，在搜索时按库过滤，快速锁定目标文档。

<CardGroup cols={2}>
  <Card title="主题隔离" icon="layer-group" iconType="duotone">
    将"工作文档"与"学术论文"分开管理，搜索时互不干扰
  </Card>

  <Card title="精准搜索" icon="bullseye" iconType="duotone">
    在启动器或 MCP/CLI 中限定搜索范围到特定知识库
  </Card>
</CardGroup>

**知识库是可选的高级功能**。不创建知识库不影响任何现有功能——默认仍然是全局检索。知识库适合文档较多、需要分类管理的用户。

### 使用场景

* **研究人员**：将不同课题的论文分别归入 `ml-papers`、`neuroscience` 等知识库
* **开发者**：将项目文档、API 规范、会议记录分开存放
* **团队协作**：为不同项目创建独立知识库，通过 MCP 让 AI 助理只在相关知识库中搜索
* **个人知识管理**：将笔记、书摘、参考资料分类整理

## 创建知识库

<Steps>
  <Step title="打开知识库页面">
    进入**设置 → 知识库**，你会看到知识库列表页（首次使用为空）。
  </Step>

  <Step title="创建新知识库">
    点击右上角**新建知识库**按钮，在弹出的对话框中填写：

    * **名称**（必填）：知识库的唯一标识，仅允许小写字母、数字和连字符（如 `my-research`、`work-2024`）
    * **描述**（可选）：简短描述知识库的用途

    <Tip>
      名称采用 slug 格式，也用作搜索时的过滤参数，建议简短易记。
    </Tip>
  </Step>

  <Step title="添加文件夹">
    创建完成后进入知识库详情页，点击**添加文件夹**按钮，在系统文件选择对话框中选择一个文件夹。

    一个知识库可以包含多个文件夹。文件夹添加后，Linkly AI 会自动扫描其中的文档并建立索引。
  </Step>
</Steps>

### 管理知识库

在知识库详情页，你可以：

* **编辑**：点击铅笔图标修改名称或描述
* **删除文件夹**：点击文件夹右侧的删除图标，移除该文件夹与知识库的关联（不会删除实际文件）
* **删除知识库**：点击删除图标，确认后删除整个知识库。已索引的文档不受影响，仍可通过全局搜索找到

## 在启动器中按库搜索

启动器支持通过 `@` 触发知识库范围搜索：

<Steps>
  <Step title="输入 @ 进入选库模式">
    在启动器搜索框中输入 `@`，搜索框切换为知识库候选列表。继续输入可按名称过滤。
  </Step>

  <Step title="选择知识库">
    点击或按 Enter 选中目标知识库。搜索框左侧会出现蓝色标签（如
    `@my-research`），表示搜索范围已限定。
  </Step>

  <Step title="输入搜索词">
    在限定范围内搜索，结果仅来自该知识库包含的文件夹。
  </Step>

  <Step title="退出限定搜索">
    在搜索框为空时按退格键（`Backspace`），或点击左侧返回按钮，即可退出知识库范围，回到全局搜索。
  </Step>
</Steps>

## 通过 AI 助理使用

连接 Linkly AI 的 AI 助理（如 Openclaw、Claude、Cursor 等）可以直接按知识库搜索。你只需用自然语言告诉它搜索范围：

<CardGroup cols={1}>
  <Card title="按知识库搜索" icon="magnifying-glass" iconType="duotone" horizontal>
    "在我的 ml-papers 知识库中搜索 attention mechanism 相关的文档"
  </Card>

  <Card title="查看可用知识库" icon="list" iconType="duotone" horizontal>
    "列出我有哪些知识库"
  </Card>

  <Card title="组合过滤" icon="filter" iconType="duotone" horizontal>
    "在 ml-papers 知识库中搜索 transformer 相关的 PDF 文件"
  </Card>
</CardGroup>

AI 助理会自动调用对应的MCP 或 CLI 工具完成搜索。

## 在 CLI 中使用

### 列出知识库

```bash theme={null}
linkly list-libraries
```

### 按知识库搜索

```bash theme={null}
linkly search "attention mechanism" --library ml-papers
```

组合路径过滤：

```bash theme={null}
linkly search "transformer" --library ml-papers --path-glob "*.pdf"
```

<Tip>知识库即将支持推送到云端使用，24 小时永远在线。</Tip>

## 常见问题

<AccordionGroup>
  <Accordion title="添加到知识库的文件夹会重新索引吗？">
    不会。如果文件夹中的文档已经通过文件夹管理添加并完成索引，创建知识库时不会触发重复索引。知识库只是在现有索引之上建立了一层逻辑分组。
  </Accordion>

  <Accordion title="升级到 v0.3.0 后会触发重新索引吗？">
    v0.3.0 调整了关键词索引结构，升级后会自动重建关键词索引。这个过程只涉及索引结构调整，不会重新解析文档内容，速度比全量索引快得多。根据文档数量，通常需要几分钟到几小时不等。
  </Accordion>

  <Accordion title="知识库和文件夹是什么关系？什么时候该用知识库？">
    添加到知识库中的文件夹会自动出现在文件夹管理列表中——知识库本质上是文件夹的一个逻辑分组，是可选功能。

    **直接添加文件夹**适合大多数用户：文件夹是全局的，支持本地搜索和通过 MCP 远程隧道访问。

    **知识库**适合需要按主题隔离搜索范围的场景，例如将"工作"和"学术"文档分开检索。此外，知识库未来将支持推送到云端，以及与特定外部工具的集成。

    如果没有特别的分类需求，不创建知识库完全不影响使用。
  </Accordion>
</AccordionGroup>