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

يدعم ⁦Elide⁩ أوامر فرعية متعددة مُنظَّمة حسب الوظيفة: أوامر الخادم، وأوامر التشغيل، وأوامر المشروع، وأوامر الشبكات المتميزة، وأوامر ⁦PKI⁩، وأوامر سلسلة أدوات ⁦JVM⁩، وأوامر دورة الحياة.

صيغة الاستخدام

Usage:
  elide srcfile.{js|ts|jsx|tsx|py|kts...} [OPTIONS] [--] [ARG...]
  or:  elide {script} [OPTIONS] [--] [ARG...]
  or:  elide build|test|check|project [OPTIONS] [TASKS...]
  or:  elide info|help|discord|bug... [OPTIONS]
  or:  elide js|node [OPTIONS] [--code CODE] [FILE] [ARG...]
  or:  elide run|repl|serve [OPTIONS] [--code CODE] [FILE] [ARG...]
  or:  elide javac|kotlinc|jar|javadoc|... [OPTIONS] [SOURCES...]

إدارة وتكوين وتشغيل التطبيقات متعددة اللغات باستخدام ⁦Elide⁩.

مستويات الترخيص

تنقسم أوامر ⁦Elide⁩ إلى مستويين:

المستوى	الأوامر	المتطلبات
مجاني / مجتمعي	`run`، `serve`، `dev`، `build`، `test`، `install`، `init`، `info`، `help`، `upgrade`، `pro`، `lsp`، `mcp`، جميع أدوات ⁦JVM⁩، جميع مُشغّلات اللغات	لا شيء
متميز (⁦Elide Pro⁩)	`fwd`، `orb` (`netorb`)، `tun` (`tunnel`)، `crt` (`cert`)	ترخيص ⁦Elide Pro⁩ نشط أو بناء ⁦EAP⁩ غير منتهي الصلاحية (فترة سماح 30 يوماً)

تعرض الأوامر المتميزة المحمية بـ ⁦EAP⁩ شعار تحذير كهرماني مع الأيام المتبقية. تعرض بُنى ⁦EAP⁩ المنتهية أو بُنى الإصدار بدون ترخيص شعار حظر أحمر وتخرج برمز ⁦1⁩. يتطلب أمر ⁦tun⁩ ترخيصاً كاملاً (بدون سماح ⁦EAP⁩). تسمح أوامر ⁦fwd⁩ و ⁦orb⁩ و ⁦crt⁩ بسماح ⁦EAP⁩.

بعض _الميزات_ المتميزة المُفعَّلة عبر تكوين ⁦PKL⁩ (⁦Tailscale⁩، ⁦auto-HTTPS⁩، الوكيل الأمامي، وكيل ⁦L4⁩) محمية أيضاً بالترخيص على مستوى التكوين، بغض النظر عن الأمر الذي يُحمّلها.

أوامر الخادم

⁦`serve`⁩ -- مجاني

خادم ⁦HTTP⁩ بمستوى إنتاجي مع ملفات ثابتة، ومعالجات ⁦JS/TS⁩، وضغط (⁦brotli⁩/⁦zstd⁩/⁦gzip⁩)، و ⁦ETag/304⁩، وتحديد المعدل، و ⁦TLS⁩، و ⁦H/1.1⁩ + ⁦H/2⁩، ولوحة تحكم تفاعلية ⁦TUI⁩.

shell

$  elide serve ./public                          # serve static files
$  elide serve --host 0.0.0.0 --port 8080 ./dist # custom bind
$  elide serve server.ts                          # JS/TS handler
$  elide serve --no-tui ./public                  # plain log output
$  elide serve --dev ./public                     # dev mode (live-reload SSE)
$  elide serve --config server.pkl ./public       # PKL configuration
$  elide serve --check-config --config server.pkl # validate config, exit

العلامة	الافتراضي	الوصف
`--host <ADDR>`	`127.0.0.1`	اسم المضيف أو عنوان ⁦IP⁩ للربط.
`--port <PORT>`	`3000`	المنفذ للتقديم عليه.
`--no-tui`	`false`	تعطيل لوحة تحكم ⁦TUI⁩، واستخدام مخرجات السجل العادية.
`--dev`	`false`	تفعيل وضع التطوير: نقطة نهاية ⁦SSE⁩ لإعادة التحميل المباشر، وحقن سكربت ⁦HTML⁩، وتخزين مؤقت مخفف.
`-c, --config <FILE>`	لا شيء	المسار إلى ملف تكوين ⁦PKL⁩.
`--check-config` / `--validate`	`false`	التحقق من صحة التكوين والخروج دون بدء الخادم. يخرج برمز ⁦0⁩ عند النجاح و ⁦1⁩ عند الفشل. مشابه لـ ⁦`nginx -t`⁩.
`--reactors <N>`	`1`	عدد خيوط المفاعل (حلقة الأحداث).
`--workers <N>`	`0` (تلقائي)	إجمالي عدد خيوط العمال عبر جميع المفاعلات.
`--workers-per-reactor <N>`	`0`	خيوط العمال لكل مفاعل. لها الأولوية على ⁦`--workers`⁩.
`--pin-reactors`	`false`	تثبيت كل خيط مفاعل على نواة ⁦CPU⁩ خاصة به (⁦Linux⁩ فقط).
`--recv-pool-max <N>`	تلقائي	الحد الأقصى لمخازن الاستقبال المُحتفَظ بها لكل فئة حجم في مجمع كل مفاعل.
`--admin-port <PORT>`	لا شيء	تفعيل واجهة ⁦API⁩ للإدارة على هذا المنفذ ⁦TCP⁩ (يرتبط بـ ⁦`--admin-host`⁩).
`--admin-host <ADDR>`	`127.0.0.1`	عنوان الربط لواجهة ⁦API⁩ للإدارة.
`--admin-socket <PATH>`	لا شيء	تفعيل واجهة ⁦API⁩ للإدارة عبر مقبس نطاق ⁦Unix⁩ (⁦Unix⁩ فقط). حصري مع ⁦`--admin-port`⁩.
`--admin-token <TOKEN>`	لا شيء	رمز ⁦Bearer⁩ لمصادقة واجهة ⁦API⁩ للإدارة.

