---

لقطات الشاشة

لوحة المعلومات (نظرة عامة / استخدام الرموز / سجل النشاط)	قائمة المهام

المهمة · التنفيذ (الجلسات / استدعاءات الأدوات)	رسم الاستكشاف البياني

النتائج	الأصول

رسم تغطية الأصول البياني (تخطيط موجّه بالقوى · إبراز المُختبَر · طي/توسيع العُقد)

تسجيل حركة المرور	محادثة بمشاركة بشرية

إدارة الوكلاء	إعداد نموذج اللغة الكبير

موافقات الاعتراض	سجلات الخلفية

---

تفاصيل سجل الموافقات

يدعم كلٌّ من "سجلات الموافقات" العامة، و"موافقات الاعتراض" داخل المهمة، وبطاقات الموافقة في المحادثات التوسّع لعرض التفاصيل. يشير هيكل العرض إلى مكوّن تفاصيل الموافقة في AegisHook، مع إعادة استخدام مكوّنات ARTEX وسمتها:

إضافة المتصفح لالتقاط حركة المرور

تحوّل إضافة المتصفح المرفقة (extension/) تصفحك الخاص إلى أدلة مرئية للوكيل: سجّل الدخول مرة واحدة إلى هدف يتطلب مصادقة (بما في ذلك رموز التحقق CAPTCHA ورموز OTP عبر البريد الإلكتروني والمصادقة الثنائية 2FA)، وستصل الطلبات/الاستجابات الملتقطة إلى مخزن حركة المرور في ARTEX مثل حركة المرور المسجلة عبر الوكيل، جاهزة للبحث وربطها بالنتائج:

• حمّل الإضافة غير المحزومة من extension/ (Chrome/Edge، وضع المطوّر ← تحميل غير محزوم)؛
• في النافذة المنبثقة، عيّن عنوان ARTEX والرمز الخاص بك، ثم اضغط بدء الالتقاط على علامة التبويب التي تتصفحها؛
• استخدم الموقع بشكل طبيعي؛ تُرسَل طلبات/استجابات النصوص على دفعات إلى POST /api/traffic/ingest (بمصادقة). تُتجاهل الأجسام الثنائية (الصور والخطوط)، وتُقتطع الأجسام عند 256 KiB، وتُحدّ الدفعات بـ 50 مدخلًا؛
• اضغط إيقاف عند الانتهاء. يبقى كل شيء في مخزن حركة المرور المحلي لديك.

مزامنة الأصول (ScopeSentry)

زامن بيانات الأصول مباشرةً من ScopeSentry، لتجنّب الجمع المكرر:

• في صفحة "مزامنة الأصول"، أدخل عنوان ScopeSentry ومفتاح API للاتصال بمصدر البيانات؛
• اختر الأهداف وأنواع الأصول للمزامنة حسب المشروع أو المهمة (النطاقات / النطاقات الفرعية / عناوين IP / المنافذ / المواقع / نقاط النهاية…)؛
• استيراد بنقرة واحدة، يُدمج حسب نطاق أصول الشركة، مباشرةً في رسم أصول ARTEX البياني ليستكشفه الوكلاء.

---

التثبيت

يتطلب قاعدة بيانات PostgreSQL؛ ويتطلب الاستكشاف نموذجًا لغويًا كبيرًا LLM (ANTHROPIC_API_KEY أو OPENAI_API_KEY، ويمكن أيضًا تهيئته في الواجهة).

الخيار 1: نص تثبيت بنقرة واحدة (موصى به)

git clone https://github.com/BaaRai/ARTEX.git
cd ARTEX
./install.sh

سيقوم السكربت بما يلي: اكتشاف Docker / تثبيته تلقائيًا → ثم يتيح لك الاختيار بين ① الكل عبر Docker أو ② البناء والتشغيل محليًا:

• ① الكل عبر Docker: أدخل كلمة مرور Postgres (اضغط Enter لاختيار كلمة عشوائية) → يكتب .env تلقائيًا → docker compose up -d.
• ② التشغيل المحلي: اختر قاعدة بيانات (الاتصال بقاعدة موجودة / تشغيل واحدة باستخدام Docker) → يُنشئ config.json → يبني go الملف التنفيذي الواحد المضمّن → يبدأ التشغيل.

بعد التثبيت، افتح http://localhost:8787 (عند الدخول لأول مرة، يقوم /setup بتعيين كلمة مرور المسؤول).

الخيار 2: Docker Compose (يدويًا)

git clone https://github.com/BaaRai/ARTEX.git
cd ARTEX
cp .env.example .env          # set POSTGRES_PASSWORD, optionally ANTHROPIC_API_KEY
docker compose up -d          # pulls the autumn27/artex image + postgres
# → http://localhost:8787

الصورة تتضمن بالفعل أدوات شائعة (ripgrep/curl/vim/npm/nmap…)؛ يتم حفظ ./skills و./data عبر عمليات التركيب bind mounts.

بالنسبة لـ MCP عن بُعد، يمكنك اختيار http (Streamable HTTP) أو sse (SSE القديم) في إعدادات النظام. عادةً ما تنشئ خوادم SSE القديمة تدفق الأحداث باستخدام GET /sse، ثم تستقبل طلبات JSON-RPC عبر /message?sessionId=... الذي يعيده الخادم؛ عند التكوين، اضبط عنوان URL على /sse وترويسة الطلب على Authorization=Bearer <token>.

الخيار 3: تنزيل الملفات التنفيذية الجاهزة (Releases)

نزّل ملف zip الخاص بمنصتك من Releases؛ بعد فك الضغط ستحصل على artex + start.sh (start.bat على Windows) + skills/ + config.example.json:

cp config.example.json config.json   # fill in the database connection
./start.sh                           # → http://localhost:8787

يُرجى البدء باستخدام start.sh / start.bat بدلاً من تشغيل ./artex مباشرةً. إنه سكربت خفي (daemon): إذا انهارت العملية، فإنه يعيد تشغيلها بعد فترة انتظار متزايدة. لإبقائه قيد التشغيل في الخلفية: nohup ./start.sh >artex.log 2>&1 &.

الخيار 4: بناء الملف التنفيذي الواحد من المصدر

# 1) frontend static export
cd web && npm ci && npm run build:static && cd ..
# 2) copy into the embed directory
cp -r web/out server/webui/dist
# 3) build (only -tags embedui embeds the frontend)
CGO_ENABLED=0 go build -tags embedui -o artex ./cmd/artex
./start.sh