مرجع سريع مستمد من توثيق OpenCode ودروس هذه الدورة. معظم العناصر تعمل في كل من OpenCode Desktop وTUI الخاصة بـ OpenCode؛ ما يخص أحدهما دون الآخر مذكور.
لسياق أعمق حول أي عنصر، اتبع الروابط إلى الدرس ذي الصلة أو إلى التوثيق الرسمي.
أوامر الشرطة المائلة
اكتبها داخل موجّه OpenCode. اكتب / وحدها لرؤية القائمة الكاملة للأوامر المتاحة في جلستك الحالية.
| الأمر | ماذا يفعل |
|---|---|
/new (alias /clear) |
ابدأ جلسة جديدة؛ الحالية تبقى في سجلك |
/sessions (aliases /resume, /continue) |
اعرض الجلسات وبدّل بينها |
/help |
اعرض حوار المساعدة وقائمة الأوامر المتاحة |
/init |
إعداد موجّه لإنشاء أو تحديث AGENTS.md على مستوى المشروع — انظر التعليمات |
/connect |
أضف مزوّد نماذج واضبط مفتاح API الخاص به (TUI) |
/models |
افتح منتقي النماذج لتبديل النماذج |
/mcp |
اعرض خوادم MCP المضبوطة وحالة اتصالها — انظر الأدوات |
/themes |
اعرض الثيمات وبدّل بينها (TUI) |
/share |
شارك الجلسة الحالية كرابط عام على opncd.ai/s/<id> |
/unshare |
أوقف مشاركة الجلسة الحالية واحذف البيانات المشتركة |
/undo |
تراجع عن آخر رسالة مستخدم وأي تغييرات ملفات أجراها الوكيل — كرّر الأمر لمواصلة التراجع |
/redo |
استعد رسالة وتغييرات ملفاتها بعد /undo |
/compact (alias /summarize) |
لخّص الجلسة الحالية لتحرير مساحة نافذة السياق |
/details |
بدّل عرض تفاصيل تنفيذ الأدوات داخل المحادثة |
/thinking |
بدّل ظهور كتل استدلال النموذج (للعرض فقط — لا يغيّر قدرة النموذج) |
/editor |
افتح المحرر المعيّن في $EDITOR لكتابة رسالة أطول (TUI) |
/export |
صدّر المحادثة الحالية كـ Markdown وافتحها في $EDITOR (TUI) |
/exit (aliases /quit, /q) |
اخرج من OpenCode (TUI) |
/<your command> |
شغّل أمراً مخصصاً عرّفته في ~/.config/opencode/commands/ أو .opencode/commands/ |
ملاحظة:
/undoو/redoيستخدمان Git داخلياً، لذا يعملان فقط في المشاريع التي هي مستودعات Git.
صيغة الموجّه
رموز خاصة تغيّر كيفية تفسير الموجّه.
| الصيغة | ماذا تفعل |
|---|---|
@<path> |
أشر إلى ملف أو مجلد؛ بحث تقريبي يعمل أثناء الكتابة، ويُضاف محتوى الملف إلى المحادثة (مثلاً Explain @src/index.ts) |
!<command> |
شغّل أمر صدفة من الموجّه؛ تُضاف المخرجات إلى المحادثة كنتيجة أداة (مثلاً !ls -la) |
اختصارات لوحة المفاتيح
Desktop و TUI (مشتركة)
| الاختصار | ماذا يفعل |
|---|---|
Return / Enter |
أرسل الرسالة الحالية |
Shift+Return (أو Ctrl+Return، Alt+Return، Ctrl+J) |
أدرج سطراً جديداً في الموجّه دون إرسال |
Cmd+V (Mac) / Ctrl+V (Windows/Linux) |
الصق صورة أو نصاً من الحافظة في الموجّه |
| السحب والإفلات | اسحب ملف صورة من سطح المكتب أو مدير الملفات إلى نافذة OpenCode لإرفاقها |
Esc |
قاطع رداً قيد التشغيل أو أغلق النوافذ المنبثقة |
تحرير إدخال الموجّه (أسلوب Readline / Emacs)
مدمج في إدخال موجّه OpenCode Desktop. لدى TUI روابط input_* مكافئة يمكن إعادة تعيينها في tui.json.
| الاختصار | ماذا يفعل |
|---|---|
Ctrl+A |
انتقل إلى بداية السطر الحالي |
Ctrl+E |
انتقل إلى نهاية السطر الحالي |
Ctrl+B / Ctrl+F |
حرّك المؤشر حرفاً للخلف / للأمام |
Alt+B / Alt+F |
حرّك المؤشر كلمة للخلف / للأمام |
Ctrl+D |
احذف الحرف تحت المؤشر |
Ctrl+K |
احذف حتى نهاية السطر |
Ctrl+U |
احذف حتى بداية السطر |
Ctrl+W |
احذف الكلمة السابقة |
Alt+D |
احذف الكلمة التالية |
Ctrl+T |
بدّل الحرفين (Desktop فقط — في TUI، Ctrl+T يتنقّل بين تنويعات النموذج) |
Ctrl+G |
ألغِ النوافذ المنبثقة / أوقف الرد قيد التشغيل |
روابط مفاتيح TUI
تستخدم TUI Ctrl+X كمفتاح قائد افتراضياً — اضغط Ctrl+X، أفلت، ثم اضغط المفتاح التالي. يمكنك تغيير القائد وأي ربط في tui.json. انظر توثيق keybinds للقائمة الكاملة.
تركيبات القائد
| الاختصار | ماذا يفعل |
|---|---|
Ctrl+X N |
جلسة جديدة |
Ctrl+X L |
قائمة الجلسات |
Ctrl+X C |
ضغط الجلسة |
Ctrl+X U |
تراجع عن آخر رسالة |
Ctrl+X R |
إعادة آخر رسالة تم التراجع عنها |
Ctrl+X X |
تصدير المحادثة |
Ctrl+X E |
افتح محرراً خارجياً |
Ctrl+X M |
منتقي النماذج |
Ctrl+X T |
منتقي الثيمات |
Ctrl+X A |
منتقي الوكلاء |
Ctrl+X Q |
خروج |
Ctrl+X B |
إظهار/إخفاء الشريط الجانبي |
Ctrl+X S |
عرض الحالة |
Ctrl+X Y |
انسخ آخر رسالة |
مستقلة
| الاختصار | ماذا يفعل |
|---|---|
Tab / Shift+Tab |
تنقّل بين الوكلاء (Plan ↔ Build) — Desktop يستخدم قائمة الوكيل المنسدلة أسفل الموجّه بدلاً من ذلك |
Ctrl+P |
لوحة الأوامر |
Ctrl+T |
تنقّل بين تنويعات النموذج (مثلاً الاستدلال تشغيل/إيقاف) |
F2 / Shift+F2 |
تنقّل بين النماذج المستخدمة مؤخراً |
Ctrl+R |
أعد تسمية الجلسة الحالية |
أوامر CLI
اكتبها في الطرفية، لا في موجّه OpenCode. واجهة opencode CLI تأتي مع OpenCode Desktop وتثبيت TUI المستقل. للقائمة الكاملة للأوامر الفرعية والأعلام، انظر توثيق CLI.
| الأمر | ماذا يفعل |
|---|---|
opencode run "<prompt>" |
شغّل موجّهاً واحداً دون تفاعل ثم اخرج |
opencode session list |
اعرض كل الجلسات عبر كل مشاريعك |
opencode export [sessionID] |
صدّر جلسة كـ JSON؛ يطلب منك الاختيار إذا حُذف المعرّف |
opencode mcp auth [name] |
صادق خادم MCP يدعم OAuth — انظر الأدوات |
opencode mcp auth list (alias ls) |
اعرض حالة OAuth لكل الخوادم المضبوطة |
opencode mcp debug <name> |
اطبع معلومات تصحيح لاتصال خادم MCP |
مسارات الملفات
أين يبحث OpenCode عن ملفات الإعداد والتخصيص. المسارات العالمية تنطبق على كل مشروع؛ مسارات المشروع تنطبق داخله فقط.
عالمي
| المسار | ما هو |
|---|---|
~/.config/opencode/opencode.json |
الإعداد الرئيسي: المزوّدون، الصلاحيات، خوادم MCP، إلخ |
~/.config/opencode/AGENTS.md |
تعليمات مخصصة تُحمَّل في بداية كل جلسة |
~/.config/opencode/commands/ |
أوامر شرطة مائلة مخصصة |
~/.config/opencode/skills/ |
مهارات قابلة لإعادة الاستخدام |
~/.config/opencode/plugins/ |
إضافات JS/TS توسّع OpenCode |
لكل مشروع
| المسار | ما هو |
|---|---|
<project>/AGENTS.md |
تعليمات خاصة بالمشروع، تُرفع عادة إلى Git |
<project>/.opencode/opencode.json |
تجاوزات إعداد خاصة بالمشروع |
<project>/.opencode/commands/ |
أوامر شرطة مائلة خاصة بالمشروع |
<project>/.opencode/skills/ |
مهارات خاصة بالمشروع |
<project>/.opencode/plugins/ |
إضافات خاصة بالمشروع |
أين تنظر بعد ذلك
- توثيق OpenCode هو المرجع الأساسي لكل ما سبق.
- توثيق keybinds يغطّي كل ربط TUI الافتراضي وكيفية إعادة تعيينه في
tui.json. - توثيق CLI يوثّق كل علم وأمر فرعي بالتفصيل.
- المعجم يعرّف المصطلحات المستخدمة في ورقة الغش هذه والدروس.