diff options
Diffstat (limited to 'packages/web/src/content/docs/ar/web.mdx')
| -rw-r--r-- | packages/web/src/content/docs/ar/web.mdx | 142 |
1 files changed, 142 insertions, 0 deletions
diff --git a/packages/web/src/content/docs/ar/web.mdx b/packages/web/src/content/docs/ar/web.mdx new file mode 100644 index 000000000..d7f887e04 --- /dev/null +++ b/packages/web/src/content/docs/ar/web.mdx @@ -0,0 +1,142 @@ +--- +title: الويب +description: استخدام OpenCode في متصفحك. +--- + +يمكن تشغيل OpenCode كتطبيق ويب داخل متصفحك، ليمنحك تجربة البرمجة القوية بالذكاء الاصطناعي نفسها دون الحاجة إلى الطرفية. + + + +## البدء + +ابدأ تشغيل واجهة الويب عبر تنفيذ: + +```bash +opencode web +``` + +يؤدي ذلك إلى تشغيل خادم محلي على `127.0.0.1` بمنفذ عشوائي متاح، ويفتح OpenCode تلقائيا في المتصفح الافتراضي لديك. + +:::caution +إذا لم يتم تعيين `OPENCODE_SERVER_PASSWORD` فسيكون الخادم دون حماية. هذا مناسب للاستخدام المحلي، لكنه يجب أن يكون مُعينا عند إتاحة الوصول عبر الشبكة. +::: + +:::tip[مستخدمو Windows] +لأفضل تجربة، شغّل `opencode web` من [WSL](/docs/windows-wsl) بدلا من PowerShell. يضمن ذلك وصولا صحيحا إلى نظام الملفات وتكاملا أفضل مع الطرفية. +::: + +--- + +## الإعدادات + +يمكنك ضبط خادم الويب باستخدام خيارات سطر الأوامر أو عبر [ملف الإعدادات](/docs/config). + +### المنفذ + +افتراضيا، يختار OpenCode منفذا متاحا. يمكنك تحديد منفذ: + +```bash +opencode web --port 4096 +``` + +### اسم المضيف + +افتراضيا، يرتبط الخادم بـ `127.0.0.1` (للاستخدام المحلي فقط). لجعل OpenCode متاحا على شبكتك: + +```bash +opencode web --hostname 0.0.0.0 +``` + +عند استخدام `0.0.0.0` سيعرض OpenCode كلا من عناوين الوصول المحلي وعناوين الشبكة: + +``` + Local access: http://localhost:4096 + Network access: http://192.168.1.100:4096 +``` + +### اكتشاف mDNS + +فعّل mDNS لجعل خادمك قابلا للاكتشاف على الشبكة المحلية: + +```bash +opencode web --mdns +``` + +يضبط ذلك تلقائيا اسم المضيف إلى `0.0.0.0` ويعلن عن الخادم باسم `opencode.local`. + +يمكنك تخصيص اسم نطاق mDNS لتشغيل عدة نسخ على الشبكة نفسها: + +```bash +opencode web --mdns --mdns-domain myproject.local +``` + +### CORS + +للسماح بنطاقات إضافية عبر CORS (مفيد للواجهات الأمامية المخصصة): + +```bash +opencode web --cors https://example.com +``` + +### المصادقة + +لحماية الوصول، عيّن كلمة مرور عبر متغير البيئة `OPENCODE_SERVER_PASSWORD`: + +```bash +OPENCODE_SERVER_PASSWORD=secret opencode web +``` + +اسم المستخدم الافتراضي هو `opencode`، ويمكن تغييره عبر `OPENCODE_SERVER_USERNAME`. + +--- + +## استخدام واجهة الويب + +بعد التشغيل، تتيح لك واجهة الويب الوصول إلى جلسات OpenCode الخاصة بك. + +### الجلسات + +اعرض جلساتك وأدرها من الصفحة الرئيسية. يمكنك رؤية الجلسات النشطة وبدء جلسات جديدة. + + + +### حالة الخادم + +انقر على "See Servers" لعرض الخوادم المتصلة وحالتها. + + + +--- + +## إرفاق طرفية + +يمكنك إرفاق واجهة طرفية (TUI) بخادم ويب قيد التشغيل: + +```bash +# Start the web server +opencode web --port 4096 + +# In another terminal, attach the TUI +opencode attach http://localhost:4096 +``` + +يتيح لك ذلك استخدام واجهة الويب والطرفية في الوقت نفسه، مع مشاركة الجلسات والحالة نفسها. + +--- + +## ملف الإعدادات + +يمكنك أيضا ضبط إعدادات الخادم داخل ملف الإعدادات `opencode.json`: + +```json +{ + "server": { + "port": 4096, + "hostname": "0.0.0.0", + "mdns": true, + "cors": ["https://example.com"] + } +} +``` + +تكون خيارات سطر الأوامر ذات أولوية أعلى من إعدادات ملف الإعدادات. |