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
Endpointy
MCP przez HTTP (przesyłane strumieniowo)
https://example.com/wp-json/zinn-cache/v1/mcpMCP 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-cacheREST: uruchom zdolność
/wp-json/wp-abilities/v1/abilities/<name>/runUwierzytelnianie 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ą.
| Uprawnienie | Działanie | Wydanie | REST | Uprawnienie | Parametry |
|---|---|---|---|---|---|
zinn-cache/clean-databasezinn-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 Pro | POST …/abilities/zinn-cache/clean-database/run | manage_options | brak |
zinn-cache/convert-imageszinn-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 Pro | POST …/abilities/zinn-cache/convert-images/run | manage_options | brak |
zinn-cache/detect-cache-layerszinn-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 darmowa | POST …/abilities/zinn-cache/detect-cache-layers/run | manage_options (the REST route's own check) | sample: boolean |
zinn-cache/get-cache-analyticszinn-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 Pro | GET …/abilities/zinn-cache/get-cache-analytics/run | manage_options | hours: integer |
zinn-cache/get-cache-layerszinn-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 darmowa | GET …/abilities/zinn-cache/get-cache-layers/run | manage_options (the REST route's own check) | brak |
zinn-cache/get-diagnosticszinn-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 darmowa | GET …/abilities/zinn-cache/get-diagnostics/run | manage_options | brak |
zinn-cache/get-image-progresszinn-cache-get-image-progress | Odczytaj postęp konwersji obrazu (Pro) Zwraca informację o postępie konwersji (lub usuwania) obrazów. | Edycja Pro | GET …/abilities/zinn-cache/get-image-progress/run | manage_options | brak |
zinn-cache/get-pro-settingszinn-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 Pro | GET …/abilities/zinn-cache/get-pro-settings/run | manage_options | brak |
zinn-cache/get-settingszinn-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 darmowa | GET …/abilities/zinn-cache/get-settings/run | manage_options | brak |
zinn-cache/get-slow-querieszinn-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 Pro | GET …/abilities/zinn-cache/get-slow-queries/run | manage_options | brak |
zinn-cache/get-statuszinn-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 darmowa | GET …/abilities/zinn-cache/get-status/run | manage_options | brak |
zinn-cache/get-warmup-progresszinn-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 Pro | GET …/abilities/zinn-cache/get-warmup-progress/run | manage_options | brak |
zinn-cache/preview-database-cleanupzinn-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 Pro | GET …/abilities/zinn-cache/preview-database-cleanup/run | manage_options | brak |
zinn-cache/purgezinn-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 darmowa | POST …/abilities/zinn-cache/purge/run | manage_options (the REST route's own check) | all: boolean, urls: array, tags: array |
zinn-cache/purge-urlszinn-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 darmowa | POST …/abilities/zinn-cache/purge-urls/run | manage_options (the REST route's own check) | urls: array (wymagane) |
zinn-cache/refresh-cachezinn-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 darmowa | POST …/abilities/zinn-cache/refresh-cache/run | manage_options (the REST route's own check) | action: start|stop (wymagane) |
zinn-cache/remove-converted-imageszinn-cache-remove-converted-images | Usuń wszystkie przekonwertowane obrazy (Pro) Usuwa w tle każdą przekonwertowaną kopię obrazów; oryginały pozostają. | Edycja Pro | POST …/abilities/zinn-cache/remove-converted-images/run | manage_options | brak |
zinn-cache/reset-settingszinn-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 darmowa | POST …/abilities/zinn-cache/reset-settings/run | manage_options | brak |
zinn-cache/reset-slow-querieszinn-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 Pro | POST …/abilities/zinn-cache/reset-slow-queries/run | manage_options | brak |
zinn-cache/update-pro-settingszinn-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 Pro | POST …/abilities/zinn-cache/update-pro-settings/run | manage_options | settings: object (wymagane) |
zinn-cache/update-settingszinn-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 darmowa | POST …/abilities/zinn-cache/update-settings/run | manage_options | lscache_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-cachezinn-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 Pro | POST …/abilities/zinn-cache/warm-cache/run | manage_options | brak |
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.
| Polecenie | Działanie | Wydanie |
|---|---|---|
wp zinn-cache purge allwp 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 detectwp 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 drainwp 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.
| Webhook | Rodzaj | Działanie | Parametry | Wydanie |
|---|---|---|---|---|
zinn_cache_control_header | Filtruj | Filtruje wartość cache-control wysyłaną do LiteSpeed dla strony z możliwością buforowania. | string $value, int $ttl | Wersja darmowa |
zinn_cache_fs_loaded | Działanie | Uruchamia 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()`. | brak | Wersja darmowa |
zinn_cache_link_scan_post_types | Filtruj | Typy postów, które obejmuje skan. | brak | Wersja darmowa |
zinn_cache_mcp_abilities | Działanie | Uruchamia się po zarejestrowaniu zdolności przez Zinn® Cache: Zinn® Cache Pro dodaje tutaj własne. | brak | Wersja darmowa |
zinn_cache_post_change_tags | Filtruj | Filtruje znaczniki pamięci podręcznej usuwane po zmianie wpisu. | string[] $tags, int $post_id, string $post_type | Wersja darmowa |
zinn_cache_purge_all | Działanie | Wyczyść wszystko, z wiersza Narzędzia. | brak | Wersja darmowa |
zinn_cache_purge_hosts | Filtruj | Filtruje nazwy hostów, które mogą określać czyszczenia (dla witryny obsługiwanej w więcej niż jednej domenie). | string[] $hosts | Wersja darmowa |
zinn_cache_purge_on_seo_change | Filtruj | Filtruje, czy zmiana wprowadzona w Zinn® SEO czyści zmienione przez nią strony. | bool $on | Wersja darmowa |
zinn_cache_purge_plan | Punkt wejścia (wywołujesz go) | Wyczyść dokładnie to, co określa plan: `do_action( 'zinn_cache_purge_plan', array( 'urls' => …, 'tags' => …, 'purge_all' => … ) )`. | brak | Wersja darmowa |
zinn_cache_purged | Działanie | Uruchamia się po wysłaniu przez wtyczkę czyszczenia pamięci podręcznej. | array{purge_all:bool,urls:string[],tags:string[]} $plan | Wersja darmowa |
zinn_cache_purged_all | Działanie | Uruchamia się po zażądaniu pełnego wyczyszczenia pamięci podręcznej strony. | string $reason | Wersja darmowa |
zinn_cache_refresh_armed | Działanie | Uruchamia się, gdy rozpoczyna się odświeżanie stopniowane. | string $reason | Wersja darmowa |
zinn_cache_refresh_finished | Działanie | Uruchamia się, gdy miarkowane odświeżanie dotrze do końca witryny. | int $pages | Wersja darmowa |
zinn_cache_refresh_guard | Filtruj | Filtruje, czy odświeżanie powinno zostać wstrzymane w tej minucie (własna ochrona obciążenia hosta). | string $reason | Wersja darmowa |
zinn_cache_refresh_urls | Filtruj | Filtruje adresy usuwane przez partię odświeżania — dodaj tutaj na przykład adresy poszczególnych stron w innych językach. | string[] $urls | Wersja darmowa |
zinn_cache_refreshed_urls | Działanie | Uruchamia się po wyczyszczeniu partii odświeżania (Zinn® Cache Pro ponownie rozgrzewa te strony). | string[] $urls | Wersja darmowa |
zinn_cache_request_cacheable | Filtruj | Filtruje, czy bieżące żądanie front-endu może być obsługiwane z pamięci podręcznej strony. | bool $cacheable | Wersja darmowa |
zinn_cache_status_rows | Filtruj | Filtruje wiersze tabeli „Co buforuje tę witrynę” na ekranie stanu. | array<int,array{0:string,1:string}> $rows, array<string,mixed> $report | Wersja darmowa |
zinn_cache_ttl | Filtruj | Filtruje czas pamięci podręcznej bieżącej strony w sekundach. | int $ttl | Wersja darmowa |