الويب

استخدام Matrix في متصفحك.

يمكن تشغيل Matrix كتطبيق ويب داخل متصفحك، ليمنحك تجربة البرمجة القوية بالذكاء الاصطناعي نفسها دون الحاجة إلى terminal.

Matrix Web - جلسة جديدة

البدء

ابدأ تشغيل واجهة الويب عبر تنفيذ:

matrix web

يؤدي ذلك إلى تشغيل خادم محلي على 127.0.0.1 بمنفذ عشوائي متاح، ويفتح Matrix تلقائيا في المتصفح الافتراضي لديك.

يمكنك ضبط خادم الويب باستخدام خيارات CLI أو عبر ملف الإعدادات.

افتراضيا، يختار Matrix منفذا متاحا. يمكنك تحديد منفذ:

matrix web --port 4096

افتراضيا، يرتبط الخادم بـ 127.0.0.1 (للاستخدام المحلي فقط). لجعل Matrix متاحا على شبكتك:

matrix web --hostname 0.0.0.0

عند استخدام 0.0.0.0 سيعرض Matrix كلا من عناوين الوصول المحلي وعناوين الشبكة:

  Local access:       http://localhost:4096
  Network access:     http://192.168.1.100:4096

فعّل mDNS لجعل خادمك قابلا للاكتشاف على الشبكة المحلية:

matrix web --mdns

يضبط ذلك تلقائيا اسم المضيف إلى 0.0.0.0 ويعلن عن الخادم باسم matrix.local.

يمكنك تخصيص اسم نطاق mDNS لتشغيل عدة نسخ على الشبكة نفسها:

matrix web --mdns --mdns-domain myproject.local

للسماح بنطاقات إضافية عبر CORS (مفيد للواجهات الأمامية المخصصة):

matrix web --cors https://example.com

لحماية الوصول، عيّن كلمة مرور عبر متغير البيئة MATRIX_SERVER_PASSWORD:

MATRIX_SERVER_PASSWORD=secret matrix web

اسم المستخدم الافتراضي هو matrix، ويمكن تغييره عبر MATRIX_SERVER_USERNAME.

بعد التشغيل، تتيح لك واجهة الويب الوصول إلى جلسات Matrix الخاصة بك.

اعرض جلساتك وأدرها من الصفحة الرئيسية. يمكنك رؤية الجلسات النشطة وبدء جلسات جديدة.

Matrix Web - جلسة نشطة

انقر على “See Servers” لعرض الخوادم المتصلة وحالتها.

Matrix Web - See Servers (عرض الخوادم)

يمكنك إرفاق واجهة terminal (TUI) بخادم ويب قيد التشغيل:

# ابدأ خادم الويب
matrix web --port 4096

# في محطة طرفية أخرى، اربط TUI
matrix attach http://localhost:4096

يتيح لك ذلك استخدام واجهة الويب وterminal في الوقت نفسه، مع مشاركة الجلسات والحالة نفسها.

يمكنك أيضا ضبط إعدادات الخادم داخل ملف الإعدادات matrix.json:

{
  "server": {
    "port": 4096,
    "hostname": "0.0.0.0",
    "mdns": true,
    "cors": ["https://example.com"]
  }
}

تكون خيارات CLI ذات أولوية أعلى من إعدادات ملف الإعدادات.