سطر الأوامر و MCP

كل ما تفعله في BIMopen هو أمر. فالنقر على جدار ثم نقطتين في المسقط ينفذ الأمر wall نفسه الذي يمكنك كتابته بنفسك. يصف هذا الفصل سطر الأوامر في النافذة، وبرنامج bimopen-cli الذي ينفذ الأوامر نفسها دون نافذة، وخادم MCP الذي يستطيع من خلاله وكيل ذكاء اصطناعي أن ينمذج مشروعًا ويفحصه ويعرضه صورةً.

سطر الأوامر في النافذة

يقع سطر الأوامر تحت منطقة الرسم. جزؤه العلوي هو السجل؛ وصفه الأخير هو حيث تكتب.

• لا تحتاج إلى النقر عليه أولًا: فكل ما تكتبه ما دام لا يُحرَّر حقل آخر يذهب إليه.
• ينفذ Enter السطر. ويُعاد عرض الأمر في السجل بعد >، متبوعًا بنتيجته؛ ويُعرض الخطأ بالأحمر ولا يغيّر شيئًا.
• يستعيد Up وDown الأسطر المكتوبة من قبل.
• على يمين الصف، تقول المطالبة ما هو منتظر: Command: حين لا تكون هناك أداة نشطة، أو طلب الأداة النشطة، مثل WALL next point [Esc to finish]:.
• يسرد help كل أمر مع سطر من الوصف؛ ويعرض help wall طريقة استخدام أمر واحد. ويقوم ? ▸ الأوامر في شريط العنوان بما يقوم به help.

الاختصارات المكتوبة تبدأ الأدوات

الأمر المكتوب دون وسائط يبدأ الأداة التفاعلية، كما لو نقرت زرها: WA (أو wall) يبدأ أداة الجدار، وDR أداة الباب، وVG يفتح الرؤية/الرسومات. والأمر نفسه مع وسائط ينجز العمل فورًا، دون الأداة: wall 0,0 5,0 يرسم جدارًا من نقطة الأصل حتى 5 m على امتداد x.

أسماء الأوامر وصيغها المختصرة ووسائطها واحدة في كل لغات الواجهة؛ ويقبل معظمها أيضًا اسمًا إيطاليًا، مثل muro بدل wall. أما أسماء المعاملات وأسماء الأنواع وأسماء العروض فتتبع لغة الواجهة: ففي الإنجليزية تكتب set Unconnected Height 2.7m، وفي الإيطالية set Altezza non collegata 2.7m. ويسرد فصل اختصارات لوحة المفاتيح كل صيغة مختصرة.

النقاط والأطوال

مثلًا، يرسم wall 0,0 @6,0 @4<90 0,4 c مستطيلًا مقاسه 6 × 4 m؛ والحرف c في النهاية يغلقه.

الوسائط بصيغة JSON

يقبل كل أمر وسائطه أيضًا ككائن JSON، ما يتيح الوصول إلى كل خياراته. ويسردها سطر الاستخدام في help:

wall 0,0 10,0 {"height":3.2,"location":"Linea d'asse del muro"}
roof walls {"slope":30,"overhang":0.5}
sheet A102 Plans {"title_block":"A3"}
export doors.csv {"schedule":"doors"}

أوامر ستستخدمها كثيرًا

لكل عنصر رقم، هو معرّفه، يُعرض بين قوسين بعد إنشائه: Door «Single swing door 80x210» in wall 102 (106). وتقبله الأوامر حيث تحتاج إلى عنصر: params 106، delete 106.

bimopen-cli

يشغّل bimopen-cli برنامج BIMopen دون نافذة: لتحويل الملفات، أو لبناء مشروع من برنامج نصي، أو لفحص نموذج، أو لخدمة الوكلاء عبر MCP. ابنِه بالأمر cargo build --release -p bimopen-cli.

bimopen-cli info <file>
bimopen-cli convert <in> <out> [--level NAME] [--view 3d] [--schedule walls|doors|windows|floors|rooms|materials]
bimopen-cli run [<file> | --sample] [--cmd LINE]… [--script FILE] [--save FILE] [--export FILE]…
bimopen-cli commands
bimopen-cli mcp [<file> | --sample]

تكون الرسائل بلغة متغير البيئة BIMOPEN_LANG (it، en، de، fr، es، ar)، أو بلغة النظام (LANG)، أو بالإيطالية. وينتهي bimopen-cli بالرمز 0 حين ينجح كل شيء، و1 حين يفشل أمر (وتقول الرسالة أيّها)، و2 حين تكون الوسائط خاطئة (فيطبع طريقة الاستخدام).

export BIMOPEN_LANG=en
bimopen-cli run --script house.txt --save house.bimopen --export house.ifc
bimopen-cli convert house.bimopen plan.svg
bimopen-cli convert house.bimopen doors.csv --schedule doors
bimopen-cli convert house.bimopen first.png --level "First Floor"
bimopen-cli convert house.bimopen house-3d.png --view 3d
bimopen-cli convert project.rvt project.bimopen

البرنامج النصي ملف نصي فيه أمر واحد في كل سطر، تمامًا كما يُكتب في سطر الأوامر:

# a small house
wall 0,0 10,0 10,6 0,6 c
door 5,0
window 10,3
floor walls
roof walls

تُكتب الجداول بصيغة CSV مع ; بين الأعمدة، والعناوين بلغة الرسائل، وصف للإجمالي في النهاية.

MCP: BIMopen لوكلاء الذكاء الاصطناعي

يتيح بروتوكول سياق النموذج (MCP) لوكيل الذكاء الاصطناعي أن يستخدم البرامج كأدوات. وbimopen-cli mcp خادم MCP: يتحدث JSON-RPC 2.0 على الدخل والخرج القياسيين، رسالة واحدة في كل سطر، ويُبقي مشروعًا واحدًا مفتوحًا طوال المحادثة. ودون ملف يبدأ من مشروع جديد؛ أما --sample فيبدأ من المنزل النموذجي.

لإضافته إلى وكيل، أعطِ الوكيل الأمر الذي يشغّله. مثلًا، في Claude Code:

claude mcp add bimopen -- bimopen-cli mcp --sample

أو، في عميل يُهيَّأ بصيغة JSON:

{ "mcpServers": { "bimopen": { "command": "bimopen-cli", "args": ["mcp", "--sample"] } } }

يقدّم الخادم سبع أدوات:

تحمل الإجابات رسالة الأمر، وبياناته بصيغة JSON حين توجد، مثل معرّفات العناصر المنشأة. ويستطيع الوكيل أن يفحص عمله بنفسه بطلب صورة.