alex188dot/agensicتحقيقات طرفية مشفرة وإعادة تشغيل الجلسات لوكلاء الذكاء الاصطناعي. يتتبع، يوقع، ويُدقق كل أمر مع علامات المصدر، وجلسات قابلة لإعادة التشغيل، والسفر عبر الزمن في Git. الخصوصية أولاً مع تخزين محلي باستخدام SQLite وتحرير الأسرار.
<p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12868/4480e118bb0f8f08f64f7da7573729d0dc6641679e7781e4c4050d939ea4d1b2.png" alt="شعار Agensic" width="100%" /> </p> <h2 align="center">اعرف ما الذي تم تشغيله وأين ومتى ومن قام بتنفيذه</h2> <h3 align="center">طبقة المراقبة المفقودة لسير عمل الطرفية المدعومة بالذكاء الاصطناعي</h3> <p align="center"> <code>المصدر الموقّع</code> <code>الجلسات المتتبعة</code> <code>السفر عبر الزمن في Git</code> <code>الجلسات القابلة لإعادة التشغيل</code> <code>الإكمال التلقائي بأسلوب IDE</code> </p> --- يعمل Agensic على ترقية سير عمل الطرفية الحالي لديك لعصر الذكاء الاصطناعي. إنه مخصص للمطورين الذين يريدون تعزيز الإنتاجية الذي توفره عوامل الذكاء الاصطناعي مباشرة في شلهم، لكنهم يرفضون التنازل عن **قابلية التدقيق والتحكم والخصوصية**. مع تزايد سيطرة عوامل الذكاء الاصطناعي على سطر الأوامر وتنفيذ المهام بشكل مستقل، تصبح الرؤية والتحكم أمرين بالغي الأهمية. يعامل Agensic **أوامر الطرفية كمواطنين من الدرجة الأولى** ويوفر إطارًا قويًا لتتبعها وفحصها وإدارتها. بدلاً من تسوية كل نشاط الطرفية في "تاريخ شل" واحد غامض، يعمل Agensic كمراقب جنائي ومساعد ذكي. يتتبع بسلاسة جلسات الترميز التفاعلية للذكاء الاصطناعي، ويوقع بشكل تشفيري على الأوامر المنفذة بواسطة العامل، ويوفر إكمالًا تلقائيًا سريعًا بأسلوب IDE مدعومًا بالتاريخ. --- ## 📋 جدول المحتويات 1. [دعم المنصات](#-دعم-المنصات) 2. [التثبيت](#-التثبيت) 3. [البدء السريع](#-البدء-السريع) 4. [مصدر Agensic](#-مصدر-agensic) - [الميزات](#-الميزات-المصدر) - [التسميات المدعومة](#-التسميات-المدعومة) 5. [جلسات Agensic](#-جلسات-agensic) - [الميزات](#-الميزات-الجلسات) - [العوامل المدعومة](#-العوامل-المدعومة) 6. [الإكمال التلقائي في Agensic](#-الإكمال-التلقائي-في-agensic) - [الميزات](#-الميزات-الإكمال-التلقائي) - [الموفرون المدعومون](#-الموفرون-المدعومون) 7. [الأوامر المتاحة](#-الأوامر-المتاحة) 8. [السلامة والخصوصية](#-السلامة--الخصوصية) 9. [منشئ المشروع](#-منشئ-المشروع) 10. [الدعم](#-الدعم) 11. [الترخيص](#-الترخيص) --- ## 💻 <a id="-platform-support"></a>دعم المنصات تم تصميم Agensic للتكامل بعمق مع بيئة الشل الخاصة بك. - macOS (Zsh) — مدعوم بالكامل ✅ - Linux (Bash) — مدعوم بالكامل ✅ --- ## 🚀 <a id="-installation"></a>التثبيت أسرع طريقة هي المثبت المُدار بسطر واحد: ```bash curl -fsSL https://raw.githubusercontent.com/Alex188dot/agensic/main/bootstrap.sh | bash ``` إذا كنت تفضل الاستنساخ يدويًا: ```bash git clone https://github.com/Alex188dot/agensic.git cd agensic bash ./install.sh ``` إذا كان لديك بالفعل `uv`، فسيستخدمه المثبت تلقائيًا للإعداد الأسرع. في التشغيل الأول، سيطلب منك Agensic اختيار موفر LLM المفضل لديك وتكوين مفاتيح API للإكمال التلقائي للأوامر. بدلاً من ذلك، يمكنك تكوين موفر LLM ومفاتيح API بتشغيل: ```bash agensic setup ``` ## ⚡ <a id="-quick-start"></a>البدء السريع بعد الإعداد، **افتح نافذة طرفية جديدة** وسيبدأ Agensic تلقائيًا في تتبع نشاط طرفيتك وتقديم اقتراحات الإكمال التلقائي أثناء الكتابة! ### 🤖 التتبع التلقائي السلس للعامل ابدأ العمل، كما تفعل عادة، على سبيل المثال باستخدام مساعد الترميز المفضل لديك، مثل Claude Code أو Codex CLI، إلخ: ```bash claude ``` أو ```bash codex ``` انظر قسم [العوامل المدعومة](#-العوامل-المدعومة) للحصول على قائمة كاملة بجميع العوامل المدعومة. إذا لم يكن العامل الخاص بك موجودًا في القائمة، يمكنك إضافته بتشغيل <code>agensic --add_agent "executable"</code> ثم استخدامه بشكل طبيعي حتى يتمكن Agensic من تتبعه. بعد الانتهاء، يمكنك استخدام Agensic لفحص تاريخ الجلسة: ```bash agensic sessions ``` أو عرض المصدر الجنائي: ```bash agensic provenance ``` --- ## 🧾 <a id="-agensic-provenance"></a>مصدر Agensic يمنحك Agensic نسخة جنائية لكل أمر. يصنف ما حدث، ويسجل بيانات وصفية غنية، ويكشف عن أثر تدقيق واضح حتى تتمكن من معرفة ما إذا كان الأمر قد كُتب يدويًا، أو قُبل من اقتراح، أو نُفذ مباشرة بواسطة عامل. <p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12868/954db235102e042437af9e18befe1d48176d543e55a5bd8ba5cc3ff7a8396f41.gif" alt="عرض توضيحي لمصدر Agensic" width="75%" /> </p> ### <a id="-features-provenance"></a>✨ الميزات ### 🔍 مستكشف المصدر بملء الشاشة <p> هل تحتاج إلى الإجابة على "ما الذي تم تشغيله بالضبط هنا ومن قام بتشغيله؟" قم بتشغيل <code>agensic provenance</code> لفتح عارض المصدر بملء الشاشة. قم بالتصفية حسب التسمية أو العامل أو الموفر أو الإطار الزمني، وافحص أثر الأوامر الدقيق وقم بتصدير العرض الحالي إلى JSON أو CSV عندما تحتاج إلى سجل دائم لتصحيح الأخطاء أو مراجعة الحوادث أو الامتثال. </p> ### 🛡️ المصدر التشفيري للأوامر والتوقيع <p> توقف عن التخمين فيما إذا كان إنسان أو ذكاء اصطناعي قد كسر البناء. يلتقط Agensic بيانات وصفية غنية لكل أمر ويستخدم التوقيع المحلي Ed25519 لوضع علامة <code>AI_EXECUTED</code> لا يمكن إنكارها على العمليات التي نفذها العامل. تحصل على جدول زمني واضح قابل للتدقيق يفصل بين ضغطات المفاتيح البشرية واقتراحات الذكاء الاصطناعي والتنفيذات الآلية. </p> ### 🏷️ تسميات الإسناد المنظمة <p> لا يقوم Agensic بتقليص تاريخ الطرفية إلى قائمة خام من السلاسل. يتم تصنيف كل أمر متتبع إلى تسمية مصدر، مما يمنحك طريقة متسقة لتصفية العمليات والتحقيق في السلوك وفهم كيف دخل الأمر إلى شلك في المقام الأول. </p> ### <a id="-supported-labels"></a>🔖 التسميات المدعومة يدعم Agensic حاليًا تسميات المصدر التالية: - <code>AI_EXECUTED</code> للأوامر التي نفذها عامل ذكاء اصطناعي مباشرة مع دليل موقع - <code>HUMAN_TYPED</code> للأوامر التي كتبها إنسان يدويًا في الشل - <code>AI_SUGGESTED_HUMAN_RAN</code> للأوامر التي اقترحها استدعاء LLM خارجي للذكاء الاصطناعي ثم نفذها إنسان - <code>AG_SUGGESTED_HUMAN_RAN</code> للأوامر التي اقترحها Agensic ثم نفذها إنسان - <code>INVALID_PROOF</code> للأوامر التي وصلت مع بيانات إثبات فشلت في التحقق - <code>UNKNOWN</code> للأوامر حيث الأدلة المتاحة غير كافية لتعيين تسمية إسناد أقوى --- ## 🕵️♂️ <a id="-agensic-sessions"></a>جلسات Agensic يسجل Agensic جلسات العامل التفاعلية، مما يمنحك دليلًا لا يمكن إنكاره على ما حدث والقدرة على التعامل بأمان مع حالة المستودع، عبر ميزة السفر عبر الزمن. <p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12868/5a2de01b27f96092f2a728dcd93c9368336747306cea978c81b18ad3b6714f5e.gif" alt="عرض توضيحي لإعادة تشغيل Agensic" width="75%" /> </p> ### <a id="-features-sessions"></a>✨ الميزات ### ▶️ جلسات قابلة لإعادة التشغيل <p> هل تحتاج إلى تدقيق جلسة الليلة الماضية، لتفهم ما حدث؟ قم بتشغيل <code>agensic sessions</code> واختر الجلسة التي تريد إعادة تشغيلها. تتيح لك واجهة TUI السريعة بملء الشاشة تصفح الجداول الزمنية فورًا، وفحص الحمولات، وإعادة تشغيل الجلسة. عندما تحتاج إلى مشاركة دليل لمراجعة حادثة، قم بتصدير مجموعة البيانات الدقيقة إلى JSON أو CSV بضغطة مفتاح واحدة. </p> ### ⏪ السفر عبر الزمن <p> هل تساءلت يومًا "كيف كان شكل مستودعي بالضبط قبل أن يقوم العامل بهذا الالتزام المدمر؟" يتيح لك السفر عبر الزمن إرجاع مستودعك إلى حالة Git الدقيقة التي تم التقاطها عند نقطة تفتيش جلسة معينة. يستعيد Agensic بأمان الملفات غير المتتبعة والمعدلة إلى فرع جديد تمامًا، مما يضمن عدم تدمير شجرة العمل الحية الخاصة بك عن طريق الخطأ أثناء التحقيق. </p> ### 🗄️ حالة مرنة محلية أولاً <p> تبقى بياناتك ملكك. يستخدم Agensic خلفية SQLite قوية مع سجل أحداث للإلحاق فقط ولقطات آلية. هذا يعني أن تاريخك الجنائي ينجو من تعطل الطرفية غير المتوقع، وإعادة تشغيل النظام، والاستخدام المحلي الطويل دون تلف. </p> ### <a id="-supported-agents"></a>🤖 العوامل المدعومة يوفر Agensic دعمًا لمجموعة من العوامل المضمنة المهيأة مسبقًا والتي يمكن تتبعها: - Claude Code - Codex CLI - Gemini CLI - OpenClaw - OpenCode - Kimi Code - Mini Agent - Qwen Code - GitHub Copilot CLI - Kiro CLI - Cline CLI - Cursor CLI - Nanoclaw - Droid - Hermes Agent - Ollama - Mistral Vibe - Aider - Pi.dev - Kilo Code - Continue CLI العوامل المخصصة: أدخل أي ملف تنفيذي لعامل في إعداد agensic وسيعمل فورًا دون أي تكوين --- ## ⚡ <a id="-agensic-autocomplete"></a>الإكمال التلقائي في Agensic يعيد Agensic تصور اقتراحات الطرفية. سياقية، ودلالية، وسريعة دائمًا بأسلوب IDE، وإكمال تلقائي مُرضٍ باستخدام Tab. <p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12868/f710d6a7c01b14691b1d825894e1640c2a92ff1642178a5aed2b3d7d0ac241e3.gif" alt="عرض توضيحي للإكمال التلقائي في Agensic" width="50%" /> </p> ### <a id="-features-autocomplete"></a>✨ الميزات ### 🚀 اقتراحات تاريخ محلية فائقة السرعة <p> قل وداعًا لتأخر الإدخال. أثناء الكتابة، يستعلم Agensis عن مخزن لتاريخ الأوامر الفعلي الخاص بك. تظهر الاقتراحات فورًا كنص شبح، يمكنك قبوله بسهولة باستخدام <code>Tab</code>. نظرًا لأنه يتعلم من أنماطك ويعتمد على ما تفعله بالفعل، فإن الاقتراحات دقيقة للغاية ومراعية للمستودع. </p> ### 🧠 بحث دلالي واسترداد الأخطاء المطبعية <p> البشر يخطئون، Agensic يصلح أخطاءهم. إذا كتبت <code>dokcer</code>، يقترح Agensic فورًا <code>هل تقصد: docker</code>. لا تستطيع تذكر الصيغة الدقيقة؟ إعادة الترتيب الدلالي تنقذ نيتك، وتجد الأمر الصحيح حتى لو لم تتطابق البادئة تمامًا: إذا كتبت <code>docker records</code> ستحصل على <code>هل تقصد: docker logs</code> (بشرط أن تكون قد نفذت <code>docker logs</code> من قبل) </p> ### 💡 احتياطي الذكاء الاصطناعي عند الطلب <p> الذكاء الاصطناعي هو احتياطي قوي، وليس ضريبة على كل ضغطة مفتاح. يفرض Agensic ميزانيات LLM لكل سطر لمنع إغراق الموجهات. عندما لا يكفي التاريخ المحلي، سيتم تشغيل الاحتياطي التلقائي لـ LLM. بدلاً من ذلك، يمكنك دائمًا الضغط على <code>Ctrl+Space</code> لجلب اقتراح ذكي يدويًا من LLM المحلي أو المستضاف المفضل لديك. </p> ### 💬 أوضاع الأوامر باللغة الطبيعية <p> انسَ الصيغ الدقيقة، فقط صف ما تريده. اكتب شيئًا مثل: <code># كيف يمكنني العثور على جميع الملفات الأكبر من 10 ميجابايت في هذا المجلد؟</code>. يولد Agensic 3 أوامر شل جاهزة للنسخ ويدرج الخيار الأكثر احتمالاً مباشرة في السطر التالي. هل تحتاج إلى إرشاد بدلاً من الأوامر؟ استخدم وضع المساعد للحصول على إجابات خطوة بخطوة مباشرة في طرفيتك: <code>## كيف يمكنني تثبيت Node على macOS؟</code>. هل تريد فهم أمر قبل تنفيذه؟ استخدم: <code>agensic --explain "أمرك هنا"</code> </p> ### 🛡️ الحفاظ الأصلي على Tab ومنع المخاطر <p> يحترم Agensic طرفيتك. يترك <code>Tab</code> وشأنه عندما تكمل مسارات الملفات أو البرامج النصية، بحيث يظل الإكمال الأصلي للشل هو الفائز حيث يكون أفضل. الأهم من ذلك، أن الأوامر التدميرية (مثل <code>rm -rf</code> أو <code>mkfs</code> أو <code>dd</code>) محظورة تمامًا من مجموعات الاقتراحات حتى لا تنفذ كارثة عن طريق الخطأ. </p> ### <a id="-supported-providers"></a>🌐 الموفرون المدعومون يتناسب Agensic مع بنيتك، سواء كنت تشغل النماذج محليًا أو تستخدم نقاط نهاية مستضافة. - **محلي:** Ollama، LM Studio - **مستضاف:** OpenAI، Anthropic، Gemini، Azure، DeepSeek، Groq، Mistral، Qwen (DashScope)، MiniMax، Moonshot، OpenRouter، Xiaomi MiMo، Z.AI، AWS SageMaker - **مخصص:** أي نقطة نهاية متوافقة مع OpenAI - **التاريخ فقط:** يعمل بالكامل دون اتصال بدون استدعاءات ذكاء اصطناعي، باستخدام تاريخ الأوامر المحلي فقط ## 🧰 <a id="-available-commands"></a>الأوامر المتاحة يسرد الجدول أدناه كل أمر CLI متاح حاليًا في Agensic. | الأمر | الوظيفة | | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | <code>agensic --help</code> | عرض المساعدة الرئيسية لـ CLI وجميع الأوامر القياسية الموجهة للمستخدم | | <code>agensic --version</code> | طباعة إصدار Agensic المثبت والخروج | | <code>agensic update</code> | تنزيل وتثبيت أحدث إصدار من Agensic على GitHub | | <code>agensic setup</code> | فتح تدفق الإعداد التفاعلي لجلسات Agensic والإكمال التلقائي | | <code>agensic enable-startup</code> | تكوين Agensic ليبدأ تلقائيًا عند تسجيل الدخول أو التمهيد | | <code>agensic first-run</code> | تشغيل تدفق الإعداد للتثبيت الأول | | <code>agensic start</code> | بدء الخلفية الخلفية لـ Agensic يدويًا | | <code>agensic stop</code> | إيقاف خلفية Agensic | | <code>agensic logs</code> | تتبع مخرجات سجلات الخلفية في الوقت الفعلي | | <code>agensic test</code> | إرسال طلب اختبار للإكمال التلقائي إلى الخلفية للتحقق من الاتصال | | <code>agensic provenance</code> | فتح عرض تاريخ مصدر الأوامر. يدعم المرشحات مثل <code>--limit</code> و <code>--label</code> و <code>--contains</code> | | <code>agensic sessions</code> | فتح متصفح الجلسات المتتبعة. استخدم <code>--text</code> للإخراج النصي العادي | ## 🔒 <a id="-safety--privacy"></a>السلامة والخصوصية يعمل Agensic على مبدأ أقل الامتيازات وأقصى خصوصية: - **المصادقة المحلية:** كل مسار API على المضيف المحلي مصادق عليه بشكل صارم مع تدوير تلقائي للرمز المميز - **تنقيح الأسرار:** يتم تجريد وتنقيح القيم عالية الإنتروبيا وبيانات اعتماد URL وتنسيقات الأسرار المعروفة (مثل مفاتيح AWS أو JWTs) **قبل** أن تغادر أي بيانات جهازك لاستدعاء LLM - **حواجز الأوامر:** الأوامر التدميرية محظورة بشدة من كل من محرك الاقتراحات وحلقة التغذية الراجعة - **تحديد المعدل:** استدعاءات LLM الصادرة محدودة بفترات زمنية وميزانيات صارمة لمنع إساءة استخدام API --- ## <a id="-project-creator"></a>👤 منشئ المشروع Alessio Leodori ## <a id="-support"></a>🤝 الدعم تجد Agensic مفيدًا؟ قم بوضع نجمة ⭐️ على المستودع وأخبر صديقًا! سيساعدنا هذا على النمو 🌱 ## 📄 <a id="-license"></a>الترخيص Agensic مفتوح المصدر ومرخص بموجب **رخصة Apache-2.0**.
