حزم الأدلة
نزّل سجلا موقّعا يبين كيف أنجز تغيير واحد (المهمة والنماذج والموافقات والملاحظات والاختبارات والتسليم) وتحقق منه في المتصفح أو دون اتصال بالشبكة.
حزمة الأدلة سجل موقّع يبين كيف أنجز تغيير واحد في AI CodeOps. وهي للمدققين ومراجعات الامتثال والعملاء الذين يحتاجون إلى بيان كيف وصل كود كتبه الذكاء الاصطناعي إلى الإنتاج.
ما تحتويه الحزمة
لتغيير واحد (Develop → Changes، ثم تغيير):
- المهمة: الموجه المعطى للذكاء الاصطناعي، والنموذج والمزود والفئة، وملفات السياق.
- التشغيلات: الجلسة وكل تشغيل متابعة، مع الحالة والتوقيتات والرموز والتكلفة، ومزود كل خطوة وكيل ونموذجها.
- النتيجة: الملخص، والملفات المتغيرة، وتجزئة SHA-256 للفروقات. والكود نفسه غير مضمّن؛ والتجزئة تتيح لك مطابقته مع طلب السحب.
- الموافقات: كل طلب موافقة، ومن طلبه (وفي موافقة الجلسة نفسها، العضو الذي بدأ الجلسة)، ومن كان يستطيع الموافقة (الحقل
eligibleApprovers: الأشخاص الذين سماهم الطلب والأدوار المسموح لها بالبت)، ومن وافق أو رفض فعلا (الحقلانapprovedByوrejectedBy)، وكل صوت (الحقلvotes). - كل صوت: في
votesإدخال لكل صوت، بترتيب الإدلاء بها: حساب المصوت (accountID)، ودوره في مساحة العمل (role)، والصوت (approveأوreject)، والوقت (decidedAt)، والملاحظة. ويبينroleAsOfالتاريخ الذي يعود إليه الدور: القيمةvoteتعني الدور المسجل حين أدلي بالصوت؛ والقيمةexportتعني الدور الذي كان له حين أنشئت الحزمة، وتستخدم للأصوات التي أدلي بها قبل تسجيل الأدوار، والقيمةnullإذا غادر المصوت مساحة العمل بعد ذلك. وتكون قيمةselfApprovalهي true حين يوافق المصوت على تغيير بدأه هو، ويبينselfApprovalAllowedByسبب السماح بذلك. ويحملgateOverrideالسبب الذي ذكره المصوت، وما قاله فحص الإصدار، حين يوافق على تغيير كان فحص الإصدار الخاص به فاشلا. وقائمةdecisionsالخام ما زالت موجودة، دون تغيير. وكلتاهما لا تحملان إلا الجولة الحالية: فحين تعاد فتح الموافقة، كأن يعدل تغيير موافق عليه، تفرغان، وتبقى الأصوات السابقة في قسمauditمن الحزمة على شكل إدخالاتapproval.decided. - قرارات السياسة: كل قرار allow أو deny أو ask اتخذته سياسات مساحة العمل أثناء التغيير.
- الملاحظات والاختبارات: ملاحظات المراجعة مع فرزها، ونتائج الاختبار (الناجح والفاشل والمتخطى والتغطية).
- التسليم: طلب السحب، وعملية النشر، وأي حادثة مرتبطة بالتغيير.
- مسار التدقيق: إدخالات سجل التدقيق المتعلقة بأي مما سبق.
- الأشخاص: عنوان البريد الإلكتروني خلف كل معرف حساب في الحزمة.
نزّل حزمة
افتح Changes، واختر تغييرا، ثم اختر Download evidence pack (تنزيل حزمة الأدلة). وتحتاج إلى صلاحية التدقيق في مساحة العمل: وهي لدى المالكين والمسؤولين ومسؤولي الأمان. ويسجل كل تنزيل في سجل التدقيق لمساحة العمل.
تحقق من حزمة في المتصفح
افتح /evidence/verify واختر الملف. ولا حاجة إلى حساب. تخبرك الصفحة هل التوقيع مطابق وأي مفتاح وقّعها.
تحقق من حزمة دون اتصال بالشبكة
لست مضطرا إلى الثقة بأداة التحقق لدينا. الحقل signature في الحزمة توقيع Ed25519 على صيغة JSON القانونية (canonical) للحقل payload: مفاتيح الكائنات مرتبة في كل مستوى، ودون مسافات بيضاء. والمفاتيح العامة للمنصة موجودة على /api/evidence?action=keys. وباستخدام Node.js 20 أو أحدث يكون السكربت كما يلي:
// verify-evidence.mjs <pack.json> <keys.json>
import { readFileSync } from "node:fs"
import { createPublicKey, verify } from "node:crypto"
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(",")}}`
const pack = JSON.parse(readFileSync(process.argv[2], "utf8"))
const { keys } = JSON.parse(readFileSync(process.argv[3], "utf8"))
const key = keys.find((k) => k.kid === pack.signature.kid)
if (!key) throw new Error(`unknown key ${pack.signature.kid}`)
const ok = verify(
null,
Buffer.from(canonical(pack.payload)),
createPublicKey(key.publicKey),
Buffer.from(pack.signature.value, "base64url"),
)
console.log(ok ? "VERIFIED" : "NOT VERIFIED: the pack was altered")
احفظ المفاتيح مرة واحدة، ثم شغّل السكربت:
curl -o keys.json "https://console.aicodeops.dev/api/evidence?action=keys"
node verify-evidence.mjs evidence-chg_....json keys.json
المفاتيح وتدويرها
المفاتيح لا تحذف أبدا. حين يحال مفتاح إلى التقاعد يتوقف عن توقيع حزم جديدة، والحزم التي وقّعها تبقى قابلة للتحقق. واحتفظ بنسخة من keys.json مع سجلات التدقيق لديك إذا أردت تحققا لا يعتمد على الوصول إلى المنصة.
الخطوات التالية
الأسئلة الشائعة
هل تحتوي الحزمة على كودنا المصدري؟
لا. تسرد الملفات المتغيرة وتجزئة SHA-256 للفروقات، فتستطيع مطابقتها مع طلب السحب دون أن يغادر الكود مستودعك.
هل تبقى الحزم القديمة قابلة للتحقق بعد إحالة مفتاح إلى التقاعد؟
نعم. المفاتيح لا تحذف أبدا. والمفتاح المتقاعد يتوقف عن توقيع حزم جديدة، والحزم التي وقّعها تبقى قابلة للتحقق.