swift chat

中文

SwiftChat - تطبيق دردشة يعمل بالذكاء الاصطناعي عبر الأنظمة الأساسية

SwiftChat هو تطبيق دردشة سريع وسريع الاستجابة يعمل بالذكاء الاصطناعي تم تطويره باستخدام React Native ومدعوم من Amazon Bedrock. بفضل فلسفة التصميم البسيطة وحماية الخصوصية القوية، فإنه يوفر محادثات متدفقة في الوقت الفعلي وقدرات إنشاء صور مدعومة بالذكاء الاصطناعي عبر منصات Android وiOS وmacOS.

الميزات الرئيسية:

• الدردشة المتدفقة في الوقت الحقيقي مع الذكاء الاصطناعي
• توليد الصور بالذكاء الاصطناعي مع التقدم
• دعم متعدد الوسائط (الكاميرا والصور والمستندات)
• عرض قائمة محفوظات المحادثات وإدارتها
• دعم عبر الأنظمة الأساسية (Android، iOS، macOS)
• جهاز لوحي مُحسّن لأجهزة iPad وAndroid اللوحية
• إطلاق سريع وأداء سريع الاستجابة
• دعم وتبديل نماذج الذكاء الاصطناعي المتعددة

بنيان

افتراضيًا، نستخدم AWS App Runner ، والذي يُستخدم عادةً لاستضافة خوادم Python FastAPI، مما يوفر أداءً عاليًا وقابلية للتوسع وزمن وصول منخفض.

وبدلاً من ذلك، نوفر خيار استبدال App Runner بـ AWS Lambda باستخدام عنوان URL للوظيفة للحصول على حل أكثر فعالية من حيث التكلفة، كما هو موضح في هذا المثال.

ابدء

المتطلبات الأساسية

تأكد من أنه يمكنك الوصول إلى نماذج مؤسسة Amazon Bedrock. الإعدادات الافتراضية لـ SwiftChat هي:

• المنطقة: us-west-2
• نموذج النص: Claude 3.5 Sonnet
• نموذج الصورة: Stable Image Core 1.0

اتبع دليل مستخدم Amazon Bedrock لتمكين نماذجك.

الخطوة 1: قم بإعداد مفتاح API الخاص بك

1. قم بتسجيل الدخول إلى وحدة تحكم AWS الخاصة بك وانقر بزر الماوس الأيمن فوق Parameter Store لفتحه في علامة تبويب جديدة.

2. تحقق مما إذا كنت في المنطقة المدعومة، ثم انقر فوق الزر "إنشاء معلمة" .

3. قم بملء المعلمات أدناه، مع ترك الخيارات الأخرى كإعداد افتراضي:

   • الاسم : أدخل اسم المعلمة (على سبيل المثال، "SwiftChatAPIKey"، سيتم استخدامه كـ ApiKeyParam في الخطوة 2).

   • النوع : حدد SecureString

   • القيمة : أدخل أي سلسلة بدون مسافات. (سيكون هذا هو API Key الخاص بك في الخطوة 3)

4. انقر فوق إنشاء معلمة .

الخطوة 2: قم بنشر المكدس واحصل على عنوان URL لواجهة برمجة التطبيقات (API) الخاصة بك

1. انقر فوق أحد الأزرار التالية لتشغيل CloudFormation Stack في نفس المنطقة التي تم إنشاء مفتاح API الخاص بك فيها.

   • عداء التطبيق

     

   • Lambda (ملاحظة: لاستخدام عملاء AWS فقط)

     

2. انقر فوق "التالي "، في صفحة "تحديد تفاصيل المكدس"، قم بتوفير المعلومات التالية:

   • املأ ApiKeyParam باسم المعلمة التي استخدمتها لتخزين مفتاح API (على سبيل المثال، "SwiftChatAPIKey").
   • بالنسبة إلى App Runner، اختر InstanceTypeParam بناءً على احتياجاتك.

3. انقر فوق التالي ، واحتفظ بصفحة "تكوين خيارات المكدس" كصفحة افتراضية، واقرأ القدرات وحدد مربع الاختيار "أقر بأن AWS CloudFormation قد ينشئ موارد IAM" في الأسفل.

4. انقر فوق "التالي" ، في "المراجعة والإنشاء"، قم بمراجعة التكوين الخاص بك وانقر فوق "إرسال" .

انتظر حوالي 3-5 دقائق حتى ينتهي النشر، ثم انقر فوق مكدس CloudFormation وانتقل إلى علامة التبويب "المخرجات" ، ويمكنك العثور على عنوان URL لواجهة برمجة التطبيقات الذي يبدو مثل: https://xxx.xxx.awsapprunner.com أو https://xxx.lambda-url.xxx.on.aws

الخطوة 3: تنزيل التطبيق والإعداد باستخدام عنوان URL لواجهة برمجة التطبيقات (API) ومفتاح واجهة برمجة التطبيقات (API Key).

1. قم بتنزيل التطبيق

   • تطبيق أندرويد اضغط للتحميل
   • تطبيق macOS انقر للتنزيل
   • iOS (حاليًا لا نوفر إصدار iOS، يمكنك بنائه محليًا باستخدام Xcode)

