gori

التثبيت • الاستخدام • التوثيق • المساهمة

---

gori (고리 — كلمة كورية تعني حلقة، رابط، طوق) يجلس في الحلقة بين عميلك وهدفه، ملتقطًا كل طلب واستجابة كـ تدفّق يمكنك إعادة تشغيله، وتشويشه، وفحصه عبر HTTP/1.1، وHTTP/2، وWebSocket، وgRPC، وSSE، والاعتراض أثناء الطيران على HTTP/1.1 وHTTP/2. إجراءات التقييم الأساسية التي تعبر الأسطح تستخدم المحركات نفسها، وهذه سير العمل متاحة أيضًا عبر gori run وMCP، بحيث يمكن للسكربتات ووكلاء الذكاء الاصطناعي قيادة نفس المهمة. تُسمّي مصفوفة القدرات حدود البروتوكول والسطح صراحةً.

الميزات

الالتقاط والاعتراض

• وكيل التقاط لـ HTTP/1.1، وHTTP/2، وWebSocket، وgRPC، وSSE
• الاعتراض على HTTP/1.1 وHTTP/2، بما في ذلك gRPC: احتفظ، أو حرّر، أو مرّر، أو أسقط أثناء الطيران — ولكل رسالة على WebSocket عبر HTTP/1.1، فعّلها بالاشتراك مع proto:ws
• History قابل للبحث لكل تدفّق، مع لغة استعلام للتصفية
• قواعد النطاق، وتجاوزات أسماء المضيفين، والمطابقة والاستبدال

إعادة التشغيل والتشويش وفك الترميز

• منصة عمل Repeater لصياغة الطلبات وإعادة إرسالها (بما في ذلك WebSocket وgRPC)
• Fuzzer بأسلوب Intruder مع أربعة أنماط هجوم
• خط أنابيب Decoder لتسلسل الترميز / فك الترميز / التجزئة، بما في ذلك كوكيز الجلسات الموقّعة
• Comparer جنبًا إلى جنب لمقارنة تدفقين
• فك ترميز مضمّن لـ JWT / SAML / GraphQL / protobuf / MessagePack / CBOR، وعرض سداسي عشري، وطباعة جميلة
• انسخ أي طلب كـ cURL، أو Python، أو fetch، أو Go، أو httpie، أو CSRF PoC

الاكتشاف والفحص

• ماسح ثغرات Probe السلبي والخفيف النشط
• Param Miner لاكتشاف المعاملات المخفية
• مصفوفة Authorize: أعد تشغيل طلب واحد تحت عدة هويات للعثور على التحكم المكسور في الوصول
• Sequencer لتقييم عشوائية رموز الجلسة، وCSRF، وإعادة التعيين
• منصة عمل Cookie للتحقق من كوكيز جلسات Flask / Rack / Django وكسرها وإعادة توقيعها
• مجمّع OAST لتأكيد SSRF الأعمى، وXXE، والحقن خارج النطاق
• فرز النتائج مع التصدير بصيغة Markdown / JSON / SARIF

سير عمل يعتمد على لوحة المفاتيح أولًا

• لوحة الأوامر (Ctrl-P) وقائمة مساحة السياق (Space) تصلان إلى كل إجراء
• اختصارات مفاتيح قابلة لإعادة الربط وسمات ألوان قابلة للتبديل
• دعم الفأرة، والتحرير متعدد الأسطر، والانتقال إلى سطر محدد

بلا واجهة وقابل للبرمجة النصية

• gori run يعرّض سير عمل المشروع والاختبار الأساسي للاستخدام غير التفاعلي
• خادم MCP (gori mcp) يعرّض سير العمل هذه لوكلاء الذكاء الاصطناعي (لا يبدأ وكيل التقاط)

التثبيت

تثبيت سريع (macOS / Linux)

curl -fsSL https://gori.hahwul.com/install.sh | bash

ثم حدّث لاحقًا باستخدام gori update (التحديث الذاتي لعمليات التثبيت الثنائية؛ إرشادات مدير الحزم لـ Chocolatey / Homebrew / Snap / AUR).

