دليل استخدام CodeScout

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

يتكوّن من جزأين:

• تطبيق سطح المكتب (ويندوز)، وفيه تعمل مع الوكيل داخل مجلدات مشاريعك.
• الموقع، وفيه تدير حسابك وتشحن الرصيد وتشتري الباقات وتستخدم الأكواد وتتابع استهلاكك.

لا تحتاج أبدًا إلى مفاتيح API خاصة بك. يوجّه CodeScout كل طلب إلى النموذج المناسب لمستوى الجودة الذي تختاره، ويخصم رصيدًا مدفوعًا مسبقًا مقابل ما تستخدمه فعلًا.

1. 01أنشئ حسابًا مجانيًا على الموقع بالبريد الإلكتروني أو Google أو GitHub.
2. 02حمّل CodeScout لويندوز وشغّل ملف التثبيت.
3. 03افتح التطبيق واختر تسجيل الدخول. سيفتح الموقع في متصفحك؛ أكّد هناك وسيتم تسجيل دخولك في التطبيق تلقائيًا.
4. 04اشحن رصيدك من صفحة الرصيد (ابتداءً من 5 دولار)، أو استخدم كودًا حصلت عليه.
5. 05في التطبيق افتح مجلد مشروع، واختر مستوى الجودة، واكتب مهمتك في خانة الرسالة.

مهمة أولى مناسبة: "اشرح هيكل هذا المشروع واقترح ثلاثة تحسينات." سيقرأ الوكيل الملفات ويجيب دون أن يغيّر أي شيء.

متطلبات النظام

التثبيت على ويندوز

1. 01ادخل صفحة التحميل واضغط تحميل لويندوز. سيُحفظ ملف التثبيت (CodeScout-Setup-<version>.exe) في مجلد التنزيلات.
2. 02افتح ملف التثبيت واتبع خطوات المعالج. التثبيت لك فقط لا يحتاج كلمة مرور المسؤول، ويمكنك أيضًا تغيير مجلد التثبيت.
3. 03إذا ظهرت رسالة "Windows protected your PC" اضغط More info ثم Run anyway (التفاصيل بالأسفل).
4. 04عند انتهاء التثبيت يفتح CodeScout تلقائيًا، وتُضاف له اختصارات في قائمة ابدأ وعلى سطح المكتب.

عن تحذير Windows SmartScreen

يحذّر SmartScreen من التطبيقات التي ليس لها بعد سجل تنزيلات طويل أو شهادة توقيع مدفوعة. هذا طبيعي لتطبيق جديد ولا يعني أن الملف ضار. حمّل CodeScout فقط من صفحة التحميل الرسمية التي توفّر الملفات من updates.codescout.online.

إلغاء التثبيت

افتح الإعدادات ← التطبيقات ← التطبيقات المثبتة، وابحث عن CodeScout واختر إلغاء التثبيت. تبقى محادثاتك وإعداداتك في %USERPROFILE%\.dsh فيكمل التطبيق من حيث توقفت عند إعادة تثبيته، واحذف هذا المجلد إن أردت إزالتها أيضًا.

يستخدم التطبيق حسابك على موقع CodeScout. يتم تسجيل الدخول في متصفحك المعتاد، لذا يمكنك استخدام أي طريقة أعددتها على الموقع (بريد وكلمة مرور أو Google أو GitHub).

1. 01في التطبيق اضغط تسجيل الدخول.
2. 02سيفتح متصفحك موقع CodeScout؛ سجّل الدخول هناك إن لم تكن مسجّلًا.
3. 03وافق على الربط. ستخبرك صفحة المتصفح بانتهاء العملية، وينتقل التطبيق إلى حسابك خلال ثوانٍ.

رموز التحقق عبر البريد

يتم تسجيل الدخول بالبريد وكلمة المرور على الموقع على خطوتين: كلمة المرور، ثم رمز من 6 أرقام نرسله إلى بريدك. والحسابات الجديدة تؤكد بريدها برمز أيضًا، و"نسيت كلمة المرور" يرسل رمزًا بدلًا من رابط. تنتهي صلاحية الرمز بعد 10 دقائق؛ استخدم إعادة إرسال الرمز إن لم يصل (وتحقق من مجلد الرسائل غير المرغوب فيها أولًا).

