دليل تكوين UA Pro

استيراد التكوين وتصديره والتكوين البعيد

نسخ التكوين احتياطيًا ونقله وكتابته يدويًا وتحميله من عنوان بعيد.

الإصدار المعني: UA Pro 1.5.0

ينطبق هذا الدليل على UA Pro 1.5.0 ويشرح نسخ التكوين احتياطيًا ونقله وكتابته يدويًا وتحميله من عنوان بعيد. يستخدم الإصدار الجديد تنسيق لقطة كاملة، وقيمة version في ملف التكوين هي 2.

قبل الاستيراد، صدّر نسخة احتياطية من المتصفح الهدف. يستبدل كل استيراد القاعدة العامة ومجموعة قواعد النطاق كاملة ومكتبتي UA ومفتاح الرجوع إلى نطاق المورد باللقطة الكاملة في الملف، دون دمج العناصر واحدًا واحدًا. تعني "globalRule": null مسح القاعدة العامة في المتصفح الهدف.

01تصدير التكوين

  1. انقر أيقونة UA Pro في شريط أدوات المتصفح.
  2. افتح «المزيد» ← «استيراد/تصدير التكوين».
  3. انقر «تصدير التكوين» واحفظ ملف .json الذي نُزّل.
  4. يكون اسم الملف مثل ua-switcher-config-2026-11-16.json. يُنشأ التاريخ في الاسم بتوقيت UTC وقد يختلف يومًا عن التاريخ المحلي.

يحتوي الملف على التكوينات المحفوظة التالية:

  • القاعدة العامة وحالة تمكينها أو إيقافها مؤقتًا.
  • مجموعة قواعد النطاق كاملة وحالة تمكين كل قاعدة أو إيقافها مؤقتًا.
  • فئات UA المخصص وعناصرها.
  • فئات النص الملحق وعناصرها.
  • مفتاح «الرجوع إلى نطاق المورد».

لا يحتوي الملف على قواعد علامات التبويب أو ارتباطات UA العشوائي التي اختيرت سابقًا أو علامات التبويب المفتوحة حاليًا أو لغة الواجهة أو السمة أو إعدادات الطبقة العائمة. لا تُستعاد هذه العناصر من النسخة الاحتياطية بعد الاستيراد؛ كما لا يمسح الاستيراد قواعد علامات التبويب الموجودة في المتصفح الهدف، ولذلك قد تستمر في تجاوز قواعد النطاق أو القاعدة العامة.

ملف التصدير نص JSON واضح قابل للقراءة. إذا احتوى UA مخصص أو تصنيف على معلومات لا تريد نشرها فاحتفظ بالنسخة الاحتياطية بأمان.

02الاستيراد من ملف محلي

  1. في المتصفح الهدف، افتح UA Pro ← «المزيد» ← «استيراد/تصدير التكوين».
  2. انقر أولًا «تصدير التكوين» للاحتفاظ بتكوين المتصفح الهدف الأصلي واستعادته عند الحاجة.
  3. انقر «استيراد التكوين» واختر ملف .json.
  4. اقرأ تنبيه الاستبدال وأعداد القواعد والقوائم؛ انقر «عرض محتوى الإعدادات» لفحص JSON كاملًا قبل التأكيد. لا تُكتب البيانات عند اختيار «إلغاء». بعد التأكيد انتظر رسالة «تم استيراد التكوين!». إذا تغيرت الإعدادات أثناء التأكيد فستطلب الإضافة إعادة العملية.
  5. افحص القاعدة العامة وقواعد النطاق والقوائم المخصصة ومفتاح الرجوع إلى نطاق المورد؛ وتحقق مما إذا كانت قواعد علامات تبويب موجودة تتجاوزها. حدّث صفحة الويب المراد اختبارها ثم تحقق من UA.

تفحص الإضافة الملف أولًا، ثم تحاول تثبيت القواعد، وأخيرًا تكتب التكوين الدائم. إذا فشل التثبيت أو الكتابة فستحاول استعادة القواعد المحفوظة حاليًا في المتصفح؛ وإذا ظهر تعذر الاستعادة فافحص الإعدادات الفعلية. عند تعديل التكوين بالتزامن بواسطة مزامنة المتصفح أو نافذة أخرى، لا ينبغي اعتبار هذه العملية معاملة عبر الأجهزة.

