التوثيق

نظرة عامة

‏Vibe Terminal مركز طرفيات يُدار عن بُعد لتطوير الأنظمة المدمجة والخوادم. يعمل خادم واحد على كل جهاز تعمل عليه — جهاز تطوير، أو خادم بناء، أو لوحة مدمجة — ويتصل به العملاء من تطبيق سطح مكتب أو من سطر الأوامر. يغطي هذا الدليل الجانبين: واجهة الويب التي تضبط الخادم، والعملاء الذين يعملون معه.

كيف تتكامل المكونات

  • كل شيء يعمل على الخادم — جلسات الطرفية تعيش هناك، فإغلاق عميل أو انقطاع الشبكة أو إعادة ترتيب النوافذ لا يقطع أمرًا يعمل أبدًا؛ أعد الاتصال واستأنف من حيث توقفت؛
  • يتصل العملاء باتصال WebSocket مشفّر واحد (wss://host:port؛ وwss://localhost:7878 للخادم المحلي) ويصادقون بمفتاح الخادم السري؛ ويسلّم الاقتران المفتاح عبر رمز QR أو سلسلة مشاركة مشفّرة (انظر توصيل عميل)؛
  • واجهة الويب هي صفحة إعداد الخادم نفسه — الملفات الشخصية، والإضافات، ومزودو LLM، والمرحّل، وإعادة توجيه المنافذ وأكثر. وهي ليست طرفية: العمل اليومي يجري في عميل سطح المكتب أو vtermc.

المكونات

  • الخادم — يعمل على الجهاز الهدف؛ يستضيف جلسات الطرفية ويقدّم للعملاء المتصلين الملفات وGit وسطح المكتب البعيد والإدخال الصوتي وميزات الذكاء الاصطناعي؛
  • عميل سطح المكتب — مساحة العمل الأصلية: طرفيات مع تقسيمات ومجموعات تبويبات ونوافذ منفصلة، ومستكشف ملفات ومحرّر، وأدوات Git، وإدخال صوتي، وسجل محادثات وكيل الشيفرة، وسطح مكتب بعيد وتنقيح بعيد؛
  • vtermc CLI — بدء الجلسات والالتحاق بها من أي طرفية عادية، أو عبر SSH، أو على جهاز بلا شاشة؛ يتشارك قائمة خوادمه مع عميل سطح المكتب (انظر عميل سطر الأوامر)؛
  • واجهة الويب — إعدادات الخادم نفسه من المتصفح، منظّمة في أقسام في الشريط الجانبي الأيسر (انظر استخدام واجهة الويب).

أيقونة منطقة الإعلام

على الأجهزة ذات جلسة سطح المكتب، يعرض الخادم أيقونة في منطقة الإعلام أثناء عمله:

قائمة أيقونة منطقة الإعلام — Open يُبرز عميلًا يعمل في المقدمة أو يشغّل واحدًا، وSettings يفتح واجهة الويب، وعنصر الصوت يبدأ خادم ASR أو يوقفه
  • Open — يُبرز عميل سطح مكتب يعمل في المقدمة، أو يشغّل واحدًا حين لا يعمل أيّ عميل (والنقر المزدوج على الأيقونة يفعل الشيء نفسه)؛
  • Settings — يفتح واجهة الويب الخاصة بالخادم في المتصفح (انظر استخدام واجهة الويب)؛
  • Start/Stop Vibe Voice — يبدأ خادم ASR أو يوقفه دون فتح واجهة الويب، بما يعكس زرّي البدء والإيقاف في قسم الصوت؛ ويظهر هذا العنصر عند تفعيل التعرف الصوتي، وتتبع تسميته الحالة (مثلًا Stop Vibe Voice (model on device) ما دام النموذج محملًا)؛
  • Exit — يغلق الخادم.

بينما تُستضاف المجلدات عبر HTTP، يوفّر عنصر HTTP Servers إيقافًا بنقرة واحدة لكل مشاركة (انظر النشر عبر خادم HTTP).

خريطة الميزات

تعكس بقية هذا الدليل فصول الشريط الجانبي:

  • الطرفيات — إنشاء الطرفيات وتقسيمها وتنظيمها؛ الملفات الشخصية، وWSL، والمنفذ التسلسلي UART؛ الأوامر السريعة ومتغيرات البيئة؛ قيادة الطرفيات من وكلاء خارجيين عبر MCP؛ مراجعة محادثات وكيل الشيفرة؛ التأكيد التلقائي للمطالبات التفاعلية؛
  • الملفات — المشاريع الحديثة، ومستكشف ملفات جانب الخادم، والرفع والتنزيل، ونشر مجلد عبر HTTP (انظر مستكشف الملفات والرفع والتنزيل والنشر عبر خادم HTTP)؛
  • Git — التحضير، والتنفيذ بمساعدة الذكاء الاصطناعي، وأشجار العمل، وإعادة التأسيس التفاعلية، وحل التعارضات، والدفع؛
  • سطح المكتب البعيد والمحاكيات — مراقبة شاشات الخادم والتحكم بها، وأجهزة ومحاكيات أندرويد، ومحاكي iOS؛
  • الإدخال الصوتي — التعرف على الكلام من جانب الخادم، مع إملاء بالضغط للتحدث وصقل LLM؛
  • المرحّل (Relay) — الوصول إلى أجهزة خلف NAT أو ذات عناوين IP ديناميكية عبر نقطة دخول علنية واحدة؛
  • الوصول البعيد — نطاقات DDNS وإعادة توجيه منافذ TLS للخدمات العاملة على الخادم؛
  • ميزات الذكاء الاصطناعي — مزودو LLM في صورة إضافات تُسند لكل ميزة، إضافة إلى تكامل MCP (انظر LLM وMCP).

من أين تبدأ

  1. افتح قسم Server بواجهة الويب، واضبط Secret Key، واقترن عميلًا — توصيل عميل يرشدك خلال إعداد رمز QR والإعداد اليدوي؛
  2. تصفّح أقسام واجهة الويب لضبط الملفات الشخصية والإضافات والميزات — انظر استخدام واجهة الويب؛
  3. افتح طرفية على الخادم وراجع الفصول أعلاه حسب الحاجة.