MISAMA Search 1.0

MISAMA Search は、Windows 優先、完全ローカルで、ファイルとフォルダ名のみを読み取るセマンティック検索ツールです。Everything に依存せず、ファイル本文も開きません。

できること

• 正確な名前、部分文字列、中国語バイグラムあいまい一致、親ディレクトリのコンテキストによる並べ替え

• BGE-small-zh-v1.5 によるローカルセマンティック検索。例:「获奖经历」で「简历」が見つかる

• USearch HNSW Int8 による百万規模のベクトルインデックス。ネイティブモジュールがない場合は Float32 の正確な検索にフォールバック

• 安定した uint64 ファイル ID により、追加・削除・名前変更に対して増分ベクトル更新を実行

• watch はサブディレクトリの変更を自動監視。管理者権限は不要

• serve は 127.0.0.1 のみをリッスンする常駐 HTTP サービスを提供し、モデルは一度だけ読み込まれる

• MCP stdio Server と MISAMA Agent Harness Tool が同じインデックスを共有

• オプションの Windows MFT サービスが NTFS ボリューム全体の高速スキャンを担当。サービスインストールと生ボリューム読み取りにのみ管理者権限が必要

Related MCP server: ragi

プライバシーの境界

インデックスには名前、パス、タイプ、ローカルベクトルが含まれ、ファイル本文は含まれません。スキャン、埋め込み、並べ替えはすべてローカルで実行されます。MCP は選択された結果を MCP 呼び出し元に渡します。MISAMA クラウドモデルアダプターはデフォルトで無効で、ユーザーが /privacy files on を実行した場合のみ、最大 10 件の相対パス、名前、タイプ、スコアを返します。絶対パス、完全なインデックス、ベクトルは決して返しません。

クイックスタート（ソースコード）

Node.js 24+ と Go 1.24+ が必要です:

npm.cmd ci
npm.cmd run model:install
go build -trimpath -o .\bin\misama-search.exe .\cmd\misama-search

.\bin\misama-search.exe scan -backend walk -index .\data\my.idx 'D:\要索引的目录'
.\bin\misama-search.exe semantic-build -index .\data\my.idx
.\bin\misama-search.exe search -index .\data\my.idx '原神角色文件夹'

モデルは約 23.3 MiB です。ダウンロード後、MISAMA_OFFLINE=1 を設定すると完全オフラインで動作します。MISAMA_MODEL_DIR でカスタムまたは持ち運び用のモデルディレクトリを指定できます。npm.cmd run model:verify で 4 つのモデルファイルの固定 SHA-256 を検証します。

自動更新と常駐サービス

.\bin\misama-search.exe refresh -index .\data\my.idx
.\bin\misama-search.exe watch -index .\data\my.idx
.\bin\misama-search.exe serve -index .\data\my.idx -addr 127.0.0.1:37421

HTTP 検索: POST /v1/search、JSON は {"query":"获奖经历","limit":5,"semantic":true}。サービスは非ループバックアドレスへのバインドを拒否します。

MCP

MCP クライアントの起動コマンド:

node D:\路径\MISAMA-Search\semantic\mcp-server.mjs

環境変数: MISAMA_SEARCH_INDEX、MISAMA_SEARCH_EXE。常駐サービスに接続する場合は、さらに MISAMA_SEARCH_URL とオプションの MISAMA_SEARCH_TOKEN を設定します。Tool 名は semantic_file_search です。

オプションの MFT サービス

通常のワークスペースでは walk + watch を直接使用するため、サービスは不要です。NTFS ボリューム全体に高速インデックスを作成する場合のみ、管理者ターミナルで実行します:

.\bin\misama-search.exe mft-service install -index 'D:\MISAMA-Data\whole-d.idx' 'D:\'
.\bin\misama-search.exe mft-service start
.\bin\misama-search.exe mft-service status
.\bin\misama-search.exe mft-service stop
.\bin\misama-search.exe mft-service uninstall

サービス名は MISAMASearchMFT です。ファイル名メタデータのスキャンとインデックス更新のみを実行し、クラウドモデル、MCP、Agent は実行しません。

インストール、アップグレード、アンインストール

リリースアーカイブを解凍した後:

powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1 -InstallDir 'D:\Apps\MISAMA Search' -DataDir 'D:\MISAMA Search Data' -AddToPath

同じインストールコマンドを再度実行するとアップグレードされ、独立した DataDir は上書きされません。アンインストールではデフォルトでインデックスが保持されます。-RemoveData を明示的に追加した場合のみ削除されます:

powershell -ExecutionPolicy Bypass -File 'D:\Apps\MISAMA Search\scripts\uninstall.ps1' -InstallDir 'D:\Apps\MISAMA Search' -DataDir 'D:\MISAMA Search Data'

検証済みの事実

• 100 件の固定中国語シナリオ: Recall@5 99%、MRR 0.945

• 100 万件の 512 次元 Int8 HNSW: P95 4.82 ms、Recall@10 95.5%

• 常駐セマンティックサービスのホットクエリ: P95 4.54 ms

• 常駐名前のみサービスのホットクエリ: P95 0.252 ms

• npm 本番依存関係監査: 脆弱性 0 件（2026-08-20）

ハードウェア、方法、制限については BENCHMARKS.md を参照してください。中国語品質セットは手作業で作成した現実的なシナリオシミュレーションであり、ユーザーの実際のハードディスクデータではありません。合成された 100 万ベクトルの結果も中国語のセマンティック品質と同等ではありません。

既知の制限

• Windows ネイティブ MFT バックエンドは NTFS のみをサポートし、管理者権限が必要です。失敗時は auto がディレクトリ走査にフォールバックします

• watch は変更を受け取った後に名前メタデータの照合を実行します。大規模ディレクトリでは今後 USN イベントによる直接更新にアップグレード可能です

• HNSW の容量を使い切ると自動的に全量再構築が実行され、二重インデックスによる無停止切り替えはまだ実装されていません

• 初回のモデルダウンロードにはネットワーク接続が必要です。オフラインリリースでは、検証済みの models ディレクトリを個別に配布できます

ライセンス: プロジェクトソースコードは MIT。サードパーティコンポーネントについては THIRD_PARTY_NOTICES.md を参照してください。