> ## 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.

# 使用云端知识库

> 把本地知识库推送到云端，24 小时在线，脱离本机被任意 AI 助理检索，也可以分享给他人。

## 什么是云端知识库

[知识库](/docs/zh/use-libraries)默认只存在于你自己的电脑上——应用没开、电脑没联网，就检索不到。**云端知识库**是把某个本地知识库的内容推送到 Linkly AI 服务端的一份副本：它 24 小时在线，不依赖你的电脑，任何支持 MCP 的 AI 工具都能直接检索，也可以分享给别人。

<CardGroup cols={2}>
  <Card title="脱离本机在线" icon="cloud" iconType="duotone">
    电脑关机、应用没启动，AI 助理照样能检索到内容
  </Card>

  <Card title="可以分享" icon="users" iconType="duotone">
    公开发布，或通过邮箱邀请指定的人使用
  </Card>
</CardGroup>

### 和「远程访问」有什么区别

这两个功能名字接近，解决的却是相反方向的问题，很容易混淆：

| 功能                                | 解决的问题                         | 依赖你的电脑   | 可分享 | 计划   |
| --------------------------------- | ----------------------------- | -------- | --- | ---- |
| [远程访问](/docs/zh/use-in-remote)（MCP 隧道） | 让云端的 AI 应用**穿透回你的本机**读取文档     | 必须开机且已连接 | 否   | Pro  |
| **云端知识库**                         | 让选中的内容**脱离本机**在线，被更多 Agent 使用 | 不依赖      | 是   | 免费可用 |

简单判断：想让 ChatGPT 读你电脑上**全部**文档 → 用远程访问；想让某一批资料**永远在线**、还能给别人用 → 用云端知识库。两者可以同时用。

### 适合什么场景

* **需要 24 小时可用**：手机上、出差时、电脑关机时也要能问自己的资料
* **给团队或客户提供资料**：把产品文档、规范、案例库做成一个库分享出去
* **公开发布知识库**：整理好的主题资料集，让任何人都能用自己的 AI 助理来检索
* **多台设备共用**：一处推送，多处检索，不用在每台电脑上重复索引

***

## 创建并推送（库主视角）

云端知识库要在网页上先建好"壳"，再用桌面应用把本地内容推上去。

