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

走完首次启动引导

引导共四屏——封面 → 把资料放进来 → 接入 Agent → 一切就绪（右下角的「1 / 2」「2 / 2」只对中间两屏计数）。每一屏上方展示区的右下角都有两个小按钮，可以随时切换语言和外观。
  • 封面：勾选 已阅读并同意隐私政策，这是继续的必要条件。下方的 帮助改进 Linkly AI（匿名） 遥测开关默认开启，可自行关闭。
  • 把资料放进来：示例资料是必选项，引导一打开就在后台解压并建立索引。下面还列出系统的「文稿」「桌面」「下载」三个目录，默认不勾选，勾上就开始索引。macOS 第一次读取这些目录时会弹出系统授权框，拒绝的话这一行显示「未授权」。
  • 接入 Agent：点「安装」会在后台装好 Linkly CLI 与 Skills，不点就不装；「自动保持 CLI 和 Skills 最新」默认开启。这一屏还有一句可以直接发给 Agent 的设置指令。
  • 一切就绪：点「立即开始」结束引导，进入主窗口首页。首页顶部的清单会接着带你添加目录、接入 Agent 等。
引导里没有登录这一步。本地文档索引、本地检索和 MCP 服务都不需要登录。想用官方 AI 模型时，到 设置 → 账户 登录即可；没登录也没配置其他模型时，「问答」页会提示你去登录。
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 服务默认端口号。如果无法连接，可以在托盘菜单的「MCP 服务: 运行中 (端口 …)」一行查看实际端口号，也可以在主窗口「Agent 使用」页点「查看 MCP 接入配置」查看。

​
步骤3：首次使用

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

使用启动器检索文档

使用全局快捷键 ⌘ + L（Windows / Linux 为 Ctrl + L）打开检索启动器窗口，输入关键词或者描述性语言，查找目标文档。也可以右键点击托盘的 L 图标，选菜单里的「搜索」（左键点击托盘打开的是主窗口）。从旧版本升级的用户会保留原来的快捷键，可在 设置 → 快捷键 查看。还可以进一步预览、查看元信息、打开文档、复制链接等，更多使用帮助查看全文检索启动器文档。

借助 AI Agent 使用

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