Skip to main content

​
什么是云端知识库

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

脱离本机在线

电脑关机、应用没启动，AI 助理照样能检索到内容

可以分享

公开发布，或通过邮箱邀请指定的人使用

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

这两个功能名字接近，解决的却是相反方向的问题，很容易混淆： 简单判断：想让 ChatGPT 读你电脑上全部文档 → 用远程访问；想让某一批资料永远在线、还能给别人用 → 用云端知识库。两者可以同时用。

​
适合什么场景

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

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

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

在网页上新建云端知识库

前往 linkly.ai 登录后，进入 Dashboard → 我的知识库，点击「新建」（直达地址 https://linkly.ai/libraries/new）。首次创建需要先设置用户名——云端知识库的地址形如 linkly.ai/<username>/<slug>，所以账号需要一个唯一用户名。填写内容：
  • 知识库标题：展示用的名字，可以是中文
  • Slug：地址里的那一段，6–60 字符，仅小写字母、数字和连字符
  • 描述（可选）：一句话说明这个库是给谁用的、装了什么
  • 分类：便于被发现，随时可改
  • 可见性：见下方分享给他人
2

用桌面应用绑定

创建完成后会看到一个「在 Linkly Desktop 中绑定」按钮，点击会唤起桌面应用。如果没有唤起，用页面上的「复制库地址」，然后到桌面应用里手动绑定：打开 设置 → 知识库，选中要推送的那个本地知识库，在「云端知识库」面板中点击「已经创建好了？粘贴库 URL」，粘贴后点「绑定」。
绑定是本地库 ↔ 云端库的一对一关系。云端库是本地库的一份副本，内容以本地为准。
3

推送内容

绑定后，「云端知识库」面板会显示待推送的文档数量。点击「推送」开始上传，过程中可以暂停、继续、查看处理详情；中断后再次点击会从断点继续。推送完成后卡片显示「已同步到云端」和文档数量。本地有新增或修改时，卡片会变成「本地有更新」，再点一次推送即可。
4

开启自动同步（推荐）

在「云端知识库」面板中打开「自动同步」，应用会每 5 分钟检查一次变更并自动推送，不用再手动点。

​
解绑

在「云端知识库」面板的菜单里选择「解绑此云端库」，本地就不再向云端推送。云端已有的内容会保留，随时可以重新绑定。 如果要彻底删除云端那一份，去网页的库设置页 → 危险区 → 删除知识库。删除会一并清除文件、邀请、收藏和所有人的连接关系，不可恢复。

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

要让 AI 助理能检索某个云端知识库，第一步是把它连接到你的账号：打开这个库的网页地址，点击右上角的「连接」按钮（英文界面是 Link），按钮变成「已连接」即成功。
**即使是你自己创建的库，也必须点一次「连接」。**MCP 的可检索范围以”连接关系”为准，而不是”所有权”——没连接的库，哪怕是自己的，AI 助理也看不到。
连接是你的账号和这个库之间的关系，与库主无关：
  • 库主看得到有哪些人连接了自己的库（库设置 → 使用者）
  • 你随时可以再点一次断开连接，不影响库本身
  • 每个连接占用一个连接位（Slot），免费账户有 1 个，Pro 有 99 个

​
在 AI 助理中使用

云端知识库通过 Linkly AI 的云端 MCP 网关对外提供检索，端点固定：
在 AI 客户端里添加时，服务器名称请用 linkly-ai-cloud。这个名字用来和本地桌面应用的 linkly-ai 区分开——两者可以同时配置，互不影响；用同一个名字则会互相覆盖。

​
三种接入方式

以 Claude Code 为例：
API 密钥在控制台的「API 密钥」区创建，以 lkai_ 开头。各客户端的具体配置格式见各 AI 客户端集成指南。
嫌手动配置麻烦？在任意云端知识库页面点击「在 AI 中使用」，复制弹窗里的那句话发给你的 AI 助理，它会读接入指南并引导你走完全程。

​
怎么指定库

云端知识库的标识形如 cloud://<owner>/<slug>，就是网页地址里的那两段：
用 list_libraries 可以列出你已连接的全部知识库和它们的准确标识。
每次检索都要显式指定库。省略库参数时，请求会默认路由到你的本机（走远程隧道），而隧道是 Pro 功能——免费账户会直接收到报错。云端知识库永远不会被隐式包含进来，需要查哪个就写哪个；要查两个库就调两次。
对 AI 助理来说，你不需要记这些语法，直接说清楚库名即可：

按云端库检索

“在 blueeon/linkly-init-example 这个云端知识库里搜一下 RAG 相关的资料”

查看有哪些库

“列出我连接了哪些知识库”

​
在桌面应用中使用

装了 Linkly AI 桌面应用的话，不用配置任何 MCP 也能用云端知识库：
  • 打开 设置 → 知识库，在「已连接的云端知识库」区域可以看到全部已连接的库，并按库开关是否在 Chat 中可用
  • 在应用内的 Chat 里用 @ 提及某个云端知识库，就能像本地库一样检索它
这一区是只读的——连接和断开都在网页上操作。如果列表是空的，先去网页把库连接上。

​
分享给他人

云端知识库有三种可见性，在库设置页随时切换： 邀请他人：在库设置页 → 分享管理，输入对方邮箱发送邀请。对方接受后成为阅读者，就能在自己的账号里连接这个库并检索。
切换可见性时如果是收紧（例如 Public → Private），会立刻移除非阅读者的连接和收藏关系，且不可撤销；已接受邀请的阅读者永远保留。操作前页面会明确列出将被清理的数量。

​
配额与限制

免费账户创建的库只能是 Private，也就是只有自己和被邀请的人能用。想公开发布或做成展示型知识库，需要升级 Pro。 超出配额时不会影响已有内容——已经创建的库、已经推送的文档都不受影响，只是无法再新建。

​
常见问题

只有你主动推送的知识库会上传。文档正文、向量和元数据加密传输并存储在服务端，可见性由你自己控制，默认是 Private。不想再放在云端时，删除云端知识库会一并清除全部内容。
不会实时同步。默认需要手动点「推送」；开启「自动同步」后，应用每 5 分钟检查一次变更并自动推送。云端是本地的一份副本，方向是单向的——在云端不能编辑内容。
最常见的原因是没点「连接」。检索范围以连接关系为准，不以所有权为准，自己的库同样要在库页面上点一次「连接」。
你连的多半是本地 MCP（127.0.0.1:60606，服务器名 linkly-ai）。这条路径上云端知识库不可达。需要另外添加云端网关连接：URL https://mcp.linkly.ai/mcp，服务器名 linkly-ai-cloud。两者可以共存。
不会。解绑只是停止推送，云端内容保留，随时可以重新绑定。要删除云端那一份，需要在网页的库设置页 → 危险区里明确删除。
不会。创建数量和连接数量是两套配额：别人的库只占用你的连接位，不算进你可创建的库数量里。

​
延伸阅读