03التحميل من عنوان بعيد

يستخدم التكوين البعيد محتوى JSON نفسه المستخدم في النسخة الاحتياطية المحلية. هذا تحميل واستيراد يدوي لمرة واحدة، وليس اشتراكًا يتحدث تلقائيًا.

  1. صدّر نسخة احتياطية للتكوين أولًا أو أعد ملف JSON وفقًا لما يلي.
  2. ضع الملف على خدمة HTTPS يمكن للمتصفح الهدف الوصول إليها، واحصل على العنوان الكامل الذي يعيد محتوى JSON مباشرة، مثل https://example.com/ua-pro/config.json. هذا العنوان مثال فقط؛ استبدله بعنوانك الفعلي.
  3. في ⁨UA Pro⁩، افتح «المزيد» ثم «استيراد/تصدير التكوين»، ووسّع «تكوين بعيد»، ثم الصق العنوان وانقر على «تحميل».
  4. بعد نجاح التحميل وفحص التنسيق، تعرض الإضافة مربع تأكيد واسم المضيف البعيد؛ انقر «عرض محتوى الإعدادات» لفحص JSON الكامل الذي نُزّل فعليًا. يؤدي التأكيد إلى تحديث الإعدادات وفق القواعد نفسها للاستيراد المحلي؛ ولا يستورد الإلغاء شيئًا.
  5. بعد تغيير الملف على الخادم، يلزم إدخال العنوان مجددًا وتحميله وتأكيده لاستخدام المحتوى الجديد. لا يُحتفظ بالعنوان تلقائيًا عند إعادة فتح اللوحة.

لا تُقبل إلا روابط HTTPS المباشرة؛ لا يُقبل HTTP أو اسم مستخدم أو كلمة مرور في العنوان أو جزء عنوان URL، ولا تُتبع عمليات إعادة التوجيه. لا يحمل الطلب Cookie المتصفح أو بيانات اعتماد تسجيل الدخول، ولا يرسل Referer، ويتجاوز ذاكرة التخزين المؤقت؛ لذلك لا تناسبه الخدمات التي تتطلب Cookie لتسجيل الدخول. لا يطبق UA Pro قواعد UA المضبوطة في هذه الإضافة على الطلب، لكن قد تعدله إضافات أخرى أو أجهزة الشبكة. يمكن أن يتضمن العنوان معاملات استعلام؛ احفظ العنوان المحتوي على رمز وصول كما تحفظ كلمة المرور. استخدم عنوانًا موثوقًا وتأكد من أن الاستجابة ملف JSON مباشرة، لا صفحة تسجيل دخول أو صفحة HTML تعرض الشيفرة.

يقتصر كل من الملف المحلي والاستجابة البعيدة على 128 KiB؛ وتقتصر القراءة البعيدة على 10 ثوانٍ ويُحسب المحتوى المقروء فعليًا. توجد حصة أصغر لكل عنصر في التخزين المتزامن للمتصفح، لذا قد يتعذر الحفظ حتى إن لم يتجاوز الملف 128 KiB إذا كانت القواعد أو مكتبة واحدة كبيرة جدًا. عند حدوث خطأ، تحقق من أن الخادم يعيد الحالة 200 وJSON صالحًا، وأن الشهادة صالحة، وأن العنوان لا يعيد التوجيه، وأن الشبكة قابلة للوصول.

04مثال JSON كامل

يمكن حفظ المثال التالي باسم config.json بترميز UTF-8. نطاقات المثال وقيم UA للتوضيح فقط؛ انسخ التكوين الحالي احتياطيًا قبل الاستبدال. يميز JSON بين الأحرف الكبيرة والصغيرة؛ استخدم علامتي اقتباس مزدوجتين من ASCII للسلاسل، ولا تضع فاصلة بعد العنصر الأخير أو تعليقات داخل JSON.

