FilePulse Guía del usuario

Tutorial completo y referencia

Aprenda a utilizar FilePulse de manera efectiva con nuestra guía completa, que cubre desde operaciones básicas hasta configuración avanzada.

Instrucciones de inicio

Cómo ejecutar FilePulse

FilePulse se ejecuta en Windows, macOS y Linux. La consola web local predeterminada utiliza los puertos 80 (HTTP) y 443 (HTTPS); Si alguno de los puertos está ocupado, FilePulse buscará automáticamente un conjunto de puertos HTTP/HTTPS disponibles, generalmente en el rango 80–10000, escribirá el nuevo puerto config.json y reiniciará automáticamente la carga. El mensaje de inicio mostrará la nueva dirección de acceso. Solo cuando falla la selección o escritura automática, o el entorno de red requiere un puerto fijo, debe modificar manualmente config.json.

Guía de la plataforma

Windows

Ejecute FilePulse.exe en un directorio separado. Cuando la indexación de discos, las operaciones de archivos o la vinculación de puertos bajos requieren privilegios de administrador, FilePulse aumentará automáticamente los privilegios.

Instrucciones de la versión de Windows

1. Extraer a un directorio separado

Descomprima completamente el paquete de versión en un directorio separado antes de ejecutarlo. Se recomienda utilizar un nuevo directorio independiente al actualizar la versión para evitar conflictos entre la configuración anterior o los archivos en ejecución y la nueva versión.

2. Iniciar FilePulse

Haga doble clic en FilePulse.exe para comenzar. No fuerce la casilla de verificación "Ejecutar este programa como administrador" en la pestaña Compatibilidad; el iniciador normal gestionará la escalada de privilegios conservando la capacidad de abrir archivos con permisos normales.

FilePulse.exe
3. Compruebe la marca del escudo

Si FilePulse.exe. Colóquelo en otras carpetas hasta que no haya escudo. De lo contrario, afectará la apertura de un objetivo con permisos normales. Si no necesita esta función, puede ignorarla.

4. Manejar letras de unidad no disponibles

Si aparece "El registro de cambios de volumen está inactivo", significa que hay un problema con una letra de unidad. Debe modificar config.json para eliminar la letra de unidad problemática de drive_list.

Guía de la plataforma

macOS

macOS Gatekeeper puede bloquear aplicaciones descargadas de Internet. Consulte los siguientes pasos según la versión que descargó:

instrucciones de la versión .app

Recomendación: después de la descarga, mueva la aplicación a otro directorio (como /Aplicaciones) para ejecutarla. No lo ejecute directamente en el directorio de descarga para evitar ser interceptado por el sistema.

1. Eliminar el atributo de cuarentena

Abra la terminal e ingrese al directorio donde se encuentra la aplicación y ejecute:

xattr -dr com.apple.quarantine FilePulse.appchmod +x FilePulse.app/Contents/MacOS/*
2. Permitirlo en la configuración del sistema

Si no se puede abrir: abra "Configuración del sistema" → "Privacidad y seguridad" → Desplácese hasta la parte inferior → busque FilePulse y haga clic en "Abrir de todos modos".

Instrucciones de la edición estándar

1. Conceder permiso de ejecución

Abra una terminal en el directorio del programa y ejecute:

chmod +x FilePulse
2. Permitirlo en la configuración del sistema

Si la operación está bloqueada: abra "Configuración del sistema" → "Privacidad y seguridad" → haga clic en "Abrir de todos modos".

3. Iniciar con sudo

Utilice sudo para iniciar la versión estándar para mostrar el icono de la bandeja normalmente y obtener permisos completos:

sudo ./FilePulse
4. Utilice sudo para ejecutar en segundo plano

Utilice el siguiente script para ejecutar en segundo plano (debe introducir la contraseña de sudo para cada ejecución):

Vaya a la página de descarga para ver el script de inicio en segundo plano completo
  • Opcional: si desea permitir que los directorios protegidos de macOS como "Escritorio, Documentos, Descargas" participen en la búsqueda, vaya a "Configuración del sistema → Privacidad y seguridad → Acceso completo al disco", lo que iniciará Terminal.app o FilePulse. traducir="no">FilePulse.app Agregar y habilitar. Cuando no se concede, FilePulse seguirá funcionando normalmente, pero es posible que los archivos de estos directorios no aparezcan en los resultados de búsqueda.

Guía de la plataforma

Linux

Se ha verificado en Debian, Ubuntu, Arch Linux y CachyOS, FilePulse en general se ejecuta normalmente.

Instrucciones de uso de la versión AppImage

1. Conceder permiso de ejecución

Después de descomprimir el zip, abra una terminal en el directorio que contiene el archivo AppImage y ejecute:

chmod +x ./FilePulse.AppImage
2. Iniciar AppImage

Si solo hay un archivo AppImage en el directorio actual, puede ejecutarlo directamente:

sudo ./FilePulse.AppImage

Instrucciones de la edición estándar

1. Conceda permiso de ejecución

Abra una terminal en el directorio del programa y ejecute:

chmod +x FilePulse
2. Instale bibliotecas dependientes

Ejecute el siguiente comando en la terminal (Ubuntu/Debian):

sudo apt install -y libxdo3 libunwind-15 libayatana-appindicator3-1 libwebkit2gtk-4.1-0
3. Utilice sudo para iniciar

Se recomienda utilizar permisos de root para iniciar el programa para garantizar una funcionalidad normal:

sudo ./FilePulse
4. Use sudo para ejecutar en segundo plano

Puede usar el siguiente script para iniciar FilePulse con permisos sudo y ejecutarlo en segundo plano sin esperar a que finalice el programa. Debe ingresar la contraseña de sudo para cada ejecución:

Vaya a la página de descarga para ver el script de inicio en segundo plano completo
  • Si está utilizando X11, tanto AppImage como Standard Edition funcionarán y todas las funciones funcionarán.
  • Si estás utilizando Wayland, se recomienda descargar primero la versión estándar. AppImage también se puede usar en Wayland, pero debido a problemas conocidos en Wayland, al hacer doble clic para iniciar o activar el inicio automático, la interfaz puede atascarse o el inicio puede atascarse. Si aún desea utilizar AppImage, no haga doble clic para ejecutarlo ni habilitar el inicio automático. En su lugar, utilice el comando sudo ./FilePulse.AppImage para iniciarlo.

Puerto predeterminado: 80 (HTTP) y 443 (HTTPS)

Cuando el puerto predeterminado está ocupado, FilePulse generalmente selecciona automáticamente un puerto disponible, escribe config.json y se reinicia automáticamente; La configuración manual solo es necesaria cuando se requiere un puerto fijo o falla la recuperación automática.

Prueba gratuita

Prueba gratuita de 30 días para nuevos usuarios

Notas

Si FilePulse.exe. Colóquelo en otras carpetas hasta que no haya escudo. De lo contrario, afectará la apertura de un objetivo con permisos normales. Si no necesita esta función, puede ignorarla.

Si se ejecuta en modo normal, el programa cambiará automáticamente a privilegios de administrador, pero no establezca la etiqueta de compatibilidad en el atributo FilePulse.exe para ejecutar este programa como administrador. Si configura la compatibilidad, no podrá abrir un objetivo con privilegios normales como se mencionó anteriormente. Si no necesita esta función, puede ignorarla.

Si aparece "El registro de cambios de volumen está inactivo", significa que hay un problema con una letra de unidad. Debe modificar config.json para eliminar la letra de unidad problemática de drive_list.

Después de la actualización de la versión, es mejor colocar el FilePulse recién descargado en una nueva carpeta por separado para evitar conflictos entre la configuración anterior y la nueva.

En Windows, macOS y Linux, la cola de eventos de archivos del sistema operativo tiene una capacidad limitada. Cuando se modifica una gran cantidad de archivos en lotes en un corto período de tiempo (por ejemplo, se eliminan 10 000 archivos en 1 segundo), es posible que algunos eventos no se entreguen a FilePulse, lo que provoca que se pierda temporalmente información de archivos individuales. Esta es una limitación del sistema operativo y no un mal funcionamiento de FilePulse; reinicie FilePulse para resincronizar.

Introducción a la función principal

Explore las funciones principales de FilePulse

Función principal 1: búsqueda de nombre de archivo

Similar a todo, con varias condiciones de filtrado complejas, se utiliza principalmente para las búsquedas complejas de los usuarios y puede responder en milisegundos

Función principal 2: búsqueda de contenido de archivos

Puede buscar texto, documentos de Office, PDF, libros electrónicos, páginas web y contenido de imágenes reconocido a través de OCR. El texto de las capturas de pantalla, los archivos PDF escaneados y las imágenes incrustadas en documentos también se pueden recuperar después de la indexación.

Función principal 3: Búsqueda visual

Admite el uso de imágenes, capturas de pantalla o vídeos como consultas para encontrar imágenes visualmente similares y videoclips coincidentes, y ver miniaturas, rutas, servidores y períodos de tiempo de destino.

Función principal 4: Iniciador rápido

Similar a listary, los resultados de las palabras clave de entrada se ordenan de antemano según la mayoría de los hábitos, localiza rápidamente la ubicación de destino y comienza

Función principal 5: Deduplicación de archivos

Compare rápidamente archivos duplicados según su tamaño y características, y limpie eficientemente las redundancias después de su seguridad revisión.

Función principal 6: vista previa y transmisión remotas

Admite vista previa rápida de documentos, libros electrónicos, paquetes comprimidos, imágenes, audio y video y otros formatos, y se puede descargar, cargar y ubicar de forma remota.

Función principal 7: sincronización remota automática de carpetas

Los directorios de mapeo locales y remotos se pueden sincronizar de forma continua y automática, lo que admite actualizaciones periódicas, reconexión estable y seguimiento de registros de eliminación.

Función principal 8: sesión de IA

Admite gestión de configuración de LLM, persistencia de sesiones múltiples, carga de imágenes y borrado de todas las sesiones con un solo clic.

Función principal 9: panel de inicio

De manera similar al inicio sónico, el software de uso común se agrega por adelantado (debido al uso de un navegador, arrastrar y soltar no puede obtener la ruta completa. Actualmente, se requiere entrada y arrastrar y soltar se puede usar para crear aplicaciones nativas en el futuro)

Función principal 10: redes de clúster

Utilizando capacidades remotas y de búsqueda principal, LaunchPad es opcional en el clúster.

Función principal 11: Búsqueda contextual

Admite el uso de teclas de método abreviado para traer automáticamente la ruta actual del administrador de archivos en Windows, macOS, Linux y conectar cuadros de diálogo abiertos compatibles en Windows. También puede continuar refinando el alcance de búsqueda actual o regresar al alcance del nivel superior.

Función principal 12: Buscar espacio de trabajo

Admite la gestión de tareas de búsqueda en curso mediante anotaciones de búsqueda persistentes, agrupaciones, elementos fijados, clasificación personalizada, recuperación de inicio y navegación con teclado más fluida.

Guía de flujo de trabajo

Seleccione la tarea a completar y luego abra el caso práctico paso a paso correspondiente.

1

Búsqueda de nombre de archivo

Localice objetivos rápidamente mediante filtrado, regularización y pinyin.

Abra un caso paso a paso
2

Búsqueda de contenido de archivos

Recupere texto de documentos y texto de imágenes reconocidos por OCR, lo que admite indexación, clasificación por clasificación, resaltado y vista previa rápida.

Abra un caso paso a paso
3

Búsqueda visual

Sube imágenes o vídeos, o pega capturas de pantalla directamente para buscar imágenes similares y localizar videoclips coincidentes.

Abra un caso paso a paso
4

Lanzador rápido

Abre aplicaciones y carpetas al instante por palabra clave.

Abra un caso paso a paso
5

Deduplicación de archivos

Encuentre rápidamente archivos duplicados y libere espacio.

Abra un caso paso a paso
6

Transmisión remota

Cargue, descargue y ubique archivos entre nodos para una operación remota sin problemas.

Abra un caso paso a paso
7

Sincronización remota automática de carpetas

Los directorios de mapeo locales y remotos se sincronizan de manera continua y automática, lo que hace que las actualizaciones sean más sencillas.

Abra un caso paso a paso
8

Vista previa rápida

Vista previa ligera de documentos, imágenes y contenido multimedia.

Abra un caso paso a paso
9

Sesión de IA

Admite sesiones contextuales y carga de imágenes, y conserva sesiones históricas.

Abra un caso paso a paso
10

Acceso compartido

Cuando se necesita colaboración, se puede generar una entrada compartida para un acceso más conveniente.

Abra un caso paso a paso
11

Búsqueda contextual

Ingrese la búsqueda más rápido desde la carpeta actual y continúe refinando manualmente el alcance o regrese al alcance del nivel superior.

Abra un caso paso a paso
12

Espacio de trabajo de búsqueda

Organiza continuamente tareas de búsqueda complejas con anotaciones persistentes, agrupaciones, elementos fijados, clasificación personalizada y navegación de resultados más fluida.

Abra un caso paso a paso

Mejore la eficiencia de la búsqueda

Utilice estas herramientas livianas para reutilizar consultas rápidamente, organizar tareas en paralelo y explorar resultados de manera más eficiente.

Historial de búsqueda

Reutilizar directamente consultas recientes sin reconstruir repetidamente las mismas condiciones.

Entrada: Búsqueda de nombre de archivo, búsqueda de contenido o iniciador rápido → botón Historial al lado del cuadro de consulta.

Ver casos prácticos

Valores predeterminados de búsqueda

Guarde todo el conjunto de criterios de búsqueda y vuelva a aplicarlos en cualquier momento, o configúrelos como predeterminados.

Entrada: Búsqueda de nombre de archivo y búsqueda de contenido → Buscar ajustes preestablecidos.

Ver casos prácticos

Espacio de trabajo con varias pestañas

Realice múltiples búsquedas de nombres de archivos, búsquedas de contenido, búsquedas visuales o tareas de inicio rápido simultáneamente.

Entrada: Admite la barra de pestañas en la parte superior de la página de búsqueda multitarea.

Ver casos prácticos

Exportación de resultados

Exporte el conjunto de resultados filtrado actual como un archivo TSV para continuar con el procesamiento.

Entrada: Parte inferior del área de resultados → Exportar.

Ver casos prácticos

Vista de iconos

Utilice miniaturas y tamaños de iconos ajustables para explorar los resultados visuales más rápido.

Entrada: Parte inferior del área de resultados → Configuración de pantalla → Modo de visualización.

Ver casos prácticos

Buscar anotaciones

Agrupa, fija y personaliza la clasificación de los resultados que requieren un seguimiento continuo.

Entrada: Configuración → Experiencia de búsqueda y luego úsela a través del menú contextual de resultados o el administrador de anotaciones.

Ver casos prácticos

Admite la búsqueda de tipos de contenido de archivos

FilePulse admite la búsqueda de contenido en múltiples formatos de archivos

Procesadores especializados procesan diferentes tipos de archivos, incluidos procesadores OCR para imágenes, archivos PDF escaneados e imágenes incrustadas en documentos de Office. Puede seleccionar el procesador apropiado por tipo de archivo en "Configuración -> Reglas de contenido/Configuración del procesador".

Extracción de texto estándar

Estos procesadores se utilizan cuando el documento ya contiene texto seleccionable, texto de documento estructurado, contenido de libro electrónico o texto de página web.

text_handler

Todos los archivos de tipo texto se leen tal cual

txt, md, json, py, js, css, xml, csv, log, etc.

docx_handler

Todo el texto de los documentos de Microsoft Word

docx

xlsx_handler

Todo el texto de tablas de Microsoft Excel

xlsx

pptx_handler

Todo el texto de una presentación de Microsoft PowerPoint

pptx

pdf_handler

PDF Todo el texto del documento

pdf

rtf_handler

Todo el contenido de texto de documentos con formato de texto enriquecido RTF

rtf

epub_handler

Contenido buscable en archivos de libros electrónicos EPUB

epub

fb2_handler

Contenido buscable en libros electrónicos FB2 archivos

fb2

html_handler

Contenido de página web HTML sin etiquetas

html, htm

OCR Reconocimiento mejorado

Utilice estos procesadores cuando aparezca información importante en capturas de pantalla, fotografías, páginas escaneadas, archivos PDF basados ​​en imágenes o imágenes incrustadas en documentos de Office.

docx_ocr_handler

Texto de documento de Word, más texto reconocido OCR en imágenes incrustadas

docx que contiene capturas de pantalla, fotografías o páginas escaneadas

xlsx_ocr_handler

Texto de tabla de Excel, más OCR en imágenes incrustadas Reconocido texto

xlsx con capturas de pantalla o notas de imágenes pegadas

pptx_ocr_handler

texto de diapositiva de PowerPoint, más texto reconocido OCR en la imagen de la diapositiva

pptx con capturas de pantalla, gráficos o páginas de fotos

pdf_ocr_handler

Texto PDF, además de texto reconocido OCR en páginas escaneadas e imágenes incrustadas

Escaneos, capturas de pantalla o PDF combinados de imágenes y texto

image_ocr_handler

OCR reconocimiento de texto de archivos de imagen para que las capturas de pantalla y las fotos también se puedan encontrar a través de la búsqueda de contenido

png, jpg, jpeg, webp, bmp, tiff

Medios de búsqueda visual

Utilice estos tipos cuando las imágenes o vídeos necesiten participar en la búsqueda visual, la comparación de capturas de pantalla y la visualización de videoclips. La búsqueda visual de vídeo requiere que FFmpeg esté disponible.

visual_search

Las imágenes y archivos de vídeo comunes se pueden utilizar como objetivos de búsqueda visual o archivos de consulta. La búsqueda de imágenes funciona de forma inmediata, la indexación y consulta de vídeos requieren FFmpeg.

jpg, jpeg, png, webp, bmp, tiff, mp4, mov, mkv, avi, webm

Consejo: cuando exista información buscable en forma de imágenes en lugar de texto seleccionable, utilice el procesador OCR.

Teclas de acceso directo

Domine estas teclas de método abreviado para mejorar la eficiencia de su trabajo

Teclas de método abreviado globales

Alt + Q
Busque en la carpeta/cuadro de diálogo abierto actualmente y ajuste el alcance de búsqueda actual más adelante.
Alt + F
Abra el iniciador rápido y ejecute un programa inmediatamente ingresando algunas palabras clave
Alt + W
Abra el panel de inicio. Los usuarios pueden agregar algunos íconos de ruta ellos mismos, que se pueden abrir haciendo doble clic en el futuro
Alt + `
Abra la página de búsqueda de nombres de archivos. Admite traer automáticamente la ruta actual del administrador de archivos a Windows, macOS y Linux, continuar conectando cuadros de diálogo abiertos compatibles en Windows y refinar el alcance de la búsqueda.
Win + `
Abra la página de búsqueda de contenido de archivos

Teclas de acceso directo de la interfaz web

Alt + 4
Puede modificar rápidamente el tipo de búsqueda (carpetas y archivos, carpetas, archivos) en las páginas de búsqueda y de inicio rápido
Alt + 1/2
El panel de inicio se utiliza para cambiar rápidamente de grupo
Alt + 1/2/3
Cambiar contenido Complemento
Alt + Página arriba/abajo, Ctrl + cursores izquierdo y derecho
Cambiar paginación
Teclas de cursor arriba y abajo
Seleccionar elementos en la tabla de resultados de búsqueda
Teclas de cursor izquierda y derecha
Abrir el menú para el elemento seleccionado, avance rápido y retroceda 5 segundos para la vista previa del vídeo
Tecla Intro
Ejecute el elemento en el menú
Ctrl + Enter
Localice rápidamente la ubicación de destino en el administrador de recursos
Ctrl + C
Copiar el archivo de destino
Ctrl + X
Cortar el archivo de destino
Space
Seleccione el archivo para una vista previa rápida remota
Alt + Enter
Vista previa de la ventana de video en pantalla completa
Ctrl + flechas izquierda y derecha
Vista previa de la ventana de video, avance rápido y rebobinado durante 30 segundos
Ctrl + Alt + flechas izquierda y derecha
Cambio de pestaña de control
Alt + /
Contenido de búsqueda seleccionado en la página

Uso avanzado

Desbloquee todo el potencial de FilePulse

Reemplazar certificado

El certificado integrado es un certificado de desarrollo. Si necesita reemplazar el certificado real, reemplace el archivo en el directorio de certificados.

Habilitar HTTP3

HTTP2/HTTP3 están habilitados al mismo tiempo de forma predeterminada, pero debido a problemas con el certificado de desarrollo, es posible que se degrade automáticamente a HTTP2. Después de reemplazarlo con un certificado real, podrá usar HTTP3 normalmente.

Expresión avanzada

Expresión simple (la expresión avanzada está desactivada)

Los cuadros de edición de Búsqueda de contenido y Ruta admiten corchetes sin (!) y (espacio) o (

Expresión avanzada (la expresión avanzada está activada)

Los cuadros de edición Buscar contenido y ruta admiten no y , o , corchetes izquierdos , corchetes derechos

Búsqueda avanzada de contenido de archivos

Búsqueda normal (la búsqueda lineal está desactivada)

Corresponde a cuatro modos de búsqueda: modo normal, expresión regular, coincidencia de prefijos y coincidencia aproximada. Entre ellos, la coincidencia difusa tiene el peor rendimiento, así que trate de evitar su uso. La coincidencia de prefijos debe comenzar con dos participios y las expresiones simples están separadas por espacios, por lo que la coincidencia de prefijos requiere una expresión avanzada.

Búsqueda lineal (la búsqueda lineal está activada)

Corresponde a dos modos de búsqueda: búsqueda con comodines y búsqueda con expresiones regulares. Ambos coinciden con todos los archivos que deben consultarse uno por uno y el rendimiento empeorará.

Conéctese al servidor remoto

Rellene la dirección, protocolo, nombre de usuario y contraseña en "Configuración → Servidor remoto". Los servidores guardados correctamente se conservarán; FilePulse intentará volver a conectarse automáticamente después del inicio. Si la conexión falla, continuará intentándolo a intervalos gradualmente extendidos. Juzgue si el servidor está actualmente en línea a través del estado de la conexión en la configuración.

Letra de unidad de montaje remoto

1

Configure y seleccione un servidor remoto guardado y en línea, y luego confirme el protocolo de devolución de llamada y la dirección a la que puede acceder la instancia remota.

2

Cuando el montaje automático está habilitado, la configuración de montaje se conserva tras los reinicios. El tiempo necesario para el primer montaje depende de la cantidad de archivos en el servidor remoto.

3

FilePulse comprueba las instancias remotas, el estado de las devoluciones de llamadas y las concesiones de montaje. Cuando la instancia remota se reinicia, se desconecta o el estado de montaje deja de ser válido, los datos remotos caducados se borrarán y se intentará volver a montar; Es posible que los resultados remotos no sean visibles temporalmente durante la recuperación.

Windows pautas de montaje de WebDAV

Al realizar el montaje mediante WebDAV en Windows, las principales consideraciones son la compatibilidad con la conexión HTTP y las limitaciones de tamaño de archivo.

Habilite HTTP
1

Presione Win + R, ingrese regedit para abrir el Editor del Registro.

2

Ubique HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters.

3

Busque BasicAuthLevel y cambie los datos del valor a 2.

4

Presione Win + R, ingrese services.msc para abrir el administrador de servicios.

5

Busque WebClient, haga clic derecho y seleccione Reiniciar.

Pregunta que el tamaño del archivo excede el límite
1

Windows El límite de tamaño de archivo predeterminado para la transferencia WebDAV es 50 M.

2

Busque FileSizeLimitInBytes en la misma ruta.

3

Cambie el valor predeterminado 2faf080 a ffffffff para ajustar el valor máximo transferible de WebDAV de 50M a 4G.

4

Busque WebClient, haga clic derecho y seleccione Reiniciar.

Windows Configuración de asignación de recursos compartidos

Windows Antes de utilizar el uso compartido, habilite la autenticación básica de WebClient en el registro.

1

Haga clic derecho en Inicio y seleccione Ejecutar.

2

Escriba regedit y haga clic en Aceptar.

3

En el Editor del Registro, vaya a HKEY_LOCAL_MACHINE > SISTEMA > CurrentControlSet > Servicios > WebClient > Parámetros.

4

Abre BasicAuthLevel y cambia los datos numéricos a 2.

5

Reinicia tu computadora y usa el recurso compartido nuevamente.

Configurar, actualizar y migrar

Exportar o importar configuraciones, buscar actualizaciones integradas y migrar espacios de trabajo de búsqueda, recursos compartidos, sincronización, LLM, reglas de contenido y datos del servidor remoto a través de la página de configuración.

Ver paquetes de descarga y lanzamiento

Los desarrolladores de la API

permiten que los agentes, scripts, lanzadores y herramientas internas de IA invoquen las capacidades de búsqueda, vista previa y descarga de FilePulse a través de una HTTP API local que requiere autenticación.

Lea la guía API para desarrolladores

Referencia de configuración de config.json

config.json controla el nombre del servicio local, el inicio de sesión, el puerto, la posición del índice, las teclas de acceso directo, el comportamiento de inicio y algunas preferencias de ejecución. La mayoría de los usuarios sólo necesitarán ajustar puertos, lista de unidades, teclas de acceso rápido, políticas de instancias múltiples u opciones de inicio cuando el entorno predeterminado no sea adecuado.

Sugerencias de modificación

Los puertos, la lista de unidades, las teclas de acceso rápido, la política de instancias múltiples y las opciones de inicio son adecuadas para el ajuste manual. La contraseña de la cuenta se modifica primero en la interfaz web. Después de modificar el puerto, la posición de escucha, la tecla de acceso directo o max_batch, se recomienda reiniciar FilePulse para permitir que la nueva configuración surta efecto de manera estable.

server_name

Nombre para mostrar del nodo local FilePulse. Cuando se utilizan flujos de trabajo de clúster o nodo remoto, se recomienda mantenerlos únicos para facilitar la identificación de resultados y fuentes de operación remota.

port_http / port_https

El puerto HTTP/HTTPS utilizado por la consola web local y el servicio API. Si está ocupado 80 o 443, modifique el puerto antes de comenzar y acceda a la dirección correspondiente.

drive_list

FilePulse monitorea e indexa ubicaciones. Windows suele ser la letra de la unidad, macOS y Linux suelen ser rutas como /Users y /home.

hot_keys

Definición de tecla de acceso directo global, que se puede asociar con la búsqueda de carpeta actual, búsqueda de contenido, iniciador rápido, panel de inicio y búsqueda contextual.

open_link_after_boot

Controla si se abre automáticamente el navegador después de iniciar el servicio local. Se puede desactivar durante el inicio en segundo plano, la implementación del servidor o cuando desee abrir la consola manualmente.

max_batch

Tamaño del lote del índice de contenido. Un valor mayor puede dar como resultado una compilación más rápida, pero requiere más memoria y CPU; Si el índice de contenido no puede asignar memoria, redúzcala.

ffmpeg_max_parallelism

Limita la cantidad de tareas FFmpeg que se pueden realizar en paralelo para la búsqueda y vista previa visual de videos. Seleccionado automáticamente cuando se deja nulo; se puede rechazar si la indexación de medios ejerce presión sobre la CPU o la memoria.

ocr_max_parallelism

Limita el número de tareas de extracción de OCR que se pueden ejecutar en paralelo. Seleccionado automáticamente cuando se deja nulo; se puede reducir cuando la CPU o la memoria del dispositivo son limitadas.

hide_console_on_startup

Controla si la ventana de la consola está oculta al iniciar FilePulse en entornos compatibles.

native_log_enabled

Controle los registros del lado nativo para facilitar la resolución de problemas relacionados con el inicio, las teclas de acceso directo o la integración del escritorio.

instance_policy.allow_multi_filepulse

Controla si se permite la ejecución simultánea de varias instancias del servicio FilePulse.

instance_policy.allow_multi_native

Controla si se permite la ejecución de varias instancias de asistente nativo de escritorio al mismo tiempo.

boot_root_autostart_enabled

Configuraciones relacionadas con el control para que se inicien automáticamente después de iniciar o iniciar sesión. Es necesario utilizar FilePulse cuando se inicia el sistema.

password / last_password_change / saved_system_password

No modifique manualmente los campos que sean confidenciales o que sean mantenidos por el sistema; Las contraseñas de las cuentas y las contraseñas del sistema deben guardarse a través de la interfaz de configuración FilePulse.

La importación/exportación de configuraciones se puede migrar junto con config.json, recursos compartidos, sincronización, LLM, reglas de contenido, servidores remotos y datos del espacio de trabajo de búsqueda. Esta sección solo describe config.json, ya que otros archivos son más adecuados para administrarse en la interfaz web.

Manejo de excepciones

Si FilePulse se apaga solo después de que la máquina se reanuda desde el modo de suspensión u otros estados, generalmente esto no es una falla del programa, pero la verificación de red de FilePulse se interrumpe después de que el terminal entra en modo de suspensión y otros estados, por lo que el programa se cierra automáticamente. Simplemente reinicie FilePulse.

Si no se puede asignar memoria al crear contenido de búsqueda, la configuración max_batch es demasiado grande. Solo necesita modificar el archivo config.json y establecer max_batch en un valor menor. Luego corre de nuevo.

Si la construcción se atasca mientras busca contenido, puede eliminar todas las entradas en las reglas en reglas.json, lo que equivale a borrar todas las reglas y luego ejecutarla nuevamente.

El resultado de la construcción está en el directorio de índice. Puede eliminar el directorio y reconstruirlo en cualquier momento. Personalmente, se recomienda no crear texto plano demasiado grande. Por ejemplo, un documento de Word pesa 500 MB, pero no habrá problema si contiene principalmente imágenes. Sin embargo, si un archivo de texto sin formato de 500 MB contiene texto sin formato, es posible que el sistema de búsqueda tarde mucho tiempo en construirse. Y un archivo de texto sin formato tan grande consume una gran cantidad de memoria durante la compilación.