pom_cache_clear_site_cache: borra la caché del sitio

Elimina la salida almacenada en caché de este sitio para que el siguiente visitante active un renderizado nuevo.

Argumentos

Argumento Obligatorio Significado
include_json No También borra la caché JSON progresiva. Por defecto es true
dry_run No Informa de qué se borraría

Permisos

mcp:write, más manage_options. Sin compuerta de escritura — consulta el índice de capítulos.

include_json está activado por defecto

Omítelo y se borrarán ambas cachés. Pásalo como false para borrar solo la caché HTML.

Ese valor por defecto es el correcto para el caso habitual —quieres que el sitio refleje un cambio— y conviene saberlo porque «borrar la caché» hará más de lo que un lector de la lista de argumentos podría suponer.

La purga de JSON solo se intenta si el sitio la admite. En un sitio sin ella, include_json no tiene efecto.

Es destructiva, y está bien

Se clasifica como destructiva porque elimina archivos. Pero todo lo que elimina es salida generada, que se reconstruye automáticamente en la siguiente petición.

No se toca contenido, ajustes, medios ni configuración. No hay nada que respaldar y nada que restaurar.

El coste real es el rendimiento: el siguiente visitante de cada página espera un renderizado completo. En un sitio grande o con mucho tráfico eso es un pico breve de carga, que es la única razón para pensar en el momento.

Lee la respuesta, no solo el éxito

Vuelven tres campos:

Campo Significado
html_deleted Si la purga HTML informó de éxito
json_deleted Lo mismo para JSON, o null si no se intentó
deleted True si cualquiera de las dos tuvo éxito

Así que es posible deleted: true con html_deleted: false: la caché JSON se borró y la caché HTML no. Como la caché HTML es la que oculta tu cambio, esa combinación parece éxito y no lo es.

Comprueba html_deleted específicamente.

Un json_deleted de null significa que la purga JSON se omitió —bien porque include_json era false o porque el sitio no la admite—. Eso no es un fallo.

Las estadísticas se restablecen en cualquier caso

Ambas opciones de estadísticas de caché se eliminan como parte de la llamada, tanto si las purgas tuvieron éxito como si no.

Así que unas estadísticas vacías después no son prueba de que la caché se borrara. Solo demuestran que esta herramienta se ejecutó. Usa html_deleted para el resultado real.

La prueba en seco informa de la intención, no del contenido

Devuelve qué cachés borraría —HTML siempre, JSON si está admitido y solicitado—. No enumera archivos, no los cuenta ni informa de cuánta salida en caché existe.

Su única utilidad real es confirmar si la purga JSON entra en el alcance en este sitio. Para el tamaño de la caché, lee primero pom_cache_get_status.

Dado que la operación es inofensiva y reversible por definición, la prueba en seco importa menos aquí que en cualquier otro lugar de la documentación.

Solo POM Cache, y solo este sitio

Quedan sin tocar por esta llamada:

  • Cachés de CDN. Normalmente la capa que de verdad mantiene invisible un cambio.
  • Cachés de página del alojamiento —caché a nivel de servidor o de proxy inverso.
  • Cachés de objetos y de opcode.
  • Cachés del navegador.
  • Otros sitios de una red multisitio. Un sitio por llamada, desde la conexión de ese propio sitio.

Un cambio que sigue sin verse después de que esta herramienta informe de éxito es casi siempre el CDN. Purga eso a continuación.

Dónde encaja en un flujo de trabajo

Al final, después del cambio y tras verificar los datos almacenados:

Actualiza el CSS global, léelo de nuevo para confirmar y luego borra la caché del sitio.

Borrar antes de que el cambio esté terminado solo vuelve a almacenar en caché la versión antigua.

Y borrar la caché no es una forma de arreglar un cambio que no se guardó. Si los datos están mal, la caché no es el problema —comprueba primero la escritura.

Después de borrar

  1. Confirma que html_deleted es true.
  2. Purga el CDN.
  3. Carga una página afectada y confirma que renderiza el cambio.
  4. Carga una segunda página para confirmar que el sitio está sano en general.

Problemas comunes

Síntoma Causa
pom_ai_mcp_pom_cache_unavailable POM Cache no está instalado en este sitio
pom_ai_mcp_forbidden Falta manage_options
deleted: true pero el cambio es invisible Comprueba html_deleted; después el CDN
json_deleted es null Se omitió: no solicitado, o no admitido
El sitio va lento justo después Esperado; las páginas se están re-renderizando
Otro sitio de la red sigue desactualizado Un sitio por llamada
Las estadísticas están vacías pero no se purgó nada Se restablecen independientemente del resultado
`pom_cache_get_status`: inspecciona el estado de la caché
Anterior
Recursos MCP
Siguiente