MISAMA Search 1.0

MISAMA Search — это семантический поисковик, ориентированный на Windows, полностью локальный, читающий только имена файлов и папок. Он не зависит от Everything и не открывает содержимое файлов.

Возможности

• Точное совпадение имени, подстрока, нечёткое сопоставление китайских биграмм и ранжирование по контексту родительского каталога;

• Локальный семантический поиск BGE-small-zh-v1.5, например, «获奖经历» находит «简历»;

• Векторный индекс USearch HNSW Int8 на миллионы записей, при отсутствии нативного модуля — откат к точному поиску Float32;

• Стабильные uint64 идентификаторы файлов, инкрементальное обновление векторов при добавлении, удалении и переименовании;

• watch автоматически отслеживает изменения в подкаталогах, не требуя прав администратора;

• serve предоставляет постоянный HTTP-сервис, слушающий только 127.0.0.1, модель загружается один раз;

• 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 МиБ. После загрузки можно установить MISAMA_OFFLINE=1 для полной работы офлайн; MISAMA_MODEL_DIR позволяет указать пользовательский или переносимый каталог модели. npm.cmd run model:verify проверяет фиксированные 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}. Сервис отказывается привязываться к адресам, отличным от loopback.

MCP

Команда запуска MCP-клиента:

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

Переменные окружения: MISAMA_SEARCH_INDEX, MISAMA_SEARCH_EXE; при подключении к постоянному сервису дополнительно задаются MISAMA_SEARCH_URL и опциональный MISAMA_SEARCH_TOKEN. Имя инструмента — 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;

• Миллион записей 512-мерного Int8 HNSW: P95 4.82 мс, Recall@10 95.5%;

• Горячие запросы постоянного семантического сервиса: P95 4.54 мс;

• Горячие запросы постоянного сервиса только по именам: P95 0.252 мс;

• Аудит npm-зависимостей для продакшена: 0 уязвимостей (2026-08-20).

Оборудование, методика и ограничения — в BENCHMARKS.md. Китайский набор качества — это вручную написанная симуляция реальных сценариев, а не реальные данные с дисков пользователей; синтетические результаты на миллионе векторов также не эквивалентны качеству китайской семантики.

Известные ограничения

• Нативный Windows MFT-бэкенд поддерживает только NTFS и требует прав администратора; при сбое auto откатывается к обходу каталогов;

• watch после получения изменений выполняет сверку метаданных имён; для больших каталогов в дальнейшем возможен переход к прямому обновлению по событиям USN;

• При исчерпании ёмкости HNSW автоматически выполняется полная перестройка; переключение между двумя индексами без простоя пока не реализовано;

• Первая загрузка модели требует подключения к сети; в офлайн-релизах проверенный каталог models можно распространять отдельно.

Лицензия: исходный код проекта — MIT. Сторонние компоненты — в THIRD_PARTY_NOTICES.md.