تبقى مسجّلًا عند إغلاق التطبيق أو إعادة تشغيل الجهاز أو تثبيت تحديث، إذ تتجدد الجلسة تلقائيًا في الخلفية.

لتسجيل الخروج افتح قائمة الحساب أسفل الشريط الجانبي واختر تسجيل الخروج، وسيحذف ذلك الجلسة المخزّنة على هذا الجهاز.

تعمل كل محادثة داخل مجلد مشروع على جهازك. يستطيع الوكيل قراءة وتعديل الملفات داخل المجلد الذي تفتحه فقط (وفي حدود وضع الصلاحيات الذي تختاره)، لذا افتح المجلد الرئيسي للمشروع الذي تريد العمل عليه.

• ابدأ محادثة جديدة لكل مهمة مستقلة؛ المحادثات القصيرة المركّزة تعطي نتائج أفضل وتستهلك رصيدًا أقل.
• تُحفظ محادثاتك على جهازك وتظهر في الشريط الجانبي لتعود إليها لاحقًا.
• يمكنك إرفاق صور مع رسالتك، مثل لقطة شاشة لخطأ أو تصميم.
• أثناء العمل ترى كل خطوة: الملفات التي يقرؤها الوكيل والتعديلات التي يجريها والأوامر التي ينفذها، ويمكنك إيقافه في أي لحظة.

كيف تكتب طلبًا جيدًا

• اذكر ماذا تريد ولماذا: "أضف زر الوضع الداكن في صفحة الإعدادات؛ الألوان موجودة في theme.css."
• اذكر أسماء الملفات ورسائل الخطأ والقيود التي تعرفها.
• للأعمال الكبيرة اطلب خطة أولًا، راجعها، ثم اطلب التنفيذ.
• اطلب من الوكيل تشغيل الاختبارات أو البناء بعد التعديل ليتحقق من عمله بنفسه.

أوامر الشرطة المائلة

اكتب / في خانة الرسالة لعرض الأوامر المتاحة، ومن أهمها:

أنت تحدد ما يمكن للوكيل فعله بمفرده. اختر وضع الصلاحيات من القائمة أسفل خانة الرسالة:

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

المهارات أدلة عمل احترافية يحمّلها الوكيل عندما تحتاجها المهمة. الأوضاع تتيح لك فرض مهارة متخصصة طوال المحادثة.

الأوضاع المتخصصة

أعد كتابة الأمر نفسه (أو /<mode> off) لإيقاف الوضع. تظهر شارة أعلى خانة الرسالة توضّح الوضع النشط.

مهارة CodeScout UI

عندما تطلب من الوكيل تصميم أو بناء موقع أو صفحة هبوط أو شاشة تطبيق أو لوحة تحكم، يحمّل تلقائيًا مهارة CodeScout UI: نظام تصميم يضم أنماطًا مختارة ولوحات ألوان وتنسيقات خطوط وقواعد تجربة استخدام. وعندما يحتاج التصميم إلى صور، يستطيع الوكيل توليدها عبر توليد الصور.

اطلب صورة من الوكيل بأي لغة، مثل "اعمل صورة رئيسية لمقهى دافئ وقت الشروق". يكتب الوكيل وصفًا تفصيليًا بالإنجليزية، ويولّد الصورة ويعرض معاينتها داخل المحادثة، كما تُحفظ في مشروعك داخل مجلد generated-images/ افتراضيًا.

• تكلفة كل صورة 10 رصيد، وتُخصم فقط عند نجاح التوليد.
• يوجد حد يومي لعدد الصور لكل حساب، ويتجدد يوميًا الساعة 00:00 بتوقيت UTC.
• يُرسَل الوصف دائمًا بالإنجليزية لأنها تعطي أفضل النتائج مع نماذج الصور.

يتيح الربط للوكيل العمل مع خدماتك على الإنترنت، مثل GitHub (المستودعات والمشكلات وطلبات الدمج) وVercel وCloudflare (النشر والمشاريع).

1. 01اضغط زر الربط بجوار خانة الرسالة (أو افتح الإعدادات ← الربط).
2. 02اختر الخدمة واضغط ربط. سيفتح متصفحك صفحة تسجيل الدخول الخاصة بالخدمة نفسها؛ وافق على الصلاحيات هناك.
3. 03عند العودة للتطبيق ستظهر الخدمة كمربوطة. اطلب من الوكيل استخدامها، مثل "افتح طلب دمج بهذه التغييرات".

