دليل تثبيت واستعمال 富江破甲: إعداد مهارات الأمان وقاعدة المعرفة وسلسلة المهام لـ DeepSeek Harness

مقدمة على المشروع

富江破甲 هو إضافة مخصّصة ديال البرومبتات ومساعدة فالتقييمات الأمنية، موجهة لـ DeepSeek Harness. النسخة المعلنة فـ README دابا هي 0.20.12. المشروع كيثبّت @deepseek-ai/dsh-prompt-custom فدليل إعدادات Harness، وكيخلي برنامج الإضافة وملف إعدادات البرومبتات prompt-custom.json محفوظين بشكل منفصل.

الإضافة كتوفّر البرومبتات المخصّصة، مكتبة المهارات، قاعدة معارف مدمجة ديال CVE/PoC، تقارير الثغرات وسلسلة مهام اختبار الاختراق. كتصلح لتنظيم الأصول، مطابقة الثغرات المحتملة، تسجيل خطوات التحقق وإنشاء التقارير فـبيئات عندك فيها ترخيص واضح. ما خاصش اعتبار العناصر المقترحة من قاعدة المعارف أو التقدم الآلي ثغرات مؤكدة بشكل مباشر.

اسم المشروع والإشارات إلى DeepSeek ما كيعنيوش تزكية رسمية. قبل الاستعمال، قرا إخلاء المسؤولية الموجود فالمستودع، وتأكد باللي أهداف الاختبار والنطاق وطريقة التشغيل كاملين مرخّصين.

الوظائف الرئيسية

• حقن البرومبتات: حدّ خانة الإدخال كاين مفتاح حالة “富江破甲” ومدخل للإعدادات. منين كتوقف الحقن، كيرجع الرأس الرسمي، مع الاحتفاظ بالنص ديال البرومبت اللي كتبتيه.
• تقارير الثغرات: حفظ دائم للسجلات ديال الثغرات اللي كتكتبها الذكاء الاصطناعي، مع إمكانية عرضها حسب المستويات: حرج، عالي الخطورة، متوسط الخطورة، منخفض الخطورة ومعلوماتي.
• مكتبة المهارات: تنزيل وتفعيل أو تعطيل REA وAboutSecurity حسب الحاجة، وتمكين الذكاء الاصطناعي من اكتشاف المهارات المسجلة.
• قاعدة المعارف المدمجة: كتجي مع الإضافة بتسعة أصناف ديال معارف CVE/PoC، وتفعيلها ما كيحتاجش تنزيل إضافي.
• سلسلة مهام اختبار الاختراق: تدبير المهام، الأصول، خطوات التحقق، سجلات المحاولات، المراحل والاقتراحات الموالية.
• مطابقة البصمات محلياً: ترتيب العناصر المرشحة من قاعدة المعارف حسب المنفذ، تعريف الخدمة أو اسم المنتج، مع إعطاء أسباب المطابقة.

واجهة البرومبتات المخصّصة

إعدادات البرومبتات المخصّصة محفوظة بشكل مستقل فـ prompt-custom.json، وقد تحتوي على إعدادات شخصية. قبل إعادة التثبيت أو النسخ الاحتياطي أو التوزيع، خاصك تتأكد واش محتوى الملف مناسب للمشاركة.

مكتبة المهارات وقاعدة المعارف

مكتبة المهارات كتدعم جوج مشاريع منبع: أداة التحليل العكسي REA ومكتبة مهارات التقييم الأمني AboutSecurity. كل مشروع من الطرف الثالث خاضع لشروط الترخيص الخاصة به.

قاعدة المعارف المدمجة كتشمل تصنيفات بحال Java deserialization، وJava Web، وأجهزة الحدود، وExchange وبيئات الدومين، وWeb وCMS، ورفع الصلاحيات فـ Linux، والسحابة والحاويات، ومخاطر واجهات الأعمال، وفرز الثغرات. كل عنصر كيسجل المنتج، النسخة، المنفذ، الكلمات المفتاحية، مستوى الخطورة، الشروط المسبقة، اقتراحات الإصلاح والمصادر المرجعية.

