> ## 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 スペース > アプリが自動的に作成してインデックスする既定のフォルダ：ディスク上のどこにあり、何が入っていて、場所をどう変えるのか、そして踏みやすい落とし穴まで。 ## 「Linkly AI スペース」とは **Linkly AI スペース**は、アプリがあなたのパソコン上に自動的に作成する、ごく普通のフォルダです。アプリ内の説明はこうなっています： > 自動的に作成・インデックスされる既定のフォルダです。ドキュメント、メモ、クリップなどを保存します。 役割はとてもシンプルで、**アプリがディスクに何かを書き込む必要があるとき、既定でここに書き込む**というものです。アプリ内で書いた[ノート](/docs/ja/use-notes)、ブラウザ拡張で保存したウェブページ、そしてインストーラーに同梱されたサンプルドキュメントは、どれもこのフォルダの下に置かれます。 中身は普通のディレクトリで、独自形式は一切ありません。Finder / エクスプローラーで開けますし、中のファイルを好きなエディタで編集でき、そのまま `grep` することも、まるごとコピーして持ち出すこともできます。 3 か所で 3 通りの書き方を目にしますが、すべて同じものを指しており、**互いに矛盾していません**： * 画面上の名前は「**Linkly AI スペース**」（設定 → 一般 ページの最下部） * ディスク上のフォルダ名は `LinklyAI`（スペースなし） * その中のサンプルドキュメントのフォルダ名は `Linkly_AI_Examples` *** ## ディスク上のどこにあるか 既定の場所は**あなたのユーザーのホームフォルダ**の下です： | OS | 既定のパス | | ----------- | --------------------------- | | **macOS** | `/Users/<ユーザー名>/LinklyAI` | | **Windows** | `C:\Users\<ユーザー名>\LinklyAI` | | **Linux** | `/home/<ユーザー名>/LinklyAI` | \*\*ホームフォルダであって、「書類 / Documents」フォルダではありません。\*\*つい Documents の中を探してしまい、見つからない方が多くいます。macOS では Finder で **⌘⇧H** を押せばホームフォルダに直接移動できます。 Windows で **設定 → 一般** に表示されるパスは**スラッシュ**の形式です（例：`C:/Users/xxx/LinklyAI`）。アプリ内部でパスを統一的に正規化しているためで、これは正常な表示です。エクスプローラーに表示される `C:\Users\xxx\LinklyAI` と同じフォルダを指しています。 すばやく開きたいときは \*\*設定 → 一般 → Linkly AI スペース →「開く」\*\*をクリックすると、システムのファイルマネージャーで直接開きます。デスクトップにも通常[ショートカット](#デスクトップショートカット)があります。 *** ## 中に何が入っているか ``` ~/LinklyAI/ ├── Clips/ ブラウザ拡張で保存したウェブページ │ └── <クリップのタイトル>/ クリップ 1 件につき 1 ディレクトリ。.md 本文と画像が入ります ├── Notes/ カードノート │ └── YYYY-MM/ UTC の月ごとにディレクトリ分け │ └── <本文の先頭 10 文字>-<8 桁の id>.md └── Linkly_AI_Examples/ インストーラー同梱のサンプルドキュメント ├── A-Life-in-10-Years/ ├── Detectives-Library/ ├── Federalist-Papers/ ├── Mission-Logs/ └── WPA-Slave-Narratives/ ``` ### `Notes/` —— ノート アプリ内で書いたカードノートは、1 件ずつここの `.md` ファイルになり、**UTC の月**ごとにサブディレクトリに分かれます。ファイル名のルール、YAML ヘッダーのフィールド、外部エディタで開くときの注意点は[ノートを使う](/docs/ja/use-notes)をご覧ください。 ### `Clips/` —— ウェブクリップ [ブラウザ拡張機能](/docs/ja/use-extension)で保存したウェブページはここに置かれ、**クリップ 1 件につき独立したディレクトリ**が作られます。中には Markdown の本文と、ページ内の画像が入ります。 ### `Linkly_AI_Examples/` —— サンプルドキュメント インストーラーに同梱されたパブリックドメインのテキスト群で、合計 **159 ファイル、展開後は約 11.9 MB**、すべて Markdown です。初回起動ウィザードの「準備中」の画面で展開・インデックスされます。インストール直後からすぐに何かを検索でき、検索や Chatbot の効果を試せるようにするためのものです。 使い方に慣れたら `Linkly_AI_Examples/` をまるごと削除して構いません。どの機能にも影響せず、インデックス内の該当エントリも自動的に片付けられます。 `Clips/` と `Notes/` の 2 つのディレクトリは**起動のたびに存在が保証されます**。手動で削除しても、次回起動時に再作成されます（ただし中身は戻りません）。`Linkly_AI_Examples/` は**初回のウィザードで一度だけ展開される**ので、削除するともう再作成されません。 *** ## どうやってインデックスされているのか このフォルダの中身が検索できるのは、「特別扱い」されているからではありません。理由はこうです： **初回起動のウィザードが、このフォルダを監視対象フォルダとして自動的に追加するからです。** つまり **設定 → フォルダ** ページから見れば、これは**ごく普通の監視フォルダ**の 1 つであり、あとからご自身が追加した「書類」「プロジェクト」などのフォルダと完全に対等です。インデックスの階層のしくみも、どのスイッチが影響するかも、他のフォルダとまったく同じです。詳しくは[インデックスの設定](/docs/ja/indexing)をご覧ください。 既存のユーザーが新しいバージョンに更新したあとも、ウィザードをもう一度通ることになります。そのため、この説明は更新したユーザーにも同じように当てはまります。更新後にこのフォルダが監視リストから外れる心配はありません。 **「設定 → フォルダ」ページでこのフォルダを削除できますが、よく考えてから実行してください。** 削除するとインデックスされなくなりますが、**アプリはその後もここにノートとクリップを書き込み続けます**。結果として、書いたノートやクリップしたウェブページは確かにディスク上に存在するのに、検索でも AI の検索でも**1 件もヒットしない**という状態になり、しかもその理由を伝える表示は画面のどこにも出ません。 うっかり削除してしまった場合は、**設定 → フォルダ** に戻ってこのフォルダをもう一度追加すれば復旧します。既存のファイルは再インデックスされます。 *** ## 場所を変更する ホームフォルダの空きが足りない、別のドライブに置きたい —— そんなときは **設定 → 一般** ページの最下部にある「Linkly AI スペース」エリアに、3 つのボタンがあります：「開く」「**変更…**」「デフォルトに戻す」。 \*\*これは「移行」ではありません。\*\*アプリがあなたのファイルを移動することはありません。 確認ダイアログにもはっきり書かれています： > 既存のファイルは移動されず、現在の場所に残ってインデックスされ続けます。この操作は今後の新しいファイルの保存先を変更するだけです。 成功後のメッセージも同様です： > フォルダの場所を更新しました。元の場所のファイルは自動的に移動されず、そのまま残ります。 裏側でやっているのは 2 つだけです：**新しい場所に空のディレクトリを作る**ことと、**設定をそこへ向ける**こと。既存のファイルをコピーも移動も削除もせず、再起動も不要で、一瞬で完了します。 「Linkly AI スペース」エリアを見つけてください。現在のパスがそこに表示されています。 **セレクターで選ぶのは「親ディレクトリ」であって、スペースのフォルダそのものではありません。**`~/Documents` を選べば `~/Documents/LinklyAI` になり、外付けドライブのルートを選べば `/Volumes/XXX/LinklyAI` になります。 唯一の例外：それ自体が `LinklyAI` という名前のフォルダを直接選んだ場合、アプリはそれをそのまま使い、`LinklyAI/LinklyAI` と入れ子にはしません。 確認ダイアログの文言を一度読んでから「続ける」をクリックします。新しいディレクトリはすぐに作成され、設定も即座に反映されます。 アプリは移してくれません。以前のノートやクリップも新しい場所に置きたい場合は、ご自身でファイルマネージャーから `Notes/`、`Clips/` などを新しいディレクトリに**コピー**してください。 下の注意書きをご覧ください。 **古いパスは監視リストに残ったままで、インデックスされ続けます。** 多くの方は「変更したら新しい場所だけがインデックスされる」と考えますが、実際には**両方の場所がインデックスされます**。古い場所のドキュメントが検索結果から消えることは 1 件もありません。 新しいものを置く場所を変えたいだけなら、これは好都合です（古い資料が失われません）。ただし「このフォルダを完全に引っ越したい」というつもりだったのなら、ご自身で **設定 → フォルダ** から古いパスを削除する必要があります。 付随する効果として、デスクトップの[ショートカット](#デスクトップショートカット)は新しい場所を指すように書き換わります。「デフォルトに戻す」ボタンの挙動は「変更…」とまったく同じで、行き先がユーザーのホームフォルダ下の `LinklyAI` に固定されているだけです。こちらも同じくデータは移動しません。 「場所を変更する」機能は **v0.8.0** から提供されています。それより前のバージョンをお使いの場合は、更新してから操作してください。 *** ## デスクトップショートカット 初回のウィザードが完了すると、アプリは**システムのデスクトップ**に `LinklyAI` という名前のショートカットを作成します。指し先は **Linkly AI スペースのフォルダ**です（アプリ本体ではありません。クリックして開くのはフォルダであって、アプリではありません）。 | OS | 形式 | | ----------- | ------------------ | | **macOS** | シンボリックリンク（symlink） | | **Windows** | `.lnk` ショートカット | | **Linux** | `.desktop` ファイル | \*\*画面上にこれをオフにするスイッチはありません。\*\*ユーザーから見て唯一の無効化の方法は、**デスクトップのそのショートカットを直接削除する**ことです。削除すれば、その後は自動的に再作成されません。 唯一の例外は[スペースの場所の変更](#場所を変更する)です。この操作だけは、新しい場所を指すショートカットを無条件に作り直します。 もともとデスクトップに `LinklyAI` という名前のファイルやフォルダがあった場合（アプリが作ったものではないもの）、アプリがそれを上書きすることは**決してありません**。 *** ## 「データフォルダ」とは別物です いちばん混同されやすい 2 つの概念です。**Linkly AI スペース**に入っているのは**あなたのコンテンツ**、**データフォルダ**に入っているのは**アプリの内部データ**です： | | Linkly AI スペース | データフォルダ | | ----------------- | ------------------------ | -------------------------------- | | **入っているもの** | あなたのコンテンツ：ノート、クリップ、サンプル | インデックス、データベース、ログ、ダウンロードしたモデルファイル | | **どこで見るか** | 設定 → 一般 → Linkly AI スペース | 設定 → 情報 → データフォルダ | | **場所を変えられるか** | 変えられます | 画面上に「必要のない限り変更しないでください」と明記されています | | **クラウドドライブに置けるか** | 置けますが、保証はありません | **絶対にやめてください** | | **削除すると** | コンテンツを失います（ノート、クリップ） | インデックスと設定を失い、再インデックスが必要になります | ### アプリのログはどこにあるか ログファイルは `logs/app.log` で、**データフォルダ**の下にあります。 \*\*設定 → 情報 ページに「ログを開く」ボタンはありません。\*\*まず「データフォルダ」の横の「**開く**」をクリックし、そこから `logs/` サブディレクトリに入る必要があります。 さらに `app.log` には **2 MB のローテーション**があり、上限を超えると後半だけが残ります。そのため問題を報告してくださるときの正しい順序は、「**まず今のログを取り出して 1 部保存し、それから問題を再現する**」です。逆にすると、初期の重要な手がかりがすでにローテーションで失われている可能性が高くなります。 *** ## 手動で削除・移動すると何が起きるか \*\*ファイルマネージャーからこのフォルダを直接削除したり移動したりしないでください。\*\*以下は各ケースで実際に起きることです。 | やったこと | 結果 | | -------------------------------- | ------------------------------------------------------------------------------------ | | **フォルダを削除して、アプリは再起動しない** | インデックスはすぐには落ちません。**設定 → フォルダ** ページに「フォルダが見つかりません」と表示されます | | **フォルダを削除して、アプリを再起動する** | アプリが**空の** `~/LinklyAI` を作り直し、スキャンで空だと分かるため、元のドキュメントは約 **60 秒後**にインデックスから削除されます | | **フォルダを手動で別の場所へ移動する** | 設定は古いパスを指したままで、再起動すると古いパスが空のディレクトリとして再作成されます。**新しい場所は手動で監視に追加しない限り、まったくインデックスされません** | | **`Linkly_AI_Examples` だけを削除する** | 安全です。サンプルは初回ウィザードで一度展開されるだけで再作成されず、他の機能にも影響しません | **正しい引っ越しの手順**： **設定 → 一般 → Linkly AI スペース** で「変更…」をクリックし、新しい親ディレクトリを選びます。 ファイルマネージャーで古いディレクトリの中身を新しいディレクトリに**コピー**します。切り取りではなくコピーを推奨します。問題がないと確認してから古い方を削除してください。 古い場所も引き続き検索できるようにしたいなら、何もする必要はありません。不要なら **設定 → フォルダ** から古いパスを削除してください。 *** ## よくある質問 **置けますが、公式の保証はありません。**アプリはこのフォルダについて**クラウドドライブの検出を一切行わず、通知も警告も出しません**。置けばそのまま置かれるだけで、問題が起きてもダイアログは出ません。 インデックス側にはクラウドドライブ向けの汎用的な保護がいくつか入っていて、ある程度は問題を和らげます： * **ローカルにまだダウンロードされていないクラウドのプレースホルダーファイルをスキップします**（検索結果に「未インデックス · クラウドプレースホルダー」と表示され、ローカルにダウンロードされると自動的に再インデックスされます） * **クラウド同期のゆらぎによる一時的な削除には 60 秒の安定化ウィンドウがあり**、ちょっと揺れただけでドキュメントをインデックスから消すことはありません * **`#recycle`、`@eaDir` などの同期メタデータのディレクトリを無視します** それでも、クラウドドライブのオンデマンドダウンロード、競合コピー、頻繁な書き換えによってインデックスが何度も変動する可能性はあります。複数のデバイスでドキュメントを共有したいだけであれば、クラウドドライブのフォルダを**普通の監視フォルダとして追加する**（設定 → フォルダ）ほうが、スペースまるごとをクラウドドライブに移すより安全です。 \*\*されません。\*\*やることは 2 つだけです：新しい場所にディレクトリを作ることと、設定を新しい場所に向けること。既存のファイルは 1 つも動かず、元の場所に残り、そのままインデックスされ続けます。 確認ダイアログの「既存のファイルは移動されず」という一文は免責事項ではなく、挙動の正確な説明です。古いファイルも移したい場合は、ご自身でファイルマネージャーからコピーしてください。 そもそもデータを移動しないので、「移行が途中で失敗したら / 中断したらどうする」という状況自体が存在しません。この操作は一瞬で完了します。 \*\*検索できます。\*\*古いパスは監視リストに残ったままインデックスされ続けるので、両方の場所の内容が検索範囲に入ります。 たいていはこれが好都合ですが（古い資料が突然消えたりしません）、「完全に引っ越したい」というつもりだったのなら、ご自身で **設定 → フォルダ** から古いパスを削除してください。 インデックスされなくなりますが、**ノートとクリップは変わらずここに書き込まれます**。書き込まれたものは検索できず、画面にも何の表示も出ません。 これがいちばん踏みやすい落とし穴です。**設定 → フォルダ** に戻ってこのフォルダを追加し直せば復旧し、既存のファイルは再インデックスされます。 構いません。`Linkly_AI_Examples/` はすべて Markdown のパブリックドメインのテキストで、削除してもどの機能にも影響せず、インデックス内の該当エントリも自動的に片付けられます。 ただし**初回のウィザードで一度だけ展開される**ため、削除するともう再作成されません。記念に残しておきたい方は、先にバックアップを取ってください。 \*\*そのまま削除すれば大丈夫です。\*\*その後は自動的に再作成されません。画面上に対応するスイッチはありません。 唯一これが再び現れる操作が[スペースの場所の変更](#場所を変更する)です。その手順では、新しい場所を指すショートカットが無条件に作り直されます。 2 つのケースに分かれます： * **まだアプリを再起動していない場合**：ファイルはすでに失われています（ノートもクリップもこの中にあります）が、インデックスはまだ残っています。Time Machine やファイル履歴があるなら、急いでバックアップからフォルダを復元し、そのあとアプリを再起動してください。 * **すでに再起動した場合**：アプリが空のディレクトリを作り直し、スキャンで空だと分かるため、元のドキュメントは約 60 秒後にインデックスから削除されます。この場合はシステムのバックアップから復元するしかありません。 アプリには**ゴミ箱も、独自のバックアップのしくみもありません**。このフォルダに入っているのはあなたの本物のファイルです。他の大切なフォルダと同じように扱ってください。 **データフォルダ**の下の `logs/app.log` です。Linkly AI スペースの中ではないことにご注意ください。 たどり方：**設定 → 情報 → データフォルダ →「開く」**、そこから `logs/` サブディレクトリに入ります。情報ページにログを直接開くボタンは**ありません**。 `app.log` は 2 MB でローテーションし、上限を超えると後半だけが残るため、問題を報告してくださるときは**先にログを取り出してから再現**してください。 *** ## 関連ドキュメント * [クイックスタート](/docs/ja/quickstart) —— インストール、ウィザードの完了、ご自身のドキュメントの追加 * [インデックスの設定](/docs/ja/indexing) —— このフォルダの中身が具体的にどうインデックスされるのか * [ノートを使う](/docs/ja/use-notes) —— `Notes/` のファイル名ルールと YAML の形式 * [ライブラリの使い方](/docs/ja/use-libraries) —— このフォルダ（やその中のサブフォルダ）をライブラリに含める * [よくある質問](/docs/ja/faq) —— そのほかのトラブルシューティング * [AI チャットを使う](/docs/ja/use-chatbot) —— チャットの中でこのフォルダの内容を `@` で参照する * [ブラウザ拡張機能](/docs/ja/use-extension) —— `Clips/` の中身がどこから来るのか