AI CodeOps

حزم الأدلة الموقّعة: إثبات طريقة إطلاق الكود الذي كتبه الذكاء الاصطناعي

Matt · · آخر تحديث · مدة القراءة: ⁨4⁩ دقيقة · المنتج

ما الذي تحتويه حزمة الأدلة في AI CodeOps، ولماذا نوقّعها بخوارزمية Ed25519 على صيغة JSON القانونية، وكيف يتحقق منها المدقق دون اتصال ودون أن يثق بنا.

عاجلا أو آجلا، يطرح أحدهم على الفريق الذي يستخدم الذكاء الاصطناعي لكتابة الكود سؤالا مشروعا: كيف وصل هذا التغيير إلى بيئة الإنتاج؟ من طلبه، وأي نموذج كتبه، ومن نظر فيه، وما الذي اختبر، وما الذي وافق عليه؟

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

ما تحتويه الحزمة

افتح Changes، واختر تغييرا، ثم اختر Download evidence pack. فتحصل على ملف JSON فيه:

  • المهمة. الموجه الذي أعطي للذكاء الاصطناعي، والنموذج، والمزود، والفئة، وملفات السياق.
  • التشغيلات. الجلسة وكل تشغيل متابعة، مع الحالة والتوقيتات والرموز والتكلفة، ومزود كل خطوة من خطوات الوكلاء ونموذجها.
  • النتيجة. الملخص، وقائمة الملفات المتغيرة، وتجزئة SHA-256 للفروقات.
  • الموافقات. كل طلب موافقة، ومن كان يستطيع الموافقة عليه، وكل صوت مع وقته وملاحظته.
  • قرارات السياسة. كل قرار allow أو deny أو ask اتخذته سياسات مساحة العمل أثناء التغيير.
  • الملاحظات والاختبارات. ملاحظات المراجعة وطريقة فرزها، ونتائج الاختبارات: الناجح والفاشل والمتخطى والتغطية.
  • التسليم. طلب السحب، وعملية النشر، وأي حادثة مرتبطة بالتغيير.
  • مسار التدقيق. إدخالات سجل التدقيق المتعلقة بأي مما سبق.
  • الأشخاص. عنوان البريد الإلكتروني وراء كل معرف حساب في الحزمة، ليقرأ الملف وحده دون حاجة إلى غيره.

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

تنزيل الحزمة يحتاج إلى صلاحية التدقيق في مساحة العمل. ويملكها المالكون والمسؤولون ومسؤولو الأمان. وكل تنزيل يسجل هو نفسه في سجل التدقيق، فتستطيع أن ترى من صدّر ماذا. والتفاصيل في دليل حزم الأدلة.

لماذا نوقّعها

ملف JSON سهل التعديل. ولو أمكن تغيير الحزمة بعد تنزيلها، لما ساوت أكثر من جدول بيانات كتبه أحدهم بيده. والتوقيع هو ما يحولها إلى دليل.

لكل حزمة ثلاثة أجزاء: سلسلة format، وpayload الذي فيه كل ما سبق، وsignature. والتوقيع بخوارزمية Ed25519 (RFC 8032) على الحمولة. واخترنا Ed25519 لأنها صغيرة وسريعة، وليست لها معاملات يمكن الخطأ فيها، وهي مضمّنة في المكتبات المعيارية التي يملكها معظم الناس أصلا، ومنها وحدة في Node.js، و Go، وحزمة cryptography في Python، و OpenSSL. فلا ينبغي أن تحتاج إلى الكود الخاص بنا لتتحقق من ادعاءاتنا.

صيغة JSON القانونية

في توقيع JSON فخ واحد. فالبيانات نفسها يمكن كتابتها بطرق كثيرة: مفاتيح بترتيب مختلف، أو مسافات زائدة، أو فاصل سطر. فإذا وقّعت البايتات نفسها التي أرسلناها، فإن إعادة حفظ بريئة في محرر نصوص أو أداة JSON تكسر التوقيع، ولا تستطيع التمييز بين إعادة التنسيق والتزوير.

لذلك نوقّع الصيغة القانونية (canonical) للحمولة بدلا من ذلك: مفاتيح الكائنات مرتبة في كل مستوى، ولا مسافات بيضاء. فأيا كان من يعيد تسلسل الحزمة، تبقى البايتات القانونية نفسها، ويبقى التوقيع صالحا. ودالة الصيغة القانونية نحو عشرة أسطر:

const canonical = (v) =>
  v === null || typeof v !== "object"
    ? JSON.stringify(v)
    : Array.isArray(v)
      ? `[${v.map(canonical).join(",")}]`
      : `{${Object.keys(v)
          .sort()
          .map((k) => `${JSON.stringify(k)}:${canonical(v[k])}`)
          .join(",")}}`

التحقق من الحزمة

هناك طريقتان.

في المتصفح. افتح /evidence/verify واختر الملف. ولا حاجة إلى حساب. وتخبرك الصفحة هل التوقيع صالح، وأي مفتاح وقّعه، وأي تغيير تخصه الحزمة، ومتى أنشئت.

دون اتصال. وهذه هي الطريقة المهمة للتدقيق، لأنها لا تطلب منك أن تثق بأداة التحقق الخاصة بنا. فمفاتيحنا العامة منشورة على /api/evidence?action=keys. احفظها مرة واحدة، ثم شغّل على الحزمة سكربت Node.js قصيرا موجودا في الدليل. فهو يحول الحمولة إلى صيغتها القانونية، ويجد المفتاح الذي تسميه الحزمة، ويتحقق من التوقيع باستخدام node:crypto. وإذا غيّر أحد حرفا واحدا في الحمولة، يطبع "NOT VERIFIED".

ونحن نشغل أيضا السكربت نفسه من الدليل في اختباراتنا، على حزمة موقّعة حقيقية. فإذا اختلف الكود والوثائق يوما، تفشل اختباراتنا، لا عملية التدقيق لديك.

المفاتيح ومدة صلاحية الحزم

تسمي كل حزمة المفتاح الذي وقّعها بمعرف مفتاح: أول 16 حرفا ست عشريا من تجزئة SHA-256 للمفتاح العام. وينشأ المفتاح الخاص عند أول استخدام ويخزن مشفرا.

ولا تحذف المفاتيح أبدا. فحين يحال مفتاح إلى التقاعد، يتوقف عن توقيع حزم جديدة، لكن نصفه العام يبقى منشورا، فتبقى كل حزمة وقّعها قابلة للتحقق. والحزمة التي تنزلها اليوم ينبغي أن تبقى صالحة للتحقق بعد سنوات.

ما لا تثبته الحزمة

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

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

أهم النقاط

  • حزمة الأدلة ملف JSON واحد لكل تغيير: المهمة، والتشغيلات، والموافقات، وقرارات السياسة، والملاحظات، والاختبارات، والتسليم، ومسار التدقيق.
  • الكود ليس في الحزمة؛ وتربط تجزئة SHA-256 للفروقات الحزمة بطلب السحب نفسه بالضبط.
  • توقّع بخوارزمية Ed25519 على صيغة JSON القانونية، فلا تكسرها إعادة التنسيق بينما يكسرها أي تعديل.
  • يستطيع أي شخص التحقق منها في المتصفح على /evidence/verify، أو دون اتصال بسكربت Node.js قصير ومفاتيحنا المنشورة.
  • تثبت ما سجله AI CodeOps وأن أحدا لم يغيره منذ ذلك الحين، لا أن الكود صحيح.