البدء السريع مع PandaNpc Work: اربط وكيلك الأول

ابدأ باستخدام PandaNpc Work، مساحة عمل الذكاء الاصطناعي متعددة المحركات. اربط حاسوبًا عبر PandaPaw، واختر محرك وكيل، وتحقق من جلسة عن بُعد.

آخر تحديث

يربط هذا الدليل حاسوبًا واحدًا بـ PandaNpc Work ويتحقق من أنك تستطيع تشغيل Claude Code أو Codex أو PandaCode من جهاز آخر. PandaNpc Work هي مساحة عمل AI متعددة المحركات حيث تفوّض العمل وتتابعه عبر الأجهزة. لا يزال الوكيل ينفّذ على الحاسوب المتصل؛ يوفّر PandaPaw الجسر وبيئة التشغيل المحلية، بينما يمنحك PandaNpc Work واجهة متزامنة للرسائل والموافقات والأسئلة وسجل الجلسات.

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

قبل أن تبدأ

ستحتاج إلى:

  • حساب PandaNpc مفتوح في تطبيق الويب، أو تطبيق سطح المكتب، أو تطبيق iOS.
  • حاسوب متصل يعمل بنظام Windows x64 أو macOS أو Linux x86_64.
  • وصول إلى الإنترنت من المضيف وإذن بتثبيت خدمة خلفية على مستوى المستخدم.
  • مجلد مشروع مسموح لك بتعديله.
  • حساب Claude أو ChatGPT/Codex أو نموذج مخصص إذا لم يكن المحرك الذي اخترته مصادقًا عليه بالفعل.

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

1. أنشئ أمر تثبيت المضيف

أثناء تسجيل الدخول، افتح الأجهزة المتصلة واختر إضافة جهاز. ينشئ PandaNpc مفتاح جهاز لمرة واحدة ويعرض الأمر الدقيق لنظام التشغيل لديك.

انسخ ذلك الأمر إلى الجهاز الذي ينبغي أن يعمل عليه وكيل البرمجة. تعامل معه مثل كلمة مرور حتى يتم استخدامه: مفتاح لمرة واحدة يقترن بجهاز واحد ولا ينبغي نشره في الدردشة أو لقطات الشاشة أو المشكلات أو صادرات سجل shell.

إذا كنت تفضّل تفويض المتصفح بدلًا من مفتاح معِدّ مسبقًا، فاستخدم المثبّت البسيط في الخطوة التالية. يشغّل pandapaw login ويفتح صفحة التفويض لك.

2. ثبّت PandaPaw على المضيف

macOS أو Linux

شغّل الأمر المعِدّ من الأجهزة المتصلة، أو استخدم المثبّت البسيط:

bash
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh

Windows PowerShell

شغّل الأمر المعِدّ من الأجهزة المتصلة، أو استخدم:

powershell
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

يضيف المثبّت PandaPaw وخدماته الخلفية، ويثبّت محركات البرمجة المدعومة المفقودة عندما يكون ذلك ممكنًا، ويوفّر بيئة تشغيل Node.js خاصة عندما لا يمتلك المضيف بيئة مناسبة. مع مفتاح جهاز معِدّ، يحدث اقتران الحساب أثناء التثبيت. مع الأمر البسيط، وافق على طلب تفويض المتصفح عند المطالبة.

قد ينتهي المثبّت حتى عندما يتم تأجيل تفويض الحساب. إذا قال إن التثبيت نجح لكن اتصال الحساب غير مكتمل، فشغّل:

bash
pandapaw login

3. تحقق من خدمات المضيف

على المضيف، شغّل:

bash
pandapaw status

ينبغي أن يتعرف الأمر على الخدمات المثبتة ويعرض الجهاز المتصل بالحساب. إذا لم يتمكن shell من العثور على pandapaw، فافتح طرفية جديدة أولًا حتى يعيد تحميل PATH المحدّث للمستخدم.

بالنسبة لمشروع Git، يمكنك أيضًا التحقق مما إذا كان مركز Agent يتعرف على جذر المشروع:

bash
pandapaw agent status --root /path/to/your/project

استخدم مسار مشروع مطلقًا حقيقيًا. يعمل ربط مشروع مركز Agent بشكل أفضل عندما يحتوي الدليل على remote.origin.url مستقر في Git.

4. ابدأ أول جلسة عن بُعد

  1. افتح PandaNpc Agent على هاتفك أو متصفحك أو حاسوب سطح مكتب آخر.
  2. اعثر على الجهاز المتصل حديثًا. مؤشر حالة أخضر يعني أن المضيف يمكن الوصول إليه حاليًا.
  3. اختر Claude Code أو Codex أو PandaCode وحدد دليل عمل المشروع.
  4. ابدأ جلسة. إذا طلب المحرك منك تسجيل الدخول، فأكمل تفويض ذلك المزوّد على المضيف أو عبر تدفق تسجيل الدخول المعروض.
  5. أرسل مطالبة اختبار غير مدمّرة مثل: Show the current working directory and list the top-level files. Do not edit anything.

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

5. تأكيد سلوك إعادة الاتصال

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

لا تُدخل المضيف في وضع السكون أثناء هذا الاختبار. لا يمكن للمضيف الذي في وضع السكون أو المطفأ تشغيل الوكيل حتى لو ظل الاتصال المحفوظ يظهر في حسابك.

استكشاف الأخطاء وإصلاحها

لا يظهر الجهاز في Agent

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

لا يتم التعرف على `pandapaw`

افتح طرفية جديدة. على macOS/Linux، تأكد من أن ~/.local/bin موجود في PATH. على Windows، يضيف المثبّت %LOCALAPPDATA%\Programs\pandapaw إلى PATH الخاص بالمستخدم؛ ولن تظهر القيمة الجديدة في طرفية فُتحت قبل التثبيت.

الجهاز مدرج لكنه غير متصل

تأكد من أن المضيف قيد التشغيل ومستيقظ وقادر على الوصول إلى الإنترنت. ثم تحقق من pandapaw status. يجب أن تسمح جدران الحماية المؤسسية بحركة HTTPS/WebSocket الصادرة؛ ولا ينبغي إنشاء قاعدة إعادة توجيه منفذ واردة.

الاتصال يعمل لكن المحرك يطلب المصادقة

اقتران PandaPaw وتسجيل الدخول إلى مزوّد النموذج أمران منفصلان. يثبت الاقتران أن المضيف ينتمي إلى حساب PandaNpc الخاص بك؛ وقد يظل Claude Code أو Codex بحاجة إلى تسجيل دخول اشتراكه الخاص أو إعداد API. أكمل تسجيل الدخول العادي للمحرك، ثم أعد محاولة الجلسة.

يفتح الوكيل في المجلد الخطأ

أنهِ جلسة الاختبار تلك وأنشئ جلسة باستخدام دليل العمل المقصود. قبل الموافقة على استخدام أداة، اطلب من الوكيل طباعة الدليل الحالي. لا يضيف الاتصال عن بُعد بيئة عزل لنظام الملفات بحد ذاته؛ تظل أذونات أدوات المحرك ودليل العمل المحدد مهمة.

الخطوات التالية