ورشة مجانية 21–22.11ورشة مجانية لمدة يومين في Vibecoding يومي 21–22 نوفمبر الساعة 16:00 بتوقيت موسكو · الدفعة 3 تبدأ 23.11سجّل مجاناً ←الدفعة 3 (23.11)
إصدارتحليل · على الرادارHabr AI→ المصدر

مطوّر من «هابر» يفكّ رموز أعلام llama.cpp: مرجع من 4 أجزاء، جزء واحد منها جاهز

llama.cpp برنامج لتشغيل الشبكات العصبية على حاسوبك الخاص، وتعليمات المساعدة المضمّنة --help شحيحة جدًا في شرح أعلامه. أمضى كاتب من «هابر» أسبوعًا في تحليل معاملات llama-cli وllama-completion وllama-server، مستعينًا بالشيفرة المصدرية للتحقق منها. ينقسم المرجع إلى 4 أجزاء: الأعلام العامة، وأخذ العيّنات (sampling)، وفك الترميز التخميني (speculative decoding)، وإعدادات الأدوات المنفردة. الجاهز حتى الآن جزء واحد فقط، وعلى القارئ انتظار البقية.

معالج بواسطة الذكاء الاصطناعي من Habr AI؛ بتحرير Hamidun News
مطوّر من «هابر» يفكّ رموز أعلام llama.cpp: مرجع من 4 أجزاء، جزء واحد منها جاهز
المصدر: Habr AI. كولاج: Hamidun News.
استمع للمقال
بطاقة الحقائق والأرقام
المعيارالتفاصيل
المصدر الأصليHabr AI ↗
رئيس التحرير
الجزء 1 — Common Paramsالأعلام العامة المشتركة بين الأدوات الثلاث
المرجع منسوخ أيضًا على GitHubنسخة روسية وأخرى إنجليزية، في صفحة واحدة لكل منهما
حقيقة رئيسية #3الأوصاف التي لا يتأكد منها الكاتب مرفقة بملاحظة تنبّه إلى احتمال عدم دقتها

llama.cpp برنامج شائع لتشغيل الشبكات العصبية مباشرة على حاسوبك أو خادمك، دون الاعتماد على السحابة. له عشرات الأعلام، لكن تعليمات المساعدة المضمّنة عبر الأمر --help تصف كل علم بسطر جاف واحد. والنتيجة أن كثيرين ينسخون مجموعة معاملات من دليل كتبه غيرهم دون أن يفهموا تمامًا ما الذي فعّلوه. قرر كاتب من «هابر» سدّ هذه الفجوة: فراجع خلال أسبوع جميع المعاملات وأعدّ مرجعًا بالروسية. يتألف المرجع من 4 أجزاء بحسب فئات الأعلام، ولم يُنشر حتى الآن سوى الجزء الأول.

ما الذي يشرحه المرجع بالضبط

يتناول المرجع ثلاث أدوات للاستدلال (inference)، أي تشغيل نموذج جاهز:

  • llama-cli — العمل مع النموذج في الطرفية (terminal) بصيغة حوار؛
  • llama-completion — توليد تكملة لنص انطلاقًا من بدايته؛
  • llama-server — تشغيل النموذج كخادم تتصل به برامج أخرى.

اتبع الكاتب مخرجات الأمرين «llama-cli --help» و«llama-server --help» وحافظ على الترتيب نفسه. لكل معامل ذُكر اسمه وقالبه ووصفه المختصر من التعليمات المضمّنة، ثم يليه تعليق مفصّل بأسلوب الكاتب. وبوسعك أن تُبقي الطرفية مفتوحة بجانب المرجع لمطابقة كل علم مع شرحه.

أجزاء المرجع الأربعة

Common Params — المعاملات العامة. تتطابق في معظمها بين الأدوات الثلاث، وهي أكبر الأجزاء. تبدأ السلسلة بها تحديدًا، وقد صدر المقال بالفعل ويعمل كفهرس لبقية الأجزاء.

Sampling Params — معاملات أخذ العيّنات، أي القواعد التي يختار النموذج بموجبها الكلمة التالية من بين الخيارات. وتشمل درجة الحرارة (temperature) وtop-p وtop-k وmin-p وغيرها. يعترف الكاتب بأنه فوجئ كثيرًا بعدد الطرق المتاحة في llama.cpp لضبط سلوك النموذج. هذه المادة ما زالت قيد الإعداد.

