@neurocode-ai/web 1.18.8

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

@@ -0,0 +1,224 @@
+---
+title: Go
+description: اشتراك منخفض التكلفة لنماذج البرمجة المفتوحة.
+---
+
+import config from "../../../../config.mjs"
+export const console = config.console
+export const email = `mailto:${config.email}`
+
+OpenCode Go هو اشتراك منخفض التكلفة — **$5 للشهر الأول**، ثم **$10/شهريًا** — يمنحك وصولًا موثوقًا إلى نماذج البرمجة المفتوحة الشائعة.
+
+يعمل Go مثل أي مزود آخر في OpenCode. تشترك في OpenCode Go وتحصل على مفتاح API الخاص بك. وهو **اختياري تمامًا**، ولا تحتاج إلى استخدامه لاستخدام OpenCode.
+
+صُمّم أساسًا للمستخدمين الدوليين، مع استضافة النماذج في الولايات المتحدة والاتحاد الأوروبي وسنغافورة لضمان وصول عالمي مستقر.
+
+---
+
+## الخلفية
+
+أصبحت النماذج المفتوحة جيدة جدًا. فهي الآن تقترب في الأداء من النماذج المملوكة في مهام البرمجة. وبما أن كثيرًا من المزودين يمكنهم تقديمها بشكل تنافسي، فهي عادةً أقل تكلفة بكثير.
+
+ومع ذلك، قد يكون الحصول على وصول موثوق إليها بزمن استجابة منخفض أمرًا صعبًا. إذ يختلف المزودون في الجودة والتوافر.
+
+:::tip
+اختبرنا مجموعة مختارة من النماذج والمزودين الذين يعملون جيدًا مع OpenCode.
+:::
+
+لمعالجة ذلك، قمنا بعدة أمور:
+
+1. اختبرنا مجموعة مختارة من النماذج المفتوحة وتحدثنا مع فرقها حول أفضل طريقة لتشغيلها.
+2. ثم عملنا مع عدد قليل من المزودين للتأكد من تقديم هذه النماذج بالشكل الصحيح.
+3. وأخيرًا، أجرينا مقارنات معيارية لمزيج النموذج/المزود، وتوصلنا إلى قائمة نشعر بالثقة في التوصية بها.
+
+يمنحك OpenCode Go الوصول إلى هذه النماذج مقابل **$5 للشهر الأول**، ثم **$10/شهريًا**.
+
+---
+
+## كيف يعمل
+
+يعمل OpenCode Go مثل أي مزود آخر في OpenCode.
+
+1. تسجّل الدخول إلى **<a href={console}>OpenCode Zen</a>**، وتشترك في Go، ثم تنسخ مفتاح API الخاص بك.
+2. تشغّل الأمر `/connect` في TUI، وتختار `OpenCode Go`، ثم تلصق مفتاح API الخاص بك.
+3. شغّل `/models` في TUI لرؤية قائمة النماذج المتاحة عبر Go.
+
+:::note
+يمكن لعضو واحد فقط في كل workspace الاشتراك في OpenCode Go.
+:::
+
+تشمل قائمة النماذج الحالية:
+
+- **Grok 4.5**
+- **GLM-5.2**
+- **GLM-5.1**
+- **Kimi K3**
+- **Kimi K2.7 Code**
+- **Kimi K2.6**
+- **MiMo-V2.5**
+- **MiMo-V2.5-Pro**
+- **MiniMax M3**
+- **MiniMax M2.7**
+- **Qwen3.7 Max**
+- **Qwen3.7 Plus**
+- **Qwen3.6 Plus**
+- **DeepSeek V4 Pro**
+- **DeepSeek V4 Flash**
+- **Hy3**
+
+قد تتغير قائمة النماذج مع استمرارنا في اختبار نماذج جديدة وإضافتها.
+
+---
+
+## حدود الاستخدام
+
+يتضمن OpenCode Go الحدود التالية:
+
+- **حد 5 ساعات** — استخدام بقيمة $12
+- **الحد الأسبوعي** — استخدام بقيمة $30
+- **الحد الشهري** — استخدام بقيمة $60
+
+تُحدَّد الحدود بالقيمة بالدولار. وهذا يعني أن عدد طلباتك الفعلي يعتمد على النموذج الذي تستخدمه. تتيح النماذج الأقل تكلفة مثل DeepSeek V4 Flash عددًا أكبر من الطلبات، بينما تتيح النماذج الأعلى تكلفة مثل GLM-5.2 عددًا أقل.
+
+يوضح الجدول أدناه عددًا تقديريًا للطلبات بناءً على أنماط استخدام Go المعتادة:
+
+| Model             | الطلبات لكل 5 ساعات | الطلبات في الأسبوع | الطلبات في الشهر |
+| ----------------- | ------------------- | ------------------ | ---------------- |
+| Grok 4.5          | 120                 | 300                | 600              |
+| GLM-5.2           | 880                 | 2,150              | 4,300            |
+| GLM-5.1           | 880                 | 2,150              | 4,300            |
+| Kimi K3           | 110                 | 250                | 490              |
+| Kimi K2.7 Code    | 1,350               | 3,380              | 6,750            |
+| Kimi K2.6         | 1,150               | 2,880              | 5,750            |
+| MiMo-V2.5         | 30,100              | 75,200             | 150,400          |
+| MiMo-V2.5-Pro     | 3,250               | 8,150              | 16,300           |
+| MiniMax M3        | 3,200               | 8,000              | 16,000           |
+| MiniMax M2.7      | 3,400               | 8,500              | 17,000           |
+| Qwen3.7 Max       | 950                 | 2,390              | 4,770            |
+| Qwen3.7 Plus      | 4,300               | 10,800             | 21,600           |
+| Qwen3.6 Plus      | 3,300               | 8,200              | 16,300           |
+| DeepSeek V4 Pro   | 3,450               | 8,550              | 17,150           |
+| DeepSeek V4 Flash | 31,650              | 79,050             | 158,150          |
+| Hy3               | 4,300               | 10,750             | 21,500           |
+
+تستند التقديرات إلى أنماط الطلبات المرصودة:
+
+- Grok 4.5 — ‏1,100 input، و71,500 cached، و220 output tokens لكل طلب
+- GLM-5.2/5.1 — ‏700 input، و52,000 cached، و150 output tokens لكل طلب
+- Kimi K3 — ‏1,050 input، و76,500 cached، و300 output tokens لكل طلب
+- Kimi K2.7/K2.6 — ‏870 input، و55,000 cached، و200 output tokens لكل طلب
+- DeepSeek V4 Pro — ‏750 input، و82,000 cached، و290 output tokens لكل طلب
+- DeepSeek V4 Flash — ‏790 input، و68,000 cached، و280 output tokens لكل طلب
+- MiniMax M3 — ‏510 input، و56,000 cached، و190 output tokens لكل طلب
+- MiniMax M2.7 — ‏300 input، و55,000 cached، و125 output tokens لكل طلب
+- Qwen3.7 Max — ‏420 input، و66,000 cached، و200 output tokens لكل طلب
+- Qwen3.7 Plus — ‏500 input، و57,000 cached، و190 output tokens لكل طلب
+- Qwen3.6 Plus — ‏500 input، و57,000 cached، و190 output tokens لكل طلب
+- Hy3 — ‏830 input، و71,500 cached، و295 output tokens لكل طلب
+- MiMo-V2.5 — ‏830 input، و71,500 cached، و295 output tokens لكل طلب
+- MiMo-V2.5-Pro — ‏790 input، و86,000 cached، و305 output tokens لكل طلب
+
+تستند التقديرات أيضًا إلى الأسعار التالية لكل 1M tokens والاستخدام الشهري المتضمن مع كل نموذج:
+
+| النموذج                      | الإدخال | الإخراج | القراءة المخزنة | الكتابة المخزنة | الاستخدام |
+| ---------------------------- | ------- | ------- | --------------- | --------------- | --------- |
+| Grok 4.5                     | $2.00   | $6.00   | $0.30           | -               | $15       |
+| GLM-5.2                      | $1.40   | $4.40   | $0.26           | -               | $60       |
+| GLM-5.1                      | $1.40   | $4.40   | $0.26           | -               | $60       |
+| Kimi K3                      | $3.00   | $15.00  | $0.30           | -               | $15       |
+| Kimi K2.7 Code               | $0.95   | $4.00   | $0.19           | -               | $60       |
+| Kimi K2.6                    | $0.95   | $4.00   | $0.16           | -               | $60       |
+| MiMo V2.5                    | $0.14   | $0.28   | $0.0028         | -               | $60       |
+| MiMo V2.5 Pro                | $0.435  | $0.87   | $0.003625       | -               | $15       |
+| MiniMax M3                   | $0.30   | $1.20   | $0.06           | -               | $60       |
+| MiniMax M2.7                 | $0.30   | $1.20   | $0.06           | $0.375          | $60       |
+| MiniMax M2.5                 | $0.30   | $1.20   | $0.06           | $0.375          | $60       |
+| Qwen3.7 Max                  | $2.50   | $7.50   | $0.50           | $3.125          | $60       |
+| Qwen3.7 Plus (≤ 256K tokens) | $0.40   | $1.60   | $0.04           | $0.50           | $60       |
+| Qwen3.7 Plus (> 256K tokens) | $1.20   | $4.80   | $0.12           | $1.50           | $60       |
+| Qwen3.6 Plus (≤ 256K tokens) | $0.50   | $3.00   | $0.05           | $0.625          | $60       |
+| Qwen3.6 Plus (> 256K tokens) | $2.00   | $6.00   | $0.20           | $2.50           | $60       |
+| DeepSeek V4 Pro              | $0.435  | $0.87   | $0.003625       | -               | $15       |
+| DeepSeek V4 Flash            | $0.14   | $0.28   | $0.0028         | -               | $60       |
+| Hy3                          | $0.14   | $0.58   | $0.035          | -               | $60       |
+
+يمكنك تتبّع استخدامك الحالي في **<a href={console}>console</a>**.
+
+:::tip
+إذا وصلت إلى حد الاستخدام، يمكنك الاستمرار في استخدام النماذج المجانية.
+:::
+
+قد تتغير حدود الاستخدام مع تعلّمنا من الاستخدام المبكر والملاحظات.
+
+---
+
+### الاستخدام بعد تجاوز الحدود
+
+إذا كان لديك أيضًا رصيد في Zen balance، فيمكنك تفعيل خيار **Use balance** في console. عند تفعيله، سيعود Go إلى استخدام Zen balance الخاص بك بعد بلوغ حدود الاستخدام بدلًا من حظر الطلبات.
+
+---
+
+### لماذا يكون الاستخدام أقل لبعض النماذج
+
+مع Go، تدفع $10 شهريًا، ونهدف إلى منحك استخدامًا بقيمة تعادل 6 أضعاف هذا المبلغ.
+
+نحقق ذلك لمعظم النماذج من خلال الخصومات على الكميات الكبيرة وسعة GPU المحجوزة. ثم ننقل هذه الوفورات إليك من خلال معامل مضاعفة قدره 6.
+
+بالنسبة إلى بعض النماذج، لم تتح لنا فرصة التفاوض على خصم أو استضافتها بتكلفة أقل، إما لأن النموذج جديد أو لأن أسعاره العامة مخفضة بالفعل.
+
+بالنسبة إلى هذه النماذج، لا تزال تحصل على استخدام يزيد قليلًا عما ستحصل عليه إذا دفعت لمزودي النماذج مباشرةً؛ ولهذا يكون معامل مضاعفة استخدامها أقل في الجدول أعلاه.
+
+---
+
+## نقاط النهاية
+
+يمكنك أيضًا الوصول إلى نماذج Go عبر نقاط نهاية API التالية.
+
+| Model             | Model ID          | Endpoint                                         | AI SDK Package              |
+| ----------------- | ----------------- | ------------------------------------------------ | --------------------------- |
+| Grok 4.5          | grok-4.5          | `https://opencode.ai/zen/go/v1/chat/completions` | `@ai-sdk/openai-compatible` |
+| GLM-5.2           | glm-5.2           | `https://opencode.ai/zen/go/v1/chat/completions` | `@ai-sdk/openai-compatible` |
+| GLM-5.1           | glm-5.1           | `https://opencode.ai/zen/go/v1/chat/completions` | `@ai-sdk/openai-compatible` |
+| Kimi K3           | kimi-k3           | `https://opencode.ai/zen/go/v1/chat/completions` | `@ai-sdk/openai-compatible` |
+| Kimi K2.7 Code    | kimi-k2.7-code    | `https://opencode.ai/zen/go/v1/chat/completions` | `@ai-sdk/openai-compatible` |
+| Kimi K2.6         | kimi-k2.6         | `https://opencode.ai/zen/go/v1/chat/completions` | `@ai-sdk/openai-compatible` |
+| DeepSeek V4 Pro   | deepseek-v4-pro   | `https://opencode.ai/zen/go/v1/chat/completions` | `@ai-sdk/openai-compatible` |
+| DeepSeek V4 Flash | deepseek-v4-flash | `https://opencode.ai/zen/go/v1/chat/completions` | `@ai-sdk/openai-compatible` |
+| MiMo-V2.5         | mimo-v2.5         | `https://opencode.ai/zen/go/v1/chat/completions` | `@ai-sdk/openai-compatible` |
+| MiMo-V2.5-Pro     | mimo-v2.5-pro     | `https://opencode.ai/zen/go/v1/chat/completions` | `@ai-sdk/openai-compatible` |
+| MiniMax M3        | minimax-m3        | `https://opencode.ai/zen/go/v1/messages`         | `@ai-sdk/anthropic`         |
+| MiniMax M2.7      | minimax-m2.7      | `https://opencode.ai/zen/go/v1/messages`         | `@ai-sdk/anthropic`         |
+| MiniMax M2.5      | minimax-m2.5      | `https://opencode.ai/zen/go/v1/messages`         | `@ai-sdk/anthropic`         |
+| Qwen3.7 Max       | qwen3.7-max       | `https://opencode.ai/zen/go/v1/messages`         | `@ai-sdk/anthropic`         |
+| Qwen3.7 Plus      | qwen3.7-plus      | `https://opencode.ai/zen/go/v1/messages`         | `@ai-sdk/anthropic`         |
+| Qwen3.6 Plus      | qwen3.6-plus      | `https://opencode.ai/zen/go/v1/messages`         | `@ai-sdk/anthropic`         |
+| Hy3               | hy3               | `https://opencode.ai/zen/go/v1/chat/completions` | `@ai-sdk/openai-compatible` |
+
+يستخدم [model id](/docs/config/#models) في إعدادات OpenCode لديك التنسيق `opencode-go/<model-id>`. على سبيل المثال، بالنسبة إلى Kimi K3، ستستخدم `opencode-go/kimi-k3` في إعداداتك.
+
+---
+
+### النماذج
+
+يمكنك جلب القائمة الكاملة بالنماذج المتاحة وبياناتها الوصفية من:
+
+```
+https://opencode.ai/zen/go/v1/models
+```
+
+---
+
+## الخصوصية
+
+صُمّمت هذه الخطة أساسًا للمستخدمين الدوليين، مع استضافة النماذج في الولايات المتحدة والاتحاد الأوروبي وسنغافورة لضمان وصول عالمي مستقر. ويتّبع مزودونا سياسة عدم الاحتفاظ بالبيانات، ولا يستخدمون بياناتك لتدريب النماذج.
+
+---
+
+## الأهداف
+
+أنشأنا OpenCode Go من أجل:
+
+1. جعل البرمجة بالذكاء الاصطناعي **متاحة** لعدد أكبر من الأشخاص عبر اشتراك منخفض التكلفة.
+2. توفير وصول **موثوق** إلى أفضل نماذج البرمجة المفتوحة.
+3. تنسيق نماذج **مختبرة وخضعت لمقارنات معيارية** لاستخدامها مع وكلاء البرمجة.
+4. **عدم فرض قيود ارتباط** من خلال السماح لك أيضًا باستخدام أي مزود آخر مع OpenCode.

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

@@ -0,0 +1,48 @@
+---
+title: IDE
+description: امتداد OpenCode لـ VS Code و Cursor وغيرها من بيئات التطوير
+---
+
+يتكامل OpenCode مع VS Code و Cursor أو أي IDE يدعم terminal. ما عليك سوى تشغيل `opencode` في terminal للبدء.
+
+---
+
+## الاستخدام
+
+- **تشغيل سريع**: استخدم `Cmd+Esc` (Mac) أو `Ctrl+Esc` (Windows/Linux) لفتح OpenCode في عرض terminal مقسّم، أو للتركيز على جلسة terminal موجودة إذا كانت قيد التشغيل بالفعل.
+- **جلسة جديدة**: استخدم `Cmd+Shift+Esc` (Mac) أو `Ctrl+Shift+Esc` (Windows/Linux) لبدء جلسة terminal جديدة لـ OpenCode حتى لو كانت هناك جلسة مفتوحة. يمكنك أيضا النقر على زر OpenCode في واجهة المستخدم.
+- **وعي بالسياق**: شارك تلقائيا تحديدك الحالي أو تبويبك مع OpenCode.
+- **اختصارات الإشارة إلى الملفات**: استخدم `Cmd+Option+K` (Mac) أو `Alt+Ctrl+K` (Linux/Windows) لإدراج مراجع الملفات. مثلا: `@File#L37-42`.
+
+---
+
+## التثبيت
+
+لتثبيت OpenCode على VS Code والتفرعات الشائعة مثل Cursor و Windsurf و VSCodium:
+
+1. افتح VS Code
+2. افتح terminal المدمجة
+3. شغّل `opencode` - سيتم تثبيت الامتداد تلقائيا
+
+أما إذا كنت تريد استخدام IDE الخاص بك عند تشغيل `/editor` أو `/export` من واجهة TUI، فستحتاج إلى ضبط `export EDITOR="code --wait"`. [اعرف المزيد](/docs/tui/#editor-setup).
+
+---
+
+### التثبيت اليدوي
+
+ابحث عن **OpenCode** في Extension Marketplace وانقر **Install**.
+
+---
+
+### استكشاف الأخطاء وإصلاحها
+
+إذا فشل تثبيت الامتداد تلقائيا:
+
+- تأكد من أنك تشغّل `opencode` داخل terminal المدمجة.
+- تأكد من تثبيت CLI الخاصة بـ IDE لديك:
+  - لـ VS Code: أمر `code`
+  - لـ Cursor: أمر `cursor`
+  - لـ Windsurf: أمر `windsurf`
+  - لـ VSCodium: أمر `codium`
+  - إذا لم تكن مثبتة، شغّل `Cmd+Shift+P` (Mac) أو `Ctrl+Shift+P` (Windows/Linux) وابحث عن "Shell Command: Install 'code' command in PATH" (أو ما يعادله في IDE لديك)
+- تأكد من أن VS Code لديه الصلاحية لتثبيت الامتدادات

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

@@ -0,0 +1,344 @@
+---
+title: مقدمة
+description: ابدأ باستخدام OpenCode.
+---
+
+import { Tabs, TabItem } from "@astrojs/starlight/components"
+import config from "../../../../config.mjs"
+export const console = config.console
+
+[**OpenCode**](/) هو وكيل ترميز بالذكاء الاصطناعي مفتوح المصدر. يتوفر كواجهة terminal، وتطبيق لسطح المكتب، أو إضافة لبيئة تطوير متكاملة (IDE).
+
+![واجهة OpenCode في terminal مع سمة opencode](../../../assets/lander/screenshot.png)
+
+لنبدأ.
+
+---
+
+#### المتطلبات
+
+لاستخدام OpenCode في terminal، ستحتاج إلى:
+
+1. محاكي terminal حديث مثل:
+   - [WezTerm](https://wezterm.org) متعدد المنصات
+   - [Alacritty](https://alacritty.org) متعدد المنصات
+   - [Ghostty](https://ghostty.org) على Linux وmacOS
+   - [Kitty](https://sw.kovidgoyal.net/kitty/) على Linux وmacOS
+
+2. مفاتيح API لمزوّدي نماذج اللغة (LLM) الذين تريد استخدامهم.
+
+---
+
+## التثبيت
+
+أسهل طريقة لتثبيت OpenCode هي عبر سكربت التثبيت.
+
+```bash
+curl -fsSL https://opencode.ai/install | bash
+```
+
+يمكنك أيضا تثبيته عبر الأوامر التالية:
+
+- **باستخدام Node.js**
+
+        <Tabs>
+
+      <TabItem label="npm">
+      ```bash
+      npm install -g opencode-ai
+      ```
+
+          </TabItem>
+
+        <TabItem label="Bun">
+        ```bash
+        bun install -g opencode-ai
+        ```
+
+          </TabItem>
+
+        <TabItem label="pnpm">
+        ```bash
+        pnpm install -g opencode-ai
+        ```
+
+          </TabItem>
+
+        <TabItem label="Yarn">
+        ```bash
+        yarn global add opencode-ai
+        ```
+
+      </TabItem>
+
+  </Tabs>
+
+- **باستخدام Homebrew على macOS وLinux**
+
+  ```bash
+  brew install anomalyco/tap/opencode
+  ```
+
+  > نوصي باستخدام tap الخاص بـ OpenCode للحصول على أحدث الإصدارات. صيغة `brew install opencode` الرسمية تُدار بواسطة فريق Homebrew ويتم تحديثها بوتيرة أقل.
+
+- **باستخدام Paru على Arch Linux**
+
+  ```bash
+  sudo pacman -S opencode           # Arch Linux (Stable)
+  paru -S opencode-bin              # Arch Linux (Latest from AUR)
+  ```
+
+#### Windows
+
+:::tip[موصى به: استخدم WSL]
+لأفضل تجربة على Windows، نوصي باستخدام [Windows Subsystem for Linux (WSL)](/docs/windows-wsl). يوفر أداء أفضل وتوافقا كاملا مع ميزات OpenCode.
+:::
+
+- **باستخدام Chocolatey**
+
+  ```bash
+  choco install opencode
+  ```
+
+- **باستخدام Scoop**
+
+  ```bash
+  scoop install opencode
+  ```
+
+- **باستخدام NPM**
+
+  ```bash
+  npm install -g opencode-ai
+  ```
+
+- **باستخدام Mise**
+
+  ```bash
+  mise use -g github:anomalyco/opencode
+  ```
+
+- **باستخدام Docker**
+
+  ```bash
+  docker run -it --rm ghcr.io/anomalyco/opencode
+  ```
+
+دعم تثبيت OpenCode على Windows باستخدام Bun قيد العمل حاليا.
+
+يمكنك أيضا تنزيل الملف التنفيذي من صفحة [Releases](https://github.com/anomalyco/opencode/releases).
+
+---
+
+## الإعداد
+
+مع OpenCode يمكنك استخدام أي مزود LLM عبر إعداد مفاتيح API الخاصة به.
+
+إذا كنت جديدا على استخدام مزوّدي LLM، فنوصي باستخدام [OpenCode Zen](/docs/zen).
+إنها قائمة منتقاة من النماذج تم اختبارها والتحقق منها بواسطة فريق OpenCode.
+
+1. شغّل الأمر `/connect` في واجهة TUI، واختر opencode، ثم انتقل إلى [opencode.ai/auth](https://opencode.ai/auth).
+
+   ```txt
+   /connect
+   ```
+
+2. سجّل الدخول، وأضف تفاصيل الدفع، ثم انسخ مفتاح API.
+
+3. الصق مفتاح API.
+
+   ```txt
+   ┌ API key
+   │
+   │
+   └ enter
+   ```
+
+بدلا من ذلك يمكنك اختيار أحد المزوّدين الآخرين. [اعرف المزيد](/docs/providers#directory).
+
+---
+
+## التهيئة
+
+بعد أن قمت بإعداد مزوّد، يمكنك الانتقال إلى المشروع الذي تريد العمل عليه.
+
+```bash
+cd /path/to/project
+```
+
+ثم شغّل OpenCode.
+
+```bash
+opencode
+```
+
+بعد ذلك، هيّئ OpenCode للمشروع عبر تشغيل الأمر التالي.
+
+```bash frame="none"
+/init
+```
+
+سيجعل هذا OpenCode يحلل مشروعك ويُنشئ ملف `AGENTS.md` في جذر المشروع.
+
+:::tip
+يستحسن أن تقوم بعمل commit لملف `AGENTS.md` الخاص بمشروعك إلى Git.
+:::
+
+يساعد هذا OpenCode على فهم بنية المشروع وأنماط الترميز المستخدمة.
+
+---
+
+## الاستخدام
+
+أصبحت الآن جاهزا لاستخدام OpenCode للعمل على مشروعك. لا تتردد في سؤاله أي شيء!
+
+إذا كنت جديدا على استخدام وكيل ترميز بالذكاء الاصطناعي، فإليك بعض الأمثلة التي قد تساعد.
+
+---
+
+### اطرح أسئلة
+
+يمكنك أن تطلب من OpenCode شرح قاعدة الشيفرة لك.
+
+:::tip
+استخدم المفتاح `@` للبحث التقريبي عن الملفات داخل المشروع.
+:::
+
+```txt frame="none" "@packages/functions/src/api/index.ts"
+How is authentication handled in @packages/functions/src/api/index.ts
+```
+
+يفيد هذا عندما تكون هناك أجزاء من قاعدة الشيفرة لم تعمل عليها.
+
+---
+
+### أضف ميزات
+
+يمكنك أن تطلب من OpenCode إضافة ميزات جديدة إلى مشروعك، لكننا نوصي أولا بطلب إنشاء خطة.
+
+1. **أنشئ خطة**
+
+   لدى OpenCode _وضع Plan_ يعطل قدرته على إجراء التغييرات، ويقترح بدلا من ذلك _كيف_ سينفّذ الميزة.
+
+   انتقل إليه باستخدام مفتاح **Tab**. سترى مؤشرا لذلك في الزاوية السفلية اليمنى.
+
+   ```bash frame="none" title="التبديل إلى وضع Plan"
+   <TAB>
+   ```
+
+   الآن لنصف ما نريده أن يفعله.
+
+   ```txt frame="none"
+   When a user deletes a note, we'd like to flag it as deleted in the database.
+   Then create a screen that shows all the recently deleted notes.
+   From this screen, the user can undelete a note or permanently delete it.
+   ```
+
+   احرص على تزويد OpenCode بتفاصيل كافية ليفهم ما تريد. يساعد أن تتحدث إليه كما لو كنت تتحدث إلى مطور مبتدئ ضمن فريقك.
+
+   :::tip
+   أعطِ OpenCode سياقا وأمثلة كافية لمساعدته على فهم ما تريد.
+   :::
+
+2. **حسّن الخطة**
+
+   بعد أن يقدم لك خطة، يمكنك إعطاؤه ملاحظات أو إضافة تفاصيل أكثر.
+
+   ```txt frame="none"
+   We'd like to design this new screen using a design I've used before.
+   [Image #1] Take a look at this image and use it as a reference.
+   ```
+
+   :::tip
+   اسحب الصور وأفلِتها داخل terminal لإضافتها إلى الطلب.
+   :::
+
+   يستطيع OpenCode فحص أي صور تزوده بها وإضافتها إلى الطلب. يمكنك فعل ذلك عبر سحب الصورة وإفلاتها داخل terminal.
+
+3. **ابنِ الميزة**
+
+   عندما تشعر بالارتياح للخطة، عد إلى _وضع Build_ بالضغط على مفتاح **Tab** مرة أخرى.
+
+   ```bash frame="none"
+   <TAB>
+   ```
+
+   ثم اطلب منه تنفيذ التغييرات.
+
+   ```bash frame="none"
+   Sounds good! Go ahead and make the changes.
+   ```
+
+---
+
+### نفّذ تغييرات
+
+للتغييرات الأبسط، يمكنك أن تطلب من OpenCode تنفيذها مباشرة دون الحاجة لمراجعة خطة أولا.
+
+```txt frame="none" "@packages/functions/src/settings.ts" "@packages/functions/src/notes.ts"
+We need to add authentication to the /settings route. Take a look at how this is
+handled in the /notes route in @packages/functions/src/notes.ts and implement
+the same logic in @packages/functions/src/settings.ts
+```
+
+تأكد من تقديم قدر مناسب من التفاصيل لكي يجري OpenCode التغييرات الصحيحة.
+
+---
+
+### تراجع عن التغييرات
+
+لنفترض أنك طلبت من OpenCode إجراء بعض التغييرات.
+
+```txt frame="none" "@packages/functions/src/api/index.ts"
+Can you refactor the function in @packages/functions/src/api/index.ts?
+```
+
+لكن تتضح لك لاحقا أنها ليست ما تريده. يمكنك **التراجع** عن التغييرات باستخدام الأمر `/undo`.
+
+```bash frame="none"
+/undo
+```
+
+سيقوم OpenCode الآن بعكس التغييرات التي أُجريت ويعرض رسالتك الأصلية مجددا.
+
+```txt frame="none" "@packages/functions/src/api/index.ts"
+Can you refactor the function in @packages/functions/src/api/index.ts?
+```
+
+من هنا يمكنك تعديل الطلب وطلب المحاولة مرة أخرى.
+
+:::tip
+يمكنك تشغيل `/undo` عدة مرات للتراجع عن عدة تغييرات.
+:::
+
+أو يمكنك **إعادة تنفيذ** التغييرات باستخدام الأمر `/redo`.
+
+```bash frame="none"
+/redo
+```
+
+---
+
+## المشاركة
+
+يمكن [مشاركة المحادثات](/docs/share) التي تجريها مع OpenCode مع فريقك.
+
+```bash frame="none"
+/share
+```
+
+سيقوم هذا بإنشاء رابط للمحادثة الحالية ونسخه إلى الحافظة.
+
+:::note
+لا تتم مشاركة المحادثات افتراضيا.
+:::
+
+إليك [مثالا لمحادثة](https://opencode.ai/s/4XP1fce5) مع OpenCode.
+
+---
+
+## التخصيص
+
+وهذا كل شيء! أصبحت الآن محترفا في استخدام OpenCode.
+
+لتجعله مناسبا لك، نوصي بـ [اختيار سمة](/docs/themes)، و[تخصيص اختصارات لوحة المفاتيح](/docs/keybinds)، و[إعداد منسقات الشيفرة](/docs/formatters)، و[إنشاء أوامر مخصصة](/docs/commands)، أو التجربة مع [إعدادات OpenCode](/docs/config).