| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387 |
- ---
- title: TUI
- description: استخدام واجهة المستخدم TUI في OpenCode.
- ---
- import { Tabs, TabItem } from "@astrojs/starlight/components"
- يوفّر OpenCode واجهة terminal تفاعلية (TUI) للعمل على مشاريعك باستخدام LLM.
- يؤدي تشغيل OpenCode إلى بدء واجهة TUI للدليل الحالي.
- ```bash
- opencode
- ```
- أو يمكنك تشغيلها لدليل عمل محدد.
- ```bash
- opencode /path/to/project
- ```
- بعد الدخول إلى واجهة TUI، يمكنك إرسال رسالة كطلب.
- ```text
- Give me a quick summary of the codebase.
- ```
- ---
- ## مراجع الملفات
- يمكنك الإشارة إلى الملفات في رسائلك باستخدام `@`. يُجري ذلك بحثا ضبابيا عن الملفات ضمن دليل العمل الحالي.
- :::tip
- يمكنك أيضا استخدام `@` للإشارة إلى الملفات في رسائلك.
- :::
- ```text "@packages/functions/src/api/index.ts"
- How is auth handled in @packages/functions/src/api/index.ts?
- ```
- تُضاف محتويات الملف إلى المحادثة تلقائيا.
- ---
- ## أوامر Bash
- ابدأ الرسالة بـ `!` لتشغيل أمر في shell.
- ```bash frame="none"
- !ls -la
- ```
- يُضاف خرج الأمر إلى المحادثة كنتيجة أداة.
- ---
- ## الأوامر
- عند استخدام واجهة OpenCode في terminal، يمكنك كتابة `/` متبوعة باسم أمر لتنفيذ الإجراءات بسرعة. مثلا:
- ```bash frame="none"
- /help
- ```
- تملك معظم الأوامر أيضا اختصارا باستخدام `ctrl+x` كمفتاح قائد، حيث إن `ctrl+x` هو المفتاح القائد الافتراضي. [اعرف المزيد](/docs/keybinds).
- فيما يلي جميع أوامر الشرطة المائلة المتاحة:
- ---
- ### connect
- أضف موفّرا إلى OpenCode. يتيح لك اختيار أحد الموفّرين المتاحين وإضافة مفاتيح API الخاصة بهم.
- ```bash frame="none"
- /connect
- ```
- ---
- ### compact
- قم بضغط الجلسة الحالية. _الاسم المستعار_: `/summarize`
- ```bash frame="none"
- /compact
- ```
- **اختصار لوحة المفاتيح:** `ctrl+x c`
- ---
- ### details
- بدّل عرض تفاصيل تنفيذ الأدوات.
- ```bash frame="none"
- /details
- ```
- **اختصار لوحة المفاتيح:** `ctrl+x d`
- ---
- ### editor
- افتح محررا خارجيا لكتابة الرسائل. يستخدم المحرر المحدد في متغير البيئة `EDITOR`. [اعرف المزيد](#editor-setup).
- ```bash frame="none"
- /editor
- ```
- **اختصار لوحة المفاتيح:** `ctrl+x e`
- ---
- ### exit
- اخرج من OpenCode. _الأسماء المستعارة_: `/quit`, `/q`
- ```bash frame="none"
- /exit
- ```
- **اختصار لوحة المفاتيح:** `ctrl+x q`
- ---
- ### export
- صدّر المحادثة الحالية إلى Markdown وافتحها في المحرر الافتراضي لديك. يستخدم المحرر المحدد في متغير البيئة `EDITOR`. [اعرف المزيد](#editor-setup).
- ```bash frame="none"
- /export
- ```
- **اختصار لوحة المفاتيح:** `ctrl+x x`
- ---
- ### help
- اعرض مربع حوار المساعدة.
- ```bash frame="none"
- /help
- ```
- **اختصار لوحة المفاتيح:** `ctrl+x h`
- ---
- ### init
- أنشئ ملف `AGENTS.md` أو حدّثه. [اعرف المزيد](/docs/rules).
- ```bash frame="none"
- /init
- ```
- **اختصار لوحة المفاتيح:** `ctrl+x i`
- ---
- ### models
- اعرض النماذج المتاحة.
- ```bash frame="none"
- /models
- ```
- **اختصار لوحة المفاتيح:** `ctrl+x m`
- ---
- ### new
- ابدأ جلسة جديدة. _الاسم المستعار_: `/clear`
- ```bash frame="none"
- /new
- ```
- **اختصار لوحة المفاتيح:** `ctrl+x n`
- ---
- ### redo
- أعِد تنفيذ رسالة تم التراجع عنها سابقا. متاح فقط بعد استخدام `/undo`.
- :::tip
- ستتم أيضا استعادة أي تغييرات على الملفات.
- :::
- داخليا، يستخدم هذا Git لإدارة تغييرات الملفات. لذلك يجب أن يكون مشروعك **مستودع Git**.
- ```bash frame="none"
- /redo
- ```
- **اختصار لوحة المفاتيح:** `ctrl+x r`
- ---
- ### sessions
- اعرض الجلسات وبدّل بينها. _الأسماء المستعارة_: `/resume`, `/continue`
- ```bash frame="none"
- /sessions
- ```
- **اختصار لوحة المفاتيح:** `ctrl+x l`
- ---
- ### share
- شارك الجلسة الحالية. [اعرف المزيد](/docs/share).
- ```bash frame="none"
- /share
- ```
- **اختصار لوحة المفاتيح:** `ctrl+x s`
- ---
- ### themes
- اعرض السمات المتاحة.
- ```bash frame="none"
- /theme
- ```
- **اختصار لوحة المفاتيح:** `ctrl+x t`
- ---
- ### thinking
- بدّل إظهار كتل التفكير/الاستدلال في المحادثة. عند تفعيله، يمكنك رؤية عملية استدلال النموذج للنماذج التي تدعم التفكير الموسّع.
- :::note
- يتحكم هذا الأمر فقط فيما إذا كانت كتل التفكير **تُعرض**؛ ولا يفعّل أو يعطّل قدرات الاستدلال في النموذج. لتبديل قدرات الاستدلال فعليا، استخدم `ctrl+t` للتنقّل بين إصدارات النموذج.
- :::
- ```bash frame="none"
- /thinking
- ```
- ---
- ### undo
- تراجع عن آخر رسالة في المحادثة. يزيل أحدث رسالة للمستخدم، وكل الردود اللاحقة، وأي تغييرات على الملفات.
- :::tip
- سيتم أيضا التراجع عن أي تغييرات على الملفات.
- :::
- داخليا، يستخدم هذا Git لإدارة تغييرات الملفات. لذلك يجب أن يكون مشروعك **مستودع Git**.
- ```bash frame="none"
- /undo
- ```
- **اختصار لوحة المفاتيح:** `ctrl+x u`
- ---
- ### unshare
- ألغِ مشاركة الجلسة الحالية. [اعرف المزيد](/docs/share#un-sharing).
- ```bash frame="none"
- /unshare
- ```
- ---
- ## إعداد المحرر
- يستخدم الأمران `/editor` و`/export` المحرر المحدد في متغير البيئة `EDITOR`.
- <Tabs>
- <TabItem label="Linux/macOS">
- ```bash
- # Example for nano or vim
- export EDITOR=nano
- export EDITOR=vim
- # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
- # include --wait
- export EDITOR="code --wait"
- ```
- لجعل ذلك دائما، أضف هذا إلى ملف تهيئة shell لديك؛
- `~/.bashrc`، `~/.zshrc`، إلخ.
- </TabItem>
- <TabItem label="Windows (CMD)">
- ```bash
- set EDITOR=notepad
- # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
- # include --wait
- set EDITOR=code --wait
- ```
- لجعل ذلك دائما، استخدم **System Properties** > **Environment Variables**.
- </TabItem>
- <TabItem label="Windows (PowerShell)">
- ```powershell
- $env:EDITOR = "notepad"
- # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
- # include --wait
- $env:EDITOR = "code --wait"
- ```
- لجعل ذلك دائما، أضف هذا إلى ملف تهيئة PowerShell لديك.
- </TabItem>
- </Tabs>
- تتضمن خيارات المحررات الشائعة ما يلي:
- - `code` - Visual Studio Code
- - `cursor` - Cursor
- - `windsurf` - Windsurf
- - `nvim` - محرر Neovim
- - `vim` - محرر Vim
- - `nano` - محرر Nano
- - `notepad` - Windows Notepad
- - `subl` - Sublime Text
- :::note
- تحتاج بعض المحررات مثل VS Code إلى التشغيل مع الخيار `--wait`.
- :::
- تحتاج بعض المحررات إلى وسائط CLI لتعمل بوضع الحجب. يجعل الخيار `--wait` عملية المحرر تنتظر حتى يتم إغلاقها.
- ---
- ## الإعداد
- يمكنك تخصيص سلوك واجهة TUI عبر ملف إعدادات OpenCode.
- ```json title="opencode.json"
- {
- "$schema": "https://opencode.ai/config.json",
- "tui": {
- "scroll_speed": 3,
- "scroll_acceleration": {
- "enabled": true
- }
- }
- }
- ```
- ### الخيارات
- - `scroll_acceleration` - فعّل تسارع التمرير على نمط macOS لتمرير سلس وطبيعي. عند تفعيله، تزداد سرعة التمرير مع إيماءات التمرير السريعة وتبقى دقيقة للحركات الأبطأ. **يتقدّم هذا الإعداد على `scroll_speed` ويستبدله عند تفعيله.**
- - `scroll_speed` - يتحكم في سرعة تمرير واجهة TUI عند استخدام أوامر التمرير (الحد الأدنى: `1`). القيمة الافتراضية هي `3`. **ملاحظة: يتم تجاهل هذا إذا تم ضبط `scroll_acceleration.enabled` على `true`.**
- ---
- ## التخصيص
- يمكنك تخصيص جوانب مختلفة من عرض واجهة TUI باستخدام لوحة الأوامر (`ctrl+x h` أو `/help`). تبقى هذه الإعدادات محفوظة عبر عمليات إعادة التشغيل.
- ---
- #### عرض اسم المستخدم
- بدّل ما إذا كان اسم المستخدم يظهر في رسائل الدردشة. يمكنك الوصول إلى هذا عبر:
- - لوحة الأوامر: ابحث عن "username" أو "hide username"
- - يُحفظ الإعداد تلقائيا وسيتم تذكره عبر جلسات واجهة TUI
|