​

WebChat (واجهة WebSocket الخاصة بـ Gateway)

​

ما هو

• واجهة دردشة أصلية للبوابة (من دون متصفح مضمّن ومن دون خادم ثابت محلي).
• تستخدم الجلسات نفسها وقواعد التوجيه نفسها مثل القنوات الأخرى.
• توجيه حتمي: تعود الردود دائمًا إلى WebChat.

​

البدء السريع

1. شغّل Gateway.
2. افتح واجهة WebChat (تطبيق macOS/iOS) أو علامة تبويب الدردشة في واجهة التحكم.
3. تأكّد من تهيئة مصادقة Gateway (مطلوبة افتراضيًا، حتى على loopback).

​

كيفية العمل (السلوك)

• تتصل الواجهة بـ WebSocket الخاص بـ Gateway وتستخدم chat.history وchat.send وchat.inject.
• يقوم chat.inject بإلحاق ملاحظة من المساعد مباشرةً بسجل المحادثة وبثّها إلى الواجهة (من دون تشغيل وكيل).
• يتم دائمًا جلب السجل من Gateway (لا توجد مراقبة لملفات محلية).
• إذا تعذّر الوصول إلى Gateway، يكون WebChat للقراءة فقط.

​

الاستخدام عن بُعد

• يقوم الوضع البعيد بنفقنة WebSocket الخاص بـ Gateway عبر SSH/Tailscale.
• لا تحتاج إلى تشغيل خادم WebChat منفصل.

​

مرجع التهيئة (WebChat)

• لا توجد كتلة webchat.* مخصّصة. يستخدم WebChat نقطة نهاية Gateway + إعدادات المصادقة أدناه.

• gateway.port وgateway.bind: مضيف/منفذ WebSocket.
• gateway.auth.mode وgateway.auth.token وgateway.auth.password: مصادقة WebSocket.
• gateway.auth.mode: "trusted-proxy": مصادقة الوكيل العكسي لعملاء المتصفح (انظر Trusted Proxy Auth).
• gateway.remote.url وgateway.remote.token وgateway.remote.password: هدف Gateway البعيد.
• session.*: تخزين الجلسات والإعدادات الافتراضية للمفتاح الرئيسي.