2. قم بتشغيل التطبيق، وافتح قائمة الدرج، ثم انقر فوق الإعدادات .

3. الصق API URL API Key ثم حدد المنطقة.

4. انقر فوق أيقونة ✓ العلوية اليمنى لحفظ التكوين الخاص بك وبدء الدردشة.

مبروك ؟ تطبيق SwiftChat الخاص بك جاهز للاستخدام!

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

• شرق الولايات المتحدة (شمال فرجينيا): شرق الولايات المتحدة -1
• غرب الولايات المتحدة (أوريغون): us-west-2
• آسيا والمحيط الهادئ (مومباي): ap-south-1
• آسيا والمحيط الهادئ (سنغافورة): ap-southeast-1
• آسيا والمحيط الهادئ (سيدني): ap-southeast-2
• آسيا والمحيط الهادئ (طوكيو): ap-northeast-1
• كندا (وسطى): ca-central-1
• أوروبا (فرانكفورت): eu-central-1
• أوروبا (لندن): الاتحاد الأوروبي-غرب-2
• أوروبا (باريس): الاتحاد الأوروبي-غرب-3
• أمريكا الجنوبية (ساو باولو): sa-east-1

الميزات التفصيلية

التعامل مع الرسائل

• دعم نسخ النص:
  • زر النسخ في رأس الرسالة
  • زر النسخ في كتل التعليمات البرمجية
  • التحديد المباشر ونسخ الكود على نظام التشغيل macOS (انقر نقرًا مزدوجًا أو انقر لفترة طويلة على نظام التشغيل iOS)
  • الضغط لفترة طويلة على النص لنسخ الجملة بأكملها (انقر بزر الماوس الأيمن على نظام التشغيل macOS)
• وضع تحديد النص عن طريق النقر على عنوان الرسالة أو النقر المزدوج على النص
• عرض الجدول الزمني للرسالة في التاريخ
• حذف الرسائل من خلال الضغط لفترة طويلة في التاريخ
• انقر لمعاينة المستندات والصور التي تم تحميلها
• دعم تنسيق Markdown لكل من الأسئلة والأجوبة
• دعم عرض الجدول وتسليط الضوء على بناء جملة التعليمات البرمجية
• الحد الأقصى 20 صورة و5 وثائق لكل محادثة

ميزات الصورة

• دعم إنشاء الصور بالمطالبات الصينية (تأكد من تمكين Claude 3 Haiku في المنطقة التي حددتها)
• عرض وتكبير الصور التي تم إنشاؤها
• اضغط لفترة طويلة على الصور لحفظها أو مشاركتها
• ضغط الصور تلقائيًا لتحسين استخدام الرمز المميز

تجربة المستخدم

• ردود الفعل اللمسية لنظامي التشغيل Android وiOS (يمكن تعطيلها في الإعدادات)
• دعم الوضع الأفقي على أجهزة Android/iOS
• انقر نقرًا مزدوجًا على شريط العنوان للتمرير إلى الأعلى
• انقر فوق السهم السفلي لعرض أحدث الرسائل
• عرض استخدام الرمز المميز للجلسة الحالية من خلال النقر على عنوان الدردشة
• تحقق من الاستخدام التفصيلي للرمز المميز وعدد الصور الناتجة في الإعدادات
• إشعارات الترقية داخل التطبيق (Android وmacOS)

ما الذي يجعل SwiftChat "سريعًا" حقًا؟

سرعة الإطلاق السريعة

• بفضل تجميع AOT (Ahead of Time) لمحرك RN Hermes
• تمت إضافة التحميل البطيء للمكونات المعقدة
• يتم تشغيل التطبيق على الفور ويكون جاهزًا للإدخال على الفور

سرعة الطلب السريعة

• تسريع طلبات واجهة برمجة التطبيقات (API) الشاملة من خلال ضغط الصور
• يؤدي نشر واجهات برمجة التطبيقات في نفس المنطقة مثل Bedrock إلى توفير زمن وصول أقل
• الحد الأدنى من حمولة الاستجابة مع عدم الحاجة إلى تحليل للعرض المباشر

سرعة التقديم السريعة

• استخدام useMemo والتخزين المؤقت المخصص لإنشاء ذاكرة تخزين مؤقت ثانوية لمحتوى الجلسة
• تقليل عمليات إعادة العرض غير الضرورية وتسريع عرض الرسائل المتدفقة
• يتم تقديم جميع مكونات واجهة المستخدم كمكونات أصلية

؟ سرعة تخزين سريعة

• باستخدام React-Native-mmkv، يمكن قراءة الرسائل وتخزينها وتحديثها بمعدل أسرع 10 مرات من AsyncStorage.
• تحسين محتوى الجلسة وبنية تخزين قائمة الجلسات لتسريع عرض قائمة المحفوظات

خصوصية وأمان التطبيق

