Mindwalk: شاهد قاعدة 코드 الخاصة بك بالكامل كخريطة ثلاثية الأبعاد

BBetter Stack
Computing/SoftwareInternet Technology

Transcript

00:00:00لمدة عامين، كنا نسلم قواعد الشفرات البرمجية الخاصة بنا لوكلاء الذكاء الاصطناعي ونسمح لهم بإعادة كتابة
00:00:05ما يحلو لهم، ثم نراجع ذلك لمجرد التمرير عبر جدار من الشفرات.
00:00:09أخيرًا، سئم أحدهم من ذلك وقام ببناء العكس تمامًا، طريقة لمشاهدة
00:00:14تحرك الوكيل عبر الشفرة البرمجية ثلاثية الأبعاد.
00:00:17تسمى أداة MindWalk.
00:00:18الآن، قد تكون هذه طريقة أفضل لتصور شفرتنا البرمجية وإحيائها.
00:00:23لدينا أدوات مثل Graphify، فكيف تقارن بهذه الأداة؟
00:00:30إليك المشكلة الحقيقية التي تستهدفها MindWalk.
00:00:34سجل الوكيل يخبرنا بما فعله، مثل تشغيل كذا أو تعديل كذا.
00:00:38لكنه لا يخبرنا أبدًا كيف فهم المهمة.
00:00:41ما هي الملفات التي قرر أنها ذات صلة؟
00:00:44أين ذهب للبحث والتصفح قبل أن يغير سطرًا واحدًا؟
00:00:47هل التزم بنطاقه المحدد أم تصفح نصف المستودع بهدوء؟
00:00:51كل هذا.
00:00:52التفكير الفعلي للوكيل غير مرئي نوعًا ما في النصوص السجلية.
00:00:55لقد اختفى ببساطة.
00:00:56إذا كنت تستمتع بأدوات البرمجة لتسريع سير عملك، فتأكد من الاشتراك.
00:00:59نحن ننشر مقاطع فيديو باستمرار.
00:01:01لذا دعني أريك كيف يبدو الأمر عندما لا يختفي ذلك.
00:01:04لدي مشروع هنا في جلسة Cloud Code قمت بتشغيلها سابقًا.
00:01:08يمكنني تثبيت هذا، باستخدام Go، ثم بنائه.
00:01:14الآن يمكنني تشغيل MindWalk بهذا الأمر هنا، وتظهر قاعدة الشفرة بالكامل كـ
00:01:20مدينة مظلمة ثلاثية الأبعاد.
00:01:21كل ملف عبارة عن مبنى، وكلما زادت شفرته البرمجية، أصبح أطول.
00:01:26ثم أضغط على زر التشغيل للجلسة.
00:01:29لاحظ الأضواء هنا.
00:01:31يتوهج الملف باللون الأخضر، أخضر مائل للطحالب، عندما يلقي الوكيل نظرة خاطفة عليه.
00:01:36وباللون الأزرق عندما يجلس ويقرأه بالفعل، وباللون الكهرماني عندما يجري تعديلًا.
00:01:41ويمكنني سحب الخط الزمني ذهابًا وإيادًا وتتبع المسار الذي سلكه الوكيل بدقة عبر
00:01:46هذه الشفرة.
00:01:48إنه ملف تنفيذي واحد بلغة Go يقرأ سجلات الجلسة فقط، والتي تكتبها Claude Code وCodeex بالفعل
00:01:53على قرصك.
00:01:54بالإضافة إلى مشهد Three.js في متصفحك للعرض ثلاثي الأبعاد.
00:01:58لغة الألوان تلك هي الحيلة الحقيقية هنا.
00:02:01الألوان الباردة تعني أن الوكيل كان يستكشف ويقرأ.
00:02:03والألوان الدافئة تعني أنه كان يغير ويعدل.
00:02:06الخط الزمني مدمج به علامات أيضًا.
00:02:07رموز صغيرة تظهر لك بالضبط أين بدأ وكيل فرعي، وأين تم ضغط نافذة السياق،
00:02:14وأين تدخّلت أنت بتعليمات جديدة.
00:02:17لذا فأنت تعرف دائمًا إلى أين تتجه.
00:02:20ولكن إليك الجزء الذي أعتقد أنه مهم حقًا.
00:02:22بمجرد أن تتجاوز فكرة “هذا يبدو رائعًا”، أليس كذلك؟
00:02:24هناك أمر تحليل (analyze) يقرأ الجلسة بأكملها باستخدام نموذج محلي من
00:02:29Cloud أو Codeex، ويقيم الجلسة التي انتهت للتو.
00:02:33هل استكشف الوكيل قدرًا كافيًا قبل أن يبدأ التعديل؟
00:02:37حسنًا، هل التزم بالتطوير المباشر؟
00:02:38هل انحرف عن الهدف؟
00:02:40هل تكبد عناء التحقق من عمله الخاص؟
00:02:42وكل واحدة من تلك النتائج عبارة عن رابط قابل للنقر ينقلك مباشرة إلى تلك اللحظة على الخط الزمني.
00:02:47هذه مراجعة شفرة للوكيل نفسه.
00:02:49وإذا لم يكن لديك إمكانية إعادة تشغيل الجلسة على الإطلاق، فهناك أمر الخريطة (map) الذي سيعرض أي مستودع
00:02:54كمدينة ثلاثية الأبعاد بمفرده دون أي إعدادات، وهي حيلة رائعة بحق.
00:02:59حسنًا، والآن لننتقل لهذه النقطة.
00:03:00عندما طُرح هذا المشروع على Hacker News، كان التعليق الأول صريحًا للغاية،
00:03:06لأنك ربما تطرح نفس السؤال أيضًا.
00:03:08هذا رائع جدًا، ولكن هل سأستخدمه بالفعل؟
00:03:10ما الذي سأستخدمه من أجله حقًا؟
00:03:12وبعض الأشخاص لم يعارضوا هذا الرأي حتى.
00:03:14قالوا أشياء مثل: لا يخدم أي غرض حقيقي.
00:03:16إنه ممتع، وليس كل شيء يحتاج إلى سبب.
00:03:19ووجه شخص آخر انتقادًا منصفًا بخصوص التغييرات الصغيرة.
00:03:23فأمر git diff العادي والبسيط أسرع بكثير من مشاهدة وكيل يمر عبر هذه الجولة ثلاثية الأبعاد.
00:03:28أنا أتفهم ذلك.
00:03:29لذا، لا يزال هذا المشروع حديثًا جدًا.
00:03:31إنه في الإصدار 0.3.
00:03:32وهو يقرأ سجلات Claude Code وCodeex فقط.
00:03:34إذا كنت تستخدم Cursor، فلن تتمكن من إعادة تشغيل جلساتك بعد.
00:03:38مما يقودني إلى السؤال: لمن صُمم هذا المشروع حقًا؟
00:03:41هل هو مجرد تسلية؟
00:03:42إذا كنت تقارن بين النماذج، فأنت تريد رؤية كيفية استكشاف Claude.
00:03:45لمهمة ما مقارنة بطريقة أدائها في Codeex.
00:03:48هذه عدسة رائعة حقًا لا يمكنك الحصول عليها في أي مكان آخر.
00:03:51إذا كنت تواجه تغييرًا ضخمًا ومتشعبًا أجراه الوكيل، ومقارنة git diff المسطحة لا تمنحك
00:03:56صورة واضحة لما حدث، فإن هذه الجولة ثلاثية الأبعاد بالإضافة إلى تقييم التحليل تُعد أمرًا رائعًا.
00:04:01فهي تفسر لك التفاصيل.
00:04:02ولكن بالنسبة لتعديل من سطرين، فلنكن واقعيين.
00:04:04اقرأ الفروقات عبر diff فقط.
00:04:05لا أعتقد أن MindWalk ستحل محل أي من أدوات المراجعة الخاصة بنا.
00:04:09ولكنها موجودة هنا ربما لمنحك شعورًا بطريقة التشغيل التي لم تُبْنَ أدواتنا الحالية
00:04:14لتظهرها لنا بالفعل.
00:04:15وهذا هو الجزء الذي يمكننا تجربته والتفاعل معه هنا.
00:04:19لقد علمنا آلاتنا كتابة شفراتنا البرمجية بأسرع بكثير من تطويرنا لطريقة لفهم
00:04:24ما كتبته تلك الآلات.
00:04:25أداة MindWalk، تمامًا مثل Graphify.
00:04:29حسنًا، أعتقد أنني أنطق اسمها بشكل صحيح.
00:04:31قد تكون هذه المحاولة الجادة الأولى لسد هذه الفجوة، مما يتيح لك رؤية كيف يفكر الوكيل بالفعل
00:04:36عبر قاعدة الشفرات البرمجية، وليس فقط ضغطات المفاتيح التي تركها أثناء بنائها.
00:04:40إنها أداة أولية وفي مراحلها المبكرة، لكنها تستهدف المشكلة الصحيحة تمامًا.
00:04:43لكن جربها وانظر ما إذا كانت تقدم لك أي فائدة.
00:04:46إذا كنت تستمتع بنصائح وحيل البرمجة مثل هذه، فاحرص على الاشتراك في قناة BetterStack.
00:04:50ونراكم في فيديو آخر.

