AI Code Lock

إضافة لـ VS Code والمحررات المتوافقة معه مثل Cursor، تمنع تعديل أجزاء الكود التي تختار قفلها. صُممت للحماية من تعديل بشري بالخطأ، ومن تعديلات Copilot وCursor Agent، ومن أدوات تعدّل الملفات من الطرفية أثناء عمل المحرر.

أهم ما تفعله النسخة 0.2.0

• تقفل الأسطر المحددة بعلامتي AI-LOCK:BEGIN وAI-LOCK:END مع رقم فريد وبصمة SHA-256.
• تعيد أي تعديل يلمس المنطقة المقفلة فورًا في وضع الحماية الافتراضي.
• تلوّن المنطقة بالأحمر وتضع علامة في Overview Ruler وأيقونة قفل في Status Bar.
• تحفظ حالة القفل ونسخة استرجاع خاصة حتى بعد إغلاق الملف أو إعادة تشغيل المحرر.
• تراقب الملفات المقفلة وهي مغلقة في التبويب، وتسترجع آخر نسخة سليمة إذا عدّلها برنامج خارجي أثناء عمل الإضافة.
• تدعم تعليقات // و# و/* */ و<!-- --> و-- وأنماط لغات شائعة أخرى.
• تستخدم قفلًا جانبيًا آمنًا للملفات التي لا تسمح بالتعليقات، وأهمها JSON الصارم.
• تنشئ قواعد لـ Claude Code وCursor وGitHub Copilot وVS Code Agents وAGENTS.md بدون حذف تعليماتك الموجودة.
• تستطيع إنشاء حارس PreToolUse اختياري يمنع أدوات Edit وWrite في Claude Code قبل تنفيذ التعديل.

التثبيت السريع من ملف VSIX

VS Code

1. نزّل ملف ai-code-lock-0.2.0.vsix.
2. افتح VS Code.
3. افتح صفحة Extensions من الأيقونة اليسرى، أو اضغط Ctrl+Shift+X.
4. اضغط زر النقاط ... أعلى صفحة Extensions.
5. اختر Install from VSIX....
6. اختر الملف الذي نزّلته، ثم اضغط Reload إذا ظهر الطلب.

Cursor

1. افتح Cursor ثم صفحة Extensions.
2. اضغط زر النقاط ....
3. اختر Install from VSIX... وحدد نفس الملف.
4. أعد تشغيل Cursor.

لا تحتاج إلى نشر الإضافة في متجر حتى تستخدمها؛ ملف VSIX كافٍ.

طريقة الاستخدام

1. افتح ملف كود وحدد سطرًا أو عدة أسطر.
2. اضغط بالزر الأيمن واختر AI Code Lock: Lock Selected Code، أو اضغط Ctrl+Alt+L.
3. ستظهر العلامات حول الكود ويظهر القفل أسفل يمين الشاشة.
4. جرّب الكتابة داخل المنطقة الحمراء: في الوضع الافتراضي سيُرجع التعديل مباشرة.
5. لفك القفل، ضع المؤشر داخله ثم افتح Command Palette بـ Ctrl+Shift+P وشغّل AI Code Lock: Unlock Code at Cursor.

الإضافة تقفل أسطرًا كاملة حتى لا تضع علامة تعليق في منتصف تعبير برمجي وتكسر الملف.

تجهيز أدوات الذكاء الاصطناعي

افتح Command Palette وشغّل:

AI Code Lock: Generate Rules Files

اختر الخيار الموصى به Rules + Claude Code hard guard. الأمر يحدّث الأقسام التي تديرها الإضافة فقط داخل:

• CLAUDE.md
• .claude/rules/ai-code-lock.md
• .cursor/rules/ai-code-lock/RULE.md
• .cursorrules للتوافق القديم
• .github/copilot-instructions.md
• .github/instructions/ai-code-lock.instructions.md
• AGENTS.md
• .claude/settings.json وحارس Claude الاختياري

اختبار يدوي بسيط

أنشئ ملفًا اسمه test.js واكتب:

const protectedValue = 1;
const editableValue = 2;

اقفل السطر الأول فقط، ثم تأكد من الآتي:

1. التعديل داخل السطر الأول يرجع فورًا.
2. التعديل داخل السطر الثاني يبقى طبيعيًا.
3. بعد حفظ الملف وإغلاقه وفتحه مرة ثانية، يبقى القفل ظاهرًا.
4. شغّل AI Code Lock: Verify All Locks وتأكد من ظهور رسالة نجاح.
5. كرر التجربة في CSS؛ ستكون العلامات بصيغة /* ... */.

ما الذي يُحفظ؟

• البصمات والمواقع العامة تظهر في .ai-code-lock/manifest.json حتى تستطيع الأدوات معرفة الأقفال. هذا الملف لا يحتوي نسخة من الكود المقفول.
• نسخة الاسترجاع الأصلية تُحفظ في مساحة التخزين الخاصة بالإضافة، وليست داخل مشروعك.
• الإضافة لا ترسل الكود إلى الإنترنت ولا تحتاج API أو حساب ذكاء اصطناعي.

حدود الحماية — بصراحة

• VS Code لا يوفر حدثًا يسمح للإضافة بإلغاء الضغطة قبل ظهورها؛ لذلك يظهر التعديل لحظة قصيرة ثم يُرجع مباشرة. هذه أقوى حماية عامة ممكنة عبر API الرسمي مع السماح بالتعديل خارج القفل.
• إذا كان التعديل الواحد يغيّر كودًا مقفلًا وغير مقفل معًا، تُرفض العملية كلها حتى لا نخاطر بخسارة القفل.
• إذا كان VS Code/Cursor والإضافة مغلقين بالكامل، لا تستطيع الإضافة إيقاف برنامج خارجي في تلك اللحظة. عند التشغيل التالي تقارن النسخة وتطلب منك الاسترجاع أو اعتماد النسخة الحالية.
• ملفات قواعد AI هي تعليمات سلوكية وليست جدارًا أمنيًا. الحماية الفعلية تأتي من الإضافة، ومن حارس Claude Code لأدوات Edit وWrite.
• حارس Claude لا يستطيع معرفة كل ما قد يفعله أمر Bash عام. القواعد تطلب عدم استخدام Bash لتجاوز القفل، ومراقب الملفات تعيد التغيير أثناء عمل المحرر.
• إيقاف الإضافة أو حذفها يوقف الحماية الفعلية؛ العلامات والقواعد وحدها لا تضمن التزام أي نموذج.
• JSON يستخدم قفلًا جانبيًا لأن إضافة تعليق داخله تجعل الملف غير صالح.

أوامر الإضافة

للمطور

npm install
npm test
npm run check
npm run package:vsix

للتجربة داخل VS Code، افتح مجلد المشروع واضغط F5 لفتح Extension Development Host. توجد اختبارات وحدات واختبار تكامل داخل مجلد test.

تعليمات النشر المبسطة موجودة في ملف PUBLISHING_AR.md، والتصميم التقني في ARCHITECTURE.md.

English summary

AI Code Lock protects selected code regions in VS Code-compatible editors. It adds language-safe markers, immediate reactive rollback, persistent private backups, closed-file monitoring, sidecar locks for commentless formats, cross-agent instruction files, and an optional Claude Code PreToolUse guard. See the Arabic guide above for installation, testing, and limitations.