حول AgentGIF
استضافة GIF للمطورين بنية ثنائية الطبقة: GIF للبشر، Cast للوكلاء.
ما هو AgentGIF؟
AgentGIF هو منصة استضافة مصممة خصيصاً لتسجيلات الطرفية التوضيحية بصيغة GIF. كل GIF يُرفع على AgentGIF يحتوي على طبقتين:
- الطبقة المرئية — صورة GIF متحركة تُشغَّل مباشرةً في ملفات README على GitHub ومواقع التوثيق والمدونات. لا يلزم مشغّل JavaScript.
- الطبقة الآلية — ملف cast من asciinema v2 مقترن بنص عادي، حتى تتمكن وكلاء الذكاء الاصطناعي من قراءة الأوامر وفهم المخرجات والإشارة إلى خطوات محددة.
يعني هذا النهج ثنائي الطبقة أن رابطاً واحداً يخدم كلا الجمهورين: يرى الإنسان عرضاً توضيحياً متحركاً للطرفية، بينما يحصل وكيل الذكاء الاصطناعي على بيانات منظمة يمكنه تحليلها والاستدلال منها.
لماذا AgentGIF؟
تسجيلات الطرفية بصيغة GIF منتشرة في كل مكان في توثيق المصدر المفتوح. لكنها تعاني من مشكلتين أساسيتين:
- صور GIF معتمة أمام الذكاء الاصطناعي — عندما يصادف وكيل الذكاء الاصطناعي صورة GIF في ملف README، فإنه يرى بيانات بكسل ثنائية. لا يمكنه استخراج الأوامر أو قراءة المخرجات أو شرح الخطوات. يحل AgentGIF هذه المشكلة بإرفاق ملفات cast وسيناريوهات نصية قابلة للقراءة آلياً مع كل GIF.
- لا توجد استضافة مخصصة — يرفع المطورون تسجيلات الطرفية بصيغة GIF إلى مضيفي الصور العامة (Imgur وأصول GitHub) التي تحذف البيانات الوصفية وتضغط بشكل مفرط ولا توفر بحثاً أو تنظيماً. يوفر AgentGIF استضافة مخصصة مع وسوم ومجموعات وثيمات طرفية وبحث نصي كامل و REST API.
ميزات المنصة
| الميزة | التفاصيل |
|---|---|
| مكتبة GIF | 768+ تسجيل طرفية عامة عبر 911+ وسم |
| ثيمات الطرفية | 44 ثيم VHS (Catppuccin، Dracula، Tokyo Night، Nord، Solarized، وغيرها) |
| صيغ التضمين | Markdown، HTML، iframe، Script widget، oEmbed، SVG Badge |
| أدوات CLI | Python، Node.js، Go، Rust، Ruby — الرفع والتسجيل والبحث من الطرفية |
| REST API | 30+ نقطة نهاية، قراءة مجانية بدون مصادقة، مواصفة OpenAPI 3.1 |
| البحث النصي الكامل | البحث بالعنوان والأمر والوسوم ومحتوى النص |
| المجموعات | Curated groups of related GIFs (e.g., "Unix Essentials", "Git Workflows") |
| خدمة الشارات | شارات حزم بثيم الطرفية لـ PyPI و npm و crates.io و GitHub |
| مولّد الـ Tape بالذكاء الاصطناعي | توليد ملفات VHS tape من أوصاف باللغة الطبيعية |
| نقاط نهاية .md | أضف .md إلى أي رابط للحصول على مخرجات Markdown محسّنة للنماذج اللغوية الكبيرة |
| التدويل | 15 لغة مع بيانات وصفية مترجمة آلياً |
مصمم لوكلاء الذكاء الاصطناعي
صُمِّم AgentGIF من الأساس لاستهلاك وكلاء الذكاء الاصطناعي. كل صفحة في الموقع تحتوي على نقطة نهاية .md تعيد Markdown نظيفاً. توفر المنصة قنوات اكتشاف متعددة:
| القناة | الرابط | الغرض |
|---|---|---|
| llms.txt | /llms.txt | ملخص بنية الموقع لزواحف الذكاء الاصطناعي |
| OpenAPI | /api/openapi.json | مخطط API الكامل (OpenAPI 3.1) |
| RSS/Atom | /feed/ | أحدث التسجيلات لقارئي التغذيات |
| خريطة الموقع | /sitemap.xml | جميع الروابط المفهرسة |
| API البحث | /api/v1/search/?q=... | بحث نصي كامل برمجي |
النظام البيئي مفتوح المصدر
يوفر AgentGIF أدوات CLI وتكاملات عبر 5 سجلات حزم:
| المنصة | الحزمة | التثبيت |
|---|---|---|
| PyPI | agentgif | pip install agentgif |
| npm | @agentgif/cli | npm install -g @agentgif/cli |
| Go | github.com/agentgif/cli | go install github.com/agentgif/cli@latest |
| Crates.io | agentgif | cargo install agentgif |
| RubyGems | agentgif | gem install agentgif |
التقنية
| الطبقة | التقنيات المستخدمة |
|---|---|
| الواجهة الخلفية | Django 6.0, Python 3.14, PostgreSQL |
| الواجهة الأمامية | Tailwind CSS, Alpine.js, xterm.js (إعادة تشغيل الطرفية) |
| CDN | Cloudflare R2 (حاوية مزدوجة: ثابت + مرفوعات) |
| البحث | بحث نصي كامل بـ PostgreSQL مع ترتيب موزون |
| التسجيل | VHS من Charm (44 ثيم طرفية) |
| صيغة الـ Cast | asciinema v2 (ترويسة JSON + أحداث مختومة زمنياً) |
التواصل
للمشكلات الأمنية، راجع security.txt. لأسئلة API، راجع مرجع API. لكل شيء آخر، تواصل عبر [email protected].