olares-search について
olares-search は、Olares でファイル、ナレッジ、インストール済みアプリを検索するコマンドラインスキルです。複数のソースを非同期インデックスで検索し、コンテンツ検索とアプリ名検索を区別します。
主な機能
- 01Drive、Sync、Google Drive、Dropbox の横断検索
- 02Wise のナレッジ検索
- 03タイトルによるインストール済みアプリの検索
- 04インデックス状態と対象範囲の確認
活用シーン
- 01名前や内容からファイルを検索
- 02Wise でナレッジ項目を検索
- 03表示タイトルでインストール済みアプリを検索
- 04検索漏れがインデックス範囲によるものか確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/olares-searchを入力して読み込まれたか確認します。
詳細
search（デスクトップのグローバル検索）
共通の入口： スイート内のルーティング、アクティブなプロファイルの選択、プラットフォームの入口、認証を続行するか停止するかの判定については、
../olares-shared/SKILL.mdを読み込んでください。ログイン、プロファイルの切り替え、トークンの保存、または認証の復旧が実際に必要な場合に限り、認証リファレンスを読み込んでください。
構文については olares-cli search <subcommand> --help を使用してください。
使用する場面
- Drive、Sync、Google Drive、Dropbox、Wise 全体から、名前または内容でファイルやナレッジ項目を検索します。Olares 1.12.7 以降では、
search driveで4つすべてのファイルソースを検索できます。 - インストール済みアプリを、表示名で検索します。
基本的な考え方：
search drive／search sync／search knowledgeは、ユーザーごとに事前作成されたインデックスを照会し、「このテキストを含むファイルはどれか」に答えます。search appは「この名前に一致するインストール済みアプリはどれか」に答えます。アプリのライフサイクル一覧（market list --mine／market status）やリソースのランキング（dashboard applications）ではありません。既知のパスを一覧表示または読み取るには、olares-files（files ls／files cat／files download）を使用してください。
すぐに使えるコマンド
| タスク | 参照先 | 最初に実行するコマンド |
|---|---|---|
| 名前または内容でファイルを検索する | このファイル | olares-cli search drive "quarterly report" -o json |
| 表示名でインストール済みアプリを検索する | このファイル | olares-cli search app music -o json |
| Wise 内を検索する | このファイル | olares-cli search knowledge "retrieval" -o json |
| 「インデックスにない」と「存在しない」を見分ける | このファイル、次に既知のパスについては olares-files | olares-cli settings search status -o json |
サブコマンド一覧
| サブコマンド | 用途 | 該当する場合に読む内容 |
|---|---|---|
drive（files） | Drive、Sync、Google Drive、Dropbox を横断した検索 | インデックスの対象範囲 — 検索結果が見つからない場合に何が言えるかは、インデックスの対象範囲で決まります |
sync | Sync（Seafile）のライブラリのみ | インデックス作成 — drive がすでにカバーしている内容を絞り込んだ表示です |
knowledge（wise） | Wise／Knowledge のコンテンツ検索 | インデックス作成 — このインデックスは Wise が管理します。Olares 1.12.7 以降が必要です |
app | インストール済みアプリの表示名検索 | 追加の参照先はありません。これは表示名との一致検索であり、アプリのライフサイクル一覧ではありません |
独立した gdrive または dropbox サブコマンドはありません。Olares 1.12.7 以降では、drive は files_v2、google_drive、dropbox、seafile を1つの非同期フェデレーションリクエストで検索します。これは、デスクトップのダイアログにある単一の「ファイル」項目に対応します。sync は同じ検索チャネルを seafile に限定します。Olares 1.12.6 以前にはフェデレーションチャネルがありません。そのため、これらのバージョンでは drive はローカルの Drive ファイルのみを対象とし、sync は /api/search/sync にフォールバックします。したがって、1.12.7 以降の drive でカバーされる範囲を検索するには、両方のコマンドが必要です。
google/<account>/... や dropbox/<account>/... などのクラウド検索結果の場所は、files ls、files cat、files download で使用できる有効なファイルパスです。Sync の場所は /sync/<repo_id>/... として示され、ライブラリの表示名が注記されます。files ls sync/<repo_id>/ には名前ではなく ID を指定します。
Google Drive と Dropbox の検索結果には、Olares 1.12.7 以降と連携のバインドが必要です。バインドされていないアカウントはエラーではなく失敗したソースとして返されるため、ジョブは引き続き完了し、他のソースの検索結果も出力されます。
インデックス作成（ドライブ／同期／クラウド／ナレッジ）
インデックス作成は非同期です。検索結果がないからといって、対象が存在しないとは限りません。既知のパスについては、files ls で確認し、settings search status で抽出エラーとインデックス作成の進行状況を確認してください。対象範囲を確認し、承認を得てからのみ再構築してください。
Google Drive と Dropbox は、アカウントを連携した後、プロバイダー側でクロールされます。olares-cli settings integration accounts list-by-type google|dropbox で、実際にアカウントが連携されているか確認してください。リストが空であることが、「連携なし」と「インデックス作成済みだが一致なし」を区別する手がかりです。クラウド検索では、どちらに該当するかを判別できません。連携は LarePass → Settings → Integration で行い、CLI からは行いません。ナレッジのインデックス作成は Wise が担当します。
インデックスの対象範囲（ドライブのみ）
- ファイル名は、除外パターンに従って幅広くインデックス化されます。
- 全文のインデックス作成は、既定で Drive の
/Documents/が対象です。他のディレクトリを対象にするには、settings search dirs addが必要です。 - 対応形式でも、暗号化、破損、またはサイズ超過により抽出に失敗することがあります。
settings search status -o jsonで確認してください。 - 除外パターンの管理は引き続き Settings UI で行います。CLI に存在しないコマンドを作らないでください。
安全性とエスカレーション
- 検索は読み取り専用です。
settings search dirs add/rmとrebuildはそれぞれ独立した設定変更であり、確認が必要です。 no resultsを、ファイルやアプリが存在しない証拠として扱わないでください。インデックス作成の遅延、対象範囲、抽出の失敗、連携の有無、可視性、実際に一致するものがない状態を区別してください。- ユーザーが別個の操作を承認していない状態で、連携またはインデックスの再構築を求めた場合は中止し、
olares-settingsに案内してください。