يقبل وسيط الموضوع مجلداً (تقديم ملفات ثابتة) أو ملف ⁦.js⁩/⁦.mjs⁩/⁦.ts⁩/⁦.mts⁩ (إرسال معالج ⁦JS/TS⁩ عبر ⁦CQ⁩).

⁦`dev`⁩ -- مجاني

خادم تطوير مع إعادة تحميل مباشر، ومراقبة الملفات، ولوحة تحكم تفاعلية ⁦TUI⁩. يُفعّل وضع التطوير تلقائياً.

shell

$  elide dev ./public
$  elide dev --no-tui ./public
$  elide dev --no-watch ./public
$  elide dev --port 8080 ./public

العلامة	الافتراضي	الوصف
`--host <ADDR>`	`127.0.0.1`	اسم المضيف أو عنوان ⁦IP⁩ للربط.
`--port <PORT>`	`3000`	المنفذ للتقديم عليه.
`--no-tui`	`false`	تعطيل لوحة تحكم ⁦TUI⁩.
`--no-watch`	`false`	تعطيل مراقبة الملفات.

أوامر الشبكات المتميزة

⁦`fwd`⁩ -- متميز (ترخيص أو ⁦EAP⁩)

وكيل أمامي مع اعتراض ⁦TLS⁩ من نوع ⁦MITM⁩ اختياري، والتحكم في الوصول، وحظر المضيفين، ومُرحّل ⁦L4⁩ (⁦TCP⁩). يتضمن واجهة ⁦TUI⁩ تفاعلية ووضع مخرجات ⁦JSON-lines⁩.

shell

$  elide fwd                                              # HTTP forward proxy on 127.0.0.1:8080
$  elide fwd --mitm                                       # with TLS interception
$  elide fwd --block "*.ads.example.com,tracker.example.net"
$  elide fwd --l4 --l4-listen 0.0.0.0:443                # SNI-routed TLS passthrough
$  elide fwd --config proxy.pkl                           # PKL configuration
$  elide fwd --json                                       # JSON-lines output

العلامة	الافتراضي	الوصف
`-l, --listen <ADDR:PORT>`	`127.0.0.1:8080`	عنوان الاستماع.
`-c, --config <FILE>`	لا شيء	ملف تكوين ⁦PKL⁩. علامات واجهة سطر الأوامر تتجاوز الإعدادات الفردية.
`--mitm`	`false`	تفعيل اعتراض ⁦TLS⁩ من نوع ⁦MITM⁩.
`--ca-cert <FILE>`	مُنشأ تلقائياً	شهادة ⁦CA⁩ لـ ⁦MITM⁩ (⁦PEM⁩). يتطلب ⁦`--mitm`⁩.
`--ca-key <FILE>`	مُنشأ تلقائياً	المفتاح الخاص لـ ⁦CA⁩ لـ ⁦MITM⁩ (⁦PEM⁩). يتطلب ⁦`--mitm`⁩.
`--block <PATTERNS>`	لا شيء	حظر أنماط أسماء المضيفين (⁦glob⁩، مفصولة بفواصل).
`--allow-hosts <PATTERNS>`	لا شيء	السماح بأنماط أسماء المضيفين هذه فقط. يُفعّل الرفض الافتراضي.
`--allow-clients <CIDRs>`	لا شيء	السماح بالاتصالات من نطاقات ⁦CIDR⁩ هذه فقط.
`--allow-ports <PORTS>`	لا شيء	السماح بمنافذ الوجهة هذه فقط (مفصولة بفواصل).
`--deny-ports <PORTS>`	لا شيء	رفض منافذ الوجهة هذه (مفصولة بفواصل).
`--l4`	`false`	تفعيل وضع مُرحّل ⁦L4 TCP⁩ (موجَّه بـ ⁦SNI⁩).
`--l4-listen <ADDR:PORT>`	`0.0.0.0:443`	عنوان استماع ⁦L4⁩ (لوضع ⁦`--l4`⁩).
`--admin-port <PORT>`	لا شيء	منفذ واجهة ⁦API⁩ للإدارة.
`--reactors <N>`	`1`	عدد خيوط المفاعل.
`--workers <N>`	`0` (تلقائي)	إجمالي خيوط العمال.
`--no-tui`	`false`	تعطيل واجهة ⁦TUI⁩.
`--json`	`false`	إخراج ⁦JSON-lines⁩ منظم إلى ⁦stdout⁩. يُعطّل واجهة ⁦TUI⁩.

