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

# Espacio de Linkly AI

> La carpeta predeterminada que la aplicación crea e indexa sola: dónde está en el disco, qué contiene, cómo cambiarla de sitio y las trampas más habituales.

## Qué es el Espacio de Linkly AI

El **Espacio de Linkly AI** es una carpeta corriente que la aplicación crea automáticamente en tu ordenador. Así la describe la propia aplicación:

> Una carpeta predeterminada que se crea e indexa automáticamente, para tus documentos, notas, recortes, etc.

Su papel es sencillo: **cuando la aplicación necesita escribir algo en el disco, lo escribe aquí por defecto**. Las [notas](/docs/es/use-notes) que tomas dentro de la aplicación, las páginas web que guardas con la [extensión del navegador](/docs/es/use-extension) y los documentos de ejemplo que vienen con el instalador acaban todos en esta carpeta.

Es un directorio normal y corriente, sin ningún formato propietario: se abre con el Finder o el Explorador, puedes modificar sus archivos con cualquier editor, pasarles un `grep` o copiarlo entero a otro sitio.

<Note>
  Verás tres formas distintas de nombrarlo en tres sitios distintos; se refieren a lo mismo y **no se contradicen**:

  * En la interfaz se llama **Espacio de Linkly AI** (al final de la página Ajustes → General)
  * En el disco, la carpeta se llama `LinklyAI` (sin espacios)
  * La carpeta de documentos de ejemplo que hay dentro se llama `Linkly_AI_Examples`
</Note>

***

## Dónde está en el disco

Por defecto, en **tu carpeta personal de usuario**:

| Sistema     | Ruta predeterminada           |
| ----------- | ----------------------------- |
| **macOS**   | `/Users/<usuario>/LinklyAI`   |
| **Windows** | `C:\Users\<usuario>\LinklyAI` |
| **Linux**   | `/home/<usuario>/LinklyAI`    |

<Warning>**Es la carpeta personal del usuario, no la carpeta Documentos.** Mucha gente la busca por costumbre en Documentos y no la encuentra. En macOS, pulsa **⌘⇧H** en el Finder para ir directamente a la carpeta personal.</Warning>

<Note>En Windows, la ruta que se muestra en **Ajustes → General** aparece con **barras normales**, por ejemplo `C:/Users/xxx/LinklyAI`: la aplicación normaliza las rutas internamente, es lo esperado y se trata de la misma carpeta que el Explorador muestra como `C:\Users\xxx\LinklyAI`.</Note>

