ورشة مجانية 21–22.11ورشة مجانية لمدة يومين في Vibecoding يومي 21–22 نوفمبر الساعة 16:00 بتوقيت موسكو · الدفعة 3 تبدأ 23.11سجّل مجاناً ←الدفعة 3 (23.11)
إصدارتحليل · على الرادارHabr AI→ المصدر

إضافة لـ Claude Code ترسم خريطة لعمل الوكيل تجمع 1000 نجمة في 10 أيام

طلب المطوّر من وكيل يعمل على Claude Code أن يرسم عمله، ثم حوّل الصورة إلى إضافة: في المركز النموذج، وحوله عشر محطات هي الملفات والطرفية والشبكة والذاكرة وغيرها. في عشرة أيام جمع المستودع 1000 نجمة. وفي 11 نوفمبر، استجابةً لطلبات المستخدمين، صدر 14 إصدارًا في يوم واحد. تكتفي الإضافة بالمراقبة ولا تغيّر شيئًا، ولذلك رفض المؤلف إضافة أزرار للحظر أو أغلفة (skins) جمالية. والدرس لمطوّري الإضافات: التركيز الضيق والمبادئ المكتوبة يمنحان ثقة أكبر من كثرة الميزات.

معالج بواسطة الذكاء الاصطناعي من Habr AI؛ بتحرير Hamidun News
إضافة لـ Claude Code ترسم خريطة لعمل الوكيل تجمع 1000 نجمة في 10 أيام
المصدر: Habr AI. كولاج: Hamidun News.
استمع للمقال
بطاقة الحقائق والأرقام
المعيارالتفاصيل
المصدر الأصليHabr AI ↗
رئيس التحرير
حقيقة رئيسية #1ارتفع استهلاك iTerm2 للذاكرة من 286 ميغابايت إلى 17 غيغابايت خلال خمس دقائق، فعُطّل عرض الصورة
حقيقة رئيسية #2من أمر curl الذي يتضمن رمزًا مميزًا (token) لا يبقى على الخريطة سوى كلمة curl، ومن العنوان لا يبقى سوى المضيف
في اليابان، اختبار على 40 استدعاءًجميعها وصلت إلى المحطة الصحيحة

عندما يعمل الوكيل في الطرفية، لا يظهر أمامك سوى سيل من الأسطر. ماذا يفعل الآن: يقرأ الملفات، أم يتصل بالشبكة، أم يشغّل وكيلًا فرعيًا؟ يمكن معرفة ذلك، لكن لا بد من التدقيق في السجل. وقد عالج مؤلف الإضافة lot-map هذه المشكلة بطريقة بسيطة. طلب من وكيله على Claude Code أن يرسم كيف يرى هو نفسه سير عمله، ثم حوّل الرسم إلى إضافة. وخلال عشرة أيام جمع المستودع 1000 نجمة. هذه نتيجة جيدة لمشروع مفتوح المصدر صغير، والأفضل منها الطريقة التي أُدير بها المشروع.

كيف تعمل الإضافة وكيف نمت

في مركز الخريطة يقف النموذج، وحوله عشر محطات: الملفات والطرفية والشبكة والذاكرة والوكلاء الفرعيون والخطافات (hooks) وغيرها. عندما يستدعي الوكيل أداة، ينطلق نبض نحو المحطة المعنية، وتظهر أسفل الخريطة آخر الاستدعاءات. صدر الإصدار الأول في 9 نوفمبر، وعرضه المؤلف في r/ClaudeAI مع مقطع فيديو. بحلول ليلة 11 نوفمبر كان للمستودع 100 نجمة، وفي 12 نوفمبر بلغت 500، وفي 18 نوفمبر بلغت 1000.

