وكيل الاشتراك — بوابة مشتركة

فكّر في الأمر وكأنه عضوية في نادٍ رياضي: لن تُعطي صديقك بطاقتك الشخصية وتخاطر بفقدانها. بدلاً من ذلك، ستحصل له على تصريح ضيف. وكيل الاشتراك (Subscription Proxy) هو بالضبط تصريح الضيف هذا لاشتراكاتك في الذكاء الاصطناعي.

المشكلة التي يحلّها

العديد من تطبيقات الذكاء الاصطناعي — مثل OpenViking أو Open WebUI — تتحدث بصيغة واجهة برمجة تطبيقات OpenAI. يمكنك نظرياً إعطاؤها مفتاح اشتراك Nous Portal الخاص بك مباشرة، لكن هذا محفوف بالمخاطر (قد يُسرَّب) ومزعج (المفاتيح تنتهي صلاحيتها). يحلّ الوكيل هذه المشكلة بتشغيل خادم محلي صغير. كل طلب من تطبيقك يمر عبره، ويقوم الوكيل تلقائياً بإرفاق بيانات اعتمادك الحقيقية. يمكن لتطبيقاتك استخدام أي مفتاح وهمي — فالوكيل يستبدله بالمفتاح الحقيقي في الخلفية.

كيف يختلف عن خادم API

	خادم API	وكيل الاشتراك
ما يوفّره	وكلاء Hermes كاملون (أدوات، ذاكرة، مهارات)	استدلال نموذجي خالص
الأنسب لـ	“استخدام Hermes كواجهة خلفية للدردشة”	“مشاركة اشتراك Portal مع تطبيقات أخرى”
المصادقة	يتطلب API_SERVER_KEY الخاص بك	أي رمز وصول (الوكيل يستبدله)
استدعاء الأدوات	مدعوم	غير مدعوم (تمرير مباشر خالص)

بجملة واحدة: استخدم خادم API عندما تريد وكيلاً؛ واستخدم الوكيل عندما تريد النموذج فقط.

ثلاث خطوات للبدء

1. تسجيل الدخول مرة واحدة

hermes portal

سيُفتح متصفحك على صفحة تفويض Nous Portal. بعد تسجيل الدخول، يخزّن Hermes رمز التحديث في ~/.hermes/auth.json.

2. تشغيل الوكيل

hermes proxy start

سترى مخرجات مشابهة لهذا:

Starting Hermes proxy for Nous Portal
  Listening on:  http://127.0.0.1:8645/v1
  Forwarding to: (resolved per-request from your subscription)
  Use any bearer token in the client — the proxy attaches your real credential.

تريده أن يعمل في الخلفية؟ استخدم tmux أو nohup أو خدمة systemd.

3. إعداد تطبيقك

أي تطبيق متوافق مع OpenAI يحتاج فقط إلى ثلاثة إعدادات:

Base URL:   http://127.0.0.1:8645/v1
API key:    anything (e.g. "sk-unused")
Model:      Hermes-4-70B    # or Hermes-4.3-36B, Hermes-4-405B

يتجاهل الوكيل أي مفتاح تكتبه ويستبدله ببيانات اعتماد Portal الحقيقية الخاصة بك — ويقوم بتحديثها تلقائياً قبل انتهاء صلاحيتها.

التحقق من الحالة

hermes proxy status

يجب أن ترى ready. إذا ظهرت الرسالة not logged in، قم بتشغيل hermes portal مرة أخرى. إذا ظهرت credentials need attention، فهذا يعني أن رمز التحديث الخاص بك قد أُلغي (عادةً لأنك سجّلت الخروج على موقع Portal) — فقط أعد تسجيل الدخول.

نقاط النهاية المدعومة

يقوم الوكيل فقط بتمرير المسارات التي يدعمها الخادم العلوي فعلياً؛ كل شيء آخر يُرجع خطأ 404 مع رسالة واضحة:

المسار	الغرض
/v1/chat/completions	إكمال المحادثة (يدعم البث)
/v1/completions	إكمال النصوص القديم
/v1/embeddings	متجهات التضمين
/v1/models	قائمة النماذج المتاحة

الخلاصة ونصائح عملية

وكيل الاشتراك هو محوّل آمن: يتيح للتطبيقات الأخرى مشاركة اشتراكك دون كشف مفتاحك الحقيقي أبداً، ويتعامل مع انتهاء الصلاحية نيابةً عنك. يدعم حالياً Nous Portal و xAI (Grok)، مع إضافة المزيد من المزوّدين قريباً.

نصيحة عملية: إذا كنت تستخدم تطبيقات متعددة، أعطِ كل تطبيق مفتاحاً وهمياً مختلفاً (مثل sk-app1، sk-app2). بهذه الطريقة، تُظهر سجلات الوكيل بالضبط أي تطبيق يُرسل أي طلب — مما يجعل تصحيح الأخطاء أسهل بكثير. أيضاً، يستمع الوكيل فقط على 127.0.0.1 افتراضياً. لا تغيّره إلى 0.0.0.0، وإلا فإن أي جهاز على شبكتك يمكنه استخدام اشتراكك أيضاً.

---