Para abrirla rápido: **Ajustes → General → Espacio de Linkly AI → Abrir**, y se abre directamente en el gestor de archivos del sistema. En el escritorio suele haber además un [acceso directo](#acceso-directo-en-el-escritorio).

***

## Qué contiene

```
~/LinklyAI/
├── Clips/                      Páginas web guardadas con la extensión del navegador
│   └── <título del recorte>/   Una carpeta por recorte, con el .md del texto y las imágenes
├── Notes/                      Notas en tarjetas
│   └── YYYY-MM/                Una carpeta por mes, calculada en UTC
│       └── <10 primeros caracteres>-<id de 8 dígitos>.md
└── Linkly_AI_Examples/         Documentos de ejemplo incluidos en el instalador
    ├── A-Life-in-10-Years/
    ├── Detectives-Library/
    ├── Federalist-Papers/
    ├── Mission-Logs/
    └── WPA-Slave-Narratives/
```

### `Notes/`: las notas

Cada nota en tarjeta que escribes dentro de la aplicación es un archivo `.md` de esta carpeta, repartido en subcarpetas por **mes UTC**. La regla de nombres, los campos de la cabecera YAML y lo que conviene tener en cuenta al abrirlas con un editor externo están en [Usar las notas](/docs/es/use-notes).

### `Clips/`: recortes web

Aquí aterrizan las páginas guardadas con la [extensión del navegador](/docs/es/use-extension), **cada recorte en su propia carpeta**, con el texto en Markdown y las imágenes de la página.

### `Linkly_AI_Examples/`: documentos de ejemplo

Una colección de textos de dominio público que acompaña al instalador: **159 archivos, unos 11,9 MB una vez descomprimidos**, todos en Markdown. Se descomprimen e indexan en la pantalla de preparación del asistente de primer inicio, y sirven para que puedas buscar algo desde el primer momento y probar la recuperación y el Chatbot.

<Tip>Cuando ya te hayas hecho a la aplicación, puedes borrar entera la carpeta `Linkly_AI_Examples/` sin que ninguna función se resienta: sus entradas desaparecerán del índice automáticamente.</Tip>

<Note>Las carpetas `Clips/` y `Notes/` **se comprueban y se recrean en cada arranque**: si las borras a mano, volverán a aparecer la próxima vez que abras la aplicación (pero su contenido no vuelve). `Linkly_AI_Examples/` **solo se descomprime una vez, durante el primer asistente**: si la borras, no se vuelve a crear.</Note>

***

## Cómo se indexa

Que el contenido de esta carpeta se pueda buscar no se debe a ningún trato especial, sino a esto:

**El asistente de primer inicio la añade automáticamente a las carpetas vigiladas.**

Es decir, en la página **Ajustes → Carpetas** aparece como **una carpeta vigilada más**, exactamente al mismo nivel que las de Documentos o Proyectos que añadas tú después. La lógica de indexación por capas y los interruptores que la afectan son los mismos que para cualquier otra carpeta; los tienes en [Ajustes de indexación](/docs/es/indexing).

<Note>Los usuarios que actualizan desde una versión anterior también vuelven a pasar por el asistente, así que esto vale igualmente para ellos: no hay que temer que la carpeta se caiga de la lista de vigiladas al actualizar.</Note>

<Warning>
  **En la página Ajustes → Carpetas puedes eliminarla, pero piénsatelo dos veces.**

  Si la eliminas deja de indexarse, pero **la aplicación sigue escribiendo dentro las notas y los recortes**. El resultado es que tus notas y las páginas que guardes existen en el disco pero **no aparecen en ninguna búsqueda ni las encuentra la IA**, y la interfaz no da ninguna pista de por qué.

  Si la has eliminado sin querer, vuelve a **Ajustes → Carpetas** y añádela de nuevo: los archivos existentes se reindexarán.
</Warning>

***

## Cambiar la carpeta del espacio

Si te falta sitio en la carpeta personal o quieres llevarlo a otro disco, al final de la página **Ajustes → General** el bloque **Espacio de Linkly AI** tiene tres botones: **Abrir**, **Cambiar…** y **Restaurar predeterminada**.

<Warning>
  **Esto no es una migración.** La aplicación no mueve ninguno de tus archivos.

  El cuadro de confirmación lo dice sin rodeos:

  > Los archivos existentes no se moverán: permanecen donde están y siguen indexados. Esta acción solo cambia dónde se guardan los archivos nuevos de ahora en adelante.

  Y el aviso posterior insiste en lo mismo:

  > Ubicación de la carpeta actualizada. Los archivos existentes permanecen en la ubicación anterior y no se mueven automáticamente.

  En segundo plano solo hace dos cosas: **crear una carpeta vacía en la nueva ubicación** y **apuntar la configuración hacia ella**. No copia, no mueve ni borra ningún archivo existente, no hace falta reiniciar y tarda menos de un segundo.
</Warning>

<Steps>
  <Step title="Abre Ajustes → General y baja hasta el final">
    Busca el bloque **Espacio de Linkly AI**: la ruta actual se muestra ahí mismo.
  </Step>

  <Step title="Pulsa Cambiar… y elige una carpeta contenedora">
    <Warning>
      **En el selector eliges la carpeta contenedora, no la carpeta del espacio en sí.** Si eliges
      `~/Documents`, obtienes `~/Documents/LinklyAI`; si eliges la raíz de un disco externo, obtienes `/Volumes/XXX/LinklyAI`.

      La única excepción: si eliges directamente una carpeta que ya se llama `LinklyAI`, la aplicación la usa tal cual, sin anidar otra dentro y quedarse con `LinklyAI/LinklyAI`.
    </Warning>
  </Step>

  <Step title="Confirma">Lee la frase del cuadro de confirmación y pulsa **Continuar**. La carpeta nueva se crea al instante y la configuración surte efecto de inmediato.</Step>

  <Step title="Mueve tú los archivos antiguos (si lo necesitas)">La aplicación no los mueve por ti. Si quieres que las notas y los recortes antiguos vivan también en la nueva ubicación, tendrás que **copiar** `Notes/`, `Clips/` y demás contenido desde tu gestor de archivos.</Step>

  <Step title="Decide si dejas de indexar la ubicación anterior">
    Lee el aviso que viene justo debajo.
  </Step>
</Steps>

<Warning>
  **La ruta antigua sigue en la lista de carpetas vigiladas y se sigue indexando.**

  Lo que casi todo el mundo espera es que a partir del cambio solo se indexe la ubicación nueva; lo que ocurre en realidad es que **se indexan las dos**, y ni un solo documento de la ubicación anterior desaparece de los resultados de búsqueda.

  Eso es una ventaja si lo único que querías era cambiar de sitio para lo nuevo (no pierdes el material antiguo), pero si tu intención era **mudar la carpeta del todo**, tendrás que ir a **Ajustes → Carpetas** y eliminar la ruta anterior tú mismo.
</Warning>

<Note>Efecto colateral: el [acceso directo](#acceso-directo-en-el-escritorio) del escritorio pasa a apuntar a la nueva ubicación. El botón **Restaurar predeterminada** se comporta exactamente igual que **Cambiar…**, solo que con destino fijo a la carpeta `LinklyAI` dentro de la carpeta personal del usuario, y tampoco mueve datos.</Note>

<Tip>La función de cambiar de ubicación existe a partir de la **v0.8.0**. Si usas una versión anterior, actualiza antes de intentarlo.</Tip>

***

## Acceso directo en el escritorio

Al terminar el asistente de primer inicio, la aplicación crea en el **escritorio del sistema** un acceso directo llamado `LinklyAI` que **apunta a la carpeta del Espacio de Linkly AI** (no a la aplicación: al abrirlo entras en la carpeta, no en el programa).

| Sistema     | Formato                    |
| ----------- | -------------------------- |
| **macOS**   | Enlace simbólico (symlink) |
| **Windows** | Acceso directo `.lnk`      |
| **Linux**   | Archivo `.desktop`         |

<Note>
  **La interfaz no tiene ningún interruptor para desactivarlo.** La única forma de quitarlo que está en tus manos es **borrar directamente ese acceso directo del escritorio**: una vez borrado, no se vuelve a crear solo.

  La única excepción es [cambiar la carpeta del espacio](#cambiar-la-carpeta-del-espacio): esa operación recrea sin condiciones un acceso directo que apunta a la nueva ubicación.
</Note>

<Tip>Si en tu escritorio ya había un archivo o una carpeta llamados `LinklyAI` que no ha creado la aplicación, esta **nunca los sobrescribe**.</Tip>

***

## No confundir con la carpeta de datos

Es la pareja de conceptos que más se confunde. El **Espacio de Linkly AI** guarda **tu contenido**; la **carpeta de datos** guarda **los datos internos de la aplicación**:

|                               | Espacio de Linkly AI                     | Carpeta de datos                                                 |
| ----------------------------- | ---------------------------------------- | ---------------------------------------------------------------- |
| **Qué guarda**                | Tu contenido: notas, recortes, ejemplos  | Índice, base de datos, registros, modelos descargados            |
| **Dónde se consulta**         | Ajustes → General → Espacio de Linkly AI | Ajustes → Acerca de → Carpeta de datos                           |
| **Se puede cambiar**          | Sí                                       | La interfaz avisa expresamente de no modificarla salvo necesidad |
| **Se puede poner en la nube** | Se puede, pero sin garantías             | **Nunca**                                                        |
| **Si la borras**              | Pierdes contenido (notas, recortes)      | Pierdes índice y configuración, y hay que reindexar              |

### Dónde está el registro de la aplicación

El archivo de registro es `logs/app.log` y está dentro de la **carpeta de datos**.

<Warning>
  **La página Ajustes → Acerca de no tiene ningún botón para abrir el registro**: hay que pulsar primero **Abrir**, junto a **Carpeta de datos**, y entrar después en la subcarpeta `logs/`.

  Además, `app.log` **rota cada 2 MB** y, al superar ese tamaño, solo conserva la segunda mitad. Por eso, cuando quieras reportarnos un problema, el orden correcto es **guardar primero una copia del registro actual y reproducir el problema después**: al revés, es muy probable que las pistas iniciales ya se hayan perdido en la rotación.
</Warning>

***

## Qué pasa si la borras o la mueves a mano

<Warning>**No borres ni muevas esta carpeta directamente desde el gestor de archivos.** Aquí tienes las consecuencias reales de cada caso.</Warning>

| Lo que haces                                      | Qué ocurre                                                                                                                                                                                |
| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Borras la carpeta sin reiniciar la aplicación** | El índice no se cae de inmediato; la página **Ajustes → Carpetas** mostrará **Carpeta no encontrada**                                                                                     |
| **Borras la carpeta y reinicias la aplicación**   | La aplicación recrea un `~/LinklyAI` **vacío**, el escaneo lo encuentra vacío y los documentos anteriores se eliminan del índice unos **60 segundos** después                             |
| **Mueves la carpeta a mano a otro sitio**         | La configuración sigue apuntando a la ruta antigua, que se recrea vacía al reiniciar; **la nueva ubicación no se indexa en absoluto salvo que la añadas a mano a las carpetas vigiladas** |
| **Borras solo `Linkly_AI_Examples`**              | Sin riesgo. Los ejemplos solo se descomprimen una vez, en el primer asistente; no se recrean y no afectan a ninguna función                                                               |

**La forma correcta de cambiar de ubicación**:

<Steps>
  <Step title="Usa primero Cambiar… desde los ajustes">En **Ajustes → General → Espacio de Linkly AI**, pulsa **Cambiar…** y elige la nueva carpeta contenedora.</Step>
  <Step title="Después copia tú los archivos antiguos">Desde el gestor de archivos, **copia** el contenido de la carpeta antigua a la nueva. Mejor copiar que cortar: borra la antigua solo cuando hayas comprobado que todo está bien.</Step>
  <Step title="Por último, decide qué hacer con la ruta antigua">Si quieres que la ubicación anterior siga siendo consultable, no hagas nada; si ya no la quieres, ve a **Ajustes → Carpetas** y elimina esa ruta.</Step>
</Steps>

***

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Puedo poner el Espacio de Linkly AI en iCloud, Dropbox o OneDrive?">
    **Puedes, pero sin garantías oficiales.** La aplicación **no detecta de ninguna manera si la carpeta está en un servicio de sincronización, ni te avisa ni te advierte de nada**: si la pones ahí, ahí se queda, y si algo va mal no aparecerá ningún mensaje.

    El lado de la indexación sí incluye algunas protecciones genéricas frente a los discos en la nube, que alivian parte del problema:

    * **Se omiten los archivos marcadores de la nube que aún no se han descargado** (en los resultados de búsqueda aparecen como «No indexado · marcador de la nube»; al descargarlos en local se reindexan solos)
    * **Ante las eliminaciones momentáneas causadas por el vaivén de la sincronización, hay una ventana de estabilidad de 60 segundos**, para no borrar un documento del índice a la primera sacudida
    * **Se ignoran las carpetas de metadatos de sincronización** como `#recycle` o `@eaDir`

    Aun así, la descarga bajo demanda, las copias en conflicto y las reescrituras frecuentes de los servicios en la nube pueden hacer que el índice cambie una y otra vez. Si lo único que quieres es compartir documentos entre varios dispositivos, suele ser más prudente **añadir la carpeta del servicio en la nube como una carpeta vigilada más** (Ajustes → Carpetas) que mudar el espacio entero a la nube.
  </Accordion>

  <Accordion title="Después de cambiar la ubicación, ¿se mueven los archivos antiguos?">
    **No.** Solo hace dos cosas: crear la carpeta en la nueva ubicación y apuntar la configuración hacia ella. Ni un solo archivo existente se toca: siguen donde estaban y se siguen indexando.

    La frase del cuadro de confirmación que dice que los archivos existentes no se moverán no es un descargo de responsabilidad, sino una descripción exacta del comportamiento. Si quieres que los archivos antiguos también viajen, tendrás que copiarlos tú desde el gestor de archivos.

    Y precisamente porque no mueve datos, no existe el escenario de una migración que falla o se interrumpe a medias: la operación se completa en menos de un segundo.
  </Accordion>

  <Accordion title="Tras cambiar la ubicación, ¿se siguen encontrando los documentos de la carpeta anterior?">
    **Sí.** La ruta antigua sigue en la lista de carpetas vigiladas y se sigue indexando: el contenido de ambas ubicaciones entra en el alcance de la búsqueda.

    Normalmente esto es bueno (el material antiguo no desaparece de golpe), pero si tu intención era mudarte por completo, ve a **Ajustes → Carpetas** y elimina tú la ruta anterior.
  </Accordion>

  <Accordion title="La he eliminado en Ajustes → Carpetas, ¿qué pasa ahora?">
    Deja de indexarse, pero **las notas y los recortes se siguen escribiendo dentro**: lo que se guarde ahí no se podrá buscar, y la interfaz no avisará de nada.

    Es la trampa más habitual. Para recuperarlo, vuelve a **Ajustes → Carpetas** y añade otra vez la carpeta: los archivos existentes se reindexarán.
  </Accordion>

  <Accordion title="¿Se pueden borrar los documentos de ejemplo?">
    Sí. `Linkly_AI_Examples/`
    son textos de dominio público en Markdown puro; borrarlos no afecta a ninguna función y sus entradas se limpian solas del índice.

    Ten en cuenta que **solo se descomprimen una vez, en el primer asistente**, así que una vez borrados no se recrean: si les tienes cariño, haz una copia antes.
  </Accordion>

  <Accordion title="¿Cómo quito el acceso directo LinklyAI del escritorio?">
    **Basta con borrarlo**; después no se vuelve a crear solo. La interfaz no tiene ningún interruptor para eso.

    Lo único que hará que reaparezca es [cambiar la carpeta del espacio](#cambiar-la-carpeta-del-espacio): ese paso recrea sin condiciones un acceso directo hacia la nueva ubicación.
  </Accordion>

  <Accordion title="He borrado ~/LinklyAI sin querer, ¿qué hago?">
    Hay dos situaciones:

    * **Todavía no has reiniciado la aplicación**: los archivos ya se han perdido (las notas y los recortes estaban ahí dentro), pero el índice sigue intacto. Si usas Time Machine o el Historial de archivos, recupera cuanto antes la carpeta desde la copia de seguridad y reinicia después la aplicación.
    * **Ya la has reiniciado**: la aplicación ha recreado una carpeta vacía, el escaneo la ha encontrado vacía y los documentos anteriores se han eliminado del índice unos 60 segundos después. En este punto solo queda tirar de la copia de seguridad del sistema.

    La aplicación **no tiene papelera ni mecanismo propio de copias de seguridad**. En esa carpeta viven tus archivos de verdad, así que trátala como tratarías cualquier otra carpeta importante.
  </Accordion>

  <Accordion title="¿Dónde está el archivo de registro?">
    En `logs/app.log`, dentro de la **carpeta de datos**, no dentro del Espacio de Linkly AI.

    Ruta: **Ajustes → Acerca de → Carpeta de datos → Abrir**, y después entra en la subcarpeta `logs/`. La página Acerca de **no** tiene un botón que abra el registro directamente.

    `app.log` rota cada 2 MB y al superarlo solo conserva la segunda mitad, así que para reportar un problema **guarda primero el registro y reproduce después**.
  </Accordion>
</AccordionGroup>

***

## Lecturas adicionales

* [Inicio rápido](/docs/es/quickstart) — instalar, completar el asistente y añadir tus propios documentos
* [Ajustes de indexación](/docs/es/indexing) — cómo se indexa exactamente el contenido de esta carpeta
* [Usar las notas](/docs/es/use-notes) — la regla de nombres y el formato YAML de `Notes/`
* [Usar bibliotecas](/docs/es/use-libraries) — incluir esta carpeta (o alguna de sus subcarpetas) en una biblioteca
* [Preguntas frecuentes](/docs/es/faq) — otras rutas de diagnóstico
* [Chatear con la IA](/docs/es/use-chatbot) — mencionar con `@` el contenido de esta carpeta en una conversación
* [Usar la extensión del navegador](/docs/es/use-extension) — de dónde sale el contenido de `Clips/`
