> ## 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.
# オフラインインストールガイド
> 外部ネットワークに接続できない PC（オフライン / 閉域網）に Linkly AI をインストールし、ローカル AI 機能をすべて使えるようにする手順：インストーラーと公式オフラインモデルパックを事前にダウンロードし、持ち込んで、順番どおりにインストールします。
Linkly AI の検索、文字認識（OCR）、音声文字起こし（ASR）、セマンティック検索はすべて**お使いの PC 上でローカルに動作**し、日常利用にインターネット接続は不要です。ただし、通常のインストールの流れのうち 2 つの手順はネットワークに依存します：インストーラーのダウンロードと、初回起動時の AI モデルファイル（合計約 870 MB）の自動ダウンロードです。
対象の PC が**外部ネットワークにまったくアクセスできない**場合（オフライン環境、社内イントラネット、閉域網）は、このページの流れに沿ってください：ネット接続のある PC で必要なものをすべてダウンロードし、持ち込んで、インストールします。
モデルファイルは必ずこのページで案内する公式オフラインモデルパックを使ってください。**他の入手経路からモデルファイルをダウンロードしたり、フォルダ構成を手作業で組み立てたりしないでください**——モデルファイルは手動での移動や文字コード変換で壊れやすく、AI 機能が分かりにくいエラーで動かなくなる原因になります。
## ステップ 1：先にダウンロードするもの
**ネット接続のある** PC で、次の 2 つをダウンロードします：
1. **アプリのインストーラー**：[公式ダウンロードページ](https://linkly.ai/#get-started)で対象 PC のプラットフォーム（Windows / macOS / Linux）を選んでダウンロードします。バージョンは **v0.9.0 以降**が必要です（それより古いバージョンはモデルのフォルダ構成が異なり、オフラインパックが適用できません）。
2. **公式オフラインモデルパック**：単一の zip ファイル（約 850 MB）。OCR・音声文字起こし・セマンティック検索に必要なモデルすべてに加え、説明ファイルと SHA-256 チェックサム一覧を同梱しています。
3. **（対象 PC が Windows の場合のみ）2 つのシステムランタイムのインストーラー**——オフライン環境ではアプリのインストーラーがこれらを自動でネットから取得できません：
* [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 コンポーネントが依存しています。欠けているとインストーラーがオンライン取得を試みて失敗します
linkly-ai-offline-models-20260825.zip · 約 850 MB。ダウンロード後は zip のまま保管し、中のファイルを開いたり編集したりしないでください。
## ステップ 2：どのファイルを持ち込むか
USB メモリ、外付けディスク、社内ファイル共有などで、次の 2 つのファイルを**そのまま**オフラインの PC へコピーします（デスクトップなど一時的な置き場所で構いません）：
* アプリのインストーラー（`.exe` / `.dmg` / `.AppImage` など）
* オフラインモデルパックの zip（**zip 全体をコピーします。先に展開してバラバラにコピーしないでください**）
* （Windows）WebView2 と VC++ ランタイムのインストーラー
## ステップ 3：インストールの実行手順
* **Windows**：**先に** WebView2 ランタイムと VC++ ランタイムを順にインストールし（既に入っている PC では何もせずスキップされます）、**その後**アプリのインストーラーをダブルクリックしてウィザードに従います
* **macOS**：`.dmg` を開き、Linkly AI を「アプリケーション」フォルダにドラッグします
* **Linux**：お使いのパッケージ形式に応じてインストールします（AppImage は実行権限を付与してそのまま実行）
まず Linkly AI を普通に一度起動します——アプリがデータフォルダを自動作成します（オフラインではモデルのダウンロードに失敗しますが、気にしなくて構いません）。その後、完全に終了します：システムトレイの L アイコンを右クリックして終了を選びます。
OS に応じて以下の場所を開きます（存在しない場合は作成してください）：
Win + R で「ファイル名を指定して実行」を開き、貼り付けて Enter：
```
%APPDATA%\ai.linkly.desktop\data
```
Finder のメニュー **移動 → フォルダへ移動…**（⌘ + ⇧ + G）で、貼り付けて Enter：
```
~/Library/Application Support/ai.linkly.desktop/data
```
```bash theme={null}
mkdir -p ~/.local/share/ai.linkly.desktop/data
xdg-open ~/.local/share/ai.linkly.desktop/data
```
**設定 → 情報 → データフォルダ** の「開く」からデータフォルダを開き、`data/` に入る方法もあります。
モデルパックの zip を任意の場所で展開すると、`models` フォルダが得られます（`README.txt` と `SHA256SUMS.txt` という 2 つの説明ファイルも一緒に出てきます）。**`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 では ⌘ + ⇧ + . で隠しファイルを表示できます）
* 別のドライブや別ユーザーのフォルダに置いていないか
ダウンロードまたは移動の途中でファイルが壊れています。パックをダウンロードし直し、別の USB メモリや別の転送手段を試してください。パックには `SHA256SUMS.txt` が同梱されており、`README.txt` 記載のコマンドでファイルごとに検証してどこで壊れたか特定できます。修復や部分的な展開は試みないでください——壊れたモデルファイルは、はるかに診断しづらい実行時エラーの原因になります。
新しいバージョンでモデルが更新された可能性があります。最新のオフラインパックをダウンロードし、このページのステップ 3 のとおりに配置し直してください。
古いバージョンはモデルのフォルダ構成が異なるため、このパックは適用できません。ステップ 1・2 の要領で最新のインストーラーを入手してアップデートしてから、続きを進めてください。
## オフライン環境で使える機能
本パックがカバーするのは**ローカル AI モデル**であり、すべての機能ではありません。インストール後：
| 機能 | オフラインでの可用性 |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| ファイルインデックス、全文検索、ランチャー、ノート | ✅ 常に利用可（モデル不要） |
| セマンティック検索、OCR、音声/動画の文字起こし | ✅ 本パックでカバー |
| AI チャット（Chatbot） | ❌ クラウドモデルに依存。ネットワーク内の OpenAI 互換エンドポイント（LAN 内の Ollama / LM Studio など）への接続は可能——[公式モデルサービス](/docs/ja/model-service)のカスタムプロバイダーの節を参照 |
| Agent Skills のインストール | ❌ ネットからのダウンロードが必要。本パックには含まれません |
| アカウントログイン、クラウドライブラリ、自動アップデート | ❌ クラウド機能 |