> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Ajustes de indexación

> Cada interruptor de la página Ajustes → Índice explicado: qué hace, cuál es su valor por defecto, qué pasa al activarlo o desactivarlo y cómo diagnosticar problemas de indexación.

Si Linkly AI encuentra al instante los documentos de tu ordenador es porque hace en segundo plano un trabajo silencioso: **indexar**. Esta página explica cada interruptor de **Ajustes → Índice** y ofrece una ruta de diagnóstico para cuando el índice da problemas.

Si acabas de instalar la aplicación y todavía no has añadido tus documentos, empieza por [Inicio rápido](/docs/es/quickstart).

***

## Cómo funciona la indexación

La indexación de Linkly AI es **por capas**: no es un todo o nada, sino que cada capa terminada añade una forma más de buscar.

<Steps>
  <Step title="Primera capa: nombre de archivo (cuestión de segundos)">Nada más detectar un archivo, su ruta y su nombre entran en el índice. Esta capa es prácticamente instantánea, así que en cuanto añades una carpeta ya puedes buscar por nombre de archivo.</Step>
  <Step title="Segunda capa: texto completo (palabras clave)">Se extrae el texto del documento y se escribe en el índice de texto completo local, que admite coincidencia por palabras clave. Con esta capa terminada, buscar «presupuesto» encuentra los documentos donde esa palabra aparece en el cuerpo del texto.</Step>
  <Step title="Tercera capa: semántica (vectores)">Un modelo de embedding local trocea el texto y lo convierte en vectores. Con esta capa terminada, buscar «cuánto gastamos el año pasado» también encuentra un informe financiero cuyo título no contiene ninguna de esas palabras.</Step>
</Steps>

Además de estas tres capas hay dos **extractores de contenido opcionales**, encargados de convertir en texto los archivos que no lo tienen, para después pasarlos por las tres capas anteriores:

* **Reconocimiento de texto (OCR)**: reconoce el texto de las imágenes y de los PDF escaneados
* **Extracción de texto de audio y vídeo (ASR)**: convierte en texto lo que se dice en los archivos de audio y de vídeo

***

## Recorrido por la página Ajustes → Índice

Al abrir **Ajustes → Índice**, de arriba abajo hay cuatro bloques:

| Bloque                   | Contenido                                                                               |
| ------------------------ | --------------------------------------------------------------------------------------- |
| **Documentos indexados** | Una cifra grande: cuántos documentos hay ahora mismo en el índice                       |
| **Detalle de estado**    | Un conjunto de líneas de solo lectura que indican en qué punto está cada capa           |
| **Interruptores**        | 7 opciones, el grueso de la página; se explican una a una más abajo                     |
| **Mantenimiento**        | Los dos botones **Optimización del almacenamiento del índice** y **Reconstruir índice** |

### Cómo leer el detalle de estado

