> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/shade-academy/shade-academy-es/shadefs/pinning-files-offline.md).

# Fijar archivos sin conexión

## Cómo funciona el anclaje

Los archivos anclados se almacenan en tu directorio de caché junto con otros archivos almacenados en caché, pero no están sujetos a límites de tamaño de caché ni a reglas de expulsión. Cuando anclas contenido, ShadeFS crea una copia local completa que persiste hasta que la desanclas explícitamente. **Esto significa que puedes anclar tanto contenido como pueda alojar tu almacenamiento local, sin importar el tamaño de caché configurado.**

{% embed url="<https://youtu.be/apDcYPUC7tw?si=LB3hSQr8zL2Ow_Md>" %}

<figure><img src="https://450378260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2F68km9NfoiJhtY8v2Z75F%2FPin%20files%20to%20Cache.gif?alt=media&#x26;token=61a05333-4ac7-4f98-a852-171bb391e929" alt=""><figcaption></figcaption></figure>

## Trabajar sin conexión

Los archivos anclados siguen siendo totalmente accesibles incluso sin conexión. Cualquier cambio que hagas en archivos anclados mientras estás sin conexión se marca como "sucio" en el sistema, lo que indica que deben sincronizarse con la nube. Estos archivos están protegidos de la expulsión de la caché hasta que puedan sincronizarse correctamente, para garantizar que no se pierda ningún trabajo cuando vuelvas a conectarte.

Al volver a conectarte o reiniciar ShadeFS, el sistema identifica automáticamente cualquier archivo cambiado y lo sincroniza con la nube de Shade.

## Cambios en conflicto

Si otra persona cambió el mismo archivo mientras estabas sin conexión, ShadeFS conserva ambas versiones. Su versión conserva el nombre original, y tu versión se guarda junto a ella con `-conflicto-` y un número añadido al final del nombre, por ejemplo `edit.prproj-conflicto-2847193021`. Nada se sobrescribe, así que puedes comparar las dos y quedarte con la que quieras.

Lo mismo ocurre si tú y otra persona crean un archivo con el mismo nombre.

## Jerarquía de anclaje

ShadeFS gestiona el anclaje con un sistema jerárquico. Al trabajar con carpetas anidadas:

* Anclar una carpeta principal incluye automáticamente todo su contenido
* Si tanto una carpeta externa como una interna están ancladas, desanclar la carpeta interna no tendrá ningún efecto, ya que el estado de anclaje de la carpeta externa tiene prioridad
* Puedes anclar selectivamente archivos o carpetas específicos dentro de una carpeta principal no anclada

## Uso flexible

Una ventaja clave del anclaje de ShadeFS es su flexibilidad:

* Puedes anclar archivos sin montar primero la unidad
* No hay límite en la cantidad de contenido que puedes anclar (más allá de tu almacenamiento disponible)
* El estado de anclado persiste tras reinicios del sistema y reconexiones
* Puedes seguir trabajando con archivos anclados incluso cuando estés sin conexión
* Puedes seguir trabajando mientras los archivos se anclan. Los archivos que abres a través de la unidad montada siempre se descargan antes que los archivos anclados, así que el anclaje se ralentiza mientras estás reproduciendo contenido multimedia de forma activa, en lugar de ralentizar tu reproducción.

## Administrar contenido anclado

{% hint style="info" %}
Los archivos anclados guardarán todos los archivos que ancles completamente sin conexión, evitando los límites de caché que hayas configurado, que se usan para el almacenamiento efímero y estándar. Esto significa que es posible que ancles **más de lo que te queda disponible en tu unidad de caché, dependiendo de lo que estés intentando anclar.**
{% endhint %}

Para anclar archivos o carpetas:

1. Abre la aplicación Shade
2. Navega hasta el contenido deseado
3. Haz clic con el botón derecho y selecciona "Anclar a la caché"

Para desanclar contenido:

1. Haz clic con el botón derecho en el elemento anclado
2. Selecciona "Desanclar de la caché"

Desanclar un archivo también elimina su copia local. También puedes desanclar archivos desde **Configuración > ShadeFS > Gestión de caché**.

Para ver todos los archivos o carpetas anclados, puedes navegar a la página de **Elementos anclados** a la que puedes acceder a nivel de unidad o de espacio de trabajo.

### Anclado desde Finder (macOS)

En macOS, también puedes anclar y desanclar directamente desde Finder. Haz clic con el botón derecho en un archivo o carpeta en una unidad Shade montada y selecciona **Anclar a la caché** o **Desanclar de la caché**. Si has seleccionado varios elementos, la opción muestra cuántos elementos se anclarán o desanclarán.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.shade.inc/shade-academy/shade-academy-es/shadefs/pinning-files-offline.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
