دليل تكامل SillyTavern

نظرة عامة

يصل SillyTavern إلى Routerah عبر مصدر Chat Completion. الصق الرابط الأساسي ومفتاح API، ثمّ اختر نموذجًا من القائمة المنسدلة. لا حاجة إلى بروكسي أو نفق.

إعداد سريع

الصق هذه في العميل. يُملأ مفتاحك تلقائيًا عند تسجيل الدخول.

عنوان URL الأساسي: https://api.routerah.app/v1
مفتاح API: YOUR_API_KEY

التوافق

الإعداد خطوة بخطوة

1. 1
   افتح API Connections

   انقر أيقونة القابس في الأعلى لفتح لوحة API Connections.

2. 2
   اختر Chat Completion

   اضبط نوع API على Chat Completion.

3. 3
   اختر Custom (OpenAI-compatible)

   في القائمة المنسدلة Chat Completion Source، اختر Custom (OpenAI-compatible).

4. 4
   الصق الرابط الأساسي

   أدخل الرابط الأساسي لـ Routerah المنتهي بـ `/v1`. لا تُضف `/chat/completions`.

   text

   Custom Endpoint (Base URL): https://api.routerah.app/v1

   سجّل الدخول لتعبئة مفتاح API تلقائياً

5. 5
   الصق مفتاح API

   الصق مفتاح API الخاصّ بـ Routerah في حقل Custom API Key.

6. 6
   اتّصل واختر نموذجاً

   انقر Connect. تُملأ قائمة Model من قائمة نماذج Routerah.

التشغيل على Android ‏(Termux)

لا يوجد تطبيق SillyTavern لنظام Android، لكنه يعمل على الهاتف داخل Termux. ثبّته مرة واحدة بهذه الخطوات، وافتحه في متصفح هاتفك، ثم اربط Routerah باتباع الخطوات أعلاه.

1. 1
   ثبّت Termux

   نزّل Termux من F-Droid أو من صفحة الإصدارات على GitHub. نسخة متجر Play لم تعد تُصان ولا تعمل.

2. 2
   اختر خادمًا مرآة وحدّث

   افتح Termux وشغّل الأمر الأول. اختر Mirror group ومنطقة قريبة منك، ثم حدّث الحزم.

   bash

   termux-change-repo
   pkg update && pkg upgrade

   سجّل الدخول لتعبئة مفتاح API تلقائياً

3. 3
   ثبّت المتطلبات

   يثبّت هذا Git وNode.js. على هاتف قديم بمعمارية 32 بت، شغّل أيضًا `pkg install esbuild` إذا فشل التشغيل برسالة Unsupported platform.

   bash

   pkg install git nodejs-lts nano

   سجّل الدخول لتعبئة مفتاح API تلقائياً

4. 4
   نزّل SillyTavern

   ينزّل هذا الإصدار المستقر إلى مجلد Termux الرئيسي.

   bash

   git clone https://github.com/SillyTavern/SillyTavern -b release

   سجّل الدخول لتعبئة مفتاح API تلقائياً

5. 5
   شغّل SillyTavern

   افتح http://127.0.0.1:8000 في متصفح هاتفك واتبع خطوات الإعداد أعلاه. اترك Termux يعمل في الخلفية أثناء الدردشة. لتشغيله مرة أخرى لاحقًا، نفّذ هذين الأمرين.

   bash

   cd ~/SillyTavern
   bash start.sh

   سجّل الدخول لتعبئة مفتاح API تلقائياً

6. 6
   حدّث SillyTavern

   نفّذ هذا متى أردت أحدث إصدار. تبقى شخصياتك ومحادثاتك كما هي.

   bash

   cd ~/SillyTavern
   git pull --rebase --autostash

   سجّل الدخول لتعبئة مفتاح API تلقائياً

النماذج الموصى بها

نماذج مجانية تعمل هنا. الصق أي معرّف نموذج في العميل.

ملاحظات مهمة

• !الصق الرابط الأساسي المنتهي بـ `/v1` فقط. يضيف SillyTavern `/chat/completions` بنفسه؛ وإضافتها تعيد الخطأ 400.
• !خلوّ قائمة النماذج المنسدلة يعني أن الاتصال قد فشل. راجع الرابط الأساسي من جديد، ثم فعّل Bypass API status check.
• !خطأ 401 يعني أن المفتاح منتهٍ أو مكتوب خطأ. أنشئ مفتاحا جديدا في لوحة تحكم Routerah والصقه دون مسافات في البداية أو النهاية.
• !إن انقطع البثّ في منتصف الجملة، فعطّل Streaming لتأكيد السبب ثمّ أعد تفعيله. كما تعطّله البروكسيات المؤسّسية التي تحذف البادئة `data:`.