video-to-blender: حوّل مقاطع الفيديو المرجعية أو الصور أو الأفكار إلى أنظمة عُقد إجرائية قابلة للتحرير في Blender

لمن هذا

هذه المهارة (Skill) مناسبة للمستخدمين الذين يرغبون في إعادة إنتاج مقطع فيديو مرجعي أو صورة أو فكرة داخل Blender باستخدام العُقد الإجرائية (Geometry Nodes وShader Nodes والمُركِّب/Compositor). تأتي معها مكتبة مُختبَرة من مجموعات عُقد NK وباني Python باسم nodekit، تستدعيه وكلاء البرمجة (coding agents) لمساعدتك في البحث عن مجموعات العُقد وبناءها والتحقق من النتائج.

يجب استيفاء المتطلبات المسبقة:

• يلزم Blender 5.2 أو أحدث مع ضمان توفره: عبر الأمر blender في PATH، أو متغير البيئة $BLENDER، أو تطبيق macOS.
• يلزم وجود وكيل برمجة مدعوم لتشغيل سير العمل.
• الحالات غير المناسبة: لم توضح الأدلة ما إذا كان هناك استخدام دون اتصال (offline) لا يعتمد على Blender، ولم توضح صيغ الفيديو المدخلة المدعومة، ولم توضح نطاق اللغات المدعومة للمواد؛ وكلها أمور مجهولة فلا تفترضها من تلقاء نفسك. إذا كانت بيئتك لا توفر Blender 5.2+، فلا يمكن تأكيد إمكانية الاستخدام ضمن حدود الأدلة.

أول محاولة في 3 دقائق

المسار الرئيسي الموصى به: التثبيت عبر سوق الإضافات الرسمي في Claude Code.

1. المتطلبات: تثبيت Claude Code مسبقًا، وتوفر Blender 5.2+ (الأمر blender في PATH، أو ضبط $BLENDER، أو تطبيق macOS).
2. مكان التثبيت والأمر (بالنص الرسمي):

claude plugin marketplace add gokayfem/video-to-blender

ثم اتبع الإجراء الرسمي لتثبيت الإضافة.

1. أطلق مهمة منخفضة المخاطر: اطلب من الوكيل تحويل أحد مقاطع الفيديو المرجعية أو صورة إلى نظام عُقد إجرائي قابل للتحرير في Blender. يُنصح في المحاولة الأولى بالبدء ببناء مجموعة عُقد واحدة لتسهيل ملاحظة النتائج.

2. في سير العمل الرسمي الأساسي، يستخدم الوكيل nodes_tools.py search للبحث عن مجموعات العُقد في المكتبة، ويستخدم try لبناء مجموعة على مدخلات اختبارية، وطباعة تحذيرات العُقد ونتائج lint، وعرض إطار ثابت (still frame)؛ ثم يعيد validate.py فتح ملف .blend المحفوظ للتحقق من التحذيرات والأعداد وأوقات التقييم وفجوات الكاميرا.

إشارات النجاح: أن يُخرج try تحذيرات العُقد ونتائج lint ويعرض إطارًا ثابتًا؛ وأن يُعيد validate.py فتح ملف .blend ويُبلغ عن نتائج الفحص (التحذيرات، الأعداد، أوقات التقييم، فجوات الكاميرا). هذه مخرجات ملاحظة موصوفة صراحة في الأدلة.

ملاحظة: تذكر الوثائق الرسمية أيضًا طرق تثبيت أخرى — للوكلاء مثل Codex وCursor وGemini CLI وCopilot يمكن استخدام skills CLI (npx skills add gokayfem/video-to-blender)، ويمكن في Claude Code النسخ يدويًا (cp -R skills/procedural-blender-nodes ~/.claude/skills/). هذه طرق بديلة ثانوية وليست المسار الرئيسي الموصى به هنا. بناء العُقد وحفظ ملف .blend إجراء يكتب ملفات، لذا قبل المحاولة الأولى تأكد من موافقتك على إنشاء ملفات .blend ومخرجات عرض داخل Blender؛ وبخلاف ذلك، لم توضح الأدلة ما إذا كانت المهارة تنفّذ أوامر أخرى أو تصل إلى الشبكة، وهذا مجهول.

