Skip to main content
本快速开始指南，将在几分钟内让您使用 Linkly AI 构建您的第一个AI-ready 的本地知识库，将了解基本的使用方法。
**想省事？让 AI 替你装。**如果你手上已经有 Claude Code、Codex、Cursor 这类能执行命令的 AI 助理，把下面这句话发给它，它会读完给 Agent 的安装指南并一步步引导你完成安装、配置和验证——包括你自己需要动手的那几步，它也会说清楚。
当然，继续往下读也完全可以，本文就是一份完整的手动安装指南。

​
开始前

Linkly AI包含了以下核心应用和能力：

Linkly AI Desktop

桌面应用程序（简称 Linkly AI），安装后自动创建索引文档，并提供检索、大纲、读取等工具。

Linkly AI CLI

命令行工具，可在 Bash 中连接你的 Linkly AI 应用并调用其工具，适合 AI Agent 使用。

MCP Server

Agent 获取上下文的开放协议。安装 Linkly AI 后自动启动 MCP 服务，适合 AI Agent 调用。

linkly-ai-skills

官方提供的 Agent Skills，指导 Agent 如何连接和使用 Linkly AI 的工具服务，强烈建议安装。

​
步骤 1：安装Linkly AI

前往官网下载页面，根据您的操作系统，选择对应版本：

下载 Linkly AI

选择适合你操作系统的版本
然后双击安装包安装，不同平台的安装步骤如下：
1

打开安装包

双击下载的 .dmg 文件，挂载磁盘映像
2

拖入应用程序

将 LinklyAI 图标拖入 Applications 文件夹
3

启动应用

在 Launchpad 或 Finder 的 Applications 文件夹中找到 LinklyAI，双击启动

​
步骤 2：初始化 Linkly AI

首次启动 Linkly AI 时，会打开引导窗口带你完成初始设置。之后再把你自己的文档加进来：
1

走完首次启动引导

引导共四屏——封面 → 登录 → 准备中 → 体验面板（右下角的步进器只对中间两屏计数）：
  • 封面：选择界面语言和主题，并勾选 已阅读并同意隐私政策，这是继续的必要条件。下方的 帮助改进 Linkly AI 遥测开关默认开启，可自行关闭。
  • 登录：点「登录账号」打开浏览器完成登录，可获得官方 AI 模型额度和云端知识库功能。这一步可以跳过——页面底部小字里的「跳过登录」是可点击的链接。本地文档索引、本地检索和 MCP 服务都不需要登录。
  • 准备中：应用会解压一批样例文档并建立索引，通常几秒完成。等「立即开始」按钮点亮即可继续。
  • 体验面板：六张功能卡片，点击任意一张或右上角的 × 即可结束引导。
2

添加你自己的文档

引导结束时，应用只索引了内置的样例文档，你自己的文件还没有被索引。跳过这一步，检索将永远搜不到你的真实内容。
两种方式任选：
  • 打开 设置 → 文件夹，添加想要索引的目录，例如「文档」「下载」或某个项目目录；
  • 或者直接把文件放进 ~/LinklyAI 文件夹——该目录默认被监视，放进去的内容会自动索引。
如果系统提示权限不足（常见于 macOS），需要前往 系统设置 → 隐私与安全性 → 完全磁盘访问权限，添加 Linkly AI，然后重启应用。
3

连接你的 AI 工具

将 Linkly AI 的 MCP 服务添加到你常用的 AI 工具中，实现智能文档搜索。
我们建议您使用 Skills 来辅助集成，这是最简单的方式，只需复制以下 Prompt 到你的 AI 助理中，按提示操作即可同时完成工具和 Skills 的集成：

请帮我安装 Agent Skill linkly-ai-skills， 并...

也可以选择手动集成 MCP 工具，但我们仍然建议您安装 Skills 来获得更好的使用体验：
在终端中运行：
其中 60606 为 Linkly AI 的 MCP 服务默认端口号，如果无法连接可在应用设置中查看实际端口号。

​
步骤3：首次使用

应用启动后，Linkly AI 会立即开始索引你的文档并持续监控，在几分钟到几十分钟之间将完成全部索引（取决于文档数量和机器性能）。
首次启动后，应用会在后台下载约 710MB 的模型文件——语义检索模型约 639MB，OCR 模型约 70MB。视网络情况，可能需要几分钟到一小时以上。关键词检索立刻可用，完全不受影响。下载完毕并完成索引后，才能使用自然语言（语义）检索。
有会议录音、播客或课程视频要检索？音频和视频的语音转写默认是关闭的——这类文件仍会被索引、能按文件名搜到，但搜不到里面说了什么。去 设置 → 索引 打开「音频解析」和「视频解析」即可，应用会自动把已有文件补做完。各个索引开关的完整说明见索引设置。
你有两种方式使用 LinklyAI：

使用启动器检索文档

使用全局快捷键 ⌘/Ctrl + Shift + L 打开检索启动器窗口，输入关键词或者描述性语言，查找目标文档。也可以右键点击托盘的 L 图标，选菜单第一项「搜索」（左键点击托盘打开的是 AI 对话窗口）。还可以进一步预览、查看元信息、打开文档、复制链接等，更多使用帮助查看全文检索启动器文档。

借助 AI Agent 使用

这是我们更推荐的方式，你将获得前所未有的交互体验和研究效率。在完成与你的 AI 助理集成或安装 Skills 后，在任意 Prompt 之后跟随 use linkly-ai，来主动使用 Linkly AI 强大的检索能力。