مخطط الرابط لـ Chute iOS و Chute tvOS و Chute Mac و Chute Android

يدعم Chute iOS (من 1.0.2) و Chute tvOS الإجراءات التالية وخياراً واحداً.

ويسجّل Chute Mac المخطط chute نفسه، لكنه لا يجيب إلا على فعلين اثنين، install-config و import، بأي من صيغتي المضيف أو المسار: chute://import?url=... و chute:///install-config?url=.... ويجب أن تكون قيمة url= عنوان http أو https أو رابط مشاركة (ss:// و vmess:// …)؛ وما عدا ذلك يُرفض. ويطلب Chute Mac تأكيداً قبل أن ينزّل أي شيء، ثم يسلّم العنوان إلى تبويب Profiles في النافذة الرئيسية، الذي يستورده: فيُحفظ الإعداد الأصلي كـإعدادات مدارة بفاصل تحديث قدره 24 ساعة، ويُحوَّل إعداد Clash أو sing-box ويُحفظ لقطةً ثابتة، أما رابط المشاركة — أو الاشتراك الذي يعيد قائمة منها — فيُحوَّل إلى ملف إعدادات. أما start و stop و toggle و tv فليست إجراءات على Mac.

يتعامل Chute Android مع روابط الاستيراد الموصوفة في نهاية هذه الصفحة.

الإجراء:

• start | connect | on

  البدء بالإعدادات المختارة.

  مثال: chute://start chute:///start

• stop | disconnect | off

  إيقاف الجلسة الحالية.

• toggle | switch

  بدء أو إيقاف بالإعدادات المختارة.

• tv (Chute iOS فقط)

  فتح عرض استيراد الإعدادات عن بعد برابط الإعدادات المعطى. هذا الإجراء متاح فقط على Chute iOS؛ أما Chute tvOS فيتعامل مع start/stop/toggle فقط.

  وخلافاً لبقية الإجراءات، يُطابَق tv على المضيف وحده، فصيغة المسار chute:///tv?url=... لا تفعل شيئاً.

  مثال: chute://tv?url=https://example.com/chute.conf

الخيار:

• autoclose=true

  إغلاق Chute تلقائياً بعد اكتمال الإجراء. على Chute iOS فقط: أما Chute tvOS فيقبل المعامل ويتجاهله، ويبقى التطبيق مفتوحاً.

  مثال: chute:///toggle?autoclose=true

ملاحظة: على Chute iOS لا يُعالَج إلا أول رابط في كل تنشيط، فالاختصار الذي يسلّم Chute عدة روابط chute:// دفعةً واحدة ينفّذ واحداً منها فقط.

x-callback-url

يدعم Chute مواصفة x-callback-url. مخطط الرابط هو 'chute' والإجراءات المتاحة هي 'start' و 'stop' و 'toggle'.

ويجب أن يكون x-success و x-error محاطين بقوسين معقوصين مزدوجين {{ }}، تماماً كما في المثال أدناه. والقيمة المكتوبة بدونهما تُقرأ فارغة فلا يُفتح أي نداء راجع. أما x-cancel فغير متعامَل معه.

مثال: chute://x-callback-url/start?x-success={{ "{{sms://}}" }}&x-error={{ "{{tel://}}" }}

يُفتح x-success بمجرد أن يقلب Chute المفتاح. وهو يعني أن الطلب قد نُفِّذ، لا أن النفق قد قام: فالبدء الذي يفشل، أو طلب VPN الذي ترفضه، ينتهي كذلك بـ x-success. ولا يُفتح x-error إلا حين يجد start النفق عاملاً بالفعل أو يجد stop النفق متوقفاً بالفعل، وذلك بعد إغلاق التنبيه الذي يقول ذلك؛ أما toggle فلا يفتحه أبداً. ومع عدم اختيار أي إعدادات، لا يُفتح أيٌّ من النداءين.

Chute Android

يفتح Chute Android روابط chute:// (ورموز QR التي تحملها، ممسوحةً في صفحة Configurations أو في معالج الإعداد) للاستيراد فقط:

• chute://download?url=... (وكذلك import و install-config) — ينزّل الإعداد الموجود في url مرة واحدة. فالملف الأصلي يُحفظ بترويسة #!MANAGED-CONFIG <url> لا تحمل interval=، أما ملف Clash أو sing-box فيُحوَّل ويُحفظ لقطةً ثابتة بلا هذه الترويسة.
• chute://subscribe?url=... — اسم بديل لـ download، لا اشتراك. فهو يسلك مسار التنزيل لمرة واحدة نفسه، ولأن الملف الذي يكتبه بلا interval= فإن التطبيق لا يجدّده أبداً. غير أن المحرك العامل، إن كان الملف أصلياً، يعيد جلب الرابط كل 24 ساعة ويطبّق المحتوى الجديد في الذاكرة، ثم يقرأ البدء التالي الملف من جديد — انظر الإعدادات المدارة. ولكي يبقي Chute اشتراكاً محدَّثاً استخدم Add Subscription في التطبيق، وهو ما يسأل عن الفاصل الزمني.
• chute://tv?url=... (وكذلك remote) — يحمّل مستودع الإعدادات البعيد في url.

الإعداد الذي يضيفه رابط مفتوح من خارج التطبيق — منزَّلاً، أو مختاراً من المستودع الذي يفتحه رابط tv — لا يُختار: يفتح Chute صفحة Configurations وقد علّمه بـ Pending، ولا يصبح الإعداد العامل إلا حين تضغط Done، فرابط كهذا لا يبدّل أبداً الإعداد الذي يشغّله Chute.

والرابط المفتوح من خارج التطبيق يحوّل ملف Clash أو sing-box كما يفعل Download From URL في صفحة Configurations، وكذلك الرابط نفسه إذا مُسح هناك بـ Download From QR Code أو في معالج الإعداد. ولا يحتفظ بالملف الأصلي اشتراكاً إلا معالج الإعداد: فإذا مُسح الرابط فيه أعطى إعداداً يحدّثه التطبيق كل 86400 ثانية، بينما الرابط نفسه المفتوح من خارج التطبيق ينزّل الملف مرة واحدة ولا يحدّثه التطبيق أبداً.

start و stop و toggle ليست إجراءات رابط على Android. تستخدم تطبيقات الأتمتة Broadcast Intents بدلاً منها: com.r3studio.chute.action.START_VPN و com.r3studio.chute.action.STOP_VPN و com.r3studio.chute.action.TOGGLE_VPN.

ولا يستطيع البث إظهار حوار موافقة VPN في النظام. ولذلك يُسقَط START_VPN بصمت ما لم تكن الموافقة قد مُنحت بعد، بينما يفتح TOGGLE_VPN تطبيق Chute بدلاً من ذلك: اضغط المفتاح هناك لمنح الموافقة — وهذه الضغطة تبدأ النفق أيضاً — ثم تعمل عمليات البث بعد ذلك. أما في وضع الخدمة Local Proxy فلا موافقة تُمنَح أصلاً، ويعمل كلاهما فوراً.