# ماتلوك (Matlock) — أدوات الوكلاء والمطورين. (دليل المالك والمرجع التشغيلي) > **لوكلاء البرمجة بالذكاء الاصطناعي والمنسّقين:** > انتقل مباشرة إلى **[الجزء الثاني: المواصفات التشغيلية للآلة والوكلاء المستقلين](#part-ii-machine--autonomous-agent-operational-specification)** للاطلاع على فهرس `stdio` MCP بـ 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`** في أي وقت) · [مركز القيادة على الويب](https://matlock.dutchp2p.com/ar/app) · [فحص المتصفح المجاني](https://matlock.dutchp2p.com/ar/#wasm-instant-audit) · [الوثائق](https://matlock.dutchp2p.com/ar/docs) · [الدليل عبر الإنترنت](https://matlock.dutchp2p.com/ar/manual) · معرف MCP `matlock://help/appliance-manual` **إشعار النطاق والإشعار القانوني**: *يقيّم ماتلوك الضوابط التقنية للشيفرة البرمجية وخطوط الأنابيب مقابل المواصفات والمعايير الصناعية المنشورة (MITRE CWE، وCISA SSDF، وIEEE Std 1003.1 POSIX، وبوابات النزاهة الآلية Pre-CI، والضوابط التقنية لـ AICPA SOC 2 Trust Services Criteria). لا يضمن ماتلوك برمجيات خالية من العيوب، ولا يُصدر تقارير تصديق رسمية من طرف ثالث، ولا يقدّم شهادات اعتماد من مكتب محاسب قانوني معتمد (CPA) مستقل.* --- ## جدول المحتويات ### الجزء الأول: دليل المشغّل البشري ومنضدة العمل 1. [مسرد سريع وسير العمل الأساسي](#1-مسرد-سريع-وسير-العمل-الأساسي) 2. [تخطيط الشاشة والسمات والتنقل](#2-تخطيط-الشاشة-والسمات-والتنقل) 3. [النصوص المكتشفة والفحوصات المخصصة والإجراءات والمفضلة بالنجوم](#3-النصوص-المكتشفة-والفحوصات-المخصصة-والإجراءات-والمفضلة-بالنجوم) 4. [روتينات العمل أثناء الغياب وأوامر الآلة والتنبيهات المحلية](#4-روتينات-العمل-أثناء-الغياب-وأوامر-الآلة-والتنبيهات-المحلية) 5. [شلال النتائج وإعادة التشغيل المعزولة والتجاهل والنسخ للوكيل](#5-شلال-النتائج-وإعادة-التشغيل-المعزولة-والتجاهل-والنسخ-للوكيل) 6. [حماية Safeguard الثابتة المقاومة للعبث وسلامة الاختبارات والاستعادة](#6-حماية-safeguard-الثابتة-المقاومة-للعبث-وسلامة-الاختبارات-والاستعادة) 7. [أشرطة الدرجة الصحية الأفقية والتغطية ومعيار النمطية](#7-أشرطة-الدرجة-الصحية-الأفقية-والتغطية-ومعيار-النمطية) 8. [الإعدادات ذات العمودين واستعادة الحالة المختومة](#8-الإعدادات-ذات-العمودين-واستعادة-الحالة-المختومة) 9. [ربط وكلاء الذكاء الاصطناعي (MCP سطح المكتب ودليل الهاتف/الدردشة)](#9-ربط-وكلاء-الذكاء-الاصطناعي-mcp-سطح-المكتب-ودليل-الهاتفالدردشة) 10. [مرجع المعايير المدمجة (10 بيئات + Pre-CI)](#10-مرجع-المعايير-المدمجة-10-بيئات--pre-ci) 11. [ترخيص محطة العمل Pro ومعاينة الويب وفحص المتصفح المجاني](#11-ترخيص-محطة-العمل-pro-ومعاينة-الويب-وفحص-المتصفح-المجاني) 12. [Linux وGoogleBook والتحديثات والخصوصية والدعم](#12-linux-وgooglebook-والتحديثات-والخصوصية-والدعم) ### الجزء الثاني: المواصفات التشغيلية للآلة والوكلاء المستقلين * [A. نقاط دخول الوكيل وإعداد النقل](#a-نقاط-دخول-الوكيل-وإعداد-النقل) * [B. القياس ووصول الأسراب M2M وفتح Pro](#b-القياس-ووصول-الأسراب-m2m-وفتح-pro) * [C. فهرس MCP المحلي الكامل بـ 27 أداة](#c-فهرس-mcp-المحلي-الكامل-بـ-27-أداة) * [D. صندوق العزل الحدودي Cold Box وحاكم الحلقات الـ 3 ومصافحة الأسئلة الـ 3](#d-صندوق-العزل-الحدودي-cold-box-وحاكم-الحلقات-الـ-3-ومصافحة-الأسئلة-الـ-3) * [E. المواصفة القابلة للقراءة آلياً لوكلاء البرمجة بالذكاء الاصطناعي (YAML)](#e-المواصفة-القابلة-للقراءة-آلياً-لوكلاء-البرمجة-بالذكاء-الاصطناعي-yaml) * [F. مبادئ تشغيل الوكيل وحدود التنفيذ](#f-مبادئ-تشغيل-الوكيل-وحدود-التنفيذ) --- ## الجزء الأول: دليل المشغّل البشري ومنضدة العمل ## 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` (`= 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 . "" /MIR` | `rsync -a --delete ./ "/"` | يبقي `.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 دون تفويض، يستعيد ماتلوك حتمياً الملف الأصلي المختوم (مع حفظ نسخة تراجع احتياطية خارج المستودع)، وينبض **الظرف** في الشريط العلوي بـ `[تنبيه ماتلوك] تم تعديل اختبار حرج: `، ويحظر التشغيلات بلا واجهة (`exit 65`). * **سلامة الاختبارات والاستعادة بموافقة شخص**: ترفع الاختبارات المحذوفة أو المتخطاة أو المُضعَفة **سجلات مراجعة اختبارات محذوفة** دائمة تحجز **جاهز للدفع** حتى يحدد شخص **حسناً، أنا فعلت ذلك** أو **مشبوه** أو يستخدم **الإعدادات -> Safeguard والاستعادة -> السماح لماتلوك باستعادة الاختبارات** (معاينة الفروق + نسخة تراجع). وتكتب **المزامنة بين أجهزتي** (Pro) ملفات سلامة `.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. الإعدادات ذات العمودين واستعادة الحالة المختومة انقر **`الإعدادات`** في الشريط العلوي لفتح نافذة العمودين (شريط فئات أيسر + عناصر تحكم موجزة؛ يتضمن رأس كل لوحة أيقونة **`?`** تقفز مباشرة إلى قسمها في الدليل): 1. **`المظهر`**: **اللغة** (9 لغات + لغة النص المنسوخ)، **السمة** (`افتراضي النظام`، `فاتح`، `أردوازي داكن`)، اختصار سطح المكتب، وخيار Windows **التصغير إلى شريط النظام عند الإغلاق**. 2. **`المشروع والمنفّذ`**: **قرص ضبط النمطية** (`Grade A..Minimum`)، و**`فتح المجلد`** للملف الشخصي المحلي الخاص بالنظام، و**`استعادة شريط الإعداد المبدئي`** (يعيد فتح `أعدّه لي`)، و**`الاحتفاظ بسجل التشغيل السريع`**، و**`إعادة تعيين سجل التجاهلات`**. 3. **`Safeguard والاستعادة`**: **`السماح لماتلوك باستعادة الاختبارات`**، ومبدّل الإرجاع التلقائي لـ Safeguard المخصص للإنسان فقط، و**`المزامنة بين أجهزتي`** (مزامنة مجلد مختومة بعبارة مرور). 4. **`تنبيهات البريد الإلكتروني`**: محطة تنبيهات البريد الصادر فقط والنصوص المخصصة المحلية + **`اختبار البريد`**. 5. **`وكيل الذكاء الاصطناعي (MCP)`**: مبدّل **`خادم MCP (stdio)`** (متوقف افتراضياً)، وجسر **`«المزامنة مع الوضع غير المرئي»`** ثنائي الاتجاه (تحديث بنقرة واحدة يحمل بطاقات/تسلسلات الوكيل وينشر الأوامر القائمة مع `0` استطلاع بالخلفية)، و**`اختبار اتصال MCP`**، و**`نسخ إعدادات MCP وتعليمات الوكيل`**، و**`نسخ سؤال لهاتفي الذكي`**، و**`جسر بريد الوكيل`**. 6. **`الترخيص والتحديثات`**: مفتاح الـ 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 للوكيل`** داخل `?`)، وانقر **`«المزامنة مع الوضع غير المرئي»`** في أي وقت (في الإعدادات أو الشريط الأيسر) لتحميل البطاقات التي أنشأها الوكيل ونشر الأوامر القائمة ثنائياً: ```json { "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/ar/manual.md) / [https://matlock.dutchp2p.com/llms.txt](https://matlock.dutchp2p.com/llms.txt) في أي دردشة ذكاء اصطناعي على الهاتف أو المتصفح. وللاطلاع على أحدث بيئات التطوير وأنظمة الوكلاء ومنصات الحاويات، راجع تعليمات التوافق الحية على [https://matlock.dutchp2p.com/ar/docs.html](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](https://matlock.dutchp2p.com/ar/pricing)) للدفع بالبطاقة (أو بالعملات المستقرة الدولارية الفورية / PayPal عبر `Solana USDC` و`PayPal PYUSD` و`Base USDC` و`Polygon USDC` أو عبر MoonPay وTransak)، وانسخ **مفتاح الـ 24 حرفاً** + `/receipt/`، وفعّله في **`الإعدادات -> الترخيص والتحديثات`**. يشمل سطح المكتب المجاني **`Matlock`** و`تقرير صحة كود CI` (مع مجاملة الأسرار) و`شريط حجم الملف` و`الملاحظات` واستعادة `المتجاهَل`؛ ويفتح Pro الإجراءات والمفضلة بالنجوم والروتينات وأوامر الآلة والتشغيل السريع (`Ctrl+K`) وأيقونة تجاهل العين وإحداثيات `file:line:col` الدقيقة غير السرية. * **مركز القيادة على الويب وفحص المتصفح المجاني:** يفحص [https://matlock.dutchp2p.com/ar/#wasm-instant-audit](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](https://matlock.dutchp2p.com/ar/app) التخطيط النهاري/الليلي الهادئ وأشرطة الدرجة/التغطية الأفقية ومنفّذ **`Matlock`** الموحّد وشريط **طرفية CLI** المدمج (`تشغيل` / `حفظ كبطاقة` / `سلسلة وتنبيه`) و**`نسخ هذه البطاقة كنص برمجي`** و**`لصق مخرجات تشغيلك` -> `تلوينها`** (وتميّز عبارة `في تطبيق سطح المكتب فقط` العناصر الأصلية). ## 12. Linux وGoogleBook والتحديثات والخصوصية والدعم * **التثبيت على GoogleBook وLinux:** على **GoogleBook**، فعّل **الإعدادات -> المطوّرون -> بيئة تطوير Linux**، وثبّت `matlock-linux-x64.deb`، واحتفظ بالمستودعات النشطة في `Linux files` الأصلية (`$HOME` `ext4`) للسرعة. وعلى **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. نقاط دخول الوكيل وإعداد النقل * **النقل**: `stdio` JSON-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`) (لبيئات **Cloudflare `ContainerHarness` / `Codex` `cloudflare/debian-trixie`** وDocker وE2B وFirecracker) أو `matlock-mcp --stdio --headless --no-coverage` على Linux `x64` وWindows `x64` وmacOS `arm64` ([https://matlock.dutchp2p.com/ar/agents](https://matlock.dutchp2p.com/ar/agents) · التوافق الحي لبيئات التطوير والحاويات: [https://matlock.dutchp2p.com/ar/docs.html](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`)، ولا يتكرر بعد الإجابة أو التجاهل: ```json { "mcpServers": { "matlock": { "command": "matlock-mcp", "args": ["--stdio", "--headless", "--no-coverage"] } } } ``` ### B. القياس ووصول الأسراب M2M وفتح Pro * **صفر تمريرات مفتوحة مجانية وإثبات قيمة `HTTP 402` في `< 50ms`**: يعمل `Index 0` `matlock_run_scan(target_path)` غير الممول محلياً خلال `< 50ms` (`0` رفع سحابي، `0` حظر للإيداع) ويعيد الدرجة الصحية الدقيقة `0.0–100.0` وأعداد الخطورة وفئات CWE المنتهكة ووسوم `MITRE ATT&CK` `T*` وحسابات `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 ` لتشغيلات غير محدودة بسعر `$0.00/تمريرة`). يخرج CLI بلا واجهة بالرمز `77` (`EX_NOPERM`) عند `402` وبالرمز `65` (`EX_DATAERR`) عند العبث بـ Safeguard/الختم. ### C. فهرس MCP المحلي الكامل بـ 27 أداة 1. **`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 أسطر (يدعم أيضاً CLI `matlock-mcp scan . --format=sarif` لـ `SARIF 2.1.0`). 2. **`matlock_describe_project(target_path?, mode?)`**: ملف تعريف اختياري لمساحة العمل (`0` رصيد، `readOnlyHint: true`)؛ مرّر **`mode: "tool_bag"`** (أو CLI **`matlock-mcp toolbag [--json]`**) للحصول على جرد تدريجي بحجم `~350–550` رمزاً لبطاقات الإجراءات والتسلسلات `[LOCKED]` (تنفيذ فقط) مقابل `[MODIFIABLE]` (قابلة لتحسين الوكيل) وشارات `[NEW]` / `[UPDATED]` وعلامات `[UNAVAILABLE IN CONTAINER]` والأوامر القائمة وجاهزية التنبيه الصادر. 3. **`matlock_get_scan_results(target_path?, cursor?, pillar?, rule_code?)`**: نتائج مرقّمة (`25`/صفحة؛ يخفي سطح المكتب السطور المحمية بـ Safeguard حتى الفتح؛ ويفتح خزان الوقود `--headless` الإحداثيات). 4. **`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`). 5. **`matlock_get_test_integrity(target_path?, reverify?, include_archive?, id?, include_text?, note_for_id?, note?)`**: يفحص سجلات سلامة الاختبارات المحذوفة ويضيف ملاحظات تفسيرية للوكيل (`0` حقوق إغلاق). 6. **`matlock_get_history(target_path?, limit?)`**: سجل الدرجات وأعداد الإصلاحات للقراءة فقط. 7. **`matlock_read_appliance_manual(section_id?, standard_id?, query?, locale?)`**: الدليل دون اتصال (9 لغات) واستعلام معايير CWE/POSIX/SSDF/SOC2/النتائج (`0` رصيد، `0` شبكة). 8. **`matlock_list_custom_tests`**: يسرد الفحوصات المخصصة للمستخدم. 9. **`matlock_register_custom_test`**: يحفظ فحصاً مخصصاً بنمط أو نص برمجي. 10. **`matlock_delete_custom_test`**: يحذف فحصاً مخصصاً غير مقفل (الفحوصات المدمجة غير قابلة للتعديل). 11. **`matlock_list_actions`**: يسرد بطاقات الإجراءات (مع رايات `favorite`/القفل/الموافقة) إضافة لـ `recommendedTemplates` غير المهيأة (`unconfiguredTemplate: true`). 12. **`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`)، ويفرض **يتطلب موافقة** على سطح المكتب. 13. **`matlock_register_sealed_script`**: يختم أوامر البناء/الاختبار (**مقفل من المستخدم**) ضد تعديلات الوكلاء الفرعيين. 14. **`matlock_run_action(id, working_dir?, async?, send_alert?, cold_box?)`**: ينفذ أمراً معزولاً ضمن احتواء شجرة مهام نظام التشغيل (`async: true` للتشغيل الخلفي غير الحاجب، `send_alert: "always" | "on_error" | "never"`، مع دعم بطاقات `git push` وUSB `robocopy`/`rsync` وR2/S3/GCS/Azure المخصصة؛ و`0` أوامر `git push` مدمجة داخل تشغيلات اختبار `Matlock`). 15. **`matlock_get_action_status(id?)`**: يستطلع الحالة الحية ورمز الخروج وكبسولات الحالة المضغوطة لتشغيلات `async: true` الخلفية. 16. **`matlock_stop_action(id?, stop_sequence?)`**: ينهي شجرة العمليات النشطة فوراً (`stop_sequence: true` يوقف تسلسلاً نشطاً كاملاً بنظافة). 17. **`matlock_delete_action`**: يحذف بطاقة إجراء غير مقفلة. 18. **`matlock_list_sequences`**: يسرد الروتينات متعددة الخطوات. 19. **`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::` في فهرس `insert_at_index` يبدأ من `0` مع `failure_policy` (`"stop" | "stop_and_alert" | "continue_and_alert"`) و`always_run` و`favorite: true | false`. 20. **`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` يفرض تنظيفاً كاملاً وإعادة معايرة التغطية). 21. **`matlock_delete_sequence`**: يحذف روتيناً غير مقفل. 22. **`matlock_list_alerts`**: يسرد قنوات التنبيه المحلية (مع حجب الأسرار). 23. **`matlock_set_alert`**: يهيئ تنبيهات Dart TLS 1.2/1.3 الأصلية الصادرة فقط `email_smtp` (إعدادات جاهزة عالمية، سلسلة مفاتيح النظام أو الخزنة المحلية للحاوية المختومة بعبارة مرور) أو `custom_script`. 24. **`matlock_trigger_alert(id, status, task_completed, uncovered_issues, next_move)`**: يرسل إشعاراً محلياً مع مصافحة الأسئلة الـ 3 الإلزامية. 25. **`matlock_delete_alert`**: يحذف بطاقة تنبيه غير مقفلة. 26. **`matlock_purchase_license(transaction_signature?, license_key?, target_path?, network?, runs?, lid?)`**: يسوّي المخصصات المقاسة لأسراب الوكلاء المستقلين (انظر `/ar/agents`) أو يطالب بمفتاح Pro من 24 حرفاً بسعر حوالي 92 درهم إماراتي* (`$24.99 USD/yr`). 27. **`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) ```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"`.