skill

دوران البوابة الدوارة

إعداد أو إصلاح أو الترحيل إلى التحقق من الروبوتات Cloudflare Turnstile في واجهة أمامية وخلفية موجودة، بما في ذلك Siteverify من جانب الخادم.

cloudflare97,263+ تثبيتموثوق

نبذة

# مهارة 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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `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.

هل دوران البوابة الدوارة مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في التصميم والإبداع.

كل بدائل دوران البوابة الدوارة ←
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
اشوني
مقابلة مكثفة لصقل خطة أو تصميم.1,242,904+
skillclaude_appclaude_codeclaude_api
npx skills add vercel-labs/agent-browser
متصفح الوكيل
أداة سطر أوامر لأتمتة المتصفح لوكلاء الذكاء الاصطناعي. تستخدم عندما يحتاج المستخدم إلى التفاعل مع مواقع الويب، بما في ذلك التنقل بين الصفحات، وملء الن…969,165+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
رسوم متحركة هايبر فريمز
جميع المعارف المتعلقة بالرسوم المتحركة ل HyperFrames — قواعد الحركة الذرية، مخططات المشاهد متعددة المراحل، انتقالات المشاهد، تقنيات تصميم الحركة الأوس…943,098+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
نموذج أولي
أنشئ نموذجا أوليا مؤقتا للإجابة على سؤال تصميمي. استخدمه عندما يرغب المستخدم في التحقق مما إذا كان نموذج الحالة أو المنطق صحيحا، أو لاستكشاف الشكل الذ…853,069+
skillclaude_appclaude_codeclaude_api
npx skills add designed-by-ai/skills
تصميم تطبيقات الجوال
صمم شاشات تطبيقات الجوال باستخدام Sleek، وقم بتحرير مشاريع Sleek، وطبق تصميماتها في React Native أو HTML.700,496+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تصميم قاعدة الكود
مفردات مشتركة لتصميم الوحدات العميقة. تستخدم عندما يرغب المستخدم في تصميم أو تحسين واجهة وحدة نمطية، أو إيجاد فرص للتعميق، أو تحديد مكان الفصل، أو جعل…692,475+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في التصميم والإبداع