⁦`orb`⁩ -- متميز (ترخيص أو ⁦EAP⁩)

مُنسّق الشبكة -- خادم ⁦Elide⁩ كامل القدرات. يجمع بين الوكيل العكسي، وموازنة الأحمال، و ⁦Tailscale⁩/⁦WireGuard⁩، ومُرحّل ⁦L4⁩، ووكيل ⁦gRPC⁩، و ⁦WebRTC⁩، و ⁦PKI⁩ الخاصة، و ⁦auto-HTTPS⁩ عبر ⁦ACME⁩، والترقيات بدون توقف. يتطلب ملف تكوين ⁦PKL⁩.

shell

$  elide orb --config server.pkl
$  elide orb --config server.pkl --tailscale
$  elide orb --config server.pkl --tailscale-direct --tailscale-auth-key tskey-auth-...
$  elide orb --config server.pkl --auto-https letsencrypt --domain example.com
$  elide orb --config server.pkl --derp

العلامة	الافتراضي	الوصف
`-c, --config <FILE>`	مطلوب	ملف تكوين ⁦PKL⁩ (⁦`ElideServer.pkl`⁩).
`--tailscale`	`false`	الربط بعنوان ⁦Tailscale IP⁩، واستخدام ⁦TLS⁩ الصادر من ⁦Tailscale⁩. ⁦Unix⁩ فقط.
`--funnel`	`false`	العرض عبر ⁦Tailscale Funnel⁩ (وصول من الإنترنت العام). ⁦Unix⁩ فقط.
`--tailscale-direct`	`false`	عقدة ⁦Tailscale⁩ مستقلة (بدون عفريت ⁦`tailscaled`⁩).
`--tailscale-auth-key <KEY>`	لا شيء	مفتاح مصادقة مسبق لـ ⁦`--tailscale-direct`⁩.
`--tun`	`false`	إنشاء جهاز ⁦TUN⁩ لتوجيه النفق على مستوى النظام.
`--auto-https <PROVIDER>`	لا شيء	تفعيل ⁦auto-HTTPS⁩ عبر ⁦ACME⁩.
`--domain <DOMAINS>`	لا شيء	النطاق(ات) لتوفير شهادات ⁦ACME⁩ لها (مفصولة بفواصل).
`--acme-email <EMAIL>`	لا شيء	بريد ⁦ACME⁩ الإلكتروني للتواصل.
`--acme-staging`	`false`	استخدام بيئة ⁦ACME⁩ التجريبية (شهادات غير موثوقة، للاختبار).
`--dns-challenge <PROVIDER>`	لا شيء	مزود تحدي ⁦DNS-01⁩ (⁦`cloudflare`⁩، ⁦`webhook`⁩).
`--derp`	`false`	تشغيل خادم ترحيل ⁦DERP⁩ إلى جانب خادم ⁦HTTP⁩.
`--derp-port <PORT>`	`3340`	منفذ ترحيل ⁦DERP⁩.
`--admin-port <PORT>`	لا شيء	منفذ واجهة ⁦API⁩ للإدارة.
`--admin-host <ADDR>`	`127.0.0.1`	عنوان ربط واجهة ⁦API⁩ للإدارة.
`--admin-socket <PATH>`	لا شيء	مقبس ⁦Unix⁩ لواجهة ⁦API⁩ للإدارة (⁦Unix⁩ فقط).
`--admin-token <TOKEN>`	تلقائي إذا كان غير محلي	رمز ⁦Bearer⁩ لواجهة ⁦API⁩ للإدارة.
`--no-tui`	`false`	تعطيل واجهة ⁦TUI⁩.
`--json`	`false`	الإخراج بتنسيق ⁦JSON⁩.

⁦`tun`⁩ -- متميز (يتطلب ترخيصاً)

نفق ⁦WireGuard⁩، واتصال ⁦Tailscale⁩، وترحيل ⁦DERP⁩. يتطلب ترخيص ⁦Elide Pro⁩ كاملاً (بدون فترة سماح ⁦EAP⁩).

الأوامر الفرعية: ⁦tun up⁩ -- تشغيل نفق ⁦WireGuard⁩ على مستوى النظام عبر ⁦Tailscale⁩. يُنشئ جهاز ⁦TUN⁩، ويتصادق مع خادم تنسيق ⁦Tailscale⁩، ويُنشئ أنفاق ⁦WireGuard⁩، ويوجّه حركة المرور. يتطلب صلاحيات ⁦root⁩ أو ⁦CAP_NET_ADMIN⁩.