Key Takeaway

تقدم أداة MindWalk المسكونة بلغة Go رؤية ثلاثية الأبعاد تفاعلية لسجلات Claude Code وCodeex لتحويل مراجعة الشفرات البرمجية المعقدة إلى تتبع بصري ومؤتمت لسلوك الذكاء الاصطناعي.

Highlights

  • تُظهر أداة MindWalk قاعدة الشفرة البرمجية بأكملها كمدينة مظلمة ثلاثية الأبعاد حيث يمثل كل ملف مبنى يتناسب ارتفاعه مع حجم الشفرة.

  • تستخدم الأداة نظام ألوان مخصصًا للتتبع: الأخضر للاستكشاف السريع، الأزرق للقراءة المتعمقة، والكهرماني لإجراء التعديلات.

  • تعتمد MindWalk على ملف تنفيذي واحد بلغة Go يقرأ سجلات الجلسات المخزنة محليًا من Claude Code وCodeex مع واجهة Three.js للعرض في المتصفح.

  • يتضمن الشريط الزمني للأداة علامات مرجعية توضح لحظات بدء الوكلاء الفرعيين، ضغط نافذة السياق، وتدخلات المستخدم المباشرة.

  • يوفر أمر التحليل (analyze) تقييمًا مؤتمتًا للجلسة عبر نموذج محلي للتحقق من استكشاف الوكيل وانحرافه عن الهدف مع روابط مباشرة للحظات التقييم.

