Reference OS v8 5 دقائق قراءة ٢٧ يونيو ٢٠٢٦ informational: فهم أداة جديدة وتقييمها وتجربتها دليل عملي: تجربة peerd – وكيل AI يعمل بالكامل في متصفحك بدون خوادم ستتعلم كيفية تثبيت وتجربة وكيل AI يعمل…
Show HN: peerd – AI agent harness that runs entirely in your browser
اختر القسم الذي تحتاجه الآن
الفكرة التي تمنع التسرع
تخيل أنك تريد تجربة وكيل AI يقوم بمهام في المتصفح نيابة عنك، لكن كل حل يحتاج إلى خادم، اشتراك شهري، أو إعدادات معقدة. peerd يعد بحل مختلف: يعمل بالكامل في متصفحك، بدون خادم. هل هذا حقيقي؟
قبل أن تطبق، اعرف أين تقف بالضبط
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
ظهر مشروع peerd مؤخراً على Hacker News تحت عنوان "Show HN: peerd – AI agent harness that runs entirely in your browser". الفكرة جريبة: وكيل ذكاء اصطناعي يعمل كإضافة متصفح، لا يحتاج إلى خادم منفصل، ولا إلى عمليات خارجية. كل شيء داخل المتصفح. هذا الدليل يشرح لك ما هو peerd، كيف تجربه، وما هي حدوده، بناءً على تحليل README وهيكل المشروع.
ملاحظة مهمة: README المشروع غير واضح تماماً، لذا الخطوات التالية تقريبية وتعتمد على فهم بنية المشروع. لا توجد أوامر تثبيت مؤكدة، وسنذكر ذلك صراحة.
peerd هو إطار عمل (harness) لوكيل AI يعمل كإضافة متصفح. الفكرة: بدلاً من تشغيل وكيل على خادم أو جهاز منفصل، يعمل الوكيل داخل متصفحك، ويتحكم في صفحات الويب نيابة عنك. يستخدم مفاتيح API الخاصة بك (مثل OpenAI) للتواصل مع نموذج لغوي كبير (LLM). المشروع مكتوب بلغة JavaScript خالصة (Vanilla JS) بدون أدوات بناء، ومرخص تحت Apache 2.0.
يناسب: مطوري الويب الذين يريدون أتمتة مهام متصفح (ملء نماذج، جمع بيانات، اختبار). صانعي المحتوى التقني الذين يبحثون عن أدوات AI جديدة. أصحاب المشاريع الصغيرة الذين يريدون تجربة AI بدون تكاليف خادم.
لا يناسب: المبتدئين تماماً في البرمجة (يتطلب فهم مفاتيح API وإضافات المتصفح). من يبحث عن حل جاهز ومنتج نهائي (المشروع تجريبي). من يحتاج دعم اللغة العربية (غير مذكور).
لأن README غير واضح، هذه الخطوات مبنية على تحليل بنية المشروع. قد تختلف التفاصيل.
git clone https://github.com/NotASithLord/peerd.git.env.example في المجلد، انسخه إلى .env واملأ مفاتيح APIملاحظة: إذا لم يوجد ملف .env.example، قد تحتاج إلى إنشاء ملف .env بنفسك بناءً على المتغيرات المذكورة في README (غير موجودة حالياً).
ملف .env يفترض أن يحتوي على مفاتيح API الخاصة بك. المتغيرات المتوقعة (غير مؤكدة):
OPENAI_API_KEY: مفتاح API من OpenAIANTHROPIC_API_KEY: مفتاح API من Anthropic (اختياري)تأكد من عدم مشاركة هذا الملف أو رفعه إلى GitHub.
بعد تحميل الإضافة، يجب أن يظهر أيقونة peerd في شريط الأدوات. اضغط عليها لفتح الواجهة. قد تحتاج إلى إدخال مفتاح API في واجهة الإضافة إذا لم يتم تعيينه في ملف .env. اكتب أمراً بسيطاً مثل "افتح موقع example.com" لاختبار التشغيل.
نعم، إذا كنت مطوراً وتبحث عن أداة تجريبية لفهم كيفية عمل وكلاء AI في المتصفح. لكن لا تتوقع منتجاً نهائياً. المشروع في مراحله الأولى، README غير واضح، وقد تواجه مشاكل في التركيب. استثمر وقتك إذا كنت مهتماً بالمساهمة أو التعلم.
نسبياً. الإضافة تعمل في متصفحك وتستخدم مفاتيح API الخاصة بك. لكن أي إضافة لها صلاحيات على المتصفح، لذا تأكد من فهمك للأذونات المطلوبة.
الأساسي هو مفتاح OpenAI. قد يدعم مزودين آخرين (غير مؤكد).
لا، يحتاج إلى اتصال للتواصل مع API.
AutoGPT يعمل على نظامك (خادم محلي)، بينما peerd يعمل داخل المتصفح كإضافة.
غير مذكور في README، لذا لا تفترض ذلك.
اسحب آخر التغييرات من GitHub وأعد تحميل الإضافة.
تحقق من تحديثات المشروع، وأعد تحميل الإضافة، وتأكد من صحة مفتاح API.
نعم، المشروع مفتوح المصدر. يمكنك فتح Issue أو Pull Request على GitHub.
peerd فكرة واعدة لكنها غير ناضجة. إذا كنت مستعداً لخوض تجربة تقنية قد تكون غير مستقرة، فجربها. وإلا، انتظر حتى يصبح README أوضح أو يظهر بديل أفضل. تذكر أن الهدف من هذا الدليل هو توفير خريطة طريق عربية عملية، وليس ترويجاً للمشروع.
خطوات عملية مرتبة من التشخيص إلى النتيجة
لماذا؟ للحصول على كود المشروع محليًا
كيف؟ git clone https://github.com/NotASithLord/peerd.git
الناتج: مجلد peerd على جهازك
لماذا؟ لتشغيل peerd كإضافة متصفح
كيف؟ افتح chrome://extensions، فعّل وضع المطور، اختر 'تحميل إضافة غير معبأة' واختر مجلد peerd
الناتج: ظهور أيقونة peerd في شريط الأدوات
لماذا؟ لتزويد الإضافة بمفاتيح API
كيف؟ انسخ .env.example إلى .env واملأ OPENAI_API_KEY (واختياريًا ANTHROPIC_API_KEY)
الناتج: ملف .env صحيح التنسيق
لماذا؟ لتطبيق التغييرات
كيف؟ في صفحة الإضافات، اضغط على زر إعادة التحميل للإضافة
الناتج: الإضافة محدثة وجاهزة
لماذا؟ للتحقق من عمل الوكيل
كيف؟ اضغط على أيقونة peerd، أدخل أمرًا مثل 'افتح example.com'
الناتج: الوكيل ينفذ الأمر أو يظهر خطأ
حوّل القراءة إلى تنفيذ سريع
OPENAI_API_KEY=your_openai_api_key_here ANTHROPIC_API_KEY=your_anthropic_api_key_here
اعرف أين يتعثر الناس وكيف تتجنب ذلك
ماذا تفعل حسب حالتك؟
إذا: إذا كنت مطورًا ولديك مفتاح API
إذن: اتبع خطوات التثبيت وجرب peerd
إذا: إذا كنت مبتدئًا أو تبحث عن حل جاهز
إذن: انتظر حتى يصبح README أوضح أو استخدم بديلاً مثل BrowserGPT
إذا: إذا واجهت مشاكل في التثبيت
إذن: راجع قسم الأخطاء الشائعة أو افتح Issue على GitHub
إذا: إذا كنت بحاجة لدعم العربية
إذن: لا تفترض وجوده؛ اختبر بنفسك أو ابحث عن بديل
جدول صغير يمنع التسويف
نقاط مختصرة ترجع لها لاحقاً
1. peerd مكتوب بـ Vanilla JS بدون أدوات بناء
2. يعمل كإضافة متصفح قياسية (Chrome/Firefox)
3. يستخدم مفاتيح API الخاصة بك (OpenAI إلزامي)
4. مرخص تحت Apache 2.0
5. README غير واضح ولا يحتوي على تعليمات تثبيت مؤكدة
6. لا يدعم اللغة العربية بشكل مذكور
7. المشروع تجريبي وغير ناضج
8. يتطلب اتصالاً بالإنترنت للتواصل مع API
9. يمكن المساهمة عبر GitHub
إجابات مباشرة على ما يبحث عنه الزائر
تعريفات مختصرة تمنع الالتباس
برنامج يستخدم الذكاء الاصطناعي لتنفيذ مهام بشكل مستقل، مثل ملء النماذج أو جمع البيانات.
برنامج صغير يضاف إلى المتصفح لتوسيع وظائفه، مثل peerd.
رمز سري يسمح للتطبيق بالتواصل مع خدمة خارجية مثل OpenAI.
JavaScript خالص بدون استخدام مكتبات أو أطر عمل.
ملف تعليمات في مستودع الكود يشرح كيفية استخدام المشروع.
استخدمها كمسارات متابعة داخل نفس الموضوع
تحول القارئ: من متشكك في جدوى المشاريع الجديدة إلى متمكن من تجربتها وتقييمها بنفسه
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
peerd فكرة واعدة لكنها غير ناضجة. إذا كنت مستعداً لخوض تجربة تقنية قد تكون غير مستقرة، فجربها. وإلا، انتظر حتى يصبح README أوضح أو يظهر بديل أفضل. تذكر أن الهدف من هذا الدليل هو توفير خريطة طريق عربية عملية، وليس ترويجاً للمشروع.
حتى يبقى المرجع صالحاً مع الوقت
FAQ
استمر في القراءة
