قبل أن تثبّت حزمة Boosthis
تعمل حزمة Boosthis داخل تطبيقك وعمليتك وعلى نطاقك. ذلك قدر كبير من الثقة لا يكفي أن تطلبه صفحة README، لذا تجيب هذه الصفحة عن الأسئلة التي يقوم عليها التقييم فعلًا دفعة واحدة.
كل إجابة أدناه مستمدة من المصدر نفسه الذي تقرؤه الحزم وأدلة التثبيت، وتفشل فحوص بنائنا إن لم تعد إحداها مطابقة له. لا شيء هنا وصف منفصل للمنتج.
- ماذا ترسل، وما الذي يعمل دائمًا؟
- ماذا تستطيع أن تقرأ داخل عمليتي؟
- ما الذي يظهر على صفحات مستخدميّ؟
- ماذا تضع على نطاقي؟
- بماذا يجب أن تسمح سياسة Content-Security-Policy لديّ؟
- أي مفتاح تحتاج إليه، وماذا يحدث إن تسرّب؟
- كيف أعرف أن البايتات التي تلقيتها منكم؟
- ما أول اتصال بالشبكة، ومتى يحدث؟
ماذا ترسل، وما الذي يعمل دائمًا؟
كل ما يلي يصل إلى مكان واحد: https://www.boosthis.com/api. التثبيت الذي لم يُضبط له مفتاح مشروع لا يرسل شيئًا.
يرسله كل تثبيت مسجّل في كل بيئة تشغيل
- معرّف تثبيت عشوائي. معرّف UUIDv4 عشوائي يُنشأ على الجهاز الذي يعمل عليه تطبيقك عند تسجيله أول مرة. لا يُصنع من أي شيء عن مستخدميك أو أجهزتهم، ولا من عنوان IP أو اسم مضيف. ويربطه Boosthis بمفتاح المشروع الذي سُجّل به، ومن ثمّ بالحساب الذي يملك ذلك المفتاح: بهذا الربط تعرض لك لوحتك وتنبيهاتك واتصالات الذكاء الاصطناعي تثبيتاتك أنت.
- فئات تصف مشكلة أداء متكررة. عندما يتكرر نمط أداء واحد، ترسل الحزمة نوع المشكلة التي رصدتها وفئة شدتها ذات المستويات الثلاثة وفئة تقريبية لعدد مرات حدوثها. لا يدخل اسم الشاشة أو المسار في هذا التوقيع. وترسله حزمتا Node والمتصفح بجانب التوقيع: يذكر كل إرسال منهما أين رُصدت المشكلة آخر مرة — تسمية المسار أو الشاشة المعرّفة في الشيفرة، بعد مرورها بحارس المعرّفات نفسه الذي تمر به كل تسمية، أو سببًا من قائمة ثابتة حيث لا يمكن تسمية شيء (لم تكن أي شاشة أو مسار مفتوحًا، أو لا تتتبعها الحزمة هناك، أو رُفضت التسمية). ولا ترسل الحزم الأخرى مع التوقيع مكانًا كهذا؛ ولا تذكر قياسات الاستدعاءات التي ترسلها حزمة React Native ابتداءً من 1.0.0-alpha.342 الشاشاتِ إلا لعدّ الاستدعاءات التي أجرتها كل شاشة.
- فئات تصف تحسّن إحدى تلك المشكلات. عندما تتحسن مشكلة متتبَّعة، ترسل الحزمة القاعدة ونوعها، وفئة التقييم قبل التحسن وبعده — جيد أو يحتاج إلى تحسين أو ضعيف — وعدد مرات رصدها، وفئتي الشدة والعدد اللتين ثبت التحسن عليهما. إنها ترسل حقيقة التحسن، لا التغيير الذي حققه: لا شيفرة مصدرية ولا فرق تعديلات ولا مسار ملف ولا اسم شاشة ولا مدة ولا قيمة.
- أنواع الأخطاء مع موضع شيفرة منقّح. عندما يقع خطأ غير معالَج في تطبيقك، ترسل الحزمة نوعه وموضعًا منقّحًا في الشيفرة (اسم الدالة واسم الملف دون مساره ورقم السطر — لا مسارًا أو URL أو وسيطًا أو قيمة)، وبصمة مشتقة فقط من هذه العناصر المعرّفة في الشيفرة، وعدد مرات تكراره. ويذكر كل تقرير عطل أيضًا، دائمًا لا في وضع الأعطال التفصيلي وحده، أين وقع في تطبيقك: تسمية الشاشة أو المسار الذي كان مفتوحًا كما عُرّفت في الشيفرة، بعد مرورها بحارس المعرّفات نفسه الذي تمر به كل تسمية، أو سببًا من قائمة ثابتة حيث لا يمكن تسمية شيء (لم تكن أي شاشة أو مسار مفتوحًا، أو لا تتتبعها الحزمة هناك، أو رُفضت التسمية). وإذا وقع العطل في منتصف إجراء كانت الحزمة تتتبعه، حمل أيضًا مرجع تتبع ذلك الإجراء: معرّف التتبع المؤلف من 32 خانة، ومعرّف الخطوة الجارية المؤلف من 16 خانة حيث وُجدت. وقد تذكر الحزمة أيضًا وقت وقوع كل عطل؛ ولا يحتفظ Boosthis بذلك الوقت إلا إذا كان معقولًا، وإلا أرّخ العطل بوقت وصوله. وعلى Android 11 وما بعده وiOS 15 وما بعده، تقرأ الحزمة أيضًا سجل نظام التشغيل نفسه عن تعطّل أصلي أو إنهاء بسبب «التطبيق لا يستجيب» عند التشغيل التالي، ولا ترسل سوى أيّهما كان، واسم الإشارة أو نوع الاستثناء، وعنصرًا نائبًا ثابتًا مكان موضع الشيفرة، ووقت حدوثه — لا وصف النظام، ولا أسماء العمليات أو الخيوط، ولا المكدس الأصلي. ولا ترسل حزم الهاتف والمتصفح خطأً التقطه تطبيقك ونجا منه على أنه تعطّل. وتقرر حزمة المتصفح على جهاز الزائر، قبل قصّ أي عنوان، هل جاء الخطأ من إضافة متصفح وحدها، وتتعرف على تنبيهات ResizeObserver الصادرة عن المتصفح نفسه؛ ولا يُرسل أيّ منهما على أنه تعطّل. ولا ترسل منهما إلا عددين — كم استبعدت من كلٍّ منهما في نافذة الأعطال — ولا ترسل أبدًا معرّف إضافة أو اسمها أو ملفها. والخطأ الذي أخفى المتصفح تفاصيله لأن نصه البرمجي جاء من عنوان آخر يُرسل مع ذلك على أنه تعطّل، تحت نوع بديل ثابت. والعطل الذي يتعذر إرساله فورًا ينتظر على الجهاز: تحتفظ حزم React Native وFlutter وAndroid وApple بالعطل غير المرسل في تخزين التطبيق نفسه، وتعرضه مجددًا عند كل تشغيل لاحق، وتسقطه دون إرسال حين يبلغ عمره 30 يومًا؛ وتحتفظ حزمة المتصفح بواحد في التخزين المحلي للموقع، يُعاد إرساله ويُسقط بعد 30 يومًا، إلى جانب سجل أعطال قصير — لكل مرة فُتح فيها الموقع خلال آخر 24 ساعة، بحد أقصى 32 مرة: متى بدأت ومتى استُخدم الموقع آخر مرة، وأوقات أعطالها، وعدد الأخطاء الصادرة عن إضافات المتصفح التي استُبعدت — أوقات وأعداد فقط، ويُسقط كل منها بعد 24 ساعة. وابتداءً من حزمة React Native 1.0.0-alpha.342، يحمل كل تقرير تعطّل من الهاتف أيضًا كلمة من قائمة ثابتة لنوع الخطأ (قراءة قيمة من شيء غير موجود؛ استخدام اسم غير معرّف أو غير جاهز بعد؛ استدعاء شيء ليس دالة؛ قيمة من نوع خاطئ؛ فشل طلب ولم تلتقطه الشيفرة؛ تعذّر قراءة البيانات؛ أو نوع غير معروف)، تقرّرها الحزمة على الهاتف من صياغة الخطأ، وتبقى الصياغة هناك؛ وفي الأنواع الثلاثة الأولى، كلمة تبيّن ما إذا كان محرك JavaScript قد طبع اسمًا من شيفرة التطبيق. أما الاسم نفسه فلا يُرسل إلا في وضع الأعطال التفصيلي، لأن الهاتف لا يستطيع إثبات أن المحرك هو الذي كتب الصياغة لا التطبيق، ثم لا يُرسل إلا حين نسخه المحرك كما كُتب في الشيفرة واجتاز قاعدة الهيئة نفسها والفحصين نفسيهما المطبّقين على اسم الشيفرة في المواقع؛ وإلا أفادت الكلمة بأن الاسم حُجب أو لم يُطبع. ويحصي Boosthis تقارير كل تعطّل في الهاتف بحسب الشاشة، مع إبقاء أكبر اثني عشر عددًا، وبحسب فئة نظام الهاتف وإصداره، وفي Android بحسب الشركة المصنّعة، كما أبلغت عنها عملية التثبيت المرسلة أصلًا؛ ولا يُرسل لذلك شيء إضافي عن الهاتف.
- من أين جاء العطل بعد إطاره الأعلى. قد يذكر تقرير العطل أيضًا أن الخطأ وصل دون أي مكدّس؛ والجزء من إطار العمل الذي التقطه، بكلمة من قائمة ثابتة (يُرسل الجزء الذي لا تعرفه الحزمة بالكلمة other)؛ وفي بناء Flutter التطويري أو بناء قياس الأداء، اسم الملف الأخير ورقم السطر للعنصر الذي سمّاه إطار العمل سببًا؛ وأول إطار في شيفرة تطبيقك نفسه، بالشكل نفسه من اسم الدالة واسم الملف الأخير ورقم السطر، عندما يكون الإطار الأعلى في إطار العمل أو في حزمة تطوير اللغة أو في حزمة أخرى؛ وأنه جاء من بناء تطويري. يُحدَّد على الجهاز أيّ الحزم تخص تطبيقك، ولا تُرسل تلك القائمة أبدًا. لا يُرسل وصف العنصر ولا مسار ولا وسيط ولا قيمة أبدًا.
- بصمة مؤقتة لدفعة الأعطال. ترسل الحزمة الحالية بصمة غير مقروءة لكل دفعة أعطال، كي لا تكرر إعادة المحاولة بعد فقد الاستجابة تسجيل الوقائع. هذه بيانات لمنع التكرار لا سجل أعطال العميل: لا تدخل في صادراته، ويُحتفظ بها 30 يومًا على الأكثر و1,024 إيصالًا لكل تثبيت، وتُمحى مع التثبيت.
- ملاحظات مجهولة عن أنماط لا نملك قاعدة لها بعد. عندما تصادف الحزمة نمطًا بطيئًا أو معيبًا بلا قاعدة، قد ترسل بيئة التشغيل وفئة تقريبية وفئة شدة وفئة زمنية وبصمة وعدد التكرارات. فئات وبصمة فقط، لا اسم شاشة أو قيمة أو شيفرتك.
- إصدار الحزمة وبيئة تشغيلها. مثلًا، إصدار حزمة Boosthis مع بيئة تشغيل لغة البرمجة، لتفسير القراءة وفق الإصدار الذي أخذها.
- أين يعمل الخادم. عندما تسجّل حزمة خادم، ترسل منصة الاستضافة التي تعرّفت عليها من العلامات التي تنشرها تلك المنصة عن نفسها، بكلمة من قائمة ثابتة؛ ورمز المنطقة الذي تعلنه المنصة، مثل us-east-1، كما كتبته المنصة؛ وهل هذه بيئة إنتاج أو معاينة أو تطوير — أو غير معروفة حيث لا تذكر المنصة ذلك. بهذا لا تُعرض أرقام المعاينة على أنها أرقام تطبيقك الحي. ولا ترسل أبدًا اسم مضيف أو عنوانًا أو أي قيمة أخرى تُقرأ من الجهاز.
- رموز أحادية الاتجاه لأسماء خوادمك. ابتداءً من حزمة Node 1.0.0-alpha.230، وحزمة Python 1.0.0a191، وحزمتي Java وGo 1.0.0a163، وحزمة PHP 1.0.103، وحزمة .NET 1.0.109، وحزمة Ruby 1.0.0a103، وحزمة Rust 1.0.0a98، وحزمة Elixir 1.0.0a96، وحزمة الحافة 1.0.0-alpha.43، ترسل حزمة الخادم مع عملية التحقق التي تجريها أصلًا رمزًا أحادي الاتجاه لكل اسم من أكثر 8 أسماء وُجّهت إليها الطلبات التي أجاب عنها — ترويسة Host في الطلب نفسه، أو اسمًا مرّره وكيل، لا يُقرأ إلا عند العمق المضبوط في BOOSTHIS_FORWARDED_HOST_HOPS — ولا ترسل الاسم نفسه أبدًا. ولا تحتفظ حزمة PHP بأي اسم إطلاقًا، بل بكل رمز وعدد الطلبات التي أجاب عنها الخادم تحت اسمه فقط، في حالتها الخاصة على خادمك؛ وحزمة الحافة، التي لا تجري عملية تحقق، ترسل الرموز مع عمليات الرفع التي تجريها أصلًا. ويُصنع الرمز بمفتاح يُستخرج لحسابك ولا يُخزَّن أبدًا، فلا يكشف الرمز وحده عن الاسم. ولا تسلّم Boosthis الرموز إلا إلى تثبيتات الهاتف التابعة للمشروع نفسه وللمالك نفسه، لتكتب حزمة React Native ترويسة التتبع إلى خوادمك أنت؛ وتحتفظ بها حتى مرور 7 أيام على آخر تقرير من الخادم، وتحذفها مع التثبيت وعند إغلاق الحساب.
- إصدار تطبيقك. على الهاتف، تقرأ الحزمة إصدار بناء تطبيقك — CFBundleShortVersionString على iOS وversionName على Android — وترسله بجانب إصدار Boosthis لا مدمجًا معه. ترسل سلسلة الإصدار التي تنشرها فقط، لا محتوى البناء أو هوية توقيعه أو رقم بنائه أو معلومات الجهاز.
- الإصدارات التي يعلنها مشروعك. عندما يُطرح إصدار من تطبيقك، يستطيع تطبيقك أو نص نشر أو خطوة بناء، أو أنت من لوحتك، إبلاغ Boosthis بذلك من أي بيئة تشغيل: نص الإصدار كما أُعطي (60 حرفًا على الأكثر، ويُفحص كأي اسم آخر)، ووقت طرحه، وطريقة إعلانه — باعتماد التثبيت نفسه، أو من اللوحة، أو بقراءته من بناء هاتف، أو بتسليم تطبيقك إياه للحزمة — ووقت أول إعلان وآخره. وإعلان الإصدار نفسه مرة أخرى لا يغيّر إلا وقت الإعلان الأخير، ولا يحمل التثبيت أكثر من 200 إصدار. ولا شيء عمّا يحتويه الإصدار. ويستطيع المطور سحب أي منها، وتُحذف كلها عند محو المشروع أو إغلاق الحساب.
- أسماء المهام المجدولة ونتيجة كل تشغيل. إذا نفذ تطبيقك مهامًا مجدولة، ترسل الحزمة اسم المهمة كما ورد في شيفرتك، ومدة كل تشغيل ونجاحه، وعدد مرات التشغيل المتوقع إن حددته شيفرتك. لا ترسل وسيطًا أو محتوى أو نتيجة أو سطر سجل أو شيئًا تعاملت معه المهمة.
يتوقف على إعدادك أو حزمتك أو إصدارها
- إذا كان تطبيقك يستخدم حزمة الموقع. اختيار حزمة الموقع يرسل افتراضيًا نوع الخطأ وصاحب الشيفرة واسم شيفرة اجتاز الفحص أو سبب غيابه واسم الخدمة وموضعًا مختزلًا حتى دون مكدس، مع أعداد بحسب المتصفح والشاشة أو المسار. لا يتطلب وضع التقارير التفصيلية. تحقق من استخدام موقعك حزمة الموقع، بوسم البرنامج المستضاف أو حزمة المتصفح، ومن إصدارها في صفحة المشروع. تُرسل حقائق سبب تعطّل الموقع افتراضيًا مع كل تقرير تعطّل: كلمة من قائمة ثابتة لنوع الخطأ — قراءة قيمة من لا شيء؛ استخدام اسم غير معرّف أو غير جاهز بعد؛ استدعاء شيء ليس دالة؛ فشل طلب دون معالجة الخطأ؛ تعذّر قراءة البيانات؛ فشل تحميل ملف شيفرة من إصدار آخر؛ امتلاء التخزين أو رفضه؛ منع المتصفح إجراءً؛ حجب المتصفح التفاصيل؛ أو نوع غير معروف. تقرّر الحزمة ذلك على جهاز الزائر من صياغة الخطأ، وتبقى الصياغة نفسها هناك. وفي حالات الاسم غير المعرّف أو الشيء الذي ليس دالة أو القراءة من لا شيء، ترسل أيضًا اسم المتغير أو الدالة أو الخاصية الوحيد الذي طبعه المتصفح من شيفرة الموقع، إذا كان على هيئة اسم في الشيفرة (حروف لاتينية وأرقام و_ و$، في خمسة أجزاء تفصل بينها نقاط على الأكثر وبحد أقصى 80 محرفًا) واجتاز فحص المعرّفات وفحص تسميات المسارات معًا؛ وإلا أرسلت كلمة تفيد بأن الاسم حُجب أو لم يُطبع. هذه حقيقة من نوع أسماء الدوال في مواضع التعطّل: اسم في الشيفرة، وليس قيمة أو أي جزء آخر من الرسالة. وتبيّن كلمة من قائمة ثابتة أيضًا لمن تعود الشيفرة التي كانت تعمل: مكتوبة داخل الصفحة نفسها، أو ملف على عنوان الموقع نفسه، أو برامج منصة المتجر نفسها، أو خدمة خارجية مسمّاة، أو عنوان آخر، أو دون عنوان. ولمنصة المتجر أو الخدمة المسمّاة، تُذكر الخدمة من القائمة الثابتة للمنصات والخدمات الخلفية وبكسلات الإعلانات ومديري الوسوم والتحليلات وأدوات المحادثة وتطبيقات المتاجر ومكتبات الشيفرة العامة. يُتخذ هذا القرار على الجهاز من عنوان الملف الكامل، الذي يبقى هناك. وللخطأ الذي لا يحمل مكدسًا، يُختزل اسم الملف والسطر اللذان أبلغ عنهما المتصفح مثل أي موضع شيفرة محجوب جزئيًا. ولا تدخل كلمة نوع الخطأ ولا اسم الشيفرة في بصمة التعطّل. وتحتفظ Boosthis أيضًا بعدد التقارير لكل تسمية شاشة أو مسار لكل تعطّل، مع إبقاء أكبر اثني عشر عددًا، وتحصي تقارير تعطّل المواقع بحسب عائلة المتصفح كما هو موضح تحت أين يذهب عنوان IP أو وصف المتصفح. أعداد تعطّل المواقع بحسب المتصفح. عند الوصول، يقرأ الخادم وصف المتصفح الذي يحمله الرفع أصلًا ويحصي التقارير لكل تعطّل بحسب عائلة المتصفح من قائمة ثابتة: Chrome وSafari وFirefox وEdge وSamsung Internet وOpera والمتصفحات داخل تطبيقات Instagram وFacebook وTikTok وSnapchat، أو متصفح آخر، أو غير مذكور. ولا يُخزّن الوصف نفسه. وتبقى الأعداد مع سجل التعطّل. والأساس القانوني هو المصلحة المشروعة في تشخيص تعطّلات العميل.
- إذا كانت تفاصيل الأداء الكاملة مفعّلة (ويبدأ المشروع الجديد وهي مفعّلة). مفعّلة منذ أول تسجيل للمشروع الجديد. وتشغيل الحزمة بمفتاح مشروعك يفعّلها، وخيار «القياس الكامل» في لوحة Boosthis يوقفها ابتداءً من التشغيل التالي للتطبيق. لحزمة الحافة وضع واحد، ولا تلتفت إلى هذا الخيار؛ فهي ترسلها كلما عملت بمفتاح. افتح المشروع في لوحة Boosthis: يُظهر خيار «القياس الكامل» ما إذا كانت مفعّلة، إلا في حزمة الحافة التي ترسلها كلما عملت بمفتاح. للقطة المقاييس أدناه مفتاح تشغيل آخر افحصه وحده.
- إذا كانت خريطة الصفحات مفعّلة وكانت التفاصيل الكاملة أو مشاركة المقاييس مفعّلة. في حزمة المتصفح ابتداءً من الإصدار 1.0.0-alpha.144، وفي حزمة React Native ابتداءً من الإصدار 1.0.0-alpha.297، تبقى مفعّلة ما لم تمرر شيفرتك sendPageMap: false؛ أما الإصدارات الأقدم من حزمة React Native فلا ترسلها إلا إذا مررت sendPageMap: true. ولا يمكن لما نرسله إليك تشغيلها أو إيقافها. تُرسل مع لقطة المقاييس، فتحتاج أيضًا إلى تفاصيل الأداء الكاملة، المفعّلة منذ أول تسجيل للمشروع الجديد إلى أن يوقفها خيار «القياس الكامل» في لوحة Boosthis، أو إلى مشاركة المقاييس للمشروع. يوقفها محو التثبيت وBOOSTHIS_DISABLED=1. ابحث عن sendPageMap في شيفرتك وافحص إصدار الحزمة. في تطبيق متصفح على الإصدار 1.0.0-alpha.144 أو أحدث، أو تطبيق React Native على الإصدار 1.0.0-alpha.297 أو أحدث، تُرسل الخريطة ما لم تجد sendPageMap: false؛ وعلى إصدار أقدم من حزمة React Native لا تُرسل ما لم تجد sendPageMap: true. وحيث تكون مفعّلة، افحص خيار «القياس الكامل» ومشاركة المقاييس في لوحة مشروعك: تفعيل أحدهما يعني إرسال الخريطة.
- إذا كانت تفاصيل الأداء الكاملة أو مشاركة المقاييس مفعّلة (ويبدأ المشروع الجديد والتفاصيل الكاملة مفعّلة). يرفعها أي من الخيارين: تفاصيل الأداء الكاملة، المفعّلة منذ أول تسجيل للمشروع الجديد إلى أن يوقفها خيار «القياس الكامل» في لوحة Boosthis (ولحزمة الحافة وضع واحد، فهي ترسلها كلما عملت بمفتاح)، أو تشغيل مشاركة المقاييس كي يقرأ المساعد المتصل أرقامك الحية. يوقفها محو التثبيت أو BOOSTHIS_DISABLED=1. افحص الأمرين: افتح مشروعك في لوحة Boosthis وانظر إلى خيار «القياس الكامل» وإلى حالة مشاركة المقاييس. أي منهما يكفي لإرسال اللقطة، ولا تتوقف إلا بإيقافهما معًا. أما حزمة الحافة فترسلها كلما عملت بمفتاح.
- إذا كان مشروعك يشغّل حزمة خادم: نظام التشغيل الذي يعمل عليه. تحدده الحزمة التي ثبّتها، لا إعداد ما. ترسله حزم الخادم — Node وBun وPython وJava وGo وPHP و.NET وRuby وRust وElixir — بدءًا من إصدار الحزمة الذي يبلغ به أول مرة، في كل مرة يسجّل فيها التثبيت، أيًا كان ما فُعّل غير ذلك. وترسل حزم الهاتف كلمة نظامها داخل لقطة المقاييس (أعلاه)، وتتركه حزمتا المتصفح والحافة خارج ما ترسلانه. ويوقفه مع كل شيء آخر محو التثبيت وBOOSTHIS_DISABLED=1. تحقق من الحزمة التي يستخدمها مشروعك: حزمة الخادم تبلغ به، أما حزم الهاتف والمتصفح والحافة فلا. ثم افتح صفحة أداء المشروع في لوحة Boosthis: بجانب مكان عمل التثبيت، يسمّي سطر «نظام التشغيل» النظام، أو يقول إن الحزمة لم تبلغ بنظام.
- إذا كانت قائمة المسارات مفعّلة (تتبع مفاتيح لقطة المقاييس). لا تُرسل إلا مع لقطة المقاييس — حين تكون تفاصيل الأداء الكاملة مفعّلة (وهي مفعّلة منذ أول تسجيل للمشروع الجديد إلى أن يوقفها خيار «القياس الكامل») أو حين تكون مشاركة المقاييس للمشروع مفعّلة — ولها مفتاح إضافي: BOOSTHIS_ROUTE_LIST=0 في Node وPython، أو setRouteListEnabled(false) في المتصفح وReact Native. يوقفها كذلك محو التثبيت وBOOSTHIS_DISABLED=1. يتحكم فيها أمران. افحص أولًا هل تُرسل لقطة المقاييس، بالنظر إلى خيار «القياس الكامل» ومشاركة المقاييس للمشروع في لوحة Boosthis. إن كانت اللقطة تُرسل، فافتح صفحة خريطة المشروع: تبيّن مصدر كل مسار وتذكر صراحة إن كانت القائمة موقوفة أو تعذّر على الحزمة سؤال إطار عملك.
- إذا كان إحصاء عناصر التحكم مفعّلًا (يتبع مفاتيح لقطة المقاييس). لا يُرسل إلا عندما تُرسل لقطة المقاييس — حين تكون تفاصيل الأداء الكاملة مفعّلة (وهي مفعّلة منذ أول تسجيل للمشروع الجديد إلى أن يوقفها خيار «القياس الكامل») أو حين تكون مشاركة المقاييس للمشروع مفعّلة — وله مفتاح إضافي: setControlCensusEnabled(false) في حزمتي المتصفح وReact Native، أو BOOSTHIS_CONTROL_CENSUS=0. يوقفه كذلك محو التثبيت وBOOSTHIS_DISABLED=1. لا تجيب عن هذا السؤال إلا حزم المتصفح وReact Native؛ ليس لحزمة خادم واجهة مرئية تفحصها. افتح صفحة خريطة المشروع: تعرض عدد عناصر التحكم في الصفحة التي أخذ منها أحدث تقرير، وتوضح إن كان الإحصاء موقوفًا أو تعذرت قراءة الصفحة أو لم تكن لبيئة التشغيل واجهة تُفحص.
- إذا حوّلت مشروعًا إلى نمط الأعطال التفصيلي. يبقى وضع تقارير التعطّل التفصيلية متوقفًا ما لم يُفعّل. لحزمة الموقع، فعّله لكل مشروع بمفتاح «تقارير التعطل التفصيلية» في صفحة المشروع بلوحة تحكم Boosthis (تتلقى الحزمة الاختيار عند تسجيلها)، أو بسمة وسم البرنامج المستضاف data-crash-details="on"، أو في إعدادات الحزمة داخل الشيفرة. وتستخدم الحزم الأخرى إعدادها داخل الشيفرة. وتُستثنى حزمة React Native ابتداءً من الإصدار 1.0.0-alpha.342: فهي تقرأ أيضًا المفتاح نفسه، الذي تتلقاه عند تسجيلها، إلى جانب إعدادها داخل الشيفرة، ويكفي تفعيل أيٍّ منهما. لحزمة الموقع، افحص مفتاح «تقارير التعطل التفصيلية» في صفحة المشروع وسمة data-crash-details في الوسم وإعدادات الحزمة داخل الشيفرة: يكفي تفعيل أي منها. ولحزمة React Native ابتداءً من 1.0.0-alpha.342، افحص المفتاح نفسه وإعداد الحزمة داخل الشيفرة: يكفي تفعيل أيٍّ منهما. للحزم الأخرى، افحص إعدادها داخل الشيفرة.
- إذا كان تطبيقك يعمل بـ React Native. يتحدد ذلك بالحزمة التي ثبّتها تطبيقك لا بإعداد. لا ترسل هذه البيانات إلا حزمة React Native. تنتقل إشارة الوصول اليومية مع إشارات التشغيل الدائمة. تبدأ الحزمة بنفسها أدوات الجمع الثلاث الأخرى عند استدعاء enableTelemetry()؛ ولا تُرسل قياساتها إلا مع لقطة المقاييس حين تكون تفاصيل الأداء الكاملة مفعّلة (وهي مفعّلة منذ أول تسجيل للمشروع الجديد إلى أن يوقفها خيار «القياس الكامل») أو حين تكون مشاركة المقاييس مفعّلة. يمكنك تعطيل كل منها باسمه: autoWrapNetwork: false أو trackUnhandledErrors: false أو trackImageWeight: false. الأداة المعطّلة لا تربط شيئًا ويذكر مقياسها إيقافها في هذا البناء. يوقف محو التثبيت وBOOSTHIS_DISABLED=1 جميعها. ينطبق هذا إن ثبّت حزمة React Native في تطبيق هاتف. تبدأ أدوات الجمع الثلاث تلقائيًا إلا إن رفضتها في خيارات استدعاء enableTelemetry()؛ ابحث في شيفرتك عن الاستدعاء. وتعرض لوحة الحزمة ومقاييس المشروع حالة كل منها.
- إذا كان تتبع الشاشات في React Native مفعّلًا، وكانت التفاصيل الكاملة أو مشاركة المقاييس مفعّلة. مفعّل افتراضيًا ابتداءً من حزمة React Native 1.0.0-alpha.297، ويُوقف بـtraceScreens: false في enableTelemetry()؛ أما الإصدارات الأقدم فلا تسجل شيئًا ما لم تمرر شيفرتك traceScreens. ولا يسجل إلا ما دام أحد مفتاحي لقطة المقاييس مفعّلًا — تفاصيل الأداء الكاملة (المفعّلة منذ أول تسجيل للمشروع الجديد إلى أن يوقفها خيار «القياس الكامل») أو مشاركة المقاييس للمشروع — ولا يسجل أبدًا ما دام تطبيقك قد سجّل أن مستخدمه حجب الإذن (setEndUserConsent("withheld"))؛ وحتى ذلك الحين لا يقرأ عنوان أي طلب، ولا توجد مقاطع تتبع للشاشات أو الاستدعاءات ولا ترويسة تتبع. يوقفه محو التثبيت وBOOSTHIS_DISABLED=1. وابتداءً من 1.0.0-alpha.339 تذهب ترويسة التتبع أيضًا إلى خوادم التطبيق نفسه، ويُتعرَّف عليها بالرموز أحادية الاتجاه التي ترسلها حزمة الخادم فيها، ما لم تمرر شيفرتك traceScreens: { ownServers: false }. مقياس الشبكة المنفصل لا يتغير ويظل لا يقرأ URL أو مضيفًا أو مسارًا أو حالة استجابة. افحص إصدار حزمة React Native وابحث عن traceScreens في استدعاء enableTelemetry(). على الإصدار 1.0.0-alpha.297 أو أحدث ومن دون traceScreens: false، تُسجَّل الدائرة كلما كان أحد مفتاحي لقطة المقاييس مفعّلًا؛ وعلى إصدار أقدم لا يسجلها إلا traceScreens صريح. تسمّي قائمة propagateTo مضيفين يمكن أن تصلهم ترويسة التتبع؛ وابتداءً من 1.0.0-alpha.339 تصل أيضًا إلى خوادم التطبيق نفسه، ويُتعرَّف عليها بالرموز أحادية الاتجاه التي ترسلها حزمة الخادم فيها، ما لم يمرر enableTelemetry() الخيار traceScreens: { ownServers: false }؛ ودون مضيف مسمى ومع إيقاف ذلك الخيار لا تصل إلى أي مضيف.
- إذا كانت صفحات موقعك تستدعي خادمك (حزمة المتصفح 1.0.0-alpha.144 وما بعدها). مفعّلة افتراضيًا ابتداءً من حزمة المتصفح 1.0.0-alpha.144، وتُوقف بـtraceSameOrigin: false. عندها يحمل كل طلب fetch أو XHR ترسله صفحة إلى أصلها نفسه ثلاث ترويسات تتبع إلى خادمك، ويُسجَّل خطوةً متتبَّعة واحدة. ولا يحمل طلب إلى مضيف آخر ترويسة تتبع ما لم تسمّ شيفرتك ذلك المضيف في tracePropagateTo. تنتقل الخطوة على مفتاحي لقطة المقاييس نفسيهما — تفاصيل الأداء الكاملة (المفعّلة منذ أول تسجيل للمشروع الجديد إلى أن يوقفها خيار «القياس الكامل») أو مشاركة المقاييس للمشروع — ويوقفها محو التثبيت وBOOSTHIS_DISABLED=1. افحص إصدار حزمة المتصفح وابحث في شيفرتك عن traceSameOrigin: false. على الإصدار 1.0.0-alpha.144 أو أحدث ومن دون هذا السطر، تُتتبَّع طلبات الصفحة إلى أصلها نفسه كلما كان أحد مفتاحي لقطة المقاييس مفعّلًا. وتحدد tracePropagateTo المضيفين الآخرين الوحيدين الذين يتلقون الترويسات.
- إذا كان خادمك يشغّل حزمة خادم من Boosthis (Node 1.0.0-alpha.200 وPython 1.0.0a168 وPHP 1.0.83 وJava وGo 1.0.0a146 وRuby 1.0.0a86 و.NET 1.0.89 وRust 1.0.0a81 وElixir 1.0.0a78 وحزمة الحافة 1.0.0-alpha.32 وما بعدها). يتحدد ذلك بالحزمة التي يشغّلها خادمك وإصدارها: ترسلها حزمة Node ابتداءً من 1.0.0-alpha.200، وحزمة Python ابتداءً من 1.0.0a168، وحزمة PHP ابتداءً من 1.0.83، وحزمتا Java وGo ابتداءً من 1.0.0a146، وحزمة Ruby ابتداءً من 1.0.0a86، وحزمة .NET ابتداءً من 1.0.89، وحزمة Rust ابتداءً من 1.0.0a81، وحزمة Elixir ابتداءً من 1.0.0a78، وحزمة الحافة ابتداءً من 1.0.0-alpha.32، ولا ترسلها أي حزمة للمتصفح أو للهاتف. لا تنتقل إلا مع الخطوة المتتبَّعة الخاصة بالطلب، على مفتاحي لقطة المقاييس نفسيهما — تفاصيل الأداء الكاملة (المفعّلة منذ أول تسجيل للمشروع الجديد إلى أن يوقفها خيار «القياس الكامل»، والمفعّلة دائمًا في حزمة الحافة) أو مشاركة المقاييس للمشروع — ويوقفها محو التثبيت وBOOSTHIS_DISABLED=1. تحقق من الحزمة التي يشغّلها خادمك وإصدارها. على أحد الإصدارات المذكورة أعلاه أو أحدث، يرسل الطلب المتتبَّع أيضًا خطوة مرتبطة واحدة لكل نوع من استدعاءات قاعدة البيانات أو الخدمات الخارجية التي أجراها، كلما كان أحد مفتاحي لقطة المقاييس مفعّلًا.
- إذا كان خادمك يشغّل حزمة Node أو Python ويستدعي خدماتك الأخرى (مفعّلة افتراضيًا). مفعّلة افتراضيًا في حزمتي Node وPython، ويغيّرها إعداد واحد على خادمك هو BOOSTHIS_TRACE_PROPAGATION: القيمة none توقفها، وinternal تبقيها على العناوين الداخلية وحدها، وقائمة بالمضيفين تحل محل الإعداد الافتراضي. ودون أي إعداد تضيف الحزمة ثلاث ترويسات تتبع إلى استدعاءاتها للعناوين التي لا يمكن أن تكون على الإنترنت العام، وابتداءً من Node 1.0.0-alpha.204 وPython 1.0.0a171 إلى المضيفين الواقعين في الموقع نفسه الذي يخدمه الطلب. ولا يتلقاها مضيف أي شركة أخرى ما لم تسمّه، ولا يُرسل شيء جديد إلى Boosthis، ويوقفها BOOSTHIS_DISABLED=1 أيضًا. تحقق من الحزمة التي يشغّلها خادمك وإصدارها، ومن ضبط BOOSTHIS_TRACE_PROPAGATION حيث يعمل. وتذكر صفحة الحالة الخاصة بالحزمة القاعدة السارية في سطر واحد.
- إذا كان تطبيقك تطبيق Flutter. يتحدد ذلك بالحزمة التي ثبّتها لا بإعداد: لا يفعل هذا إلا حزمة Flutter. فهي تراقب الطلبات التي يرسلها تطبيقك عبر عميل HTTP الخاص بلغة Dart، وهو ما يشمل package:http وDio على محوّله الافتراضي، وتراقب الإضافة الاختيارية boosthis_dio كل استدعاء يجريه مثيل Dio بعد أن تضيف شيفرتك معترضها. وما دامت الحزمة غير موقوفة، يحمل كل طلب من هذه الطلبات ثلاث ترويسات تتبع إلى أي مضيف يذهب إليه، ولا يوقفها إلا BOOSTHIS_DISABLED إذا ضُبط عند بناء التطبيق. ولا تُرسل الخطوة المتتبَّعة لكل استدعاء إلا ما دامت التفاصيل الكاملة مفعّلة للمشروع، وتوقف forget إرسال أي شيء. وفي تطبيق Flutter يعمل في متصفح، تتنحى الحزمة والإضافة: لا يُقاس شيء ولا تُضاف ترويسة. ينطبق إذا كان تطبيقك يشغّل حزمة Flutter؛ ولا تكتب أي حزمة أخرى ترويسات التتبع إلى كل مضيف. ابحث في إعدادات البناء عن BOOSTHIS_DISABLED: ما لم يُضبط عند بناء التطبيق، يحمل كل طلب عبر عميل HTTP الخاص بلغة Dart الترويسات الثلاث، أيًّا كان المضيف الذي يذهب إليه. وابحث في شيفرتك عن BoosthisDioInterceptor لتعرف هل الإضافة مستخدمة، وافتح المشروع في لوحة Boosthis لترى هل التفاصيل الكاملة مفعّلة.
- إذا كانت شيفرة تطبيق هاتفك تلفّ لمسة في trackTap (حزمة Flutter 0.1.95 أو حزمة iPhone 0.2.76 وما بعدهما). يتحدد ذلك بشيفرتك لا بإعداد: ابتداءً من حزمة Flutter 0.1.95 وحزمة iPhone 0.2.76، لا تُرسل لمسة إلا حيث يلفّ تطبيقك معالج تلك اللمسة في trackTap (وفي iPhone: trackTap أو trackTapAsync). ولا تراقب أيٌّ من الحزمتين اللمس من تلقاء نفسها، ولا ترسل حزمة Android أي لمسة على الإطلاق. وتنتقل خطوة اللمسة الملفوفة مع الخطوات المتتبَّعة الأخرى للحزمة، وحين يُسمح لها بالانتقال فقط؛ وإزالة اللفّ توقفها، ويوقفها محو التثبيت وBOOSTHIS_DISABLED=1 كما يوقفان كل شيء آخر. ابحث في شيفرتك عن trackTap وtrackTapAsync، وتحقق من إصدار الحزمة. على Flutter 0.1.95 أو iPhone 0.2.76 أو أحدث، ترسل كل لمسة ملفوفة نتج عنها استدعاء تسجّله الحزمة خطوةَ لمسة واحدة؛ ومن دون لفّ في شيفرتك لا تُرسل أي خطوة لمسة.
- إذا كان تطبيقك يعمل في متصفحات الزوار (حزمة المتصفح 1.0.0-alpha.146 وما بعدها). يتحدد ذلك بالحزمة التي ثبّتها لا بإعداد. لا ترسله إلا حزمة المتصفح — وسم السكربت المستضاف ووحدة المتصفح على السواء — ابتداءً من 1.0.0-alpha.146، وينتقل مع الإشارات الدائمة: تحمله عمليات الرفع والتسجيل التي تجريها الحزمة أصلًا، دون أي طلب إضافي. يحذف محو التثبيت (forget()) قيمة اليوم من المتصفح، والزائر الذي يوقف تخزين الحزمة على جهازه يمحوها مع كل ما تحتفظ به الحزمة هناك. ينطبق إذا كان موقعك يشغّل حزمة المتصفح بالإصدار 1.0.0-alpha.146 أو أحدث؛ ولا ترسله أي بيئة تشغيل أخرى. الموقع الذي يحمّل وسم السكربت المستضاف يشغّل الإصدار الذي يقدّمه Boosthis في تلك اللحظة، والموقع الذي يضمّن وحدة المتصفح يشغّل الإصدار المسمى في ملف القفل لديه؛ وتعرض صفحة مشروعك على Boosthis إصدارات الحزمة التي أبلغت عنها متصفحات زوارك.
- اسم تسجيل تطبيقك والاسم الذي تكتبه للمشروع. لا يرسل التطبيق اسمًا إلا إذا منحته شيفرتك أو بناؤك اسمًا؛ الحقل اختياري ويظهر التثبيت بلا اسم وفق معرّفه. اسم المشروع لا ترسله أي حزمة؛ تكتبه أنت في لوحة Boosthis ولا تراه الحزمة. الاسمان ظاهران في لوحتك: اسم التطبيق في صف تثبيته واسم المشروع أعلى صفحته. ابحث في شيفرتك أو إعداد بنائك عن الاسم الممرَّر للحزمة؛ إن لم تمرر شيئًا فلا يُرسل اسم. إعادة تسمية المشروع تغيّر اسمه لكل مفتاح في سلسلة تدويره، ويبلّغ التطبيق ذو المفتاح الأقدم تحت الاسم الجديد عند اتصاله التالي.
- إذا رفع مطور خريطة بناء لقراءة إطارات الأعطال بوصفها شيفرة مصدرية. لا يُرفع شيء ما لم يفعل المطور ذلك من صفحة المشروع أو بخطوة يضيفها إلى بنائه. لا تجلب الحزمة محتوى خريطة بناء ولا يطلب Boosthis واحدة من نظام بنائك؛ والمشروع الذي لم يرفع خريطة لا يحتفظ بها. تفحص حزمة المتصفح وجود خريطة بطلب HEAD إلى عنوان .map لأول ملف شيفرة في موقعك وتحتفظ فقط بإشارة نجاح 1 أو فشل 0، دون تنزيلها أو تخزين عنوانها أو إرساله. إن رفعت خريطة، تُحل إطارات الأعطال إلى الملف والسطر الأصليين؛ وإلا تظهر مواضع البناء المجمّع، وهذا هو الفرق الوحيد. تعرض صفحة المشروع كل خريطة محتفظ بها: الإصدار والملف المولَّد ووقت وصولها وتاريخ انتهائها. القائمة الفارغة تعني أنه لا توجد خريطة الآن، سواء لم تُرفع أصلًا أو انتهت مدتها. تُحفظ كل خريطة 90 يومًا من وصولها ثم تُحذف؛ وإعادة رفع الإصدار نفسه تستبدل القديمة وتبدأ المدة من جديد.
لا يُرسل في أي نمط
- عناوين IP. لا تُرسل ضمن بيانات القياس، ولا تُستخدم لتحديد أي شخص ولا تُربط بالقياسات. وكمعظم خدمات الويب تقريبًا، يحتفظ خادمنا بسجلات طلبات تشغيلية. ويحمل كل سطر فيها، مكان العنوان، وسمًا يتغير كل يوم ولا يمكن تحويله إليه مجددًا، وتُحذف السجلات بعد 30 يومًا، بما فيها الأسطر الأقدم التي كانت لا تزال تحمل العنوان كاملًا. وتُعدّ الطلبات للحد من معدلها بحسب مفتاح المشروع أو التثبيت، لا بحسب العنوان أبدًا.
- أي شيء يعرّف أحد مستخدميك. معرّفات المستخدمين والبريد الإلكتروني والأسماء وأرقام الهاتف والعناوين البريدية ومعرّفات الأجهزة وسائر المعرّفات. تمنعها قائمة حظر على الجهاز ثم على خادمنا، وتُرفض الدفعة كاملة إن احتوت واحدًا منها.
- محتوى الطلبات والاستجابات. لا تُجمع ولا تُرسل أجسام الطلبات أو الاستجابات أو سلاسل الاستعلام أو الترويسات. القراءة داخل عمليتك وجمع البيانات شيئان مختلفان، وفيما يلي كل ما يُقرأ داخلها. الاستثناء الواحد هو مقياس استدعاءات الذكاء الاصطناعي: لتمييز نصوص الطلب المتكررة، يقرأ أول 4,096 محرفًا على الأكثر من جسم طلب صادر إلى مزود ذكاء اصطناعي، داخل عمليتك، ويختزلها فورًا إلى رقم واحد — لا يُخزّن نص الجسم ولا يُرفع ولا يمكن استعادته. 9 قراءات محدودة أخرى تعمل بالطريقة نفسها — داخل عمليتك، ويُختزل كل منها فورًا إلى رقم أو إشارة أو تسمية من قائمة ثابتة: يقرأ المقياس نفسه رد المزود أثناء تدفقه، محتفظًا بما لا يزيد عن 8,192 محرفًا من سطر جزئي في كل مرة، لاستخراج أعداد token التي يذكرها المزود؛ عندما يرفض المزود استدعاءً، يأخذ المقياس نسخة من رد الخطأ ليحدد نوع الرفض — تتوقف حزمة Python عن التجميع عند 8,192 محرفًا، بينما تسلّم بيئة التشغيل الرد كسلسلة واحدة في Node والمتصفح، فتُستبعد السلسلة إن تجاوزت 8,192 محرفًا دون فحصها؛ تقرأ مراقبة التسرب أول 8,192 بايتًا على الأكثر من استجابة خطأ يوشك تطبيقك على إعادتها، لترى إن كان تتبع مكدّس أو نص يشبه معلومة سرية سيتسرب إلى أحد مستخدميك؛ في المتصفح فقط، وفقط إن فعّلت ذلك، تُقرأ نسخة من استجابة JSON لأحد استدعاءات تطبيقك لترى إن كانت تشبه خطأ رغم إرجاع حالة 200؛ لا تؤخذ النسخة إلا إذا أعلن الخادم طولًا لا يزيد عن 65,536 بايتًا، ولأن الطول المعلن قد يقل عن الفعلي، تُفحص النسخة التي يعيدها المتصفح مرة أخرى وتُستبعد دون فحص محتواها إذا تجاوزت 65,536 محرفًا؛ عند نقطة اتصال MCP يقدّمها تطبيقك، تُنسخ أول 64 كيلوبايت على الأكثر من طلب JSON-RPC أثناء قراءة تطبيقك له، لاستخراج اسم الطريقة من غلافه — لا الوسائط، ولا يتغير أي بايت مما يستلمه تطبيقك نفسه؛ في حزمة الحافة، تختزل قراءتا العمل المتكرر وقاعدة البيانات ما يصل إلى 4,096 محرفًا من كل طرف من استعلام الاستدعاء الصادر، ومن جسمه حين يكون نصًا، إلى رقم واحد، حتى لا يُعدّ استدعاءان مختلفان إلى العنوان نفسه عملًا واحدًا؛ ويُقارَن الرقم داخل الطلب ويُهمَل معه؛ يقرأ فحص cookie ترويسات Set-Cookie التي يرسلها تطبيقك — بحد أقصى 20 لكل استجابة و2,048 محرفًا من قسم السمات في كل منها، أو 2,048 بايتًا في الحزم التي تكون سلاسلها بايتات — لفحص أعلام Secure وHttpOnly وSameSite والحجم، لا القيمة؛ وتقرأ حزمة Node أيضًا اسم كل ملف cookie، حتى 1,024 محرفًا وتتوقف حيث ينتهي الاسم، وتطابقه بقائمة كلمات ثابتة فقط لتقرر هل يهم غياب HttpOnly — فملف الجلسة أو رمز الدخول يحتاجه، أما ملف CSRF أو التفضيلات فمقصود أن تقرأه شيفرة صفحتك نفسها — ولا يُحتفظ بالاسم ولا يُرسل؛ ولا تُقرأ ترويسة Cookie التي يرسلها مستخدموك إطلاقًا؛ تُبحث قائمة ثابتة من الترويسات بأسمائها وتُحوّل فورًا إلى رقم أو تسمية ثابتة: نوع المحتوى وطوله وترميزه، وترويسة Accept التي أرسلها متصفح المستخدم، وما إذا كانت استجابتك موسومة للتنزيل (Content-Disposition)، وتعليمات التخزين المؤقت ومُتحققات استجابة تطبيقك (Cache-Control وETag وLast-Modified)، وفارق الزمن بالمللي ثانية الذي كتبه جزء سابق مزوّد بالقياس، ووقت بدء الانتظار الذي يضيفه الوكيل، ووجود ترويسات إعادة التوجيه من الوكيل العكسي دون قيمها (X-Forwarded-For وX-Forwarded-Host وX-Forwarded-Proto وX-Real-IP)، وما إذا كانت ترويستا Host وOrigin في طلبٍ لإحدى إجابات الحزمة المقصورة على الجهاز المحلي تشيران إلى هذا الجهاز (جواب بنعم أو لا يقرّر هل تجيب الحزمة؛ ولا تُحفظ أيٌّ من القيمتين)، وما إذا كان الطلب يحمل ترويسة Origin، وما إذا كانت ترويسات المصادر المتقاطعة في استجابة تطبيقك نفسه (Access-Control-Allow-Origin وAccess-Control-Allow-Credentials) تجيب أي مصدر، أو تعيد ذلك المصدر نفسه، أو تجمع بين إجابة أي مصدر وبيانات الاعتماد (أجوبة بنعم أو لا تصير أعدادًا؛ ولا يُحفظ أي مصدر ولا أي قيمة ترويسة)، وحكم مخزن منصة الاستضافة المؤقت، وما تبقى من حد طلبات مزود الذكاء الاصطناعي ومدة إعادة المحاولة ووقت المعالجة عنده، ووجود ترويسة تفويض أو طلب مصادقة — لا قيمتها ولا ترويسة غير مسمّاة؛ وإذا بدأت حزمة قراءة ترويسة خارج القائمة يفشل بناؤنا قبل نشرها؛ وقيم الاستعلام التي تقرؤها الحزمة أثناء الإرسال موجودة في عناوين URL التي تبنيها الحزمة نفسها لرفع بياناتها؛ وتُقرأ مفتاحًا بمفتاح حتى يرفض الفاحص أي قيمة تشبه معرّفًا قبل مغادرة عمليتك. تُحذف استعلامات تطبيقك دون قراءتها قبل تكوين تسمية المسار. قراءة محدودة واحدة ليست اختزالًا، لأن ما تحفظه هو صفحتك وهي في طريقها إلى زائرك: حين تكون فقاعة اللوحة مفعّلة، تُحفظ صفحة HTML مؤقتًا لإدراج وسم شيفرة واحد فيها — حتى 2 ميغابايت، أو 4 ميغابايت في .NET؛ وبعد هذا الحد تُمرَّر الصفحة دون تغيير. تُعاد البايتات مع وسم شيفرة واحد، دون أخذ شيء منها. قراءة واحدة لا تُحصر في تسمية من قائمة ثابتة ولا في طول محدد، لأن قيمتها هي السؤال الموجه إلى نقطة الحزمة نفسها: تقرأ نقاط القراءة المحلية للحزمة — اللوحة وقراءات JSON التي تقدمها تحت مسارها الخاص وخلف قيد الجهاز المحلي أو المفتاح — استعلام الطلبات الموجهة إليها: عدد الصفوف التي تعيدها واسم المسار الذي تُصفّى عليه؛ يتحول عدد الصفوف إلى رقم، ويُقارن اسم المسار كما كتبه المستدعي دون حد لطوله بأسماء المسارات المحتفظ بها لدى الحزمة، فيعيد الاسم الذي لا يطابق أيًا منها نتيجة فارغة. لا تُسجّل القيمتان، ولا تقرأ هذه النقاط أي استعلام آخر في تطبيقك. لا تُفحص مقابل قائمة أولًا ولا يُفرض حد لطولها، ولا يُشتق منها أو يُحفظ شيء بعد إرسال الاستجابة. قراءة محدودة واحدة لا تبقى داخل عمليتك، ونوضح الفرق بدل تركه للتخمين: في طلب يصل إلى تطبيقك، تقرأ حزم الخوادم قيمة ترويستين لا مجرد تصنيفهما: معرّف التتبع ومعرّف مقطع المستدعي اللذين كتبتهما خدمة أخرى لديك مزوّدة بقياس Boosthis. لا تُقبل القيمة إلا إذا طابقت تمامًا شكل معرّفات الحزم (32 محرفًا سداسيًا عشريًا للتتبع و16 للمقطع)؛ وما عدا ذلك يُستبعد ويُستبدل معرّف التتبع بآخر عشوائي. يصبح معرّف التتبع المقبول معرّف تتبع ذلك الطلب: يُنقل مع الاستدعاءات التي يجريها تطبيقك لمعالجة الطلب، ويُرفع مع مدده؛ ويُرفع معرّف المقطع المقبول بوصفه أصل خطوة ذلك الطلب نفسه. بهذا وحده تُعرض العملية العابرة لعدة خدمات كسطر واحد لا أسطر منفصلة. هذان المعرّفان هما الشيئان الوحيدان هنا اللذان يُنقلان إلى خدمات أخرى أو يُرفعان مع قراءات تطبيقك؛ وكل منهما معرّف تولّده الحزم ولا يُشتق منه شيء، ولا تُقرأ قيمة أي ترويسة أخرى. قراءتان تُرسل ما تحمله إلى Boosthis، لأن ما تحمله اعتماد أصدره Boosthis نفسه ولا يستطيع غيره أن يقول هل لا يزال قائمًا: حين تكون فقاعة اللوحة مفعّلة، تبحث الحزمة في عنوان الصفحة عن مفتاح واحد هو boosthis — حزمة الخادم في عنوان كل طلب صفحة يتلقاه تطبيقك، وحزمة المتصفح في عنوان الصفحة نفسها — ولا تبحث فيه إلا عن واحد من ثلاثة أجوبة: إثبات مالك صالح لمرة واحدة من صفحة مشروعك على Boosthis، يُرسل إلى Boosthis ليُستبدل بتصريح مالك يدوم نحو 30 يومًا (تحفظه حزمة الخادم في cookie خاص بها، وحزمة المتصفح في تخزين ذلك المتصفح نفسه)؛ أو off، فيُنسى ذلك التصريح؛ أو on، ولا تقبله إلا حزمة الخادم، ومن الجهاز نفسه فقط؛ وحين تعمل الحزمة بأحدها يبقى المتصفح على العنوان نفسه دون ذلك المفتاح، ولا يُستخدم أي مفتاح آخر في العنوان أو يُحفظ، وزر الإيقاف في فقاعة حزمة الخادم لا يفعل إلا كتابة ذلك المفتاح بقيمة off في عنوان الصفحة التي هو فيها؛ وتبحث حزمة الخادم في ترويسة Cookie لكل طلب يتلقاه تطبيقك عن ملفي cookie خاصين بها ولا تستخدم غيرهما: boosthis_owner_pass، ويحمل تصريح المالك الذي أصدره Boosthis عبر رابط المالك، وboosthis_owner، ولا يحمل إلا القيمة 1 علامةً على أن المتصفح مفعّل؛ ويُرسل التصريح إلى Boosthis للسؤال هل لا يزال قائمًا، وتحفظ الحزمة الجواب مدة تصل إلى عشر دقائق (ثلاثين ثانية إن لم يُجب Boosthis)؛ والطلب الذي لا يحمل ذلك الملف لا يُجري أي اتصال؛ وتقرأ شيفرة الفقاعة في الصفحة الملف الثاني لتقرر هل تظهر؛ وحيث لا تستطيع الحزمة ضبط ملفاتها إلا بإعادة كتابة أسطر Set-Cookie في الاستجابة، تأخذ الأسطر التي وضعها تطبيقك وتعيدها دون تغيير بجانب أسطرها؛ وفي الصفحة التي تحمل الفقاعة تضيف Cookie إلى ترويسة Vary في تطبيقك مع إبقاء ما كان فيها. قراءة واحدة غير محدودة ولا تُختزل إلى رقم، وتطلبها بنفسك: تقدم لوحة حزمة Python نقطة اتصال واحدة تقبل طلب POST — مطابِق القواعد — وتقرأ جسمه كاملًا، لأن الشيفرة التي تلصقها هي السؤال نفسه: تُقارن بكتاب القواعد داخل عمليتك، خلف القيد المحلي أو مفتاح اللوحة نفسه، والجواب قائمة بأسماء القواعد؛ ولا تُخزَّن الشيفرة أو أي جزء منها أو يُسجَّل أو يُرفع. باستثناء معرّف التتبع ومعرّف المقطع اللذان وضعتهما خدمة أخرى مزوّدة بالقياس في الطلب؛ مفتاح رابط المالك الوحيد، boosthis، في عنوان الصفحة؛ وملفا cookie الخاصان بالمالك لدى الحزمة، لا يُخزّن أو يُرفع ما يُقرأ هنا، ولا يمكن استعادته مما يُرفع؛ ويرفض فاحص مسار الرفع أي حمولة تتضمن جسم طلب أو استجابة أو ترويسة أو cookie أو قيمة استعلام — ويُرفع هذان المعرّفان في حقلين مستقلين، لا كترويسة وصولهما، ويذهب إثبات المالك وتصريحه إلى Boosthis في اتصالات مستقلة، لا ضمن أي رفع.
- تتبعات المكدّس الخام ورسائل الخطأ الخام وأسطر السجل. يحمل تقرير العطل موضعًا منقّحًا في الشيفرة ونوع الخطأ، والشاشة أو المسار الذي وقع فيه (أو سببًا من قائمة ثابتة حيث لا يمكن تسمية شيء)، ومراجع تتبع الإجراء الذي وقع أثناءه إن كان إجراءً متتبَّعًا. وتحمل تقارير المواقع أيضًا كلمات نوع الخطأ وصاحب الشيفرة واسم الخدمة من القوائم الثابتة، واسم الشيفرة الذي اجتاز الفحص أو سبب غيابه، مع أعداد بحسب عائلة المتصفح والشاشة أو المسار. وتحمل تقارير الهاتف أيضًا كلمة نوع الخطأ الموضحة أعلاه، ومعها ابتداءً من حزمة React Native 1.0.0-alpha.342 كلمة تبيّن ما إذا كان اسم شيفرة قد طُبع، مع أعداد بحسب الشاشة وفئة النظام والشركة المصنّعة. وفي وضع الأعطال التفصيلي فقط، تضيف سطرًا أول اجتاز الحارس، مقصوصًا إلى 300 حرف على الأكثر، وحتى 20 إطارًا مختزلة بالطريقة نفسها، وتضيف حزمة React Native اسم الشيفرة الذي اجتاز الفحص. لا مكدّس خام أبدًا ولا قيمة. ويعدّ مقياس الأخطاء المسجلة عددها وتواترها، لا السطر ولا الرسالة ولا اسم المسجّل ولا المستوى.
- أي شيء عن العمليات التي يشغّلها تطبيقك. لا تُرسل أسطر الأوامر أو وسائطها أو بيئاتها أو مخرجاتها. يحصي مقياس العمليات الفرعية عدد مرات تشغيلها وتكرارها فقط.
- أسماء الأشياء التي تعدّها المقاييس. تُحصى الخيوط والعاملات والوحدات والمقابض والمؤقتات والملفات والمخازن والطوابير دون ذكر أسمائها. يبلّغ المقياس عن العدد والمدة لا الهوية.
- شيفرتك المصدرية. لا يقرأ Boosthis قاعدة شيفرتك أبدًا. لا تفتح أي حزمة ملف شيفرة أو تفحصه أو تفهرسه أو ترفعه، ولا يُخزّن نص الشيفرة على خوادمنا؛ حتى النسخة المضمنة في خريطة البناء تُستبعد عند وصولها. ما نستطيع قوله عن سطر من شيفرتك يأتي مما وضعه بناؤك في إطار مكدّس.
- أسماء المضيفين وبيئتك. لا تُرسل أسماء المضيفين ولا قيم متغيرات البيئة أبدًا، إلا في حالتين. الأولى رمز المنطقة الذي تنشره منصة الاستضافة عن نفسها، مثل us-east-1، ويُرسل مع مكان عمل الخادم (أعلاه). والثانية خدمة خارجية يستدعيها تطبيقك في اندفاعة: حيث تراقب الحزمة استدعاءات تطبيقك الصادرة بحثًا عن مضيف واحد يُستدعى مرة بعد مرة دون تمهّل — خمسة استدعاءات له أو أكثر خلال عشر ثوانٍ — تبلغ عن ذلك مشكلةً تحمل اسم المضيف وحده، مثل api.example.com، لا مسارًا ولا سلسلة استعلام ولا منفذًا ولا أي شيء آخر من العنوان. تراقب حزمة Node ذلك من تلقاء نفسها، ولا تراقبه بعض الحزم الأخرى إلا حيث تسلّمها شيفرتك كل استدعاء صادر. وتقرأ الحزمة متغيرات البيئة داخل عمليتك — إعداداتها الخاصة، والعلامات التي تنشرها منصة الاستضافة عن نفسها — وما يغادرها، باستثناء رمز المنطقة ذاك، كلمة من قائمة ثابتة أو رقم يُحسب هناك، لا القيمة التي قرأتها أبدًا. ففحص وضع التطوير في حزمة المتصفح، مثلًا، يقرأ NODE_ENV للإبلاغ هل يعمل بناء تطوير، في صورة 1 أو 0؛ وتقرأ حزمة المتصفح NODE_ENV واسم مضيف الصفحة نفسها للتعرف على صفحة المطوّر نفسه — بناء تطوير، أو عنوان استرجاع محلي مثل localhost — فإن كانت كذلك لم ترسل إلا كلمة development، وأبلغت عن تلك الصفحة على أنها تثبيت التطوير المنفصل للمشروع. وما ترسله حزمة الخادم عن الأسماء التي تُوجَّه إليها الطلبات التي يجيب عنها الخادم هو رمز أحادي الاتجاه لكل منها، لا الاسم أبدًا (انظر «رموز أحادية الاتجاه لأسماء خوادمك» أعلاه). ولا تُرسل مسارات الملفات من جهازك أيضًا — باستثناء واحد نذكره هنا: خريطة البناء التي يرفعها المطور تحتفظ بمسارات المصدر الأصلية فيها طوال مدة حفظ الخريطة. وشيئان يقرآن المسارات دون إرسالها: تقرأ الحزمة المسارات في مكدّس الخطأ داخل عمليتك فقط لتقصّ كلًّا منها إلى اسم ملفه، فيكون ملف إطار العطل اسم الملف وحده؛ ويفتح قارئ المحادثات في إضافة Boosthis للمحرر ملفات المحادثات التي يحفظها مساعد الذكاء الاصطناعي لدى المطور على قرصه هو.
- ما يراه مستخدموك أو يقولونه. لا تُلتقط محتويات الشاشة أو لقطات الشاشة أو الفيديو أو الصوت.
تفاصيل كل حقل والصياغة التي تحتاجها سياسة الخصوصية لديك في ما يجمعه Boosthis داخل تطبيقك.
ماذا تستطيع أن تقرأ داخل عمليتي؟
القراءة داخل عمليتك وجمع البيانات شيئان مختلفان. الاستثناء الواحد هو مقياس استدعاءات الذكاء الاصطناعي: لتمييز نصوص الطلب المتكررة، يقرأ أول 4,096 محرفًا على الأكثر من جسم طلب صادر إلى مزود ذكاء اصطناعي، داخل عمليتك، ويختزلها فورًا إلى رقم واحد — لا يُخزّن نص الجسم ولا يُرفع ولا يمكن استعادته. 9 قراءات محدودة أخرى تعمل بالطريقة نفسها — أعداد token التي يذكرها المزود في رده؛ نوع الرفض في رد خطأ المزود؛ تتبع مكدّس أو معلومة سرية توشك على الوصول إلى أحد مستخدميك؛ استجابة JSON تشبه الخطأ وتعود بحالة 200؛ اسم الطريقة في طلب استدعاء أداة يقدّمه تطبيقك؛ استعلام استدعاء صادر وجسمه، مختزلَين إلى رقم واحد؛ أعلام cookie التي يضبطها تطبيقك؛ قائمة ثابتة من الترويسات المسمّاة؛ واستعلام عناوين URL لرفع بيانات الحزمة نفسها — ويُختزل كل منها فورًا إلى رقم أو إشارة أو تسمية من قائمة ثابتة، مع توضيح حدّه في سياسة الخصوصية. قراءة محدودة واحدة ليست اختزالًا — صفحة HTML التي تُدرج فيها فقاعة اللوحة — تُحفظ فقط حتى إدراج وسم شيفرة واحد ثم تُعاد دون أخذ شيء منها. قراءة واحدة لا تُحصر في تسمية من قائمة ثابتة ولا في طول محدد — استعلام الطلبات إلى نقاط القراءة الخاصة بالحزمة — تُستخدم كما كتبها المستدعي لاختيار صفوف الحزمة، ثم تُحذف مع الاستجابة. قراءة محدودة واحدة لا تبقى داخل عمليتك — معرّف التتبع ومعرّف المقطع اللذان وضعتهما خدمة أخرى مزوّدة بالقياس في الطلب — لا يُعتمد كلٌّ منهما إلا إذا طابق تمامًا الشكل الذي تنشئه الحزم، ثم يُنقل أو يُرفع مع مدد الطلب ليُقرأ الإجراء العابر لخدماتك بوصفه إجراءً واحدًا. قراءتان تُرسل ما تحمله إلى Boosthis — مفتاح رابط المالك الوحيد، boosthis، في عنوان الصفحة؛ وملفا cookie الخاصان بالمالك لدى الحزمة — وما يُرسل ليس إلا اعتمادًا أصدره Boosthis نفسه، يُعاد إليه للتحقق في اتصال مستقل، لا ضمن أي رفع. قراءة واحدة غير محدودة ولا تُختزل إلى رقم، وتطلبها بنفسك: الشيفرة التي ترسلها إلى مطابِق القواعد في الحزمة. باستثناء معرّف التتبع ومعرّف المقطع اللذان وضعتهما خدمة أخرى مزوّدة بالقياس في الطلب؛ مفتاح رابط المالك الوحيد، boosthis، في عنوان الصفحة؛ وملفا cookie الخاصان بالمالك لدى الحزمة، لا يُخزّن أو يُرفع ما يُقرأ هنا، ولا يمكن استعادته مما يُرفع؛ ويرفض فاحص مسار الرفع أي حمولة تتضمن جسم طلب أو استجابة أو ترويسة أو cookie أو قيمة استعلام — ويُرفع هذان المعرّفان في حقلين مستقلين، لا كترويسة وصولهما، ويذهب إثبات المالك وتصريحه إلى Boosthis في اتصالات مستقلة، لا ضمن أي رفع.
ما الذي يظهر على صفحات مستخدميّ؟
الفقاعة العائمة لمالك التطبيق وحده، في كل حزمة. على الموقع المنشور لا ترسمها حزمة الخادم ولا حزمة المتصفح إلا في متصفح فُعّلت فيه برابط المالك من صفحة المشروع على Boosthis؛ وعلى جهاز المطوّر نفسه ترسمها حزمة الخادم في متصفح فتح إحدى صفحات التطبيق مع ?boosthis=on على ذلك الجهاز، وترسمها حزمة المتصفح على localhost. وترسمها حزمة الهاتف في نسخ التطوير فقط. ويوقفها ?boosthis=off أو زر الإيقاف داخل الفقاعة في ذلك المتصفح. لا يُظهرها أي إعداد لأي شخص آخر. ضبط BOOSTHIS_BUBBLE على 0 يخفيها في كل مكان مع استمرار الحزمة في القياس؛ أما BOOSTHIS_DISABLED فيوقف الحزمة تمامًا.
الحزم التي ترسمها: Node.js، Python، Go، Java، PHP، Ruby، .NET، Rust، Elixir، Browser / web، React Native / Expo، Flutter، Swift / iOS، Kotlin / Android. الحزم التي لا تُظهر شيئًا لمستخدميك: Edge / V8 isolates.
ما تلمسه الحزمة أيضًا في الصفحة
- عنصر واحد بجذر ظل مغلق. الفقاعة عنصر div واحد يحمل data-boosthis-bubble وجذر ظل مغلقًا بداخله. أنماطها في عنصر style داخل الجذر، فلا تؤثر في صفحتك ولا تؤثر أنماط صفحتك فيها. لا يُضاف أو يُنقل أو يُعدّل نمط أي عنصر آخر.
- تخزين الويب ضمن مساحة أسماء واحدة. كل ما تحفظه الحزمة يقع تحت بادئة boosthis: في localStorage؛ وإذا تعذّر الوصول إليه تستخدم الذاكرة. لا تقرأ مفتاحًا خارج البادئة ولا تسرد المفاتيح.
- دون ملفات تعريف ارتباط. لا تقرأ الحزمة document.cookie ولا تكتبه؛ ولا تحمل التقارير المرفوعة بيانات اعتماد الزائر، بل مفتاح المشروع الذي ضبطته فقط.
- مستمع سلبي لسياسة الأمان. تستمع الحزمة لحدث securitypolicyviolation في المتصفح لتكتب سطرًا في وحدة التحكم إذا منعتها سياستك. لا يقع الحدث إلا عند المنع، فلا يضيف عملًا أو طلب فحص لصفحة بلا سياسة.
ماذا تضع على نطاقي؟
تربط الحزمة عناوين داخل تطبيقك على النطاق الذي تنشر إليه. معظمها يستجيب للطلبات المحلية فقط. هذه العناوين لا تجيب إلا متصفحك الذي فُعّل برابط المالك من صفحة مشروعك على Boosthis، أو اتصالًا مباشرًا من الجهاز نفسه؛ ويحصل أي شخص آخر على رد تطبيقك المعتاد لعنوان لا يعرفه: /_boosthis، /_boosthis/، /_boosthis/panel، /_boosthis/pulse.
التفاصيل لكل بيئة تشغيل، بما يعيده كل عنوان وما يستبعده، في ما تضيفه Boosthis إلى تطبيقك.
بماذا يجب أن تسمح سياسة Content-Security-Policy لديّ؟
أصل واحد، https://www.boosthis.com، في connect-src وscript-src. لا تحتاج إلى حرف بدل ولا تتصل الحزمة بمضيف آخر، والصفحة بلا سياسة لا تحتاج إلى تغيير.
connect-src— يحتاجه تحتاجه كل حزمة متصفح مهما كانت طريقة تثبيتها؛ يحمل عمليات الرفع. بدونه يرفض المتصفح كل رفع؛ تستمر الحزمة في العمل والقياس ولا يصل شيء.script-src— يحتاجه تحتاجه الصفحات التي تحمّل وسم الشيفرة الجاهز فقط. التثبيت المضمّن في بنائك لا يحتاجه لأن الشيفرة أصبحت جزءًا من بنائك. بدونه لا تُحمّل الشيفرة إطلاقًا ولا يُقاس شيء.style-src— تفي به تحتاجه الفقاعة الظاهرة على الصفحة فقط لتبدو صحيحة. تنشئ الحزمة عنصر style داخل جذر الظل أثناء التشغيل ولا تملك قيمة سماح استثنائية؛ لذا ترفضه سياسة ترفض الأنماط المضمنة. تظهر الفقاعة بلا أنماط؛ لكن القياسات تُؤخذ وتُرفع وتبقى في لوحتك. إن لم ترد توسيع style-src لعنصر من غير شيفرتك، فأخفِ الفقاعة بدل السماح بالأنماط المضمنة في صفحتك كلها.script-src-attr— تفي به لا تحتاجه للقياس. يحمل وسم الشيفرة الجاهز سمة onerror مهمتها كتابة سطر في وحدة التحكم إن لم يصل ملف الحزمة؛ والسياسة الصارمة تمنع معالجات الأحداث المضمنة (أو يقيّدها script-src إن لم تضبط script-src-attr). بدونه لا يظهر سطرنا في وحدة التحكم؛ اقرأ تقرير انتهاك سياستك إن كانت الشيفرة محظورة أو أخطأت في عنوانها.
في سياستك، هذا شكل توضيحي: أضف الأصل إلى توجيهاتك الحالية لا تلصق السطر كسياسة مستقلة؛ ترمز … إلى المصادر التي تسمح بها بالفعل. توجيه script-src ثانٍ بعد الأول يضيّقه ولا يوسّعه.
connect-src … https://www.boosthis.com; script-src … https://www.boosthis.com;هناك توجيهان إضافيان لا يلزم أي منهما لوصول قراءة واحدة: style-src وscript-src-attr. السماح بـ 'unsafe-inline' فيهما يوسّع سياستك فعلًا لشفرة طرف آخر؛ لذلك نوضح كلفة إبقاء سياستك الصارمة بدل طلب توسيعها.
وسم الشيفرة الجاهز للصفحات بلا خطوة بناء يُقدَّم من https://www.boosthis.com/kit.js، وهو الأصل نفسه.
كل عنوان ترفع إليه الحزمة تحت https://www.boosthis.com/api
/installs/consent— معرّف التثبيت واسم بيئة التشغيل وإصدار الحزمة ونمط الجمع الذي طلبته شيفرة هذا البناء واسم العرض إن وُجد. يُرسل مفتاح المشروع في ترويسة. هذا أول اتصال./samples— قراءات زمنية فردية بوصفها أرقامًا مرتبطة بتسمية المسار./snapshots— ملخص دوري لمقاييس هذا التثبيت./crashes— تقارير الأعطال والأخطاء بعد تمرير الرسالة والمكدّس عبر قائمة الحظر في الحزمة./spans— مقاطع التتبع — طريقة وتسمية مسار لكل مقطع، دون URL أو جسم طلب./candidates— قواعد مرشحة رصدتها الحزمة بمصطلحات من قائمة مغلقة./resolutions— ما إذا توقفت مشكلة أُبلغ عنها سابقًا./job-runs— مدد تشغيل مهام الخلفية والمهام المجدولة حيث تراقبها الحزمة. لحزم الخادم والجهاز فقط./installs/forget— معرّف التثبيت وtoken الخاص به فقط — وسيلة المحو، والعنوان الوحيد الذي يطلبه شخص عمدًا.
يقرأ فحص بنائنا العناوين من مصادر الحزم ويفشل إن أغفلت القائمة عنوانًا تستخدمه حزمة أو ذكرت عنوانًا لا تستخدمه أي حزمة.
أي مفتاح تحتاج إليه، وماذا يحدث إن تسرّب؟
مفتاح مشروع واحد تُنشئه من صفحة مفاتيح المشروع في لوحة Boosthis. تقرأه حزم الخادم من البيئة — BOOSTHIS_PROJECT_KEY إن لم يُربط اسم أكثر تحديدًا — فلا ينتقل ضمن شيء ينزّله المستخدم.
the React Native kit، the browser kit، the Flutter kit، the Swift kit، the Kotlin kit مختلفة: يستقر مفتاحها داخل بناء منشور يمكن لأي حامل لنسخة التطبيق قراءته. نُنشئه بأضيق صلاحيات متاحة:
يمكن لمفتاح مستخرج من بناء منشور أن يسجّل تثبيتات ضمن المشروع ويرسل قراءات مختلقة إلى مقاييسه. لا يستطيع قراءة تلك المقاييس أو القياسات أو التتبعات أو البنية أو التغطية أو نتائج التعرض عبر اتصال الذكاء الاصطناعي لدى Boosthis؛ ولا يصل إلى حساب أو فوترة أو فريق أو مشروع آخر.
يمكنك إبطال مفتاح منشور وحده من صفحة مفاتيح المشروع في لوحة Boosthis دون إيقاف مفاتيح الحساب الأخرى.
كيف أعرف أن البايتات التي تلقيتها منكم؟
افهم ما يثبته الفحص وشغّل الأمر المطابق لما نزّلته: توجد صيغتان للأرشيف، والأمر الخاطئ لن يجد ملفًا يفحصه.
Node.js، Python، Go، Java، PHP، Ruby، .NET، Rust، Elixir، Browser / web، Flutter، Swift / iOS، Kotlin / Android، Edge / V8 isolates
يحمل الأرشيف BOOSTHIS_CHECKSUMS.txt بقيمة SHA-256 لكل ملف. من المجلد الذي فككت الأرشيف فيه:
sha256sum -c BOOSTHIS_CHECKSUMS.txtعلى macOS دون GNU coreutils، يؤدي shasum -a 256 -c BOOSTHIS_CHECKSUMS.txt الفحص نفسه. لا يحتاج شبكة ولا حسابًا ولا أدوات Boosthis.
React Native / Expo
لا يحمل هذا الأرشيف قائمة بصمات. تحفظ أداة التعبئة بصمة كل ملف في boosthis-kit-manifest.json في جذر الأرشيف، ويحمل الأرشيف أداة تعيد فحصها بعد فكّه:
node lib/boosthis-runtime-rn/cli/init.js verify .الفحص نفسه دون اتصال، مقابل ملف مختلف. سيفشل sha256sum -c BOOSTHIS_CHECKSUMS.txt هنا لأن الملف الذي يتوقعه ليس في هذا الأرشيف.
ما يثبته الفحصان: كل ملف يسميه الأرشيف موجود على قرصك مطابقًا بايتًا ببايت لحظة تعبئته. يكشفان التنزيل الناقص وفشل كتابة ملف وحذف جزء أثناء النقل؛ ولا يثبتان شيئًا عن ملفات لا يسميها السجل. فكّ الأرشيف في مجلد فارغ حتى لا تبقى ملفات من نسخة سابقة خارج الفحص.
ما لا يثبته أي منهما: مصدر البايتات. يسافر السجل داخل الأرشيف الذي يصفه، ويستطيع من يغيّر الأرشيف تغيير سجله أيضًا.
ما يثبته: قائمة الإصدار الموقَّعة. ننشر بجانب أرشيف كل حزمة قائمة إصدار تضم بصمة SHA-256 للأرشيف كما يُقدَّم ولكل ملف فيه مع رقم الإصدار، موقَّعة بمفتاح توقيع إصدارات Boosthis. تنزّل خطوات التثبيت التي نقدّمها هذه القائمة وتوقيعها وملف الموقّعين، وتفحص التوقيع بالأمر ssh-keygen -Y verify ثم تفحص الأرشيف مقابل القائمة، وتتوقف والأرشيف ما زال مغلقًا إن فشل أحد الفحصين.
تُوقَّع الإصدارات الجديدة بالمفتاح kr-2026-10-c وبصمته SHA256:9U7YAkn2DM2UqngyJxMB6hlzO8Puql0cb6aa9Jb885w. يحمل ملف الموقّعين في https://www.boosthis.com/.well-known/boosthis-kit-release-keys نصفه العام وسجل المفاتيح السابقة وما أُبطل منها، ويسمّي security.txt المفتاح نفسه.
مفتاح التوقيع محفوظ بعيدًا عن النشر الذي يقدّم التنزيلات: يتوقف بناء الإنتاج عندنا إذا رأى المفتاح، فلا يستطيع من يغيّر ذلك النشر أن يوقّع إصدارًا. وحدّ ذلك بوضوح: ملف الموقّعين يُقدَّم من موقعنا أيضًا، فالتثبيت الأول يثق بموقعنا في المفتاح. أما المشروع الذي يحتفظ بالملف boosthis-kit-release-keys ويحذف سطر تنزيله في التحديثات اللاحقة فيبقى يفحص مقابل المفتاح الذي لديه، مهما قدّم موقعنا لاحقًا.
إن حصلت على الحزمة من طريق آخر، نسخة ملصوقة أو محوّلة أو عبر اتصال ذكاء اصطناعي لم تفتحه بنفسك، فلا يثبت فحص البصمات إلا سلامة النسخة لا أنها نسختنا. نزّلها مجددًا من لوحتك، حيث تفحص الخطوات التوقيع.
ما أول اتصال بالشبكة، ومتى يحدث؟
طلب POST إلى https://www.boosthis.com/api/installs/consent، يحمل معرّف التثبيت واسم بيئة التشغيل وإصدار الحزمة ونمط الجمع الذي طلبته شيفرة البناء واسم العرض إن وُجد. يُرسل مفتاح المشروع في ترويسة.
يحدث عند التهيئة لا بعد فعل بشري: لا لافتة أو نقرة أو حوار موافقة قبله، لأنه يُبلغنا بوجود تثبيت لمشروعك. لا يجري تثبيت بلا مفتاح مشروع أي اتصال.
تسجّل صفحة المتصفح خلال ثوانٍ قليلة بعد تحميلها، وتسجّل حزمة الهاتف بعد فتح التطبيق بقليل؛ وتظهران فورًا تقريبًا. أما حزمة الخادم فتسجّل عند أول طلب حقيقي للخدمة لا عند بدء التشغيل؛ لذا فإن خدمة بدأت ولم تُطلب بعد تظهر بلا تسجيل، وهو متوقع وليس عطلًا.
إن لم تكفِك هذه الإجابات
- ما يجمعه Boosthis داخل تطبيقك — كل حقل، وأين يُعالَج ومدة الاحتفاظ به وصياغة جاهزة للصق في سياسة الخصوصية لديك.
- ما تضيفه Boosthis إلى تطبيقك — العنصر المرئي وكل عنوان يبدأ تطبيقك بالاستجابة له، حسب بيئة التشغيل.
- سياسة الخصوصية و شروط الخدمة — المرجع القانوني. تصف هذه الصفحة السلوك وتحكمه الوثيقتان.
- support@boosthis.com — يصل سؤالك عن نشرك إلى شخص.