على Windows، استخدم Chocolatey، أو نزّل gori-windows-x86_64.exe من Releases، وأعد تسميته إلى gori.exe وضعه على PATH الخاص بك.

Chocolatey

تقوم حزمة Chocolatey بتثبيت الملف الثنائي Windows x86_64:

choco install gori

Homebrew

brew tap hahwul/gori
brew install gori

Nix

المستودع عبارة عن flake، لذا يعمل دون الحاجة إلى تثبيته:

nix run github:hahwul/gori
nix profile install github:hahwul/gori   # or keep it

من المصدر

يتطلب Crystal >= 1.21.0 وpkg-config.

git clone https://github.com/hahwul/gori.git
cd gori
shards build --release

يُكتب الملف التنفيذي إلى bin/gori.

لمكتبات النظام (Brotli / Zstd)، وعمليات البناء دون اتصال، وخيارات أخرى، راجع دليل التثبيت.

الاستخدام

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

للبشر: gori (TUI)

ابدأ الوكيل وافتح واجهة الطرفية التفاعلية. لا حاجة إلى أمر فرعي:

gori

يستمع الوكيل (proxy) افتراضيًا على 127.0.0.1:8070، ويختار معالج إعداد قصير عند التشغيل الأول الافتراضي العام للربط (bind) والسمة (theme) (يمكن للمشاريع تثبيت إعداداتها الخاصة لاحقًا). لاعتراض HTTPS، ثِق بشهادة الجذر (root CA) الخاصة بـ gori. أسرع طريق هو Open browser (Ctrl-P) في لوحة الأوامر، والذي يشغّل متصفحًا موثوقًا ومُمرَّرًا عبر الوكيل مسبقًا. تصل حركة المرور المعترَضة إلى History؛ اضغط Ctrl-P لفتح لوحة الأوامر أو Space لإجراءات السياق.

gori --listen 0.0.0.0 --port 8080   # global bind for this run only (not persisted)

لوكلاء الذكاء الاصطناعي: gori mcp (خادم MCP)

gori mcp هو خادم Model Context Protocol. يقوم عميل الذكاء الاصطناعي بتشغيله عبر stdio، ويقرأ حركة المرور الخاصة بك، ويشغّل نفس الأدوات التي تشغّلها أنت. دع gori يكتب الإعدادات لوكيلك، ثم أعد تشغيل العميل:

gori mcp --install-claude-code   # Claude Code   (~/.claude.json)
gori mcp --install-claude        # Claude Desktop
gori mcp --install-codex         # OpenAI Codex
gori mcp --install-agy           # Antigravity CLI
gori mcp --install-grok          # Grok
gori mcp --install-hermes        # Hermes        (~/.hermes/config.yaml)
gori mcp --install-pi            # Pi            (~/.pi/agent/mcp.json)

يحتاج Pi إلى محوّل MCP، مثل pi-mcp-adapter (pi install npm:pi-mcp-adapter). يحترم المثبّت PI_CODING_AGENT_DIR عند تعيينه.

أضف --read-only لتسليم مشروع إلى وكيل غير موثوق (أدوات قراءة فقط، دون طلبات حية). يشرح دليل إعداد الذكاء الاصطناعي كيفية ربط وكيل و تشغيل طلبك الأول.

للسكربتات: gori run (واجهة سطر أوامر بلا واجهة تفاعلية)

يعرض gori run محرّكات المشروع والاختبار الأساسية نفسها دون الواجهة التفاعلية. وهو مصمّم للسكربتات والتكامل المستمر (CI)، لكنه يعمل بالقدر ذاته من الجودة يدويًا أو من صدفة وكيل:

gori run history --format json      # dump captured flows as JSON
gori run sitemap                    # endpoints seen so far
gori run --help                     # every subcommand

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

التطوير

shards build          # debug binary at bin/gori (add --release to optimise)
shards run gori       # run without installing

إذا فشل الربط بسبب رموز BrotliDecoder* غير المعرّفة، فإن libbrotlidec مفقودة أو أن pkg-config لا يستطيع العثور عليها — راجع دليل التثبيت للحصول على مكتبات النظام و بناء -Dwithout_native_codecs دون اتصال.

المساهمون