JSON
{
  "version": 2,
  "type": "ua-switcher-config",
  "timestamp": "2026-11-16T06:00:00.000Z",
  "data": {
    "globalRule": {
      "enabled": true,
      "mode": "builtin",
      "params": {
        "os": "Windows",
        "uaKey": "Edge 125 (Latest)"
      }
    },
    "domainRules": {
      "example.com": {
        "enabled": true,
        "mode": "custom",
        "params": {
          "category": "手机示例",
          "value": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1"
        }
      },
      "app.example.com": {
        "enabled": true,
        "mode": "append",
        "params": {
          "category": "测试标记",
          "value": "MyApp/1.0"
        }
      },
      "random.example.com": {
        "enabled": true,
        "mode": "random",
        "params": {
          "pool": "custom:随机示例",
          "strategy": "page"
        }
      },
      "paused.example.com": {
        "enabled": false,
        "mode": "custom",
        "params": {
          "category": "测试",
          "value": "ExampleAgent/1.0"
        }
      }
    },
    "userCustomData": {
      "手机示例": [
        "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1"
      ],
      "随机示例": [
        "ExampleAgent/1.0",
        "ExampleAgent/2.0"
      ],
      "测试": [
        "ExampleAgent/1.0"
      ]
    },
    "userAppendData": {
      "测试标记": [
        "MyApp/1.0"
      ]
    },
    "resourceDomainFallback": false
  }
}

يعيّن المثال UA عامًا مدمجًا واحدًا وأربع قواعد نطاق. تتقدم قواعد النطاق الفرعي الأكثر تحديدًا مثل app.example.com على example.com؛ ولا تشارك القواعد الموقوفة مؤقتًا في المطابقة الفعالة، وقد تحل محلها قاعدة النطاق الأصل أو القاعدة العامة. يعتمد تعرف الموقع الفعلي على UA المثال على الموقع نفسه.

05حقول المستوى الأعلى وسلوك الاستبدال

الحقل مثال الوظيفة
version 2 مطلوب. لا يقبل الإصدار الجديد إلا الرقم 2.
type "ua-switcher-config" مطلوب. معرّف نوع التكوين ويجب أن يطابق هذه السلسلة تمامًا.
timestamp "2026-11-16T06:00:00.000Z" مطلوب. استخدم وقت UTC مع أجزاء الثانية بالألف وZ؛ للتسجيل فقط ولا يحدد وقت سريان القاعدة.
data { ... } مطلوب. كائن يخزن التكوين الكامل ويتضمن كل حقول الجدول التالي.
الحقول في data التنسيق الصحيح السلوك عند الاستيراد في هذا الإصدار
globalRule كائن قاعدة واحد أو null يستبدل كائن القاعدة القاعدة العامة الحالية؛ وتمسح null القاعدة العامة الحالية.
domainRules { "域名": 规则对象 } يستبدل الكائن كاملًا قواعد النطاق السابقة؛ وتمسحها {} كلها.
userCustomData { "分类": ["UA", ...] } يستبدل الكائن كاملًا مكتبة UA المخصص السابقة؛ وتفرغها {}.
userAppendData { "分类": ["追加文本", ...] } يستبدل الكائن كاملًا مكتبة النص الملحق السابقة؛ وتفرغها {}.
resourceDomainFallback true أو false قيمة JSON منطقية: تشغيل الرجوع إلى نطاق المورد أو إيقافه.

الحقول الخمسة كلها مطلوبة، ولا يجوز استخدام null إلا في globalRule. تُرفض الحقول المفقودة أو المجهولة ومفاتيح JSON المكررة؛ ولا تُستورد التكوينات القديمة أو الجزئية. تُستبدل قواعد النطاق وكل من المكتبتين كمجموعة كاملة: مثلًا سيستبدل domainRules الذي يحتوي على نطاق واحد قواعد النطاق الأخرى الموجودة في المتصفح الهدف. يُنصح بالتحرير انطلاقًا من ملف مصدّر فعليًا من الإصدار الجديد والاحتفاظ بكل العناصر المطلوبة.

