Skip to content

INSTALLATION_GUIDE.md

Latest commit

 

History

History
272 lines (184 loc) · 5.97 KB

INSTALLATION_GUIDE.md

File metadata and controls

272 lines (184 loc) · 5.97 KB

📸 دليل التثبيت المصور - Comet-X Installation Guide

آخر تحديث: 25 ديسمبر 2025

🎯 الهدف

تثبيت Comet-X Browser Extension على Chrome

المدة: 2 دقيقة ⏱️

📋 الخطوات بالتفصيل

الخطوة 1: افتح Chrome 🌐

  1. افتح متصفح Google Chrome
  2. في شريط العنوان، اكتب: 
    chrome://extensions/
  3. اضغط Enter

💡 أو: انسخ هذا الرابط والصقه في Chrome!

الخطوة 2: فعّل وضع المطور 🛠️

في صفحة Extensions:

  1. شوف أعلى اليمين ← مكتوب "Developer mode"
  2. فعّله (يصير أزرق ✅)

📸 المفترض تشوف:

Developer mode   [ON ✅]

الخطوة 3: حمّل الـ Extension 📦

  1. بعد ما فعّلت Developer mode، بتظهر أزرار جديدة
  2. اضغط على: "Load unpacked"
  3. بينفتح نافذة اختيار مجلد

الخطوة 4: اختر المجلد 📂

في نافذة اختيار المجلد:

  1. روح لـ:

    C:\Users\admin\source\repos\gratech\

  2. افتح مجلد: comet-x-browser

  3. اضغط "Select Folder"

💡 نسخ/لصق السريع:

C:\Users\admin\source\repos\gratech\comet-x-browser

الخطوة 5: تأكد من النجاح ✅

بعد ما تختار المجلد، المفترض تشوف:

╔════════════════════════════════════╗
║  💚 Comet-X                        ║
║  Neural Sovereignty Browser        ║
║  Version: 0.1.0                    ║
║  [Details] [Remove] [Errors]       ║
╚════════════════════════════════════╝

علامات النجاح:

  • ✅ أيقونة 💚 في شريط الأدوات
  • ✅ اسم "Comet-X" موجود
  • ✅ Version 0.1.0
  • ✅ لا توجد أخطاء حمراء

🎮 تجربة الـ Extension

الطريقة 1: الأيقونة 🖱️

  1. شوف شريط الأدوات (toolbar) في Chrome
  2. لازم تلقى أيقونة 💚 (لون أخضر)
  3. اضغط عليها
  4. بتنفتح قائمة Comet-X!

💡 إذا ما شفت الأيقونة:

  • اضغط على أيقونة الـ Extensions (puzzle piece 🧩)
  • بتلقى Comet-X في القائمة
  • اضغط على الدبوس 📌 عشان تثبتها

الطريقة 2: Keyboard Shortcut ⌨️

  1. افتح أي صفحة ويب
  2. اضغط: Ctrl + Shift + C
  3. بينفتح Chat Sidebar! 💬

الطريقة 3: الـ Floating Orb ⭕

  1. افتح أي صفحة
  2. شوف أسفل اليمين
  3. لازم تشوف كرة خضراء تلمع (Orb)
  4. اضغط عليها!

🐛 حل المشاكل - Troubleshooting

المشكلة 1: ما تظهر الأيقونة 🔴

الحل:

1. Refresh صفحة Extensions
2. Disable ثم Enable الـ Extension
3. Restart Chrome

المشكلة 2: Errors ظهرت ⚠️

الأسباب المحتملة:

  1. ملفات ناقصة:

    • تأكد إنك اخترت مجلد comet-x-browser كامل
    • المفترض فيه: manifest.json, background/, content/, etc.

  2. Chrome قديم:

    • Comet-X يحتاج Chrome 88+
    • تحديث Chrome: chrome://settings/help

  3. Manifest خطأ:

    • افتح Developer Tools للـ Extension
    • شوف Console للتفاصيل

المشكلة 3: ما يشتغل على الصفحات 🌐

الحل:

1. Reload الصفحة (F5)
2. تأكد إن الـ Extension Enabled
3. شوف Chrome DevTools → Console

📊 ملفات الـ Extension

المفترض تشوف هذه الملفات في المجلد:

comet-x-browser/
├── manifest.json          ✅ (الأهم!)
├── background/
│   └── service-worker.js  ✅
├── content/
│   ├── content-script.js  ✅
│   └── styles.css         ✅
├── offscreen/
│   └── cognitive.html     ✅
├── ui/
│   ├── popup.html         ✅
│   └── popup.js           ✅
└── README.md              ✅

إذا أي ملف ناقص:

  • ارجع لـ Git
  • تأكد إنك في الـ branch الصحيح (main)
  • اعمل git pull إذا لزم

🎯 بعد التثبيت

الخطوة التالية:

  1. جرب القائمة:

    • اضغط الأيقونة 💚
    • شوف Quick Actions

  2. جرب Chat:

    • Ctrl+Shift+C
    • اكتب أي رسالة

  3. شوف الـ Orb:

    • افتح أي صفحة
    • الـ Orb المفترض يطلع أسفل اليمين

💡 نصائح

للتطوير:

  1. اترك Extensions Page مفتوحة

    • عشان تشوف الـ Errors مباشرة

  2. استخدم Reload Button

    • بعد أي تعديل، اضغط "Reload" في Extensions page

  3. DevTools للـ Extension:

    • في Extensions page
    • تحت Comet-X
    • اضغط "Inspect views: service worker"

🎨 Features متاحة الآن

✅ الأساسيات:

  • Floating Orb UI
  • Chat Sidebar (Ctrl+Shift+C)
  • Popup Menu
  • Page Context Capture
  • Memory System (basic)

🔄 قيد التطوير:

  • Local AI Model
  • Vector Search
  • Page Summarization
  • Smart Responses

📞 المساعدة

إذا واجهت مشكلة:

  1. شوف Console Errors
  2. تأكد من الملفات
  3. Restart Chrome
  4. راسلني: admin@gratech.sa

🇸🇦 Vision 2030

"من الرماد ينهض العنقاء" 🔥

Neural Sovereignty | Digital Independence

آخر تحديث: 25 ديسمبر 2025
الإصدار: 0.1.0
الحالة: جاهز للتجربة ✅

💚 Built with Love in Saudi Arabia