@neurocode-ai/web 1.18.8

package/src/content/docs/ar/models.mdx

@@ -0,0 +1,222 @@
+---
+title: النماذج
+description: تهيئة مزوّد LLM والنموذج.
+---
+
+يستخدم OpenCode كلاً من [AI SDK](https://ai-sdk.dev/) و[Models.dev](https://models.dev) لدعم **أكثر من 75 مزوّداً لنماذج LLM**، كما يدعم تشغيل النماذج محلياً.
+
+---
+
+## المزوّدون
+
+أكثر المزوّدين شيوعاً مُحمَّلون مسبقاً افتراضياً. إذا أضفت بيانات اعتماد أحد المزوّدين عبر الأمر `/connect` فستكون متاحة عند تشغيل OpenCode.
+
+تعرّف على المزيد حول [المزوّدين](/docs/providers).
+
+---
+
+## اختر نموذجاً
+
+بعد تهيئة المزوّد يمكنك اختيار النموذج الذي تريده بكتابة:
+
+```bash frame="none"
+/models
+```
+
+---
+
+## النماذج الموصى بها
+
+هناك الكثير من النماذج المتاحة، وتظهر نماذج جديدة كل أسبوع.
+
+:::tip
+ننصح باستخدام أحد النماذج التي نوصي بها.
+:::
+
+لكن القليل منها فقط يكون جيداً في كلٍ من توليد الشيفرة واستدعاء الأدوات.
+
+فيما يلي عدة نماذج تعمل جيداً مع OpenCode، دون ترتيب معيّن. (هذه ليست قائمة شاملة وقد لا تكون محدَّثة دائماً):
+
+- GPT 5.2
+- GPT 5.1 Codex
+- Claude Opus 4.5
+- Claude Sonnet 4.5
+- Minimax M2.1
+- Gemini 3 Pro
+
+---
+
+## تعيين الافتراضي
+
+لتعيين أحد هذه النماذج كنموذج افتراضي، يمكنك ضبط المفتاح `model` في ملف إعدادات OpenCode.
+
+```json title="opencode.json" {3}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "model": "lmstudio/google/gemma-3n-e4b"
+}
+```
+
+المعرّف الكامل هنا يكون بالشكل `provider_id/model_id`. على سبيل المثال، إذا كنت تستخدم [OpenCode Zen](/docs/zen) فستستخدم `opencode/gpt-5.1-codex` لنموذج GPT 5.1 Codex.
+
+إذا كنت قد هيّأت [مزوّداً مخصّصاً](/docs/providers#custom)، فإن `provider_id` هو المفتاح الموجود ضمن قسم `provider` في إعداداتك، و`model_id` هو المفتاح الموجود ضمن `provider.models`.
+
+---
+
+## إعداد النماذج
+
+يمكنك ضبط خيارات النموذج على مستوى عام عبر ملف الإعدادات.
+
+```jsonc title="opencode.jsonc" {7-12,19-24}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "openai": {
+      "models": {
+        "gpt-5": {
+          "options": {
+            "reasoningEffort": "high",
+            "textVerbosity": "low",
+            "reasoningSummary": "auto",
+            "include": ["reasoning.encrypted_content"],
+          },
+        },
+      },
+    },
+    "anthropic": {
+      "models": {
+        "claude-sonnet-4-5-20250929": {
+          "options": {
+            "thinking": {
+              "type": "enabled",
+              "budgetTokens": 16000,
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+هنا نقوم بضبط إعدادات عامة لنموذجين مدمجين: `gpt-5` عند الوصول إليه عبر مزوّد `openai`، و`claude-sonnet-4-20250514` عند الوصول إليه عبر مزوّد `anthropic`.
+يمكن العثور على أسماء المزوّدين والنماذج المدمجة على [Models.dev](https://models.dev).
+
+يمكنك أيضاً ضبط هذه الخيارات لأي وكلاء تستخدمهم. تتجاوز إعدادات الوكيل أي خيارات عامة هنا. [اعرف المزيد](/docs/agents/#additional).
+
+كما يمكنك تعريف متغيّرات مخصّصة تُوسّع المتغيّرات المدمجة. تتيح لك المتغيّرات ضبط إعدادات مختلفة للنموذج نفسه دون إنشاء إدخالات مكرّرة:
+
+```jsonc title="opencode.jsonc" {6-21}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "opencode": {
+      "models": {
+        "gpt-5": {
+          "variants": {
+            "high": {
+              "reasoningEffort": "high",
+              "textVerbosity": "low",
+              "reasoningSummary": "auto",
+            },
+            "low": {
+              "reasoningEffort": "low",
+              "textVerbosity": "low",
+              "reasoningSummary": "auto",
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+---
+
+## المتغيّرات
+
+تدعم العديد من النماذج عدة متغيّرات بإعدادات مختلفة. يأتي OpenCode مع متغيّرات افتراضية مدمجة للمزوّدين الشائعين.
+
+### المتغيّرات المدمجة
+
+يأتي OpenCode مع متغيّرات افتراضية لعدد كبير من المزوّدين:
+
+**Anthropic**:
+
+- `high` - ميزانية تفكير مرتفعة (الافتراضي)
+- `max` - أقصى ميزانية تفكير
+
+**OpenAI**:
+
+تختلف حسب النموذج، لكن بشكل عام:
+
+- `none` - بدون استدلال
+- `minimal` - أقل جهد للاستدلال
+- `low` - جهد استدلال منخفض
+- `medium` - جهد استدلال متوسط
+- `high` - جهد استدلال مرتفع
+- `xhigh` - جهد استدلال مرتفع جداً
+
+**Google**:
+
+- `low` - جهد/ميزانية رموز أقل
+- `high` - جهد/ميزانية رموز أعلى
+
+:::tip
+هذه القائمة ليست شاملة. لدى العديد من المزوّدين الآخرين إعدادات افتراضية مدمجة أيضاً.
+:::
+
+### متغيّرات مخصّصة
+
+يمكنك تجاوز المتغيّرات الموجودة أو إضافة متغيّراتك الخاصة:
+
+```jsonc title="opencode.jsonc" {7-18}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "openai": {
+      "models": {
+        "gpt-5": {
+          "variants": {
+            "thinking": {
+              "reasoningEffort": "high",
+              "textVerbosity": "low",
+            },
+            "fast": {
+              "disabled": true,
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+### التبديل بين المتغيّرات
+
+استخدم اختصار لوحة المفاتيح `variant_cycle` للتبديل بسرعة بين المتغيّرات. [اعرف المزيد](/docs/keybinds).
+
+---
+
+## تحميل النماذج
+
+عند بدء تشغيل OpenCode، يتحقق من النماذج وفق ترتيب الأولوية التالي:
+
+1. خيار CLI `--model` أو `-m`. الصيغة هي نفسها الموجودة في ملف الإعدادات: `provider_id/model_id`.
+
+2. قائمة النماذج في إعدادات OpenCode.
+
+   ```json title="opencode.json"
+   {
+     "$schema": "https://opencode.ai/config.json",
+     "model": "anthropic/claude-sonnet-4-20250514"
+   }
+   ```
+
+   الصيغة هنا هي `provider/model`.
+
+3. آخر نموذج تم استخدامه.
+
+4. أول نموذج وفق أولوية داخلية.

package/src/content/docs/ar/network.mdx

@@ -0,0 +1,57 @@
+---
+title: الشبكة
+description: إعداد الوكلاء والشهادات المخصصة.
+---
+
+يدعم OpenCode متغيرات بيئة الوكيل (proxy) القياسية والشهادات المخصصة لبيئات الشبكات المؤسسية.
+
+---
+
+## الوكيل
+
+يتبع OpenCode متغيرات بيئة الوكيل القياسية.
+
+```bash
+# وكيل HTTPS (موصى به)
+export HTTPS_PROXY=https://proxy.example.com:8080
+
+# وكيل HTTP (إذا لم يتوفر HTTPS)
+export HTTP_PROXY=http://proxy.example.com:8080
+
+# تجاوز الوكيل للخادم المحلي (مطلوب)
+export NO_PROXY=localhost,127.0.0.1
+```
+
+:::caution
+تتواصل واجهة TUI مع خادم HTTP محلي. يجب تجاوز الوكيل لهذا الاتصال لمنع حلقات التوجيه.
+:::
+
+يمكنك إعداد منفذ الخادم واسم المضيف باستخدام [أعلام CLI](/docs/cli#run).
+
+---
+
+### المصادقة
+
+إذا كان الوكيل يتطلب مصادقة أساسية، فأدرج بيانات الاعتماد في عنوان URL.
+
+```bash
+export HTTPS_PROXY=http://username:password@proxy.example.com:8080
+```
+
+:::caution
+تجنّب تضمين كلمات المرور بشكل ثابت. استخدم متغيرات البيئة أو تخزين بيانات اعتماد آمن.
+:::
+
+بالنسبة للوكلاء الذين يتطلبون مصادقة متقدمة مثل NTLM أو Kerberos، فكّر في استخدام بوابة LLM تدعم طريقة المصادقة لديك.
+
+---
+
+## الشهادات المخصصة
+
+إذا كانت مؤسستك تستخدم سلطات تصديق (CA) مخصصة لاتصالات HTTPS، فقم بإعداد OpenCode ليثق بها.
+
+```bash
+export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem
+```
+
+يعمل ذلك لكل من اتصالات الوكيل والوصول المباشر إلى APIs.

package/src/content/docs/ar/permissions.mdx

@@ -0,0 +1,235 @@
+---
+title: الأذونات
+description: تحكّم في الإجراءات التي تتطلب موافقة قبل تنفيذها.
+---
+
+يستخدم OpenCode إعداد `permission` لتحديد ما إذا كان إجراءٌ ما سيُنفّذ تلقائيًا، أو سيطلب موافقتك، أو سيتم حظره.
+
+اعتبارًا من `v1.1.1`، تم إهمال إعداد `tools` القديم (المنطقي) ودمجه ضمن `permission`. ولا يزال إعداد `tools` القديم مدعومًا للتوافق مع الإصدارات السابقة.
+
+---
+
+## الإجراءات
+
+يؤول كل حكم أذونات إلى إحدى القيم التالية:
+
+- `"allow"` — تشغيل دون موافقة
+- `"ask"` — طلب الموافقة
+- `"deny"` — حظر الإجراء
+
+---
+
+## الإعداد
+
+يمكنك تعيين الأذونات بشكل عام (باستخدام `*`) ثم تجاوزها لأدوات محددة.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "*": "ask",
+    "bash": "allow",
+    "edit": "deny"
+  }
+}
+```
+
+يمكنك أيضًا تعيين جميع الأذونات دفعة واحدة:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": "allow"
+}
+```
+
+---
+
+## قواعد دقيقة (صيغة الكائن)
+
+في معظم الأذونات، يمكنك استخدام كائن لتطبيق إجراءات مختلفة بناءً على مُدخلات الأداة.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "bash": {
+      "*": "ask",
+      "git *": "allow",
+      "npm *": "allow",
+      "rm *": "deny",
+      "grep *": "allow"
+    },
+    "edit": {
+      "*": "deny",
+      "packages/web/src/content/docs/*.mdx": "allow"
+    }
+  }
+}
+```
+
+تُقيَّم القواعد عبر مطابقة الأنماط، مع كون **آخر قاعدة مطابقة هي التي تُطبَّق**. من الشائع وضع قاعدة الشمول `"*"` أولًا ثم القواعد الأكثر تحديدًا بعدها.
+
+### أحرف البدل
+
+تستخدم أنماط الأذونات مطابقة بسيطة لأحرف البدل:
+
+- `*` يطابق صفرًا أو أكثر من أي حرف
+- `?` يطابق حرفًا واحدًا بالضبط
+- جميع الأحرف الأخرى تُطابق حرفيًا
+
+### توسيع مجلد المنزل
+
+يمكنك استخدام `~` أو `$HOME` في بداية النمط للإشارة إلى مجلد المنزل. هذا مفيد خصوصًا لقواعد [`external_directory`](#external-directories).
+
+- `~/projects/*` -> `/Users/username/projects/*`
+- `$HOME/projects/*` -> `/Users/username/projects/*`
+- `~` -> `/Users/username`
+
+### الأدلة الخارجية
+
+استخدم `external_directory` للسماح باستدعاءات الأدوات التي تلمس مسارات خارج دليل العمل الذي بدأ منه OpenCode. ينطبق ذلك على أي أداة تأخذ مسارًا كمدخل (مثل `read` و`edit` و`glob` و`grep` والعديد من أوامر `bash`).
+
+توسيع المنزل (مثل `~/...`) يؤثر فقط على طريقة كتابة النمط. لا يجعل ذلك المسار الخارجي جزءًا من مساحة العمل الحالية، لذا يجب السماح بالمسارات خارج دليل العمل عبر `external_directory` أيضًا.
+
+على سبيل المثال، يتيح هذا الوصول إلى كل ما يقع تحت `~/projects/personal/`:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "external_directory": {
+      "~/projects/personal/**": "allow"
+    }
+  }
+}
+```
+
+أي دليل مسموح به هنا يرث نفس القيم الافتراضية لمساحة العمل الحالية. وبما أن [`read` افتراضيًا هو `allow`](#defaults)، فإن عمليات القراءة تكون مسموحة أيضًا للعناصر ضمن `external_directory` ما لم يتم تجاوز ذلك. أضِف قواعد صريحة عندما يجب تقييد أداة ما في هذه المسارات، مثل حظر التعديلات مع الإبقاء على القراءة:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "external_directory": {
+      "~/projects/personal/**": "allow"
+    },
+    "edit": {
+      "~/projects/personal/**": "deny"
+    }
+  }
+}
+```
+
+اجعل القائمة مقتصرة على المسارات الموثوقة، ثم أضِف طبقات إضافية من قواعد `allow` أو `deny` حسب الحاجة لأدوات أخرى (مثل `bash`).
+
+---
+
+## الأذونات المتاحة
+
+تُعرَّف أذونات OpenCode بأسماء الأدوات، بالإضافة إلى بعض حواجز الأمان:
+
+- `read` — قراءة ملف (يطابق مسار الملف)
+- `edit` — جميع تعديلات الملفات (يشمل `edit` و`write` و`patch`)
+- `glob` — مطابقة أسماء الملفات (يطابق نمط الـ glob)
+- `grep` — البحث في المحتوى (يطابق نمط regex)
+- `bash` — تشغيل أوامر shell (يطابق الأوامر المُحلَّلة مثل `git status --porcelain`)
+- `task` — تشغيل وكلاء فرعيين (يطابق نوع الوكيل الفرعي)
+- `skill` — تحميل مهارة (يطابق اسم المهارة)
+- `lsp` — تشغيل استعلامات LSP (حاليًا دون قواعد دقيقة)
+- `webfetch` — جلب عنوان URL (يطابق الـ URL)
+- `websearch` — بحث الويب (يطابق الاستعلام)
+- `external_directory` — يُفعَّل عندما تلمس أداة مسارات خارج دليل عمل المشروع
+- `doom_loop` — يُفعَّل عندما يتكرر نفس استدعاء الأداة 3 مرات مع نفس المُدخلات
+
+---
+
+## القيم الافتراضية
+
+إذا لم تحدد شيئًا، يبدأ OpenCode بقيم افتراضية متساهلة:
+
+- معظم الأذونات افتراضيًا تكون `"allow"`.
+- `doom_loop` و`external_directory` افتراضيًا تكون `"ask"`.
+- `read` هو `"allow"`، لكن ملفات `.env` تكون مرفوضة افتراضيًا:
+
+```json title="opencode.json"
+{
+  "permission": {
+    "read": {
+      "*": "allow",
+      "*.env": "deny",
+      "*.env.*": "deny",
+      "*.env.example": "allow"
+    }
+  }
+}
+```
+
+---
+
+## ماذا تفعل `"ask"`
+
+عندما يطلب OpenCode الموافقة، تعرض الواجهة ثلاث نتائج ممكنة:
+
+- `once` — الموافقة على هذا الطلب فقط
+- `always` — الموافقة على الطلبات المستقبلية المطابقة للأنماط المقترحة (لباقي جلسة OpenCode الحالية)
+- `reject` — رفض الطلب
+
+مجموعة الأنماط التي ستوافق عليها `always` تُوفَّر من الأداة نفسها (على سبيل المثال، موافقات `bash` عادةً ما تُدرج بادئة أمر آمنة في القائمة البيضاء مثل `git status*`).
+
+---
+
+## الوكلاء
+
+يمكنك تجاوز الأذونات لكل وكيل. تُدمَج أذونات الوكلاء مع الإعداد العام، وتكون قواعد الوكيل هي ذات الأولوية. [تعرّف أكثر](/docs/agents#permissions) على أذونات الوكلاء.
+
+:::note
+ارجع إلى قسم [قواعد دقيقة (صيغة الكائن)](#granular-rules-object-syntax) للحصول على أمثلة أكثر تفصيلًا حول مطابقة الأنماط.
+:::
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "bash": {
+      "*": "ask",
+      "git *": "allow",
+      "git commit *": "deny",
+      "git push *": "deny",
+      "grep *": "allow"
+    }
+  },
+  "agent": {
+    "build": {
+      "permission": {
+        "bash": {
+          "*": "ask",
+          "git *": "allow",
+          "git commit *": "ask",
+          "git push *": "deny",
+          "grep *": "allow"
+        }
+      }
+    }
+  }
+}
+```
+
+يمكنك أيضًا ضبط أذونات الوكيل في Markdown:
+
+```markdown title="~/.config/opencode/agents/review.md"
+---
+description: Code review without edits
+mode: subagent
+permission:
+  edit: deny
+  bash: ask
+  webfetch: deny
+---
+
+Only analyze code and suggest changes.
+```
+
+:::tip
+استخدم مطابقة الأنماط للأوامر التي تحتوي على معاملات. يسمح `"grep *"` بتنفيذ `grep pattern file.txt`، بينما سيحظر `"grep"` وحده ذلك. تعمل أوامر مثل `git status` للسلوك الافتراضي، لكنها تتطلب إذنًا صريحًا (مثل `"git status *"`) عند تمرير معاملات.
+:::