لا يمكن تطبيق قاعدة الرجوع إلى نطاق المورد حسب نطاق وجهة طلب المورد إلا عندما لا يكون للصفحة الرئيسية UA فعال على مستوى علامة التبويب أو النطاق أو العمومي؛ ولا يعني ذلك أن جميع الموارد عبر النطاقات تتجاوز قاعدة الصفحة الرئيسية.

06كيفية كتابة كائن القاعدة

تستخدم القاعدة العامة وكل قاعدة نطاق البنية نفسها:

JSON
{
  "enabled": true,
  "mode": "custom",
  "params": {
    "category": "常用",
    "value": "ExampleAgent/1.0"
  }
}

تعني enabled: true التمكين وfalse الإيقاف المؤقت. تحدد mode حقول params:

6.1 UA مدمج: builtin

JSON
{
  "enabled": true,
  "mode": "builtin",
  "params": { "os": "Windows", "uaKey": "Edge 125 (Latest)" }
}

يجب أن تطابق os وuaKey تمامًا المفاتيح المضبوطة مسبقًا داخل إصدار الإضافة، وقد لا تطابق النص المترجم الظاهر في الواجهة. الطريقة الأكثر موثوقية هي اختيار الإعداد المسبق في الواجهة وتصدير التكوين ثم نسخ params المقابل. أعد التحقق عند تغير قائمة الإعدادات المسبقة بين الإصدارات.

6.2 UA مخصص: custom

JSON
{
  "enabled": true,
  "mode": "custom",
  "params": { "category": "常用", "value": "ExampleAgent/1.0" }
}

value هي سلسلة UA الكاملة. تُستخدم category للتصنيف والتحرير في الواجهة؛ ويُنصح بتضمين القيمة أيضًا في الفئة ذات الاسم نفسه في userCustomData. عند سريان القاعدة تُقرأ value الخاصة بها؛ ولا يضيف استيراد القاعدة يدويًا هذه القيمة تلقائيًا إلى المكتبة المخصصة.

6.3 نص ملحق: append

JSON
{
  "enabled": true,
  "mode": "append",
  "params": { "category": "应用标记", "value": "MyApp/1.0" }
}

تضيف الإضافة مسافة بعد UA الأصلي للمتصفح الحالي ثم تلحق value. يُنصح بالاحتفاظ بالنص أيضًا في الفئة ذات الاسم نفسه في userAppendData؛ ولا يملأ استيراد القاعدة القائمة تلقائيًا.

6.4 UA عشوائي: random

JSON
{
  "enabled": true,
  "mode": "random",
  "params": { "pool": "custom:随机示例", "strategy": "page" }
}

يجب أن تكون strategy إما "page" (اختيار عند كل تحميل كامل للصفحة) أو "tab" (الاحتفاظ حسب القاعدة وعلامة التبويب). يسمح الاختيار العشوائي بالتكرار، لذا لا يعني تطابق نتيجتين متتاليتين بالضرورة عدم إعادة الاختيار.

قيم pool الشائعة:

القيمة مصدر الاختيار العشوائي
all كل UA المدمج والمخصص وUA الناتج من النص الملحق
builtin كل UA المدمج
builtin_desktop، builtin_mobile، builtin_legacy فئات سطح المكتب أو المحمول أو الأجهزة القديمة المدمجة
builtin_gaming، builtin_smarttv، builtin_communication، builtin_social الفئات المدمجة المقابلة
custom UA في جميع الفئات المخصصة
custom:分类名 UA في الفئة المحددة داخل userCustomData
append_all UA المقابل لجميع النصوص الملحقة
append:分类名 UA المقابل للنص الملحق في الفئة المحددة داخل userAppendData

يجب أن يطابق اسم الفئة بعد النقطتين المفتاح في المكتبة. يجب أن تتوفر خيارات لقاعدة عشوائية مفعلة وإلا رُفض الملف.

