ملف اختبار اختراق وكيلي (Agentic) لـ Hermes: 31 دليل تشغيل (playbook) للاستطلاع المصرح به، وهجمات الويب والتحكم في الوصول، والتحقق الآمن من استغلال الثغرات، وإعداد تقارير مبنية على الأدلة مع بوابات حماية.
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/50022/55f1c11f1fa53cb32838b487d5b5b6f1745b609c7123ce0a2b28ff21108c765b.png" alt="Violin" width="256"/>
</p>
<h1 align="center">Violin ☤ — ملف تعريف اختبار اختراق Hermes الوكيلي الخاضع للإشراف</h1>
<p align="center">
<a href="https://github.com/Strategic-Automation/violin"><img src="https://img.shields.io/badge/Status-Release%20Ready-2ea44f?style=for-the-badge" alt="Release Ready"></a>
<a href="https://github.com/Strategic-Automation/violin/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue?style=for-the-badge" alt="License: MIT"></a>
<a href="https://hermes-agent.nousresearch.com/"><img src="https://img.shields.io/badge/Hermes-%3E=0.21.5-FFD700?style=for-the-badge" alt="Hermes >=0.21.5"></a>
<a href="https://www.kali.org/"><img src="https://img.shields.io/badge/Kali%20Linux-557C94?style=for-the-badge&logo=kali-linux&logoColor=white" alt="Kali Linux"></a>
<a href="https://www.parrotsec.org/"><img src="https://img.shields.io/badge/Parrot%20OS-2E8B57?style=for-the-badge" alt="Parrot OS"></a>
<a href="https://strategic-automation.github.io/violin/"><img src="https://img.shields.io/badge/Site-Landing%20page-FF3B4A?style=for-the-badge" alt="Landing page"></a>
<a href="https://github.com/Strategic-Automation/violin/stargazers"><img src="https://img.shields.io/github/stars/Strategic-Automation/violin?style=for-the-badge&color=FFD166" alt="GitHub stars"></a>
</p>
<p align="center">
<b>35 دليل تشغيل · 19 مرجعًا · 14 قالبًا · حارس تنفيذ إلزامي · أصيل في Hermes</b>
</p>
Violin هو **ملف تعريف اختبار اختراق وكيلي أصيل في Hermes** لاختبارات الاختراق الخاضعة للإشراف والمصرّح بها — من الاستطلاع مرورًا بالتحقق الآمن من الاستغلال وصولًا إلى إعداد التقارير. يستخدم مجموعات الأدوات المدمجة في Hermes، وسبع مهارات موجّهة، وإضافة `violin_guard` الإلزامية عند حدود تنفيذ الأهداف. تدعم واجهة سطر الأوامر المستقلة فحوصات الإصدار والتشخيص والاسترداد الإداري؛ أما أوامر الأهداف فتُنفَّذ عبر الإضافة. لا يضيف Violin أي بيانات اعتماد خاصة بملف التعريف، ويرث موفّري الخدمة والخلفيات الأدواتية المهيّأة مسبقًا في Hermes.
<p align="center">
<a href="#quick-start">البدء السريع</a> ·
<a href="#engagement-lifecycle">سير العمل</a> ·
<a href="#guard-tools">أدوات الحارس</a> ·
<a href="#benchmarks">المعايير القياسية</a> ·
<a href="https://strategic-automation.github.io/violin/">الصفحة الرئيسية</a> ·
<a href="https://github.com/Strategic-Automation/violin/discussions">المناقشات</a> ·
<a href="#development">التطوير</a>
</p>
<p align="center">
<strong>هل تتابع Violin؟</strong>
<a href="https://github.com/Strategic-Automation/violin/stargazers">ضع نجمة على المستودع</a>
ليبقى سهل العثور عليه ومساعدة مهندسي الأمن الآخرين على اكتشاف اختبار الاختراق الوكيلي الخاضع للإشراف.
</p>
### الاكتشاف المجتمعي
Violin مُدرج في مجموعات منسّقة مجتمعيًا تشمل
[awesome-ai-security](https://github.com/gmh5225/awesome-ai-security)،
و[awesome-hermes-skills](https://github.com/ZeroPointRepo/awesome-hermes-skills)،
و[awesome-hermes-agent](https://github.com/Anil-matcha/awesome-hermes-agent)، و
[awesome-infosec](https://github.com/onlurking/awesome-infosec).
تغطية من جهات خارجية:
[تحليل Starlog التقني](https://starlog.is/articles/cybersecurity/strategic-automation-violin) و
[«Violin: ملف تعريف اختبار اختراق وكيلي خاضع للإشراف لوكيل Hermes»](https://hamradio.my/violin-supervised-agentic-pentest-profile-hermes/).
للتقييم المستقل، استخدم
[مجموعة المراجع](https://strategic-automation.github.io/violin/review.html)، التي
تجمع مسار المعايير القياسية والحدود المعروفة وسياق المراجعة ومقارنة
واقعية مع تصاميم وكلاء اختبار الاختراق المستقلين.
---
<table>
<tr><td width="240"><strong>تنفيذ مستهدف محمي</strong></td><td>تُجرى فحوصات النطاق والمرحلة وPTT والمهارة والفرضية والسجل والمزامنة قبل بدء أي أمر مستهدف.</td></tr>
<tr><td><strong>حالة اشتباك دائمة</strong></td><td>تبقى مهام PTT والفرضيات وسجل الأوامر ونقاط التحقق والأدلة والتقارير صامدة أمام ضغط السياق.</td></tr>
<tr><td><strong>نتائج مدعومة بالأدلة</strong></td><td>يربط إرسال مُنمَّط كل نتيجة مُتحقَّق منها بإيصالات تنفيذ موثّقة.</td></tr>
<tr><td><strong>منهجية موجَّهة</strong></td><td>يختار منسّق اختبار الاختراق أدلة تشغيل مركّزة للويب والهوية وواجهات API ومنطق الأعمال وأمن LLM وسوء التكوين.</td></tr>
<tr><td><strong>تنفيذ محدود النطاق</strong></td><td>تتشارك الأوامر المفردة ودفعات الأوامر والعمليات الخلفية ومراجعة الدفعات وفحوصات النبض والإلغاء نموذج حالة واحدًا.</td></tr>
<tr><td><strong>إصدارات قابلة للتحقق</strong></td><td>تخضع تسجيلات الإضافات والمخططات ولقطات المهارات وعقود التوثيق والفحص والتنسيق ومجموعة الاختبارات الكاملة لبوابات الإصدار.</td></tr>
</table>
## البدء السريع
### تثبيت الملف التعريفي
```bash
hermes profile install https://github.com/Strategic-Automation/violin
hermes -p violin plugins disable violin_guard
hermes -p violin plugins enable violin_guard --no-allow-tool-override
hermes -p violin
```
تُعلَن تبعيات الحارس في `plugins/violin_guard/plugin.yaml`. يستخدم اسم الإضافة والدليل وإعدادات التمكين جميعًا `violin_guard`، لذا يستطيع Hermes حلّ تبعياته دون الحاجة إلى حل بديل على مستوى الدليل. إن تثبيت التبعيات في `.venv` الخاص بالتطوير لا يثبّتها في Hermes. وتفرض دورة التعطيل/التمكين أعلاه قبول التبعيات حتى عندما يكون إعداد الملف الشخصي قد فعّل الإضافة بالفعل. تحقّق من التسجيل بعد التثبيت:
```bash
hermes -p violin plugins doctor ~/.hermes/profiles/violin/plugins/violin_guard --ci
hermes -p violin tools list
```
يجب أن يُبلّغ Plugin Doctor عن 12 أداة و5 خطافات، ويجب أن يظهر `violin_guard`
كطقم أدوات مُفعّل. أعد تشغيل Hermes بعد التثبيت قبل بدء
مهمة. أعد تثبيت الملف الشخصي لترحيل تثبيت `violin-guard` الأقدم.
ثم ابدأ بهدف مُصرّح به ودع Violin يجمع النطاق قبل
أي تفاعل مع الهدف:
```text
Run an authorized penetration test against example.com.
```
### المتطلبات
- [Hermes Agent](https://hermes-agent.nousresearch.com/) 0.21.5 أو أحدث (يثبّت الحاوية التزام إصدار `v2026.9.24`)
- Python 3.11 و`uv` للتطوير المحلي
- Kali Linux أو Parrot OS لبيئة أدوات الأمان المتوقعة
- تفويض مكتوب ونطاق معتمد
لا يختار Violin نموذجًا أو مزوّدًا. قم بتهيئة ذلك في Hermes. للحصول على
إعداد افتراضي قادر، استخدم **Qwen3.8 27B** محليًا أو **DeepSeek V4 Flash** عبر
مزوّد مستضاف.
## دورة حياة المهمة
```mermaid
flowchart LR
S[Scope] --> R[Recon]
R --> V[Vulnerability research]
V --> E[Exploit validation]
E --> P[Reporting]
P --> X[Retrospective]
G[Violin Guard] -. validates .-> R
G -. validates .-> V
G -. validates .-> E
```
1. ابدأ المهمة واعتمد `scope/scope.yaml`.
2. اختر مهمة PTT نشطة واحدة ومهارتها الموجّهة باستخدام
`violin_record_ptt`.
3. نفّذ أوامر الهدف باستخدام `violin_exec` أو `violin_exec_burst`.
4. حدّث الفرضيات مع تغيّر حالتها بناءً على الأدلة.
5. راجع كل دفعة أوامر محدودة باستخدام `violin_review_batch`.
6. قدّم النتائج المتحقق منها وأنشئ التقرير النهائي.
7. أكمل مراجعة ما بعد المهمة.
نموذج المراحل الكامل هو:
```text
SCOPING → RECON → VULN_RESEARCH → EXPLOITATION
→ POST_EXPLOITATION / PRIVESC / FLAGS
→ REPORTING → RETROSPECTIVE
```
بدء العمل في مرحلة جديدة يتطلب مهمة PTT ضمن تلك المرحلة. لا يتم نقل المهام
الموجودة بين أقسام المراحل.
## أدوات الحماية
تسجّل الإضافة اثنتي عشرة أداة Hermes من سجل واحد مُنمّط:
| الأداة | الغرض |
|---|---|
| `violin_record_ptt` | إنشاء مهمة PTT أو بدؤها أو تحديثها أو إغلاقها أو إلغاؤها |
| `violin_record_hypothesis` | إنشاء فرضية محددة النطاق أو تحديثها |
| `violin_submit_finding` | تقديم نتيجة مُتحقَّق منها مرتبطة بإيصالات تنفيذها الموقّعة |
| `violin_exec` | تنفيذ أمر واحد محمي |
| `violin_exec_burst` | تنفيذ ملف أوامر محدود |
| `violin_exec_status` | قراءة حالة التنفيذ في الخلفية |
| `violin_exec_cancel` | إلغاء تنفيذ خلفي متتبَّع |
| `violin_review_batch` | مراجعة دفعة مكتملة وتسوية حالتها |
| `violin_rebind_pending_batch` | إعادة ربط دفعة معلّقة بعد التأكيد |
| `violin_heartbeat_done` | مسح مراجعة نبضة مكتملة |
| `violin_target` | تحديد هدف التقييم المعتمد |
| `violin_status` | توضيح المهام والمهارات والمعوّقات الحالية |
`violin_exec` هو الحدّ العام لأوامر الهدف. لا توجد
محوّلات تنفيذ خاصة بأدوات معينة ولا قوائم سماح ثنائية. لا يجوز تشغيل الأدوات
غير التفاعلية المثبَّتة إلا بعد اجتياز بوابات المهمة.
خطاف الطرفية الخام هو شبكة أمان بأفضل جهد ممكن، وليس احتواءً شبكيًا.
استخدم `terminal` فقط للتحضير والإدارة المحلية على المضيف.
## نموذج السلامة
```mermaid
flowchart LR
A[Written authorization] --> B[Approved scope]
B --> C[Active phase task]
C --> D[Skill and hypothesis gates]
D --> E[Guarded execution]
E --> F[Evidence receipt]
F --> G[Batch review]
```
- لا تفاعل مع الهدف قبل الموافقة على النطاق والتحقق من التهيئة الأولية.
- لا تنفيذ أوامر shell خام لأوامر الهدف.
- لا إجراء تدميري أو تعطيلي أو يتعلق ببيانات الاعتماد أو الاستمرارية أو التخفي أو
طرف ثالث دون تفويض كتابي صريح.
- تبقى الأدلة الخام تحت `$ENG_DIR/evidence/<phase>/`.
- تبقى الأسرار والمخلفات ومخرجات الإثبات خارج `$ENG_DIR/state/`.
- يُستأنف ضغط السياق من ملفات المهمة في محادثة Hermes
الحالية.
السياسة التفصيلية موجودة في
[`skills/pentest/references/standards.md`](https://github.com/strategic-automation/violin/blob/master/skills/pentest/references/standards.md).
## حالة المهمة
ينشئ `init-engagement` بنية العمل الأساسية:
```text
$ENG_DIR/
├── scope/
│ └── scope.yaml
├── state/
│ ├── ptt.md
│ ├── history.md
│ └── checkpoint.json
├── hypotheses.md
├── evidence/
├── reporting/
└── retrospective/
```
### الترقية من Violin 3.3
يخزّن Violin 4.0 حالة المنفّذ في `state/runtime.json` ولا يقوم بترحيل ملفات
`sync.json` أو `counts.json` أو `heartbeat.json` الخاصة بالإصدار 3.3. ابدأ
مهمة جديدة في دليل جديد؛ واحتفظ بدليل الإصدار 3.3 كسجل تاريخي.
إعادة استخدام دليله تُبقي ملفات الحالة القديمة في مكانها، لذا سيرفضها Violin 4.0.
### تسليم المهارات
تُحمَّل المهارات عند الطلب. قد يُرجع أول استدعاء لـ `violin_record_ptt` لمهارة
موجَّهة النتيجة `skill_prepared` دون تغيير الـ PTT. بعد أن يسلّم Hermes
محتوى المهارة، كرّر الانتقال لربط الإيصال وتطبيق
تغيير المهمة. يُبلّغ `violin_status` عن إجراء الاسترداد الدقيق.
ملفات العلامات مثل `.skill-loaded-*` لا تُثبت تسليم المهارة.
## المهارات الموجَّهة
| المهارة | التغطية |
|---|---|
| `pentest` | النطاق، دورة الحياة، الاستطلاع، الاستغلال، إعداد التقارير، الإغلاق |
| `web-app` | الحقن، SSRF، اجتياز المسارات، إلغاء التسلسل، العيوب من جهة العميل |
| `identity-auth` | المصادقة، التخويل، IDOR، JWT، CSRF، التشفير |
| `api-testing` | REST، SOAP، GraphQL، WebSocket |
| `business-logic` | سير العمل، التسعير، القسائم، الحصص، الإحالة، حالات التسابق |
| `llm-security` | حقن الأوامر (Prompt injection)، MCP، JSON-RPC |
| `misconfig` | النشر، معالجة الأخطاء، القابلية للمراقبة، الغموض |
يحمّل المنسّق فقط مواد المرحلة ودليل اللاعب المتخصص اللازمين
للمهمة الحالية.
## واجهة سطر الأوامر الإدارية
لا تحل واجهة سطر الأوامر محل تنفيذ الأهداف المحمي.
```bash
python scripts/violin_guard.py --help
python scripts/violin_guard.py init-engagement engagements/example --host example.com
python scripts/violin_guard.py check-bootstrap --eng-dir engagements/example
python scripts/violin_guard.py status --eng-dir engagements/example
python scripts/violin_guard.py generate-closeout --eng-dir engagements/example
python scripts/violin_guard.py check-release
```
`check-command` يعرض فحوصات القبول لأغراض التشخيص ولا ينفّذ
الأمر المقدَّم.
## البنية
```text
plugins/violin_guard/
├── core/
│ ├── commands/ shell parsing, targets, HTTP proof
│ ├── engagement/ state, PTT, phases, hypotheses, bootstrap
│ ├── evidence/ findings, history, receipts, redaction
│ └── skills/ skill policy and receipts
├── gates/ command, scope, hypothesis, terminal policies
├── engine/ execution, runtime backend, code audit, release checks
├── handlers/ public Hermes tool handlers
├── hooks.py Hermes lifecycle hooks
└── registry.py registered tool definitions
skills/ orchestrator, routed skills, playbooks, references
benchmark/ runner, scorer, proof checks, calibration fixtures
scripts/ administrative CLI and platform smoke tests
tests/ runtime, integration, documentation, release tests
```
## المعايير القياسية
يتضمن المستودع تعريف Escape Duck Store بالإضافة إلى نماذج تقييم معروفة-جيدة ومعروفة-سيئة. يُثبت المعايرة أن أداة التقييم تتعامل مع تلك النماذج؛ لكنها لا تُثبت استدعاء الوكيل الحي، أو إتمام سير العمل، أو جودة التقرير.
```bash
uv run python -m benchmark.score --calibrate known-good
uv run python -m benchmark.score --calibrate known-bad
uv run python -m benchmark.run \
--target http://localhost:<published-port> \
--provider <provider> \
--api-base <openai-compatible-base-url> \
--model <model-id> \
--target-isolation-id escape-duck-store-2026-04:<image-digest-or-reset-id>
```
اقرأ [منهجية القياس المرجعي](https://github.com/strategic-automation/violin/blob/master/docs/BENCHMARKS.md) قبل نشر أي نتيجة.
فهي تحدد متطلبات الإثبات وقابلية إعادة الإنتاج والتقييم الخاص والإفصاح
اللازمة للحصول على نتيجة موثوقة.
## التطوير
```bash
uv sync --dev
uv run pytest
uv run ruff check .
uv run ruff format --check .
uv run python scripts/violin_guard.py check-release
```
تتحقق بوابة الإصدار من أسطح الإصدارات، واستيراد الإضافات المعزول، والأدوات المسجّلة، والمخططات المُولّدة، ولقطات المهارات، وعقود التوثيق، وRuff، ومجموعة الاختبارات الكاملة.
اختبارات الدخان للمنصات:
- `scripts/smoke-test.sh` — اختبار دخان لإصدار Linux وKali/Parrot
- `scripts/smoke-test.ps1` — اختبار دخان لتهيئة Windows والنطاق وحلّ الأهداف؛ يتطلب تسليم المهارات وتنفيذ الأهداف وجود Hermes
راجع [CONTRIBUTING.md](https://github.com/strategic-automation/violin/blob/master/CONTRIBUTING.md) للاطلاع على قواعد المساهمة، و[SECURITY.md](https://github.com/strategic-automation/violin/blob/master/SECURITY.md) للإبلاغ الخاص عن الثغرات.
## الاستخدام المسؤول
صُمم Violin لتقييم الأمن المصرّح به. يتحمل المشغّلون مسؤولية النطاق والموافقات وملكية الأهداف والتعامل مع البيانات والقانون المحلي.
## دعم Violin
Violin مشروع مفتوح المصدر تديره Strategic Automation Ltd.
إذا كان Violin مفيدًا لك أو لمؤسستك، يمكنك
[رعاية استمرار تطويره](https://github.com/sponsors/Strategic-Automation).
تدعم الرعاية استمرار التطوير والاختبار والتوثيق وأعمال التوافق والإصدارات.
يبقى Violin متاحًا بموجب ترخيص MIT. لا تشمل الرعاية دعمًا مضمونًا، أو أولوية في الميزات، أو تأثيرًا على سياسة الأمان.
## الترخيص
MIT — راجع [LICENSE](https://github.com/strategic-automation/violin/blob/master/LICENSE).