Programiści

Odnośnik możliwości Zinn® Cache

Wtyczka Zinn® Cache rejestruje swoje działania za pomocą WordPress Abilities API. Te same uprawnienia są narzędziami MCP na własnym serwerze witryny oraz ścieżkami REST pod adresem /wp-json/wp-abilities/v1. Ta strona jest generowana z własnego rejestru wtyczki.

Przewodnik użytkownika: podłącz aplikację sztucznej inteligencji

Zinn®, nasz Wiking, wiwatuje, gdy asystent SI łączy się z narzędziami platformy.

Endpointy

MCP przez HTTP (przesyłane strumieniowo)

https://example.com/wp-json/zinn-cache/v1/mcp

MCP przez WP-CLI (standardowe wejście i wyjście)

wp mcp-adapter serve --server=zinn-cache --user=<login>

REST: wyświetl listę umiejętności

/wp-json/wp-abilities/v1/abilities?category=zinn-cache

REST: uruchom zdolność

/wp-json/wp-abilities/v1/abilities/<name>/run

Uwierzytelnianie i uprawnienia

Żądania HTTP uwierzytelniają się za pomocą hasła aplikacyjnego WordPress (HTTP Basic). Połączenie z serwerem MCP wymaga uprawnienia pokazanego poniżej; każda funkcja sprawdza następnie własne uprawnienia dla każdego obiektu. Funkcje tylko do odczytu działają z metodą GET i danymi wejściowymi w ciągu zapytania; pozostałe z metodą POST i treścią JSON {„input”: {…}}.

Przykłady

# REST: uruchom zdolność
curl -u your-username:your-application-password \
  "https://example.com/wp-json/wp-abilities/v1/abilities/zinn-cache/get-cache-layers/run"
# MCP (JSON-RPC over HTTP, after "initialize")
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"zinn-cache-get-cache-layers","arguments":{}}}

Wszystkie uprawnienia

Wygenerowano z pliku abilities.json wtyczki, który z kolei jest generowany z działającej witryny; test kończy się niepowodzeniem, gdy oba źródła się nie zgadzają.

