Claude في Houdini على Windows: خللان في لوحة الوكيل وجيود من 31 عقدة

الوكيل الذي لا يملك وصولًا إلى البرنامج قليل الفائدة. لذلك وصل كاتب Habr، الذي يختبر وكلاء الذكاء الاصطناعي في Houdini بانتظام، برنامج Claude مباشرةً بنافذة البرنامج. لم تعمل هذه الحزمة على Windows مباشرةً بعد التثبيت، واضطر المؤلف إلى معالجة مشكلات الرمز المميز (token) ومتغيرات البيئة وانهيار خادم MCP. غير أن النتيجة النهائية لافتة: جيود إجرائي من 31 عقدة خلال نحو 22 دقيقة من العمل، والفيديو مسرَّع نحو 24 ضعفًا تقريبًا.

اللوحة وMCP وتسجيل الدخول بالاشتراك

اختار المؤلف لوحة houdini-agent-panel (بترخيص MIT)، أي نافذة دردشة مع الوكيل داخل Houdini. والسبب عملي: فهي تسهّل تسجيل الفيديو. ويعمل في الخلفية خادم MCP باسم fxhoudinimcp.

يتم التثبيت على النحو التالي:

• تنفيذ الأمر `uvx --from houdini-agent-panel python -m houdini_agent_panel install`؛ • إعادة تشغيل Houdini، والضغط على «+» في علامات التبويب، واختيار New Pane Tab Type ← Agent (في أسفل القائمة تمامًا)؛ • الضغط على Install مقابل Claude Agent في إعدادات اللوحة؛ • لتسجيل الدخول باشتراك Claude Pro/Max دون مفتاح API، تنفيذ `claude setup-token`، ثم `setx CLAUDE_CODE_OAUTH_TOKEN "sk-ant-oat01-…"`.

هذه نقطة مهمة من الناحية الاقتصادية. فالعمل يجري ضمن اشتراك ثابت، لا وفق تسعيرة الرموز (tokens). وفي الجلسات الطويلة التي تضم عشرات الخطوات ولقطات شاشة لنافذة العرض (viewport)، تكون التكلفة أكثر قابلية للتوقع بوضوح.

ما الذي تعطّل على Windows

أول ما واجهه المؤلف كان رسالة «انتهت صلاحية الرمز». ثم ساءت الأمور: فعلى حد قول المؤلف، لا يكاد أحد يصحّح أخطاء مثل هذه المنتجات. عثر Claude على الأسباب في الشيفرة، وتحقق منها المؤلف وأرسل الإصلاحات.

الأعراض والحلول:

• الخطأ 401 OAuth access token has expired مباشرةً بعد setx. يأخذ الوكيل بيانات الدخول القديمة من ~/.claude/.credentials.json. للتحقق من الرمز الجديد: `claude -p "reply with: ok"`. • Houdini لا يرى المتغير بعد setx. مستكشف الملفات (Explorer) ونوافذ PowerShell القديمة تعمل ببيئة قديمة. يجب إعادة تشغيل Explorer أو تسجيل الخروج من Windows. • الخطأ 401 يظهر مع ذلك. تأخذ اللوحة المتغيرات من login shell (/bin/sh)، وهو غير موجود على Windows. الإصلاح: MAY4VFX/houdini-agent-panel#46، إذ تقرأ اللوحة HKCU\Environment. • الوكيل يرد، لكن أدوات Houdini غير متاحة له. ينهار خادم MCP مع الخطأ No module named 'pywintypes'، لأن ملف .pth الخاص بـ pywin32 لا يُقرأ من PYTHONPATH. الإصلاح: MAY4VFX/houdini-agent-panel#47. وللحل اليدوي يجب إضافة deps\py3.13\win32 وwin32\lib إلى HAP_MCP_PATH في الملف Documents\houdini22.0\packages\houdini_agent_panel.json.

وفي الربيع واجه المؤلف مشكلات مشابهة مع houdini-mcp وCodex على Windows. وقد قُبلت تلك الإصلاحات في المشروع بالفعل: oculairmedia/houdini-mcp#8.