<Steps>
  <Step title="在网页上新建云端知识库">
    前往 [linkly.ai](https://linkly.ai) 登录后，进入 **Dashboard → 我的知识库**，点击「新建」（直达地址 `https://linkly.ai/libraries/new`）。

    首次创建需要先设置**用户名**——云端知识库的地址形如 `linkly.ai/<username>/<slug>`，所以账号需要一个唯一用户名。

    填写内容：

    * **知识库标题**：展示用的名字，可以是中文
    * **Slug**：地址里的那一段，6–60 字符，仅小写字母、数字和连字符
    * **描述**（可选）：一句话说明这个库是给谁用的、装了什么
    * **分类**：便于被发现，随时可改
    * **可见性**：见下方[分享给他人](#分享给他人)
  </Step>

  <Step title="用桌面应用绑定">
    创建完成后会看到一个「在 Linkly Desktop 中绑定」按钮，点击会唤起桌面应用。

    如果没有唤起，用页面上的「复制库地址」，然后到桌面应用里手动绑定：打开 **设置 → 知识库**，选中要推送的那个本地知识库，在「云端知识库」面板中点击「已经创建好了？粘贴库 URL」，粘贴后点「绑定」。

    <Note>
      绑定是**本地库 ↔ 云端库**的一对一关系。云端库是本地库的一份副本，内容以本地为准。
    </Note>
  </Step>

  <Step title="推送内容">
    绑定后，「云端知识库」面板会显示待推送的文档数量。点击「推送」开始上传，过程中可以暂停、继续、查看处理详情；中断后再次点击会从断点继续。

    推送完成后卡片显示「已同步到云端」和文档数量。本地有新增或修改时，卡片会变成「本地有更新」，再点一次推送即可。
  </Step>

  <Step title="开启自动同步（推荐）">
    在「云端知识库」面板中打开「自动同步」，应用会每 5 分钟检查一次变更并自动推送，不用再手动点。
  </Step>
</Steps>

### 解绑

在「云端知识库」面板的菜单里选择「解绑此云端库」，本地就不再向云端推送。**云端已有的内容会保留**，随时可以重新绑定。

如果要彻底删除云端那一份，去网页的库设置页 → 危险区 → 删除知识库。删除会一并清除文件、邀请、收藏和所有人的连接关系，不可恢复。

***

## 连接知识库（使用者视角）

要让 AI 助理能检索某个云端知识库，第一步是把它**连接**到你的账号：打开这个库的网页地址，点击右上角的「**连接**」按钮（英文界面是 **Link**），按钮变成「**已连接**」即成功。

<Warning>
  \*\*即使是你自己创建的库，也必须点一次「连接」。\*\*MCP
  的可检索范围以"连接关系"为准，而不是"所有权"——没连接的库，哪怕是自己的，AI
  助理也看不到。
</Warning>

连接是**你的账号**和**这个库**之间的关系，与库主无关：

* 库主看得到有哪些人连接了自己的库（库设置 → 使用者）
* 你随时可以再点一次断开连接，不影响库本身
* 每个连接占用一个**连接位（Slot）**，免费账户有 1 个，Pro 有 99 个

***

## 在 AI 助理中使用

云端知识库通过 Linkly AI 的云端 MCP 网关对外提供检索，端点固定：

```
https://mcp.linkly.ai/mcp
```

在 AI 客户端里添加时，**服务器名称请用 `linkly-ai-cloud`**。这个名字用来和本地桌面应用的 `linkly-ai` 区分开——两者可以同时配置，互不影响；用同一个名字则会互相覆盖。

### 三种接入方式

| 你用的工具                                 | 怎么接                                    |
| ------------------------------------- | -------------------------------------- |
| Claude Code、Codex、Cursor、Gemini CLI 等 | HTTP MCP + API 密钥（请求头里带 `Bearer`）      |
| ChatGPT、Claude.ai 等在线应用               | 填 URL 后走 OAuth 授权，不需要 API 密钥           |
| Linkly AI CLI                         | `linkly auth set-key` 后加 `--remote` 参数 |

以 Claude Code 为例：

```bash theme={null}
claude mcp add --transport http linkly-ai-cloud https://mcp.linkly.ai/mcp \
  --header "Authorization: Bearer lkai_你的密钥"
```

API 密钥在[控制台](https://linkly.ai/dashboard/integrations)的「**API 密钥**」区创建，以 `lkai_` 开头。各客户端的具体配置格式见[各 AI 客户端集成指南](/docs/zh/integration)。

<Tip>
  嫌手动配置麻烦？在任意云端知识库页面点击「**在 AI
  中使用**」，复制弹窗里的那句话发给你的 AI
  助理，它会读[接入指南](/docs/zh/library-setup)并引导你走完全程。
</Tip>

### 怎么指定库

云端知识库的标识形如 `cloud://<owner>/<slug>`，就是网页地址里的那两段：

```
网页地址  https://linkly.ai/blueeon/linkly-init-example
库标识    cloud://blueeon/linkly-init-example
```

用 `list_libraries` 可以列出你已连接的全部知识库和它们的准确标识。

<Warning>
  **每次检索都要显式指定库。**省略库参数时，请求会默认路由到你的本机（走远程隧道），而隧道是
  Pro
  功能——免费账户会直接收到报错。云端知识库**永远不会**被隐式包含进来，需要查哪个就写哪个；要查两个库就调两次。
</Warning>

对 AI 助理来说，你不需要记这些语法，直接说清楚库名即可：

<CardGroup cols={1}>
  <Card title="按云端库检索" icon="magnifying-glass" iconType="duotone" horizontal>
    "在 blueeon/linkly-init-example 这个云端知识库里搜一下 RAG 相关的资料"
  </Card>

  <Card title="查看有哪些库" icon="list" iconType="duotone" horizontal>
    "列出我连接了哪些知识库"
  </Card>
</CardGroup>

***

## 在桌面应用中使用

装了 Linkly AI 桌面应用的话，不用配置任何 MCP 也能用云端知识库：

* 打开 **设置 → 知识库**，在「已连接的云端知识库」区域可以看到全部已连接的库，并按库开关是否在 Chat 中可用
* 在应用内的 Chat 里用 `@` 提及某个云端知识库，就能像本地库一样检索它

这一区是只读的——连接和断开都在网页上操作。如果列表是空的，先去网页把库连接上。

***

## 分享给他人

云端知识库有三种可见性，在库设置页随时切换：

| 可见性          | 谁能看到详情和文件列表 | 谁能连接并检索    | 会被探索页和搜索引擎收录 |
| ------------ | ----------- | ---------- | ------------ |
| **Public**   | 所有人         | 所有登录用户     | 是            |
| **Showcase** | 所有人         | 仅被邀请的成员    | 是            |
| **Private**  | 仅所有者和被邀请的人  | 仅所有者和被邀请的人 | 否            |

**邀请他人**：在库设置页 → 分享管理，输入对方邮箱发送邀请。对方接受后成为阅读者，就能在自己的账号里连接这个库并检索。

<Note>
  切换可见性时如果是**收紧**（例如 Public →
  Private），会立刻移除非阅读者的连接和收藏关系，且不可撤销；**已接受邀请的阅读者永远保留**。操作前页面会明确列出将被清理的数量。
</Note>

***

## 配额与限制

|            | 免费        | Pro                         |
| ---------- | --------- | --------------------------- |
| 可创建的云端知识库  | 1 个       | 30 个                        |
| 每个库的文档上限   | 500 篇     | 2000 篇                      |
| 可连接的知识库    | 1 个       | 99 个                        |
| 可选的可见性     | 仅 Private | Public / Showcase / Private |
| 云端检索       | 可用        | 可用                          |
| 远程隧道（访问本机） | 不可用       | 可用                          |

**免费账户创建的库只能是 Private**，也就是只有自己和被邀请的人能用。想公开发布或做成展示型知识库，需要升级 [Pro](https://linkly.ai/pricing)。

超出配额时不会影响已有内容——已经创建的库、已经推送的文档都不受影响，只是无法再新建。

***

## 常见问题

<AccordionGroup>
  <Accordion title="推送到云端的内容安全吗？">
    只有你主动推送的知识库会上传。文档正文、向量和元数据加密传输并存储在服务端，可见性由你自己控制，默认是 Private。不想再放在云端时，删除云端知识库会一并清除全部内容。
  </Accordion>

  <Accordion title="云端库和本地库的内容会自动保持一致吗？">
    不会实时同步。默认需要手动点「推送」；开启「自动同步」后，应用每 5
    分钟检查一次变更并自动推送。云端是本地的一份副本，方向是单向的——在云端不能编辑内容。
  </Accordion>

  <Accordion title="为什么我自己的库在 AI 助理里也搜不到？">
    最常见的原因是没点「**连接**」。检索范围以连接关系为准，不以所有权为准，自己的库同样要在库页面上点一次「连接」。
  </Accordion>

  <Accordion title="AI 助理说找不到 cloud:// 开头的库？">
    你连的多半是**本地** MCP（`127.0.0.1:60606`，服务器名
    `linkly-ai`）。这条路径上云端知识库不可达。需要另外添加云端网关连接：URL
    `https://mcp.linkly.ai/mcp`，服务器名 `linkly-ai-cloud`。两者可以共存。
  </Accordion>

  <Accordion title="解绑或删除本地知识库，云端的会消失吗？">
    不会。解绑只是停止推送，云端内容保留，随时可以重新绑定。要删除云端那一份，需要在网页的库设置页
    → 危险区里明确删除。
  </Accordion>

  <Accordion title="别人分享给我的库，会占用我的库数量配额吗？">
    不会。创建数量和连接数量是两套配额：别人的库只占用你的**连接位**，不算进你可创建的库数量里。
  </Accordion>
</AccordionGroup>

***

## 延伸阅读

* [给 Agent 的云端库接入指南](/docs/zh/library-setup) —— 把接入过程交给 AI 助理自动完成
* [使用知识库](/docs/zh/use-libraries) —— 本地知识库的创建与按库检索
* [远程访问](/docs/zh/use-in-remote) —— 让云端 AI 穿透访问本机文档
* [工具介绍](/docs/zh/tools-intro) —— 检索工具的完整参数说明