07التحقق عند التحرير اليدوي

  • اكتب نطاقًا كمفتاح لـ domainRules، مثل example.com وshop.example.com، ولا تكتب https:// أو مسارًا أو منفذًا أو مسافة. تطابق قواعد النطاق النطاقات الفرعية أيضًا؛ وفي الإصدار الحالي تشمل *.example.com النطاق example.com نفسه، وليست للنطاقات الفرعية فقط.
  • يمكن استخدام الصينية في اسم الفئة، ويجب أن يكون سلسلة غير فارغة وألا يحتوي على محارف تحكم أو محارف تحكم خطرة للنص ثنائي الاتجاه؛ ولا يمكن استخدام __proto__ أو prototype أو constructor اسمًا للفئة. يُنصح باستخدام محارف ASCII قابلة للطباعة في UA والنص الملحق؛ لا تُضمّن أسطرًا جديدة أو علامات جدولة أو محارف تحكم أخرى؛ والحد الأقصى لكل UA هو 4096 محرفًا. يجب تهريب علامتي الاقتباس المزدوجتين من ASCII والشرطة المائلة العكسية في النص وفق قواعد JSON.
  • تقابل كل فئة مصفوفة سلاسل، مثل "常用": ["Agent/1.0", "Agent/2.0"]. احتفظ بالقوسين المربعين حتى مع عنصر واحد. يمكن كتابة فئة فارغة بالشكل [].
  • لا توضع true وfalse وnull بين علامتي اقتباس مزدوجتين؛ فـ "false" سلسلة وليست قيمة منطقية.
  • يجب أن يكون الملف UTF-8 وJSON صالحين، ولا تُسمح المفاتيح المكررة. تفحص الإضافة أيضًا البنية وأنواع الحقول والقواعد وأسماء الإعدادات المسبقة ومجموعة الاختيار العشوائي؛ ولا تضمن صحة البنية النحوية صلاحية القاعدة للاستخدام.

يمكن لملف التكوين تغيير UA الذي يرسله المتصفح إلى المواقع. يحمي HTTPS النقل لكنه لا يضمن أن التكوين الذي يقدمه الخادم يوافق رغبتك؛ استورد ملفات من مصادر موثوقة فقط، وافحص المحتوى قبل التأكيد، وتحقق من النتيجة الفعلية بعد تحديث الصفحة الهدف.

08الأسئلة الشائعة

المشكلة طريقة التحقق
ظهور رسالة بأن تنسيق الملف غير صحيح تحقق من UTF-8 وبنية JSON والمفاتيح المكررة والإصدار والحقول المطلوبة ونوع القاعدة؛ واستخدم ملف تصدير من الإصدار الجديد قالبًا.
فشل التحميل البعيد تحقق من شهادة HTTPS والرابط المباشر والشبكة والمحتوى المُعاد؛ لا يُسمح بإعادة التوجيه أو تسجيل الدخول باستخدام Cookie أو HTTP.
انخفاض عدد القواعد بعد الاستيراد تُستبدل قواعد النطاق وكل مكتبة من المكتبتين كاملة؛ استعد النسخة الاحتياطية السابقة للاستيراد أو أضف العناصر المطلوب الاحتفاظ بها إلى الملف الجديد.
استُوردت قاعدة عامة فارغة لكن الصفحة لا تزال تستخدم UA آخر تحقق من قواعد علامات التبويب الموجودة أو قواعد النطاق المطابقة؛ فقد تتقدم على القاعدة العامة.
ظهور النجاح مع UA غير صحيح تحقق من تمكين القاعدة وصلاحية محتواها وتوفر عناصر في المجموعة العشوائية ووجود قواعد علامة تبويب أو نطاق أعلى أولوية، ثم حدّث الصفحة.
خطأ تخزين عند استيراد بيانات كثيرة لكل من الملف وتخزين مزامنة المتصفح حد للحجم؛ قلل القواعد أو القوائم ثم أعد المحاولة وافحص التكوين الحالي.
لا تتغير الإضافة بعد تعديل الملف البعيد التحميل البعيد استيراد يدوي لمرة واحدة؛ أدخل العنوان مجددًا ثم حمّله وأكد العملية.