> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 离线安装指南

> 在完全没有外网的电脑（离线/内网环境）上安装 Linkly AI 并用上全部本地 AI 功能：提前下载安装包与官方离线模型包，拷贝过去，按步骤安装。

Linkly AI 的搜索、文字识别（OCR）、语音转写（ASR）和语义搜索都**在你的电脑上本地运行**，日常使用不需要联网。但正常安装流程里有两步依赖网络：下载安装包，以及首次运行时自动下载 AI 模型文件（合计约 870 MB）。

如果目标电脑**完全无法访问外网**（离线环境、企业内网、隔离网络），按本页流程走一遍即可完成安装：在有网的电脑上把东西下载齐，拷贝过去，然后安装。

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

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

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

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

<Card title="下载离线模型包" icon="download" href="https://updater.linkly.ai/model/linkly-ai-offline-models-20260825.zip">
  linkly-ai-offline-models-20260825.zip · 约 850 MB。下载后整包保存，不要打开或编辑其中的任何文件。
</Card>

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

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

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

## 第三步：怎么执行安装

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

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

  <Step title="打开应用数据目录下的 data 文件夹">
    按你的操作系统找到（不存在就手动创建出来）：

    <Tabs>
      <Tab title="Windows">
        按 <kbd>Win</kbd> + <kbd>R</kbd> 打开「运行」，粘贴并回车：

        ```
        %APPDATA%\ai.linkly.desktop\data
        ```
      </Tab>

      <Tab title="macOS">
        Finder 顶部菜单 **前往 → 前往文件夹…**（<kbd>⌘</kbd> + <kbd>⇧</kbd> + <kbd>G</kbd>），粘贴并回车：

        ```
        ~/Library/Application Support/ai.linkly.desktop/data
        ```
      </Tab>

      <Tab title="Linux">
        ```bash theme={null}
        mkdir -p ~/.local/share/ai.linkly.desktop/data
        xdg-open ~/.local/share/ai.linkly.desktop/data
        ```
      </Tab>
    </Tabs>

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

  <Step title="解压模型包，把 models 文件夹放进 data">
    在任意位置解压模型包 zip，会得到一个 `models` 文件夹（旁边还有 `README.txt` 和 `SHA256SUMS.txt` 两个说明文件）。把 **`models` 整个文件夹**复制到上一步打开的 `data` 目录下——`data` 里已经有 `models` 时直接合并覆盖。

    完成后，最终路径应当与下面的[目录结构](#安装后的目录结构)完全一致，例如能看到 `data/models/Qwen3-Embedding-0.6B-Q8_0.gguf` 这个文件。
  </Step>

  <Step title="启动应用并验证">
    启动 Linkly AI，打开 **设置 → AI**：模型区域应显示为就绪，而不是等待下载。OCR（扫描件/图片文字识别）和语义搜索即可直接使用。

    音频/视频转写功能**默认是关闭的**：需要时去 **设置 → 索引** 打开「音频解析」和「视频解析」，应用会用包里的语音模型自动处理已有的媒体文件，不需要重新扫描。
  </Step>
</Steps>

## 安装后的目录结构

放置完成后，`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
```

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

## 常见问题排查

<AccordionGroup>
  <Accordion title="安装后应用仍提示需要下载模型">
    几乎都是目录结构没对齐。对照上面的结构逐项核对，重点检查：

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

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

  <Accordion title="升级应用后 AI 功能又提示需要下载">
    新版本应用可能更换了模型。重新下载最新的离线模型包，按本页第三步重新放置一次即可。
  </Accordion>

  <Accordion title="应用版本低于 v0.9.0">
    旧版本的模型目录结构不同，本页的离线包对它不适用。请先按第一、二步获取最新版安装包并升级，再继续。
  </Accordion>
</AccordionGroup>

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

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

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