
مسارات تدقيق مقاومة للعبث لوكلاء الذكاء الاصطناعي: سجلات Runtime Records مترابطة بسلسلة تجزئة (hash-chained)، بدون تبعيات، وقابلة للتحقق من قبل أي شخص.
مسارات تدقيق مقاومة للتلاعب لوكلاء الذكاء الاصطناعي — سجلات وقت التشغيل المتسلسلة هاشيًا، تُعرض كتقرير وقت تشغيل يمكن لعملائك التحقق منه بأنفسهم.
كل إجراء تلتقطه أدوات القياس الخاصة بك (استدعاءات الأدوات، استدعاءات النماذج، الوصول إلى البيانات، الموافقات) يصبح سجل وقت تشغيل واحدًا في سجل إضافي فقط ومتسلسل هاشيًا؛ وتقرير وقت التشغيل هو تلك السلسلة معروضة كصفحة HTML تعيد حساب سلسلة الهاش في متصفح القارئ وتعرض ما تعرضه من السجلات التي تحققت منها (للحصول على تحقق لا يعتمد على كود الصفحة نفسها، شغّل halo verify على ملف JSONL). أي طرف يملك نقطة تحقق من السلسلة يمكنه التحقق من أن السجلات حتى تلك النقطة لم تُعدَّل منذ أخذها، دون الوثوق بمن أنتجها — نقطة التحقق تلك هي الجزء الحامل للثقل: السلسلة وحدها مقاومة للتلاعب ضد الجميع باستثناء الطرف الذي يشغّل المسجّل (LIMITS.md §1). عندما يسأل فريق الأمن لدى العميل "ماذا فعل وكيلك ببياناتنا؟"، تسلّمهم رابطًا بدلًا من فقرة. مراجعات الأمن تطرح بالفعل أسئلة الذكاء الاصطناعي بجانب قائمة SOC 2 — وبشكل متزايد تأتي تلك الأسئلة من ISO 42001، ومواد حفظ السجلات في قانون الذكاء الاصطناعي الأوروبي، واستبيانات العملاء الخاصة. اليوم لا يزال الضمان المكتوب يمر. والرهان وراء هذا المشروع هو أنه لن يمر طويلًا.
"عشرون عامًا في التحقيق الجنائي الرقمي تعلّمك أن الدليل لا يكون دليلًا إلا إذا استطاع الطرف الآخر التحقق منه... في مجال مليء بمنتجات الذكاء الاصطناعي التي تطلب الثقة، [Halo] هو المنتج النادر المصمم لجعل الثقة غير ضرورية."
Johannes Stillig، المؤسس والرئيس التنفيذي لـ Tidebreak AI ورئيس أمن المعلومات في مجموعة بمكتب استثمار خاص
ظهر في Help Net Security · ضمن أفضل 4% من إطلاقات Show HN ذلك الأسبوع · مُدرج في Agentic Trust Controls مقابل خمسة ضوابط
صيغة السجل مفتوحة ومجانية للتنفيذ. هذه الحزمة هي التنفيذ المرجعي: المسجّل، والمدقق، وعميل الشاهد، وخادم التقرير.
هل تستخدم halo-record، أو تفكر في ذلك؟ أخبرني من أنت ولأي غرض → من يستخدم halo-record؟
يُطلب منك وضع مسجّل داخل وكيلك. لا ينبغي أن تقبل ذلك إيمانًا:
pip install halo-record يثبّت حزمة واحدة بالضبط.halo serve --verify-email (يرسل رمزًا لمرة واحدة واسم موضوع التقرير، عبر SMTP من خلال الخادم الذي تهيّئه في $HALO_SMTP_HOST، إلى العنوان الذي يدخله عارض التقرير). جميعها معطّلة ما لم تستدعها؛ ولا تخرج أي محتويات أخرى للسجلات من بنيتك التحتية.summaries=False) فلا يحتفظ بأي ملخّص على الإطلاق. التنقيح هو أفضل جهد ممكن (تعبير نمطي على صيغ الأسرار والبيانات الشخصية الشائعة بالإضافة إلى أداة إنتروبيا شاملة): تعامل معه كدفاع متعدد الطبقات، لا كضمان. حقول النتيجة التي تقدّمها بما يتجاوز summary تُفحص وتُخفى بنفس الأنماط، لكن لا تُقتطع إلى 200 حرف (LIMITS §13).ما يثبته كل طبقة — التمييز الجوهري في هذا المشروع (LIMITS.md §1): السلسلة التي تحتفظ بها بنفسك تثبت أن السجلات لم تُحرَّر، نسبةً إلى رأس يملكه شخص آخر بالفعل؛ فقط نقاط التحقق المحفوظة خارج المشغّل تثبت أن أياً منها لم يُحذف؛ ولا تثبت أي تجزئة أن كل إجراء قد تم التقاطه.
| الادعاء | سلسلة محفوظة ذاتيًا | + نقاط تحقق خارجية | + التقاط موثوق |
|---|---|---|---|
| كشف التعديلات على أثر راسخ | ✔ | ✔ | ✔ |
| كشف إعادة كتابة التاريخ المثبَّت | — | ✔ | ✔ |
| كشف نقاط التحقق المفقودة/المتأخرة | — | ✔ (وتيرة متفق عليها) | ✔ |
| إثبات أن كل إجراء قد سُجّل | — | — | يعتمد على حدود الالتقاط |
شاهد واحدًا قبل أن تثبّت: تقرير وقت تشغيل نموذجي — بيانات خيالية، سلسلة حقيقية، ويعيد نصّه البرمجي حساب سلسلة تجزئة السجلات المضمّنة في متصفحك عند فتحه.
لا حاجة إلى وكيل. مع uv، لا شيء لتثبيته:
uvx --from halo-record halo demo --serve
أو بالطريقة التقليدية:
pip install halo-record
halo demo --serve
إما أن يقوم أحد الأمرين ببناء بائع وكيل دعم خيالي مع عميلين، ويشهد على السلاسل (مع ملف شاهد محلي يقوم مقام شاهد خارج المشغّل — انظر LIMITS.md §1)، ويقدّم تقارير Runtime المُقيَّدة الخاصة بهم، ويفتح وحدة تحكم المشغّل في متصفحك. ثم جرّب اختبار العبث: احذف سطرًا من أحد ملفات .jsonl وأعد التحميل. يكتشف التقرير ذلك.
سطر واحد عند الحدود:
from halo_record import trace
agent = trace(run_my_agent, profile="my-agent", log="audit.jsonl") # wraps your entrypoint; records the run boundary to ./audit.jsonl — add record_call() or a framework adapter at each tool boundary to capture individual calls
يُشحن أيضًا غلاف تسهيلي from halo import ... — لكن اسم halo على PyPI يعود لحزمة مؤشر طرفية (terminal-spinner) غير ذات صلة، وإذا كانت تلك الحزمة مثبّتة فإنها تفوز عند الاستيراد. اسم halo_record لا يحتمل اللبس، لذا تستخدمه الأمثلة.
بدون log=، تذهب السجلات إلى ~/.halo/my-agent.jsonl (سلسلة واحدة لكل وكيل). يختم الغلاف حدّ التشغيل؛ وتوجد الأدلة في سجلات كل استدعاء. التقطها باستخدام محوّل إطار عمل (الجدول أدناه) — أو صراحةً، وهو ما يُظهر أيضًا كيفية ربط التفويض:
from halo_record import Recorder, record_call
rec = Recorder("audit.jsonl")
with record_call(rec, "crm.lookup", {"account": "acct-9"}) as call: # one sealed record per tool call
call.result = crm.lookup("acct-9")
with record_call(rec, "payments.refund", {"amount": 120},
parent_id=rec.last_record_id()) as call: # child links to the action that spawned it
call.result = payments.refund(120)
ثم اعرض التقرير:
halo report audit.jsonl -o report.html # one chain -> HTML that re-verifies in the browser
halo serve ./records --port 8721 # all tenants, gated per customer
هل تقوم بترقية دليل خُدِم أول مرة بواسطة 0.2.45؟ يعيد halo serve قراءة كل منحة سابقة عند بدء التشغيل. تُعزل المنحة على ملف لا تحمل سجلاته معرّف موضوع (ملف Recorder عادي مثل agent.jsonl) وتُطبع عند كل بدء تشغيل مع أمر halo grant الذي يعيد إصدارها — انظر LIMITS.md §17، "Serving a directory first served by 0.2.45".
ينتهي البدء السريع عندما تنظر إلى تقرير وقت التشغيل Runtime Report الخاص بوكيلك في المتصفح. إذا حصلت على ملف JSONL دون تقرير، فهناك خطأ ما: افتح issue.
إذا تحققت طبقة حماية أو سياسة من الإجراء، يمكن أن يرافق الحكم السجل — كتلة اختيارية تسجّل ما قررته البوابة، مختومة في سلسلة التجزئة مثل كل حقل آخر:
from halo_record import build