تثبيت PandaNpc وPandaPaw

يتكون إعداد عميل البرمجة عن بُعد من جزأين مستقلين:

• عميل PandaNpc — الواجهة التي تستخدمها لقراءة الجلسات وإرسال الأوامر والموافقة على الأدوات. يعمل على الويب وiOS وWindows وmacOS وLinux.
• مضيف PandaPaw — الخدمة الخلفية على الكمبيوتر حيث يتم تنفيذ Claude Code أو Codex أو PandaCode فعليًا.

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

انظر PandaNpc Desktop لمعرفة ما يضيفه تطبيق Windows/macOS/Linux إلى ما هو أبعد من خطوات التثبيت أدناه، بما في ذلك سجل الإصدارات الخاصة به.

اختر ما تريد تثبيته

لأقصر مسار من البداية إلى النهاية، استخدم دليل البدء السريع.

تثبيت عميل PandaNpc

استخدم صفحة تنزيل PandaNpc كمصدر موثوق للمثبتات الحالية. تجنب مواقع التنزيل التابعة لجهات خارجية لأنها قد تقدم حزمًا قديمة أو معدلة.

الويب

افتح pandanpc.com/agent في متصفح حديث. لا يتم تثبيت أي شيء. تخزن مساحة تخزين المتصفح حالة تسجيل الدخول المحلية، لذا قد تتطلب النوافذ الخاصة/التصفح المتخفي تسجيل الدخول مرة أخرى.

iOS

اتبع رابط App Store على صفحة التنزيل وقم بتثبيت PandaNpc. يعد iOS مفيدًا للتحقق من التقدم والإجابة على الأسئلة والموافقة على الأدوات أثناء الابتعاد عن المضيف. لا تزال عملية البرمجة تعمل على جهاز المضيف المتصل. انظر PandaNpc لنظام iOS لمعرفة ما يغطيه التطبيق، بما في ذلك سجل الإصدارات.

Windows

1. قم بتنزيل مثبت Windows الحالي.
2. قم بتشغيله واتبع مطالبات المثبت.
3. قم بتشغيل PandaNpc من قائمة ابدأ.
4. إذا عرض Windows تحذيرًا بشأن الناشر أو السمعة، فتأكد من أن الملف جاء من pandanpc.com قبل المتابعة.

macOS

1. قم بتنزيل ملف .dmg الخاص بنظام macOS.
2. اسحب PandaNpc إلى Applications.
3. قم بتشغيله من Applications وأكمل أي مطالبة أمان في macOS.

إصدار macOS شامل (Universal)، لذا تدعم الحزمة نفسها أجهزة Apple Silicon وأجهزة Mac بمعالج Intel.

Linux

قم بتنزيل AppImage الخاص بمعمارية x86_64، واجعله قابلاً للتنفيذ، ثم قم بتشغيله:

chmod +x PandaNpc_*.AppImage
./PandaNpc_*.AppImage

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

تثبيت PandaPaw على مضيف الوكيل

يوفر PandaPaw حاليًا مثبتات المضيف لأنظمة Windows x64 وmacOS universal وLinux x86_64. قم بتشغيل الأمر على الكمبيوتر الذي يملك ملفات المشروع ويجب أن ينفذ أدوات الوكيل.

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

macOS أو Linux

المثبت العادي مع تفويض المتصفح:

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

نموذج المفتاح الجاهز لمرة واحدة:

curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh -s -- --mesh pnkey-xxxx

Windows PowerShell

المثبت العادي:

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

نموذج المفتاح الجاهز لمرة واحدة:

$env:PANDANET_KEY="pnkey-xxxx"; iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

لا يمكن لخط أنابيب PowerShell iwr | iex تمرير وسائط السكربت العادية، لذلك يقرأ مثبت Windows المفتاح لمرة واحدة من PANDANET_KEY.

ما الذي يغيّره مثبت المضيف

يقوم المثبت بما يلي:

1. يضيف PandaPaw إلى دليل التطبيقات/الملفات التنفيذية للمستخدم الحالي ويحدّث PATH الخاص بالمستخدم عند الحاجة.
2. يسجل الخدمات الخلفية المناسبة لتبدأ تلقائيًا.
3. يثبت محركات البرمجة المدعومة المفقودة عندما يسمح النظام الأساسي بذلك.
4. يوفر بيئة تشغيل Node.js خاصة عندما لا يحتوي النظام على إصدار مناسب.
5. يبدأ تفويض الحساب أو يستبدل مفتاح الجهاز المجهز.
6. يسجل الملفات التي أنشأها بحيث يمكن لإلغاء التثبيت الحفاظ على الأدوات المتوافقة الموجودة مسبقًا.

تثبيت محرك لا يشتري أو يوثق اشتراك نموذج تلقائيًا. قد يطلب Claude Code وCodex تسجيل دخول مزودهما الخاص عند أول تشغيل.

التحقق من التثبيت

افتح طرفية جديدة بعد التثبيت وقم بتشغيل:

pandapaw status

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

التحديث

تخطرك عملاء سطح المكتب عند توفر تحديث. يتم تحديث iOS من خلال App Store.

حدّث PandaPaw وأعد تشغيل خدماته المدارة باستخدام:

pandapaw update --restart

يتحقق المحدّث من الملف الثنائي الذي تم تنزيله مقابل المجموع الاختباري SHA-256 المنشور قبل استبدال النسخة المثبتة. يتم الحفاظ على ربط حسابك وهوية الاتصال الحالية. كما أن إعادة تشغيل أمر التثبيت مدعومة عندما يكون المحدّث نفسه غير متاح.

إلغاء التثبيت

• عميل Windows: الإعدادات → التطبيقات → التطبيقات المثبتة → PandaNpc → إلغاء التثبيت.
• عميل macOS: قم بإنهاء PandaNpc، ثم انقله من Applications إلى سلة المهملات.
• عميل Linux: قم بإزالة AppImage وأي مشغل أنشأته له.
• مضيف PandaPaw: قم بتشغيل pandapaw uninstall على المضيف.

يميز بيان إلغاء التثبيت الخاص بـPandaPaw الأدوات التي أنشأها المثبت عن الأدوات المتوافقة الموجودة مسبقًا. وهو متحفظ عمدًا بدلاً من حذف تثبيت حالي لـClaude Code أو Codex أو PandaCode أو Node.

مشاكل التثبيت

انتهى الأمر ولكن المضيف غير متصل

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

لا يمكن للصدفة العثور على `pandapaw`

افتح طرفية جديدة. على macOS/Linux، تحقق من ~/.local/bin؛ على Windows، تحقق من %LOCALAPPDATA%\Programs\pandapaw. لا تعد إعادة التثبيت مرارًا حتى تتأكد من وجود الملف التنفيذي وأن PATH فقط قديم.

فشل تثبيت محرك برمجة

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

AppImage أو تطبيق سطح المكتب لن يفتح

تأكد من أنك قمت بتنزيل الحزمة للمعمارية الصحيحة، ثم قم بتشغيلها من طرفية لالتقاط الخطأ الأول. قم بتضمين هذا الخطأ وإصدار نظام التشغيل الخاص بك عند الاتصال بالدعم؛ لقطات الشاشة لنافذة مغلقة عادةً لا تكفي لتشخيص مكتبة وقت تشغيل مفقودة.

للفحوصات الخاصة بالاتصال بالمضيف، تابع مع دليل PandaPaw أو الأسئلة الشائعة.