• تخزين مفتاح API المشفر
• الحد الأدنى من متطلبات الإذن
• تخزين البيانات المحلية فقط
• لا يوجد تتبع لسلوك المستخدم
• لا جمع البيانات
• نهج الخصوصية أولاً

بناء التطبيق وتطويره

أولاً، قم باستنساخ هذا المستودع. كل كود التطبيق موجود في المجلد react-native . قبل المتابعة، قم بتنفيذ الأمر التالي لتنزيل التبعيات.

 cd react-native && npm i

بناء لالروبوت

npm start && npm run android

مصمم لنظام iOS

npm start && npm run ios

مصمم لنظام التشغيل MacOS

1. قم بالتعديل كـ isMac = true في /src/App.tsx وقم بتنفيذ npm start .
2. انقر نقرًا مزدوجًا على ios/SwiftChat.xcworkspace لفتح المشروع في Xcode الخاص بك.
3. قم بتغيير وجهة البناء إلى My Mac (Mac Catalyst) ثم انقر فوق الزر ◀ Run (تشغيل).

مرجع واجهة برمجة التطبيقات

مخطط واجهة برمجة التطبيقات

أولاً، يرجى تكوين API URL ومفتاح واجهة برمجة API Key مثل:

 export API_URL= < API URL >
export API_KEY= < API Key >

1. /api/converse

   curl -N " ${API_URL} /api/converse " 
   --header ' Content-Type: application/json ' 
   --header " Authorization: Bearer ${API_KEY} " 
   --data ' {
     "messages": [
       {
         "role": "user",
         "content": [
           {
             "text": "Hi"
           }
         ]
       }
     ],
     "modelId": "anthropic.claude-3-5-sonnet-20240620-v1:0",
     "region": "us-west-2"
   } '

   يتم استخدام واجهة برمجة التطبيقات هذه لتنفيذ المحادثات المتدفقة، وتقوم فقط بإرجاع النص واستخدام الرمز المميز للعرض.

   تتوافق messages الموجودة أسفل النص بشكل كامل مع مواصفات بنية الرسائل في واجهة برمجة تطبيقات البث المباشر لـ Amazon Bedrock. يمكنك أيضًا إضافة image أو document وفقًا للمواصفات لدعم المحادثات متعددة الوسائط.

2. /api/image

   curl " ${API_URL} /api/image " 
   --header ' Content-Type: application/json ' 
   --header " Authorization: Bearer ${API_KEY} " 
   --data ' {
     "prompt": "Beautiful countryside",
     "modelId": "stability.stable-image-core-v1:0",
     "region": "us-west-2",
     "width": "1024",
     "height": "1024"
   } '

   يتم استخدام واجهة برمجة التطبيقات هذه لإنشاء الصور وإرجاع سلسلة مشفرة من الصورة باستخدام base64.

3. /api/models

   curl " ${API_URL} /api/models " 
   --header ' Content-Type: application/json ' 
   --header ' accept: application/json ' 
   --header " Authorization: Bearer ${API_KEY} " 
   --data ' {
     "region": "us-west-2"
   } '

   يتم استخدام واجهة برمجة التطبيقات هذه للحصول على قائمة بجميع نماذج النصوص ونماذج إنشاء الصور المدعومة بالتدفق في المنطقة المحددة.

4. /api/upgrade

   curl " ${API_URL} /api/upgrade " 
   --header ' Content-Type: application/json ' 
   --header ' accept: application/json ' 
   --header " Authorization: Bearer ${API_KEY} "

   تُستخدم واجهة برمجة التطبيقات هذه للحصول على الإصدار الجديد من تحديثات تطبيق SwiftChat لنظامي التشغيل Android وmacOS.

مرجع رمز API

• رمز العميل: bedrock-api.ts

• رمز الخادم: main.py

كيفية الترقية؟

ترقية التطبيق

• Android و macOS : انتقل إلى صفحة الإعدادات ، إذا كان هناك إصدار جديد، فستجده أسفل هذه الصفحة، ثم انقر فوق إصدار التطبيق لتنزيله وتثبيته.
• iOS : إذا تم إصدار إصدار جديد في صفحة الإصدار، فقم بتحديث الكود المحلي الخاص بك، وأعد إنشاء تطبيقك وتثبيته بواسطة Xcode.

ملاحظة : بعد تنزيل إصدار جديد، يرجى التحقق من ملاحظات الإصدار لمعرفة ما إذا كان تحديث إصدار API مطلوبًا.

ترقية واجهة برمجة التطبيقات

• بالنسبة إلى AppRunner : انقر على صفحة خدمات مشغل التطبيقات وافتحها، وابحث عن swiftchat-api وافتحه، ثم انقر فوق زر النشر العلوي الأيمن.
• بالنسبة إلى Lambda : انقر فوق خدمات Lambda وافتحها، وابحث عن Lambda الذي يبدأ بـ SwiftChatLambda-xxx وافتحه، وانقر فوق الزر "نشر صورة جديدة" وانقر فوق "حفظ".

حماية

انظر المساهمة لمزيد من المعلومات.

رخصة

هذه المكتبة مرخصة بموجب ترخيص MIT-0. انظر ملف الترخيص.