linuztx/alter-zeroإطار وكيل طرفي موفّر لذاكرة الوصول العشوائي للبرمجة والأمن السيبراني والأتمتة.
اقرأ الكود وابنِه وصحّح أخطاءه وراجعه مع وكيل يعمل إلى جانبك.
استخدم الأدوات نفسها لأبحاث الأمن السيبراني والتحقيق التقني والأتمتة اليومية.
البدء السريع · الميزات · موفّرو النماذج · الأوامر والاختصارات · الدعم · شكر وتقدير
Alter Zero هو وكيل برمجة بالذكاء الاصطناعي مفتوح المصدر مكتوب بلغة Rust. يعمل مباشرة داخل مشروعك: يقرأ الملفات، ويجري التعديلات، ويشغّل الأوامر، ويتحقق من النتائج بينما تتابع أنت كل ذلك في طرفيتك. البرمجة هي محوره الأساسي، مع مرونة تتيح لك التحقيق في المشكلات الأمنية، واستكشاف الأنظمة غير المألوفة، وأتمتة المهام باستخدام أدواتك الحالية.
| ما تحصل عليه | لماذا يهم |
|---|---|
| عمل يمكنك متابعته | مخرجات الأوامر المباشرة، والفروقات المقروءة، وقائمة مهام واضحة تجعل متابعة التقدّم سهلة. |
| تحكّم في التنفيذ | اختر وضع الأذونات، وراجع التغييرات المقترحة، ووجّه الوكيل أثناء عمله. |
| حرية اختيار النموذج | اتصل عبر اشتراك مدعوم أو مفتاح API، أو شغّل نماذج محلية باستخدام Ollama. |
| مجال للتوسيع | أضف وكلاء فرعيين متخصصين، ومهارات قابلة لإعادة الاستخدام، وخطافات دورة الحياة، وخوادم MCP لتناسب سير عملك. |
| تجربة طرفية أصلية | ملف Rust تنفيذي واحد مع جلسات دائمة، وصور مضمّنة، وتحكّم بالكامل عبر لوحة المفاتيح. |
يعمل Alter Zero على Linux (x86_64، arm64) وmacOS (Intel، Apple silicon) في طرفية حديثة.
سطر واحد على Linux أو macOS:
curl -fsSL https://raw.githubusercontent.com/linuztx/alter-zero/main/install.sh | sh
يختار البنية المناسبة لجهازك، ويتحقق من SHA-256 مقابل المجموع الاختباري المنشور مع الإصدار، ويثبّت alter-zero في ~/.local/bin، وينبّهك إذا لم يكن هذا المجلد ضمن PATH لديك.
اضبط ALTER_ZERO_INSTALL_DIR للتثبيت في مكان آخر، أو ALTER_ZERO_VERSION=vX.Y.Z لتثبيت إصدار محدّد. يسجّل CHANGELOG.md ما تغيّر بين الإصدارات.
ALTER_ZERO_INSTALL_DIR="$HOME/bin" ALTER_ZERO_VERSION=v0.1.0 \
sh -c "$(curl -fsSL https://raw.githubusercontent.com/linuztx/alter-zero/main/install.sh)"
للتثبيت اليدوي، تسرد ملاحظات كل إصدار جميع الأرشيفات مع مجاميع SHA-256 الخاصة بها، بحيث يمكنك التنزيل والتحقق والاستخراج يدويًا.
يبني docker/ صورة Kali Rolling صغيرة بلا واجهة رسومية حول أحدث إصدار، مع مجموعة أدوات سطر أوامر جاهزة، لـ Docker أو Podman. أمر واحد يبنيها ويشغّل حاوية على أحد مجلداتك:
docker/build.sh ~/projects/site # add --engine podman for Podman
docker exec -it -e TERM -e COLORTERM -e TERM_PROGRAM -e KITTY_WINDOW_ID -e TMUX \
alter-zero-kali alter-zero
خارج أي مُضاعِف طرفيات، تمرّر أعلام -e هوية طرفيتك حتى تُعرض الصور كصور حقيقية بدلًا من أنصاف الكتل. يغطي دليل الحاوية مساحات العمل، والمنافذ المنشورة، ولصق الصور، وإضافة الأدوات.
داخل tmux، فعّل allow-passthrough على المضيف واختر صراحةً بروتوكول صور الطرفية الخارجية لأمر docker exec ذلك؛ تتضمن تعليمات tmux مثالًا جاهزًا للتشغيل باستخدام Podman.
تحتاج إلى rustup ومترجم C. يثبّت المستودع إصدار سلسلة أدوات Rust، ويقوم rustup بتثبيته تلقائيًا.
git clone https://github.com/linuztx/alter-zero.git
cd alter-zero
cargo install --path .
alter-zero
بدون مزوّد مُهيّأ، يفتح Alter Zero عرضًا توضيحيًا دون اتصال بجولات مكتوبة مسبقًا لتتمكن من استكشاف الواجهة. للعمل على مهامك الخاصة:
/login واختر اشتراكًا مدعومًا، أو مزوّد API، أو خادم نماذج محلي. اتبع التعليمات للاتصال./model لاختيار نموذج. يتذكّر Alter Zero اختيارك لهذا المجلد.تُحفظ عمليات تسجيل الدخول المضافة عبر /login في ~/.alter-zero/.env، خارج مستودعك. استخدم / لتصفح الأوامر أو ? في محرّر فارغ لعرض الاختصارات.
يمكنك أيضًا اختيار مزوّدك قبل التشغيل. اضبط متغير مفتاح API الخاص به ومعرّف المزوّد، ثم شغّل التطبيق. على سبيل المثال، مع OpenRouter:
export OPENROUTER_API_KEY="your-api-key"
export ALTER_ZERO_PROVIDER=openrouter
alter-zero
اختر نموذجًا باستخدام /model، أو اضبط ALTER_ZERO_MODEL على معرّف النموذج قبل التشغيل.
ابدأ بمهمة محددة ودع الوكيل ينجزها معك.
| حالة الاستخدام | جرّب أن تطلب |
|---|---|
| البرمجة وتصحيح الأخطاء | "اكتشف سبب فشل هذا الاختبار، وأصلح السبب، وشغّل الاختبارات ذات الصلة." |
| أبحاث الأمن السيبراني | "راجع هذا المستودع بحثًا عن ثغرات أمنية. تتبّع كل اكتشاف إلى الكود واقترح إصلاحًا." |
| التحقيق التقني | "تتبّع كيفية عمل المصادقة في هذا المشروع واشرح أين تحدث فحوصات الوصول." |
| الأتمتة | "اكتب سكربتًا يلخّص هذه السجلات ويرصد الأخطاء المتكررة." |
اتصل بخدمة اشتراك مدعومة، أو مزوّد API، أو خادم نماذج محلي. استخدم /login للاتصال و/model لاختيار نموذجك.