shell

$  elide tun up --auth-key tskey-auth-...
$  elide tun up --auth-key tskey-auth-... --exit -node
$  elide tun up --auth-key tskey-auth-... --advertise-routes 10.0.0.0/24,192.168.1.0/24
$  elide tun up --auth-key tskey-auth-... --json

العلامة	الافتراضي	الوصف
`--auth-key <KEY>`	مطلوب	مفتاح مصادقة مسبق لـ ⁦Tailscale⁩.
`--control-url <URL>`	إنتاج ⁦Tailscale⁩	عنوان خادم تحكم ⁦Tailscale⁩.
`--dev <NAME>`	`elide0`	اسم جهاز ⁦TUN⁩.
`--mtu <N>`	`1280`	⁦MTU⁩ لواجهة ⁦TUN⁩.
`--accept-routes`	`false`	قبول المسارات المُعلَن عنها من الأقران (توجيه الشبكات الفرعية).
`--exit-node`	`false`	الإعلان عن هذه العقدة كعقدة خروج.
`--use-exit-node <PEER>`	لا شيء	توجيه كل حركة المرور عبر قرين محدد.
`--advertise-routes <CIDRs>`	لا شيء	الإعلان عن الشبكات الفرعية المحلية لشبكة ⁦Tailscale⁩ (مفصولة بفواصل).
`--self-signed`	`false`	إنشاء شهادة ⁦TLS⁩ موقعة ذاتياً.
`--serve <PORT>`	لا شيء	بدء خادم ⁦HTTP⁩ أيضاً على النفق.
`--foreground`	`true`	التشغيل في المقدمة.
`--verbose`	`false`	تفعيل التسجيل المفصل.
`--json`	`false`	الإخراج بتنسيق ⁦JSON⁩.

⁦tun down⁩ -- إيقاف النفق. يُعالَج حالياً بإيقاف عملية ⁦tun up⁩ (⁦Ctrl+C⁩).

العلامة	الوصف
`—force`	فرض الإيقاف حتى مع وجود اتصالات نشطة.

⁦tun status⁩ -- عرض حالة النفق والأقران المتصلين والمسارات. يستعلم عفريت ⁦tailscaled⁩ المحلي.

العلامة	الوصف
`—peers`	عرض معلومات تفصيلية عن الأقران.
`—routes`	عرض جدول التوجيه.
`—derp`	عرض اتصالات ترحيل ⁦DERP⁩.
`—json`	الإخراج بتنسيق ⁦JSON⁩.

⁦tun derp⁩ -- تشغيل خادم ترحيل ⁦DERP⁩ مستقل.

العلامة	الافتراضي	الوصف
`—host`	`0.0.0.0`	عنوان الربط.
`—port`	`3340`	منفذ الاستماع.
`—mesh-with`	لا شيء	الاتصال بخوادم ⁦DERP⁩ أخرى لترحيل متعدد المناطق (مفصولة بفواصل).
`—tls-cert`	لا شيء	ملف شهادة ⁦TLS⁩.
`—tls-key`	لا شيء	ملف مفتاح ⁦TLS⁩.
`—stun-port`	لا شيء	تفعيل ⁦STUN⁩ على هذا المنفذ (الافتراضي: ⁦3478⁩).
`—json`	`false`	الإخراج بتنسيق ⁦JSON⁩.

أوامر ⁦PKI⁩

⁦`crt`⁩ -- متميز (ترخيص أو ⁦EAP⁩)

إدارة الشهادات و ⁦PKI⁩ مع سلطة شهادات محلية، وتكامل مخزن ثقة النظام، وتجديد ⁦ACME⁩، وتحويل الصيغ. تدعم جميع الأوامر الفرعية ⁦--json⁩ للإخراج المنظم.

الأوامر الفرعية: ⁦crt ca⁩ -- إنشاء أو عرض سلطة شهادات محلية.

العلامة	الافتراضي	الوصف
`—name`	`Elide Local CA`	الاسم الشائع لسلطة الشهادات.
`—days`	`3650`	فترة الصلاحية بالأيام.
`—key-type`	`ecdsa-p256`	خوارزمية المفتاح (⁦`ecdsa-p256`⁩، ⁦`ecdsa-p384`⁩، ⁦`ed25519`⁩، ⁦`rsa-2048`⁩، ⁦`rsa-4096`⁩).
`—out-dir`	الموقع الافتراضي	مجلد الإخراج.
`—proxy`	`false`	إنشاء سلطة شهادات ⁦MITM⁩ منفصلة للوكيل.
`—force`	`false`	الكتابة فوق سلطة شهادات موجودة.
`—show`	`false`	عرض معلومات سلطة الشهادات الحالية بدلاً من الإنشاء.
`—ct-log`	لا شيء	تفعيل سجل ⁦CT⁩ المُضمَّن.
`—json`	`false`	الإخراج بتنسيق ⁦JSON⁩.

⁦crt generate⁩ -- إنشاء شهادة ⁦TLS⁩.

