بروتوكول خدمة النماذج المحلية (LMSP)

مسودة 1.0
آخر تحديث 8 نوفمبر 2026
عرض بصيغة Markdown

ماذا يفعل LMSP

LMSP (اختصار Local Model Service Protocol) بروتوكول مفتوح للبرمجيات التي تشغّل نماذج اللغة على جهاز المستخدم نفسه أو على شبكته المحلية، وللعملاء الذين يستخدمون تلك البرمجيات.

تصف الخدمة المحلية المقيمة نفسها عند عنوان معروف (well-known) وتسرد نماذجها. وتجيب عن طلبات التوليد بصيغة JSON أو بأحداث يرسلها الخادم، وتشغّل عمليات التوليد الطويلة بوصفها مهامَّ محفوظة يمكن إلغاؤها ومتابعتها من جديد بعد انقطاع الاتصال. وتتحدث الخدمة نفسها كذلك واجهة OpenAI البرمجية، فيستمر عمل العملاء الموجودين اليوم.

LMSP لا يحل محل واجهة OpenAI البرمجية ولا Ollama ولا MCP. إنه يجمع نقاط قوتها في طبقة بروتوكول مصممة للخدمات المحلية المقيمة.

نظرة سريعة

الموضوع	الخلاصة
العنوان الافتراضي	`http://127.0.0.1:17832`
وصف الخدمة	`GET /.well-known/lmsp.json`
الواجهة الأساسية	`/lmsp/v1`، صيغة JSON عبر HTTP، والبث بالأحداث التي يرسلها الخادم
واجهات التوافق	`/v1` لعملاء OpenAI، و`/api` الاختيارية لعملاء Ollama
الاكتشاف	عنوان يدوي، وفحص العناوين المحلية، وmDNS وDNS-SD الاختياريان (`_lmsp._tcp.local.`)
المصادقة	رموز Bearer يُحصل عليها بالاقتران المحلي
الحفظ الدائم	SQLite مضمّنة، مع مهام تنجو من إعادة التشغيل
العقد	OpenAPI 3.2

جرّبه

إن كانت خدمة LMSP تعمل على جهازك، فهذه هي الدورة كاملة. أجرِ الاقتران أولًا للحصول على رمز، كما هو موضح في القسم 10.2، واحفظه في LMSP_TOKEN.

# 1. اكتشاف الخدمة
curl http://127.0.0.1:17832/.well-known/lmsp.json

# 2. سرد النماذج المحلية
curl http://127.0.0.1:17832/lmsp/v1/models \
  -H "Authorization: Bearer $LMSP_TOKEN"

# 3. توليد استجابة
curl http://127.0.0.1:17832/lmsp/v1/responses \
  -H "Authorization: Bearer $LMSP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen3:14b-q4_k_m","input":[{"type":"message","role":"user","content":[{"type":"input_text","text":"Hello"}]}]}'

البروتوكول	ما يغطيه	علاقته بـ LMSP
واجهة OpenAI البرمجية	النماذج المستضافة. وواجهة Responses هي أحدث واجهاتها.	يتبع LMSP بنية Responses في واجهته الأساسية، وتعرض الخدمة إلى جانبها واجهة متوافقة مع OpenAI.
Ollama	بيئة تشغيل محلية تقدّم أصلًا نقاط نهاية متوافقة مع OpenAI.	يمكن أن تقف خلف خدمة LMSP بوصفها محوّلًا، ويحدد LMSP نقاط نهاية اختيارية متوافقة مع Ollama.
MCP	يربط الوكلاء بالأدوات والسياق.	يربط LMSP الوكلاء بالنماذج. وكلاهما يفضّل الاكتشاف عديم الحالة على الجلسات الإلزامية.
A2A	التعاون بين الوكلاء.	يستعير LMSP بطاقات الخدمة وحالات المهام الصريحة لوصف الخدمة ولمهامه.

الموارد

المواصفة، الإصدار 1.0 (مسودة).
عقد OpenAPI، بصيغة JSON أو YAML.
llms.txt وllms-full.txt، للنماذج اللغوية.
كل صفحة متاحة بصيغة Markdown. استبدل الشرطة المائلة الأخيرة في عنوانها بـ .md، مثل /ar/lmsp/1.0/tasks.md.

المواصفة 1.0

