ظهر مشروع peerd مؤخراً على Hacker News تحت عنوان "Show HN: peerd – AI agent harness that runs entirely in your browser". الفكرة جريبة: وكيل ذكاء اصطناعي يعمل كإضافة متصفح، لا يحتاج إلى خادم منفصل، ولا إلى عمليات خارجية. كل شيء داخل المتصفح. هذا الدليل يشرح لك ما هو peerd، كيف تجربه، وما هي حدوده، بناءً على تحليل README وهيكل المشروع.

ملاحظة مهمة: README المشروع غير واضح تماماً، لذا الخطوات التالية تقريبية وتعتمد على فهم بنية المشروع. لا توجد أوامر تثبيت مؤكدة، وسنذكر ذلك صراحة.

ما هو peerd بالضبط؟

peerd هو إطار عمل (harness) لوكيل AI يعمل كإضافة متصفح. الفكرة: بدلاً من تشغيل وكيل على خادم أو جهاز منفصل، يعمل الوكيل داخل متصفحك، ويتحكم في صفحات الويب نيابة عنك. يستخدم مفاتيح API الخاصة بك (مثل OpenAI) للتواصل مع نموذج لغوي كبير (LLM). المشروع مكتوب بلغة JavaScript خالصة (Vanilla JS) بدون أدوات بناء، ومرخص تحت Apache 2.0.

من يحتاج peerd ومن لا؟

يناسب: مطوري الويب الذين يريدون أتمتة مهام متصفح (ملء نماذج، جمع بيانات، اختبار). صانعي المحتوى التقني الذين يبحثون عن أدوات AI جديدة. أصحاب المشاريع الصغيرة الذين يريدون تجربة AI بدون تكاليف خادم.

لا يناسب: المبتدئين تماماً في البرمجة (يتطلب فهم مفاتيح API وإضافات المتصفح). من يبحث عن حل جاهز ومنتج نهائي (المشروع تجريبي). من يحتاج دعم اللغة العربية (غير مذكور).

المميزات الرئيسية

• يعمل بالكامل في المتصفح (لا خادم)
• إضافة متصفح قياسية (Chrome/Firefox)
• يستخدم مفاتيح API الخاصة بك (تحكم كامل)
• مفتوح المصدر (Apache 2.0)
• مكتوب بـ Vanilla JS (لا يحتاج بناء)

المتطلبات الأساسية قبل البدء

• متصفح حديث (Chrome أو Firefox)
• حساب ومفتاح API من مزود LLM (مثل OpenAI)
• معرفة أساسية بكيفية تحميل إضافات المتصفح في وضع المطور
• محرر نصوص (لتعديل ملف .env)

خطوات التركيب والتثبيت (تقريبية)

لأن README غير واضح، هذه الخطوات مبنية على تحليل بنية المشروع. قد تختلف التفاصيل.

1. استنساخ المستودع: git clone https://github.com/NotASithLord/peerd.git
2. افتح المتصفح، اذهب إلى صفحة الإضافات (chrome://extensions أو about:debugging#/runtime/this-firefox)
3. فعّل "وضع المطور" (Developer mode)
4. اختر "تحميل إضافة غير معبأة" (Load unpacked) واختر مجلد المشروع
5. ابحث عن ملف .env.example في المجلد، انسخه إلى .env واملأ مفاتيح API
6. أعد تحميل الإضافة من صفحة الإضافات

ملاحظة: إذا لم يوجد ملف .env.example، قد تحتاج إلى إنشاء ملف .env بنفسك بناءً على المتغيرات المذكورة في README (غير موجودة حالياً).

شرح ملف .env ومفاتيح API

ملف .env يفترض أن يحتوي على مفاتيح API الخاصة بك. المتغيرات المتوقعة (غير مؤكدة):

• OPENAI_API_KEY: مفتاح API من OpenAI
• ANTHROPIC_API_KEY: مفتاح API من Anthropic (اختياري)

تأكد من عدم مشاركة هذا الملف أو رفعه إلى GitHub.

كيفية تشغيل peerd لأول مرة

بعد تحميل الإضافة، يجب أن يظهر أيقونة peerd في شريط الأدوات. اضغط عليها لفتح الواجهة. قد تحتاج إلى إدخال مفتاح API في واجهة الإضافة إذا لم يتم تعيينه في ملف .env. اكتب أمراً بسيطاً مثل "افتح موقع example.com" لاختبار التشغيل.

أخطاء شائعة وحلولها

استخدامات عملية في السوق السعودي

• أتمتة ملء نموذج اتصال: يمكن للوكيل ملء نموذج على موقع سعودي (مثل نموذج طلب خدمة) بالبيانات المخزنة.
• جمع بيانات من صفحة ويب: استخراج قائمة منتجات من متجر إلكتروني سعودي وتحليلها.
• مساعد تصفح: البحث عن معلومات في موقع حكومي سعودي وتلخيصها.

هل يستحق peerd التجربة؟

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

بدائل مشابهة لـ peerd

أسئلة شائعة (FAQ)

هل peerd آمن للاستخدام؟

نسبياً. الإضافة تعمل في متصفحك وتستخدم مفاتيح API الخاصة بك. لكن أي إضافة لها صلاحيات على المتصفح، لذا تأكد من فهمك للأذونات المطلوبة.

ما هي مفاتيح API التي أحتاجها؟

الأساسي هو مفتاح OpenAI. قد يدعم مزودين آخرين (غير مؤكد).

هل يمكن استخدام peerd بدون اتصال بالإنترنت؟

لا، يحتاج إلى اتصال للتواصل مع API.

ما الفرق بين peerd وأدوات مثل AutoGPT؟

AutoGPT يعمل على نظامك (خادم محلي)، بينما peerd يعمل داخل المتصفح كإضافة.

هل يدعم peerd اللغة العربية؟

غير مذكور في README، لذا لا تفترض ذلك.

كيف أحدث peerd؟

اسحب آخر التغييرات من GitHub وأعد تحميل الإضافة.

ماذا أفعل إذا توقف peerd عن العمل؟

تحقق من تحديثات المشروع، وأعد تحميل الإضافة، وتأكد من صحة مفتاح API.

هل يمكنني المساهمة في تطوير peerd؟

نعم، المشروع مفتوح المصدر. يمكنك فتح Issue أو Pull Request على GitHub.

خلاصة وتوصيات

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