skill
دوران البوابة الدوارة
إعداد أو إصلاح أو الترحيل إلى التحقق من الروبوتات Cloudflare Turnstile في واجهة أمامية وخلفية موجودة، بما في ذلك Siteverify من جانب الخادم.
نبذة
# مهارة Turnstile Spin
تحول المطالبة "إعداد Turnstile" إلى تكامل عملي شامل: أداة واجهة مستخدم (widget)، مقتطفات واجهة أمامية في كل نقطة إدراج مختارة، تحقق معياري من جانب الخادم (siteverify) في الواجهة الخلفية الحالية للعميل، واجتياز تحقق حقيقي قبل الإبلاغ عن النجاح.
أنت الوكيل. قم بتشغيل المعالج أدناه عن طريق استدعاء السكريبتات الموجودة تحت `scripts/` والتفرع بناء على مخرجاتها بصيغة JSON. تحتوي السكريبتات على المنطق الحتمي (استدعاءات API، معالجة إعادة المحاولة/الأخطاء)؛ وظيفتك هي التنسيق، قراءة قاعدة الكود، التأكيد، وتعديلات الواجهة الأمامية والخلفية.
هذا الملف هو السلوك المعياري القابل للقراءة آليا. تأتي متطلبات المنتج من [وثائق Turnstile](https://developers.cloudflare.com/turnstile/index.md)، ويجب أن تعكس المطالبة المستضافة هذا السلوك.
## مراجع الأطر البرمجية
اقرأ المرجع الخاص بالواجهة الأمامية الموجودة عند ربط التكامل:
| الواجهة الأمامية | المرجع | |---|---| | Vanilla HTML | [vanilla-html](references/vanilla-html.md) | | Next.js App Router | [nextjs-app](references/nextjs-app.md) | | Next.js Pages Router | [nextjs-pages](references/nextjs-pages.md) | | Astro | [astro](references/astro.md) | | SvelteKit | [sveltekit](references/sveltekit.md) | | Hugo | [hugo](references/hugo.md) |
## متى يتم تحميل هذه المهارة
قم بالتحميل عندما تذكر مطالبة المستخدم أيا مما يلي:
- "Turnstile", "CAPTCHA", "حماية الروبوتات" - "siteverify", "cf-turnstile-response" - "حماية هذا النموذج", "حماية نقطة النهاية هذه", "حماية هذا الزر", "إيقاف تسجيلات الروبوتات", "تسجيلات البريد العشوائي", "حظر الروبوتات على <الهدف>" - نموذج تسجيل محدد، تسجيل دخول، نموذج اتصال، تنزيل، تعليق، نقطة نهاية API، أو طلب آخر يتم تشغيله بواسطة المستخدم بالاشتراك مع "Cloudflare" أو "روبوت"
لا تقم بالتحميل لمهام Cloudflare غير ذات الصلة (Workers, Pages, R2, إلخ) ما لم يتم ذكر Turnstile أيضا.
## اختر التدفق قبل الرد
افحص مطالبة المستخدم قبل بدء المعالج المرقم. إذا ذكرت أن الأداة (widget) قد تم إنشاؤها بالفعل وقدمت مفتاح موقع واحدا أو أكثر (sitekeys)، فانتقل مباشرة إلى تدفق الأداة الموجودة أدناه. لا تقم بتشغيل، تلخيص، أو اقتراح تدفق إنشاء الأداة. بخلاف ذلك، استخدم معالج الإنشاء المرقم.
## تدفق المحادثة
قام المستخدم بلصق المطالبة. أنت في حوار متعدد الخطوات. اكتشف ما يمكنك اكتشافه، اسأل فقط عند الضرورة، أكد قبل كل خطوة لا رجعة فيها. كل لحظة مرقمة هي رسالة وكيل واحدة. تتطلب العناصر التي تحمل علامة **[انتظر المستخدم]** استجابة من المستخدم.
1. **إقرار موجز.** جملة واحدة: "سأقوم بتشغيل إعداد Turnstile من البداية إلى النهاية. وهذا يشمل: التحقق من المصادقة، مسح قاعدة الكود، إنشاء الأداة، تضمينها حيث تتطلب طلبات الزوار التحقق، ربط siteverify من جانب الخادم، التحقق. هل أتابع؟" **[انتظر المستخدم]** لا تقدم خطة بعد. المصادقة والمسح يأتيان أولا.
2. **فحص CLI.** تستخدم سكريبتات المساعدة الخاصة ب Spin أمر `curl` مقابل `api.cloudflare.com`. يتطلب تعداد الحساب إما `$CLOUDFLARE_ACCOUNT_ID` صريحا أو `WRANGLER_BIN` مطلقا معياريا معتمدا من المستخدم خارج المشروع مع `WRANGLER_VERSION` دقيق. لا تستخدم أبدا `npx`، `pnpm exec`، سكريبت حزمة، ثنائي محلي للمشروع، أو ملف تنفيذي غير معتمد لأمر يحمل بيانات اعتماد. لا تقم أبدا بتثبيت Wrangler تلقائيا أثناء التدفق.
3. **فحص المصادقة والنطاق (الإجراء الأول الذي لا رجعة فيه).** قم بتشغيل `scripts/auth-probe.sh`. إذا كان تعداد الحساب يتطلب Wrangler، قم بتعيين `PROJECT_ROOT`، `WRANGLER_BIN` المعياري المعتمد، و `WRANGLER_VERSION` الدقيق أولا. تفرع بناء على `status`: - `ok`: تابع إلى الخطوة 4. لقد اختار السكريبت الحساب بالفعل (رمز حساب واحد، أو واحد يطابق `$CLOUDFLARE_ACCOUNT_ID`). - `missing_token` أو `missing_scope`: اطلب من المستخدم إنشاء رمز مميز على https://dash.cloudflare.com/profile/api-tokens ← Custom token ← إذن `Account.Turnstile:Edit` ← تضمين الحساب المستهدف في Account Resources. **لا توجههم إلى `wrangler login`** إلا إذا كان نطاق OAuth الخاص ب wrangler يتضمن `Account.Turnstile:Edit` (يختلف حسب إصدار wrangler). قدم طريقتين لتوفير الرمز المميز بدون الدردشة، الأسهل أولا: 1. **تصدير + إعادة تشغيل** (الرمز المميز لا يدخل الدردشة ولا سجل الأوامر): `read -rsp 'Cloudflare API token: ' token; echo; export CLOUDFLARE_API_TOKEN="$token"; unset token`، ثم أعد تشغيل الوكيل من تلك الطرفية. 2. **حفظ في ملف** (الرمز المميز في ملف خاص بالمستخدم فقط): `umask 077; read -rsp 'Cloudflare API token: ' token; echo; printf '%s' "$token" > ~/.cf-turnstile-token; unset token`، ثم قم بتحميله دون طباعته. لا تطلب من المستخدم لصق رمز API المميز في الدردشة. عندما يتم إنشاء المصادقة، أعد تشغيل `auth-probe.sh` واستأنف من الخطوة 4. - `network_failure`: لم يتمكن الفحص من الوصول إلى `api.cloudflare.com`. أظهر التشخيص (VPN/proxy, TLS interception, DNS). لا تعتبر هذا مشكلة نطاق. اطلب من المستخدم إصلاح الاتصال، ثم أعد تشغيل `auth-probe.sh`. - `upstream_failure`: أعادت API استجابة غير متوقعة (`http_code` غير 4xx). لا تفترض أن الرمز المميز سيء. أظهر الكود، اطلب من المستخدم إعادة المحاولة بعد انتظار قصير، وأعد تشغيل `auth-probe.sh`. - `multiple_accounts`: يغطي الرمز المميز أكثر من حساب واحد
التثبيت
شغل هذا الأمر
npx skills add cloudflare/skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add cloudflare/skills`، أو استنسخ المستودع وانسخ مجلد `skills/turnstile-spin` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة دوران البوابة الدوارة؟
إعداد أو إصلاح أو الترحيل إلى التحقق من الروبوتات Cloudflare Turnstile في واجهة أمامية وخلفية موجودة، بما في ذلك Siteverify من جانب الخادم.
كيف أثبت دوران البوابة الدوارة؟
شغل هذا الأمر في الطرفية:
npx skills add cloudflare/skillsمع أي أدوات ذكاء اصطناعي تعمل دوران البوابة الدوارة؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور دوران البوابة الدوارة؟
طورها cloudflare.
هل دوران البوابة الدوارة مجانية؟
نعم، يمكنك استخدامها مجانا.
npx skills add mattpocock/skills
npx skills add vercel-labs/agent-browser
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add designed-by-ai/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى