tui.mdx 9.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387
  1. ---
  2. title: TUI
  3. description: استخدام واجهة المستخدم TUI في OpenCode.
  4. ---
  5. import { Tabs, TabItem } from "@astrojs/starlight/components"
  6. يوفّر OpenCode واجهة terminal تفاعلية (TUI) للعمل على مشاريعك باستخدام LLM.
  7. يؤدي تشغيل OpenCode إلى بدء واجهة TUI للدليل الحالي.
  8. ```bash
  9. opencode
  10. ```
  11. أو يمكنك تشغيلها لدليل عمل محدد.
  12. ```bash
  13. opencode /path/to/project
  14. ```
  15. بعد الدخول إلى واجهة TUI، يمكنك إرسال رسالة كطلب.
  16. ```text
  17. Give me a quick summary of the codebase.
  18. ```
  19. ---
  20. ## مراجع الملفات
  21. يمكنك الإشارة إلى الملفات في رسائلك باستخدام `@`. يُجري ذلك بحثا ضبابيا عن الملفات ضمن دليل العمل الحالي.
  22. :::tip
  23. يمكنك أيضا استخدام `@` للإشارة إلى الملفات في رسائلك.
  24. :::
  25. ```text "@packages/functions/src/api/index.ts"
  26. How is auth handled in @packages/functions/src/api/index.ts?
  27. ```
  28. تُضاف محتويات الملف إلى المحادثة تلقائيا.
  29. ---
  30. ## أوامر Bash
  31. ابدأ الرسالة بـ `!` لتشغيل أمر في shell.
  32. ```bash frame="none"
  33. !ls -la
  34. ```
  35. يُضاف خرج الأمر إلى المحادثة كنتيجة أداة.
  36. ---
  37. ## الأوامر
  38. عند استخدام واجهة OpenCode في terminal، يمكنك كتابة `/` متبوعة باسم أمر لتنفيذ الإجراءات بسرعة. مثلا:
  39. ```bash frame="none"
  40. /help
  41. ```
  42. تملك معظم الأوامر أيضا اختصارا باستخدام `ctrl+x` كمفتاح قائد، حيث إن `ctrl+x` هو المفتاح القائد الافتراضي. [اعرف المزيد](/docs/keybinds).
  43. فيما يلي جميع أوامر الشرطة المائلة المتاحة:
  44. ---
  45. ### connect
  46. أضف موفّرا إلى OpenCode. يتيح لك اختيار أحد الموفّرين المتاحين وإضافة مفاتيح API الخاصة بهم.
  47. ```bash frame="none"
  48. /connect
  49. ```
  50. ---
  51. ### compact
  52. قم بضغط الجلسة الحالية. _الاسم المستعار_: `/summarize`
  53. ```bash frame="none"
  54. /compact
  55. ```
  56. **اختصار لوحة المفاتيح:** `ctrl+x c`
  57. ---
  58. ### details
  59. بدّل عرض تفاصيل تنفيذ الأدوات.
  60. ```bash frame="none"
  61. /details
  62. ```
  63. **اختصار لوحة المفاتيح:** `ctrl+x d`
  64. ---
  65. ### editor
  66. افتح محررا خارجيا لكتابة الرسائل. يستخدم المحرر المحدد في متغير البيئة `EDITOR`. [اعرف المزيد](#editor-setup).
  67. ```bash frame="none"
  68. /editor
  69. ```
  70. **اختصار لوحة المفاتيح:** `ctrl+x e`
  71. ---
  72. ### exit
  73. اخرج من OpenCode. _الأسماء المستعارة_: `/quit`, `/q`
  74. ```bash frame="none"
  75. /exit
  76. ```
  77. **اختصار لوحة المفاتيح:** `ctrl+x q`
  78. ---
  79. ### export
  80. صدّر المحادثة الحالية إلى Markdown وافتحها في المحرر الافتراضي لديك. يستخدم المحرر المحدد في متغير البيئة `EDITOR`. [اعرف المزيد](#editor-setup).
  81. ```bash frame="none"
  82. /export
  83. ```
  84. **اختصار لوحة المفاتيح:** `ctrl+x x`
  85. ---
  86. ### help
  87. اعرض مربع حوار المساعدة.
  88. ```bash frame="none"
  89. /help
  90. ```
  91. **اختصار لوحة المفاتيح:** `ctrl+x h`
  92. ---
  93. ### init
  94. أنشئ ملف `AGENTS.md` أو حدّثه. [اعرف المزيد](/docs/rules).
  95. ```bash frame="none"
  96. /init
  97. ```
  98. **اختصار لوحة المفاتيح:** `ctrl+x i`
  99. ---
  100. ### models
  101. اعرض النماذج المتاحة.
  102. ```bash frame="none"
  103. /models
  104. ```
  105. **اختصار لوحة المفاتيح:** `ctrl+x m`
  106. ---
  107. ### new
  108. ابدأ جلسة جديدة. _الاسم المستعار_: `/clear`
  109. ```bash frame="none"
  110. /new
  111. ```
  112. **اختصار لوحة المفاتيح:** `ctrl+x n`
  113. ---
  114. ### redo
  115. أعِد تنفيذ رسالة تم التراجع عنها سابقا. متاح فقط بعد استخدام `/undo`.
  116. :::tip
  117. ستتم أيضا استعادة أي تغييرات على الملفات.
  118. :::
  119. داخليا، يستخدم هذا Git لإدارة تغييرات الملفات. لذلك يجب أن يكون مشروعك **مستودع Git**.
  120. ```bash frame="none"
  121. /redo
  122. ```
  123. **اختصار لوحة المفاتيح:** `ctrl+x r`
  124. ---
  125. ### sessions
  126. اعرض الجلسات وبدّل بينها. _الأسماء المستعارة_: `/resume`, `/continue`
  127. ```bash frame="none"
  128. /sessions
  129. ```
  130. **اختصار لوحة المفاتيح:** `ctrl+x l`
  131. ---
  132. ### share
  133. شارك الجلسة الحالية. [اعرف المزيد](/docs/share).
  134. ```bash frame="none"
  135. /share
  136. ```
  137. **اختصار لوحة المفاتيح:** `ctrl+x s`
  138. ---
  139. ### themes
  140. اعرض السمات المتاحة.
  141. ```bash frame="none"
  142. /theme
  143. ```
  144. **اختصار لوحة المفاتيح:** `ctrl+x t`
  145. ---
  146. ### thinking
  147. بدّل إظهار كتل التفكير/الاستدلال في المحادثة. عند تفعيله، يمكنك رؤية عملية استدلال النموذج للنماذج التي تدعم التفكير الموسّع.
  148. :::note
  149. يتحكم هذا الأمر فقط فيما إذا كانت كتل التفكير **تُعرض**؛ ولا يفعّل أو يعطّل قدرات الاستدلال في النموذج. لتبديل قدرات الاستدلال فعليا، استخدم `ctrl+t` للتنقّل بين إصدارات النموذج.
  150. :::
  151. ```bash frame="none"
  152. /thinking
  153. ```
  154. ---
  155. ### undo
  156. تراجع عن آخر رسالة في المحادثة. يزيل أحدث رسالة للمستخدم، وكل الردود اللاحقة، وأي تغييرات على الملفات.
  157. :::tip
  158. سيتم أيضا التراجع عن أي تغييرات على الملفات.
  159. :::
  160. داخليا، يستخدم هذا Git لإدارة تغييرات الملفات. لذلك يجب أن يكون مشروعك **مستودع Git**.
  161. ```bash frame="none"
  162. /undo
  163. ```
  164. **اختصار لوحة المفاتيح:** `ctrl+x u`
  165. ---
  166. ### unshare
  167. ألغِ مشاركة الجلسة الحالية. [اعرف المزيد](/docs/share#un-sharing).
  168. ```bash frame="none"
  169. /unshare
  170. ```
  171. ---
  172. ## إعداد المحرر
  173. يستخدم الأمران `/editor` و`/export` المحرر المحدد في متغير البيئة `EDITOR`.
  174. <Tabs>
  175. <TabItem label="Linux/macOS">
  176. ```bash
  177. # Example for nano or vim
  178. export EDITOR=nano
  179. export EDITOR=vim
  180. # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
  181. # include --wait
  182. export EDITOR="code --wait"
  183. ```
  184. لجعل ذلك دائما، أضف هذا إلى ملف تهيئة shell لديك؛
  185. `~/.bashrc`، `~/.zshrc`، إلخ.
  186. </TabItem>
  187. <TabItem label="Windows (CMD)">
  188. ```bash
  189. set EDITOR=notepad
  190. # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
  191. # include --wait
  192. set EDITOR=code --wait
  193. ```
  194. لجعل ذلك دائما، استخدم **System Properties** > **Environment Variables**.
  195. </TabItem>
  196. <TabItem label="Windows (PowerShell)">
  197. ```powershell
  198. $env:EDITOR = "notepad"
  199. # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
  200. # include --wait
  201. $env:EDITOR = "code --wait"
  202. ```
  203. لجعل ذلك دائما، أضف هذا إلى ملف تهيئة PowerShell لديك.
  204. </TabItem>
  205. </Tabs>
  206. تتضمن خيارات المحررات الشائعة ما يلي:
  207. - `code` - Visual Studio Code
  208. - `cursor` - Cursor
  209. - `windsurf` - Windsurf
  210. - `nvim` - محرر Neovim
  211. - `vim` - محرر Vim
  212. - `nano` - محرر Nano
  213. - `notepad` - Windows Notepad
  214. - `subl` - Sublime Text
  215. :::note
  216. تحتاج بعض المحررات مثل VS Code إلى التشغيل مع الخيار `--wait`.
  217. :::
  218. تحتاج بعض المحررات إلى وسائط CLI لتعمل بوضع الحجب. يجعل الخيار `--wait` عملية المحرر تنتظر حتى يتم إغلاقها.
  219. ---
  220. ## الإعداد
  221. يمكنك تخصيص سلوك واجهة TUI عبر ملف إعدادات OpenCode.
  222. ```json title="opencode.json"
  223. {
  224. "$schema": "https://opencode.ai/config.json",
  225. "tui": {
  226. "scroll_speed": 3,
  227. "scroll_acceleration": {
  228. "enabled": true
  229. }
  230. }
  231. }
  232. ```
  233. ### الخيارات
  234. - `scroll_acceleration` - فعّل تسارع التمرير على نمط macOS لتمرير سلس وطبيعي. عند تفعيله، تزداد سرعة التمرير مع إيماءات التمرير السريعة وتبقى دقيقة للحركات الأبطأ. **يتقدّم هذا الإعداد على `scroll_speed` ويستبدله عند تفعيله.**
  235. - `scroll_speed` - يتحكم في سرعة تمرير واجهة TUI عند استخدام أوامر التمرير (الحد الأدنى: `1`). القيمة الافتراضية هي `3`. **ملاحظة: يتم تجاهل هذا إذا تم ضبط `scroll_acceleration.enabled` على `true`.**
  236. ---
  237. ## التخصيص
  238. يمكنك تخصيص جوانب مختلفة من عرض واجهة TUI باستخدام لوحة الأوامر (`ctrl+x h` أو `/help`). تبقى هذه الإعدادات محفوظة عبر عمليات إعادة التشغيل.
  239. ---
  240. #### عرض اسم المستخدم
  241. بدّل ما إذا كان اسم المستخدم يظهر في رسائل الدردشة. يمكنك الوصول إلى هذا عبر:
  242. - لوحة الأوامر: ابحث عن "username" أو "hide username"
  243. - يُحفظ الإعداد تلقائيا وسيتم تذكره عبر جلسات واجهة TUI