التحضير قبل التثبيت

1. تأكد من استعمال نسخة مدعومة من DeepSeek Harness. الإضافة كتعلن على التوافق مع DeepSeek Harness ونسخ >=0.2.1-rc.5 <0.3.0 ديال dsh-system-prompt.
2. تأكد باللي نسخة Cordis داخلة فالنطاق >=4.0.5 <5.
3. شغّل DeepSeek Harness Desktop الرسمي مرة وحدة على الأقل، باش يكمل البرنامج تهيئة إعدادات desktop.
4. سد Harness كامل قبل التثبيت، بما فيه اختيار “خروج” من أيقونة علبة النظام ديال Windows فالجهة اليمنى لتحت.
5. نزّل المستودع من مصدر موثوق وراجع محتوى الملفات قبل تشغيل السكريبت.

استعمال سكريبت التثبيت

من صفحة المستودع اختار Code → Download ZIP وفك الضغط، أو استعمل Git لاستنساخ المستودع. من بعد ما تسد Harness كامل، دير نقرة مزدوجة على 点我执行脚本.cmd داخل المجلد المفكوك.

# شغّلو من بعد ما تسد Harness كامل
.\点我执行脚本.cmd

# غير عرض خطة التثبيت بلا تعديل الملفات
.\install.ps1 -DryRun

-DryRun مناسب باش تراجع العمليات اللي غادي ينفذها السكريبت قبل التثبيت الفعلي. المثبّت كيستعمل إعداد desktop افتراضياً، وكيعطي الأولوية لأداة DSH لسطر الأوامر المرفقة مع Desktop. إلا بغيتي تخصّص البيئة، تقدر تحدد اسم الإعداد وأداة سطر الأوامر ودليل البيانات باستعمال -Profile و-DshCommand و-DshHome.

إلا ما كانش DSH_HOME مضبوط، فدليل البيانات الافتراضي هو $env:USERPROFILE\.dsh. سكريبت التثبيت كينسخ الإضافة إلى $DSH_HOME\local-plugins\dsh-prompt-custom، وكيسجلها باستعمال مدير إضافات DSH، ومن بعد كينسخ ملف prompt-custom.json المرفق.

إلا كانت إعدادات البرومبت القديمة مختلفة على الإعدادات الجديدة، المثبّت كينشئ أولاً نسخة احتياطية حدّ الملف الأصلي. إلا فشل التسجيل وكانت النسخة الاحتياطية موجودة، السكريبت كيرجع إعدادات البرومبت الأصلية. من بعد التثبيت الناجح، السكريبت كيحاول حتى يكتب install.log فالمكان المجاور، ولكن هاد الملف ماشي سجل تشغيل كامل.

إلا اكتشف المثبّت أن Harness مازال خدام، غادي يطلب منك تسدو ويوقف، وما غاديش يعدل الملفات فهاد المحاولة. المثبّت ما كيسدش ولا كيعيد تشغيل Harness أوتوماتيكياً، وما كيدعمش المعامل -NoRestart.

شنو تدير إلا حبس Windows السكريبت

المثبّت عبارة عن سكريبت PowerShell قابل للقراءة، وكينفذ أساساً نسخ الملفات واستدعاء أوامر DSH. README كيوضح أنه ما فيهش تشغيل نوافذ مخفية، أو إنهاء إجباري للعمليات، أو إنشاء مهام مجدولة، أو إنشاء عمليات عبر WMI، ولكن هاد الشي ما كيمثلش حكماً من أي برنامج أمني على نتيجة الكشف.

إلا منع Windows السكريبت بسبب علامة مصدر التنزيل، خاصك أولاً تتحقق من مصدر التنزيل وتراجع محتوى السكريبت. وتقدر حتى تحسب قيمة التحقق SHA256 وتقارنها بالقيمة اللي عطاها الناشر:

Get-FileHash .\install.ps1 -Algorithm SHA256

من بعد ما تتأكد من موثوقية الملف، تقدر تحيد علامة مصدر التنزيل من خلال “إلغاء الحظر” فـ “خصائص” الملف داخل Windows.