shell

$  elide crt generate example.com *.example.com
$  elide crt generate --self-signed localhost 127.0.0.1
$  elide crt generate --client alice@example.com    # mTLS client cert

العلامة	الافتراضي	الوصف
	مطلوب	أسماء النطاقات أو عناوين ⁦IP⁩.
`—ca-cert`	سلطة شهادات محلية	ملف شهادة سلطة الشهادات للتوقيع.
`—ca-key`	سلطة شهادات محلية	المفتاح الخاص لسلطة الشهادات للتوقيع.
`—self-signed`	`false`	فرض التوقيع الذاتي (بدون سلطة شهادات).
`—days`	`365`	فترة الصلاحية بالأيام.
`—client`	`false`	إنشاء شهادة عميل (لـ ⁦mTLS⁩).
`—out-cert`	تلقائي	مسار إخراج الشهادة.
`—out-key`	تلقائي	مسار إخراج المفتاح.
`—out-dir`	تلقائي	مجلد الإخراج.
`—bundle`	`false`	تضمين شهادة سلطة الشهادات في الإخراج (السلسلة الكاملة).
`—ct-log`	لا شيء	تفعيل سجل ⁦CT⁩ للشفافية.
`—json`	`false`	الإخراج بتنسيق ⁦JSON⁩.

⁦crt trust⁩ -- تثبيت شهادة سلطة شهادات في مخازن ثقة النظام.

العلامة	الوصف
`[FILE]`	ملف شهادة سلطة الشهادات (حذفه لسلطة شهادات ⁦Elide⁩ المحلية).
`—proxy`	الوثوق بسلطة شهادات ⁦MITM⁩ للوكيل بدلاً من ذلك.
`—firefox`	التثبيت أيضاً في مخزن ⁦Firefox NSS⁩.
`—java`	التثبيت أيضاً في ⁦JVM cacerts⁩.
`—java-home`	مجلد ⁦JVM⁩ الرئيسي لـ ⁦`—java`⁩.
`—system`	التثبيت في المخزن على مستوى الجهاز (يتطلب صلاحيات المسؤول).
`—dry-run`	عرض ما سيتم تنفيذه دون تنفيذه فعلياً.

⁦crt untrust⁩ -- إزالة شهادة سلطة شهادات من مخازن الثقة.

العلامة	الوصف
`[FILE]`	ملف شهادة سلطة الشهادات (حذفه لسلطة شهادات ⁦Elide⁩ المحلية).
`—proxy`	إزالة سلطة شهادات ⁦MITM⁩ للوكيل.
`—all`	الإزالة من جميع المخازن.
`—system`	الإزالة من المخزن على مستوى الجهاز (يتطلب صلاحيات المسؤول).
`—dry-run`	عرض ما سيتم تنفيذه.

⁦crt inspect⁩ -- عرض تفاصيل الشهادة.

shell

$  elide crt inspect ./cert.pem
$  elide crt inspect example.com              # fetch from remote host
$  cat cert.pem | elide crt inspect -         # read from stdin
$  elide crt inspect --chain example.com      # show full chain

العلامة	الوصف
	مسار ملف، أو مضيف بعيد، أو ⁦`-`⁩ للإدخال القياسي.
`—chain`	عرض جميع الشهادات في السلسلة.
`—der`	الإدخال بترميز ⁦DER⁩.
`—brief`	إخراج مضغوط بسطر واحد.
`—json`	الإخراج بتنسيق ⁦JSON⁩.

⁦crt verify⁩ -- التحقق من صلاحية الشهادة وسلسلة الثقة.

العلامة	الوصف
	ملف الشهادة أو المضيف البعيد.
`—ca`	شهادة سلطة الشهادات للتحقق مقابلها.
`—ocsp`	فحص حالة الإلغاء عبر ⁦OCSP⁩.
`—expiry-warn`	تحذير إذا كانت ستنتهي خلال ⁦N⁩ يوم (الافتراضي: ⁦30⁩).
`—hostname`	اسم المضيف للتحقق مقابله.

⁦crt export⁩ -- تحويل الشهادات بين الصيغ.

العلامة	الوصف
	ملف شهادة الإدخال.
`—key`	ملف المفتاح الخاص (مطلوب لـ ⁦PKCS12⁩).
`—chain`	سلسلة سلطة الشهادات/الوسيطة للتضمين.
`—format`	صيغة الإخراج: ⁦`pem`⁩، ⁦`der`⁩، ⁦`pkcs12`⁩.
`—out`	مسار ملف الإخراج (مطلوب).
`—password`	كلمة المرور لإخراج ⁦PKCS12⁩.

⁦crt renew⁩ -- تجديد الشهادات عبر ⁦ACME⁩.

العلامة	الوصف
	أسماء النطاقات (مطلوبة).
