امنح وكيلك أي حاسوب

أمر واحد. رابط واحد. طرفية حقيقية لوكيلك، وعرض مباشر لك.

شغّل Porterminal على حاسوب يعمل بنظام Windows أو macOS أو Linux وامنح الرابط الناتج لوكيل الذكاء الاصطناعي الخاص بك. سيحصل على صدفة حقيقية مع الملفات والأدوات والمشاريع الموجودة على ذلك الجهاز. افتح الرابط نفسه على هاتفك أو في أي متصفح لمشاهدة الوكيل وهو يعمل والكتابة في طرفيته.

ابدأ من هنا

على الحاسوب الذي تريد منحه لوكيلك:

uvx ptn

1. امنح الوكيل الرابط. اضغط على c في نافذة Porterminal المحلية لنسخ عنوان URL وتعليمات الاتصال. الصقهما في وكيلك مع مهمة. يحتاج الوكيل إلى دعم MCP عن بُعد أو طريقة لإجراء طلبات HTTP.
2. افتح عرضك. امسح رمز QR أو افتح عنوان URL الكامل في متصفح. اختر علامة تبويب 🤖 الخاصة بالوكيل لرؤية طرفيته.
3. اعملا معًا. راقب المخرجات، أو أجب عن مطالبة تفاعلية، أو اكتب أمرًا، أو أغلق علامة التبويب لإنهاء تلك الصدفة.
4. ادخل إلى حاسوبك من أي هاتف. استخدم متصفح هاتفك للبرمجة بالحدس، والإصلاحات السريعة، وتشغيل الأوامر، والمزيد.

للبدء في مشروع معين، استخدم uvx ptn /path/to/project. لخيارات التثبيت، راجع installation، أو استخدم أحد برامج التثبيت أدناه.

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

الوكيل يعمل. وأنت تبقى على اطلاع.

وكيلك	أنت
يشغّل الأوامر في صدفة الحاسوب الحقيقية	تراقب المخرجات نفسها مباشرةً في متصفح
يقرأ شاشات الطرفية ويجيب عن المطالبات	تكتب في الطرفية نفسها عند الحاجة
يحافظ على حالة الصدفة عبر استدعاءات الأدوات	تتنقل بين علامات تبويب الوكيل والشخصية
يستخدم MCP أو HTTP للاتصال	يستخدم رمز QR أو عنوان URL من هاتف أو حاسوب مكتبي

إدخال الطرفية مشترك؛ نسّق الكتابة مع وكيلك. يدعم Porterminal تطبيقات الطرفية التفاعلية، وعلامات تبويب متعددة، وإعادة الاتصال بالجلسات قيد التشغيل ما دام الخادم والجلسة على قيد الحياة.

تتضمن واجهة الهاتف مفاتيح Ctrl/Alt/Shift، والتحديد باللمس، والتمرير، والتكبير بالقرص، وحقل إنشاء لتحرير الإدخال الأطول أو إملائه. راجع terminal controls.

جرّب العرض التوضيحي

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

يتضمن demo guide مشروعًا جاهزًا للنسخ، ومهمة للوكيل، وخطة تسجيل مدتها 60 ثانية. يوضح الأوامر، وتغييرات الملفات، والتحقق، والإدخال البشري في جلسة مشتركة واحدة.

اربط وكيلك

يؤدي الضغط على c إلى نسخ تعليمات طرق الاتصال المتاحة. كما يقدّمها الخادم قيد التشغيل على <url>/llms.txt.

هنا، <url> هو عنوان URL الكامل المُولّد، بما في ذلك رمز الوصول الخاص به.

قدرة الوكيل	الاتصال
MCP عن بُعد	<url>/mcp — Streamable HTTP
طلبات HTTP	<url>/api/agent/run — REST
أتمتة المتصفح	افتح <url>/؛ استخدم Terminal screen و Terminal input

يكشف MCP عن أربع أدوات: run_command و read_screen و send_keys و send_signal. يعيد REST قيمة session_id يعيد الوكيل استخدامها للأوامر والتفاعل اللاحقين. تظهر صدَف الوكلاء كعلامات تبويب 🤖 في متصفحك.

راجع agent access لإعداد العميل، وأمثلة الطلبات، وأعمار الجلسات، والأوامر طويلة التشغيل.

التثبيت

يتطلب Python 3.12+. يحاول Porterminal تثبيت cloudflared تلقائيًا عند غيابه.

الطريقة	التشغيل أو التثبيت	التحديث
uvx	uvx ptn	uvx --isolated ptn@latest
uv tool	uv tool install ptn	uv tool upgrade ptn
pipx	pipx install ptn	pipx upgrade ptn
pip	pip install ptn	pip install -U ptn

ثبّت uv و Porterminal معًا:

Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/porterminal/porterminal/master/install.ps1 | iex"

macOS / Linux:

curl -LsSf https://raw.githubusercontent.com/porterminal/porterminal/master/install.sh | sh

الاستخدام

بعد التثبيت، شغّل ptn أو ptn /path/to/project.

الخيار	الغرض
--no-tunnel	التشغيل دون نفق Cloudflare
--mcp-only	إتاحة MCP فقط؛ يعطّل رمز QR والمحطة الطرفية في المتصفح وواجهة REST API
--compose	البدء مع تفعيل حقل compose للجوال
--init	إنشاء .ptn/ptn.yaml مع أزرار مكتشفة من سكربتات المشروع
--password	إضافة كلمة مرور للوصول إلى المحطة الطرفية في المتصفح
--help	عرض جميع الخيارات
--version	عرض الإصدار المثبّت

أثناء التشغيل: c ينسخ تعليمات الوكيل، و**u** ينسخ الرابط فقط، و**s** يعرض نص المشاركة على الشاشة (q يغلقه). Ctrl+C يوقف Porterminal. في وضع MCP-only تستخدم مفاتيح المشاركة رابط MCP.

توجد الأصداف المخصصة وأزرار شريط الأدوات وإعدادات بدء التشغيل في ptn.yaml. راجع الإعدادات.

الأمان

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

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

كلمة المرور الاختيارية تحمي اتصالات المتصفح. يستخدم MCP وREST الرابط الكامل كبيانات اعتماد لهما ولا يتطلبان تلك كلمة المرور.

راجع الأمان للنموذج الكامل وسلوك كلمة المرور. أبلغ عن الثغرات عبر سياسة الأمان.

التوثيق والتطوير

• التثبيت
• وصول الوكيل: MCP وREST والبديل عبر المتصفح
• إعداد العرض التجريبي والتسجيل
• الإعدادات
• البنية
• التطوير وعملية الإصدار
• سجل التغييرات

نرحّب بتقارير الأخطاء وطلبات الميزات كـ issues. لا تُقبل طلبات السحب الخارجية ومساهمات الشيفرة؛ راجع CONTRIBUTING.md. يمكنك عمل fork وتشغيل نسختك الخاصة.

الترخيص