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

مرجع قابلیت‌های 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/runmanage_optionsهیچ‌کدام
zinn-cache/convert-images
zinn-cache-convert-images
تبدیل همه تصاویر موجود (حرفه‌ای)
تبدیل تصاویر کتابخانه رسانه به فرمت‌های مدرن فعال‌شده در تنظیمات را در پس‌زمینه آغاز می‌کند.
نسخه پروPOST …/abilities/zinn-cache/convert-images/runmanage_optionsهیچ‌کدام
zinn-cache/get-cache-analytics
zinn-cache-get-cache-analytics
تجزیه و تحلیل کش را بخوانید (حرفه‌ای)
نرخ بازدید و ترافیک کش شی را برای ساعات گذشته (ساعت‌ها، تا ۷۲۰ ساعت)، کندترین دستورات آن، و اینکه کدام افزونه‌ها بیشترین میزان عدم بهره‌برداری از کش را دارند، برمی‌گرداند.
نسخه پروGET …/abilities/zinn-cache/get-cache-analytics/runmanage_optionshours: integer
zinn-cache/get-diagnostics
zinn-cache-get-diagnostics
خواندن گزارش عیب‌یابی
گزارش عیب‌یابی‌ای که پشتیبانی درخواست می‌کند را برمی‌گرداند: نسخه‌ها، محدودیت‌های سرور، وضعیت حافظه پنهان و خطاهای اخیر. این گزارش شامل هیچ‌گونه رمز عبور یا کلیدی نیست.
نسخه رایگانGET …/abilities/zinn-cache/get-diagnostics/runmanage_optionsهیچ‌کدام
zinn-cache/get-image-progress
zinn-cache-get-image-progress
پیشرفت تبدیل تصویر را بخوانید (Pro)
پیشرفت تبدیل (یا حذف) تصاویر را برمی‌گرداند.
نسخه پروGET …/abilities/zinn-cache/get-image-progress/runmanage_optionsهیچ‌کدام
zinn-cache/get-pro-settings
zinn-cache-get-pro-settings
خواندن تنظیمات کش پرو (پرو)
تمام تنظیمات کش پرو (پیش‌گرمایش، تصاویر، اسکریپت‌ها و استایل‌ها، پاک‌سازی پایگاه داده، پاک‌سازی هوشمند، یابنده) را برمی‌گرداند. اسرار هرگز برگردانده نمی‌شوند.
نسخه پروGET …/abilities/zinn-cache/get-pro-settings/runmanage_optionsهیچ‌کدام
zinn-cache/get-settings
zinn-cache-get-settings
خواندن تنظیمات کش
همه تنظیمات کش را برمی‌گرداند. رمز عبور Redis هرگز برگردانده نمی‌شود، بلکه فقط ذخیره شدن یا نشدن آن مشخص می‌گردد.
نسخه رایگانGET …/abilities/zinn-cache/get-settings/runmanage_optionsهیچ‌کدام
zinn-cache/get-slow-queries
zinn-cache-get-slow-queries
جستجوگر پرس‌وجوهای کند (Pro) را بخوانید
کندترین پرس‌وجوهای پایگاه داده و تماس‌های خروجی را که یابنده مشاهده کرده است، به همراه افزونه یا قالبی که هر یک را انجام داده است، برمی‌گرداند.
نسخه پروGET …/abilities/zinn-cache/get-slow-queries/runmanage_optionsهیچ‌کدام
zinn-cache/get-status
zinn-cache-get-status
خواندن وضعیت کش
نشان می‌دهد که آیا کش صفحه و کش شیء روشن و فعال هستند، چه تعداد صفحه کش شده‌اند، و وضعیت اتصال کش شیء و تعداد بازدیدهای آن را گزارش می‌کند.
نسخه رایگانGET …/abilities/zinn-cache/get-status/runmanage_optionsهیچ‌کدام
zinn-cache/get-warmup-progress
zinn-cache-get-warmup-progress
پیشرفت گرم کردن را بخوانید (حرفه ای)
مشخص می‌کند که آیا گرم‌سازی در حال اجرا است یا خیر، چه تعداد صفحه را بازدید کرده و چند صفحه با شکست مواجه شده‌اند.
نسخه پروGET …/abilities/zinn-cache/get-warmup-progress/runmanage_optionsهیچ‌کدام
zinn-cache/preview-database-cleanup
zinn-cache-preview-database-cleanup
پیش‌نمایش پاکسازی پایگاه داده (نسخه حرفه‌ای)
تعداد موارد قابل حذف توسط پاک‌سازی را بر اساس نوع (نسخه‌ها، پیش‌نویس‌ها، هرزنامه‌ها، داده‌های موقتی منقضی‌شده و موارد مشابه) می‌شمارد. هیچ‌چیز حذف نمی‌شود.
نسخه پروGET …/abilities/zinn-cache/preview-database-cleanup/runmanage_optionsهیچ‌کدام
zinn-cache/purge
zinn-cache-purge
پاک‌سازی حافظه پنهان
صفحه‌های ذخیره‌شده در حافظه پنهان را پاک می‌کند: همه (all: true)، برخی آدرس‌ها (urls) یا هر چیزی که برچسب‌گذاری شده است (tags). صفحات با ورود بازدیدکنندگان دوباره ساخته می‌شوند.
نسخه رایگانPOST …/abilities/zinn-cache/purge/runmanage_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/runmanage_optionsهیچ‌کدام
zinn-cache/reset-settings
zinn-cache-reset-settings
تنظیمات کش را به حالت پیش‌فرض بازگردانید
همه تنظیمات کش را به حالت پیش‌فرض برمی‌گرداند، همان‌طور که دکمهٔ بازنشانی (Reset) انجام می‌دهد. رمز عبور ذخیره‌شدهٔ Redis نیز حذف می‌شود.
نسخه رایگانPOST …/abilities/zinn-cache/reset-settings/runmanage_optionsهیچ‌کدام
zinn-cache/reset-slow-queries
zinn-cache-reset-slow-queries
پاک کردن نتایج پرس‌وجوهای کند (Pro)
همه کوئری‌های کند و فراخوانی‌های کند پیدا شده تا این لحظه را فراموش می‌کند و جستجوگر از نو شروع می‌کند.
نسخه پروPOST …/abilities/zinn-cache/reset-slow-queries/runmanage_optionsهیچ‌کدام
zinn-cache/update-pro-settings
zinn-cache-update-pro-settings
تغییر تنظیمات کش پرو (Pro)
تنظیمات Cache Pro ارسالی شما (تنظیمات: کلید به مقدار) را تغییر می‌دهد و بقیه را حفظ می‌کند. هر مقدار دقیقاً مانند صفحه Cache Pro بررسی می‌شود؛ کلید ناشناخته رد می‌شود.
نسخه پروPOST …/abilities/zinn-cache/update-pro-settings/runmanage_optionssettings: object (الزامی)
zinn-cache/update-settings
zinn-cache-update-settings
تغییر تنظیمات کش
تنظیماتی را که ارسال می‌کنید تغییر می‌دهد و بقیه موارد (کش صفحه، مدت زمان باقی‌ماندن صفحات در کش، کش شیء و اتصال Redis آن، قوانین پاکسازی و استثنائات) را حفظ می‌کند. مقادیر دقیقا مانند صفحه کش بررسی و اصلاح می‌شوند.
نسخه رایگانPOST …/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
zinn-cache/warm-cache
zinn-cache-warm-cache
پیش‌گرمایش کَش (پرو)
شروع به بازدید از تمام صفحات موجود در نقشههای سایت در پس‌زمینه می‌کند تا بازدیدکنندگان صفحات کش شده را دریافت کنند. آن را با zinn-cache/get-warmup-progress دنبال کنید.
نسخه پروPOST …/abilities/zinn-cache/warm-cache/runmanage_optionsهیچ‌کدام