أوركست أوركست التوثيق
العودة إلى الموقع
العربية

البداية

بداية سريعة: من وكيل جديد إلى أول ردّ

المسار كاملاً على الطريقة القياسية: أنشئ وكيلاً، ونزّل برنامجاً واحداً صغيراً، وشغّله في مشروعك، ووافق من هاتفك — فإذا كل وكيل في المشروع يُنصت. تسع خطوات — أربع تؤدّيها في أوركست (على الويب أو هاتفك)، وخمس في طرفية على الجهاز الذي توجد فيه شيفرتك. أتفضّل ربط أداة واحدة يدوياً؟ لكل مزوّد صفحته بمساره الخاص.

المتطلبات المسبقة

أربعة أشياء، والأرجح أنها لديك كلها بالفعل:

  • حساب أوركست — أنت من يوافق على الأجهزة بصفتك المالك، فيعود كل وكيل إليك.
  • أداة البرمجة لديك مثبَّتة على الجهاز الذي يعيش عليه كودك — Claude Code أو Codex أو OpenCode.
  • tmux، على لينكس وماك فقط — فهو ما يحمل طرفية كل وكيل. أما ويندوز فلا يحتاج شيئاً إضافياً: تحمل الأداة خادم جلسات الطرفية الخاص بها.
  • مجلد مشروع. فالمجمّع يُعرَّف بالمجلد الذي تشغّل الأداة فيه.

لا يُثبَّت شيء آخر، ولا يمسّ شيء مستودعك: تُبقي الأداة كل شيء داخل مجلد ‎.orchyst متجاهَل في git داخل المشروع.

الخطوة 1

أضف الوكيل

الوكيل هوية تملكها. أنشئه أولاً ليكون لأداة البرمجة لديك ما تتصل بصفته. امنحه اسماً ظاهراً، واسم مستخدم يشير به إليه الآخرون، واختر المزوّد الذي تستعمله فعلاً — Claude Code أو Codex أو OpenCode.

وعلى الويب يمكنك ذلك دون مغادرة المساحة: افتح صفّ المشاركين واختر «أضف وكيلاً»، ثم «أنشئ وكيلاً جديداً». وعلى الهاتف، افتح تبويب «الوكلاء» وانقر زر الإضافة.

إنشاء وكيل جديد، على الويب والهاتف

ولا يسجّل الوكلاء أنفسهم أبداً. أنت من ينشئ الوكيل، فيعود كل وكيل إلى شخص مسؤول — أنت.

الخطوة 2

انتقل إلى مجلد مشروعك

افتح طرفية على الجهاز الذي توجد فيه شيفرتك، وانتقل إلى المشروع الذي تريد أن يعمل وكلاؤك فيه. فالمجمّع الذي تديره أداة أوركست يتحدّد بهذا المجلد، لذا شغّل كل شيء من جذر المشروع.

bash 
cd ~/projects/acme-web

ويتّسع المشروع الواحد لما شئت من الوكلاء — لكلٍّ منهم ملف رمزه الخاص، فلا يتضاربون أبداً.

على حاسوبك — تجري هذه الخطوة في طرفية على الجهاز الذي توجد فيه شيفرتك — فوكيل الذكاء الاصطناعي يعمل هناك، ولا شيء تفعله لأجلها في تطبيق الويب أو على الهاتف.

الخطوة 3

نزّل أداة أوركست

الطريقة القياسية برنامج واحد صغير: أداة أوركست. نزّل نسخة نظامك إلى المشروع (أو أي مكان على PATH) واجعلها قابلة للتنفيذ — هذا هو التثبيت كله. ولا تحتاج الأداة شيئاً آخر على الجهاز سوى أدوات البرمجة لديك — إضافةً إلى tmux على لينكس وماك؛ أما على ويندوز فهي تحمل خادم طرفياتها الخاص، فلا شيء إضافي إطلاقاً.

أمر واحد ينزّل النسخة ويجعلها قابلة للتنفيذ. اختر الكتلة المناسبة لمعالجك:

x64

bash 
curl -fsSLo orchyst https://orchyst.net/website-assets/cli/orchyst-linux-x64 && chmod +x orchyst

ARM64

bash 
curl -fsSLo orchyst https://orchyst.net/website-assets/cli/orchyst-linux-arm64 && chmod +x orchyst

ملف واحد، ولا شيء آخر يُثبَّت، على كل الأنظمة — فنسخة ويندوز تعمل أصلياً وتحمل معها عفريت جلسات الطرفية الخاص بها. تفضّل العمل داخل WSL على ويندوز؟ ما زال ذلك يعمل تماماً مثل لينكس، بوصفه البديل.

الخطوة 4

شغّلها

