跳转到主要内容
本快速开始指南，将在几分钟内让您使用 Linkly AI 构建您的第一个AI-ready 的本地知识库，将了解基本的使用方法。

​
开始前

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 时，会出现引导向导，帮助您完成 3 步初始化配置：
1

选择要索引的目录

选择你希望 Linkly AI 索引的文档目录：
  • 我的文档：仅索引 ~/Documents或者我的文档 目录下的所有文档
  • 整台电脑：扫描所有可访问的文档，覆盖范围最广，需要授权
  • 自定义文件夹：手动选择一个指定的文件夹
2

检查访问权限

系统会自动检查所选文件夹的访问权限。如果权限不足（常见于 macOS），需要前往 系统设置 → 隐私与安全性 → 完全磁盘访问权限，添加 Linkly AI，然后重启应用。
3

连接你的 AI 工具

将 Linkly AI 的 MCP 服务添加到你常用的 AI 工具中，实现智能文档搜索。

我们建议您使用 Skills 来辅助集成，这是最简单的方式，只需复制以下 Prompt 到你的 AI 助理中，按提示操作即可同时完成工具和 Skills 的集成：

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

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

​
步骤3：首次使用

应用启动后，Linkly AI 会立即开始索引你的文档并持续监控，在几分钟到几十分钟之间将完成全部索引（取决于文档数量和机器性能）。
首次启动需要下载一个 100M 左右的模型文件，可能需要几分钟到几十分钟不等，但不影响关键词检索功能的使用。下载完毕并完成全部索引后，即可使用自然语言检索功能。
你有两种方式使用 LinklyAI：

使用启动器检索文档

你可以在托盘中点击应用图标（L Logo），或者使用全局快捷键 CMD/Crtl + Shift + L，打开检索启动器窗口，输入关键词或者描述性语言，查找目标文档。还可以进一步预览、查看元信息、打开文档、复制链接等，更多使用帮助查看全文检索启动器文档。

借助 AI Agent 使用

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