طريقة التثبيت اليدوي

إلا ما بغيتيش تشغل سكريبت التثبيت الآلي، تقدر تنسخ الإضافة وتسجلها يدوياً من بعد ما تسد Harness كامل. الأوامر التالية كتستعمل دليل البيانات الافتراضي وأداة DSH لسطر الأوامر المرفقة مع Desktop:

$pluginTarget = Join-Path $env:USERPROFILE '.dsh\local-plugins\dsh-prompt-custom'
New-Item -ItemType Directory -Force -Path $pluginTarget | Out-Null
Get-ChildItem -LiteralPath .\plugin -Force | ForEach-Object {
  Copy-Item -LiteralPath $_.FullName -Destination $pluginTarget -Recurse -Force
}

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add $pluginTarget

إلا بغيتي حتى تستعمل إعدادات البرومبت المرفقة مع المستودع، دير أولاً نسخة احتياطية من $env:USERPROFILE\.dsh\prompt-custom.json، ومن بعد نسخ الملف الجديد. من بعد ما يكمل التثبيت، خاصك تعاود تشغل Harness يدوياً.

المسار الأساسي للاستعمال

الخطوة الأولى: تفعيل حقن البرومبتات

من بعد ما تعاود تشغل Harness، قلب حدّ خانة الإدخال على مدخل الحالة “富江破甲”. منين كتفعّلو، الإضافة كتستعمل فقرة فارغة بلاصة الرأس الرسمي harness:identity؛ ومنين كتوقفو كيرجع الرأس الرسمي. النص ديال البرومبت المخصّص ديالك ما كيتحيدش بسبب هاد العملية.

الخطوة الثانية: إعداد مكتبة المهارات

حل لوحة الإعدادات ثم “مكتبة المهارات”، ونزّل وفعّل REA أو AboutSecurity حسب الحاجة. AboutSecurity كينزّل أرشيف الفرع الحالي master من GitHub، وكيستخرج منو غير دليل skills/. عملية التنزيل كتدعم عرض التقدم والإلغاء.

REA كيتطلب نسخة متوافقة من Node.js هي ^22.23.4 || ^24.22.1 || >=26.12.1. منين كتثبّت الإضافة REA عبر npm، كتعطّل سكريبتات دورة الحياة، وبالتالي ما كيتبناش الربط الأصلي الاختياري ديال Frida بهاد الطريقة. واش الأدوات غادي تخدم فعلاً كيبقى متعلقاً ببيئة التشغيل المحلية ومحرك التحليل.

AboutSecurity كيتكوّن أساساً من وثائق مهارات بصيغة Markdown، وما كيحتاجش مكونات تشغيل أصلية إضافية. نجاح تنزيل المهارات كيعني غير أن الملفات توصلات وتسجلات، وما كيعنيش أن كل أداة دازت من التحقق التشغيلي.

الخطوة الثالثة: استعمال قاعدة المعارف للمطابقة المساعدة

قاعدة المعارف مفعّلة افتراضياً، والحالة ديالها محفوظة فـ $DSH_HOME/fujiang-skills/knowledge-state.json. منين كتوقفها، الإضافة ما كتبقاش تقدم محتوى المعرفة المعني للذكاء الاصطناعي، ولكن الملفات الأصلية كاتبقى محفوظة محلياً.

فاختبار مرخّص، تقدر أولاً تشرح للذكاء الاصطناعي المنتج المستهدف، والنسخة، والمنافذ، وتعريف الخدمة ونطاق الاختبار، ومن بعد تطلب منو يقلب على عناصر المعرفة المرتبطة. مثال:

هاد بيئة اختبار عندي عليها ترخيص. عافاك قلب فقاعدة المعارف على العناصر المرشحة اعتماداً على اسم المنتج والنسخة والمنافذ المفتوحة اللي تأكدنا منها، وذكر أسباب المطابقة، والشروط المسبقة المنطبقة، والأدلة اللي مازال خاص التحقق منها، واقتراحات الإصلاح. ما تقدّمش العناصر المرشحة على أنها ثغرات مؤكدة.