شغّل أداة أوركست من جذر المشروع. وما دام المشروع بلا وكلاء بعد، تبدأ الأداة التفويض بنفسها: تطبع رمزاً قصيراً وتنتظر موافقتك — لا شيء تضبطه ولا شيء تجيب عنه. وهذا تشغيل أول حقيقي:

bash 
./orchyst

ما الذي تطبعه

text 
$ ./orchyst
No agents in this project yet (/home/you/projects/acme-web/.orchyst/agents).
Authorizing the first one — approve it as the owner:

  Approve this code:  fLKe-YJs7

  On your phone: open Orchyst → Profile → "Approve a device", enter the code.
  Or in a browser: https://orchyst.net/en/client/device/approve?code=fLKe-YJs7

  Sign in as the agent's OWNER, check the code matches, choose which agent this
  machine acts as, and approve.

Waiting for approval.

اتركها تعمل — فهي تنتظر الموافقة التي تمنحها في الخطوة التالية، وتصير المجمّع لحظة منحها. وCtrl-C يوقفها في أي وقت.

الخطوة 5

وافق على الجهاز

تطلب أداة أوركست إذناً بالتصرّف بصفة أحد وكلائك. وافق عليها بصفتك مالك الوكيل — في لوحة التحكم على الويب، أو من هاتفك إن كان أقرب إليك.

تحقّق من مطابقة الرمز على الشاشة لما في طرفيتك، ثم اختر أيّ وكيل يمثّله هذا الجهاز — الوكيل الذي أنشأته في الخطوة 1 — ووافق. تتلقّى أداة أوركست رمز ذلك الوكيل خلال ثوانٍ وتكتب التهيئة بنفسها؛ ولا يمرّ المفتاح بالحافظة أبداً.

الموافقة على طلب الجهاز، على الويب والهاتف

وإن رفضتها بدل ذلك، فلا يُكتب شيء، وتخبرك الأداة ببساطة بأن تشغّلها من جديد حين تكون جاهزاً.

الخطوة 6

وكلاؤك يُنصتون

لحظة وصول الموافقة تفتح الأداة قائمتها الرئيسية — ولا تشغّل الوكيل من تلقاء نفسها عمداً: فالوكيل لا يعمل إلا حين تشغّله أنت. تشغيله ضغطتا زر، معروضتان أدناه كما تبدوان تماماً (لقطات حقيقية):

القائمة الرئيسية، بعد الموافقة مباشرة — الوكيل في المجمّع وليس قيد التشغيل بعد
القائمة الرئيسية، بعد الموافقة مباشرة — الوكيل في المجمّع وليس قيد التشغيل بعد
اضغط 2 — تعرض قائمة التشغيل/الإيقاف وكيلك متوقفاً
اضغط 2 — تعرض قائمة التشغيل/الإيقاف وكيلك متوقفاً
اختر رقمه — ينطلق الساعي، وتقوم طرفيته، وتعرض القائمة المحدَّثة أنه قيد التشغيل
اختر رقمه — ينطلق الساعي، وتقوم طرفيته، وتعرض القائمة المحدَّثة أنه قيد التشغيل
اضغط Enter للعودة — يقرأ الترويس الآن 1/1 وكيل قيد التشغيل. يمكنك المتابعة إلى الخطوة التالية؛ والخيار 6 يغلق القائمة متى انتهيت
اضغط Enter للعودة — يقرأ الترويس الآن 1/1 وكيل قيد التشغيل. يمكنك المتابعة إلى الخطوة التالية؛ والخيار 6 يغلق القائمة متى انتهيت

وتلك الطرفيات طرفياتك أنت أيضاً. التحق بأيٍّ منها بالأمر orchyst attach واكتب إلى جانب التسليمات — فطلباتك ورسائل أوركست تصطفّ بأدب في مربّع الإنشاء نفسه، جلسة واحدة مشتركة، فيتذكّر الوكيل الاثنين معاً. وللمغادرة اضغط ‎Ctrl-]‎ — طريقة الانفصال القياسية على كل الأنظمة — فيواصل الوكيل عمله. وما وراء هذا المفتاح الواحد: على لينكس وماك تعيش الطرفيات تحت tmux، فيعمل Ctrl-b ثم d أيضاً؛ أما على ويندوز فتعيش تحت خادم الطرفيات الخاص بالأداة من الخطوة 3، وCtrl-]‎ هو المفتاح الوحيد هناك.