لا يستخدم الوكيل الخدمة المربوطة إلا عندما يحتاجها طلبك. تُحفظ رموز الربط على جهازك، ويمكنك فصل أي خدمة في أي وقت من المكان نفسه.

أما Supabase وWordPress فيُربطان لكل مشروع على حدة: تلصق مفاتيح المشروع مرة واحدة وتنطبق عليه وحده. راجع الربط بووردبريس لخطوات WordPress.

اربط المشروع بموقع WordPress ليعمل الوكيل عليه مباشرة: قراءة ملفات القوالب والإضافات وتعديلها، وإدارة المقالات والصفحات والوسائط، والاستعلام من قاعدة البيانات، وتثبيت الإضافات والقوالب وتحديثها، مع أخذ نسخة احتياطية أولًا. يتم الربط عبر إضافة WP CodeScout Connector ويُضبط لكل مشروع على حدة.

خطوات الإعداد

1. 01ثبّت إضافة WP CodeScout Connector وفعّلها على موقع WordPress.
2. 02من لوحة تحكم WordPress افتح CodeScout Connector وأنشئ اتصالًا جديدًا. انسخ معرّف الاتصال (يبدأ بـ cs_) ورمز API (يبدأ بـ csc_). يظهر الرمز مرة واحدة فقط.
3. 03اختر الصلاحيات المسموح بها لهذا الاتصال (الملفات وقاعدة البيانات والإضافات والقوالب والمحتوى والنسخ الاحتياطية وغيرها). العمليات الخطرة تبقى معطّلة ما لم تفعّلها.
4. 04في CodeScout اضغط زر الربط بجوار خانة الرسالة (أو افتح الإعدادات ← الربط) واختر WordPress.
5. 05الصق رابط الموقع ومعرّف الاتصال ورمز API، ثم اضغط اختبار وحفظ. لا يُحفظ أي شيء إلا إذا نجح الاختبار.

بعد الربط تعرض النافذة حساب WordPress الذي يعمل به الاتصال، وإصدار WordPress والإضافة، والصلاحيات المسموح بها. اطلب من الوكيل مثلًا: "اعرض الإضافات والقوالب المثبتة" أو "غيّر لون الهيدر في القالب الفرعي".

الأمان

• يُحفظ رمز API على جهازك فقط ولا يظهر للوكيل أبدًا.
• يجب أن يستخدم الموقع https:// (يعمل http فقط مع المواقع المحلية مثل localhost).
• لا يستخدم الوكيل إلا الصلاحيات التي فعّلتها في الإضافة، ولا يُجري تغييرات إلا بطلبك، ويأخذ نسخة احتياطية قبل تعديل الملفات أو البيانات.
• يمكنك إزالة الربط من النافذة نفسها في أي وقت، أو إلغاء الرمز من صفحة الإضافة في WordPress.

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

لن تختار مزوّدًا ولن تدير مفاتيح API: المنصة توجّه كل مستوى للنموذج المناسب، وتنتقل تلقائيًا إلى مفتاح أو نموذج آخر إذا تعطل أحدها.

يعتمد CodeScout على رصيد مدفوع مسبقًا. يُحتسب كل طلب عند انتهائه حسب حجم النص الذي قرأه النموذج وكتبه، مضروبًا في مضاعِف مستوى الجودة الذي اخترته. المحادثات الأطول والردود الأكبر تكلّف أكثر.

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

كيف توفّر رصيدك

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

1. 01افتح صفحة الرصيد واختر المبلغ (ابتداءً من 5 دولار).
2. 02يمكنك إدخال كود كوبون والضغط على تطبيق لرؤية الخصم.
3. 03اضغط متابعة الدفع. تفتح صفحة الدفع الآمنة داخل موقع CodeScout نفسه: ادفع بالبطاقة أو Google Pay أو Apple Pay. وإذا طلب البنك التحقق يظهر في الصفحة نفسها.
4. 04بمجرد تأكيد الدفع يُضاف الرصيد إلى حسابك.