`—acme-email`	بريد حساب ⁦ACME⁩ الإلكتروني.
`—acme-server`	عنوان دليل ⁦ACME⁩ (الافتراضي: إنتاج ⁦Let's Encrypt⁩).
`—staging`	استخدام بيئة ⁦Let's Encrypt⁩ التجريبية.
`—dns`	مزود تحدي ⁦DNS-01⁩ (⁦`cloudflare`⁩، ⁦`webhook`⁩).
`—dns-token`	رمز ⁦API⁩ لمزود ⁦DNS⁩.
`—dns-webhook-url`	عنوان ⁦webhook⁩ لـ ⁦DNS-01⁩.
`—force`	التجديد حتى لو لم تكن على وشك الانتهاء.
`—out-dir`	مجلد إخراج الشهادات المُجدَّدة.

أوامر التشغيل

⁦`run`⁩ -- مجاني

تشغيل ملف سكربت أو مقتطف كود. إذا لم يُقدَّم كود، تبدأ جلسة ⁦REPL⁩ تفاعلية. يختار ⁦Elide⁩ لغة مناسبة إذا أُعطي ملفاً مصدرياً يمكن تحديده بوضوح.

shell

$  elide run app.js
$  elide run script.py
$  elide repl
$  elide run --debugger app.js
$  elide run --coverage app.js

العلامة	الوصف
`—debugger[=MODE]`	تفعيل مُصحّح الأخطاء (⁦`auto`⁩، ⁦`cdp`⁩، ⁦`dap`⁩).
`—profiler[=MODE]`	تفعيل مُحلّل الأداء (⁦`cputracing`⁩، ⁦`cpusampling`⁩).
`—coverage[=MODE]`	تفعيل جمع تغطية الكود.
`—lsp`	تفعيل ميزات ⁦LSP⁩.
`—insights`	تفعيل سكربتات الرؤى.

⁦`test`⁩ -- مجاني

تشغيل سكربت متعدد اللغات، أو خادم، أو واجهة تفاعلية في وضع الاختبار.

shell

$  elide test

الأوامر الخاصة باللغات

⁦js⁩، ⁦node⁩ -- تشغيل ⁦JavaScript⁩. مكافئ لـ ⁦elide run --javascript ...⁩.

shell

$  elide js app.js
$  elide node app.js

⁦python⁩ -- تشغيل ⁦Python⁩. مكافئ لـ ⁦elide run --python ...⁩.

shell

$  elide python script.py

⁦ruby⁩ -- تشغيل ⁦Ruby⁩. مكافئ لـ ⁦elide run --ruby ...⁩.

shell

$  elide ruby app.rb

أوامر المشروع

⁦`init`⁩ -- مجاني

تهيئة مشروع ⁦Elide⁩ جديد.

shell

$  elide init

⁦`build`⁩ -- مجاني

تشغيل بناء المشروع أو سكربت البناء.

shell

$  elide build
$  elide build --no-cache
$  elide build --inspect

العلامة	الوصف
`—inspect`	فحص البناء.
`—no-cache`	تعطيل ذاكرة التخزين المؤقت للبناء.

⁦`install`⁩ -- مجاني

حل وتثبيت جميع تبعيات المشروع.

shell

$  elide install
$  elide i
$  elide install --slim
$  elide install --with npm

العلامة	الوصف
`—slim`	وضع التثبيت المخفف.
`—with`	أنظمة بيئية إضافية للتثبيت لها.

⁦`project`⁩ -- مجاني

إدارة مشاريع ⁦Elide⁩ المُعرَّفة بـ ⁦elide.pkl⁩ أو بيانات أخرى.

shell

$  elide project

أوامر الترخيص

⁦`pro`⁩ -- مجاني

إدارة ترخيص ⁦Elide Pro⁩.

الأوامر الفرعية:

الأمر	الوصف
`pro activate`	تفعيل ⁦Elide Pro⁩ برمز ترخيص.
`pro use	FILE>`	تثبيت مفتاح أو ملف ترخيص غير متصل.
`pro whoami`	عرض معلومات الترخيص الحالي.
`pro yeet`	إزالة الترخيص الحالي.

shell

$  elide pro activate elide_pro_1234567890abcdef
$  elide pro use /path/to/license.key
$  elide pro whoami
$  elide pro yeet

أوامر دورة الحياة

⁦`upgrade`⁩ -- مجاني

تحديث ملف ⁦Elide⁩ الثنائي ذاتياً باستخدام ⁦TUF⁩ (⁦The Update Framework⁩) لتحديثات آمنة ومُتحقَّق منها.

shell

$  elide upgrade
$  elide upgrade --check
$  elide upgrade --channel preview
$  elide upgrade --graceful   # zero-downtime upgrade (Unix)

العلامة	الافتراضي	الوصف
`—check`	`false`	التحقق من التحديثات دون تطبيقها.
`—force`	`false`	فرض التحديث حتى لو كان على أحدث إصدار.
`—channel`	`release`	قناة الإصدار (⁦`release`⁩، ⁦`preview`⁩، ⁦`nightly`⁩).
`—graceful`	`false`	ترقية بدون توقف: إشارة للخادم الجاري لتصريف الاتصالات وإيداع واصفات الملفات وإعادة التنفيذ (⁦Unix⁩ فقط).

⁦`info`⁩ -- مجاني

عرض معلومات حول تثبيت ⁦Elide⁩ الحالي.

shell

$  elide info
$  elide info --cargo-lockfile   # print embedded Cargo.lock

العلامة	الوصف
`—cargo-lockfile`	طباعة ⁦Cargo.lock⁩ المُضمَّن والخروج.

أوامر سلسلة أدوات ⁦JVM⁩

تكشف هذه الأوامر عن أدوات ⁦JVM⁩ المضمّنة. تقبل جميعها علامات خاصة بالأداة بعد ⁦--⁩.

الأمر	الوصف
`javac`	مُجمّع ⁦Java⁩ (حتى ⁦JDK 25⁩).
`kotlinc`	مُجمّع ⁦Kotlin⁩.
`jar`	بناء وإدارة أرشيفات ⁦Java⁩.
`javadoc`	إنشاء وثائق ⁦Java⁩.
`javap`	مُفكّك ملفات فئات ⁦Java⁩.
`native-image`	مُجمّع ⁦GraalVM Native Image⁩.
`jib`	مُنشئ صور حاويات لتطبيقات ⁦JVM⁩/الأصلية.
`javaformat`	مُنسّق كود ⁦Java⁩.
`ktfmt`	مُنسّق كود ⁦Kotlin⁩.
`mvn`	أداة بناء ⁦Maven⁩ المضمّنة.

shell

$  elide javac -- [JAVAC_OPTIONS] [SOURCES...]
$  elide kotlinc -- [KOTLINC_OPTIONS] [SOURCES...]
$  elide jar -- [TOOL_OPTIONS] [FILES...]
$  elide native-image [OPTIONS]

أدوات المطورين

⁦`lsp`⁩ -- مجاني

تشغيل نسخة ⁦LSP⁩ (⁦Language Server Protocol⁩) لمشروع ⁦Elide⁩.

shell

$  elide lsp

⁦`mcp`⁩ -- مجاني

تشغيل خادم ⁦MCP⁩ (⁦Model Context Protocol⁩) لمشروع ⁦Elide⁩.

shell

$  elide mcp
$  elide mcp --mode stdio
$  elide mcp --mode http --host localhost --port 8123

العلامة	الافتراضي	الوصف
`—mode`	لا شيء	وضع التشغيل: ⁦`stdio`⁩ أو ⁦`http`⁩.
`—host`	`localhost`	مضيف الربط (وضع ⁦HTTP⁩).
`—port`	`8123`	منفذ الربط (وضع ⁦HTTP⁩).

⁦`help`⁩ -- مجاني

فتح الوثائق، أو الإبلاغ عن أخطاء، أو طلب ميزات.

shell

$  elide help
$  elide docs serve
$  elide bug

الخيارات العامة

تدعم جميع الأوامر هذه الخيارات العامة:

الخيار	الوصف
`-h, --help`	عرض نص المساعدة لأي أمر.
`-V, --version`	طباعة معلومات الإصدار والخروج. على ⁦Linux x86_64⁩، يُعترَض ⁦`--version`⁩ قبل تهيئة بيئة التشغيل لاستجابة فورية.
`-v, --verbose`	تفعيل الإخراج المفصل (تسجيل التصحيح). يُعيّن ⁦`ELIDE_LOG=debug`⁩.
`--debug`	تفعيل ميزات التصحيح والتسجيل على مستوى التتبع. يُعيّن ⁦`ELIDE_LOG=trace`⁩.
`-q, --quiet`	كتم معظم الإخراج.
`-p, --project <PATH>`	المسار إلى مجلد مشروع محدد.
`--color`	فرض وضع الألوان.
`--no-color`	فرض وضع بدون ألوان.
`--timeout <DURATION>`	المهلة المُطبَّقة عند الخروج (قابلة للقراءة، مثل ⁦`30s`⁩، ⁦`5m`⁩).
`--locale <LOCALE>`	تجاوز لغة العرض.
`--use-version <VERSION>`	التفويض إلى إصدار محدد مثبت من ⁦Elide⁩.
`--ignore-version`	تجاهل ⁦`.elideversion`⁩ و ⁦`--use-version`⁩؛ تشغيل الملف الثنائي الحالي.
`--no-telemetry`	تعطيل القياس عن بُعد. لا تأثير له على بُنى ⁦EAP⁩ غير المُرخَّصة.
`--no-sidecar`	تعطيل عملية ⁦sidecar⁩؛ يفرض الرجوع لـ ⁦UDP⁩ للقياس عن بُعد على ⁦Linux⁩.
`--cloud`	تفعيل الاتصال السحابي (يتجاوز الافتراضي للأمر الفرعي).
`--no-cloud`	تعطيل الاتصال السحابي.
`--no-native`	تعطيل الوصول الأصلي.
`--debugger[=MODE]`	تفعيل مُصحّح الأخطاء (⁦`auto`⁩، ⁦`cdp`⁩، ⁦`dap`⁩).
`--profiler[=MODE]`	تفعيل مُحلّل الأداء (⁦`cputracing`⁩، ⁦`cpusampling`⁩).
`--coverage[=MODE]`	تفعيل تغطية الكود.
`-X, --vm <KEY=VALUE>`	تعيين خاصية ⁦VM⁩/المحرك (يمكن تكراره).
`--insights <FILES>`	تفعيل سكربتات الرؤى.
`--crash`	الانهيار فوراً (للاختبار).
`--`	فاصل بين خيارات ⁦Elide⁩ والمعاملات الموضعية / وسائط السكربت.

نصيحة: ملفات الوسائط

يدعم ⁦Elide⁩ ملفات الوسائط (⁦argfiles⁩). أضف بادئة ⁦@⁩ لاسم ملف لقراءة الخيارات منه، خيار واحد في كل سطر. الوسائط بعد ⁦--⁩ لا تُوسَّع أبداً.

رموز الخروج

الرمز	المعنى
`0`	تنفيذ ناجح أو ⁦`--help`⁩ / ⁦`--version`⁩.
`1`	فشل عام: وسائط غير صالحة، خطأ في الخادم، خطأ في التكوين، حظر بوابة الترخيص، انتهاء ⁦EAP⁩، فشل التهيئة.
`2`	استثناء في كود المستخدم (خطأ وقت تشغيل لغة الضيف).

على ⁦Linux x86_64⁩، يخرج ⁦--version⁩ عبر استدعاء نظام خام ⁦syscall(exit_group, 0)⁩ قبل تهيئة بيئة تشغيل ⁦Rust⁩، لذا رمز الخروج دائماً ⁦0⁩.

متغيرات البيئة

المتغير	الوصف
`ELIDE_LOG`	مستوى التسجيل (⁦`trace`⁩، ⁦`debug`⁩، ⁦`info`⁩، ⁦`warn`⁩، ⁦`error`⁩). يُتجاوَز بـ ⁦`--verbose`⁩ و ⁦`--debug`⁩.
`TAILSCALE_AUTH_KEY`	بديل لـ ⁦`--tailscale-auth-key`⁩ لوضع ⁦Tailscale⁩ المستقل.
`ELIDE_EAP_TTL_DAYS`	تجاوز فترة سماح ⁦EAP⁩ (بُنى التصحيح فقط؛ بُنى الإصدار تستخدم مهلة ثابتة 30 يوماً).

انظر أيضاً

تكامل ⁦Tailscale⁩

شبكات بدون تكوين، و ⁦TLS⁩، ومصادقة عبر ⁦Tailscale⁩

البدء

شغّل أولى عينات الكود مع ⁦Elide⁩

السابق: البدء التالي: الإصدارات

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

صيغة الاستخدام

مستويات الترخيص

أوامر الخادم

⁦serve⁩ -- مجاني

⁦dev⁩ -- مجاني

أوامر الشبكات المتميزة

⁦fwd⁩ -- متميز (ترخيص أو ⁦EAP⁩)

⁦orb⁩ -- متميز (ترخيص أو ⁦EAP⁩)

⁦tun⁩ -- متميز (يتطلب ترخيصاً)

أوامر ⁦PKI⁩

⁦crt⁩ -- متميز (ترخيص أو ⁦EAP⁩)

أوامر التشغيل

⁦run⁩ -- مجاني

⁦test⁩ -- مجاني

الأوامر الخاصة باللغات

أوامر المشروع

⁦init⁩ -- مجاني

⁦build⁩ -- مجاني

⁦install⁩ -- مجاني

⁦project⁩ -- مجاني

أوامر الترخيص

⁦pro⁩ -- مجاني

أوامر دورة الحياة

⁦upgrade⁩ -- مجاني

⁦info⁩ -- مجاني

أوامر سلسلة أدوات ⁦JVM⁩

أدوات المطورين

⁦lsp⁩ -- مجاني

⁦mcp⁩ -- مجاني

⁦help⁩ -- مجاني

الخيارات العامة

رموز الخروج

متغيرات البيئة

انظر أيضاً

تكامل ⁦Tailscale⁩

البدء

⁦`serve`⁩ -- مجاني

⁦`dev`⁩ -- مجاني

⁦`fwd`⁩ -- متميز (ترخيص أو ⁦EAP⁩)

⁦`orb`⁩ -- متميز (ترخيص أو ⁦EAP⁩)

⁦`tun`⁩ -- متميز (يتطلب ترخيصاً)

⁦`crt`⁩ -- متميز (ترخيص أو ⁦EAP⁩)

⁦`run`⁩ -- مجاني

⁦`test`⁩ -- مجاني

⁦`init`⁩ -- مجاني

⁦`build`⁩ -- مجاني

⁦`install`⁩ -- مجاني

⁦`project`⁩ -- مجاني

⁦`pro`⁩ -- مجاني

⁦`upgrade`⁩ -- مجاني

⁦`info`⁩ -- مجاني

⁦`lsp`⁩ -- مجاني

⁦`mcp`⁩ -- مجاني

⁦`help`⁩ -- مجاني