أداة فك ترميز Protocol Buffers

ما الذي يستطيع فك ترميز Protobuf بلا مخطط إثباته؟

تخزّن Protocol Buffers سلسلة من وسوم الحقول وقيمها، لا تصريحات ملف .proto الأصلية. يعرّف دليل ترميز protobuf الرسمي كل وسم بإزاحة رقم الحقل ثلاث بتات ثم دمجه مع نوع السلك، أي ما يكافئ field_number × 8 + wire_type. لذلك تستطيع الأداة إثبات رقم الحقل ونوع السلك وحدود البايتات والترميزات الممكنة بنيويًا. لكنها لا تستطيع الجزم بأن varint عُرّف على أنه uint64 أو int64 أو sint64 أو bool أو enum، لأن هذه التصريحات قد تشترك في البايتات نفسها.

يُختار وضع الإدخال دائمًا صراحة. يقبل hex المسافات البيضاء ASCII وبادئة 0x واحدة على الأكثر. ويُتحقق من Base64 وBase64URL كلٌ على حدة، بما في ذلك الطول والحشو وبتات الحشو غير المستخدمة، ولا يجوز خلط الأبجدية القياسية بالآمنة لعناوين URL. يعني النص الخام البايتات الدقيقة بترميز UTF-8 التي ينشئها TextEncoder في المتصفح، ولا تُفسّر تسلسلات الشرطة المائلة. أما الملف فيُقرأ ببايتاته الأصلية.

أنواع السلك والتفسيرات

لا يستطيع نوع العدد العادي في JavaScript تمثيل كل عدد صحيح من 64 بت بدقة. تستخدم الأداة BigInt في محلل السلك كله، وتحول الأعداد الدقيقة إلى سلاسل عشرية للعرض والتصدير. كما تصدّر القيم العائمة الخاصة مثل NaN واللانهاية والصفر السالب كسلاسل حتى لا يحولها JSON بصمت إلى قيمة أخرى.

فهم غموض القيم محددة الطول

يُستخدم نوع السلك 2 للسلاسل النصية والبايتات الخام والرسائل المضمّنة والقيم العددية المتكررة المضغوطة. ومن دون مخطط قد يصلح تسلسل بايتات واحد لعدة أدوار في آن واحد. فمثلًا، 2a 03 01 02 03 هو الحقل 5 ويحتوي ثلاثة بايتات. تصلح هذه البايتات كقيم varint مضغوطة [1, 2, 3]، لكنها تظل أيضًا بايتات عادية. تعرض الأداة الاحتمالين ولا ترجّح أحدهما.

لا يظهر احتمال الرسالة المتداخلة إلا إذا تحلّل جسم القيمة كاملًا كرسالة سليمة. وبالمثل، لا تظهر احتمالات varint أو fixed32 أو fixed64 المضغوطة إلا إذا استهلك التفسير جميع البايتات. ويتطلب احتمال UTF-8 الصارم فك التسلسل كاملًا من دون محارف استبدال. تكشف هذه الاختبارات الإمكانات البنيوية، لا نوع الحقل المصرح به.

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

الحدود والتأطير والتعامل الآمن

تقبل الأداة رسالة واحدة غير مؤطرة بحجم يصل إلى 10 MiB. ولا تفصل stream مسبوقًا بالطول أو إطار gRPC أو ملف رسائل محددة الطول أو غلاف نقل. أزل التأطير أولًا ثم فك رسالة واحدة. ويضع المحلل حدودًا لعدد السجلات وعمق التداخل والصفوف المرئية وعمل فحص الاحتمالات. تتماشى هذه الضوابط مع روح الإرشادات الرسمية حول مجموعات البيانات الكبيرة وحدود التنفيذ: protobuf فعّال، لكن تبويب التشخيص في المتصفح يحتاج أيضًا إلى حدود للذاكرة والعمل.

يجب أن تكون أرقام الحقول بين 1 و536,870,911. وتحذّر الأداة من النطاق 19,000–19,999 لأن الإرشاد الرسمي لأرقام الحقول يحجزه للتنفيذ. نوعا السلك 6 و7 غير صالحين.

تجري عملية التحليل والتصدير محليًا. قد يحتفظ العرض متعدد الخطوات بحمولة محدودة في sessionStorage لهذا التبويب لمدة تصل إلى ساعتين، ويؤدي البدء من جديد إلى حذفها. لا يوضع شيء في عنوان URL ولا يُرسل إلى الخادم. مخرج JSON هو صراحةً تقرير فك بالتنسيق الخاص بهذه الأداة، وليس ProtoJSON. يبدأ CSV بعلامة UTF-8 BOM وتُسبق الخلايا الشبيهة بالصيغ لتكون أكثر أمانًا عند فتحها في جداول البيانات. ومع ذلك قد تحتوي التقارير بيانات تطبيق سرية، لذا راجعها قبل مشاركتها.