عن المشروع

pi_agent_rust هو أداة سطر أوامر عالية الأداء لوكيل برمجة بالذكاء الاصطناعي مكتوبة بلغة Rust وخالية من الشيفرة غير الآمنة. وهو نقل أصلي لأداة Pi Agent من Mario Zechner، مصمم ليحل محل البدائل الأبطأ والأثقل موارد المبنية على بيئات تشغيل مُدارة مثل Electron أو Node.js. **الميزات الرئيسية:** - **36 أداة مدمجة** موزعة على خمس طبقات: أوامر أساسية (read، write، edit، bash، grep، find، ls، web_search)، وأدوات قابلة للاكتشاف (ast_grep، ast_edit، lsp، debug، أدوات الذاكرة)، وأدوات خلفية (jobs، hub)، وإضافات مقيّدة بالإعدادات (أتمتة المتصفح، التحكم بالحاسوب/سطح المكتب، معالجة الصور/tts/الوسائط) - **استجابات متدفقة** مع دعم كتل التفكير الموسّع عبر محلل SSE مخصص مُهيّأ لظروف الشبكة الواقعية - **دعم النماذج المحلية** جاهز للاستخدام مع Ollama وllama.cpp (llama-server) وmistralrs — دون الحاجة إلى مفتاح API - **تزامن مُهيكل** عبر بيئة تشغيل asupersync لإلغاء قابل للتنبؤ وتنظيف الموارد - **نموذج أمان مقيّد بالصلاحيات**: تنفيذ إضافات على مرحلتين مع حجب على مستوى الأوامر لأنماط shell الخطرة (الحذف التكراري، الكتابة على القرص، الأصداف العكسية)، ودورة حياة ثقة من أربع طبقات (pending → acknowledged → trusted → killed)، وضوابط مفتاح إيقاف مسار hostcall، وسجل مخاطر وقت تشغيل مقاوم للتلاعب - **معمارية موارد محدودة** للجلسات طويلة الأمد باستخدام فهرسة جلسات SQLite مع sidecar من الإصدار v2 لمسارات إعادة الفتح بترتيب O(index+tail) - واجهة طرفية غنية مبنية بـ rich_rust، وهي نقل إلى Rust لمكتبة Rich بلغة Python **التثبيت:** ```bash curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/pi_agent_rust/main/install.sh?$(date +%s)" | bash ``` **الاستخدام السريع:** ```bash # جلسة تفاعلية pi # مع مطالبة أولية pi "Summarize the architecture in src/" # إرفاق ملف pi @src/main.rs "Explain startup flow" # وضع برمجة نصية لطلقة واحدة pi -p "List likely regression risks for this diff" # متابعة آخر جلسة pi --continue ``` **الإعداد:** تُضبط مفاتيح API عبر متغيرات البيئة (مثل `ANTHROPIC_API_KEY`). تعمل المزودات المحلية دون مفاتيح. يمكن تحديث كتالوجات النماذج باستخدام `pi --fetch-models <provider> --refresh-models --persist-models`. يوجد إعداد المزود والنموذج في `~/.pi/agent/models.json`. يستخدم المشروع Doodlestein Self-Releaser (DSR) لجميع عمليات البناء وفحوصات الجودة؛ ويُوجَّه المساهمون بعيداً عن استدعاءات Cargo المباشرة. وتخضع أدلة القياسات لعقود صارمة للعناصر تتطلب نتائج مطابقة المصدر قبل نشر أي ادعاءات موجهة للإصدار.