MISAMA Search 1.0

MISAMA Search es un buscador semántico prioritario para Windows, totalmente local, que solo lee nombres de archivos y carpetas. No depende de Everything ni abre el contenido de los archivos.

Qué puede hacer

• Coincidencia exacta de nombres, subcadenas, coincidencia difusa de bigramas en chino y ordenación por contexto del directorio principal;

• Búsqueda semántica local BGE-small-zh-v1.5, por ejemplo, "experiencia de premios" encuentra "currículum";

• Índice vectorial USearch HNSW Int8 a escala de millones, con respaldo a búsqueda exacta Float32 cuando falta el módulo nativo;

• ID de archivo uint64 estable, con actualización vectorial incremental para altas, bajas y renombrados;

• watch supervisa automáticamente los cambios en subdirectorios sin necesidad de permisos de administrador;

• serve ofrece un servicio HTTP residente que solo escucha en 127.0.0.1; el modelo se carga una sola vez;

• El servidor MCP stdio y MISAMA Agent Harness Tool comparten el mismo índice;

• El servicio opcional Windows MFT se encarga del escaneo de alta velocidad de volúmenes NTFS completos; solo la instalación del servicio y la lectura del volumen sin procesar requieren permisos de administrador.

Related MCP server: ragi

Límites de privacidad

El índice contiene nombres, rutas, tipos y vectores locales, pero no el contenido de los archivos. El escaneo, la incrustación y la clasificación se realizan localmente. MCP entrega los resultados seleccionados al llamador de MCP; el adaptador de modelo en la nube de MISAMA está desactivado por defecto; solo después de que el usuario ejecute /privacy files on se devuelven como máximo 10 rutas relativas, nombres, tipos y puntuaciones, y nunca se devuelven rutas absolutas, el índice completo ni los vectores.

Inicio rápido (código fuente)

Se requiere Node.js 24+ y 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 '原神角色文件夹'

El modelo ocupa unos 23,3 MiB. Tras la descarga, se puede configurar MISAMA_OFFLINE=1 para estar completamente sin conexión; MISAMA_MODEL_DIR permite especificar un directorio de modelos personalizado o portátil. npm.cmd run model:verify verifica el SHA-256 fijo de los cuatro archivos del modelo.

Actualización automática y servicio residente

.\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

Búsqueda HTTP: POST /v1/search, con JSON {"query":"获奖经历","limit":5,"semantic":true}. El servicio rechaza vincularse a direcciones que no sean de bucle local.

MCP

Comando de inicio del cliente MCP:

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

Variables de entorno: MISAMA_SEARCH_INDEX, MISAMA_SEARCH_EXE; si se conecta a un servicio residente, configure también MISAMA_SEARCH_URL y, opcionalmente, MISAMA_SEARCH_TOKEN. El nombre de la herramienta es semantic_file_search.

Servicio MFT opcional

Para espacios de trabajo normales, use directamente walk + watch; no se necesita ningún servicio. Solo cuando se indexa a alta velocidad un volumen NTFS completo, ejecute en un terminal de administrador:

.\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

El nombre del servicio es MISAMASearchMFT. Solo realiza el escaneo de metadatos de nombres de archivo y la actualización del índice; no ejecuta modelos en la nube, MCP ni Agent.

Instalación, actualización y desinstalación

Tras descomprimir el paquete de la versión:

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

Volver a ejecutar el mismo comando de instalación actualiza; el DataDir independiente no se sobrescribe. La desinstalación conserva el índice de forma predeterminada; solo se elimina si se añade explícitamente -RemoveData:

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

Hechos probados

• 100 consultas congeladas en chino: Recall@5 99 %, MRR 0,945;

• Un millón de vectores Int8 HNSW de 512 dimensiones: P95 4,82 ms, Recall@10 95,5 %;

• Consultas en caliente del servicio semántico residente: P95 4,54 ms;

• Consultas en caliente del servicio de solo nombres residente: P95 0,252 ms;

• Auditoría de dependencias de producción de npm: 0 vulnerabilidades (2026-08-20).

El hardware, los métodos y las limitaciones se describen en BENCHMARKS.md. El conjunto de calidad en chino es una simulación realista escrita a mano, no datos reales del disco del usuario; los resultados sintéticos de un millón de vectores tampoco equivalen a la calidad semántica del chino.

Limitaciones conocidas

• El backend MFT nativo de Windows solo admite NTFS y requiere permisos de administrador; en caso de error, auto recurre al recorrido de directorios;

• watch concilia los metadatos de nombres tras detectar cambios; en el futuro, los directorios grandes podrán actualizarse directamente mediante eventos USN;

• Cuando se agota la capacidad de HNSW, se reconstruye todo automáticamente; aún no se ha implementado el cambio sin interrupciones con doble índice;

• La primera descarga del modelo requiere conexión a Internet; para distribuciones sin conexión, el directorio models verificado se puede distribuir por separado.

Licencia: el código fuente del proyecto es MIT. Para componentes de terceros, consulte THIRD_PARTY_NOTICES.md.