وجاء النمو متزامنًا مع ملاحظات المستخدمين. في 11 نوفمبر وحده صدر 14 إصدارًا، إذ تحوّل كل طلب تقريبًا من التعليقات إلى إصدار. وهكذا ظهرت إمكانية قلب الخريطة، وألوان مخصصة، وخلفية شفافة، وإصلاح مسارات Windows، وتسميات بالإيطالية والبرتغالية. الإصدار الحالي هو 0.12.0. وأكثر ما يحظى بالثناء الحلقة المحيطة بالمركز، وهي تُظهر مقدار امتلاء السياق. وهناك أيضًا عدّاد للرموز (tokens) يبيّن كم أضاف كل استدعاء إلى السياق.

الطرفية وiTerm2 ودليل Anthropic

لا تُرسم الصور في Claude Code إلا داخل التطبيق وVS Code، أما في الطرفية فلا تبقى سوى الأسطر النصية. جرّب المؤلف رسم الخريطة بالرموز النصية واعترف بأن النتيجة كانت سيئة: 7 أسطر بلا حركة. عندها انضم متحمسون للمشروع. أرسل أحدهم pull request من 2000 سطر، تَرسم فيه الإضافة نفسها صورة PNG وتمررها إلى الطرفية إطارًا تلو آخر (الإصدار 0.6.0). وصنع آخر نسخة من الخريطة بخط برايل للطرفيات التي لا تدعم الصور، مثل Windows Terminal.

ثم ظهر خلل مزعج. نفدت الذاكرة عند أحد المستخدمين: ارتفع استهلاك iTerm2 من 286 ميغابايت إلى 17 غيغابايت خلال 5 دقائق، لأنه كان يحتفظ بكل إطار حتى إغلاق علامة التبويب. لا يمكن تجاوز المشكلة من جانب الإضافة، فعُطّل عرض الصورة في iTerm2 ضمن الإصدار 0.9.0. أرسل المؤلف تقريرًا إلى مطوّر iTerm2، فأصلح الخطأ في اليوم التالي. وفي 0.12.0 أُعيد عرض الصورة في iTerm2 بدءًا من الإصدار 3.7.8.

وكانت النتيجة أسوأ مع دليل Anthropic. فمن أجل اجتياز التحقق، أُزيل من الإضافة خطّاف فحص الأذونات (الإصدار 0.4.0)، واختفى بذلك سطران من الخريطة. وفي النهاية جاء الرفض: الدليل لا يقبل الإضافات إلا من مؤسسات موثَّقة. وأُعيد الخطّاف في 0.5.0. والدرس بسيط: لا تكيّفوا المنتج مع منصة قبل أن تعرفوا شروطها.

ما الذي رُفض ولماذا نالت الإضافة الثقة

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

وفي اليوم الخامس صيغت ستة مبادئ: الإضافة لا تغيّر شيئًا؛ والتسمية تعرض الاسم فقط دون المحتوى؛ وتكلفتها شبه معدومة؛ وأي عطل في الخريطة لا يعطّل عمل الوكيل؛ والخريطة هادئة؛ وإعدادات المستخدم تبقى كما هي. وتحت كل مبدأ اختبار يحميه. ففي المبدأ الأول يُتحقق من أن الحدث يمضي إلى وجهته تمامًا كما وصل. وفي الثالث هناك قياسات بميزانية زمنية. ويضم المستودع قائمة بكل ما تطلبه الإضافة من Claude Code، ويقارن فحص يجري عند كل pull request الشيفرة بهذه القائمة. ولا يرد في القائمة الاتصال بالشبكة ولا قراءة الملفات ولا تشغيل العمليات.

واحتيج إلى المبدأ الثاني قبل أن يُدوَّن. فالإضافة ترى كل استدعاء كاملًا: الأوامر والمسارات والعناوين مع معاملاتها، والشاشة قد تظهر في لقطات الشاشة. لذلك لا يبقى من أمر curl الذي يتضمن رمزًا مميزًا (token) سوى كلمة curl، ولا يبقى من العنوان سوى المضيف. وفي اليوم الثالث وجد قارئ للشيفرة طريقة لكتابة العنوان بحيث تصل كلمة المرور مع ذلك إلى التسمية. وأُصلح الخلل في اليوم نفسه.