نظرة عامة
نظرة عامة على مسودة LMSP 1.0. ما هو بروتوكول خدمة النماذج المحلية، والتصاميم التي يبني عليها، وبنيته الطبقية، وكيفية قراءة المواصفة، والمصطلحات المستخدمة في النص كله.
النقل والنشر
عناوين الاستماع الافتراضية والنقل وصيغة البث وتخطيط عناوين URL لخدمة LMSP، وكيف تعمل بوصفها خدمة لنظام التشغيل منفصلة عن عمليات النماذج.
اكتشاف الخدمات
كيف يعثر عملاء LMSP على خدمة محلية عبر الإعداد اليدوي وفحص عناوين loopback وmDNS/DNS-SD الاختياري، وكيف تُقرأ وثيقة وصف الخدمة المعروفة well-known.
نقاط النهاية
الجدول الكامل لنقاط نهاية LMSP 1.0 بطريقة كل منها ومسارها ومستوى إلزامها وغرضها، مع اصطلاحات المسارات والمصادقة ونقاط النهاية الاختيارية.
فهرس النماذج
كيف تسرد خدمة LMSP نماذجها المحلية، وكائن النموذج ورايات قدراته، وحالات دورة حياة النموذج، ومعرّفات النماذج الثابتة، ونسخ الفهرس.
الاستجابات والبث
واجهة المحادثة الأساسية في LMSP، بطلبات وعناصر مخرجات على نمط Responses، وتوليد متزامن ومبثوث، وأنواع أحداث يرسلها الخادم، ومعرّفات الأحداث، وإعادة الاتصال، واستدعاءات الأدوات.
المهام غير المتزامنة
كيف يشغّل LMSP عمليات التوليد الطويلة بوصفها مهام محفوظة، مع إنشاء المهام وآلة حالاتها والإلغاء الآمن عند التكرار وتدفقات الأحداث وسياسات إعادة التشغيل للمهام غير المنتهية.
التوافق مع OpenAI وOllama
كيف تبقى خدمة LMSP متوافقة مع عملاء OpenAI وOllama الحاليين عبر طبقة رقيقة لتحويل البيانات فوق نواة تنفيذ واحدة، وأين ينتهي هذا التوافق.
القواعد العامة
قواعد تشترك فيها كل نقاط نهاية LMSP، وهي ترويسات الإصدار والامتدادات ومفاتيح التكرار الآمن وصيغة الأخطاء problem+json مع رموزها وفحص الصحة.
الأمان المحلي
متطلبات الأمان لخدمات LMSP، وتشمل الارتباط بعنوان loopback والاقتران ورموز Bearer والنطاقات وفحوص Origin وHost ضد صفحات الويب الخبيثة ووضع LAN وقواعد التسجيل.
الحفظ الدائم
كيف تخزّن خدمة LMSP حالتها، بقاعدة بيانات SQLite مضمَّنة، والجداول التي ينبغي الاحتفاظ بها، والقواعد المعاملاتية للمهام والأحداث، ومدة الاحتفاظ، والاستعادة عند البدء.
الحد الأدنى القابل للتطبيق
نطاق مقترح لأول تنفيذ لـ LMSP، يضم القطع العشر التي تشكّل حلقة مغلقة قابلة للاستخدام، وأجزاء المواصفة التي يمكن أن تنتظر الإصدارات اللاحقة.

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

ما هو LMSP؟

LMSP، أي Local Model Service Protocol (بروتوكول خدمة النماذج المحلية)، بروتوكول مفتوح لخدمات نماذج اللغة التي تعمل على جهاز المستخدم نفسه أو على شبكته المحلية. وهو يحدد كيف يكتشف العملاء الخدمة، ويسردون نماذجها، ويطلبون الاستجابات، ويستقبلون المخرجات مبثوثة، ويشغّلون المهام الطويلة.

هل يحل LMSP محل واجهة OpenAI البرمجية أو Ollama أو MCP؟

لا. يبني LMSP عليها. فواجهته الأساسية تتبع بنية OpenAI Responses، ويمكن للخدمة أن تعرض نقاط نهاية متوافقة مع OpenAI وOllama، ويستعير البروتوكول الاكتشاف عديم الحالة من MCP وحالات المهام من A2A.

هل يمكن لعملاء OpenAI الحاليين استخدام خدمة LMSP؟

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

كيف يعثر العميل على خدمة LMSP محلية؟

يجرب ثلاثة أمور بالترتيب. أولًا عنوانًا يُدخل يدويًا، ثم العنوان المحلي المتعارف عليه الذي يطلب منه /.well-known/lmsp.json، وأخيرًا، اختياريًا، التصفح عبر mDNS وDNS-SD بحثًا عن _lmsp._tcp.local. على الشبكة المحلية.

هل خدمة النماذج على localhost آمنة؟

ليس تلقائيًا، لأن صفحات الويب قد تحاول الوصول إلى المنافذ المحلية. تلتزم خدمات LMSP افتراضيًا بعنوان loopback، وتشترط رموز Bearer يُحصل عليها بالاقتران المحلي، وتتحقق من ترويستي Origin وHost، وتشترط المصادقة في وضع LAN.

ما حالة المواصفة؟

الإصدار 1.0 هو أول مسودة عامة، وقد يتغير بما لا يتوافق مع النسخة الحالية. النص الإنجليزي هو المعتمد، والترجمات مقدمة للتيسير.