summaryrefslogtreecommitdiffhomepage
path: root/packages/web/src/content/docs/ar/ide.mdx
blob: 354d95a07d3131ba6e9d59fdd1a912d305d7d871 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
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 لديه الصلاحية لتثبيت الامتدادات