عناصر المعرفة هي تجميع لمراجع عامة، وعادة كتستعمل بيانات وصفية بحال verified: false وsources: باش تبيّن حالة التحقق والمصدر. فالاستعمال الفعلي، خاص مراجعتها بالاعتماد على نسخة الهدف وإعداداته وشروطه المسبقة.

الخطوة الرابعة: إنشاء سلسلة مهام اختبار الاختراق

التنفيذ الحالي كيتطلب من المستخدم ينشئ المهمة أولاً فلوحة الإضافة، ومن بعد يقدر الذكاء الاصطناعي يستعمل سجلات المهام الموجودة لتسجيل الأصول والخطوات والنتائج. سلسلة المهام منظمة حسب المراحل التالية:

1. جمع المعلومات
2. التعرف على البصمات
3. مطابقة الثغرات
4. التحقق من الجدوى
5. استغلال الثغرات
6. الحركة الجانبية
7. إخراج التقرير

كل مهمة تقدر ترتبط بجلسة وحدة، وكل جلسة تقدر ترتبط بمهمة وحدة كحد أقصى. الإضافة كتقدم للذكاء الاصطناعي المرتبط المهمة والمرحلة وعدد الأصول والاقتراحات الموالية عبر campaign:context.

من الأحسن تعمّر بوضوح وقت إنشاء المهمة الأهداف المرخّصة، والنطاق المسموح بالعمليات داخلو، والأفعال الممنوعة، ووقت الاختبار وشروط التوقف. تقدم المهمة والمرحلة غير لتنظيم المعلومات، وما كيعاوضوش أدلة التحقق من الثغرة.

الخطوة الخامسة: تسجيل تقرير الثغرة

منين كتكون نتائج التحقق كافية لدعم الاستنتاج، عاد خَلّي الذكاء الاصطناعي يكتب سجل الثغرة. خاص التقرير يتضمن الأصول المتأثرة، وشروط إعادة الإنتاج، والأدلة، وتقييم التأثير، ومستوى الخطورة، واقتراحات الإصلاح والمصادر المرجعية. العناصر المرشحة اللي ما تحققناش منها خاصها تبقى فحالة “في انتظار التحقق”، وما تتعلّمش مباشرة كثغرات.

الواجهات المحلية والأدوات الأصلية

الإضافة كتوفّر واجهة محلية لمطابقة البصمات وواجهة لتدبير سجل المهام. حسابات المطابقة وكتابة السجل كيتدارو فالجهاز المحلي، ولكن تنزيل المهارات، واستدعاءات النماذج عبر الشبكة، والتحقق الفعلي من الأهداف يقدرو يسببو طلبات شبكية.

• POST /api/dsh-prompt-custom/match: كيرجع العناصر المرشحة المرتبة من قاعدة المعارف وأسباب المطابقة اعتماداً على المنفذ أو تعريف الخدمة أو اسم المنتج. الأوزان هي: المنفذ 40، المنتج 30، CVE 20، الكلمات المفتاحية 20، مستوى الخطورة 5.
• /api/dsh-prompt-custom/campaigns: تدبير نطاق الاختبار، وبصمات الأصول، وخطوات التنفيذ، وسجلات المحاولات ومراحل المهمة. السجل محفوظ فـ $DSH_HOME/vuln-report/campaigns.json.
• GET ?id=: قراءة المهمة المحددة والاقتراح الموالي.

واجهة المهام كتوفّر حتى عمليات بحال bind وunbind وkick. الأدوات الأصلية كتشمل kb_match وcampaign_upsert وfinding_upsert وpipeline_next؛ ومداخل البحث فالمهارات كتشمل skill_search وskill_read. تسجيل الأدوات الأصلية كيعتمد على خدمة أدوات DSH اللي يمكن تحليلها.

نصائح للاستعمال المتقدّم

استعمل DryRun أولاً باش تراجع خطة التثبيت

