ماتلوك (Matlock) — أدوات الوكلاء والمطورين. (دليل المالك والمرجع التشغيلي)
لوكلاء البرمجة بالذكاء الاصطناعي والمنسّقين: انتقل مباشرة إلى الجزء الثاني: المواصفات التشغيلية للآلة والوكلاء المستقلين للاطلاع على فهرس
stdioMCP بـ 27 أداة، وفتحHTTP 402ثنائي المسار، وقواعد صندوق العزل الحدوديcold_box، وعقود الإتمام.
المنتج: ماتلوك (Matlock) — أدوات الوكلاء والمطورين. (كفاءة. دقة. وفق الأصول.)
التموضع: تحقق تقني متعدد اللغات في < 50ms دون رفع سحابي لمعايير الأمان وMITRE CWE وIEEE Std 1003.1 POSIX وCISA SSDF وAICPA SOC 2 Trust Services Criteria، مع أختام اختبارات Safeguard المقاومة للعبث، وصناديق عزل Pre-CI الحدودية، وأتمتة CLI بنقرة واحدة، وتنبيهات خاصة صادرة فقط، وMCP محلي عبر stdio بـ 27 أداة (0 رفع سحابي للكود، 0 منافذ مفتوحة، 0 حظر لأوامر git-commit).
الناشر: ماتلوك (Matlock) by Dutch P2P © 2026. جميع الحقوق محفوظة.
الواجهات: مركز قيادة سطح المكتب (Windows وLinux وGoogleBook؛ وmacOS وiOS جاهز للوضع بلا واجهة MCP على macOS arm64 — اضغط ? أو F1 في أي وقت) · مركز القيادة على الويب · فحص المتصفح المجاني · الوثائق · الدليل عبر الإنترنت · معرف MCP matlock://help/appliance-manual
إشعار النطاق والإشعار القانوني: يقيّم ماتلوك الضوابط التقنية للشيفرة البرمجية وخطوط الأنابيب مقابل المواصفات والمعايير الصناعية المنشورة (MITRE CWE، وCISA SSDF، وIEEE Std 1003.1 POSIX، وبوابات النزاهة الآلية Pre-CI، والضوابط التقنية لـ AICPA SOC 2 Trust Services Criteria). لا يضمن ماتلوك برمجيات خالية من العيوب، ولا يُصدر تقارير تصديق رسمية من طرف ثالث، ولا يقدّم شهادات اعتماد من مكتب محاسب قانوني معتمد (CPA) مستقل.
الجزء الأول: دليل المشغّل البشري ومنضدة العمل
1. مسرد سريع وسير العمل الأساسي
- كيف يسير العمل الأساسي: اختر مجلد مشروع -> يشغّل ماتلوك فحصاً ساكنًا فورياً خارج خيط الواجهة (
max(1, cores - 1)عزلات، مع إبقاء نواة معالج1مستجيبة للمستخدم) ويكتشف نصوص مساحة العمل -> ضع نجمة على الأوامر الأكثر استخداماً في المفضلة -> انقرMatlockلتشغيل خط التحقق الموحّد (Clean -> Get -> Format -> Lint -> Analyze/Compile -> Test -> Coverageعبرdepth 0..2إضافة لفحوصات ما قبل CI العابرة للأنظمة والفحوصات المدمجة والمخصصة؛ وتتخطى التشغيلات الدافئة اليومية مرحلةCleanمتى بقيت بيانات الأساس والتبعيات دون تغيير، بينما توفّر قائمة...خيارتشغيل فحص النظافة والتغطية الكاملفي أي وقت دون مفاتيح واجهة مزدحمة). يختبرMatlockكل شيء دون إيداع أو دفع (0أوامرgit pushمدمجة داخلMatlockأو روتينات الاختبار المسبقة — يظل الاختبار والدفع منفصلين، مع حرية المستخدمين ووكلاء MCP في إضافة بطاقات وسلاسل مخصصة لـgit pushأو النشر السحابي) ولا يثبّت.git/hooks/*ولا يعيق الإيداعات المحلية أبداً. - الاختبار مقابل الخطأ (النتيجة): الاختبار هو فحص مدمج غير قابل للتعديل أو فحص مخصص ينشئه المستخدم ويسهم في الدرجة الصحية الرقمية
0.0–100.0. والخطأ هو مشكلة واحدة بإحداثياتfile:line:col(col >= 1) ووسوم[MITRE CWE-*]/[POSIX-*]/[MITRE Txxxx]وسبب واضح ووصفة فرق موحدة من 5 أسطر منقّحة. - الإجراء والروتين (التسلسل): الإجراء بطاقة أمر محلي بنقرة واحدة (
flutter testأوnpm run buildأو نسخ احتياطي.bat)؛ والروتين يربط أكثر من 20 بطاقة على خط التشغيل مع إيقاف وتنبيه (افتراضي) أو إيقاف أو متابعة وتنبيه. - Safeguard (
محمي (Safeguarded)/يمكن لوكيل الذكاء الاصطناعي التعديل): ختم ثابت يحمي الاختبارات والنصوص والإجراءات والروتينات والتنبيهات (للقراءة والتشغيل فقط). وتُستعاد التعديلات غير المصرح بها على ملف أو نص محمي تلقائياً إلى الأصل المختوم مع إطلاق تنبيه عبث نابض في الظرف.
2. تخطيط الشاشة والسمات والتنقل
- السمتان النهارية والليلية الهادئتان: بدّل في أي وقت عبر زر السمة في الشريط العلوي أو الإعدادات -> المظهر بين النهاري الفضي-الأبيض الهادئ (
#F8F9FA/#FFFFFF) والليلي الأردوازي الفحمي الهادئ (#131517/#181B20/#1E2228). بلا أي نوافذ مقاطعة منبثقة أثناء التشغيل؛ فقط ثقة المجلد لأول مرة ومطالبة واحدة مسبقة اسألني قبل تشغيل هذا قبل الخطوة 1. - الشريط العلوي:
تصفح...+ مربع المسار،المتجاهَل (N)بإدارة خماسية النطاقات،إيقاف(Ctrl+./Esc)،ترقية(المجاني)،القيمة،مشاركة،صندوق رسائل الظرفالنابض ([x] إرسال إشعارات البريد الإلكتروني،إرسال رسالة،تحديد الكل كمنجز، وبطاقات العبث/الوكيل)، مبدّل السمة،?(F1الدليل)، والإعدادات. - الشريط الجانبي الأيسر: بطاقة منفّذ
Matlockالموحّد،«المزامنة مع الوضع غير المرئي»كجسر ثنائي الاتجاه،إيقاف عند الخطأ وإشعار،إشعار،شريط حجم الملف(قرص ضبط النمطية)،+ إضافة بطاقة،المفضلةبالنجوم،الأوامر المتاحة/خطوات المشروعالمكتشفة تلقائياً، أوامرالآلة، والملاحظات. - الوسط والطرفية المدمجة المفتوحة دائماً: مكدس قائمة التحقق المُدار (
بدء العملية،إيقاف العملية،إعادة تشغيل الفاشل،تشغيل/تقرير صحة كود CIالقابل للطباعة عبرCtrl+P، صفوف المراحل، وصف FIFO في خط التشغيل) فوق طرفية مدمجة مفتوحة دائماً (Output وProblems وTests (N)وCoverage (N)، مع تثبيت التحديد كي لا يقفز النص أثناء التظليل، ومتابعة تلقائية + الانتقال للأحدث، وبحث، والتشغيل السريعCtrl+Kفي Pro، وشريط طرفية CLI مضمّن لتكتب وتضغطتشغيللأي أمر مثلgit statusأوgit pushأوwrangler deployداخل ماتلوك دون فتح PowerShell أوcmd.exe، ثم تنقرحفظ كبطاقةأوسلسلة وتنبيهبنقرة واحدة). - شريط القياس الأيمن: درجة ماتلوك الرقمية (
XX.X / 100.0) مع أشرطة التقدم الأفقية للدرجة الصحية وتغطية المنطق الحقيقية، وعدّاداتالاختبارات الناجحة/الأخطاء، وأعلى 3 إصلاحات، وأكبر الملفات غير المختبرة، ومخططالقيمة، وسجلات الاختبارات المحذوفة فيسلامة الاختبارات.
3. النصوص المكتشفة والفحوصات المخصصة والإجراءات والمفضلة بالنجوم
- النصوص المخصصة المكتشفة تلقائياً و6 قوالب مبدئية غير مهيأة: عند فتح مجلد، يكتشف ماتلوك الأوامر من
package.jsonوMakefileوCargo.tomlوpyproject.tomlوpubspec.yamlونصوص.bat/.ps1/.shفي مساحة العمل تحت الأوامر المتاحة (لا تُضاف للمفضلة تلقائياً أبداً — انقر نجمة لتثبيتها)، إلى جانب 6 قوالب مبدئية غير مهيأة مسبقة التزويد (GitHub، حفظ إلى وحدة USB / قرص، AWS / Google Cloud، إضافة لبطاقات الآلة حفظ، تحسين القرص، إيقاف التشغيل). ويفتح النقر على قالب غير مهيأ محرّره لإدخال نصك البرمجي — أو يمكن لوكيل MCP المتصل برمجته وتثبيته في المفضلة نيابةً عنك — وبمجرد تهيئته يعمل بضغطة واحدة. - الطرفية المدمجة والتعديل -> النص المصدري + Safeguard الثابت: اكتب أي أمر في شريط CLI بالطرفية المفتوحة دائماً وانقر
حفظ كبطاقة(بطاقة إجراء بضغطة واحدة) أوسلسلة وتنبيه(خطوة تسلسل مع إيقاف عند الفشل أو تنبيه بريدي)، أو انقر تعديل على أي بطاقة لعرض أو تعديل أمرها/نصها ومجلد عملها ومهلتها وخياراسألني قبل تشغيل هذاواحتساب الفشل ضد درجتي الصحيةومفتاحSafeguardالثابت ([LOCKED]للتنفيذ فقط للوكلاء مقابل[MODIFIABLE]القابل لتحسين الوكيل مع مراجعة فرق الأمر قبل/بعد في الظرف ليختار الإنسان قبول أو إرجاع). - إضافة فحص مخصص (
+ إضافة بطاقة -> فحص مخصص): أنشئ قاعدة البحث عن نص في الملفات (تعبير نمطي/حرفي) أو قاعدة تشغيل نص برمجي (exit 0= ناجح؛ ويُحلَّلfile:line:col: messageكنتائج) مع مستوى الخطورة (حرج،رئيسي،تحذير،معلومات)، محفوظة في مساحة التخزين المحلية الخاصة لملف المستخدم خارج مستودعك. - معالجة Windows
.batوrobocopy: يمنع إغلاقstdin(<nul) واحتواء مهام نظام التشغيل أي تعليق؛ وتُحوَّل%iذات السطر الواحد إلى%%i؛ وتُحتسب رموز خروجrobocopyمن0–7كـ ناجح (>= 8= فاشل).
4. روتينات العمل أثناء الغياب وأوامر الآلة والتنبيهات المحلية
- روتينات العمل أثناء الغياب وسلاسل الدفع/النشر المخصصة (
+ إضافة بطاقة -> تسلسلأوسلسلة وتنبيهفي الطرفية): اربط أكثر من 20 بطاقة على التوالي مع وضعMatlockأولاً افتراضياً، وخيار تشغيل هذه الخطوة دائماً حتى لو فشلت خطوة سابقة، وموافقة مسبقة واحدة اسألني قبل تشغيل هذا قبل الخطوة 1. وتشمل القوالب المبدئية فحص ليلي ونشر إلى Cloudflare ونسخ احتياطي وإيقاف التشغيل (إضافة لقوالب الوجهات السحابية والحاويات التي تستخدم أداة CLI المحلية لديك مع0بيانات اعتماد مخزنة؛ ولا تتضمن تشغيلات اختبارMatlockأيgit pushمدمج، بينما يضيف المستخدمون ووكلاء MCP بحرية بطاقات وسلاسل مخصصة لـgit pushأو النشر السحابي). - بطاقة الإشعار / تنبيه البريد (
إشعارأوالإعدادات -> تنبيهات البريد الإلكتروني— خطوة بخطوة): (1) أنشئ كلمة مرور تطبيق / رمز تفويض من 16 حرفاً من إعدادات أمان المصادقة الثنائية 2FA لحساب بريدك (لا تستخدم كلمة مرور الويب العادية عند تفعيل 2FA أبداً)، وافتحإشعارأوالإعدادات -> تنبيهات البريد الإلكتروني، وأدخل بريد المرسل/المستلم وكلمة مرور التطبيق / رمز التفويض (SMTP أصلي صادر فقط عبر TLS 1.2/1.3 مع التحقق من شهادات X.509،0وصول IMAP/POP3 لصندوق الوارد،0خوادم ترحيل لدى Dutch P2P؛ مع إعدادات جاهزة لـ Gmail / Workspace وMicrosoft 365 / Outlook وYahoo وiCloud وQQ / 163 برمز تفويض 16 حرفاً وZoho Global/EU/IN وFastmail وYandex وMail.ru وAliyun وGMX / Web.de مع تفعيل POP3/SMTP خارجي، وجسر Proton Mail المحلي127.0.0.1:1025؛ وتُختم بيانات الاعتماد في سلسلة مفاتيح النظام أو في الخزنة المحلية للحاوية المختومة بعبارة مرور) أو اختبرها بلا واجهة عبرmatlock-mcp send-alert --subject "..." --body "..."وانقراختبار البريد— أو اختر نصوصاً محلية مخصصة. (2) شغّل بطاقة الإشعار منفردة بنقرة واحدة في أي وقت. (3) ألحقها بأي سلسلة تسلسل عبرإيقاف وتنبيه(إطلاق عند الخطأ: يتوقف فوراً إذا فشل بناء/اختبار ويراسلك بالبريد) أومتابعة وتنبيه(always: بريد إتمام غير مشروط عند انتهاء السلسلة كاملة). الآلة(8 أوامر حاسوب قابلة للتعديل من المستخدم — لا تعمل تلقائياً أبداً):
| البطاقة | Windows | Linux | ملاحظات |
|---|---|---|---|
| إيقاف التشغيل خلال 30 دقيقة | shutdown.exe /s /t 1800 | shutdown -h +30 | مهلة 30 دقيقة، دون /f أبداً؛ مقترن بإلغاء الإيقاف |
| إلغاء الإيقاف | shutdown.exe /a | shutdown -c | إيقاف فوري بنقرة واحدة |
| تنظيف الملفات المؤقتة | مجلد المؤقت للمستخدم فقط، يتخطى الملفات النشطة | ملفات المستخدم الأقدم من يوم في ~/.cache و/tmp | لا يمس ملفات المشروع أبداً |
| فحص مساحة القرص | Get-PSDrive -PSProvider FileSystem | df -h | للقراءة فقط |
| تحسين القرص (تجزئة أو trim) | Optimize-Volume -DriveLetter C -Verbose | fstrim -av | يتطلب صلاحيات مدير/جذر؛ يتوقف بنظافة دون مطالبات UAC/sudo |
| نسخة احتياطية | robocopy . "<backup-folder>" /MIR | rsync -a --delete ./ "<backup-folder>/" | يبقي .git ويتخطى مخازن البناء المؤقتة؛ robocopy 0–7 = ناجح |
| ابحث عن كلمة واكشفها | findstr /s /i /m /c:"Aluminium" *.dart | grep -rnI "Aluminium" --include="*.dart" . | بحث متكرر قابل للتعديل غير حساس لحالة الأحرف |
| صيد الأسطر فوق 250 | for /r %i in (*.dart) do ... find /c /v "" | find . -name "*.dart" -exec awk '... c>250 ...' {} + | فحص للقراءة فقط يسرد الملفات التي تتجاوز 250 سطراً |
5. شلال النتائج وإعادة التشغيل المعزولة والتجاهل والنسخ للوكيل
- شلال الفئات الأكثر أخطاءً أولاً: تترتب فئات الفحص تلقائياً بوضع أعلى أعداد الأخطاء النشطة في الأعلى كي تظهر العناقيد الحرجة أولاً دون التمرير فوق الفحوصات النظيفة.
- التظليل للنسخ وإعادة التشغيل المعزولة للفئة: ظلّل أي نص نتيجة بالسحب للنسخ مباشرة، أو انقر مشاركة للوكيل / نسخ (
Ctrl+Shift+C) للحصول علىfolder/file:line+[MITRE CWE-*]/[POSIX-*]+ وصفات فرق موحدة من 5 أسطر، أو انقر زر إعادة التشغيل الخاص بالفئة لإعادة فحص تلك الفئة وحدها خلال أجزاء من الثانية (شارة تقدير?حتى تشغيلMatlockالكامل). - تجاهل خماسي النطاقات خارج المستودع (
المتجاهَل (N)): جنّبfile:line:codeأوfile:codeأو*:codeأوfileأوfolder/(0خصم من الدرجة، مع استعادة / استعادة الكل بنقرة واحدة، وخيار إرسال وتجاهل للإنذار الكاذب). ولا تسكت تعليقات الكود المضمّنة (// ignore:،/* nolint */،# noqa،@ts-ignore) ماتلوك أبداً، ولا يملك الوكلاء أي أدوات MCP لكتابة التجاهلات.
6. حماية Safeguard الثابتة المقاومة للعبث وسلامة الاختبارات والاستعادة
- لماذا تهم حماية Safeguard: تُجمَّع الفحوصات المدمجة داخل الملف التنفيذي الأصلي، ويختم Safeguard اختبارات المستخدم والنصوص المكتشفة/المخصصة والإجراءات والروتينات والتنبيهات (
[LOCKED]/للقراءة والتشغيل فقط— للتشغيل فقط عبرmatlock_run_action/matlock_run_sequence، بينما تتيح بطاقات[MODIFIABLE]للوكلاء تحسين النصوص وإرسال فرق الأمر إلى الظرف للمراجعة). - الإرجاع التلقائي الحتمي وتنبيه الظرف النابض: إذا عدّل وكيل ذكاء اصطناعي أو أداة خارجية اختباراً أو نصاً مختوماً بـ Safeguard دون تفويض، يستعيد ماتلوك حتمياً الملف الأصلي المختوم (مع حفظ نسخة تراجع احتياطية خارج المستودع)، وينبض الظرف في الشريط العلوي بـ
[تنبيه ماتلوك] تم تعديل اختبار حرج: <test_name>، ويحظر التشغيلات بلا واجهة (exit 65). - سلامة الاختبارات والاستعادة بموافقة شخص: ترفع الاختبارات المحذوفة أو المتخطاة أو المُضعَفة سجلات مراجعة اختبارات محذوفة دائمة تحجز جاهز للدفع حتى يحدد شخص حسناً، أنا فعلت ذلك أو مشبوه أو يستخدم الإعدادات -> Safeguard والاستعادة -> السماح لماتلوك باستعادة الاختبارات (معاينة الفروق + نسخة تراجع). وتكتب المزامنة بين أجهزتي (Pro) ملفات سلامة
<computer-id>.matlock-syncمختومة بعبارة مرور (0كود مصدري،0اتصالات شبكة).
7. أشرطة الدرجة الصحية الأفقية والتغطية ومعيار النمطية
- الدرجة الرقمية وأشرطة التقدم الأفقية: تعرض
XX.X / 100.0(--قبل أول تشغيل) مقترنةً بأشرطة تقدم أفقية لـ الدرجة الصحية وتغطية المنطق الحقيقية التي تحتسب منطق الإنتاج غير المختبر مع استثناء النصوص المولدة آلياً. وتضع إخفاقات البناء أو التبعيات أو الاختبارات سقفاً للدرجة دون مستوى الجاهزية للنشر؛ بينما يكونالتنسيقللإبلاغ فقط (0خصم من الدرجة). - قرص ضبط النمطية المخصص للإنسان فقط (
CWE-1080/CWE-1120): يُضبط عبرشريط حجم الملففي الشريط الأيسر أوالإعدادات -> المشروع والمنفّذ(*وفق معيار Grade C. يمكنك التعديل في الإعدادات، مختوم في إعدادات النظام،0ملفات في المستودع،0صلاحية كتابة عبر MCP):Grade A (<= 60 / <= 25 fn)،Grade B (<= 100 / <= 40 fn)،Grade C (<= 250 / <= 80 fn)[افتراضي]،Grade D (<= 500 / <= 120 fn)، أوMinimum (<= 1000 / <= 250 fn). - حكم
جاهز للدفع: يتطلب درجة جاهزة للشحن مع0نتائج حرجة، ونجاح مراحل البناء والاختبار، و0سجلات اختبارات محذوفة مفتوحة، وتغطية غير مؤقتة.
8. الإعدادات ذات العمودين واستعادة الحالة المختومة
انقر الإعدادات في الشريط العلوي لفتح نافذة العمودين (شريط فئات أيسر + عناصر تحكم موجزة؛ يتضمن رأس كل لوحة أيقونة ? تقفز مباشرة إلى قسمها في الدليل):
المظهر: اللغة (9 لغات + لغة النص المنسوخ)، السمة (افتراضي النظام،فاتح،أردوازي داكن)، اختصار سطح المكتب، وخيار Windows التصغير إلى شريط النظام عند الإغلاق.المشروع والمنفّذ: قرص ضبط النمطية (Grade A..Minimum)، وفتح المجلدللملف الشخصي المحلي الخاص بالنظام، واستعادة شريط الإعداد المبدئي(يعيد فتحأعدّه لي)، والاحتفاظ بسجل التشغيل السريع، وإعادة تعيين سجل التجاهلات.Safeguard والاستعادة:السماح لماتلوك باستعادة الاختبارات، ومبدّل الإرجاع التلقائي لـ Safeguard المخصص للإنسان فقط، والمزامنة بين أجهزتي(مزامنة مجلد مختومة بعبارة مرور).تنبيهات البريد الإلكتروني: محطة تنبيهات البريد الصادر فقط والنصوص المخصصة المحلية +اختبار البريد.وكيل الذكاء الاصطناعي (MCP): مبدّلخادم MCP (stdio)(متوقف افتراضياً)، وجسر«المزامنة مع الوضع غير المرئي»ثنائي الاتجاه (تحديث بنقرة واحدة يحمل بطاقات/تسلسلات الوكيل وينشر الأوامر القائمة مع0استطلاع بالخلفية)، واختبار اتصال MCP، ونسخ إعدادات MCP وتعليمات الوكيل، ونسخ سؤال لهاتفي الذكي، وجسر بريد الوكيل.الترخيص والتحديثات: مفتاح الـ 24 حرفاًتفعيل/نقل الترخيص إلى هذا الجهاز،التحقق التلقائي من التحديثات(MATLOCK_OFFLINE=1يحجب كل الاتصالات الصادرة)،إرسال تشخيصات الأعطال المجهولة(متوقف افتراضياً؛MATLOCK_NO_TELEMETRY=1)،نسخ معلومات التشخيص،تحرير الذاكرة،مشاركة ماتلوك،تواصل معنا(dutch@dutchp2p.com)، وأدوات Dutch P2P.- استعادة الحالة المختومة (
إعادة تعيين سجل التجاهلات): إذا أطلقت تعديلات خارجية رمزintegrity_seal:MUTE_SEAL_TAMPEREDأوstorage_recovery:BAK_AUTO_RESTORE، افتحالإعدادات -> المشروع والمنفّذ -> التخزين والنسخ الاحتياطي -> إعادة تعيين سجل التجاهلات.
9. ربط وكلاء الذكاء الاصطناعي (MCP سطح المكتب ودليل الهاتف/الدردشة)
- كيفية الربط عبر
stdioالمحلي و«المزامنة مع الوضع غير المرئي»(0منافذ مفتوحة): افتحالإعدادات -> وكيل الذكاء الاصطناعي (MCP)، وفعّلخادم MCP (stdio)، وانقرنسخ إعدادات MCP وتعليمات الوكيل(أونسخ دليل MCP للوكيلداخل?)، وانقر«المزامنة مع الوضع غير المرئي»في أي وقت (في الإعدادات أو الشريط الأيسر) لتحميل البطاقات التي أنشأها الوكيل ونشر الأوامر القائمة ثنائياً:
{
"mcpServers": {
"matlock": {
"command": "matlock.exe",
"args": ["mcp", "--stdio"]
}
}
}
- دعم عالمي للعملاء والمُشغِّلات والدردشة: شغّل دون إعداد مسبق عبر
npx -y @dutchp2p/matlock-mcpأوuvx matlock-mcp؛ ويعمل عبر VS Code وCursor وClaude Code/Desktop وAntigravity وGemini CLI وCopilot وCodex وWindsurf وJetBrains/Junie وTrae وLingma وMarsCode وCodeGeeX وBaidu Comate وTencent CodeBuddy وZed وCline وRoo Code وContinue وAider وGoose وOpenHands وDevin وReplit Agent وSourcegraph Amp وKimi وQwen وDeepSeek وDoubao وMiniMax ووكلاء Ollama/vLLM/SGLang/LM Studio المحليين. ويستدعي الوكلاء المتصلونmatlock_read_appliance_manual(section_id, locale)برصيد0(9 لغات)، أو الصق https://matlock.dutchp2p.com/ar/manual.md / https://matlock.dutchp2p.com/llms.txt في أي دردشة ذكاء اصطناعي على الهاتف أو المتصفح. وللاطلاع على أحدث بيئات التطوير وأنظمة الوكلاء ومنصات الحاويات، راجع تعليمات التوافق الحية على https://matlock.dutchp2p.com/ar/docs.html.
10. مرجع المعايير المدمجة (10 بيئات + Pre-CI)
كل فحص مدمج مُجمَّع داخل ماتلوك ومرتكز على MITRE CWE وCISA SSDF (NIST SP 800-218) وIEEE Std 1003.1 POSIX وبوابات Pre-CI والضوابط التقنية لـ AICPA SOC 2 Trust Services Criteria:
| البيئة والمجال | ما يفحصه ماتلوك وأعطال الإنتاج التي يمنعها |
|---|---|
| الأساس متعدد اللغات وDart / Flutter | كتل catch الصامتة (CWE-391)، مخاطر الفارغ/الحدود (CWE-476/CWE-125)، سباقات async غير المنتظرة، تسريبات التدفقات/المؤقتات/المتحكمات (CWE-401)، حلقات إعادة المحاولة اللانهائية (CWE-835)، الأسرار المضمنة (CWE-798)، أسرار السجلات غير المنقّحة (CWE-532)، تعطيل تحقق شهادات TLS عبر HTTP/SMTP/CLI/CI (CWE-295 / [MITRE T1557])، حقن SQL (CWE-89)، وSSRF (CWE-918)، وXXE (CWE-611)، ورموز JWT غير الموقّعة (CWE-347)، وإعادة التوجيه المفتوحة (CWE-601)، نقص المهل، الكتابات غير الذرية، اختراق المسار (CWE-22)، والاختبارات الجوفاء/المتقلبة (CWE-362). |
Java (.java) | المفاتيح المضمنة (CWE-798)، حقن الأوامر/SQL (CWE-78/CWE-89)، إلغاء التسلسل غير الآمن (CWE-502)، التشفير الضعيف (CWE-327)، الاستثناءات المبتلعة (CWE-391)، تسريب مقابض JDBC/التدفقات (CWE-404)، أخطاء == للنصوص، إيقاف System.exit المفاجئ، والنوم داخل الحلقات. |
Python (.py) | الأسرار المضمنة (CWE-798)، حقن الصدَفة/SQL (CWE-78/CWE-89)، تحميل pickle/yaml غير الآمن (CWE-502)، التجزئات الضعيفة (CWE-328)، except المجرد (CWE-391)، الوسائط الافتراضية القابلة للتعديل، تسريبات المواصفات (CWE-775)، النداءات المتزامنة داخل async def، والاختبارات الجوفاء. |
Rust (.rs) | الأسرار المضمنة (CWE-798)، سلاسل الصدَفة/SQL المنسقة (CWE-78/CWE-89)، تحويلات unsafe غير المحروسة، تعطيل فحوصات TLS (CWE-295)، هلع .unwrap()/todo!() في الإنتاج، النوم الحاجز في مهام async، التسريبات المتعمدة (CWE-401)، تجاهل Result، والاختبارات الجوفاء. |
Go (.go) | الرموز المضمنة (CWE-798)، دمج exec/SQL (CWE-78/CWE-89)، InsecureSkipVerify (CWE-295)، مولّد عشوائي ضعيف (CWE-330)، تجاهل الأخطاء (CWE-252)، تسريبات defer في الحلقات والسياقات غير الملغاة (CWE-404)، غياب مهل HTTP، panic في الإنتاج، والاختبارات الجوفاء. |
TypeScript وJavaScript (.ts و.tsx و.js و.jsx) | الأسرار المكشوفة (CWE-798)، مصارف DOM XSS / eval (CWE-79/CWE-95)، تضمين الصدَفة (CWE-78)، تلوث النموذج الأولي (CWE-1321)، .catch() الفارغة (CWE-391)، كتم الأنواع، أخطاء مقارنة NaN، توقفات I/O المتزامن، بقايا debugger، وتسريبات المستمعات/المؤقتات (CWE-401). |
C وC++ (.c و.cpp و.cc و.h و.hpp) | الأسرار المضمنة (CWE-798)، نسخ FFI/المخزن غير المحروس (CWE-787/CWE-120)، أخطاء سلاسل التنسيق (CWE-134)، حقن system() (CWE-78)، عدم تطابق new[]/delete (CWE-762)، الاستخدام بعد التحرير (CWE-416)، المدمّرات الرامية، memset على أنواع غير بدائية، والخيوط غير المضمومة. |
Kotlin وAndroid (.kt و.kts) | الأسرار المضمنة (CWE-798)، دمج SQL (CWE-89)، جسور WebView غير الآمنة، تجاوز TLS (CWE-295)، التفضيلات المقروءة للجميع (CWE-276)، تسريب coroutines من GlobalScope (CWE-401)، توقفات الخيط الرئيسي، انهيارات !!، ابتلاع CancellationException، ومخاطر ترويسة ZIP/APK (CWE-190). |
C# و.NET (.cs) | مقابض IDisposable غير المصرفة (CWE-404)، فخاخ انهيار async void، سلاسل SQL/الأوامر غير المعامَلة (CWE-89/CWE-78)، تعطيل فحوصات TLS ServerCertificateCustomValidationCallback (CWE-295)، الاستثناءات المبتلعة (CWE-391)، جمود .Result/.Wait() المتزامن، والاختبارات الجوفاء. |
SQL ومحركات التخزين (.sql) | صلاحيات البطاقة الشاملة (CWE-250)، دمج SQL الديناميكي (CWE-89)، كلمات مرور نصية في DDL (CWE-256)، إجراءات هروب صدَفة النظام (CWE-78)، تعطيل RLS، أوامر DELETE/UPDATE بلا شرط، ترحيلات غير متكررة الأثر، مسوحات OFFSET العميقة، وأقفال الجداول غير المحروسة. |
ما قبل CI العابر للأنظمة وBash/Shell (.sh) وPowerShell (.ps1) وDockerfile وGitHub Actions YAML | تعارض حالة أحرف المسارات (POSIX.1)، سطور CRLF في shebang، تعابير Bash/POSIX غير المتوافقة وفخاخ $ErrorActionPreference / LASTEXITCODE في PowerShell، وسوم Dockerfile غير المثبتة ومخاطر حاوية root، تجاوز ميزانية بايتات HTML/الأصول، فخاخ تشغيل .cmd/.bat المجرد في Windows، المقابض المسربة وإنهاءات غير شجرية (CWE-775)، فواصل المسارات الصلبة، الاستيرادات غير المتتبعة، انحراف ملفات القفل، صلاحيات GitHub Actions YAML غير المقيدة، حقن نصوص سير العمل، وفقدان بت +x. |
| النمطية والفحوصات المخصصة | قرص ضبط النمطية المخصص للإنسان فقط (Grade A <= 60 إلى Minimum <= 1000، الافتراضي Grade C <= 250 ملف / <= 80 دالة؛ CWE-1080 / CWE-1120) مع فحوصات الأنماط والنصوص المعرفة من المستخدم في ملف النظام. |
11. ترخيص محطة العمل Pro ومعاينة الويب وفحص المتصفح المجاني
- Unlimited Workstation Pro (حوالي 92 درهم إماراتي* ($24.99 USD/year)، بلا حسابات): يفتح مركز قيادة سطح المكتب كاملاً (
1حاسوب نشط، حد أقصى1نقل عتاد/سنة عبرنقل الترخيص إلى هذا الجهاز) إضافة لتشغيلات محلية وبلا واجهة غير محدودة بسعر$0.00/تمريرةطوال عام كامل. انقرترقيةفي سطح المكتب (أو زر https://matlock.dutchp2p.com/ar/pricing) للدفع بالبطاقة (أو بالعملات المستقرة الدولارية الفورية / PayPal عبرSolana USDCوPayPal PYUSDوBase USDCوPolygon USDCأو عبر MoonPay وTransak)، وانسخ مفتاح الـ 24 حرفاً +/receipt/<id>، وفعّله فيالإعدادات -> الترخيص والتحديثات. يشمل سطح المكتب المجانيMatlockوتقرير صحة كود CI(مع مجاملة الأسرار) وشريط حجم الملفوالملاحظاتواستعادةالمتجاهَل؛ ويفتح Pro الإجراءات والمفضلة بالنجوم والروتينات وأوامر الآلة والتشغيل السريع (Ctrl+K) وأيقونة تجاهل العين وإحداثياتfile:line:colالدقيقة غير السرية. - مركز القيادة على الويب وفحص المتصفح المجاني: يفحص https://matlock.dutchp2p.com/ar/#wasm-instant-audit المجلدات المحلية (
0اتصالات شبكة) أو روابط مستودعات GitHub العامة الاختيارية (تُجلب مباشرة بين متصفحك وapi.github.com/raw.githubusercontent.comمع مرور0بايت عبر Dutch P2P؛ والأسعار بصيغة Markdown على/ar/pricing.md) في ذاكرة المتصفح مع أمر خدمة تشخيصي قابل للطباعة. ويعاين https://matlock.dutchp2p.com/ar/app التخطيط النهاري/الليلي الهادئ وأشرطة الدرجة/التغطية الأفقية ومنفّذMatlockالموحّد وشريط طرفية CLI المدمج (تشغيل/حفظ كبطاقة/سلسلة وتنبيه) ونسخ هذه البطاقة كنص برمجيولصق مخرجات تشغيلك->تلوينها(وتميّز عبارةفي تطبيق سطح المكتب فقطالعناصر الأصلية).
12. Linux وGoogleBook والتحديثات والخصوصية والدعم
- التثبيت على GoogleBook وLinux: على GoogleBook، فعّل الإعدادات -> المطوّرون -> بيئة تطوير Linux، وثبّت
matlock-linux-x64.deb، واحتفظ بالمستودعات النشطة فيLinux filesالأصلية ($HOMEext4) للسرعة. وعلى Linux، ثبّت.deb(sudo apt install ./matlock-linux-x64.deb) أوchmod +x matlock-linux-x64.AppImage(--appimage-extract-and-runمدعوم دونlibfuse2). - إيقاف العمليات والتحديثات وإلغاء التثبيت: ينهي
إيقاف(Ctrl+./Esc) شجرة عمليات النظام بأكملها (0عمليات زومبي) ويحرر أقفال منع السكون (أبقِ غطاء الحاسوب المحمول مفتوحاً خلال السلاسل الطويلة). تُحدَّث نسخة Windows عبر Microsoft Store ويتحققAppImageمنSHA-256ذرياً مع حفظ 100% من حالة الملف الشخصي المحلي. وإلغاء التثبيت عبر التطبيقات المثبّتة /apt remove matlock/ حذف ملفAppImage. الدعم:dutch@dutchp2p.com.
الجزء الثاني: المواصفات التشغيلية للآلة والوكلاء المستقلين
A. نقاط دخول الوكيل وإعداد النقل
- النقل:
stdioJSON-RPC 2.0 محلي (0منافذ TCP/UDP مفتوحة،0مآخذ HTTP localhost). - سطر أوامر الرفيق لسطح المكتب:
matlock.exe mcp --stdio(Windows) ·matlock mcp --stdioأو/path/to/matlock-linux-x64.AppImage mcp --stdio(Linux وGoogleBook). - المحرك الخالي من العرض، وإعداد الحاوية بسطرين، والتوجيه الاستباقي للتنبيهات:
npx -y @dutchp2p/matlock-mcpأوuvx matlock-mcpأو خطافsetupبسطرين للحاوية (agent-install.sh+matlock-mcp toolbag --json) (لبيئات CloudflareContainerHarness/Codexcloudflare/debian-trixieوDocker وE2B وFirecracker) أوmatlock-mcp --stdio --headless --no-coverageعلى Linuxx64وWindowsx64وmacOSarm64(https://matlock.dutchp2p.com/ar/agents · التوافق الحي لبيئات التطوير والحاويات: https://matlock.dutchp2p.com/ar/docs.html؛ يعرض تعليقاتreadOnlyHint: trueوقوائمprompts/list:matlock-verify-before-pushوmatlock-fix-top-findingsوmatlock-setup-action-chain). وفي أول جلسة--headlessممولة عندما لا يكون هناك تنبيه بريد صادر مهيأ بعد، يصدر ماتلوك تلميح تأهيل غير حاجب لمرة واحدة كي يسأل الوكيل المستخدم مرة واحدة عمّا إذا كان يريد إعداد تنبيهات البريد عند الإتمام/الخطأ عبرmatlock_set_alert(مختومة في سلسلة مفاتيح النظام أو في الخزنة المحلية للحاوية المختومة بعبارة مرور عبرMATLOCK_VAULT_PASSPHRASE)، ولا يتكرر بعد الإجابة أو التجاهل:
{
"mcpServers": {
"matlock": {
"command": "matlock-mcp",
"args": ["--stdio", "--headless", "--no-coverage"]
}
}
}
B. القياس ووصول الأسراب M2M وفتح Pro
- صفر تمريرات مفتوحة مجانية وإثبات قيمة
HTTP 402في< 50ms: يعملIndex 0matlock_run_scan(target_path)غير الممول محلياً خلال< 50ms(0رفع سحابي،0حظر للإيداع) ويعيد الدرجة الصحية الدقيقة0.0–100.0وأعداد الخطورة وفئات CWE المنتهكة ووسومMITRE ATT&CKT*وحساباتast_token_savingsالحية (0أسماء ملفات،0إحداثيات سطر/عمود،0رقع فروق). وبعد كل خصم1رصيد مدفوع على مساحة العملW، تعمل حتى3فحوصات تغييراتchanged_only: trueعلى نفس مساحة العمل خلال10دقائق دون استهلاك رصيد إضافي. - فتح ثنائي المسار بلا احتكاك: المسار A (محفظة الوكيل ذاتية الحفظ) — فتح الوصول المقاس M2M لأسراب الوكلاء المستقلين عبر Solana USDC أو Solana PYUSD أو Base USDC أو Polygon USDC من خلال
matlock_run_scan(target_path, transaction_signature)أوmatlock_purchase_license(transaction_signature)(انظر كتالوج وكلاء MCP علىhttps://matlock.dutchp2p.com/ar/agentsو/agents.mdللأدوات بلا واجهة وتسعير الأسراب). المسار B (جسر الدفع البشري) — مشاركة رابط إتمام الشراء العائد من402(/ar/pricing.md) ليفتح المطور حوالي 92 درهم إماراتي* ($24.99 USD/yr) Unlimited Workstation Pro (matlock_purchase_license(license_key)أوmatlock-mcp activate <KEY>لتشغيلات غير محدودة بسعر$0.00/تمريرة). يخرج CLI بلا واجهة بالرمز77(EX_NOPERM) عند402وبالرمز65(EX_DATAERR) عند العبث بـ Safeguard/الختم.
C. فهرس MCP المحلي الكامل بـ 27 أداة
matlock_run_scan(target_path?, changed_only?, dedup_by_rule?, if_none_match?, agent_id?, rule_id?, category?, pillar?, file_filter?, include_generated?, compact?, cursor?, rule_code?, transaction_signature?): فحصIndex 0(readOnlyHint: true) في< 50msلـ AST وCWE وPOSIX وما قبل CI يعيدfile:line:col(col >= 1) وcweوmitre_attackووصفات فرق موحدة من 5 أسطر (يدعم أيضاً CLImatlock-mcp scan . --format=sarifلـSARIF 2.1.0).matlock_describe_project(target_path?, mode?): ملف تعريف اختياري لمساحة العمل (0رصيد،readOnlyHint: true)؛ مرّرmode: "tool_bag"(أو CLImatlock-mcp toolbag [--json]) للحصول على جرد تدريجي بحجم~350–550رمزاً لبطاقات الإجراءات والتسلسلات[LOCKED](تنفيذ فقط) مقابل[MODIFIABLE](قابلة لتحسين الوكيل) وشارات[NEW]/[UPDATED]وعلامات[UNAVAILABLE IN CONTAINER]والأوامر القائمة وجاهزية التنبيه الصادر.matlock_get_scan_results(target_path?, cursor?, pillar?, rule_code?): نتائج مرقّمة (25/صفحة؛ يخفي سطح المكتب السطور المحمية بـ Safeguard حتى الفتح؛ ويفتح خزان الوقود--headlessالإحداثيات).matlock_qualify_test(file | files, target_path?, dry_run?, baseline_only?, wait_if_busy?, max_wait_seconds?): يتحقق من 1–5 ملفات اختبار (test_file/test_files) عبر 3 بوابات (نجاح التشغيل مع>= 1تحقق،0تحذيرات محلل + سقف الأسطر،0نتائج ماتلوك) قبل الختم في Safeguard، أو يختم خط أساس (baseline_only: true).matlock_get_test_integrity(target_path?, reverify?, include_archive?, id?, include_text?, note_for_id?, note?): يفحص سجلات سلامة الاختبارات المحذوفة ويضيف ملاحظات تفسيرية للوكيل (0حقوق إغلاق).matlock_get_history(target_path?, limit?): سجل الدرجات وأعداد الإصلاحات للقراءة فقط.matlock_read_appliance_manual(section_id?, standard_id?, query?, locale?): الدليل دون اتصال (9 لغات) واستعلام معايير CWE/POSIX/SSDF/SOC2/النتائج (0رصيد،0شبكة).matlock_list_custom_tests: يسرد الفحوصات المخصصة للمستخدم.matlock_register_custom_test: يحفظ فحصاً مخصصاً بنمط أو نص برمجي.matlock_delete_custom_test: يحذف فحصاً مخصصاً غير مقفل (الفحوصات المدمجة غير قابلة للتعديل).matlock_list_actions: يسرد بطاقات الإجراءات (مع راياتfavorite/القفل/الموافقة) إضافة لـrecommendedTemplatesغير المهيأة (unconfiguredTemplate: true).matlock_register_action(id, command, name?, favorite?): يبرمج أو يحدّث إجراءً غير مقفل أو قالباً مبدئياً (tpl_githubوtpl_save_driveوtpl_cloud_syncوtpl_save_backupوtpl_defrag_optimizeوtpl_shut_down)، ويزيلunconfiguredTemplate، ويثبت/يزيل التثبيت في المفضلة (favorite: true | false)، ويفرض يتطلب موافقة على سطح المكتب.matlock_register_sealed_script: يختم أوامر البناء/الاختبار (مقفل من المستخدم) ضد تعديلات الوكلاء الفرعيين.matlock_run_action(id, working_dir?, async?, send_alert?, cold_box?): ينفذ أمراً معزولاً ضمن احتواء شجرة مهام نظام التشغيل (async: trueللتشغيل الخلفي غير الحاجب،send_alert: "always" | "on_error" | "never"، مع دعم بطاقاتgit pushوUSBrobocopy/rsyncوR2/S3/GCS/Azure المخصصة؛ و0أوامرgit pushمدمجة داخل تشغيلات اختبارMatlock).matlock_get_action_status(id?): يستطلع الحالة الحية ورمز الخروج وكبسولات الحالة المضغوطة لتشغيلاتasync: trueالخلفية.matlock_stop_action(id?, stop_sequence?): ينهي شجرة العمليات النشطة فوراً (stop_sequence: trueيوقف تسلسلاً نشطاً كاملاً بنظافة).matlock_delete_action: يحذف بطاقة إجراء غير مقفلة.matlock_list_sequences: يسرد الروتينات متعددة الخطوات.matlock_register_sequence(id, name?, step_ids?, commands?, insert_step_id?, insert_command?, insert_step_name?, insert_at_index?, remove_step_index?, failure_policy?, always_run?, favorite?): يؤلف أو يعدّل تسلسلاً غير مقفل على التوالي، مع إدراج أي إجراء أو خطوةalert::<id>في فهرسinsert_at_indexيبدأ من0معfailure_policy("stop" | "stop_and_alert" | "continue_and_alert") وalways_runوfavorite: true | false.matlock_run_sequence(id, file?, async?, send_alert?, cold_box?, deep?, include_coverage?): يشغّلseq_matlockأوseq_fast_verify(مرّرfileلتشغيل ملف اختبار واحد، وasync: trueللتنفيذ غير الحاجب مع إفاقة تلقائية عند الانتهاء، وsend_alertلإشعارات الخطأ/الإتمام؛ الافتراضيcold_box: falseللسرعة؛ وcold_box: trueصندوق عزل حدودي قبل الحفظ الخارجي أو المزامنة السحابية أو النسخ الاحتياطي أو الدفع أو الترجمة، يعود في< 15msعند التحقق ويستبدل15,000–40,000رمز فحص يدوي بأقل من< 300رمز إحداثيات؛ وdeep: trueيفرض تنظيفاً كاملاً وإعادة معايرة التغطية).matlock_delete_sequence: يحذف روتيناً غير مقفل.matlock_list_alerts: يسرد قنوات التنبيه المحلية (مع حجب الأسرار).matlock_set_alert: يهيئ تنبيهات Dart TLS 1.2/1.3 الأصلية الصادرة فقطemail_smtp(إعدادات جاهزة عالمية، سلسلة مفاتيح النظام أو الخزنة المحلية للحاوية المختومة بعبارة مرور) أوcustom_script.matlock_trigger_alert(id, status, task_completed, uncovered_issues, next_move): يرسل إشعاراً محلياً مع مصافحة الأسئلة الـ 3 الإلزامية.matlock_delete_alert: يحذف بطاقة تنبيه غير مقفلة.matlock_purchase_license(transaction_signature?, license_key?, target_path?, network?, runs?, lid?): يسوّي المخصصات المقاسة لأسراب الوكلاء المستقلين (انظر/ar/agents) أو يطالب بمفتاح Pro من 24 حرفاً بسعر حوالي 92 درهم إماراتي* ($24.99 USD/yr).matlock_report_issue(category, subject, description, tool_context?, output_dump?): تقرير ملاحظات/قائمة أمنيات منقّح غير متزامن (0رصيد،CONTINUE_IMMEDIATELY).
D. صندوق العزل الحدودي Cold Box وحاكم الحلقات الـ 3 ومصافحة الأسئلة الـ 3
cold_box: trueعند الحدود فقط (OFFافتراضياً): يعتمدmatlock_run_sequenceافتراضياًcold_box: falseلحلقات التكرار السريعة في المكان (0تقليص ثابت لأنوية المعالج). مرّرcold_box: true(id: "seq_matlock") قبيل الدفع الخارجي عبر git أو الحفظ السحابي أو النسخ الاحتياطي القابل للإزالة أو بناء ملف الإصدار التنفيذي للتحقق داخل نسخة$TEMPمعقّمة (CI=true، إغلاقstdin، تدقيق المقابض/العمليات اليتيمةCWE-775).- قاطع الحلقات ثنائي المستوى ومصافحة الأسئلة الـ 3 الإلزامية: يحدد المستوى 1 سقف حلقات الإصلاح المتعثرة المتتالية لقاعدة/ملف عند 3، ليعيد
STOP_IMMEDIATELY(مهمة هدف واحد) أوSKIP_AND_MOVE_ON(سباق متعدد الملفات)؛ ويوقف المستوى 2 الجلسة عند تعثر 2 منطقتين متخطاتين في جلسة واحدة، ليعيدHALT_FOR_REPLACEMENT(loopGovernorDirective: "STOP_AND_ALERT_USER") ويكتب ملفsession_handoff.jsonالمنقّح من الأسرار بأقل من< 200رمز لتوجيه وكيل بديل جديد إلىagents.mdوهدف التسلسل النشط (agent_id/MATLOCK_AGENT_IDيعزل عدادات العمال المتزامنين). ويجب على الوكلاء عند استدعاءmatlock_trigger_alertتزويدtask_completedوuncovered_issues(وليس"None"أبداً) وnext_move.
E. المواصفة القابلة للقراءة آلياً لوكلاء البرمجة بالذكاء الاصطناعي (YAML)
product: "Matlock — Agent & Developer Tools. (Efficient. Exact. By the book.)"
pinned_version: "v1.0.0+1"
web_command_center: "https://matlock.dutchp2p.com/ar/app"
free_local_scan: "https://matlock.dutchp2p.com/ar/#wasm-instant-audit"
docs_hub: "https://matlock.dutchp2p.com/ar/docs"
online_manual: "https://matlock.dutchp2p.com/ar/manual"
public_repository: "https://github.com/Dutchp2p/matlock-public"
online_operational_map: "https://matlock.dutchp2p.com/llms.txt"
mcp_resource_uri: "matlock://help/appliance-manual"
mcp_stdio_command: "npx -y @dutchp2p/matlock-mcp | uvx matlock-mcp | matlock.exe mcp --stdio (Windows) | matlock mcp --stdio (.deb) or /path/to/matlock-linux-x64.AppImage mcp --stdio (Linux & GoogleBook) | matlock-mcp --stdio --headless --no-coverage (Linux x64, Windows x64 & macOS arm64)"
network_ports: 0
git_hooks_installed: 0
builtin_git_push_in_test_runs: false
custom_push_deploy_actions_allowed: true
mcp_tools_count: 27
primary_pipeline:
card: "Matlock"
sequence_id: "seq_matlock"
entry_tool_index_0: "matlock_run_scan"
badge_svg_url: "https://matlock.dutchp2p.com/badge/verified.svg"
stages: "Clean -> Get -> Format -> Lint -> Analyze/Compile -> Test -> Coverage (depth 0..2)"
cold_box_default: false
cold_box_boundary_triggers: ["before external git push", "before cloud-drive save", "before removable backup", "before release compile"]
modularity_tuning_dial:
person_only_sealed_os_settings: true
default_tier: "Grade C (<= 250 / <= 80 fn)"
tiers: ["Grade A (<= 60 / <= 25 fn)", "Grade B (<= 100 / <= 40 fn)", "Grade C (<= 250 / <= 80 fn)", "Grade D (<= 500 / <= 120 fn)", "Minimum (<= 1000 / <= 250 fn)"]
ignore_scopes_5: ["file:line:code", "file:code", "*:code", "file", "folder/"]
lock_governance:
safeguarded: "Read & Run Only (auto-reverts unauthorized edits + Envelope tamper alert)"
unlocked: "AI agent can modify (Read, Write, Modify & Run)"
os_storage:
scope: "private_user_profile_outside_repo"
env_override: "MATLOCK_STATE_DIR"
F. مبادئ تشغيل الوكيل وحدود التنفيذ
- المبدأ 1 (منع إضعاف الاختبارات أو الكتم): لا تحذف الاختبارات أو تضعف التحققات أو تحقن تعليقات كتم مضمنة (
// ignore:أو/* nolint */أو# noqaأو@ts-ignore) أبداً؛ ففعل ذلك يرفع سجلات سلامة الاختبارات المحذوفة، ويرجع الملفات المحمية بـ Safeguard، ويوقف التشغيلات بلا واجهة (exit 65). - المبدأ 2 (ثبات Safeguard وفصل الاختبار عن الدفع): عناصر Safeguarded للقراءة والتشغيل فقط، ولا يثبّت ماتلوك
.git/hooks/*أبداً، ولا يقومMatlock(seq_matlock) بالإيداع أو الدفع تلقائياً أثناء تشغيلات الاختبار أبداً (ويمكن للمستخدمين ووكلاء MCP تسجيل بطاقات وسلاسل مخصصة لـgit pushأو النشر السحابي بحرية). - المبدأ 3 (Cold Box الحدودي وإثبات PR): أبقِ
cold_box: falseأثناء سباقات البرمجة السريعة، وشغّلmatlock_run_sequence(id: "seq_matlock", cold_box: true)قبل الدفع/الحفظ السحابي/النسخ الاحتياطي/الترجمة، وتوقف عندSTOP_IMMEDIATELY/HALT_FOR_REPLACEMENT(STOP_AND_ALERT_USER)، وأدرج شارةpr_verification_badgeالمعتمدة على الشعار فقط (https://matlock.dutchp2p.com/badge/verified.svg) في وصف طلب السحب بمجرد أن تصبحverdict == "PASSED".