mirror of
https://gitea.toothfairyai.com/ToothFairyAI/tf_code.git
synced 2026-04-01 06:42:26 +00:00
143 lines
4.2 KiB
Plaintext
143 lines
4.2 KiB
Plaintext
---
|
|
title: الويب
|
|
description: استخدام OpenCode في متصفحك.
|
|
---
|
|
|
|
يمكن تشغيل OpenCode كتطبيق ويب داخل متصفحك، ليمنحك تجربة البرمجة القوية بالذكاء الاصطناعي نفسها دون الحاجة إلى terminal.
|
|
|
|
|
|
|
|
## البدء
|
|
|
|
ابدأ تشغيل واجهة الويب عبر تنفيذ:
|
|
|
|
```bash
|
|
opencode web
|
|
```
|
|
|
|
يؤدي ذلك إلى تشغيل خادم محلي على `127.0.0.1` بمنفذ عشوائي متاح، ويفتح OpenCode تلقائيا في المتصفح الافتراضي لديك.
|
|
|
|
:::caution
|
|
إذا لم يتم تعيين `OPENCODE_SERVER_PASSWORD` فسيكون الخادم دون حماية. هذا مناسب للاستخدام المحلي، لكنه يجب أن يكون مُعينا عند إتاحة الوصول عبر الشبكة.
|
|
:::
|
|
|
|
:::tip[مستخدمو Windows]
|
|
لأفضل تجربة، شغّل `opencode web` من [WSL](/docs/windows-wsl) بدلا من PowerShell. يضمن ذلك وصولا صحيحا إلى نظام الملفات وتكاملا أفضل مع terminal.
|
|
:::
|
|
|
|
---
|
|
|
|
## الإعدادات
|
|
|
|
يمكنك ضبط خادم الويب باستخدام خيارات CLI أو عبر [ملف الإعدادات](/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" لعرض الخوادم المتصلة وحالتها.
|
|
|
|
|
|
|
|
---
|
|
|
|
## إرفاق terminal
|
|
|
|
يمكنك إرفاق واجهة terminal (TUI) بخادم ويب قيد التشغيل:
|
|
|
|
```bash
|
|
# Start the web server
|
|
opencode web --port 4096
|
|
|
|
# In another terminal, attach the TUI
|
|
opencode attach http://localhost:4096
|
|
```
|
|
|
|
يتيح لك ذلك استخدام واجهة الويب وterminal في الوقت نفسه، مع مشاركة الجلسات والحالة نفسها.
|
|
|
|
---
|
|
|
|
## ملف الإعدادات
|
|
|
|
يمكنك أيضا ضبط إعدادات الخادم داخل ملف الإعدادات `opencode.json`:
|
|
|
|
```json
|
|
{
|
|
"server": {
|
|
"port": 4096,
|
|
"hostname": "0.0.0.0",
|
|
"mdns": true,
|
|
"cors": ["https://example.com"]
|
|
}
|
|
}
|
|
```
|
|
|
|
تكون خيارات CLI ذات أولوية أعلى من إعدادات ملف الإعدادات.
|