jquery35-local-agent

أداة أتمتة لمعالجة jQuery CVE-2020-11023 تعمل بـ Node.js وحده في الشبكات المغلقة (لمشاريع Java/Spring/JSP القديمة · بدون الحاجة إلى npm install · بدون إنترنت · بدون تبعيات خارجية)

تتعامل محليًا مع كامل العملية اللازمة عند ترقية jQuery إلى 3.5+ في تطبيقات الويب القديمة (عائلة Spring/JSP + jQuery 1.x): تحليل ثابت شامل → تصحيح تلقائي آمن (توليد TO-BE) → استبدال بـ jQuery 3.5.1 + Migrate → Runtime Probe للواجهات → خادم Lab وهمي → حزمة قرار AI → فحص بوابة قبل التطبيق في بيئة الإنتاج → تقرير.

الميزات

• مبدأ عدم تعديل الأصل — تُنشأ جميع التغييرات في مجلد TO-BE الخاص بـ --target فقط. تُراجَع عبر diff مقسّم AS-IS/TO-BE عند النقر على الملف في report/index.html ثم تُعتمد.
• ماسح يقلل الإيجابيات الكاذبة — ليس مجرد تعبير نمطي بسيط، بل إخفاء الرموز (إزالة التعليقات/السلاسل/التعبيرات النمطية) + تتبع عكسي لسلسلة المستقبِل + محلل وسائط متوازن الأقواس + تتبع taint داخل الملف (ترقية معاملات callback في ajax → DOM sink) + استنتاج أنواع مواقع الاستدعاء على مستوى المشروع بأكمله (AutoInferred).
• إصلاح تلقائي للآمن فقط — فقط التغييرات الاستباقية التي تعمل في jQuery 1.x/3.x معًا مثل .bind→.on، .size()→.length، boolean .attr→.prop. لا يُصلَح تلقائيًا أبدًا أي مرشح XSS مثل .html(response) بل يُصنَّف فقط.
• دعم البيئات المغلقة/القديمة — ES5 Runtime Probe لوضع IE في Edge (محدودية أدوات المطور)، والحفاظ على بايتات ملفات EUC-KR (latin1 round-trip)، وإنشاء تقارير CSV/XLS مباشرة دون npm.
• حزمة وقت تشغيل jQuery الافتراضية — يضع patch-jquery تلقائيًا jquery-3.5.1.min.js وjquery-migrate-3.6.0.min.js في شجرة TO-BE، لذا يمكن تشغيل التركيبة الافتراضية دون تجهيز ملفات منفصلة. وتُضمَّن نسخة jquery-migrate-3.6.0.js غير المضغوطة معها لأغراض Tracing/debug المؤقتة.
• حزمة مراجعة AI (review-pack) — حلقة تختار فقط نقاط الكود الغامضة (اسم الدالة + بضعة أسطر قبلها وبعدها، مع إخفاء السلاسل/التعليقات/التعبيرات النمطية) وتتعلم تكراريًا مع AI خارجي على طريقة لعبة العشرين سؤالًا. فمعرفة دور دالة مشتركة خاصة بالشركة (مثل غلاف AJAX) تنتشر إلى جميع مواضع الاستدعاء. المعرفة المتعلَّمة لا تُطلق أبدًا إصلاحًا تلقائيًا بل تؤثر في التصنيف فقط.
• حزمة الفحص المحلي Hermes (hermes-pack) — تُنشأ بشكل مستقل عن أسئلة AI الخارجية: نقاط التحقق الساكن لكل CASE، واختبارات Probe/Lab المحلية، ومعايير النجاح/الفشل، وقالب انعكاس project-profile، وصفحة ويب مخبر محاكاة لكل CASE. حزمة مكوّنات لبناء معرفة فحص متكررة داخل الشبكة المغلقة.
• rulepack للتوزيع العام — تُفصل مرشحات جذر الويب، وتلميحات إدراج Probe، وتوصيات المورّد، والاستجابات الافتراضية لـ mock في rules/*.json. فيُضبط كل موقع نشر بتغيير حزمة القواعد فقط دون تعديل كود JS.
• أدلة ساكنة لـ Java/Spring — دون تشغيل Spring، تُقرأ عائلات @RequestMapping وإعدادات XML لتوليد ajaxToServerMap.csv وserverEndpoints.csv وhermes_server_evidence.json، وتُضاف تلميحات المتحكم إلى mock route.
• سيناريوهات التحقق Runtime — تُطابَق id/class/name/نص الأزرار في JSP/HTML مع محددات JS لتوليد سلوكيات التحقق في runtime_scenarios.html: code-only/static لشبكة 1، وChrome smoke لشبكة 2، وعينة Edge IE mode النهائية.
• تحليل Runtime Parity — يفصل مدى موثوقية نتائج Local Lab/mock ويبلّغ عن مسارات LOCAL_LAB_OK وCHROME_SMOKE_REQUIRED وIE_FINAL_SAMPLE_REQUIRED، ويولّد runtime_parity.html وruntimeParity.csv وieModeRisk.csv.
• قالب Runtime Lab اختياري — لا يتضمن ZIP العام Docker/JDK/Tomcat/WAR، بل يوفّر فقط هيكل runtime-lab/ لتجربة نشر WAR من Codex/الكمبيوتر المحلي.
• حزمة نسخ ولصق لحكم Voyager/AI — لمواجهة حالة الشبكة المغلقة التي يتعذر فيها تسليم ملفات CSV، تُضغط الملخصات/السيناريوهات/المحددات/AJAX في voyager_packet.txt، ويُضغط في ai_verdict_packet.txt سؤال حكم لا يتجاوز 1000 حرف: «الفحص البشري كافٍ / يلزم runtime إضافي / يلزم مراجعة IEDriver».
• مخرجات النشر للشبكة المغلقة — تُسجَّل أدلة عدم الاعتماد/عدم الاتصال في airgap_manifest.json/txt، ويُولَّد ZIP للتوزيع العام عبر --mode release-zip.
• وحدة تحكم ويب محلية — عبر 실행0_웹대시보드.bat أو --mode ui تُعالَج في المتصفح: تصفح المسارات، والحساب التلقائي للمسار، وخط أنابيب plan/autofix/patch/Hermes/report، وLocal Lab، وفتح تقارير HTML الموجودة.
• لوحة معلومات التجميع/المراجعة — في index.html، اطّلع أولاً على الرسوم البيانية حسب النوع (event-shortcut-load وغيرها) والتوزيع حسب عمق الدليل، وعند النقر على ملف تتم مقارنة الكود المحيط بصيغة AS-IS/TO-BE في نافذة منبثقة.
• تحقق ذاتي مدمج — يقوم --mode self-test بإنشاء مشروع عينة مؤقت للتحقق من الدورة الكاملة. يتضمن الإصدار v5.6.10 الإعداد التلقائي source-only، وأسماء خطوات وحدة تحكم الويب S1~S11، وتجميع المسارات/الأنواع، والإصلاح التلقائي مع الحفاظ على فواصل الأسطر AS-IS/TO-BE، والوضع التلقائي لـ jQuery المضمّن، وتنظيف ملفات النواة القديمة، وسيناريوهات وقت التشغيل القائمة على عناصر واجهة المستخدم، وتكافؤ وقت التشغيل لعينات code-only/Chrome smoke/IE final، وإنشاء حزم النسخ واللصق لأحكام Voyager/AI.

البدء السريع

node run-jquery35-v5.js --mode self-test

node run-jquery35-v5.js --mode ui --port 18088

node run-jquery35-v5.js --source "C:\work\legacy-app" --target "C:\work\legacy-app_jquery35_tobe" --report "C:\work\jquery35_report_v5" --mode plan

يُفتح وحدة تحكم المتصفح على http://127.0.0.1:18088/. هنا يكفي تصفح أو إدخال source فقط ليتم احتساب المسارات الافتراضية لـ TO-BE/report/profile/server-source/verify-source تلقائيًا، ثم يمكن التنفيذ عبر الخطوات الفردية S1~S11 أو عبر Pipeline. إذا كان أسلوب الأوامر أسهل لك، فافتح لوحة report\index.html للاطلاع على الحالة، واتبع الترتيب الموجود في README_FIRST.txt (التحليل → الإصلاح التلقائي → استبدال jQuery → Probe → Lab → verify-clean). على مستخدمي Windows تعديل المسارات العلوية فقط في الملفات المرفقة 실행0_웹대시보드.bat ~ 실행9_배포ZIP생성.bat ثم تشغيلها.

عند النشر العام أو التطبيق في موقع آخر، انسخ project-profile.public.sample.json وأنشئ منه project-profile.json، وعدّل عند الحاجة rules/public-defaults.json وrules/vendor-compat.json وrules/mock-defaults.json فقط.

node run-jquery35-v5.js --report ".\release" --mode release-zip

الوثائق

• README_KO.md — الدليل الكامل (معايير الحكم، شرح الأوضاع، تدفق Git/CI، الأسئلة الشائعة)
• VENDOR_COMPAT_KO.md — موجز توافق الموردين: الإصدارات المتوافقة مع jQuery 3.x لـ jqGrid/jQuery UI/select2/autoNumeric، وثغرات jQuery UI الخاصة به، وتغييرات السلوك التي لا يستطيع Migrate استعادتها (الوسوم ذاتية الإغلاق وغيرها)
• RUN_EXAMPLES_KO.txt — مجموعة أمثلة الأوامر
• README_FIRST.txt — البدء السريع

جميع المسارات في الوثائق (مثل C:\work\legacy-app) هي أمثلة. استبدلها بمسار مشروعك الفعلي.

المتطلبات

Node.js 16+ minimum, Node.js 18+ recommended. هذا كل شيء.

الترخيص

MIT