Timeline

مشكلة التتبع البصري لسلوك وكلاء الذكاء الاصطناعي

  • تخفي النصوص السجلية التقليدية كيفية فهم الوكيل للمهمة الموكلة إليه.
  • مراجعة التغييرات عبر المرور التقليدي على الشفرة البرمجية تستهلك وقتًا وتفتقر للسياق.
  • قراءة الملفات والتصفح الاستكشافي للوكيل يختفيان تمامًا من السجلات العادية.

تسليم قواعد الشفرات البرمجية لوكلاء الذكاء الاصطناعي ينتج جدرانًا من الشفرات تتطلب مراجعة يدوية شاقة. السجلات الحالية تسجل الأوامر والتعديلات فقط دون توضيح نطاق البحث أو الملفات التي تم الاطلاع عليها قبل إجراء التعديل. تغطي أداة MindWalk هذا النقص من خلال تجسيد حركة الوكيل وتفكيره الداخلي.

آلية عمل MindWalk والترميز اللون المتتبع

  • تمثل الأداة المستودع البرمجي على شكل مدينة ثلاثية الأبعاد يعبر ارتفاع المباني فيها عن حجم الملفات.
  • تتوزع الألوان بين الباردة للاستكشاف والدافئة للتعديل المباشر.
  • تتكون البنية التقنية من برنامج تنفيذي بلغة Go ومحرك Three.js للمتصفح.

عند تشغيل الأمر المخصص، تظهر قاعدة الشفرة كمدينة مظلمة. يتوهج المبنى باللون الأخضر الطحلبي عند إلقاء نظرة خاطفة، وباللون الأزرق عند القراءة الكاملة، وباللون الكهرماني عند التعديل. يعتمد النظام على قراءة ملفات السجلات المخزنة محليًا على القرص الصلب بواسطة Claude Code وCodeex، مع إمكانية سحب الخط الزمني لتتبع المسار بدقة.

أوامر التحليل التلقائي والعرض المجرد

  • يحلل أمر التحليل (analyze) الجلسة الكاملة بواسطة نموذج محلي لتقييم أداء الوكيل.
  • تتيح النتائج روابط تنقل المستخدم مباشرة إلى نقاط زمنية محددة على الخط الزمني.
  • يعرض أمر الخريطة (map) أي مستودع برمجي كمدينة ثلاثية الأبعاد دون الحاجة لإعدادات مسبقة.

يتجاوز النظام مجرد العرض البصري عبر تقييم مدى استكشاف الوكيل للبيئة قبل التعديل وتحققه من عمله وانحرافه عن المسار. تتحول كل نتيجة تقييم إلى رابط تفاعلي على الخط الزمني. وفي حال عدم وجود سجلات إعادة تشغيل، يوفر أمر الخريطة رؤية هيكلية فورية لملفات المشروع.

حالات الاستخدام الفعالة والقيود الحالية

  • تقتصر الأداة في إصدارها 0.3 على سجلات Claude Code وCodeex دون دعم Cursor.
  • تتفوق الجولة ثلاثية الأبعاد على المقارنات المسطحة في التغييرات الضخمة والمتشعبة.
  • تظل أوامر git diff التقليدية الخيار الأسرع للتعديلات البسيطة التي تتكون من سطرين.

تتلقى الأداة انتقادات بشأن جدواها في التغييرات السريعة، حيث تظل الفروقات النصية البسيطة أكثر كفاءة. وتبرز قيمة MindWalk الحقيقية عند مقارنة سلوك النماذج المختلفة على نفس المهمة، أو عند مراجعة التعديلات المعقدة التي تشمل ملفات متعددة وتتطلب فهمًا لسياق الاستكشاف.

Community Posts

View all posts