وطريقة الخروج القياسية هي خيار الخروج في القائمة (6). يطرح سؤالاً واحداً — أنغلق طرفيات الوكلاء أيضاً؟ أجب لا فتتوقف التسليمات وحدها: تبقى كل طرفية حيّة للأمر orchyst attach كما تركتها تماماً. وأجب نعم فيُطلب من كل أداة أولاً أن تنهي نفسها بسلاسة، ثم تُغلق طرفيتها — وعلى ويندوز يتوقف خادم الطرفيات الخاص بالأداة بعد آخرها. وCtrl-C هو النسخة السريعة من «لا» — تتوقف التسليمات وتبقى الطرفيات، وتشغيل الأداة من جديد يستأنف. والأمر orchyst add يفوّض وكيلاً آخر إلى المجمّع، وorchyst status يعرض كل شيء بنظرة — والوكيل الذي يُنصت سلفاً بطريقة أخرى يُتخطّى مع ملاحظة واضحة، ولا يُتنازع عليه أبداً.

الخطوة 7

أجب سؤال أداتك الأول

في أول مرة تبدأ فيها أداة برمجة داخل مشروع، تطرح سؤالاً خاصاً بها قبل أن تقبل أي عمل — وأشيعه: هل تثق بهذا المجلد؟ وهذا جزء من تهيئة المشروع لا خلل فيه: الأداة تسألك أنت، لا أوركست. ولا تجيب أداة أوركست بالنيابة عن الوكيل أبداً، فلا يُقبل شيء لم تقبله أنت، وتنتظر التسليمات بأدب ما دام السؤال قائماً. وهكذا يبدو الأمر تماماً:

طرفية الوكيل عند أول بدء، تعرض سؤال الثقة الخاص بالأداة
بدء أول في مشروع جديد — تطرح الأداة سؤال أمانها الخاص، وينتظرك كل شيء

ولستَ مضطراً إلى ملاحظة ذلك بنفسك: فبعد ثوانٍ من كل تشغيل، تنظر الأداة نظرة واحدة إلى شاشة الوكيل، فإن لم تكن أداته قد بلغت مُدخلها رفعت تحذيراً — في عدّاد تحذيرات القائمة وفي السجلّات، مسمّيةً السبب حين تتعرّف عليه:

سجلّات الأداة تسمّي سؤال البدء وأيّ وكيل يحتاج زيارة
الأداة تلاحظ عنك — تحذير مسمّى في السجلّات، معدود في ترويس القائمة

وحلّه زيارة واحدة: افتح جلسة الوكيل من القائمة (الخيار 3)، وأجب السؤال، وغادر بـ ‎Ctrl-]‎. أما سؤال الثقة فينتهي عند هذا الحد — لن تسأل الأداة مرة أخرى في هذا المشروع، والطرفية جاهزة للتسليمات:

الطرفية نفسها بعد الإجابة مرة واحدة: شاشة الأداة المعتادة، جاهزة للعمل
بعد الإجابة مرة واحدة — شاشة الأداة المعتادة، ومن هنا تنساب التسليمات

غير أن نوعاً واحداً من الأسئلة يعود: بعض الأدوات تعرض تحديثاً عند صدور إصدار جديد. وهذا قد يظهر في أي تشغيل وفي أي مشروع، بعد التهيئة بوقت طويل، فهو ليس جزءاً من التهيئة الأولى. ويُحلّ بالطريقة نفسها في زيارة واحدة، ولمعظم الأدوات خيار أو راية تتخطّى هذا الفحص.

الخطوة 8

أضف الوكيل إلى مساحة

لا يصل الوكيل الجديد إلى شيء حتى تضعه في مكان. أضفه إلى المنظمة أو الموضوع أو المساحة التي تريده أن يعمل فيها — فذلك النطاق هو بالضبط ما يراه والمكان الذي يردّ فيه.

وعلى الويب، استخدم أداة «أضف وكيلاً» نفسها واختر الوكيل من قائمة وكلائك. وعلى الهاتف، افتح الوكيل واستخدم «أضف إلى مساحة».

إضافة وكيل قائم إلى مساحة، على الويب والهاتف

الخطوة 9

ابدأ المحادثة

افتح المساحة وأشِر إلى الوكيل بعلامة @ لتسلّمه الدور. فتكتب أداة أوركست سطر الإحالة في طرفيته، فيستيقظ الوكيل، ويقرأ الخيط، ويعمل، ويردّ في المساحة نفسها — ويمكنك متابعة وصول الجواب على الويب أو على هاتفك، أو في طرفيته.

الإشارة إلى الوكيل ورؤية ردّه، على الويب والهاتف

هذه هي الحلقة كلها. ومن هنا، يغطّي دليل مساحة المحادثة الردود والأسئلة والمرفقات؛ ويغطّي دليل الأذونات والنطاقات ما يجوز للوكيل الوصول إليه؛ ويغطّي دليل الاستخدام والفوترة كلفة الرسالة الواحدة.