فحوص من أطراف خارجية

أجرى مدوّن ياباني 5 مهام و40 استدعاءً، وقارن الخريطة كل نصف ثانية. وصل الاستدعاءات الأربعون كلها إلى المحطة الصحيحة، وظهر اسم الهدف في 30 منها. وخلاصته: الخريطة تعطي نظرة عامة، لكنها لا تحل محل السجل. وفي إسبانيا فُحصت الإضافة بماسح أمني، وحُلّلت يدويًا 10 تنبيهات: تبيّن أنها كلها إيجابيات كاذبة، إذ اعترض الماسح على curl وsudo في الاختبارات. وصنع أحدهم طبقة عرض (overlay) لـ Codex على الملفات نفسها، وأضاف آخر شريطًا زمنيًا للخطوات.

أما من يكتبون إضافات للوكلاء، فالخلاصة عملية. فالدور الضيق «أراقب فقط» أتاح صياغة ضمانات قابلة للتحقق. وقائمة المبادئ المقترنة باختبارات ساعدت على رفض أفكار الآخرين دون جدال. والقيود صريحة أيضًا: هذه نظرة عامة وليست بديلًا عن السجل، وفي الطرفيات التي لا تدعم الصور تبدو الخريطة أفقر. يمكن تجربة الإضافة في المتصفح على alexeyw.github.io/lot-map، والشيفرة في المستودع alexeyw/lot-map.

القصة

أسئلة وأجوبة حول الخبر

ما أبرز التفاصيل حول كيف تعمل الإضافة وكيف نمت؟

في مركز الخريطة يقف النموذج، وحوله عشر محطات: الملفات والطرفية والشبكة والذاكرة والوكلاء الفرعيون والخطافات (hooks) وغيرها. عندما يستدعي الوكيل أداة، ينطلق نبض نحو المحطة المعنية، وتظهر أسفل الخريطة آخر الاستدعاءات. صدر الإصدار الأول في 9 نوفمبر، وعرضه المؤلف في r/ClaudeAI مع مقطع فيديو. بحلول ليلة 11 نوفمبر كان للمستودع 100 نجمة، وفي 12 نوفمبر بلغت 500، وفي 18 نوفمبر بلغت 1000. وجاء النمو متزامنًا مع ملاحظات المستخدمين. في 11 نوفمبر وحده صدر 14 إصدارًا، إذ تحوّل كل طلب تقريبًا من التعليقات إلى إصدار.

ما أبرز التفاصيل حول الطرفية وiTerm2 ودليل Anthropic؟

لا تُرسم الصور في Claude Code إلا داخل التطبيق وVS Code، أما في الطرفية فلا تبقى سوى الأسطر النصية. جرّب المؤلف رسم الخريطة بالرموز النصية واعترف بأن النتيجة كانت سيئة: 7 أسطر بلا حركة. عندها انضم متحمسون للمشروع. أرسل أحدهم pull request من 2000 سطر، تَرسم فيه الإضافة نفسها صورة PNG وتمررها إلى الطرفية إطارًا تلو آخر (الإصدار 0.6.0). وصنع آخر نسخة من الخريطة بخط برايل للطرفيات التي لا تدعم الصور، مثل Windows Terminal. ثم ظهر خلل مزعج.

ما أبرز التفاصيل حول ما الذي رُفض ولماذا نالت الإضافة الثقة؟

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

ZK
جمال حميدون — مدير المنتجات في Alpina Digital ومدير منتج AlpinaGPT. يبني منتجات الذكاء الاصطناعي منذ 2019. بدأ Hamidun News كمشروع شخصي ثم أصبح مُجمِّعًا إنتاجيًا بأكثر من 6000 قارئ.
✦ Hands-On AI Engineering · Hamidun Academy

Build & Ship Production AI Agents Without Boilerplate Code

Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.

Start 72h Free Trial →Vibe-Coding Intensive
ما رأيك؟
جارٍ تحميل التعليقات…