الجيود كاختبار

للاختبار، اقترح Claude بنفسه كويكبًا، لكن النتيجة جاءت «ليست كما ينبغي»، فانتقلوا إلى الجيود. المهمة: «جوزة» حجرية مشقوقة إلى نصفين، وفي داخلها تجمّع من بلورات الجمشت. اشترط الطلب (prompt) أن يعمل الوكيل بحيث تبقى الشبكة مرئية دائمًا، وأن ينشئ العقد واحدة تلو الأخرى، ويمنحها أسماء واضحة، ويحيط المراحل بـ network box، ويلوّنها، ويتحقق من عمله بلقطة شاشة.

كانت المراحل كما يلي:

• القشرة: كرة ← ضوضاء (noise) ← VDB ← قشرة مجوفة ← مضلعات؛ • الشق: قطع بمستوى غير منتظم بحافة ممزقة؛ • البلورات: نقاط في الداخل، واتجاه وفق الاتجاه العمودي (normal)، وبلورات قصيرة عند الجدران وطويلة نحو المركز، وبلورة سداسية بقمة حادة، وcopy to points؛ • اللون: حجر رمادي مائل إلى البني، وخطوط فاتحة من العقيق على مقطع الشق، وبلورات تتدرج من البنفسجي الداكن إلى أطراف فاتحة؛ • الخاتمة: كل شيء في OUT، ونافذة العرض (viewport) على زاوية المقطع.

والجيود نفسه، بحسب اعتراف المؤلف، لا يثير مشاعر خاصة. أما ما فاجأه فهو أمر آخر: لاحظ Claude أخطاءه بنفسه وصحّحها، بينما يضطر المؤلف عادةً في هذه المرحلة إلى الاستعانة بـ Codex، لأن قدرة Claude البصرية متواضعة.

كيف يعمل المؤلف فعليًا

يشبه الوكيل في Houdini موظفًا مبتدئًا (junior) قرأ الإنترنت كله. فحتى وقت قريب لم يكن قادرًا على بناء أسطوانة عادية من المضلعات، وقد اختبر المؤلف ذلك على Claude وChatGPT وPerplexity وغيرها. الأهم هو توجيهه. وإلا فسيبني كل شيء بـ Python داخل عقدتين أو ثلاث، ويصبح تحرير ذلك مستحيلًا. وفي إحدى المرات حذف Claude عقد المؤلف واستبدلها بعقده هو، وبداخلها Python. لكنه مفيد في الأعمال الروتينية: فقد عيّن مثلًا نحو مئة مادة في Karma.

وفي الألعاب لا يستخدم المؤلف MCP، بل hython، أي Python مع الوحدة hou، ويعمل دون واجهة: `& "C:\Program Files\Side Effects Software\Houdini 22.0.368\bin\hython.exe" build_scene.py`. يكتب الوكيل السكربت ويشغّله بنفسه. وهذا مناسب حين لا يحتاج المشروع إلى تعديل داخل Houdini نفسه.

خلاصات عملية

يستطيع الوكيل المتصل تنفيذ أي شيفرة Python داخل Houdini لديك، ولا توجد كلمة مرور للاتصال. لذلك لا ينبغي استخدام هذه الحزمة إلا على جهاز عملك الخاص. وكل إجراء ينفذه الوكيل يُسجَّل خطوة undo مستقلة، مما يسهّل التراجع.

والترتيب العملي كالتالي: تحقق أولًا من الرمز بالأمر `claude -p`، ثم تأكد من أن Houdini يرى متغير البيئة، ولا تنتقل إلى معالجة MCP إلا بعد ذلك. يصلح الوكيل للأعمال الروتينية مثل تعيين المواد بالجملة. أما بنية المشروع فالأفضل تحديد قواعدها صراحةً: عقد واحدة تلو الأخرى، وأسماء واضحة، ولا Python داخل العقد إطلاقًا. وللمهام المستقلة التي لا تتطلب تعديل المشهد في الواجهة، يكون hython أبسط وأكثر موثوقية من MCP.