يمكنك الدفع بفيزا أو ماستركارد أو Google Pay أو Apple Pay (على الأجهزة التي تدعمه). تتم معالجة المدفوعات عبر XPay، ولا نرى رقم بطاقتك ولا نخزّنه أبدًا. الأسعار معروضة بالدولار وتُحصَّل بالجنيه المصري بسعر الصرف المثبّت لحظة فتح الدفع. إيصالاتك وسجل مدفوعاتك في صفحة الفواتير.

الباقات

يبدأ كل حساب بالباقة المجانية. الباقات المدفوعة تجمع رصيدًا مع مدة صلاحية؛ اطّلع على العروض الحالية في صفحة الباقات. ستصلك إشعارات قبل انتهاء باقتك.

أكواد الاستخدام

كود الاستخدام يضيف رصيدًا أو يفعّل باقة مجانًا. أدخله في خانة استخدام كود في صفحة الرصيد. يمكن استخدام كل كود مرة واحدة لكل حساب، وقد تكون للأكواد مدة صلاحية أو عدد استخدامات محدود.

الكوبونات

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

• لوحة التحكم: رصيدك وباقتك وآخر نشاطك في نظرة واحدة.
• الإحصاءات: رسوم بيانية للاستهلاك اليومي حسب المستوى وعبر الزمن.
• في التطبيق تعرض الإعدادات ← الاستخدام الاستهلاك لكل يوم ولكل محادثة.
• الإشعارات: انخفاض الرصيد (أقل من 2 رصيد) وانتهاء الباقة والإعلانات، وتظهر المهمة منها داخل التطبيق أيضًا.

الرسائل التي نرسلها

يتحقق CodeScout من التحديثات تلقائيًا. عند توفر إصدار جديد يحمّله التطبيق في الخلفية ويعرض عليك إعادة التشغيل. تبقى محادثاتك وإعداداتك وتسجيل دخولك كما هي بعد التحديث.

يمكنك دائمًا تحميل أحدث ملف تثبيت من صفحة التحميل وتثبيته فوق إصدارك الحالي.

• المحادثات والأكواد والملفات تبقى على جهازك.
• يُرسَل فقط الجزء اللازم من المحادثة عبر بوابة CodeScout إلى نموذج الذكاء الاصطناعي، والبوابة لا تخزّن محتواه.
• نحتفظ ببيانات الاستخدام (المستوى والحجم والوقت) لأغراض الفوترة.

اقرأ سياسة الخصوصية كاملة.

ما زالت المشكلة قائمة؟ أرسل /feedback من التطبيق، أو راسلنا على [email protected] موضحًا ما فعلته وما توقعته وأي رسالة خطأ ظهرت.

هل أحتاج مفتاح API من OpenAI أو Anthropic أو DeepSeek؟

لا. يوفّر CodeScout النماذج، وتدفع فقط رصيدًا مقابل ما تستخدمه.

هل يعمل الوكيل دون إنترنت؟

لا. التطبيق يعمل على جهازك، لكن نماذج الذكاء الاصطناعي تعمل سحابيًا، لذا يلزم اتصال بالإنترنت.

هل يمكنني استخدام CodeScout على أكثر من جهاز؟

نعم. ثبّته وسجّل الدخول بالحساب نفسه. رصيدك مشترك، أما المحادثات فتبقى على الجهاز الذي أُنشئت عليه.

ما لغات البرمجة المدعومة؟

كل اللغات وأطر العمل الشائعة: JavaScript و TypeScript و Python و Java و C# و Go و PHP و Rust و SQL و HTML/CSS وغيرها.

هل يمكنني استرداد ثمن الرصيد غير المستخدم؟

لا. جميع عمليات الشراء نهائية؛ راجع سياسة الاسترداد. ابدأ بشحن صغير لتجربة الخدمة أولًا.

هل يوجد إصدار لـ macOS أو Linux؟

ليس بعد. هما ضمن الخطة، وستعرضهما صفحة التحميل فور جاهزيتهما.

راسلنا على [email protected] للمساعدة في حسابك أو المدفوعات أو التطبيق. اذكر بريد حسابك في CodeScout، وعند وجود مشكلة اذكر ما فعلته وأي رسالة خطأ ظهرت.

• من داخل التطبيق أرسل /feedback للإبلاغ عن خطأ أو اقتراح تحسين؛ تصل مباشرة إلى الفريق.
• مجتمعا Discord و Telegram قريبًا، وستضع صفحة التواصل روابطهما فور افتتاحهما.