عن المشروع

fireworks-tech-graph هي مهارة وكيل تعمل دون تغيير في Codex وClaude Code. وهي تحوّل الأوصاف باللغة الطبيعية (الإنجليزية أو الصينية) إلى مخططات SVG مُتحقق من هندستها، وصادرات PNG عالية الدقة، وحركة دلالية SVG-to-GIF مُتحقق منها، وملف HTML تفاعلي واحد يعمل دون اتصال. القدرات الأساسية - 12 نمطًا بصريًا: 11 ملف تعريف مدعومًا بمولّد بالإضافة إلى نمط واحد من تأليف الذكاء الاصطناعي (Dark Luxury). وتضيف أربعة أنماط هندسية أولًا عقودًا قابلة للتنفيذ لمراجعات C4 وعمليات النشر السحابي وتدفقات الأحداث وتحقيقات الموثوقية. - 14 نوعًا من المخططات مع دعم UML كامل: Class وComponent وDeployment وPackage وComposite Structure وObject وUse Case وActivity وState Machine وSequence وCommunication وTiming وInteraction Overview وER Diagram، إلى جانب أنماط مجال AI/Agent مثل RAG وAgentic Search وMem0 وMulti-Agent وTool Call. - مفردات دلالية: ترمز الأشكال إلى الأدوار (LLM كمستطيل مزدوج الحدود، وAgent كمسدس، وVector Store كأسطوانة محيطة بحلقة) وترمز أنماط لون/شرطة الأسهم إلى المعنى (كتابة، قراءة، غير متزامن، حلقة). - التوجيه والتخطيط: مسارات متعامدة حتمية بنقاط مسار دقيقة، ومنافذ مميزة، وإعادة تحديد موقع تلقائية للوسيلة الإيضاحية، وإبقاء التسميات داخل اللوحة، وقفزات جسر مُتحقق منها للتقاطعات التي لا يمكن تجنبها. - التحقق: يقوم IR مخطط ذي إصدار بتطبيع JSON القديم إلى schema v1 ويفشل عند وجود معرفات مكررة أو مراجع معلقة أو نقاط مسار مشوهة أو هندسة غير منتهية؛ وتغطي فحوصات SVG المنظمة سلامة XML والعلامات بالإضافة إلى شروط العقد والمناطق المحجوزة والتسميات واللوحة وتداخل الحواف وتقاطع الحواف. - المخرجات: SVG للتحرير وPNG بدقة 1920px للتضمين؛ SVG مضمّن خالص دون جلب خطوط خارجية، مخصص للعرض في cairosvg وrsvg-convert وChrome بلا واجهة. ويدعم CLI موحّد أوامر render وvalidate وcheck وexport-html وanimate، ويضيف تصدير HTML التحريك والتكبير/التصغير وسمات فاتحة/داكنة ونسخ المصدر وتنزيلات SVG/PNG/JPEG/WebP بمضاعفات 1x-4x. - الحركة: يقبل أمر animate ملف SVG دلاليًا مُولّدًا يحمل أحد اثني عشر عقد حركة معتمدًا ويُخرج GIF بالإضافة إلى تقرير تحقق motion.json. الافتراضي الموثق هو 960px و5.75 ثانية و20fps و115 عينة إطار، مع رسم الموصلات بالترتيب الدلالي؛ كما تُدعم جداول زمنية أقصر من 75 إطارًا و55 إطارًا. - بوابة المراجعة البصرية: تُفحص ملفات PNG المُصدَّرة بحثًا عن القص والتداخل وموضع التسميات وانحدارات التوجيه، مع تمريرتين تصحيحيتين مركّزتين كحد أقصى افتراضيًا؛ وإذا تعذّر على بيئة التشغيل قراءة الصور، تُبلغ المهارة عن visual_review كمتخطّى بدلًا من ادعاء التحقق. - أيقونات المنتجات: أكثر من 40 منتجًا بألوان العلامات التجارية، بالإضافة إلى تجميع تلقائي للمسارات السباحية للبنى المعقدة. التثبيت والمتطلبات يتم التثبيت عبر skills CLI باستخدام المسار المتداخل skills/fireworks-tech-graph، أو عبر استنساخ المستودع إلى ~/.agents/skills (Codex) أو ~/.claude/skills (Claude Code)؛ كما تُوثَّق نسخة مشتركة مع روابط رمزية. يلزم Python 3.9+. وتحتاج نصوص SVG/PNG إلى cairosvg (موصى به) أو rsvg-convert؛ ويحتاج تصدير GIF الاختياري إلى FFmpeg/FFprobe وChrome/Chromium وpuppeteer أو puppeteer-core، مع Node.js 22.12+ لمسار Puppeteer. يضع README المشروع في مواجهة Mermaid وdraw.io، مشيرًا إلى أنه يقبل إدخال اللغة الطبيعية، ويتضمن أنماط مجال AI/Agent، ويشحن أنماطًا مدمجة، ويصدّر PNG عالي الدقة تلقائيًا ولا يحتاج إلى أداة عبر الإنترنت. وهو مُصدَر بموجب رخصة MIT.