UprawnienieDziałanieWydanieRESTUprawnienieParametry
zinn-cache/clean-database
zinn-cache-clean-database
Oczyść bazę danych (Pro)
Usuwa w tle rodzaje zbędnych elementów włączone w ustawieniach. To, co zostanie usunięte, nie może zostać przywrócone.
Edycja ProPOST …/abilities/zinn-cache/clean-database/runmanage_optionsbrak
zinn-cache/convert-images
zinn-cache-convert-images
Konwertuj wszystkie istniejące obrazki (Pro)
Rozpoczyna w tle konwersję obrazów z biblioteki mediów do nowoczesnych formatów włączonych w ustawieniach.
Edycja ProPOST …/abilities/zinn-cache/convert-images/runmanage_optionsbrak
zinn-cache/detect-cache-layers
zinn-cache-detect-cache-layers
Wykryj pamięci podręczne przed witryną
Wysyła zapytanie o stronę główną tak, jak zrobiłby to odwiedzający, i zapisuje, które pamięci podręczne odpowiedziały. Z parametrem sample: true wysyła także dwukrotnie zapytanie o najnowsze strony i zlicza, jak często każda warstwa serwowała je ze swojej pamięci podręcznej.
Wersja darmowaPOST …/abilities/zinn-cache/detect-cache-layers/runmanage_options (the REST route's own check)sample: boolean
zinn-cache/get-cache-analytics
zinn-cache-get-cache-analytics
Odczytaj analitykę pamięci podręcznej (Pro)
Zwraca współczynnik trafień i ruch w pamięci podręcznej obiektów z ostatnich godzin (godziny, do 720), jej najwolniejsze polecenia oraz wtyczki, które najczęściej pomijają pamięć podręczną.
Edycja ProGET …/abilities/zinn-cache/get-cache-analytics/runmanage_optionshours: integer
zinn-cache/get-cache-layers
zinn-cache-get-cache-layers
Przeczytaj, co buforuje witrynę
Zwraca informację o tym, która pamięć podręczna serwuje strony (LiteSpeed, nginx, Varnish, Apache, Cloudflare lub pamięć podręczna wtyczki na dysku), co wykryło ostatnie sprawdzenie, rozmiar każdej warstwy, tam gdzie WordPress może go odczytać, kolejkę czyszczenia, odświeżanie stopniowe oraz ostatnie czyszczenia.
Wersja darmowaGET …/abilities/zinn-cache/get-cache-layers/runmanage_options (the REST route's own check)brak
zinn-cache/get-diagnostics
zinn-cache-get-diagnostics
Przeczytaj raport diagnostyczny
Zwraca raport diagnostyczny, o który prosi pomoc techniczna: wersje, limity serwera, stan pamięci podręcznej i ostatnie błędy. Nie zawiera haseł ani kluczy.
Wersja darmowaGET …/abilities/zinn-cache/get-diagnostics/runmanage_optionsbrak
zinn-cache/get-image-progress
zinn-cache-get-image-progress
Odczytaj postęp konwersji obrazu (Pro)
Zwraca informację o postępie konwersji (lub usuwania) obrazów.
Edycja ProGET …/abilities/zinn-cache/get-image-progress/runmanage_optionsbrak
zinn-cache/get-pro-settings
zinn-cache-get-pro-settings
Odczytaj ustawienia Cache Pro (Pro)
Zwraca każde ustawienie Cache Pro (rozgrzewanie, obrazy, skrypty i style, czyszczenie bazy danych, inteligentne czyszczenie, wyszukiwarkę). Klucze tajne nigdy nie są zwracane.
Edycja ProGET …/abilities/zinn-cache/get-pro-settings/runmanage_optionsbrak
zinn-cache/get-settings
zinn-cache-get-settings
Odczytaj ustawienia pamięci podręcznej
Zwraca każde ustawienie pamięci podręcznej. Hasło Redis i token Cloudflare nigdy nie są zwracane, a jedynie informacja o tym, czy zostały zapisane.
Wersja darmowaGET …/abilities/zinn-cache/get-settings/runmanage_optionsbrak
zinn-cache/get-slow-queries
zinn-cache-get-slow-queries
Przeczytaj o wyszukiwarce powolnych zapytań (Pro)
Zwraca najwolniejsze zapytania do bazy danych i wywołania wychodzące wykryte przez wyszukiwarkę, wraz z wtyczką lub motywem, który je wykonał.
Edycja ProGET …/abilities/zinn-cache/get-slow-queries/runmanage_optionsbrak
zinn-cache/get-status
zinn-cache-get-status
Odczytaj stan pamięci podręcznej
Zwraca informację, czy pamięć podręczna stron i pamięć podręczna obiektów są włączone i działają, ile stron znajduje się w pamięci podręcznej oraz liczbę połączeń i trafień pamięci podręcznej obiektów.
Wersja darmowaGET …/abilities/zinn-cache/get-status/runmanage_optionsbrak
zinn-cache/get-warmup-progress
zinn-cache-get-warmup-progress
Odczytaj postęp rozgrzewania (Pro)
Zwraca informację, czy rozgrzewanie jest uruchomione, ile stron odwiedziło i ile zakończyło się niepowodzeniem.
Edycja ProGET …/abilities/zinn-cache/get-warmup-progress/runmanage_optionsbrak
zinn-cache/preview-database-cleanup
zinn-cache-preview-database-cleanup
Podgląd oczyszczania bazy danych (Pro)
Zlicza według rodzaju elementy, które usunęłoby czyszczenie (poprawki, szkice, spam, wygasłe dane tymczasowe itp.). Nic nie zostaje usunięte.
Edycja ProGET …/abilities/zinn-cache/preview-database-cleanup/runmanage_optionsbrak
zinn-cache/purge
zinn-cache-purge
Wyczyść pamięć podręczną
Odrzuca strony z pamięci podręcznej: wszystko (all: true), niektóre adresy (urls) lub wszystkie otagowane elementy (tags). Strony są tworzone na nowo, gdy pojawiają się odwiedzający.
Wersja darmowaPOST …/abilities/zinn-cache/purge/runmanage_options (the REST route's own check)all: boolean, urls: array, tags: array
zinn-cache/purge-urls
zinn-cache-purge-urls
Wyczyść niektóre adresy na każdej warstwie pamięci podręcznej
Usuwa te adresy (ścieżki takie jak /about/ lub pełne adresy w tej witrynie) jednocześnie z pamięci podręcznej dysku, pamięci podręcznej serwera i Cloudflare oraz informuje, co odpowiedziała każda z warstw.
Wersja darmowaPOST …/abilities/zinn-cache/purge-urls/runmanage_options (the REST route's own check)urls: array (wymagane)
zinn-cache/refresh-cache
zinn-cache-refresh-cache
Rozpocznij lub zatrzymaj odświeżanie stopniowe
action: start odświeża każdą stronę partiami co minutę (to, co robią aktualizacje zamiast czyszczenia pamięci podręcznej); action: stop kończy trwające odświeżanie.
Wersja darmowaPOST …/abilities/zinn-cache/refresh-cache/runmanage_options (the REST route's own check)action: start|stop (wymagane)
zinn-cache/remove-converted-images
zinn-cache-remove-converted-images
Usuń wszystkie przekonwertowane obrazy (Pro)
Usuwa w tle każdą przekonwertowaną kopię obrazów; oryginały pozostają.
Edycja ProPOST …/abilities/zinn-cache/remove-converted-images/runmanage_optionsbrak
zinn-cache/reset-settings
zinn-cache-reset-settings
Przywróć domyślne ustawienia pamięci podręcznej
Przywraca wszystkie ustawienia pamięci podręcznej do wartości domyślnych, tak jak przycisk Resetuj. Zapisane hasło do Redis również zostanie usunięte.
Wersja darmowaPOST …/abilities/zinn-cache/reset-settings/runmanage_optionsbrak
zinn-cache/reset-slow-queries
zinn-cache-reset-slow-queries
Wyczyść wyniki powolnych zapytań (Pro)
Zapomina każde znalezione do tej pory powolne zapytanie oraz powolne wywołanie, a wyszukiwarka uruchamia się ponownie.
Edycja ProPOST …/abilities/zinn-cache/reset-slow-queries/runmanage_optionsbrak
zinn-cache/update-pro-settings
zinn-cache-update-pro-settings
Zmień ustawienia Cache Pro (Pro)
Zmienia przesłane ustawienia Cache Pro (ustawienia: klucz do wartości) i zachowuje pozostałe. Każda wartość jest sprawdzana dokładnie tak, jak na ekranie Cache Pro; nieznany klucz jest odrzucany.
Edycja ProPOST …/abilities/zinn-cache/update-pro-settings/runmanage_optionssettings: object (wymagane)
zinn-cache/update-settings
zinn-cache-update-settings
Zmień ustawienia pamięci podręcznej
Zmienia przesłane przez ciebie ustawienia i zachowuje pozostałe (pamięć podręczną stron, czas przechowywania stron w pamięci podręcznej, pamięć podręczną obiektów i jej połączenie z Redis, reguły czyszczenia oraz wykluczenia). Wartości są sprawdzane i korygowane dokładnie tak samo, jak na ekranie pamięci podręcznej.
Wersja darmowaPOST …/abilities/zinn-cache/update-settings/runmanage_optionslscache_enabled: boolean, lscache_ttl: integer, object_cache_enabled: boolean, auto_purge_enabled: boolean, purge_on_upgrade: boolean, exclude_uris: array|object|string, exclude_query_keys: array|object|string, exclude_cookies: array|object|string, redis_host: string, redis_port: integer, redis_database: integer, redis_username: string, redis_password: string, redis_key_prefix: string, browser_ttl: integer, cache_logged_out_only: boolean, purge_on_comment: boolean, ttl_overrides: array|object|string, server_cache: string, server_cache_headers: boolean, nginx_purge_method: string, nginx_purge_endpoint: string, nginx_http_verb: string, nginx_purge_address: string, nginx_cache_path: string, nginx_cache_levels: string, nginx_cache_key: string, nginx_key_variants: array|object|string, nginx_spool_dir: string, varnish_host: string, varnish_port: integer, varnish_method: string, apache_cache_root: string, apache_dir_levels: integer, apache_dir_length: integer, cloudflare_enabled: boolean, cloudflare_zone_id: string, cloudflare_api_token: string, cloudflare_purge_everything: boolean, refresh_batch: integer, refresh_load_limit: integer, redis_serializer: string, heartbeat_mode: string, font_display_swap: boolean, preconnect_origins: array|object|string, cdn_url: string, cdn_exclude: array|object|string
zinn-cache/warm-cache
zinn-cache-warm-cache
Rozgrzej pamięć podręczną (Pro)
Zaczyna w tle odwiedzać każdą stronę z map witryny, dzięki czemu odwiedzający otrzymują strony zapisane w pamięci podręcznej. Postęp jest zgłaszany osobno w trakcie działania.
Edycja ProPOST …/abilities/zinn-cache/warm-cache/runmanage_optionsbrak

Polecenia WP-CLI

Uruchom je na serwerze za pomocą WP-CLI. Każde polecenie sprawdza te same uprawnienia co ekrany wtyczki; przykłady pochodzą z własnego tekstu pomocy wtyczki.

PolecenieDziałanieWydanie
wp zinn-cache purge all
wp zinn-cache purge all
Wyczyść każdą stronę w pamięci podręcznej.Wersja darmowa
wp zinn-cache purge post
<id>...
wp zinn-cache purge post 42
Wyczyść strony wpisu oraz listy, na których się pojawia (strona główna, archiwa, kanały informacyjne).Wersja darmowa
wp zinn-cache purge url
<url>...
wp zinn-cache purge url https://example.com/ /pricing/
Wyczyść strony w pamięci podręcznej pod tymi adresami URL.Wersja darmowa
wp zinn-cache refresh
<action>
wp zinn-cache refresh status
Uruchom, zatrzymaj lub pokaż odświeżanie stopniowe (to, co zastępuje opcję „wyczyść wszystko” po aktualizacji).Wersja darmowa
wp zinn-cache server detect
wp zinn-cache server detect
Sprawdź, które pamięci podręczne odpowiadają przed witryną (nginx, Varnish, Apache, LiteSpeed, Cloudflare).Wersja darmowa
wp zinn-cache server drain
wp zinn-cache server drain
Wyślij oczyszczenia pamięci podręcznej serwera w kolejce teraz, zamiast czekać na WP-Cron.Wersja darmowa
wp zinn-cache status
[--format=<format>]
wp zinn-cache status --format=json
Zgłoś stan pamięci podręcznej obiektów.Wersja darmowa

Działania i filtry

Wszystkie zaczepy oferowane przez wtyczkę wraz z opisami z kodu źródłowego. Filtry zmieniają wartość; akcje pozwalają uruchomić kod w danym momencie; punkty wejścia to akcje wywoływane w celu zlecenia wtyczce określonego zadania.

WebhookRodzajDziałanieParametryWydanie
zinn_cache_control_headerFiltrujFiltruje wartość cache-control wysyłaną do LiteSpeed dla strony z możliwością buforowania.string $value, int $ttlWersja darmowa
zinn_cache_fs_loadedDziałanieUruchamia się po załadowaniu zestawu SDK licencji, przed resztą pamięci podręcznej Zinn® Cache. Podczep się tutaj, aby połączyć się z `zinn_cache_fs()`.brakWersja darmowa
zinn_cache_link_scan_post_typesFiltrujTypy postów, które obejmuje skan.brakWersja darmowa
zinn_cache_mcp_abilitiesDziałanieUruchamia się po zarejestrowaniu zdolności przez Zinn® Cache: Zinn® Cache Pro dodaje tutaj własne.brakWersja darmowa
zinn_cache_post_change_tagsFiltrujFiltruje znaczniki pamięci podręcznej usuwane po zmianie wpisu.string[] $tags, int $post_id, string $post_typeWersja darmowa
zinn_cache_purge_allDziałanieWyczyść wszystko, z wiersza Narzędzia.brakWersja darmowa
zinn_cache_purge_hostsFiltrujFiltruje nazwy hostów, które mogą określać czyszczenia (dla witryny obsługiwanej w więcej niż jednej domenie).string[] $hostsWersja darmowa
zinn_cache_purge_on_seo_changeFiltrujFiltruje, czy zmiana wprowadzona w Zinn® SEO czyści zmienione przez nią strony.bool $onWersja darmowa
zinn_cache_purge_planPunkt wejścia (wywołujesz go)Wyczyść dokładnie to, co określa plan: `do_action( 'zinn_cache_purge_plan', array( 'urls' => …, 'tags' => …, 'purge_all' => … ) )`.brakWersja darmowa
zinn_cache_purgedDziałanieUruchamia się po wysłaniu przez wtyczkę czyszczenia pamięci podręcznej.array{purge_all:bool,urls:string[],tags:string[]} $planWersja darmowa
zinn_cache_purged_allDziałanieUruchamia się po zażądaniu pełnego wyczyszczenia pamięci podręcznej strony.string $reasonWersja darmowa
zinn_cache_refresh_armedDziałanieUruchamia się, gdy rozpoczyna się odświeżanie stopniowane.string $reasonWersja darmowa
zinn_cache_refresh_finishedDziałanieUruchamia się, gdy miarkowane odświeżanie dotrze do końca witryny.int $pagesWersja darmowa
zinn_cache_refresh_guardFiltrujFiltruje, czy odświeżanie powinno zostać wstrzymane w tej minucie (własna ochrona obciążenia hosta).string $reasonWersja darmowa
zinn_cache_refresh_urlsFiltrujFiltruje adresy usuwane przez partię odświeżania — dodaj tutaj na przykład adresy poszczególnych stron w innych językach.string[] $urlsWersja darmowa
zinn_cache_refreshed_urlsDziałanieUruchamia się po wyczyszczeniu partii odświeżania (Zinn® Cache Pro ponownie rozgrzewa te strony).string[] $urlsWersja darmowa
zinn_cache_request_cacheableFiltrujFiltruje, czy bieżące żądanie front-endu może być obsługiwane z pamięci podręcznej strony.bool $cacheableWersja darmowa
zinn_cache_status_rowsFiltrujFiltruje wiersze tabeli „Co buforuje tę witrynę” na ekranie stanu.array<int,array{0:string,1:string}> $rows, array<string,mixed> $reportWersja darmowa
zinn_cache_ttlFiltrujFiltruje czas pamięci podręcznej bieżącej strony w sekundach.int $ttlWersja darmowa