عن المشروع

Charon هو تطبيق ويب مستضاف ذاتيًا للعب الأدوار مع شخصيات الذكاء الاصطناعي، ويصفه مؤلفه بأنه مزيج من ميزات Chub وSillyTavern وأدوات أخرى. وهو مصمم لإبقاء بيانات المستخدم محلية بدلاً من خدمة سحابية. القدرات الأساسية الموصوفة في README: - محادثات متفرعة: كل تمريرة لرد الذكاء الاصطناعي تنشئ فرعًا جديدًا، بحيث يمكن للمستخدمين التنقل بين البدائل، وتحرير الرسائل مباشرة، وتجنب فقدان الردود السابقة. - بطاقات الشخصيات V2 وV3: يستورد بطاقات شخصيات `.png` من SillyTavern أو Chub أو مصادر أخرى دون تحويل. - مفتاح API خاص بك: يعمل مع موفري متوافقين مع OpenAI مثل OpenAI وAnthropic عبر وكيل وOpenRouter وOllama وvLLM. تُوصف المفاتيح بأنها مشفرة عند التخزين. - كتب الخلفية: يمكن إرفاق خلفية معرفية بالدردشة، ويختار التطبيق الإدخالات ذات الصلة للذكاء الاصطناعي تلقائيًا. - الشخصيات المتعددة: يمكن تعريف عدة شخصيات وتبديلها لكل دردشة. - عرض Markdown: يدعم الخط العريض والمائل وكتل التعليمات البرمجية والصور ونطاق `<style>` وتمييز الحوار، مع ظهور تدريجي آمن للبث. - الاستضافة الذاتية: تُخزن البيانات في ملف SQLite محلي، دون اعتماد على السحابة أو تتبع أو حسابات خارجية تتجاوز حساب المستخدم الخاص. تشمل خيارات النشر Docker عبر `docker compose up -d` (تُحفظ البيانات في مجلد `charon-data`) أو إعداد تطوير قائم على pnpm. تتضمن متغيرات البيئة المطلوبة `BETTER_AUTH_SECRET` و`ENCRYPTION_KEY`، مع أوامر توليد أمثلة باستخدام `openssl rand`. يُقال إن الترحيلات تعمل تلقائيًا عند أول تشغيل. يوجد مسار ترقية لقواعد البيانات القديمة ينتقل إلى حساب إداري واحد، مع إجراء موثق للنسخ الاحتياطي والاستعادة باستخدام `pnpm migrate:single-user`. يتضمن الإعداد الأول إنشاء حساب، والمرور عبر معالج إعداد لربط موفر ذكاء اصطناعي والحصول على شخصية، ثم بدء دردشة. لا يتم تضمين الشخصيات؛ يُوجه المستخدمون إلى Chub أو مجلد `public/characters/` في SillyTavern. تتضمن عناصر تحكم الدردشة الإرسال والسطر الجديد والتمرير وإعادة التوليد والتحرير والتقمص والمتابعة وحذف الفرع وقائمة أوامر Ctrl+K. يُوثق مسار استيراد SillyTavern عبر نسخ البيانات إلى `public/data/` وتشغيل `pnpm run migrate`. تستخدم إصدارات الإنتاج `pnpm run build` و`pnpm run start` على المنفذ 3000، مع تعيين `APP_URL` لملفات تعريف الارتباط للمصادقة. يُشار إلى وثائق المطور في CONTRIBUTING.md.