التفضيلات
نظرة عامة
حوار التفضيلات هو نقطة الدخول الموحدة لكل الإعدادات العامة للمحرر — كل ما هو ليس جزءاً من المشروع المفتوح بل يضبط المحرر نفسه، الاتصال ببيئة التشغيل، والسلوك بعد الرفع.
افتح الحوار عبر Edit > Preferences... (تضعه بعض السمات تحت
Tools > Preferences... بدلاً من ذلك). اضغط F1 أثناء تركيز الحوار
لفتح هذه الصفحة مباشرة.
Preferences
+-- Editor (font, tab width, line numbers)
+-- Runtime (anvild host/port, Anvil debug, network scanner)
+-- PLC (build mode, auto-start, persist, monitoring)
+-- AI Assistant (LLM endpoint, tokens, temperature)
المحرر
يتحكم في كيفية ظهور النص في محرر كود ST وكل حقل إدخال نصي آخر.
| الحقل | المعنى |
|---|---|
| الخط | عائلة الخط. تمت تصفيتها مسبقاً للخطوط ذات العرض الثابت (مُوصى بها: JetBrains Mono، Cascadia Code، Consolas). |
| حجم الخط | حجم الخط بالنقاط. الافتراضي 10. |
| عرض Tab | عدد المسافات لكل علامة جدولة. الافتراضي 4. |
| إظهار أرقام السطور | يعرض أرقام السطور في هامش محرر الكود. |
وقت التشغيل
الاتصال ببرنامج خفي anvild وتشخيص IPC.
| الحقل | المعنى |
|---|---|
| المضيف | اسم مضيف PLC أو IP. الافتراضي localhost. |
| المنفذ | منفذ gRPC لـ anvild. الافتراضي 50051. |
| المستخدم | اسم المستخدم لمصادقة الرمز. |
| Anvil Debug | مستوى تشخيص IPC (Off، Errors only، Verbose). يضيف إحصائيات إضافية لسجل anvild — مفيد لتعقّب انحراف موضوع Iceoryx في الإنتاج. |
بالإضافة: الاتصال التلقائي عند البدء يتصل تلقائياً بآخر anvild متصل بنجاح عند بدء المحرر — مفيد على حاسوب هندسة مخصص.
تقوم كتلة ماسح الشبكة في نفس التبويب بمسح LAN بحثاً عن أجهزة Modbus TCP (المنفذ 502) وبيئات تشغيل ForgeIEC (المنفذ 50051) وتُدرج النتائج في تكوين الناقل.
PLC
يتحكم في ما يحدث بعد الرفع إلى PLC.
| الحقل | المعنى |
|---|---|
| وضع الترجمة | Development (المراقبة الحية + الفرض مفعّلان) أو Production (ثنائي مجرّد، بدون جسور تصحيح — حد أمني). |
| التشغيل التلقائي لـ PLC | يبدأ تلقائياً بيئة تشغيل PLC بعد رفع ناجح، يتجاوز حوار التأكيد. |
| تفعيل الاحتفاظ | يفعّل الاحتفاظ الدوري لمتغيرات VAR_PERSIST/RETAIN إلى /var/lib/anvil/persistent.dat. القيم تصمد أمام إعادة تشغيل بيئة التشغيل. |
| فترة استقصاء الاحتفاظ | الثواني بين تمريرات الحفظ التلقائي (الافتراضي 5 s). |
| سجل المراقبة | عدد العينات لكل متغير في مسجل الأوسيلوسكوب (الافتراضي 1000). |
| فترة المراقبة | فترة العينة بالميلي ثانية للمراقبة الحية (الافتراضي 100 ms). |
المكتبة
سلوك المزامنة للمكتبة القياسية بين مورد المحرر ومسار المكتبة على جانب PLC — انظر المكتبة لنموذج الانحراف الكامل. وضعان:
- Auto-Push معطّل (افتراضي) — عند الاتصال يسجل المحرر
تلميحاً في لوحة الإخراج فقط عند اكتشاف انحراف. الدفع
يحدث يدوياً عبر
Tools > Sync Library. - Auto-Push مفعّل — عند كل انحراف مكتشف يدفع المحرر إصدار مكتبته المحلي تلقائياً. مفيد في إعداد مبرمج واحد.
مساعد الذكاء الاصطناعي
إكمال كود اختياري ضد خادم LLM محلي متوافق مع OpenAI (LM Studio، Ollama، llama.cpp، vLLM).
| الحقل | المعنى |
|---|---|
| تفعيل مساعد الذكاء الاصطناعي | يبدّل الإكمال الداخلي. |
| نقطة نهاية API | نقطة نهاية متوافقة مع OpenAI، مثل http://localhost:1234/v1. |
| الحد الأقصى للرموز | حد الاستجابة لكل طلب. الافتراضي 2048. |
| درجة الحرارة | Precise (0.1)، Balanced (0.3)، Creative (0.7)، Wild (1.0). |
حالة UX (محفوظة تلقائياً)
تُخزّن الحقول التالية في الخلفية بدون المرور عبر حوار التفضيلات، حتى يعيد المحرر فتح نفسه بالحالة التي تركته فيها بالضبط:
- هندسة النافذة + حالة النافذة (
windowGeometry،windowState) - مواضع المقسّم والترويسة (
splitterState،headerState) - ارتفاع لوحة الإخراج (
outputPanelHeight) - آخر مشروع مفتوح (
lastProject) وقائمة الملفات الأخيرة - حالة الجلسة: علامات تبويب POU المفتوحة، التبويب النشط، المؤشر وموضع التمرير لكل POU
تخزين الإعدادات
تُخزّن الإعدادات عبر QSettings الخاص بـ Qt، حسب المنصة:
| المنصة | المسار |
|---|---|
| Windows | السجل: HKCU\Software\ForgeIEC\ForgeIEC Studio |
| Linux | ~/.config/ForgeIEC/ForgeIEC Studio.conf |
| macOS | ~/Library/Preferences/io.forgeiec.studio.plist |
حذف ذلك الملف / مفتاح السجل يُعيد كل الإعدادات إلى الافتراضي — مفيد بعد ترقية فاشلة.
الامتدادات المخططة
قائمة المهام (العنقود R المرحلة 3): ستحصل لوحة الإخراج على ألوان
شدة خاصة بها (أحمر للخطأ، أصفر للتحذير، أبيض للمعلومات) وحجم خط قابل
للضبط. كلا الخيارين سيظهران هنا في تبويب Output جديد.
مواضيع ذات صلة
- المكتبة — سلوك المزامنة بين المحرر وبيئة التشغيل.
- تكوين الناقل — إعدادات على مستوى المشروع لا تعيش هنا بل على شريحة الناقل / الجهاز نفسه.