# Tus archivos y datos

Descubre qué viaja con un proyecto y cómo hacer copias de seguridad del código, el historial y los datos de la app.

Tu manuscrito es una carpeta de archivos de código normales. Puedes abrir esos archivos con otro editor, hacer copias de seguridad o sacarlos de Oleafly.

## Archivos del proyecto

Los proyectos de la biblioteca normalmente viven en `~/.oleafly/projects/`. Un proyecto puede contener un documento principal en LaTeX, Typst o Markdown, una bibliografía, figuras y material de investigación.

`project.json` registra la identidad y los ajustes del proyecto, incluidos su documento principal, su motor y la versión de Typst fijada. Un directorio `.git` guarda el historial de Git. Un proyecto que crea o importa Oleafly normalmente empieza con una confirmación de sus archivos, llamada «Create project» (consulta [Git y control de versiones](/docs/git-history/#the-first-commit)). El directorio `.oleafly/build/` contiene la salida de compilación generada y se puede recrear compilando.

Un proyecto de Typst puede guardar copias de los paquetes que importa en una carpeta `typst-packages`, para que compile sin conexión y en otros ordenadores. Typst también usa las tipografías de la carpeta `fonts` de un proyecto. Las dos carpetas viajan con el proyecto.

Una carpeta que [abres en su sitio](/docs/library/#folders-opened-in-place) se queda donde está. Oleafly guarda las compilaciones, los ajustes, los puntos de control y los chats de esa carpeta en su propia carpeta de datos, de modo que no se añade nada a la tuya.

## Datos guardados fuera del proyecto

Las preferencias de la app, las credenciales cifradas de los proveedores, los registros de chats y de uso, las herramientas descargadas (como versiones adicionales de Typst) y los puntos de control guardados pertenecen al almacenamiento local de la app. También las copias de un proyecto que Oleafly guarda antes de cada turno de un asistente o un agente, que te permiten deshacer los archivos que cambió ese turno. La copia de tu biblioteca de Zotero que lee la búsqueda con `@` también está ahí, no en el proyecto. Copiar la carpeta de un manuscrito no copia todos esos datos de la app.

Las [carpetas enlazadas](/docs/linked-folders/) siguen en su ubicación original. Un archivo comprimido con el código no incluye su contenido solo porque las hayas enlazado.

## Dónde viven las notas

Las [notas](/docs/notes/) son archivos Markdown en tu ordenador. Cada nota personal es una carpeta dentro de la carpeta de proyectos, junto a los proyectos de tu biblioteca. Una nota de proyecto es un archivo `.md` en la carpeta `notes` del proyecto, así que viaja con el proyecto. Consulta [Dónde se guardan las notas](/docs/notes/#where-notes-are-stored) para ver la carpeta en Windows, macOS y Linux y qué contiene la carpeta de una nota.

## Dónde vive TinyTeX

Cuando instalas TinyTeX desde **Ajustes → Motores → LaTeX**, Oleafly lo pone en `~/.oleafly/tinytex`. Windows es la excepción cuando el nombre de tu carpeta de usuario tiene letras con acento o no latinas, como un nombre coreano o chino, porque TeX Live no puede ejecutarse desde una carpeta así. Entonces TinyTeX va a una carpeta llamada `Oleafly-` más un código corto dentro de ProgramData, que suele ser `C:\ProgramData`. No hace falta acceso de administrador. Si Oleafly tampoco puede preparar esa carpeta, lo dice. Puedes seguir compilando con Tectonic, o instalar TeX Live tú mismo en `C:\texlive`.

La fila de TinyTeX en **Gestionar las distribuciones de TeX** muestra la carpeta; pasa el cursor sobre la ruta borrosa para leerla. Quita TinyTeX desde esa fila en lugar de borrar la carpeta a mano.

## Haz copias de seguridad de tu trabajo

| Lo que quieres conservar | Cómo conservarlo |
| --- | --- |
| El código del manuscrito y los recursos del proyecto | Copia la carpeta del proyecto o exporta un ZIP del código |
| Las confirmaciones de Git | Haz una copia del repositorio o súbelas al remoto que hayas configurado |
| Los puntos de control guardados | Exporta un archivo de historial cifrado desde Control de versiones |
| Las preferencias de la app y los registros locales | Incluye el directorio de datos de Oleafly en la copia de seguridad habitual de tu ordenador |
| Los datos y las referencias enlazados | Haz una copia de seguridad de sus carpetas originales |
| Los proyectos de la biblioteca y los ajustes, fuera de este ordenador | Activa la [sincronización en la nube](/docs/cloud-sync/) para guardar una copia en tu Dropbox |

Un ZIP del código excluye las cachés de compilación y Git. Usa la [sincronización con GitHub](/docs/github-sync/) para un repositorio remoto y los [archivos de puntos de control](/docs/checkpoints/) para el historial de puntos de control.

## Pasa a otro ordenador

Instala Oleafly y copia o clona el proyecto del manuscrito. Vuelve a conectar las carpetas enlazadas y los proveedores de modelos en esa máquina. El proyecto lleva consigo su elección de compilador y sus metadatos; puede que haga falta instalar herramientas o paquetes adicionales. Un proyecto de Typst que fija una versión que este ordenador no tiene ofrece descargarla antes de compilar.

## Rutas en pantalla

Las rutas dentro de tu carpeta personal aparecen como `~/…` en Ajustes, el historial de versiones, los detalles de motores y agentes, y el chat. En Ajustes, las rutas de archivos y carpetas además se mantienen difuminadas hasta que pasas el cursor por encima o llegas a ellas con Tab, para que una captura de pantalla no muestre dónde están tus archivos.

## Acceso a la red

Escribir y corregir en local ocurre en tu máquina. La IA alojada recibe el contexto que se entrega al proveedor seleccionado. Las herramientas que leen imágenes y PDF escaneados usan un modelo local de Ollama, salvo que elijas para ellas un modelo alojado o Mathpix, y entonces el archivo va a ese servicio. Las citas de Zotero hablan con la app de Zotero de tu ordenador, o con zotero.org cuando conectas una cuenta. La búsqueda de citas, la importación de Zotero, las herramientas de alphaXiv, la sincronización con GitHub, las descargas de paquetes y versiones de Typst, otras descargas y las comprobaciones de actualizaciones contactan con sus respectivos servicios. La [colaboración en tiempo real](/docs/collaboration/) envía cada proyecto compartido al servidor de colaboración en el que se comparte. La [sincronización en la nube](/docs/cloud-sync/) envía los proyectos de tu biblioteca y tus ajustes a tu propio Dropbox. Abrir Ajustes → Ayuda y Acerca de obtiene cifras públicas: el número de estrellas y de bifurcaciones del proyecto en GitHub y cuántos miembros están conectados en la comunidad de Discord. Las peticiones no llevan información de cuenta, de proyecto ni de uso, y el modo sin conexión omite la de Discord. Tectonic y Typst admiten ambos la compilación en caché mediante el modo sin conexión.

[Lee los principios del producto →](/docs/philosophy/)
