pom_cache_get_status: inspecciona el estado de la caché

Informa de si POM Cache está instalada, qué cachés admite y sus estadísticas actuales.

Argumentos

Ninguno.

Permisos

mcp:read, más manage_options. Ten en cuenta que se trata de un nivel de administrador para una lectura: la mayoría de las herramientas de lectura de POM AI necesitan mucho menos.

Qué devuelve

available y html_cache_supported son la misma comprobación

Ambos informan de si existe la función de borrado del sitio de POM Cache. Nunca estarán en desacuerdo.

json_cache_supported es una comprobación genuinamente distinta: un sitio puede tener la caché HTML y no la JSON progresiva, normalmente porque ejecuta una versión antigua de POM Cache o porque no utiliza la carga progresiva.

Esa distinción es la que pom_cache_clear_site_cache utiliza para decidir si siquiera se intenta el purgado del JSON.

La herramienta existe aunque POM Cache no

Ambas herramientas de caché se registran incondicionalmente, a diferencia de las herramientas POM Theme, que desaparecen cuando su plugin no está presente.

Así que encontrar pom_cache_get_status en la lista de herramientas de un cliente no te dice nada sobre si POM Cache está instalada. available es la respuesta, y es la razón para llamar a esto antes que a la herramienta de borrado:

Comprueba el estado de POM Cache y dime si es posible borrar la caché aquí.

Un available de false significa que pom_cache_clear_site_cache devolverá pom_ai_mcp_pom_cache_unavailable.

Las estadísticas se reinician al borrar

Ambas opciones de estadísticas se eliminan como parte de un purgado. Así que los números que lees aquí describen la caché desde el último borrado, no desde que se construyó el sitio.

Dos consecuencias:

• Leer las estadísticas inmediatamente después de un purgado devuelve unas vacías. Eso es lo esperado, no un fallo.
• Comparar estadísticas a través de un purgado no tiene sentido. Si quieres una imagen de antes y después, léelas, borra y luego deja que la caché se caliente antes de volver a leerlas.

Un conjunto de estadísticas vacío es normal

Obtienes una estructura vacía cuando la caché acaba de ser borrada, cuando el sitio es de nueva construcción o cuando POM Cache no está instalada en absoluto.

Comprueba available antes de interpretar las estadísticas vacías como un problema. En un sitio sin POM Cache, el vacío es simplemente la verdad.

Para qué sirven las estadísticas

Describen cuánta salida almacenada en caché existe. Eso es útil para dos preguntas:

• ¿Está haciendo algo la caché? Un sitio con una salida en caché sustancial es uno en el que un purgado tendrá un efecto notable en las siguientes cargas de página.
• ¿Fue efectivo el purgado? Unas estadísticas vacías después de un borrado confirman que las opciones se reiniciaron; combinado con html_deleted de la herramienta de borrado, eso es una evidencia razonable de que los archivos desaparecieron.

Lo que no pueden decirte es si una página concreta está en caché. No hay inspección por URL ni forma de purgar una única página. Consulta Acceso limitado a la caché.

Cubre solo este sitio

En una red multisitio, las estadísticas son del sitio al que estás conectado. Otros sitios de la red tienen su propio estado de POM Cache, alcanzable solo desde sus propias conexiones.

No lee nada sensible

Indicadores de disponibilidad y contadores agregados. Sin contenidos de página, sin URLs, sin datos de visitantes. Es seguro incluirlo en diagnósticos.

Cómo usarla bien

Antes de un purgado:

Comprueba el estado de la caché y luego borra la caché si está disponible.

Diagnóstico de un sitio obsoleto:

¿Está POM Cache activa aquí y admite la caché JSON?

Problemas habituales

Relacionado

• pom_cache_clear_site_cache
• Acceso limitado a la caché
• Herramientas de caché