AMBER ICI v5: مركز قيادة تحقيقي محلي أولاً يعمل عبر Ollama، مع أدلة محددة النطاق لكل قضية، وسلاسل وكلاء، واسترجاع هجين، وتحليل متدفق، وعروض رسومية وزمنية، والتعرّف الضوئي على الحروف (OCR)، وبحث ويب مُتحكَّم فيه، وقياس عن بُعد لاستخدام وحدة معالجة الرسومات (GPU).
<p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12061/b3526255ef1a43950d559d01043863d61c0ef36cfbf4e3270caef742cde07d9e.png" alt="لافتة واجهة AMBER ICI" width="1200" /> </p> # AMBER ICI v5 AMBER ICI (واجهة قيادة التحقيق AMBER) هي واجهة متصفح محلية أولاً لسير العمل التحقيقي والتحليلي مدعومة بخادم [Ollama](https://ollama.com/) محلي. وتشمل: - وحدة تحكم المحلل بنموذج واحد وتنفيذ متوازٍ متعدد النماذج - سلسلة وكلاء يحددها المستخدم تُشغَّل من زر `SEND` في الطرفية الرئيسية - تحكم المستخدم في الوكلاء الذين يعملون، وعددهم، وعدد الحلقات، والنموذج المحلي الذي يستخدمه كل منهم - توليد إعدادات الوكلاء بواسطة نموذج محلي انطلاقاً من هدف مكتوب بلغة عادية - أرشيف دلالي دائم مدعوم بتضمينات Ollama - استرجاع كسوري فيبوناتشي لسياق الملف النشط - رفع الملفات، والوصول للقراءة فقط إلى الدلائل المرتبطة، واستخراج النصوص، والتعرف الضوئي على الحروف (OCR) - جلب ويب اختياري مدعوم بـ Playwright والبحث في السجلات العامة، خلف مفتاح رئيسي واحد - عروض مستقلة لرسم الكيانات والخط الزمني ومخزن المتجهات - قياس محلي لمعدل الرموز والجلسات وGPU/VRAM ودرجة الحرارة حيثما توفر ذلك يقيّد واجهة المستخدم استدلال Ollama على نقاط النهاية المحلية (`127.0.0.1` أو `localhost` أو `::1`). لا يتضمن AMBER استدلالاً سحابياً أو قياساً عن بُعد للتطبيق، ولا تتطلب أي ميزة تسجيل دخول أو مفتاح API أو حساب. حبة `WEB` هي المفتاح الرئيسي لكل وصول إلى الإنترنت: فعندما تكون `OFF`، لا يُجري AMBER أي طلب صادر من أي نوع. ## أبرز ميزات v5 - مساحات عمل محلية للقضايا مع أدلة واسترجاع أرشيف محدودين بنطاق القضية - هوية أثرية SHA-256 متدفقة، وأصل الإدخال، وكشف التكرار، والاستشهادات بالمصادر - استرجاع حتمي بالكلمات المفتاحية مدمج مع نتائج الأرشيف الدلالي الحالية - ذاكرة صريحة ومحدودة النطاق مرتبطة بالجلسات أو المحققين أو القضايا أو الوكلاء أو مهام الاستدلال - قوالب أدوار تحقيق يختارها المشغّل باستخدام نماذج Ollama المحلية المثبتة - تنفيذ الوكلاء من الطرفية الرئيسية مع نماذج وحدود وصيغ وتسليمات وتحكم في الحلقات لكل وكيل - فحص أولي لـ WEB عبر Playwright، وتشخيصات تنفيذ مرئية، وبديل الجلب المباشر، وتخزين مؤقت محلي لمدة ساعة - كشف مخزّن مؤقتاً للعتاد مع تقارير Metal وCUDA وROCM والذاكرة الموحدة والاستخدام ودرجة الحرارة - تحديثات متدفقة مدمجة لإخراج طويل سريع الاستجابة - بيانات وصفية محفوظة محدودة النطاق، ومحتوى واجهة مولّد مُهرَّب، واعتماديات Node قابلة لإعادة الإنتاج، واستثناءات موسّعة لبيئات التشغيل الحساسة ## مجموعة الميزات الحالية ### وحدة تحكم المحلل - تبث محادثة مع نموذج Ollama واحد محدد - تدعم موجّه النظام، ووضع إخراج JSON، والبذرة (seed)، ودرجة الحرارة، وحجم CTX - تحقن سياق الملف النشط، والويب الاختياري، والمحادثة المحتفظ بها - توقف العمل النشط باستخدام `STOP` أو `Esc` يحمل شريط الحبات في وحدة التحكم عناصر التحكم في التنفيذ: | الحبة | القيم | الغرض | |---|---|---| | `TEMP` / `CTX` / `MEM` / `FMT` / `STREAM` / `SEED` / `SYS` | — | إعدادات الاستدلال في وضع المحلل | | `WEB` | `OFF` (افتراضي) / `ON` | المفتاح الرئيسي لكل وصول إلى الإنترنت | | `EXEC` | `ANALYST` (افتراضي) / `AGENTS` | ما يشغّله `SEND`: النموذج النشط الوحيد، أو سلسلة الوكلاء | | `AGN` | `0` = الكل | عدد الوكلاء الذين تشغّلهم السلسلة، بترتيب البطاقات | | `LOOPS` | `1`+ | عدد مرات تكرار السلسلة؛ يُعكس مع حقل `LOOPS` في لوحة الوكلاء | ### المتوازي - يشغّل نفس الموجّه على جميع النماذج المحددة - يبث ويتتبع كل استجابة بشكل مستقل - يطبّق نفس عناصر التحكم في CTX والملف النشط المستخدمة في وحدة تحكم المحلل ### الوكلاء — سلسلة التنفيذ الوكلاء يحددهم المستخدم وهم مسار التنفيذ الأساسي. لا توجد قائمة وكلاء مدمجة أو ثابتة؛ تبدأ لوحة الوكلاء فارغة وتملؤها بطريقتين: - `+ CREATE AGENT` — تعريف وكيل يدوياً - `GENERATE FROM PROMPT` — صف هدفاً وسيكتب نموذج مخطط محلي محدد مجموعة الوكلاء لك يخزّن كل وكيل إعدادات التشغيل الخاصة به: | الحقل | الافتراضي | ملاحظات | |---|---|---| | اسم الوكيل | — | مطلوب | | غرض الوكيل | — | يُحقن بصيغة `[AGENT PURPOSE]` | | موجه نظام الوكيل | — | تعليمات دور الوكيل | | النموذج المحلي المفضل | — | مطلوب؛ يجب أن يكون مثبتًا في Ollama | | درجة الحرارة | `0.35` | لكل وكيل، مستقلة عن حبة `TEMP` في وحدة التحكم | | الحد الأقصى لرموز الإخراج | `0` (تلقائي) | `0` يستخدم استدلال الطول الخاص بـ AMBER | | الحلقات | `1` | عدد المرات التي ينفذ فيها هذا الوكيل في كل حلقة سلسلة، حيث يحسّن كل منها مخرجاته السابقة | | تنسيق الإخراج | نص عادي | `JSON` يفعّل وضع JSON في Ollama ويتخطى توسيع الطول | | تعليمات التسليم | — | تُمرَّر إلى الوكيل التسلسلي التالي بصيغة `[HANDOFF FROM PREVIOUS AGENT]` | | وضع التنفيذ | `sequential` | `sequential` أو `parallel` أو `gated` | | هدف الإخراج، نطاق الذاكرة، الدور، الوصول إلى الأدوات، التمكين، الملاحظات | — | ضمن `ADVANCED` | **تشغيل السلسلة.** اضبط `EXEC` على `AGENTS`، واكتب موجهًا في الطرفية الرئيسية، ثم اضغط `SEND`. يقرأ AMBER الوضع المحدد، والوكلاء الممكّنين، والنموذج المحلي لكل وكيل، وعدد `AGN`، وعدد `LOOPS`، ثم ينفّذ: الوكلاء `parallel` بشكل متزامن، يليهم الوكلاء `sequential` بترتيب البطاقات، مرة واحدة لكل حلقة. يتلقى كل وكيل تسلسلي مخرجات الوكيل السابق بصيغة `[UPSTREAM OUTPUT]` بالإضافة إلى ملاحظة التسليم الخاصة بذلك الوكيل. تُطبع التقدم ومخرجات كل وكيل المتدفقة في الطرفية الرئيسية، ويُحتفظ بالإجابة النهائية في سجل المحادثة. زر `RUN` في لوحة Agents يفعل الشيء نفسه باستخدام حقل `LOOPS` الخاص باللوحة. في وضع `AGENTS` لا يتطلب `SEND` نموذجًا نشطًا في لوحة Models، لأن كل وكيل يحمل نموذجه الخاص. تُستثنى الوكلاء `gated` من السلسلة — شغّلها فرديًا باستخدام زر `RUN` في بطاقتها. **لا يتم استبدال النماذج المفقودة أبدًا.** حفظ وكيل أو بدء سلسلة بنموذج لا يمتلكه Ollama يطبع كتلة قابلة للتنفيذ في الطرفية تسمّي النموذج المطلوب، والنماذج المثبتة فعليًا، وأمر `ollama pull <model>` المطلوب، ولا تبدأ العملية. يمكن تخزين مجموعات الوكلاء المحفوظة واستعادتها بالاسم من لوحة Agents. > تم إيقاف وضع تسلسل الخطوات `PIPELINE` / `CHAIN` السابق من الواجهة. يبقى محركه وملف `state/pipeline_state.json` في مكانهما للتوافق مع الإصدارات السابقة، لكنه لم يعد وضعًا قابلًا للاختيار؛ الوكلاء هم سلسلة التنفيذ. ### الأرشيف والذاكرة - يضع الملفات في قائمة الانتظار للقطع والتضمين باستخدام `embeddinggemma:latest` - يبحث في الأرشيف المحلي عبر تشابه جيب التمام - يستورد ويصدّر JSON الأرشيف - يضيف أحدث مخرجات المساعد مباشرة إلى الأرشيف - يبني فهرس فراكتال فيبوناتشي داخل المتصفح لاسترجاع مصادر الملفات - يوفر ملفات تعريف الاسترجاع `FAST` و`HYBRID` و`DEEP` ### استخبارات الحالات يتضمن الأرشيف الآن حدًا اختياريًا للحالة دون استبدال سير عمله الحالي الخاص بالأرشيف الكامل: - `NEW CASE` ينشئ بيانات وصفية محلية للحالة. - `ADD ACTIVE TO CASE` يسجل الملفات المحددة كأدلة، ويحتفظ بالرفع الخام الحالي، ويحسب هوية SHA-256 متدفقة، ويسجل مصدر الاستيعاب. - تحمل متجهات الأرشيف المفهرسة أثناء تحديد حالة معينة معرّف تلك الحالة. تدمج عمليات البحث في الحالات تلك النتائج الدلالية مع بديل كلمات مفتاحية حتمي عند توفر كليهما. - `REMEMBER LAST` يحفظ صراحةً أحدث مخرجات المساعد كذاكرة حالة موسومة. لا تُرقّى مخرجات النموذج أبدًا بصمت إلى أدلة أو ذاكرة. - `ADD INVESTIGATION ROLES` يضيف قوالب اختيارية لـ Director وResearcher وInvestigator وAnalyst وDocumenter وCritic إلى سجل الوكلاء المحدد من قبل المستخدم. تستخدم النموذج المحلي الذي يختاره المشغّل ولا تعمل تلقائيًا. تُخزَّن استخبارات الحالات ذريًا في مخزن JSON واحد مُصدَّر بإصدارات من المكتبة القياسية، وتستخدم عميل Ollama الحالي الخاص بـ AMBER. ### العروض المستقلة يفتح الرأس هذه الأدوات في علامات تبويب منفصلة: - Entity Provenance Graph: `http://127.0.0.1:8765/amber_graph.html` - Timeline: `http://127.0.0.1:8765/amber_timeline.html` - Vector Store manager: `http://127.0.0.1:8765/amber_vectorstore.html` ## المتطلبات وقت التشغيل الأساسي: - Python 3.10 أو أحدث؛ يستخدم المشغّل والواجهة الخلفية الأساسية المكتبة القياسية فقط، لذا لا حاجة إلى `pip install` لتشغيل AMBER - Ollama مثبّت ويعمل محليًا - نموذج توليد واحد على الأقل من Ollama - `embeddinggemma:latest` لفهرسة الأرشيف والبحث الدلالي قدرات اختيارية: - Node.js 18+ وnpm، إضافةً إلى تبعيات المشروع، لجلب صفحات الويب المعروضة عبر JavaScript والبحث في السجلات - متصفح Playwright Chromium لتلك الميزات المدعومة بالمتصفح - `ocrmypdf` وTesseract لـ OCR على ملفات PDF - Tesseract لـ OCR على الصور - Pillow لتحويل صور WebP قبل OCR عندما يتعذر على Tesseract قراءتها مباشرةً - `psutil` أو `nvidia-smi` أو `osx-cpu-temp` لمقاييس نظام إضافية؛ تبقى القراءات غير المتاحة فارغة ببساطة كل ما سبق محلي. لا يتطلب أي مكوّن حسابًا أو مفتاح API أو خدمة سحابية. ## التثبيت والتشغيل ### 1. استنساخ المستودع ```bash git clone https://github.com/gs-ai/AMBER-ICI.git cd AMBER-ICI ``` ### 2. تشغيل Ollama في طرفية منفصلة: ```bash ollama serve ``` اسحب نموذج التضمين المطلوب ونموذج توليد واحدًا على الأقل: ```bash ollama pull embeddinggemma:latest ollama pull qwen2.5-coder:7b ``` نموذج التوليد مجرد مثال؛ يكتشف AMBER النماذج المثبتة محليًا من Ollama. ### 3. إنشاء بيئة Python تستورد الواجهة الخلفية الأساسية مكتبة Python القياسية فقط، لذا فإن البيئة الافتراضية اختيارية للتشغيل المباشر. أنشئ واحدة على أي حال إذا كنت تريد سكربتات npm (التي تستدعي `venv/bin/python3`) أو دعم Pillow الاختياري: ```bash python3 -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate python3 -m pip install --upgrade pip ``` لا يوجد `requirements.txt` لأنه لا شيء مطلوب. ثبّت الإضافات الاختيارية في تلك البيئة فقط إذا كنت تريدها: ```bash python3 -m pip install Pillow # optional: WebP conversion before OCR ``` إلغاء التنشيط باستخدام `deactivate`. إذا تركت نسخة سابقة من AMBER حزمًا غير مستخدمة في `venv/` (على سبيل المثال `camoufox`)، فإنها لا تُستورد بواسطة الكود الحالي ويمكن تجاهلها أو إزالتها. ### 4. تشغيل التطبيق الأساسي ```bash python3 files/launch_amber_ici_gui.py ``` يفتح AMBER المتصفح تلقائيًا. للتشغيل دون فتح علامة تبويب: ```bash python3 files/launch_amber_ici_gui.py --no-browser ``` ثم افتح `http://127.0.0.1:8765/amber_ui.html`. ### 5. تثبيت ميزات الويب الاختيارية المدعومة بالمتصفح مطلوب فقط إذا كنت تنوي تفعيل زر `WEB`: ```bash npm install # playwright, playwright-extra, stealth plugin npx playwright install chromium # the browser binary itself ``` تحقق من أن المساعدين قابلون للتشغيل — مع تشغيل AMBER، يُبلّغ هذا عن مسارات المساعدين، وملف `node` الثنائي المُحلَّل، وأي حزمة مفقودة: ```bash curl -s http://127.0.0.1:8765/api/web/status ``` يستخدم AMBER مساعد Node/Chromium للصفحات التي تُعرض عبر JavaScript، مع جلب HTTP بلغة Python العادية كبديل للروابط المباشرة. يتطلب مساعد البحث في السجلات Node.js، وتبعيات npm، وChromium؛ وليس لديه بديل HTTP عادي. ### 6. تثبيت دعم OCR الاختياري macOS مع Homebrew: ```bash brew install ocrmypdf tesseract python3 -m pip install Pillow ``` أوبونتو/دبيان: ```bash sudo apt-get update sudo apt-get install -y ocrmypdf tesseract-ocr python3 -m pip install Pillow ``` Pillow مطلوب فقط لتنسيقات الصور التي تتطلب تحويلًا قبل أن يتمكن Tesseract من معالجتها. يستمر AMBER في العمل عند غياب أي من تبعيات OCR الاختيارية. ### نصوص npm المساعدة تُشغّل نصوص npm المرفقة AMBER باستخدام `venv/bin/python3`، لذا أنشئ تلك البيئة أولًا (الخطوة 3): ```bash npm start # 127.0.0.1:8765, no browser tab npm run start:browser # same, and opens the browser ``` يُعد التشغيل المباشر عبر `python3` الخيار الأكثر قابلية للنقل. ### الإعداد الكامل، من البداية إلى النهاية ```bash git clone https://github.com/gs-ai/AMBER-ICI.git cd AMBER-ICI python3 -m venv venv # for the npm scripts npm install # optional: WEB features npx playwright install chromium # optional: WEB features ollama serve & # in its own terminal ollama pull embeddinggemma:latest # required for Archive ollama pull qwen2.5-coder:7b # any generation model npm start # → http://127.0.0.1:8765/amber_ui.html ``` ## خيارات المشغّل ```bash python3 files/launch_amber_ici_gui.py --help ``` | العَلَم | الافتراضي | الغرض | |---|---:|---| | `--host HOST` | `127.0.0.1` | العنوان الذي يستمع عليه خادم AMBER HTTP | | `--port PORT` | `8765` | منفذ خادم AMBER HTTP | | `--no-browser` | معطّل | عدم فتح المتصفح الافتراضي | | `--gui PATH` | يُكتشف تلقائيًا | تقديم ملف HTML لواجهة رسومية محددة | | `--version` | — | طباعة إصدار AMBER ICI والخروج | تقبل واجهة المتصفح عمدًا عناوين Ollama المحلية (loopback) فقط حتى لو كان خادم AMBER مرتبطًا بواجهة أخرى. ## سير العمل عند التشغيل الأول 1. تأكد من أن نقطة نهاية Ollama في أعلى اليمين هي `http://127.0.0.1:11434`. 2. انقر على `PING` لتحميل النماذج المثبتة محليًا. 3. اختر نموذجًا واحدًا في لوحة Models. 4. أدخل طلبًا (prompt) في Analyst Console وانقر على `SEND`. 5. اختياريًا، ارفع ملفات أو اربط دليلًا، ثم فعّل الملفات لتضمينها في السياق. 6. اسحب `embeddinggemma:latest` قبل فهرسة الملفات في Archive. لتشغيل سلسلة الوكلاء بدلًا من ذلك: 1. افتح تبويب `AGENTS` في اللوحة اليسرى. 2. أنشئ وكيلًا باستخدام `+ CREATE AGENT`، أو صِف هدفًا تحت `GENERATE FROM PROMPT`. 3. اضبط `EXEC` على `AGENTS` في شريط الحبوب (pill bar) الخاص بالطرفية. 4. اضبط `AGN` (عدد الوكلاء؛ `0` = الكل) و`LOOPS` (عدد المرات). 5. اكتب الطلب في الطرفية الرئيسية واضغط `SEND`. للسماح لـ AMBER بقراءة الإنترنت، اضبط حبة `WEB` على `ON` أولًا؛ فهي `OFF` افتراضيًا. ## استيعاب الملفات تقتصر عمليات الرفع على 100 MiB لكل ملف. يقبل منتقي الملفات ومسار السحب والإفلات حاليًا: - المستندات: `.txt`، `.md`، `.pdf`، `.docx`، `.rtf` - البيانات/الإعدادات: `.csv`، `.xlsx`، `.json`، `.yaml`، `.yml`، `.toml`، `.ini`، `.cfg`، `.conf`، `.xml` - المصدر/السجلات: `.py`، `.js`، `.ts`، `.tsx`، `.jsx`، `.html`، `.sql`، `.sh`، `.bash`، `.zsh`، `.log` - الصور: `.png`، `.jpg`، `.jpeg`، `.bmp`، `.webp`، `.tif`، `.tiff`، `.svg` سلوك الاستخراج: - تُفكّ ترميز ملفات النص العادي والمصدر والإعدادات وCSV وRTF كنص. - تُستخرج أوراق عمل XLSX باستخدام مكتبة Python القياسية؛ لا تُحفظ الصيغ والتنسيقات المعقدة. - يُستخرج نص DOCX من XML الخاص بالمستند؛ لا يُحفظ التخطيط المعقد. - يحاول استخراج PDF أولًا قراءة النص المضمّن ويحاول أيضًا التعرف الضوئي (OCR) عند تثبيت `ocrmypdf`، مع الاحتفاظ بالنتيجة الأكثر فائدة. - تستخدم الصور النقطية التعرف الضوئي Tesseract عند تثبيته. يقرأ استخراج SVG محتوى `<text>` و`<tspan>` المضمّن. تُخزَّن البايتات الخام المرفوعة في `uploads/blobs/`، والنص المستخرج في `uploads/texts/`، والبيانات الوصفية في `uploads/manifest.json`. ### الأدلة المرتبطة يكشف `LINK DIRECTORY` عن الملفات المدعومة غير المخفية من دليل محلي واحد لـ AMBER. تعامل لوحة Files الإدخالات المرتبطة كقراءة فقط، وسرد الدليل غير متكرر. يُخزَّن المسار المحدد في `state/linked_dir_state.json`؛ ويبقى محتوى الملف في موقعه الأصلي ويُقرأ فقط عند طلبه للسياق أو الاستخراج. يستخدم منتقي المجلدات الأصلي مكتبة Tkinter في Python. إذا لم تكن متاحة، تطالب الواجهة بإدخال مسار يدويًا. إلغاء ربط الدليل يزيل الرابط المحفوظ لكنه لا يحذف الملفات المصدرية. يتعرف الواجهة الخلفية على بعض صيغ الملفات المرتبطة الإضافية (`.xls`، `.ods`، `.gif`، `.heic`، `.ico`، `.ppt`، `.pptx`، و`.zip`). الصيغ التي لا تحتوي على مستخرج نصي تساهم بتسمية بيانات وصفية بدلًا من محتوى مفكوك الترميز. استخراج `.xls` و`.ods` القديمين هو بأفضل جهد وقد يُبلّغ عن عدم توفر الاستخراج. ## سلوك السياق والذاكرة خيارات CTX في الواجهة هي `2K` و`4K` و`8K` و`16K` و`32K` وتُطبَّق عبر استدعاءات Analyst وParallel وAgent. - قبل الاستدلال، يزيل `trimMsgsToCtx()` أقدم الرسائل غير النظامية حتى يتناسب الطلب مع نحو 90% من ميزانية السياق المحددة، المقدَّرة بأربعة أحرف لكل رمز (token). - يستعلم استرجاع الملف النشط أولاً عن مخزن فراكتال فيبوناتشي، عندما يكون ممتلئًا، ثم يتراجع إلى تجميع سياق الملفات المسطّح. - يستخدم الاسترجاع عمقًا يصل إلى 4، وعرض حزمة 2–4، وحدود نتائج تعتمد على الملف الشخصي. - يُحدَّد سياق الملف النشط وفقًا لملف الذاكرة الشخصي: نحو `CTX × 2.6` حرفًا في Fast، و`CTX × 3.2` في Hybrid، و`CTX × 4.0` في Deep. - يُرتَّب السياق المسطّح المفرط الحجم باستخدام تقييم تداخل الكلمات المفتاحية قبل الحقن. - يحتفظ حقن لوحة المسودة (scratchpad) بذيل يبلغ نحو 8,000–20,000 حرف، ويُقيَّد إضافةً إلى ذلك بميزانية سياق الملفات الخاصة بالملف الشخصي النشط. - تتلقى الوكلاء ذوو الذاكرة الكاملة آخر ست رسائل محادثة. تستخدم الذاكرة المحلية ذيل لوحة المسودة؛ ويُعطِّل `none` هذا الاستدعاء. هذه ضوابط حماية قائمة على الأحرف، وليست أعدادًا دقيقة من المُرمِّز (tokenizer). أرشيف المتجهات (vector Archive) دائم، لكن شجرة فيبوناتشي المنفصلة هي ذاكرة جلسة. تُبنى لملف عندما تتم فهرسة ذلك الملف خلال جلسة الصفحة الحالية، ولا تُعاد بناؤها تلقائيًا من `state/vector_store.json` بعد إعادة التحميل؛ وإلى أن تُعاد البناء، يستخدم سياق الملف النشط البديل المسطّح. ## الاستمرارية يخزّن المشغّل بيانات التطبيق الدائمة بصيغة JSON تحت `state/` باستخدام استبدال ذري للملفات المؤقتة. لا توجد ترحيلات SQLite نشطة ولا اعتماد على قاعدة بيانات. | المسار | المحتويات | |---|---| | `state/agents_state.json` | الوكلاء الحاليون، بما في ذلك نموذج كل وكيل ودرجة الحرارة وحد الرموز والحلقات والتنسيق والتسليم | | `state/agent_sets.json` | إعدادات الوكلاء المسبقة المحفوظة | | `state/agent_run_log.json` | آخر 100 تنفيذ للوكلاء: الوكيل والنموذج والمدة والنجاح والسياق | | `state/pipeline_state.json` | خطوات خط الأنابيب المتقاعدة، محتفظ بها للتوافق مع الإصدارات السابقة | | `state/chain_sets.json` | إعدادات السلاسل المسبقة المحفوظة | | `state/step_run_log.json`، `state/tool_call_log.json`، `state/tool_registry_state.json` | سجلات الخطوات واستدعاءات الأدوات وسجل الأدوات | | `state/chat_history.json` | آخر 100 رسالة محادثة؛ تعيد واجهة المستخدم تشغيل أحدث 30 رسالة | | `state/scratch.json` | آخر 20,000 حرف من لوحة المسودة | | `state/memory_profile.json` | اختيار الاسترجاع Fast أو Hybrid أو Deep | | `state/vector_store.json` | أجزاء الأرشيف والتضمينات (embeddings) | | `state/case_intelligence.json` | بيانات الحالة الوصفية وعقود الأدلة ومصادرها، والذاكرة الصريحة المحدودة، وإيصالات تتبع الوكلاء؛ يُنشأ عند أول كتابة | | `state/graph_state.json`، `state/timeline_state.json` | بيانات الرسم البياني والخط الزمني | | `state/web_cache.json` | نتائج الجلب المباشر من الويب مع مدة صلاحية (TTL) مدتها ساعة واحدة | | `state/linked_dir_state.json` | مسار الدليل المرتبط الحالي | | `uploads/manifest.json` | البيانات الوصفية للملفات المرفوعة | يُخزَّن تخطيط اللوحة في `localStorage` الخاص بالمتصفح، لذا فهو خاص بملف تعريف المتصفح. تُعاد التحديدات والاحصائيات الخاصة بوقت التشغيل فقط، وشجرة الفراكتال الموجودة في الذاكرة، إلى حالتها عند تحميل الصفحة. إذا تعذّر فك ترميز ملف JSON للحالة، يعزله المشغّل بلاحقة `.corrupt-<timestamp>.json` ويعيد قيمة فارغة حتى تتمكن اللوحة المتأثرة من التعافي. ## الوصول إلى الويب وحدود الشبكة زر `WEB` هو المفتاح الرئيسي، وقيمته الافتراضية `OFF`. **عند إيقاف `WEB`، لا يُجري AMBER أي طلب صادر من أي نوع.** يُفرَض هذا القيد داخل دوال الجلب نفسها، لذا تُحظر بالتساوي صياغة الأوامر وسياق الملفات المحقون واستدعاءات أدوات الوكيل (`web_fetch`، `online_records_search`). إذا طلب أمر ما عملية جلب بينما المفتاح متوقف، يذكر الطرفية ذلك ولا يُرسَل الطلب بدلاً من الفشل الصامت. عند تشغيل `WEB`، يتحقق AMBER أولاً من بيئة المساعد، ويطبع مسار المساعد الذي سيستخدمه، ثم يحل الطلب بهذا الترتيب: 1. تعليمات موقع صريحة مثل "search foxnews.com for X" — تجلب ذلك الموقع، باستخدام عنوان URL بحث معروف عندما يكون الموضوع محددًا. 2. طلب بصياغة محددة "records search for/on [person] in [location]" — يستدعي مساعد السجلات. 3. عنوان URL صريح `http://`/`https://` أو نطاق مجرد معروف في الموجّه أو في سياق ملف مُحقن. 4. بخلاف ذلك، يُرسل نص الموجّه إلى نقطة نهاية HTML الخاصة بـ DuckDuckGo وتُجلب صفحة النتائج. تعني الخطوة 4 أنه مع تفعيل `WEB`، يمكن أن يصل نص الموجّه إلى محرك بحث عام. أوقف `WEB` للموجّهات التي لا ينبغي أن يغادر نصها الجهاز. تُبلَّغ كل نتيجة في الطرفية الرئيسية: الوضع المحدد، ومسار المساعد المستخدم، والطلب المُرسل، والمحرك الذي خدمه (`playwright` أو `urllib` أو `cache`)، وحجم المحتوى ومكان حقنه، أو كتلة فشل تسمّي التبعية المفقودة والأمر الذي يصلحها. تُخزَّن عمليات الجلب المباشرة مؤقتًا لمدة ساعة في `state/web_cache.json`. يستعلم بحث السجلات من هذه المصادر ويعيد فقط التطابقات التي يؤكد نص صفحتها كلاً من الموضوع والموقع المطلوب: `casesearch.kscourts.gov`، `doc.ks.gov/offender-search`، `kbi.ks.gov/registeredoffender`، DuckDuckGo، وBrave Search. سلوك الشبكة هو: - اكتشاف النموذج والاستدلال والتضمينات وحالة النموذج تتصل فقط بنقطة نهاية Ollama على loopback. - يخدم الواجهة الخلفية لـ AMBER الملفات المحلية ومسارات API من مضيف/منفذ AMBER المُهيأ. - مع تفعيل `WEB`، تُجري عملية جلب الويب عبر Playwright، وبديلها عبر Python HTTP، وبحث السجلات طلبات صادرة إلى مواقع يختارها المستخدم، وإلى مزوّدي البحث، ومواقع السجلات العامة. مع إيقاف `WEB`، لا يعمل أي منها. - `GET /api/web/status` هو فحص أولي محلي فقط؛ يفحص نظام الملفات و`PATH` ولا يُجري أي طلب شبكة. - لا توجد نقطة نهاية قياس عن بُعد لـ AMBER، ولا تنقل أي ميزة بيانات اعتماد أو مفاتيح أو بيانات استخدام. تُحقن الصفحات المجلوبة في الموجّه بصيغة `[WEB CONTEXT]` وبالتالي تصبح جزءًا من سجل المحادثة المحفوظ في `state/chat_history.json`؛ كما يضيف الوكلاء الذين يكون هدف مخرجاتهم لوحة المسودة إلى `state/scratch.json`. يستقر محتوى الويب المباشر في حالة القضية المحلية. يرسل المشغّل سياسة أمان محتوى تقييدية، ويعطّل التأطير، ويضبط `no-referrer`، ويحظر أذونات المتصفح الحساسة، ويعطّل التخزين المؤقت لـ HTTP. يمكن لعقد `/api/task/execute` الخاص بالواجهة الخلفية سرد الملفات أو قراءتها أو كتابتها أو إلحاقها أو إنشائها ضمن الجذر المرتبط عند استدعائه صراحةً. يرفض المسارات التي تخرج عن ذلك الجذر، والمسارات المخفية، والأدوات غير المعروفة، وعمليات الكتابة فوق غير مصرّح بها صراحةً. اربط فقط دليلًا يجوز للتطبيق المحلي الوصول إلى محتوياته المرئية وتعديلها. ## لوحة القياس عن بُعد --- [Read more](https://github.com/gs-ai/amber-ici)