توسعه‌دهندگان

مرجع قابلیت‌های Zinn® Cache

Zinn® Cache کنش‌های خود را در API توانمندی‌های WordPress ثبت می‌کند. همین توانمندی‌ها ابزارهای MCP روی سرور خود سایت و مسیرهای REST در /wp-json/wp-abilities/v1 هستند. این صفحه از رجیستری خود افزونه تولید شده است.

راهنمای کاربر: اتصال یک برنامه هوش مصنوعی

نقاط پایانی

پروتکل کنترل مدل (MCP) روی HTTP (قابل پخش جریانی)

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

MCP از طریق WP-CLI (ورودی و خروجی استاندارد)

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

REST: فهرست کردن قابلیت‌ها

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

REST: اجرای یک قابلیت

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

احراز هویت و دسترسی‌ها

درخواست‌های HTTP با یک گذرواژه برنامه‌ای WordPress (پایه‌ای HTTP) احراز هویت می‌شوند. اتصال به سرور MCP به قابلیت نشان‌داده‌شده در زیر نیاز دارد؛ سپس هر توانایی، مجوز خود را به ازای هر شیء بررسی می‌کند. قابلیت‌های فقط‌خواندنی با متد GET و ورودی خود در رشته پرس‌وجو (Query String) اجرا می‌شوند؛ سایر قابلیت‌ها با متد POST و بدنه JSON به شکل {"input": {…}} اجرا می‌شوند.

نمونه‌ها

# REST: اجرای یک قابلیت
curl -u your-username:your-application-password \
  "https://example.com/wp-json/wp-abilities/v1/abilities/zinn-cache/get-diagnostics/run"

# MCP (JSON-RPC over HTTP, after "initialize")
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"zinn-cache-get-diagnostics","arguments":{}}}

تمام قابلیت‌ها

تولید شده از abilities.json افزونه که خود از یک وب‌سایت در حال اجرا ایجاد شده است؛ زمانی که این دو با یکدیگر اختلاف داشته باشند، یک تست با شکست مواجه می‌شود.

