# حصر إعدادات الموارد في Terminal-Bench

تاريخ الإنشاء: 2026-11-17
تاريخ التحديث: 2026-11-17

## السؤال ومجتمع الدراسة

ما التصريحات الخاصة بالمهام التي سيغيرها إعداد واحد لبيئة معزولة في Terminal-Bench v4.1.0؟ تقارن هذه الدراسة الإعدادات المنشورة حتى تتمكن فرق التقييم من اختيار إعداد لبيئة التنفيذ وتوثيقه. وهي لا تقدّر الاستخدام الفعلي للموارد أو الحد الأدنى للأجهزة أو السعر أو مدة الإكمال أو أداء النموذج أو احتمال الإخفاق.

يشمل مجتمع الدراسة جميع المهام الـ 66 الواردة في قائمة الإصدار الرسمية v4.1.0، وليس كل ملف يشبه المهام في المستودع. نُشر الإصدار في 3 نوفمبر 2026. واطّلعنا على البيانات الوصفية للإعدادات في 17 نوفمبر 2026. تحدد [بطاقة مجموعة البيانات الرسمية](https://huggingface.co/datasets/harborframework/terminal-bench) الإصدار و[قائمة ملفاته](https://huggingface.co/datasets/harborframework/terminal-bench/resolve/v4.1.0/registry.json). وثُبّت المستودع المصدري عند الإيداع `4070d6cef56a7d20cb5dc98d5e10ada88a6b9440` في `harbor-framework/terminal-bench`.

قيمة SHA-256 لقائمة الإصدار هي `8809dc185dcb431e3a92ea1eaeb8f82ec63aa98050051815d0d6005ce2c99262`. تتضمن كل ملاحظة رابط مصدر مثبتًا وقيمة SHA-256 لملف المصدر الكامل `task.toml`. واستُبعدت المهام القديمة وملفات اختبار CI والقوالب غير الواردة في قائمة الإصدار. ولم تُشغّل أي مهمة أو حاوية أو نموذج أو نص برمجي للتحقق.

## الاستخراج

وحدة التحليل هي مهمة واحدة من قائمة الإصدار. يحلل برنامج الجمع ملفات TOML باستخدام مكتبة Python القياسية، ويسجل القيم المصرح بها على المستوى الأعلى لبيئة المهمة لكل من CPU والذاكرة والتخزين وGPU ونوع GPU وTPU ومهلة البناء. ويحافظ على الحقول المحذوفة بوصفها محذوفة. وتبقى قيم مهلة الوكيل ومهلة أداة التحقق منفصلة. وتُعد القيمتان العدديتان `1200` و`1200.0` متكافئتين في الأعداد الموجزة؛ بينما تحتفظ ملاحظات المصدر بنوع كل قيمة بعد تحليلها.

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

يبلغ إجمالي حجم ملفات TOML المصدرية الـ 66 مقدار 85,966 بايت. ويحتوي الاستخراج المنشور على حقائق مختارة عن الإعدادات وأسماء الحقول ومعرّفات المهام وقيم تجزئة المصادر. وهو يستبعد تعليمات المهام والحلول والاختبارات ومعلومات الاتصال بالمؤلفين وقيم متغيرات البيئة. ولا يُعاد توزيع ملفات المصدر الكاملة أو صور بيئات الاختبار ضمن هذه الحزمة.

## المقارنة المنشأة

اخترنا لكل من عدد وحدات CPU والذاكرة والتخزين وعدد وحدات GPU القيمة الصريحة الأكثر تكرارًا في تصريحات بيئات المهام الـ 66 على المستوى الأعلى: وحدتا CPU و4,096 MB من الذاكرة و10,240 MB من التخزين و0 من وحدات GPU. ويشكل جمع هذه القيم إعداد المقارنة الذي أنشأناه. وهو ليس إعدادًا افتراضيًا لـ Harbor أو توصية من مورد أو إعداد تقييم تمت ملاحظته.

تدخل المهمة ضمن مجموعة «أعلى من إعداد المقارنة» إذا كانت قيمة رقمية واحدة على الأقل من القيم المصرح بها صراحة أكبر من القيمة المقابلة في الإعداد. ونأخذ اتحاد معرّفات المهام، لا مجموع الأعداد لكل حقل. لا تُحسب قيم GPU المفقودة على أنها صفر ولا تنشئ حالة تتجاوز الإعداد. وتبقى المهام الثماني التي حُذف منها عدد وحدات GPU قابلة للتحديد في بيانات المصدر. يقيس اتحاد المهام الـ 38 اختلافًا في التصريحات؛ ولا يتنبأ بما إذا كان يمكن تشغيل المهمة أو اجتيازها وفق أي إعداد.

نحصي أيضًا أنماط التصريح المختلفة عبر عدد وحدات CPU والذاكرة والتخزين وعدد وحدات GPU ونوع GPU وTPU، مع استبعاد المهل. يبلغ العدد الخام للأنماط 27. ويؤدي تعيين عدد وحدات GPU المحذوف إلى صفر إلى خفض العدد إلى 22. ولهذه الحساسية تبدأ المقالة بحقول الموارد الفردية ومقارنة واضحة، بدلًا من عرض عدد الأنماط بوصفه عددًا لمتطلبات الأجهزة.

## تفسير برنامج التشغيل

راجعنا مصدر Harbor عند الإيداع `ec6aeab7fe0eb51df52b4e72c524daf5ea9cc5f4`، الذي تحدد بيانات المشروع الوصفية إصداره بأنه 0.26.0. هذه نتائج لقراءة الشيفرة، وليست تحققًا بتنفيذ جميع المهام أو أنظمة التنفيذ الخلفية.

- يترك [محلل المهام](https://github.com/harbor-framework/harbor/blob/ec6aeab7fe0eb51df52b4e72c524daf5ea9cc5f4/src/harbor/models/task/config.py#L435) أعداد وحدات CPU والذاكرة والتخزين وGPU قابلة لأن تكون فارغة، ويرحّل سلاسل الذاكرة والتخزين القديمة. وحقل إصدار المخطط لديه سلسلة نصية؛ ولا يثبت مسار ترحيل الإصدارات بحد ذاته أن كل مهمة قابلة للتنفيذ.
- تطبق [البيئة الأساسية](https://github.com/harbor-framework/harbor/blob/ec6aeab7fe0eb51df52b4e72c524daf5ea9cc5f4/src/harbor/environments/base.py#L468) إعدادات التجاوز الخاصة بالتجربة. ويُحوّل عدد وحدات GPU المحذوف إلى صفر هناك؛ ويمكن لسياسات تجاهل CPU والذاكرة أن تمنع تطبيق القيم. ونحتفظ بالحقول المحذوفة في مجموعة البيانات حتى عندما يحوّل برنامج التشغيل أحدها إلى قيمة.
- يستخدم [محلل إعدادات أداة التحقق](https://github.com/harbor-framework/harbor/blob/ec6aeab7fe0eb51df52b4e72c524daf5ea9cc5f4/src/harbor/models/task/verifier_mode.py#L15) بيئة أداة التحقق المقدمة كاملةً؛ وإلا فإنه ينسخ بيئة المهمة. ولا يدمج كتلة أداة تحقق صريحة مع إعدادات الوكيل حقلًا بحقل. ومع ذلك، يمرر [إنشاء التجربة](https://github.com/harbor-framework/harbor/blob/ec6aeab7fe0eb51df52b4e72c524daf5ea9cc5f4/src/harbor/trial/trial.py#L1104) إعدادات تجاوز البيئة.
- يحوّل [مكيّف Docker](https://github.com/harbor-framework/harbor/blob/ec6aeab7fe0eb51df52b4e72c524daf5ea9cc5f4/src/harbor/environments/docker/docker.py#L568) سياسات CPU والذاكرة التلقائية إلى حدود، ويتجاهل صراحة اختيار نوع GPU. ويكتب [برنامج إعداد موارد Compose](https://github.com/harbor-framework/harbor/blob/ec6aeab7fe0eb51df52b4e72c524daf5ea9cc5f4/src/harbor/environments/docker/__init__.py#L36) قيود CPU والذاكرة وعدد وحدات GPU، ولا يكتب حدًا أقصى للتخزين. وقد تتصرف إعدادات Compose الموجودة ومقدمو الخدمات الآخرون على نحو مختلف.
- يسمح [تحديد المهلة](https://github.com/harbor-framework/harbor/blob/ec6aeab7fe0eb51df52b4e72c524daf5ea9cc5f4/src/harbor/trial/trial.py#L695) و[حساب الميزانية](https://github.com/harbor-framework/harbor/blob/ec6aeab7fe0eb51df52b4e72c524daf5ea9cc5f4/src/harbor/trial/trial.py#L1724) بإعدادات التجاوز والحدود القصوى والمضاعفات. ولا تمثل تصريحات مهل الوكيل وأداة التحقق والبناء مددًا تمت ملاحظتها. ولا يُفترض أن مجموعها حد أقصى للمدة الإجمالية للتجربة.

لا يفحص هذا الحصر كل Dockerfile أو حاوية جانبية في Compose أو صورة أو خدمة خارجية. وقد تضيف هذه العناصر متطلبات وقيودًا للموارد خارج حقول الإعدادات على المستوى الأعلى. ولا تترتب على هذه الدراسة أي نتيجة بشأن صلاحية المعيار أو تغير الدرجات.

## إعادة الإنتاج

باستخدام Python 3.11 أو إصدار أحدث، شغّل `python3 census.py` لإعادة إنشاء `census-results.json` من `census.json` المقدم. وشغّل `python3 census.py --collect` لإعادة جلب قائمة الإصدار الثابتة وملفات TOML الـ 66 المثبتة قبل التحليل. يستخدم برنامج الجمع 3 عمليات قراءة متزامنة كحد أقصى، ويضع حدًا لحجم قائمة الإصدار قدره 300 KB ولكل مهمة قدره 100 KB، ويتوقف مع ظهور خطأ إذا اختلفت عضوية قائمة الإصدار أو قيمة تجزئتها المثبتة. ولا يُجري تعديلات لدى مقدم الخدمة ولا ينفذ الشيفرة التي ينزّلها.

شغّل `python3 render-assets.py` لإعادة إنشاء الشكلين الأصليين بصيغة SVG. يستخدم إنشاء الأشكال ReportLab؛ وقد أُخرجت النسخ الأصلية المنشورة باستخدام ReportLab 4.4.9 وPython 3.12.14. يقرأ شكل التوزيع نتائج التحليل مباشرة. والشكل الثاني مخطط أنشأه الباحث لسجل الإعدادات، وليس بيانات تجريبية. ويحتفظ ملفا SVG بالنصوص والعناوين والأوصاف المتاحة لإمكانية الوصول.

يستخدم معيار المصدر [Apache License 2.0](https://github.com/harbor-framework/terminal-bench/blob/4070d6cef56a7d20cb5dc98d5e10ada88a6b9440/LICENSE). وتبقى حقوق التأليف والنشر للمصادر مع مؤلفيها. تتضمن هذه الحزمة استخراج Sapien1 المختار للحقائق وتحليلها الأصلي؛ ولا تمنح حقوقًا في أصول مهام الجهات الخارجية أو محتويات الحاويات.
