离线安装指南

Linkly AI 的搜索、文字识别（OCR）、语音转写（ASR）和语义搜索都在你的电脑上本地运行，日常使用不需要联网。但正常安装流程里有两步依赖网络：下载安装包，以及首次运行时自动下载 AI 模型文件（合计约 870 MB）。如果目标电脑完全无法访问外网（离线环境、企业内网、隔离网络），按本页流程走一遍即可完成安装：在有网的电脑上把东西下载齐，拷贝过去，然后安装。

模型文件请使用本页提供的官方离线模型包，不要自行从其他渠道下载模型文件、也不要手动拼摆目录——模型文件在人工搬运和转码中很容易损坏，导致 AI 功能报错或不可用。

第一步：要先下载哪些东西

在一台能上网的电脑上，下载以下两样：

应用安装包：在官网下载页选择目标电脑对应的平台（Windows / macOS / Linux）下载。要求版本 v0.9.0 或更高（更早版本的模型目录结构不同，离线模型包对它不适用）。
官方离线模型包：单个 zip 文件，约 850 MB，包含 OCR、语音转写与语义搜索所需的全部模型，并附带说明文件与 SHA-256 校验清单。
（仅目标电脑为 Windows 时）两个系统运行库安装包——离线环境下应用安装器无法自动联网获取它们：
- WebView2 运行时（Evergreen 独立安装包，x64）：Windows 11 和多数装有 Edge 的 Windows 10 已自带；企业精简版 / LTSC 系统可能没有，带上以防安装卡住
- Microsoft VC++ 2015–2022 运行库（x64）：应用的本地 AI 组件依赖它，缺失时安装器会尝试联网下载并失败

下载离线模型包

linkly-ai-offline-models-20260825.zip · 约 850 MB。下载后整包保存，不要打开或编辑其中的任何文件。

第二步：把哪些文件拷贝过去

用 U 盘、移动硬盘或内网文件共享，把下面两个文件原样拷贝到离线电脑上（放在桌面或任意临时位置都行）：

应用安装包（.exe / .dmg / .AppImage 等）
离线模型包 zip（整包拷贝，不要先解压再分开拷）
（Windows）WebView2 与 VC++ 运行库安装包

第三步：怎么执行安装

安装应用

Windows：先依次安装 WebView2 运行时和 VC++ 运行库（已有的会自动跳过，装一遍不会有副作用），再双击应用安装包按向导完成安装
macOS：打开 .dmg，把 Linkly AI 拖入「应用程序」文件夹
Linux：按你使用的包格式安装（AppImage 赋予执行权限后直接运行）

启动一次，然后完全退出

先正常启动一次 Linkly AI——应用会自动创建数据目录（离线状态下它尝试下载模型会失败，不用理会）。然后彻底退出应用：右键系统托盘的 L 图标，选择退出。

打开应用数据目录下的 data 文件夹

按你的操作系统找到（不存在就手动创建出来）：

Windows
macOS
Linux

按 Win + R 打开「运行」，粘贴并回车：

%APPDATA%\ai.linkly.desktop\data

Finder 顶部菜单 前往 → 前往文件夹…（⌘ + ⇧ + G），粘贴并回车：

~/Library/Application Support/ai.linkly.desktop/data

mkdir -p ~/.local/share/ai.linkly.desktop/data
xdg-open ~/.local/share/ai.linkly.desktop/data

也可以从 设置 → 关于 → 数据目录 点「打开」，再进入 data/。

解压模型包，把 models 文件夹放进 data

在任意位置解压模型包 zip，会得到一个 models 文件夹（旁边还有 README.txt 和 SHA256SUMS.txt 两个说明文件）。把 models 整个文件夹复制到上一步打开的 data 目录下——data 里已经有 models 时直接合并覆盖。完成后，最终路径应当与下面的目录结构完全一致，例如能看到 data/models/Qwen3-Embedding-0.6B-Q8_0.gguf 这个文件。

启动应用并验证