حالات الاستخدام

الحالة الأولى: توليد نظام عُقد من مقطع فيديو مرجعي. السيناريو: لديك مقطع فيديو تريد إعادة إنتاج مؤثراته البصرية. ابدأ مهمة للوكيل: "باستخدام هذا الفيديو المرجعي، ابنِ نظام عُقد إجرائيًا قابلًا للتحرير في Blender". سيتّبع الوكيل سير العمل الرسمي: البحث في مكتبة مجموعات عُقد NK باستخدام nodes_tools.py search عن مجموعة مناسبة، ثم البناء وعرض إطار ثابت باستخدام try، ثم إعادة فحص ملف .blend باستخدام validate.py للتحذيرات والأعداد وأوقات التقييم وفجوات الكاميرا. النتيجة المتوقعة: نظام عُقد قابل للتحرير (Geometry/Shader/Compositor) مع تقرير تحقق. أما صيغ الفيديو المدعومة تحديدًا فلم توضحها الأدلة، فاعتمد على ملاحظات الوكيل الفعلية.

الحالة الثانية: بناء مجموعة عُقد واحدة من صورة أو فكرة والتحقق منها. السيناريو: تريد فقط اختبار مادة أو مؤثر هندسي معيّن. اطلب من الوكيل "بناء مجموعة عُقد على مدخلات اختبارية بناءً على هذه الصورة (أو هذه الفكرة)". سيستدعي الوكيل try لبناء المجموعة على مدخلات اختبارية، وطباعة تحذيرات العُقد ونتائج lint، وعرض إطار ثابت، ثم يستخدم validate.py لإعادة فتح ملف .blend المحفوظ وفحصه. النتيجة المتوقعة: قائمة تحذيرات المجموعة ونتائج lint وإطار ثابت مُصيَّر؛ وإذا تضمن تقرير التحقق تحذيرات، يمكنك بناءً عليها أن تطلب من الوكيل إجراء تعديلات وإعادة المحاولة.

حدود الاستخدام

• الملفات والأثر الجانبي: يبني سير العمل العُقد ويحفظ ملف .blend، ويعيد validate.py فتح ذلك الملف؛ وعرض الإطار الثابت ينتج مخرجات. نقطة التأكيد الصريحة قبل البناء هي اختيار المادة المرجعية (فيديو/صورة/فكرة) والهدف المطلوب بناؤه. تُنتج المهارة نظام عُقد ومعلومات تحقق، أما ما إذا كانت تعدّل ملفاتك الأخرى مباشرة فلم توضح الأدلة ذلك.
• الأوامر والشبكة: استدعاءات السكربتات المؤكدة في الأدلة هي nodes_tools.py search وtry وvalidate.py؛ أما تنفيذ أوامر أخرى أو الوصول إلى الشبكة فلم يُذكر، وهو مجهول.
• بيئة التشغيل والعملاء: يجب توفير Blender 5.2+ (الأمر blender في PATH، أو $BLENDER، أو تطبيق macOS). يُثبَّت Claude Code عبر سوق الإضافات، ويُثبَّت وكلاء مثل Codex وCursor وGemini CLI وCopilot عبر skills CLI؛ ولم توضح الأدلة ما إذا كانت المهارة تعمل فقط مع العملاء المذكورين، وإتاحتها لوكلاء آخرين مجهولة.
• القيود الرسمية والمعلومات غير المؤكدة: لم يُعثر على بيانات حول صيغ المدخلات المدعومة، أو نطاق اللغات، أو طريقة الاستخدام دون اتصال، أو العمليات خارج try/validate.py؛ لا تستنتج هذه الأمور من عندك.