PandaPaw: المضيف البعيد لـ Claude Code و Codex و PandaCode

يحوّل PandaPaw جهازًا يعمل بنظام Windows أو macOS أو Linux تتحكم فيه إلى مضيف وكيل PandaNpc. تبقى محركات البرمجة وملفات المشروع والصدفة والأدوات على ذلك المضيف؛ وتمنحك عملاء PandaNpc واجهة متزامنة من هاتف أو متصفح أو سطح مكتب آخر.

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

ما يديره PandaPaw

• اتصالات الوكلاء عن بُعد لـ Claude Code و OpenAI Codex و PandaCode.
• الخدمات الخلفية والتشغيل التلقائي بحيث يمكن للمضيف العودة بعد إعادة تشغيل عادية.
• تفويض الجهاز القائم على الحساب دون نسخ يدوي لمعرّف Bridge طويل الأمد أو رمز مميز أو مفتاح توقيع.
• المساعدة في تثبيت المحرك عند فقدان محرك برمجة مدعوم.
• إسقاطات مركز الوكلاء التي تعرض إرشادات كل محرك ومهاراته وذاكرته وتعريفات وكيله في تخطيطه الأصلي.
• الشبكات الخاصة للأجهزة للأجهزة المنضمة عبر تدفق الأجهزة المتصلة.
• تدوين سجلات التحديث والإلغاء بحيث يتم الحفاظ على الأدوات التي كانت موجودة قبل PandaPaw.

لا يوفّر PandaPaw اشتراكًا في النماذج بحد ذاته. لا تزال Claude Code و Codex و PandaCode تستخدم بيانات اعتماد المزوّد والحدود المُهيأة لمحركها.

كيف يعمل التنفيذ عن بُعد

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

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

أنظمة تشغيل المضيف المدعومة

يمتلك عميل العرض PandaNpc مصفوفة أنظمة تشغيل أوسع. راجع تثبيت PandaNpc و PandaPaw عند اختيار حزم العميل والمضيف.

التثبيت الموصى به

1. سجّل الدخول إلى PandaNpc.
2. افتح الأجهزة المتصلة.
3. اختر إضافة جهاز. يتم إصدار مفتاح لمرة واحدة ويعرض الحوار أمرًا واحدًا لنظام التشغيل المكتشف.
4. انسخ هذا الأمر إلى المضيف وشغّله هناك.
5. اترك الحوار مفتوحًا إذا أردت أن يكتشف الجهاز الجديد تلقائيًا.

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

مثبّت macOS/Linux البسيط

استخدم هذا النموذج عندما تريد تفويضًا عبر المتصفح بدلاً من مفتاح مُجهز:

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

مثبّت Windows PowerShell البسيط

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

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

التحقق من المضيف

أولاً تحقق من المضيف نفسه:

pandapaw status

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

مطالبة الاختبار: اطبع دليل العمل الحالي واعرض قائمة الملفات في المستوى الأعلى. لا تعدّل أي شيء.

الرد الناجح يثبت أكثر من مجرد مؤشر أخضر: فهو يتحقق من اقتران الحساب، واتصال المرحّل، والمحرك المحدد، ومصادقة المزوّد، وتعيين دليل العمل.

بالنسبة لمشروع مركز الوكلاء، شغّل:

pandapaw agent status --root /absolute/path/to/project

يعرض هذا ما إذا كان المشروع مرتبطًا وما إذا كانت الإعدادات المُدارة متاحة محليًا. يساعد Git remote المستقر PandaPaw على تحديد نفس المشروع عبر الأجهزة.

تفويض الحساب وهوية الاتصال

يستخدم pandapaw login جلسة تفويض جهاز عبر المتصفح. بعد موافقتك، يستلم المضيف بيانات اعتماد خاصة بالجهاز ومفتاح تحقق من مركز الوكلاء عبر TLS، ويكتب إعدادات الجهاز في ~/.pandapaw/، ويسجّل اتصالات المحركات المدعومة، ويربط مشاريع Git المعروفة.

شغّل pandapaw login --force فقط عند التبديل المتعمد بين الحسابات أو استبدال بيانات اعتماد مضيف منتهية الصلاحية. إعادة تفويض جهاز سليم دون سبب قد تنشئ هويات مكررة أو مستبدلة ومربكة.

لا يزال pandapaw qr ينشئ رابط اتصال يدوي قصير الأمد للتوافق والحالات الخاصة. ليس هو الطريقة الأساسية لمضيف جديد؛ فالأجهزة المتصلة أسهل في التدقيق ولا تتطلب من المستخدمين فهم معرّفات Bridge.

مزامنة مركز الوكلاء

مركز الوكلاء موجّه بالأحداث في الحالة المستقرة:

1. يتم اكتشاف التغييرات المحلية في الملفات المُدارة ونشرها إلى المشروع المرتبط.
2. تصل الإصدارات الموقعة عبر تدفق الأحداث.
3. تتم إعادة استخدام ملفات البيان وكتل المحتوى غير المتغيرة بدلاً من تنزيلها مرة أخرى.
4. يلتقط فحص الاسترداد الدوري الأحداث التي فاتت أثناء انقطاع مؤقت.

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

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

أوامر مفيدة

pandapaw login
pandapaw status
pandapaw agent status --root /absolute/path/to/project
pandapaw update --restart
pandapaw uninstall

راجع سجل إصدارات PandaPaw عندما يختلف أمر أو واجهة عن لقطة شاشة أو برنامج تعليمي قديم.

حدود الأمان

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

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

لا يتم العثور على `pandapaw` بعد التثبيت

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

نجح التثبيت، لكن لا يظهر أي جهاز

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

يظهر الجهاز لكن يبقى غير متصل

تأكد من أن المضيف نشط ولديه وصول إلى الإنترنت. تحقق من حالة PandaPaw محليًا. يجب أن يسمح الخادم الوكيل أو جدار الحماية في الشركة بمسار HTTPS/WebSocket الصادر؛ فالمنفذ الوارد لا يحل مشكلة اتصال صادر محظور.

المضيف متصل، لكن Claude Code أو Codex لا يستجيبان

اقتران المضيف لا يوثّق كل مزوّد نماذج. افتح المحرك محليًا أو اتبع مطالبة تسجيل الدخول الظاهرة في الجلسة البعيدة. تأكد أيضًا من أن النموذج المحدد موجود لهذا الحساب وأن حد استخدامه لم يُستنفد.

تفتح الجلسة في مشروع خاطئ

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

لا تظهر تغييرات مركز الوكلاء

شغّل pandapaw agent status --root /path/to/project من جذر Git الصحيح. تأكد من أن المشروع مرتبط، وأن المضيف مسجل دخوله، وأن الملف المحلي جزء من إسقاط مُدار. أبقِ آخر إصدار تم التحقق منه في مكانه أثناء التحقيق بدلاً من حذف الأدلة المُدارة.

التحديث والإلغاء

يقوم pandapaw update --restart بتنزيل الملف الثنائي الحالي، والتحقق من مجموعته الاختبارية SHA-256، واستبدال النسخة المثبتة، وإعادة تشغيل الخدمات المُدارة ليصبح الإصدار نشطًا. يتم الحفاظ على اقتران الحساب الحالي.

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