10. よくあるご質問（FAQ）
この章では、特によくあるご質問とトラブルシューティングのヒントをまとめています。
答えが見つからない場合は、GitHub Issues までお知らせください。
インストールと起動
macOS で「アプリケーションが破損しています」と表示される
原因：現在のバージョンは署名されていません（v1.0.1 以降は署名済みのため、この操作は不要です）。
以下のいずれかの方法で回避できます。
「アプリケーション」フォルダで PinSlip を 右クリック → 開く
ターミナルで
xattr -cr /Applications/PinSlip.appを実行
Linux でグローバルショートカットが反応しない
原因：Wayland セッションではネイティブウィンドウへのグローバルショートカットが反応しません。
解決策：X11 セッションでログインしてください。X11 では期待どおりに動作します。
GNOME デスクトップでトレイアイコンが表示されない
原因：GNOME はデフォルトでアプリケーションインジケーターを表示しません。
解決策：AppIndicator and KStatusNotifierItem Support 拡張をインストールしてください。
Windows 版インストール時に「自動起動」がグレーアウトしている
原因：dev モード（pnpm dev）ではレジストリへの書き込みができません。
解決策：インストール版（PinSlip-Setup-*.exe）をインストールしてから切り替えてください。
初回起動が遅い
原因：Go サービスの初回コンパイル + インデックスの全量再構築が発生します。
説明：2 回目以降はすぐに起動します。空の vault なら数秒、数千件のメモがある場合は 1〜2 分かかることがあります。
メモが見つからない / 画面外に出た
メモが画面の外に出てしまった
原因：外付けディスプレイの取り外し / ディスプレイ解像度の変更。
解決策：アプリを再起動 → PinSlip は自動的に表示領域に戻します。
メイン画面が見当たらない
解決策：
システムトレイの PinSlip アイコンを 左クリック → 表示を切り替え
ショートカット
Ctrl+Shift+Nでクイックキャプチャを再度呼び出すアプリを再起動
Windows タスクバーにも見つからない
解決策：各メモはタスクバーにアイコンがあります。表示されていない場合は、トレイが「非表示」になっていないか確認してください。
削除と復元
間違って削除してしまった
解決策：.trash/ からファイルを notes/ へドラッグします。PinSlip の watcher が自動で認識し、インデックスを再構築します。
フォルダ全体を削除してしまった
解決策：.trash/フォルダ名/ からフォルダ全体を notes/ へドラッグします。
あるメモを物理削除したい（ごみ箱を経由しない）
解決策：.trash/ から直接ファイルを削除します（PinSlip の削除ロジックを迂回します）。
通常はこの方法は推奨されません。ごみ箱は最終的なセーフティネットとして存在します。
検索
一部のキーワードが検索できない
確認ポイント：
記号のみの文字列はマッチしないことがあります
タグやタイトルの語を試してみてください（検索での重みづけがもっとも高いです）
本文中のキーワードは重みが低く、必ずしも先頭に表示されるとは限りません
検索結果が多すぎる
解決策：修飾語を増やしてください。タグ検索に切り替えるのも有効です。
Markdown と画像
貼り付けた画像が表示されない
確認ポイント：
<vault>/attachments/ディレクトリの権限を確認外部エディタ（Obsidian / VS Code）が相対パス
../attachments/に対応しているか確認<img>タグのパスに日本語や空白が含まれていないか（含まれていてはいけません）
タスクリストがクリックできない
確認ポイント：
マウスカーソルがタスクのチェックボックスの上にあるか
メモが折りたたまれていないか（折りたたみ時もクリックは可能ですが、スクロールターゲットが外れることがあります）
フォントサイズ調整のボタンが消えた
原因：ウィンドウが狭すぎるため、優先度の低いボタンが非表示になっています。
解決策：
ウィンドウを広げる
⋯ メニューから「フォントサイズ調整」を探す
Git 同期
認証失敗
確認ポイント：
トークンが期限切れではないか
リポジトリ URL に
.gitのサフィックスがあるか書き込み権限があるか
ユーザー名を間違えていないか
同期が停滞する
原因：ネットワーク / リモート側の問題。
解決策：
ステータス画面に
lastErrorが表示されます指数バックオフ 1m → 5m → 15m は正常な挙動です
同期失敗が繰り返される
確認ポイント：
GitHub / GitLab / cnb にネットワークから到達できるか
DNS ハイジャックが疑われる場合は、hosts ファイルの設定を確認してください
国内ネットワークでアクセスできない場合は、cnb や自前の Gitea への切り替えを検討してください
「未解決コンフリクト」が表示される
解決策：コンフリクトのあるメモを開く → 「すべてローカルを使用 / すべてリモートを使用 / 手動で編集」から選択 → 「解決を保存」をクリックします。
MCP
クライアントが MCP に接続できない
確認ポイント：
<vault>/.pinslip/mcp.jsonが存在するかpid が生きているか（PinSlip のプロセスと一致するか）
設定の MCP スイッチがオンになっているか
クライアントの URL が
localhostではなく127.0.0.1を使っているか
ツール呼び出しが 404 になる
原因：MCP スイッチがオフ、またはサービスが起動していない。
解決策：
設定 → MCP サービス → スイッチをオン
PinSlip を再起動
ツール呼び出しがタイムアウトする
解決策：
Go サービスがフリーズしていないか確認（PinSlip を再起動）
大量のメモのインデックス再構築が行われていないか確認
ブラウザ拡張
拡張機能がデスクトップに接続できない
確認ポイント：
デスクトップ版 PinSlip が起動しているか
オプションページのポートが
mcp.jsonのportと一致しているか（デフォルト 17639、しかし一致しないことがあります）「再接続プローブ」ボタンを押してみる
右クリックメニューに PinSlip の項目が出ない
確認ポイント：
拡張機能の「コンテキストメニュー」権限が有効か
拡張機能の注入が許可されていないページ（Chrome ウェブストア / 設定ページなど）にいないか
パフォーマンス
vault が大きいと起動が遅い
解決策：
.pinslip/pinslip.dbが外部プログラムにロックされていないか確認（通常はロックされません）数千件のメモまでは基本的に気になりません
ごみ箱を使って不要なメモをこまめに削除
編集中のカクつき
確認ポイント：
1 枚のメモが長すぎないか。分割するか、外部ファイルへアーカイブする
ブラウザ拡張が継続的にディスクへ読み書きしていないか
その他
macOS のトレイアイコンのサイズがおかしい
説明：v1.0.0 の初期バージョンではメニューバーのアイコンが「はみ出る」問題があり、v1.0.1 で修正されています。最新版へアップグレードしてください。
完全にアンインストールしたい
macOS：ゴミ箱へドラッグ
Windows：設定 → アプリ → アンインストール
Linux：
sudo apt remove pinslipまたは AppImage を直接削除vault ディレクトリを削除（事前にバックアップを取ってください）
データの所有権は誰にあるのか
データの所有権はユーザー自身にあります。 PinSlip は単なる器であり、ユーザーのメモは常に Markdown ファイルとしてユーザーのディスク上に存在します。
PinSlip が開発を終了したとしても、Obsidian / VS Code / Typora など、任意のエディタでメモを開けます。
これは PinSlip の設計思想であり、今後も維持されます。