> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lasersell.io/llms.txt
> Use this file to discover all available pages before exploring further.

# مرجع واجهة سطر الأوامر

> دليل واجهة سطر أوامر LaserSell: سلوك البرنامج ومخرجات السجل والتكوين.

تعمل واجهة سطر أوامر LaserSell كبرنامج خلفي يراقب محفظتك وينفذ عمليات الخروج تلقائياً عند استيفاء شروط استراتيجيتك.

## كيف يعمل

بعد فتح محفظتك، تتصل واجهة سطر الأوامر ببث LaserSell وتبدأ المراقبة. يُسجّل كل نشاط في الطرفية عبر مخرجات سجل منظمة.

```shellscript theme={null}
lasersell
```

يعمل البرنامج حتى تضغط **Ctrl+C** للإيقاف التدريجي.

## مخرجات السجل

تُخرج واجهة سطر الأوامر أحداثاً منظمة فور حدوثها:

| الحدث                 | المعنى                                      |
| --------------------- | ------------------------------------------- |
| `startup`             | بدأت واجهة سطر الأوامر، فُتحت المحفظة       |
| `stream_connected`    | متصل ببث LaserSell                          |
| `wallet_registered`   | تم التحقق من ملكية المحفظة مع الخادم        |
| `balance_update`      | تم استطلاع رصيد SOL                         |
| `session_started`     | تم اكتشاف مركز جديد وبدأت المراقبة          |
| `pnl_update`          | تحديث الأرباح/الخسائر لمركز نشط             |
| `sell_scheduled`      | انطلق شرط الخروج، البيع في الانتظار         |
| `sell_attempt`        | تم تقديم معاملة البيع                       |
| `sell_complete`       | تم تأكيد البيع على السلسلة                  |
| `session_closed`      | تم الخروج من المركز بالكامل                 |
| `liquidity_snapshot`  | تحديث سيولة المجمع (الاتجاه + نطاقات العمق) |
| `stream_disconnected` | فُقد اتصال البث                             |

## خيارات سطر الأوامر

| الخيار                 | اختصار | الوصف                                                          |
| ---------------------- | ------ | -------------------------------------------------------------- |
| `--setup`              |        | فرض تشغيل معالج الإعداد                                        |
| `--config <path>`      | `-f`   | مسار ملف تكوين مخصص                                            |
| `--debug`              |        | كتابة سجلات بمستوى التصحيح إلى `~/.lasersell/debug.log`        |
| `--smoke`              |        | تشغيل فحص صحة الاتصال والخروج                                  |
| `--export-private-key` |        | تصدير المفتاح الخاص لمحفظتك بصيغة base58 إلى المخرجات القياسية |

`--smoke` و`--setup` و`--export-private-key` متبادلة الاستبعاد.

## التشغيل بدون واجهة

صُممت واجهة سطر الأوامر لنشر الخوادم بدون واجهة. للفتح الآلي، حدد عبارة المرور عبر متغير البيئة:

```shellscript theme={null}
export LASERSELL_WALLET_PASSPHRASE="your-passphrase"
lasersell
```

على VPS، شغّل في جلسة `tmux` أو `screen` أو استخدم `systemd` لإدارة العملية.

## استراتيجيات الخروج

تدعم واجهة سطر الأوامر جميع استراتيجيات خروج LaserSell المحددة في `~/.lasersell/config.yml`:

| الاستراتيجية        | حقل التكوين          | الوصف                                           |
| ------------------- | -------------------- | ----------------------------------------------- |
| جني الأرباح         | `target_profit`      | خروج عندما يصل الربح إلى هذه النسبة من الدخول   |
| وقف الخسارة         | `stop_loss`          | خروج عندما تصل الخسارة إلى هذه النسبة من الدخول |
| الوقف المتحرك       | `trailing_stop`      | خروج عندما ينخفض الربح بهذه النسبة من الذروة    |
| مهلة الموعد النهائي | `deadline_timeout`   | خروج إجباري بعد N ثانية                         |
| البيع عند التخرج    | `sell_on_graduation` | خروج عند انتقال الرمز إلى تبادل لامركزي جديد    |
| سلم الخروج          | `take_profit_levels` | بيع مبالغ جزئية عند عتبات ربح متعددة            |
| حراسة السيولة       | `liquidity_guard`    | خروج عندما تنخفض سيولة المجمع دون العتبة الآمنة |
| مسار التعادل        | `breakeven_trail`    | وقف متحرك ينشط بمجرد وصول المركز إلى التعادل    |

يجب تفعيل شرط خروج واحد على الأقل. راجع [مثال التكوين](/onboarding/example-configuration) لمرجع التكوين الكامل.

## نسخ التداول

راقب محافظ أخرى واشترِ اختيارياً تلقائياً عند شرائهم:

```yaml theme={null}
watch_wallets:
  - pubkey: "TraderWallet1..."
    label: "whale"
  - pubkey: "TraderWallet2..."
    auto_buy:
      amount: 0.1       # SOL
      amount_usd1: 0.0   # USD1
```

المراكز من المحافظ المراقبة تُدار بنفس استراتيجية الخروج كمراكزك الخاصة.

## تعديل استراتيجيتك

عدّل `~/.lasersell/config.yml` وأعد تشغيل البرنامج. تسري التغييرات عند التشغيل التالي.

لإعادة تشغيل معالج الإعداد:

```shellscript theme={null}
lasersell --setup
```