الأسئلة الشائعة

ما هو AgentGIF؟

AgentGIF هو منصة استضافة GIF للمطورين بـبنية ثنائية الطبقة. كل تسجيل طرفي توضيحي مقترن بملف cast قابل للقراءة آلياً من asciinema v2، حتى يتمكن البشر ووكلاء الذكاء الاصطناعي من فهم المحتوى.

يرى الإنسان تسجيل طرفية متحرك. يرى وكيل الذكاء الاصطناعي بيانات منظمة: الأوامر والمخرجات والطوابع الزمنية والبيانات الوصفية.

هل AgentGIF مجاني؟

نعم. رفع التسجيلات واستضافتها وتضمينها مجاني تماماً. REST API مجاني لعمليات القراءة بدون مصادقة. تتطلب عمليات الكتابة (الرفع والتعديل والحذف) مفتاح API مجانياً من صفحة الإعدادات.

ما هو ملف cast؟

ملف cast هو تسجيل asciinema v2. إنه صيغة نصية حيث السطر الأول ترويسة JSON مع بيانات وصفية للطرفية، تليها مجموعات أحداث مختومة زمنياً:

{"version": 2, "width": 120, "height": 40}
[0.5, "o", "$ docker compose up -d\r\n"]
[1.2, "o", "Creating network...\r\n"]
[2.8, "o", "Container app-1  Started\r\n"]

كل مجموعة هي [timestamp_seconds, event_type, data]. يُمكّن هذا وكلاء الذكاء الاصطناعي من استخراج الأوامر والمخرجات والتوقيت دون OCR.

كيف أرفع تسجيلاً؟

خياران:

• الويب: اسحب وأفلت على /upload/ (يتطلب تسجيل الدخول بـ GitHub)
• CLI: agentgif upload demo.gif --title "My Demo" --tags cli,unix

CLI متاح لـ 5 لغات: Python و Node.js و Go و Rust و Ruby. أضف راية --cast demo.cast لإرفاق الطبقة القابلة للقراءة آلياً.

كيف أضمّن تسجيلاً في README الخاص بي؟

النمط الموصى به لملفات GitHub README:

<p align="center">
  <a href="https://agentgif.com/ID">
    <img src="https://media.agentgif.com/ID.gif" alt="demo" width="800">
  </a>
</p>

استبدل ID بمعرف التسجيل المكون من 8 أحرف. راجع دليل التضمين الكامل لجميع الطرق الـ 6.

ما هي نقطة نهاية .md؟

أضف .md إلى أي رابط AgentGIF للحصول على استجابة text/markdown محسّنة للنماذج اللغوية الكبيرة. كل صفحة تدعم هذا — تفاصيل التسجيلات وقوائم الوسوم وصفحات الأدوات والمجموعات والأدلة ونتائج البحث.

curl https://agentgif.com/tools/git/.md
curl https://agentgif.com/explore/tags/docker/.md

هل أحتاج إلى مفتاح API؟

احصل على مفتاح API مجاني من /settings/ بعد تسجيل الدخول بـ GitHub.

ما ثيمات الطرفية المتاحة؟

يدعم AgentGIF جميع الـ 44 ثيم طرفية من VHS. خيارات شائعة:

تصفح جميع الثيمات مع معاينات مباشرة: معرض الثيمات.

ما هي خدمة الشارات؟

يوفر AgentGIF شارات حزم بثيم الطرفية كبديل عن shields.io. تُعرض بألوان ثيم الطرفية الذي اخترته.

![PyPI](https://agentgif.com/badge/pypi/requests/version.svg?theme=dracula)
![npm](https://agentgif.com/badge/npm/express/version.svg?theme=nord)
![Stars](https://agentgif.com/badge/github/torvalds/linux/stars.svg)

المزودون المدعومون: PyPI، npm، crates.io، GitHub. خصّص بمعاملي ?theme= و?style=. انظر ملعب الشارات.

كيف تقرأ وكلاء الذكاء الاصطناعي التسجيلات؟

يمكن لوكلاء الذكاء الاصطناعي الوصول إلى محتوى التسجيلات عبر قنوات متعددة:

• ملفات Cast: GET /api/v1/gifs/{id}/cast/ — تسجيل asciinema v2 كامل مع طوابع زمنية
• النصوص: GET /api/v1/gifs/{id}/transcript/ — نص عادي نظيف، رموز ANSI محذوفة
• نقاط نهاية .md: أضف .md إلى أي رابط صفحة للحصول على مخرجات Markdown
• JSON API: /api/v1/search/?q=docker — بحث نصي كامل مع نتائج منظمة
• llms.txt: /llms.txt — ملخص على مستوى الموقع لزواحف الذكاء الاصطناعي

انظر توثيق تكامل وكيل الذكاء الاصطناعي الكامل.

ما صيغ الملفات المدعومة؟

للحصول على أفضل النتائج، احتفظ بالتسجيلات أقل من 5 MB. انظر دليل التسجيل لنصائح التحسين.

كيف أسجّل تسجيلاً طرفياً بصيغة GIF؟

نوصي بـ VHS من Charm للتسجيلات المبرمجة القابلة للتكرار:

# Install VHS
brew install vhs

# Create a tape file (demo.tape)
Output demo.gif
Set Theme "Catppuccin Mocha"
Type "echo 'Hello, world!'"
Enter
Sleep 2s

# Record
vhs demo.tape

تعليمات كاملة خطوة بخطوة: كيفية تسجيل GIF طرفي.