Speculative Params — إعدادات فك الترميز التخميني. تقوم الفكرة على أن نموذجًا مسودة (draft) صغيرًا وسريعًا يخمّن عدة رموز (tokens) تالية، ثم يتحقق منها النموذج الأساسي الكبير دفعة واحدة. إذا تأكدت التخمينات، يقبلها النموذج الكبير دون توليد خطوة بخطوة، فيظهر النص أسرع. هذا الجزء أيضًا قيد الإعداد.

Example-Specific Params — معاملات أدوات بعينها. فمثلًا، لدى llama-server إعدادات خاصة بالجانب الخادمي لا وجود لها في llama-cli وllama-completion. ويحذّر الكاتب من أن كلمة «خاصة» لا تعني «نادرة». فبين هذه الأعلام ما هو ضروري للعمل المنتظم، خصوصًا مع الخادم. هذا الجزء لم يُنشر بعد.

يخطط الكاتب تقريبًا لـ4 مقالات، لكنه لا يستبعد أن يزيد عددها.

كيف عمل الكاتب وما الذي يستحق الثقة

يقرّ الكاتب بصراحة بأنه لا يستخدم بنفسه كل ما في llama.cpp، وأنه راجع كثيرًا من المعاملات بمساعدة الذكاء الاصطناعي. لكنه لم ينسخ إجابات النماذج: حاول أن يفهم كيف يعمل المعامل وعلى ماذا يؤثر، وقرأ الشيفرة المصدرية عند الحاجة، ثم صاغ تعليقه. وحيث لم يتوفر اليقين الكافي، أُرفق الوصف بملاحظة تفيد بأنه قد يكون غير دقيق.

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

ماذا تفعل بهذا المرجع

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

القصة

أسئلة وأجوبة حول الخبر

ما أبرز التفاصيل حول ما الذي يشرحه المرجع بالضبط؟

يتناول المرجع ثلاث أدوات للاستدلال (inference)، أي تشغيل نموذج جاهز: llama-cli — العمل مع النموذج في الطرفية (terminal) بصيغة حوار؛ llama-completion — توليد تكملة لنص انطلاقًا من بدايته؛ llama-server — تشغيل النموذج كخادم تتصل به برامج أخرى. اتبع الكاتب مخرجات الأمرين «llama-cli --help» و«llama-server --help» وحافظ على الترتيب نفسه. لكل معامل ذُكر اسمه وقالبه ووصفه المختصر من التعليمات المضمّنة، ثم يليه تعليق مفصّل بأسلوب الكاتب. وبوسعك أن تُبقي الطرفية مفتوحة بجانب المرجع لمطابقة كل علم مع شرحه.

ما أبرز التفاصيل حول أجزاء المرجع الأربعة؟

Common Params — المعاملات العامة. تتطابق في معظمها بين الأدوات الثلاث، وهي أكبر الأجزاء. تبدأ السلسلة بها تحديدًا، وقد صدر المقال بالفعل ويعمل كفهرس لبقية الأجزاء. Sampling Params — معاملات أخذ العيّنات، أي القواعد التي يختار النموذج بموجبها الكلمة التالية من بين الخيارات. وتشمل درجة الحرارة (temperature) وtop-p وtop-k وmin-p وغيرها. يعترف الكاتب بأنه فوجئ كثيرًا بعدد الطرق المتاحة في llama.cpp لضبط سلوك النموذج. هذه المادة ما زالت قيد الإعداد. Speculative Params — إعدادات فك الترميز التخميني.

ما أبرز التفاصيل حول كيف عمل الكاتب وما الذي يستحق الثقة؟

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

ZK
جمال حميدون — مدير المنتجات في Alpina Digital ومدير منتج AlpinaGPT. يبني منتجات الذكاء الاصطناعي منذ 2019. بدأ Hamidun News كمشروع شخصي ثم أصبح مُجمِّعًا إنتاجيًا بأكثر من 6000 قارئ.
✦ Unified AI Workspace · Nomad

Test Frontier LLMs & Autonomous Agents in One Workspace

Run Claude Opus 5.5, GPT-6, Gemini 3.1, and DeepSeek side-by-side in Nomad AI (nomadnet.ai) — unified model routing, deep research, and multimodal workflows under one subscription.

Try Nomad AI →Launch Nomad Agent
ما رأيك؟
جارٍ تحميل التعليقات…