启动 Linkly AI，打开 设置 → AI：模型区域应显示为就绪，而不是等待下载。OCR（扫描件/图片文字识别）和语义搜索即可直接使用。音频/视频转写功能默认是关闭的：需要时去 设置 → 索引 打开「音频解析」和「视频解析」，应用会用包里的语音模型自动处理已有的媒体文件，不需要重新扫描。

安装后的目录结构

放置完成后，data/models 文件夹应包含以下内容（文件名必须完全一致）：

models/
├── Qwen3-Embedding-0.6B-Q8_0.gguf      ← 语义搜索模型
├── ocr/
│   ├── .ready                          ← 就绪标记（包里已带，勿动）
│   ├── v6/
│   │   ├── pp-ocrv6_small_det.onnx
│   │   ├── pp-ocrv6_small_rec.onnx
│   │   ├── ppocrv6_dict.txt
│   │   ├── korean_pp-ocrv5_mobile_rec.onnx
│   │   ├── ppocrv5_korean_dict.txt
│   │   ├── latin_pp-ocrv5_mobile_rec.onnx
│   │   └── ppocrv5_latin_dict.txt
│   └── structure/
│       ├── pp-doclayout-m.onnx
│       ├── slanet_plus.onnx
│       └── table_structure_dict_ch.txt
└── asr/
    └── sense-voice/
        ├── model.int8.onnx
        └── tokens.txt

ocr/.ready 是一个隐藏文件（文件名以点开头），是 OCR 模型的就绪标记。不要打开、编辑或重新创建它——文本编辑器保存时引入的编码差异会让应用拒绝识别。如果怀疑它有问题，重新解压一次离线包即可。

常见问题排查

安装后应用仍提示需要下载模型

几乎都是目录结构没对齐。对照上面的结构逐项核对，重点检查：

是否把 zip 直接解压进了 data/models，形成 data/models/models/... 的双层嵌套——把里层的 models 内容上移一级
ocr/.ready 隐藏文件是否在（部分解压工具默认跳过点开头的文件；Finder 按 ⌘ + ⇧ + . 可显示隐藏文件）
是否放到了别的盘符或别的用户目录下

zip 打不开或解压报错

文件在下载或搬运过程中损坏了。重新下载离线包，换一个 U 盘或传输方式再试。包内附有 SHA256SUMS.txt，可按 README.txt 里的命令逐文件校验，定位是哪一环出的问题。不要尝试修复或部分解压——损坏的模型文件会导致更难排查的运行时错误。

升级应用后 AI 功能又提示需要下载

新版本应用可能更换了模型。重新下载最新的离线模型包，按本页第三步重新放置一次即可。

应用版本低于 v0.9.0

旧版本的模型目录结构不同，本页的离线包对它不适用。请先按第一、二步获取最新版安装包并升级，再继续。

离线环境下哪些功能可用

本包覆盖的是本地 AI 模型，不是所有功能。装好后：

功能	离线可用性
文件索引、全文搜索、启动器、笔记	✅ 一直可用（不依赖模型）
语义搜索、OCR、音频/视频转写	✅ 本包覆盖
AI 对话（Chatbot）	❌ 依赖云端模型；可改接内网的 OpenAI 兼容端点（如局域网里的 Ollama / LM Studio），见官方模型服务的自定义提供商部分
Agent Skills 安装	❌ 需联网下载，不在本包内
账号登录、云端知识库、应用自动更新	❌ 云端功能

快速开始

核心功能

接入 AI 工具

给 Agent 的指南

离线安装指南

第一步：要先下载哪些东西

下载离线模型包

第二步：把哪些文件拷贝过去

第三步：怎么执行安装

安装后的目录结构

常见问题排查

离线环境下哪些功能可用

​第一步：要先下载哪些东西

下载离线模型包

​第二步：把哪些文件拷贝过去

​第三步：怎么执行安装

​安装后的目录结构

​常见问题排查

​离线环境下哪些功能可用

第一步：要先下载哪些东西

第二步：把哪些文件拷贝过去

第三步：怎么执行安装

安装后的目录结构

常见问题排查

离线环境下哪些功能可用