ユーザーガイド

文書をすばやく見つけるために必要なことのすべて。GitHub の README 全文 も参照してください。

検索モード

右上のトグルで キーワード、意味、両方(既定)を選びます。検索は Enter を押すと実行されます。入力欄を空にすると、すべての文書が再び表示されます。

• キーワード: SQLite FTS5 による逐語検索。各語は前方一致で OR 結合されるので、budget report は budget… または report… を含む文書を見つけます。タイトルと著者での一致は本文やタグより上位になります。文書内にある語・名前・コードが分かっているときに最適。
• 意味: AI 埋め込みによる意味検索。正確な語がなくても、クエリに関する文書を見つけます。「X に関する文書」に最適。
• 両方: 両方を実行し、文書ごとに強い方のスコアを採用します(両方が当たると小さなボーナス)。表示されるにはキーワードの一致か意味のある意味スコアが必要なので、弱い意味ノイズが確実なキーワード一致を埋もれさせません。

語の組み合わせによる違い

引用符は完全一致フレーズ

語を "..." で囲むと、その連続フレーズの完全一致(大文字小文字を区別しない)を、どのモードでも要求します。意味と両方のモードでは、まず存在フィルターとして働き、その後に一致を意味で順位付けします。形式を混ぜることもできます:golang "import fmt" はフレーズ import fmt または緩い語 golang を意味します。意味モードでフィラー扱いされるのは冠詞(a/an/the)と接続詞だけなので、正確な語順が重要なときはフレーズを引用符で囲んでください。

ディープリンク

意味検索はどの文書が一致するかを見つけます。ディープリンクは、その中のどこかを見つけます。結果のボタンをクリックすると、一致する箇所がページ・行・セクションのラベル付きで一覧表示されます。1 つをクリックすると、一致したテキストが黄色でハイライトされた状態で開きます。再インデックス不要で、オンデマンドに動作します。

モードは検索に従います:意味は意味で箇所を、キーワードやハイブリッドは語で箇所を見つけます。PDF、TXT、HTML、Markdown、DOCX、RTF、ODT、電子書籍、DjVu、XML 系、LaTeX、メール、ソースコードなどに対応。表計算やプレゼンテーションは、それぞれのリーダーで開く動作に戻ります。

AI 要約

文書のタイトルをクリックすると、dolphin3:latest によってローカルで生成され、初回以降はキャッシュされる、本の内容紹介のような要約が表示されます。CPU のみのハードウェアでは最初の要約は遅いことがありますが、以降の要求は瞬時です。

画面の見方

• ダーク/ライトのテーマ切り替え
• ページ分割された結果(1 ページ 50 件)と「戻る」「次へ」
• すばやく移動するための A–Z・0–9 のインデックスバー。Home でリセット
• トピックで絞り込むタグクラウド
• 各結果の関連度バッジ(0–100%)
• 開くは既定のアプリでファイルを起動。📋 はパスをコピー。🗑 はディスクとインデックスからファイルを削除(確認あり)
• ファイルが無くなった文書をクリックすると、閉じられるモーダルが表示され、インデックスから削除されます。ドライブが単にアンマウントされている場合はトーストが出て、インデックスは変更されません。

文書のインデックス化

docubrowser rescan を実行してスキャン・インデックス化・埋め込みを行います。対応する形式には次が含まれます:

• PDF、DOCX、PPTX、XLSX、RTF、CSV/TSV、メール(.eml)
• OpenDocument(ODT、ODS、ODP とテンプレート)
• EPUB、MOBI、AZW3、AZW、DjVu
• Visio(VSDX、レガシー VSD)、draw.io、PlantUML、Mermaid、SVG
• HTML、Markdown、XML/SGML、DocBook、RSS/Atom/OPML、reST、AsciiDoc、LaTeX、設定・ログファイル、ソースコード

タイトル・著者・主題は文書のメタデータから読み取られ、タグはディレクトリ構造と内容から生成されます。取り込み後の PII スキャナーは、SSN、クレジットカード、銀行のルーティング・口座番号、生年月日、MRN、運転免許、パスポートのパターンを含む文書を削除して恒久的にブラックリスト登録します。誤検出を抑えるために構造的に検証されます。ドットファイルや隠しディレクトリは設計上スキップされます。

重複は docubrowser duplist と docubrowser dupclean で見つけて整理できます。

設定

歯車アイコンを開くか、/settings にアクセスします。一般パネルでは、文書ディレクトリ(ライブのディレクトリブラウザ付き)、任意の数の追加スキャンディレクトリ、作業ディレクトリ、ポート、言語を設定します。除外ディレクトリパネルでは、スキャンからフォルダーを除外でき、すでにインデックス化されたものを削除する前に確認があります。

言語

1 つのインストールは 1 つの言語に対応し、インターフェース、検索トークナイザー、埋め込みモデル、要約モデルがすべてそれに従います。現在の対応言語:英語(既定)、日本語、韓国語、簡体字中国語、繁体字中国語。混在言語のコレクションには対応していません。

言語の選び方

• 最初の起動。 DocuBrowse は英語で起動します。ターミナルで最初に docubrowser start を実行すると、使いたい言語を尋ね、答えを保存します。案内に従うだけです。
• その後いつでも。 設定ページ(歯車アイコン)を開き、一般パネルのドロップダウンから言語を選びます。

既知の制限