قابلیت	عملکرد آن	ویرایش	استراحت	مجوز	پارامترها
`zinn-cache/clean-database` `zinn-cache-clean-database`	پاکسازی پایگاه داده (نسخه حرفه‌ای) اقلام اضافی فعال‌شده در تنظیمات را در پس‌زمینه حذف می‌کند. آنچه حذف شود قابل بازیابی نیست.	نسخه پرو	`POST …/abilities/zinn-cache/clean-database/run`	manage_options	هیچ‌کدام
`zinn-cache/convert-images` `zinn-cache-convert-images`	تبدیل همه تصاویر موجود (حرفه‌ای) شروع تبدیل تصاویر کتابخانه رسانه به فرمت‌های مدرن فعال‌شده در تنظیمات، در پس‌زمینه.	نسخه پرو	`POST …/abilities/zinn-cache/convert-images/run`	manage_options	هیچ‌کدام
`zinn-cache/get-cache-analytics` `zinn-cache-get-cache-analytics`	تحلیل‌های حافظه پنهان را بخوانید (Pro) نرخ برخورد و ترافیک کش شی را برای ساعات گذشته (ساعات، تا ۷۲۰ ساعت)، کندترین دستورات آن، و افزونه‌هایی را که بیشترین عدم برخورد با کش را دارند، برمی‌گرداند.	نسخه پرو	`GET …/abilities/zinn-cache/get-cache-analytics/run`	manage_options	hours: integer
`zinn-cache/get-diagnostics` `zinn-cache-get-diagnostics`	خواندن گزارش تشخیصی گزارش عیب‌یابی‌ای که پشتیبانی درخواست می‌کند را برمی‌گرداند: نسخه‌ها، محدودیت‌های سرور، وضعیت حافظه پنهان و خطاهای اخیر. این گزارش شامل هیچ‌گونه رمز عبور یا کلیدی نمی‌شود.	نسخه رایگان	`GET …/abilities/zinn-cache/get-diagnostics/run`	manage_options	هیچ‌کدام
`zinn-cache/get-image-progress` `zinn-cache-get-image-progress`	خواندن پیشرفت تبدیل تصویر (حرفه‌ای) میزان پیشرفت تبدیل (یا حذف) تصویرها را برمی‌گرداند.	نسخه پرو	`GET …/abilities/zinn-cache/get-image-progress/run`	manage_options	هیچ‌کدام
`zinn-cache/get-pro-settings` `zinn-cache-get-pro-settings`	خواندن تنظیمات کش پرو (پرو) همه تنظیمات Cache Pro (پیش‌گرمایش، تصاویر، اسکریپت‌ها و سبک‌ها، پاک‌سازی پایگاه داده، پاک‌سازی هوشمند، یابنده) را برمی‌گرداند. رمزها هرگز برگردانده نمی‌شوند.	نسخه پرو	`GET …/abilities/zinn-cache/get-pro-settings/run`	manage_options	هیچ‌کدام
`zinn-cache/get-settings` `zinn-cache-get-settings`	خواندن تنظیمات کَش همه تنظیمات کش را برمی‌گرداند. رمز عبور Redis هرگز برگردانده نمی‌شود، بلکه فقط ذخیره شدن یا نشدن آن مشخص می‌گردد.	نسخه رایگان	`GET …/abilities/zinn-cache/get-settings/run`	manage_options	هیچ‌کدام
`zinn-cache/get-slow-queries` `zinn-cache-get-slow-queries`	مایاب پرس‌وجوی کند (Pro) کندترین پرس‌وجوهای پایگاه داده و تماس‌های خروجی را که جستجوگر مشاهده کرده است، به همراه افزونه یا قالبی که هر یک را انجام داده است، برمی‌گرداند.	نسخه پرو	`GET …/abilities/zinn-cache/get-slow-queries/run`	manage_options	هیچ‌کدام
`zinn-cache/get-status` `zinn-cache-get-status`	خواندن وضعیت حافظه پنهان مشخص می‌کند که آیا کش صفحه و کش شیء روشن و فعال هستند یا خیر، چه تعداد صفحه کش شده‌اند و اتصال کش شیء و تعداد بازدیدهای آن را برمی‌گرداند.	نسخه رایگان	`GET …/abilities/zinn-cache/get-status/run`	manage_options	هیچ‌کدام
`zinn-cache/get-warmup-progress` `zinn-cache-get-warmup-progress`	پیشرفت گرم کردن (حرفه‌ای) وضعیت اجرای گرم‌سازی، تعداد صفحات بازدیدشده و تعداد صفحات ناموفق را برمی‌گرداند.	نسخه پرو	`GET …/abilities/zinn-cache/get-warmup-progress/run`	manage_options	هیچ‌کدام
`zinn-cache/preview-database-cleanup` `zinn-cache-preview-database-cleanup`	پیش‌نمایش پاکسازی پایگاه داده (حرفه‌ای) تعداد مواردی را که پاکسازی حذف می‌کند، به تفکیک نوع (نسخه‌ها، پیش‌نویس‌ها، هرزنامه‌ها، داده‌های موقتی منقضی‌شده و موارد مشابه) می‌شمارد. هیچ چیزی حذف نمی‌شود.	نسخه پرو	`GET …/abilities/zinn-cache/preview-database-cleanup/run`	manage_options	هیچ‌کدام
`zinn-cache/purge` `zinn-cache-purge`	پاک‌سازی کش صفحه‌های ذخیره‌شده در حافظه پنهان را پاک می‌کند: همه (all: true)، برخی آدرس‌ها (urls) یا هر چیزی که برچسب خورده باشد (tags). صفحات با ورود بازدیدکنندگان دوباره ساخته می‌شوند.	نسخه رایگان	`POST …/abilities/zinn-cache/purge/run`	manage_options (the REST route's own check)	all: boolean, urls: array, tags: array
`zinn-cache/remove-converted-images` `zinn-cache-remove-converted-images`	حذف تمام تصاویر تبدیل‌شده (پرو) هر نسخه تبدیل‌شده تصاویر را در پس‌زمینه حذف می‌کند؛ نسخه‌های اصلی باقی می‌مانند.	نسخه پرو	`POST …/abilities/zinn-cache/remove-converted-images/run`	manage_options	هیچ‌کدام
`zinn-cache/reset-settings` `zinn-cache-reset-settings`	تنظیمات کش را به حالت پیش‌فرض بازگردانید همانند دکمه‌ی «بازنشانی»، تمام تنظیمات کش را به حالت پیش‌فرض برمی‌گرداند. رمز عبور ذخیره‌شده‌ی Redis نیز حذف می‌شود.	نسخه رایگان	`POST …/abilities/zinn-cache/reset-settings/run`	manage_options	هیچ‌کدام
`zinn-cache/reset-slow-queries` `zinn-cache-reset-slow-queries`	پاکسازی نتایج پرس‌وجوهای کند (نسخه پرو) همه پرس‌وجوها و فراخوانی‌های کندی را که تاکنون پیدا شده‌اند فراموش می‌کند و جستجوگر از سر می‌گیرد.	نسخه پرو	`POST …/abilities/zinn-cache/reset-slow-queries/run`	manage_options	هیچ‌کدام
`zinn-cache/update-pro-settings` `zinn-cache-update-pro-settings`	تغییر تنظیمات کش پرو (Pro) تنظیمات Cache Pro ارسالی شما را تغییر می‌دهد (تنظیمات: کلید به مقدار) و بقیه را حفظ می‌کند. هر مقدار دقیقاً مانند صفحه Cache Pro بررسی می‌شود؛ یک کلید ناشناخته رد می‌شود.	نسخه پرو	`POST …/abilities/zinn-cache/update-pro-settings/run`	manage_options	settings: object (الزامی)
`zinn-cache/update-settings` `zinn-cache-update-settings`	تغییر تنظیمات کش تنظیماتی را که ارسال می‌کنید تغییر می‌دهد و بقیه را حفظ می‌کند (کش صفحه، مدت زمان ماندگاری صفحات در حالت کش، کش اشیاء و اتصال Redis آن، قوانین پاکسازی و استثنائات). مقادیر دقیقاً مانند صفحه کش بررسی و اصلاح می‌شوند.	نسخه رایگان	`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
`zinn-cache/warm-cache` `zinn-cache-warm-cache`	پیش‌گرمایش حافظه پنهان (حرفه‌ای) شروع به بازدید از تمام صفحات موجود در نقشه‌های سایت در پس‌زمینه می‌کند تا بازدیدکنندگان صفحات ذخیره‌شده در حافظه پنهان را دریافت کنند. پس از آن از zinn-cache/get-warmup-progress استفاده کنید.	نسخه پرو	`POST …/abilities/zinn-cache/warm-cache/run`	manage_options	هیچ‌کدام