فأول تثبيت ولا ملي كتبدّل مجلد الإعدادات، شغّل أولاً .\install.ps1 -DryRun. بهاد الطريقة تقدر تتأكد من المسار المستهدف، واسم الإعدادات، والعمليات المتوقعة، وكتفادى تعديل الملفات مباشرة.

دير نسخ احتياطية منفصلة للإضافة وللتوجيهات الشخصية

prompt-custom.json مستقل على برنامج الإضافة، وقد يحتوي على إعدادات شخصية. قبل الترقية ولا إعادة التوزيع، خاصك تدير ليه نسخة احتياطية بوحدو وتراجع المحتوى ديالو، باش ما تمسحش التخصيصات ولا تشارك معلومات حساسة بلا قصد.

فرّق بين المطابقات المرشحة والثغرات المؤكدة

مطابقة البصمة غير كتستعمل المنافذ والمنتج وCVE والكلمات المفتاحية ومستوى الخطورة لترتيب العناصر المرشحة. الترتيب العالي ما كيعنيش بالضرورة أن الهدف متأثر. خاصك تكمل التحقق من الإصدار، وطريقة النشر، وحالة التصحيحات، والشروط المسبقة، والأدلة الفعلية.

استعمل التشغيل المتواصل بحذر

التشغيل المتواصل كيكون افتراضياً حتى لـ 8 دورات كحد أقصى، ومعاه كشف التوقف واقتراح الخطوة الجاية. ملي كتستعملو، خاصك تحدد بوضوح حدود التفويض وشروط التوقف، وتبقى كتراجع يدوياً باستمرار، باش ما ينفذش النموذج عمليات لاحقة غير مناسبة بسبب نقص السياق.

فهم طريقة تحديث قاعدة المعرفة

عناصر المعرفة كاينة فـ plugin/knowledge/، وكيعاود يقرا الملفات كل مرة كيتحمّل فيها عنصر، وبهذا تقدر التحديثات ديال المحتوى تبان فاستدعاءات لاحقة. تعريفات التصنيفات كاينة فـ lib/knowledge.js؛ إلا بدّلتي التصنيفات، خاصك تعاود تحميل الإضافة.

شخّص مشاكل اختصارات الإدخال

README كيسجل حالة معروفة: من بعد ما كتسد نافذة إخلاء المسؤولية، ممكن يبقى مستمع Enter ولا Esc كيأثر على الإدخال والاختصارات. إلا وقع مشكل، تقدر أولاً تشوف واش مرتبط بهاد المشكل المعروف، ومن بعد تعاود تحميل الإضافة ولا تعاود تشغيل Harness.

حدود التوافق والتحقق

الإضافة كتخدم عبر systemPrompt وskills وtools ودورة حياة الوكيل وخدمة webServer العمومية، وما كتتثبتش بتعديل ملفات برنامج Harness. من بعد التثبيت، خاصك تخرج من Harness بالكامل وتعاود تشغلو.

README كيشير بلّي النسخة الحالية تراجعات فيها بنية الملفات ومنطق التثبيت، ولكن ما تعاودش التحقق عملياً من جميع الوظائف. لذلك، ما يمكنش نضمنو بناءً على هاد الشي أن جميع المهارات ولا عناصر CVE ولا المسارات المؤتمتة غادي تخدم. قبل النشر فبيئة الإنتاج، خاصك تتحقق من كل عنصر بوحدو فبيئة اختبار معزولة ومصرّح بها.

الخلاصة

富江破甲 كيدمج تدبير التوجيهات، والمهارات الأمنية، وقاعدة المعرفة المدمجة، وتقارير الثغرات، وسجلّ المهام داخل DeepSeek Harness. الطريقة الصحيحة للاستعمال هي تبدأ بمراجعة التوافق وخطة التثبيت، ومن بعد تهيّأ المهارات وقاعدة المعرفة، وفالأخير تنشئ المهام داخل نطاق تفويض واضح، وتتحقق من العناصر المرشحة، وتحفظ الأدلة. ديماً خَلّي المراجعة البشرية، وأقل الصلاحيات، والأدلة الموثوقة قبل الأتمتة.