| Línea                              | Descripción                                                                                              |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Estado**                         | Estado global del índice, con 5 valores posibles; ver [Estados posibles](#estados-posibles)              |
| **Búsqueda por nombre de archivo** | Primera capa; cuando todo va bien muestra «Listo»                                                        |
| **Búsqueda de texto completo**     | Segunda capa; cuando todo va bien muestra «Listo»                                                        |
| **Búsqueda semántica**             | Tercera capa. Puede mostrar «Listo», «Preparando» o «En cola»; con el interruptor apagado, «Desactivada» |
| **Reconocimiento de texto (OCR)**  | «Listo» o «Preparando», o bien el archivo que está procesando; con el interruptor apagado, «Desactivado» |
| **Extraer texto de audio y vídeo** | «Listo», «Procesando», «En espera», etc.; si no se ha activado, «No activado»                            |
| **Última actualización**           | Cuándo se escribió por última vez en el índice                                                           |
| **Tamaño de datos**                | Cuánto espacio ocupa el índice en el disco                                                               |

***

## Los ajustes de indexación

### 1. Modo de rendimiento

**Qué hace**: controla cuántos recursos de cálculo puede consumir la indexación en segundo plano.

**Valor por defecto**: Auto (Recomendado)

| Opción                 | Comportamiento                                                                                                                            |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Equilibrado**        | Indexa con el mínimo de recursos posible; prácticamente no afecta a tu trabajo                                                            |
| **Rendimiento**        | La indexación usa todos los recursos del equipo que puede para analizar y calcular; puede afectar al uso del ordenador                    |
| **Auto (Recomendado)** | Pasa a rendimiento cuando el teclado y el ratón llevan más de **120 segundos** inactivos, y vuelve a equilibrado en cuanto retomas el uso |

### 2. Ahorro de energía

**Qué hace**: en un portátil alimentado por batería, pausa las tareas pesadas que más consumen.

**Valor por defecto**: desactivado

<Warning>Para que surta efecto tienen que darse las dos condiciones a la vez: **el interruptor activado** y **el equipo funcionando con batería**.</Warning>

Lo que se pausa con la batería:

* OCR de imágenes
* Conversión de PDF escaneados a Markdown estructurado
* Índice semántico (generación de vectores)
* Transcripción de audio y vídeo
* Sincronización automática de las bibliotecas en la nube
* Tareas de optimización de la base de datos

**Lo que no se ve afectado y sigue funcionando**: el índice de nombres de archivo y el índice de texto completo (palabras clave). Así que, incluso en ahorro de energía, los archivos nuevos se siguen encontrando.

**Cuándo tocarlo**: si usas portátil, actívalo y olvídate de él. En un ordenador de sobremesa da igual activarlo o no.

### 3. Suspender modelos de IA inactivos

**Qué hace**: libera la memoria de los modelos de IA locales cuando llevan un rato sin usarse, y los vuelve a cargar automáticamente cuando hacen falta.

**Valor por defecto**: activado

Los modelos locales (embedding semántico, OCR y reconocimiento de voz) se descargan de la memoria tras unos **300 segundos (5 minutos)** de inactividad.
Si lo desactivas, los modelos se quedan residentes en memoria y los tres juntos ocupan alrededor de **1 GB**.

**Cuándo tocarlo**: si vas justo de memoria (8 GB o menos), déjalo activado como viene.

### 4. Reconocimiento de texto en imágenes (OCR)

**Qué hace**: reconoce con un modelo de OCR local el texto de las imágenes, **y además convierte los PDF escaneados en Markdown estructurado**.

**Valor por defecto**: activado

### 5. Búsqueda semántica

**Qué hace**: permite encontrar documentos usando lenguaje natural y descripciones aproximadas.

**Valor por defecto**: activada

### 6 y 7. Transcripción de audio y Transcripción de vídeo

**Qué hacen**: convierten en texto, con un modelo de reconocimiento de voz local, lo que se dice en los archivos de audio y de vídeo, y ese texto pasa después al índice de texto completo y al semántico.

**Valor por defecto: las dos desactivadas** ⚠️

| Tipo      | Formatos compatibles          |
| --------- | ----------------------------- |
| **Audio** | mp3, wav, m4a, flac, aac, ogg |
| **Vídeo** | mp4, mov, mkv, webm (avi no)  |

<Warning>**Desactivado no significa sin indexar.** Los archivos de audio y vídeo se registran igualmente en el índice: **se encuentran por nombre de archivo, pero no por lo que se dice dentro**.</Warning>

**Cuándo tocarlo**: actívalas cuando tengas grabaciones de reuniones, pódcasts o vídeos de cursos que quieras poder buscar.

***

## Optimizar y reconstruir el índice

### Optimización del almacenamiento del índice

Reconstruye el índice vectorial con una compresión más avanzada. Es una **ganancia prácticamente sin contrapartidas**:

* El espacio en disco **se reduce alrededor de un 80 %** (en pruebas reales, hasta 11,6 veces menos)
* Las búsquedas van más rápido

Salir de la aplicación a mitad de proceso es seguro: no daña los datos y en el siguiente arranque continúa sola.

<Note>**Si el índice ya está en el estado óptimo, pulsar el botón no hace nada**: solo aparece el aviso «Tu índice ya está optimizado», y **tampoco se puede forzar la ejecución manualmente**.</Note>

### Reconstruir índice

**Es una operación peligrosa** y por eso el botón es rojo. Lo que hace:

* **Elimina**: la carpeta del índice de texto completo, todos los vectores y las marcas de progreso de indexación de cada documento
* **No elimina**: tus archivos originales, la caché de texto ya extraído ni los archivos de modelo ya descargados

Precisamente porque la caché de texto y los modelos se conservan, reconstruir suele ser **mucho más rápido** que la primera indexación: se ahorra la parte más lenta, el análisis y el OCR.

Durante la reconstrucción, las búsquedas **devuelven resultados vacíos** (no un error).

<Warning>
  En estos cuatro casos la operación se **rechaza** y el botón no surte efecto:

  * Todavía hay tareas de OCR o de transcripción de audio y vídeo ejecutándose en segundo plano
  * La indexación está en pausa (pausada desde el menú de la bandeja)
  * Hay un escaneo o una indexación en curso
  * Ya hay una reconstrucción en marcha
</Warning>

***

## Estados posibles

El estado tiene cinco valores en total:

| Estado         | Qué significa                                                                         |
| -------------- | ------------------------------------------------------------------------------------- |
| **Inactivo**   | Aún no ha empezado, **o la indexación está en pausa** (los dos casos comparten valor) |
| **Escaneando** | Está recorriendo las carpetas para descubrir qué archivos hay                         |
| **Indexando**  | Está analizando e indexando el contenido de los archivos                              |
| **Vigilando**  | El estado estable: todo indexado, esperando a que algún archivo cambie                |
| **Error**      | Algo ha fallado; el motivo concreto está en el [registro de la aplicación](/docs/es/faq)   |

**Vigilando** es el estado final al que quieres llegar.

### Cómo se pausa la indexación

**La opción de pausar la indexación solo existe en el menú de la bandeja del sistema**: haz **clic derecho** en el icono L de la bandeja para abrir el menú y encontrarás **⏸︎ Pausar indexación** / **▶︎ Iniciar indexación** (con el clic izquierdo se abre la ventana de chat con IA, no el menú).

***

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Por qué encuentro los archivos de audio y vídeo por nombre pero no por su contenido?">
    Porque **la transcripción de audio y la de vídeo vienen desactivadas por defecto**. Con ellas apagadas, los archivos multimedia se siguen registrando en el índice (de ahí que los encuentres por nombre), pero lo que se dice dentro no se transcribe.

    Ve a **Ajustes → Índice** y activa **Transcripción de audio** y **Transcripción de vídeo**: la aplicación descargará los 161 MB del modelo de reconocimiento de voz y después completará sola todos los archivos pendientes, sin necesidad de volver a escanear ni de reconstruir el índice.

    Excepción: si junto al archivo multimedia hay un subtítulo `.srt` o `.vtt` con el mismo nombre, o si ya se transcribió antes y la caché sigue ahí, el contenido se encuentra aunque el interruptor esté apagado.
  </Accordion>

  <Accordion title="No encuentro el texto de un PDF escaneado o de una imagen">
    Comprueba primero en **Ajustes → Índice** si el interruptor **Reconocimiento de texto en imágenes (OCR)** está apagado.

    **Atención: ese interruptor controla a la vez el OCR de imágenes y la extracción de texto de los PDF escaneados**, aunque la etiqueta hable solo de imágenes. Si lo apagas, los PDF escaneados también pasan a tener solo nombre de archivo y ningún contenido.

    Si el interruptor está encendido, mira en el detalle de estado la línea **Reconocimiento de texto (OCR)**: si pone «Preparando», el modelo todavía se está descargando o cargando, así que basta con esperar un poco.
  </Accordion>

  <Accordion title="El estado se queda en Inactivo y el progreso no avanza">
    La causa más habitual es que **la indexación esté en pausa**. Esa opción está únicamente en el **menú de la bandeja del sistema**: haz **clic derecho** en el icono de la bandeja para desplegarlo y, si ves **▶︎ Iniciar indexación**, es que está pausada; púlsalo para reanudarla.

    Cómo confirmarlo: si la página de ajustes muestra «Inactivo» y justo debajo aparece en letra pequeña `Indexing paused`, está pausada. Ese mensaje lo emite el motor de indexación y aparece en inglés en todos los idiomas.

    Si no es eso, comprueba en **Ajustes → Carpetas** que hayas añadido tus propias carpetas: el asistente de primer inicio solo indexa los documentos de ejemplo que vienen con la aplicación.
  </Accordion>

  <Accordion title="La búsqueda semántica no parece funcionar y los resultados salen demasiado literales">
    Revisa en este orden:

    1. ¿La línea **Búsqueda semántica** del detalle de estado en **Ajustes → Índice** muestra «Desactivada»? Entonces el interruptor está apagado; actívalo y listo (se pondrá al día sola, sin reconstruir nada).
    2. ¿Muestra «Preparando» o «En cola»? Todavía está generando vectores; espera a que termine.
    3. Si no es ninguna de las dos, ve a **Ajustes → IA → Modelo de embedding** y mira si el modelo sigue descargándose o si la descarga ha fallado. **En este caso la interfaz de búsqueda no avisa de nada**: la búsqueda degrada en silencio a palabras clave puras. Si ha fallado, pulsa **Reintentar** en la tarjeta.
  </Accordion>

  <Accordion title="¿Cómo pauso la indexación? No lo encuentro en los ajustes">
    Pausar la indexación **está solo en el menú de la bandeja del sistema**; la página de ajustes no lo ofrece. Haz **clic derecho** en el icono L de la bandeja → **⏸︎ Pausar indexación**. Se reanuda en el mismo sitio: la entrada del menú pasa a ser **▶︎ Iniciar indexación**.

    Mientras está en pausa no se puede ejecutar **Reconstruir índice**: hay que reanudarla antes.
  </Accordion>

  <Accordion title="El índice ocupa demasiado espacio en disco, ¿qué hago?">
    Ve a **Ajustes → Índice → Mantenimiento** y pulsa **Optimización del almacenamiento del índice**. Reconstruye el índice vectorial con una compresión más avanzada y **reduce el espacio en disco alrededor de un 80 %**, a cambio de en torno a un 1 % de pérdida de exhaustividad; además, la búsqueda se vuelve más rápida.

    Si el botón responde «Tu índice ya está optimizado», es que tu índice ya usa el formato nuevo: no hay margen de optimización y tampoco se puede forzar una nueva pasada.
  </Accordion>

  <Accordion title="Los resultados de búsqueda salen raros, ¿debería reconstruir el índice?">
    No corras. Reconstruir es el último recurso y durante el proceso las búsquedas devuelven resultados vacíos. Prueba en este orden:

    1. Comprueba que el interruptor correspondiente no esté apagado (OCR, búsqueda semántica, transcripción de audio y vídeo)
    2. Comprueba que la indexación no esté en pausa (menú de la bandeja)
    3. Comprueba que el estado haya llegado a **Vigilando** y no siga en **Indexando**

    Solo cuando hayas descartado todo lo anterior, plantéate **Ajustes → Índice → Mantenimiento → Reconstruir**. La reconstrucción no borra tus archivos originales, ni la caché de texto ya extraído, ni los archivos de modelo, así que suele ser mucho más rápida que la primera indexación.
  </Accordion>

  <Accordion title="¿Puedo detener la indexación cambiando el modo de rendimiento?">
    No. El modo de rendimiento **solo controla cuántos hilos usa la indexación y con qué frecuencia cede el paso**, no si debe ejecutarse o no. Elegir **Equilibrado** únicamente hace que vaya más despacio y moleste menos.

    Para detenerla de verdad, usa **Pausar indexación** en el menú de la bandeja.

    Además, el modo **Auto** solo se fija en **si el teclado y el ratón están inactivos** (más de 120 segundos cuenta como inactivo): no mira la batería ni la carga de la CPU. En un escritorio Linux con Wayland puro esa señal no está disponible, así que **Auto** equivale siempre a **Equilibrado**.
  </Accordion>

  <Accordion title="He activado el ahorro de energía pero no noto ninguna diferencia">
    Es lo normal. El ahorro de energía solo surte efecto si se cumplen las dos condiciones: **el interruptor activado** y **el equipo funcionando con batería**. Con el cargador enchufado, o en un sobremesa sin batería, no hace absolutamente nada.

    Justamente por eso **puedes dejarlo activado todo el año**, sin tener que encenderlo antes de salir de casa y apagarlo al volver.
  </Accordion>

  <Accordion title="El ordenador se arrastra mientras se indexa, ¿qué puedo hacer?">
    De menor a mayor impacto:

    1. Cambia el modo de rendimiento a **Equilibrado** (surte efecto de inmediato: las tareas en curso vuelven a repartirse según el nuevo presupuesto)
    2. Desactiva temporalmente **Transcripción de audio** y **Transcripción de vídeo**: la transcripción multimedia es la tarea más pesada y además compite con el OCR por la misma ranura global
    3. Si sigue yendo lento, usa **Pausar indexación** en el menú de la bandeja y reanúdala cuando el equipo esté libre
  </Accordion>
</AccordionGroup>

***

## Lecturas adicionales

* [Inicio rápido](/docs/es/quickstart) — instalar, añadir documentos y conectar tus herramientas de IA
* [Buscar con el lanzador](/docs/es/use-launcher) — el uso completo de la interfaz de búsqueda
* [Usar bibliotecas](/docs/es/use-libraries) — acotar el alcance de la búsqueda por biblioteca
* [Preguntas frecuentes](/docs/es/faq) — cuánto tarda la indexación y cómo obtener el registro de la aplicación
* [Chatear con la IA](/docs/es/use-chatbot) — el estado del índice también se ve al final de la barra lateral
* [Espacio de Linkly AI](/docs/es/linkly-space) — la carpeta que se indexa por defecto