دليل المستخدم
دليل شامل وعملي لبناء البرمجيات باستخدام DeepCerebra Coder — للويب، سطح المكتب، وواجهة سطر الأوامر (CLI)

📖 جدول المحتويات

  1. مقدمة وإصدارات
  2. البدء والحساب
  3. نظرة سريعة على مساحة العمل
  4. فتح مشروع
  5. العمل مع الملفات
  6. الدردشة مع الوكيل
  7. أوضاع الدردشة الأربعة
  8. مراجعة التغييرات وتطبيقها
  9. الطرفية المدمجة
  10. وضع التخطيط والتنفيذ
  11. اختيار النماذج ووضع "تلقائي"
  12. أحضر مفتاحك الخاص (BYOK)
  13. الجهاز المحلي: نماذج GPU والطرفية (DCC Bridge)
  14. سير عمل التعاون عبر Git
  15. خوادم MCP
  16. تخصيص الوكيل: القواعد، المهارات، الخطافات، الوكلاء الفرعيون، والمكونات الإضافية
  17. استوديو سير العمل الوكيلي والوكلاء المعتمدون على الأحداث
  18. الإكمال التنبؤي بالضغط على Tab
  19. الاستخدام، الرصيد، والفواتير
  20. الحصول على مفتاح API الخاص بالبوابة
  21. الأمان والخصوصية
  22. استكشاف الأخطاء وإصلاحها
  23. DeepCerebra Discovery — اسأل بياناتك ومستنداتك

1 مقدمة وإصدارات

DeepCerebra Coder هو مساعد برمجة وكيلي. على عكس مساعد الإكمال التلقائي البسيط، فإنه يخطط، يكتب، يعيد هيكلة، يشغل الأوامر، يستدعي الأدوات، ويكرر العمل عبر مشروعك بأكمله — مع مراجعتك واعتمادك للتغييرات التي يقترحها.

ثلاث طرق لاستخدامه

الإصدارالأفضل لـالوصول إلى الملفات
تطبيق الويبتثبيت صفري، العمل من أي جهازتخزين سري داخل المتصفح (ومستودعات Git)
سطح المكتب (Windows / Linux / macOS)تطوير محلي أولاً، نماذج محليةنظام الملفات المحلي المباشر
CLI و APIالبرمجة النصية، CI/CD، الأتمتةملفات محلية / برمجية

يركز هذا الدليل على تطبيق الويب على deepcerebra.ai؛ يعكس تطبيق سطح المكتب نفس اللوحات وسير العمل.

2 البدء & الحساب

المتصفحات المدعومة

استخدم إصدارًا حديثًا من Chrome أو Edge أو Brave للحصول على التجربة الكاملة — يعتمد فتح مجلد محلي على Chromium File System Access API. يعمل Firefox و Safari للدردشة وللمشاريع المدعومة بـ Git، ولكن لا يمكنهما فتح مجلد محلي مباشرةً.

إنشاء حساب

  1. انقر على البدء في الصفحة الرئيسية.
  2. املأ اسم العرض الاختياري، البريد الإلكتروني، البلد، و تاريخ الميلاد (يجب أن يكون عمرك 18 عامًا على الأقل).
  3. اختر لغة الواجهة وكلمة مرور لا تقل عن 12 حرفًا.
  4. اقرأ إشعار الاتفاقية وقم بالتأكيد. إنشاء حساب يعني موافقتك على شروط الخدمة، بيان الخصوصية، وصف الخدمات، و اتفاقية معالجة البيانات العالمية (Global DPA).
  5. انقر على إنشاء حساب، ثم تحقق من بريدك الإلكتروني إذا طُلب منك، وقم بتسجيل الدخول.
💡 نصيحة: يمكنك اختيار خطة أثناء التسجيل بزيارة /register?plan=basic (أو pro / ultimate)، أو البدء الآن واختيار خطة لاحقًا في الفواتير.

إعادة تعيين كلمة المرور الخاصة بك

  1. في صفحة تسجيل الدخول، انقر على هل نسيت كلمة المرور؟
  2. أدخل بريدك الإلكتروني وافتح رابط إعادة التعيين المرسل إلى صندوق الوارد الخاص بك.
  3. عيّن كلمة مرور جديدة (12 حرفًا كحد أدنى).

3 نظرة سريعة على مساحة العمل

بعد تسجيل الدخول، تهبط في بيئة العمل، التي تضع كل لوحة في شاشة واحدة:

اسحب الفاصل بين المحرر والدردشة لإعادة توازن التخطيط، واسحب الفاصل الأفقي لتغيير حجم الطرفية. يتنقل الشريط الجانبي الأيسر أيضًا إلى مساحة العمل، الإضافات، مفاتيح API، الفواتير، والملاحظات.

4 فتح مشروع

4.1 فتح مجلد محلي

  1. في المستكشف، انقر على فتح مجلد المشروع.
  2. اختر مجلدًا وامنح المتصفح إذنًا بقراءته.
  3. تُقرأ الملفات في مساحة عمل متصفحك المشفرة داخل المتصفح — لا يتم تحميل أي شيء. سترى عددًا مباشرًا وملخصًا نهائيًا (عدد الملفات · الحجم، بالإضافة إلى أي ملفات تم تخطيها أو اقتطاعها).
⚠️ دعم المتصفح: إذا رأيت ملاحظة تفيد بأن تحميل المجلد يتطلب متصفح Chromium، فقم بالتبديل إلى Chrome/Edge/Brave، أو استخدم الفتح من Git بدلاً من ذلك.

4.2 الفتح من Git (GitHub / GitLab)

  1. انقر على فتح من Git في المستكشف.
  2. اختر علامة التبويب GitHub أو GitLab والصق رمز وصول شخصي. لـ GitHub، استخدم نطاق repo (كلاسيكي) أو رمزًا دقيقًا مع Contents + Pull requests؛ لـ GitLab، استخدم نطاق api. يتم تخزين الرمز الخاص بك على الخادم — يتم سحب محتويات الملفات فقط إلى المتصفح.
  3. اكتب المستودع كـ owner/name (قم بتصفية القائمة للعثور على مستودعك)، ثم اختر فرعًا.
  4. اختياريًا، ضع علامة على إنشاء فرع عمل جديد (مثل dcc/my-feature) للحفاظ على عملك معزولًا عن الفرع الافتراضي.
  5. اختياريًا، قم بتمكين خطاف الدفع (push webhook) بحيث يتم تحديث المستكشف فورًا عندما يقوم زملاء الفريق بالدفع (يتطلب عنوان URL عامًا للبوابة).
  6. انقر على فتح المستودع.

4.3 التحديث، التبديل، والإغلاق

4.4 جلسات الدردشة المحددة بالمجلد

سجل الدردشة مرتبط بالمشروع المفتوح. يؤدي تبديل المجلدات تلقائيًا إلى بدء جلسة جديدة وتحميل الجلسات السابقة لذلك المجلد، وإعادة فتح الأحدث حتى تتمكن من استئناف العمل من حيث توقفت.

4.5 المجلدات التشغيلية

المجلدات التي يستخدمها DeepCerebra داخليًا — .deepcerebra، .sessions — تظهر في الشجرة ولكنها مطوية افتراضيًا حتى لا تشوش على مصدرك.

5 العمل مع الملفات

6 الدردشة مع الوكيل

اكتب طلبًا

صف ما تريده بلغة بسيطة — اطرح سؤالًا، اطلب ميزة، أو أشر إلى خطأ. كن محددًا بشأن الملفات، الأطر، والقيود للحصول على أفضل نتيجة. أرفق الملفات ذات الصلة عن طريق سحبها إلى مربع الدردشة.

اقرأ الردود، بأسلوب Cursor

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

توجيه أو إيقاف تشغيل

💡 نصيحة (سطح المكتب): في تطبيق سطح المكتب، تستدعي الوكيل في الدردشة بـ @deepcerebra، وتطلب البادئات مثل [deep] تفكيرًا أعمق.

7 أوضاع الدردشة الأربعة

اختر وضعًا من محدد الأوضاع بجوار مربع الدردشة. يضبط كل وضع مدى تخطيط الوكيل ومدى حريته في التعديل:

الوضعما يفعلهاستخدمه عندما…
وكيل (Agent)يخطط ويعدل عبر مشروعك بشكل مستقلتريد من المساعد تنفيذ تغيير شامل
سؤال (Ask)يجيب على الأسئلة حول التعليمات البرمجية الخاصة بك دون تعديلتريد فهم قاعدة التعليمات البرمجية
تخطيط (Plan)يصيغ نهجًا قبل أي تعديلالمهمة كبيرة أو تتطلب تسوية مقايضات أولاً
تعديل (Edit)يجري تعديلات مركزة في السياق الحاليتريد تغييرًا صغيرًا ومستهدفًا

8 مراجعة التغييرات وتطبيقها

عندما يقترح الوكيل تغييرات في الملفات، تظهر لوحة التغييرات المقترحة فوق مربع إدخال الدردشة، وتسرد كل ملف تم لمسه مع عدد الأسطر المضافة (+) والمحذوفة (−).

⚠️ راجع دائمًا: قد تحتوي التعليمات البرمجية التي تم إنشاؤها بواسطة الذكاء الاصطناعي على أخطاء أو أنماط غير آمنة. راجع الفرق واختبر قبل الاعتماد عليها أو نشرها.

9 الطرفية المدمجة

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

10 وضع التخطيط والتنفيذ

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

11 اختيار النماذج ووضع "تلقائي"

افتح محدد النموذج بجوار مربع الدردشة. تُصنف الخيارات كالتالي:

كيف يعمل الاختيار التلقائي

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

12 أحضر مفتاحك الخاص (BYOK)

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

  1. افتح مفاتيح API من الشريط الجانبي.
  2. تحت أحضر مفتاحك الخاص، اختر مزودًا (مثل ANTHROPIC_API_KEY، GOOGLE_API_KEY، OPENAI_API_KEY).
  3. الصق قيمة المفتاح وانقر على حفظ. يتم تشفير المفاتيح في وضع السكون ولا تُعاد أبدًا إلى المتصفح — يتم عرض معاينة مقنعة فقط.

نماذج المنصة (DeepCerebra) لا تحتاج إلى مفتاح. أزل مفتاحًا في أي وقت باستخدام إزالة.

13 الجهاز المحلي: نماذج GPU والطرفية (DCC Bridge)

يربط DCC Bridge جهاز الكمبيوتر الخاص بك بتطبيق الويب من خلال موصل dcc-bridge صغير، مما يفتح قدرتين في وقت واحد:

يقوم الموصل بالاتصال خارجًا عبر WebSocket مصادق عليه — لا توجد حاجة لمنافذ واردة، ويعمل خلف NAT وجدران الحماية. يعمل على Windows و macOS و Linux (Python 3.10+).

13.1 إقران جهاز الكمبيوتر الخاص بك

  1. انقر على أيقونة الكمبيوتر المحمول في شريط الأنشطة الأيسر — الجهاز المحلي (GPU + الطرفية). (تفتح نفس اللوحة من تذييل محدد النموذج عبر إدارة GPU المحلي…).
  2. تأكد من تمكين مفتاح التنفيذ المحلي، وسمِّ الجهاز، وانقر على إضافة هذا الكمبيوتر. انسخ رمز الإقران لمرة واحدة (dcc_brg_…) وأمر الموصل الجاهز للصق — يُعرض الرمز مرة واحدة فقط.

13.2 تثبيت وتشغيل الموصل

pip install git+https://github.com/mohammadkhair7/DeepCerebra-connector

# then run the command copied from the pairing card, e.g.:
python -m dcc_bridge --gateway wss://deepcerebra.ai --token dcc_brg_xxxxx

13.3 استخدم الطرفية الخاصة بك من تطبيق الويب

بشكل افتراضي، تقتصر الأوامر على مجلد مساحة عمل مخصص (~/DeepCerebra). للعمل في مجلدات مشروعك الحقيقية باستخدام واجهات سطر الأوامر (CLIs) المكونة مسبقًا، امنحها صراحةً عند بدء تشغيل الموصل:

# grant one or more real folders (repeatable)
python -m dcc_bridge --gateway wss://deepcerebra.ai --token dcc_brg_xxxxx --host-dir "F:\MyProjects"

# or the whole machine (prints a warning; prefer --host-dir)
python -m dcc_bridge ... --allow-any-dir

ثم افتح لوحة الطرفية، انقر على النافذة المنبثقة هدف التنفيذ (أيقونة الكمبيوتر المحمول)، اختر جهازي، واختر دليل عمل. يتم بعد ذلك تنفيذ كل من الأوامر التي تكتبها وأوامر البناء/الاختبار الخاصة بالوكيل على جهازك.

⚠️ الأمان: لا يتجاوز وصول المضيف أبدًا المجلدات التي أنت أدرجتها في سطر أوامر الموصل؛ يتم تجزئة الرموز في وضع السكون ويمكن إلغاؤها في أي وقت؛ --no-exec يجعل الجهاز مخصصًا للاستدلال فقط (نماذج GPU، بدون أوامر).
💡 نصيحة: يمكن لتطبيق سطح المكتب استخدام النماذج المحلية مباشرةً بدون الموصل. مرجع الموصل الكامل: github.com/mohammadkhair7/DeepCerebra-connector.

14 سير عمل التعاون عبر Git

مع فتح مشروع مدعوم بـ Git، يظهر شريط الفروع في المستكشف يوضح فرعك الحالي وإجراءين:

إذا كان خطاف الدفع (push webhook) ممكّنًا، يقوم المستكشف بالتحديث التلقائي عندما يقوم زملاء الفريق بالدفع، مما يحافظ على تزامن الجميع — وهو الأساس لتطوير الفريق التعاوني من خلال DeepCerebra.

15 خوادم MCP

قم بتوسيع الوكيل باستخدام أدوات وبيانات خارجية عبر بروتوكول سياق النموذج (Model Context Protocol). قم بتكوين الخوادم في ملف .deepcerebra/mcp.json، على سبيل المثال:

{
  "mcpServers": {
    "my-tools": {
      "url": "https://example.com/mcp",
      "disabled": false,
      "allowlist": ["search_issues", "get_pr"],
      "autoApprove": ["create_issue"],
      "auth": { "type": "bearer", "tokenEnv": "MY_TOKEN" }
    }
  }
}

تصبح أدوات MCP الممكنة متاحة للوكيل تلقائيًا عندما تكون ذات صلة بطلبك. يتم دعم كل من الخوادم المحلية (stdio) والبعيدة (http/sse).

أمان مدمج

الموارد والمطالبات

إذا كان الخادم يعرض موارد MCP أو قوالب المطالبات، يكتسب الوكيل تلقائيًا أدوات لاستخدامها (mcp_list_resources، mcp_read_resource، mcp_list_prompts، mcp_get_prompt).

المصادقة للخوادم البعيدة

أضف كتلة auth إلى خادم بعيد. تدعم الأسرار استيفاء ${ENV_VAR}:

// Static bearer token (literal or from env)
"auth": { "type": "bearer", "token": "${GITHUB_TOKEN}" }
"auth": { "type": "bearer", "tokenEnv": "GITHUB_TOKEN" }

// Custom header (e.g. API key)
"auth": { "type": "header", "header": "x-api-key", "value": "${MY_KEY}" }

// OAuth 2.0 client-credentials
"auth": {
  "type": "oauth", "grant": "client_credentials",
  "tokenUrl": "https://auth.example.com/oauth/token",
  "clientId": "${MCP_CLIENT_ID}", "clientSecret": "${MCP_CLIENT_SECRET}",
  "scope": "mcp.read mcp.write"
}

16 تخصيص الوكيل: القواعد، المهارات، الخطافات، الوكلاء الفرعيون، والمكونات الإضافية

يمكنك تشكيل طريقة تفكير الوكيل وتصرفه باستخدام اتفاقية واحدة قائمة على الملفات — دليل .deepcerebra/ — الذي يعمل بشكل متطابق في تطبيق سطح المكتب، تطبيق الويب، وAPI. في تطبيق الويب، قم بإدارة كل هذه العناصر ضمن عرض الوكيل؛ على سطح المكتب وعبر API، هي ملفات عادية تقوم بالالتزام بها مع مشروعك.

النطاقات والأسبقية

يتم اكتشاف التكوين من عدة نطاقات؛ عندما يوجد نفس العنصر في أكثر من نطاق واحد، يفوز العنصر ذو الأسبقية الأعلى:

team/org  <  global (~/.deepcerebra)  <  workspace (<repo>/.deepcerebra)
(lowest)                                              (highest)

القواعد (التوجيه)

القواعد هي تعليمات دائمة — معايير الترميز، اتفاقيات البنية، سياق المجال — تُحقن في مطالبة نظام الوكيل. توجد كملفات Markdown تحت .deepcerebra/steering/، بالإضافة إلى معيار AGENTS.md الذي يعمل دائمًا. تتحكم الواجهة الأمامية في متى يتم تحميل القاعدة:

---
inclusion: fileMatch          # always | fileMatch | auto | manual
globs: "src/**/*.ts"          # or fileMatchPattern
name: api-design
description: REST conventions
---
# API design
- Use REST resource nouns, plural.

ينطبق ملف AGENTS.md الجذري على مستوى المستودع؛ ينطبق ملف AGENTS.md المتداخل (مثل services/api/AGENTS.md) فقط على الملفات الموجودة ضمن هذا المجلد. في تطبيق الويب، يوفر عرض الوكيل ← التوجيه لكل قاعدة محدد النطاق (Scope) (عام (Global) / مشروع (Project) / فريق (Team)).

المهارات

المهارات هي أدلة تشغيل قابلة لإعادة الاستخدام يقوم الوكيل بتحميلها عند الطلب. كل مهارة هي مجلد يحتوي على SKILL.md تحت .deepcerebra/skills/:

---
name: deploy-release
description: How to cut and publish a versioned release.
disable-model-invocation: false   # true => manual-only (/skill)
---
# Deploy a release
1. Bump the version, build, and test.
2. Tag and publish.

يرى الوكيل كتالوجًا خفيف الوزن (الاسم + الوصف) ويسحب النص الكامل باستخدام أداة load_skill عندما يكون ذلك مناسبًا. يمكنك أيضًا استدعاء مهارة بشكل صريح باستخدام /skill <name>. اضبط disable-model-invocation: true لجعل المهارة يدوية فقط.

الخطافات (Hooks)

تقوم الخطافات بتشغيل الأتمتة على أحداث دورة الحياة. قم بتعريفها كـ .deepcerebra/hooks/*.hook.json:

{
  "title": "Format on save",
  "event": "fileSave",
  "filePattern": ["**/*.ts"],
  "action": { "type": "shell", "command": "npm run lint:fix -- $FILE" },
  "enabled": true
}

تشمل الأحداث promptSubmit، preToolUse، postToolUse، fileCreate، fileSave، fileDelete، preTask، postTask، sessionStart، preCompact، وagentStop (تُقبل أيضًا تهجئات Cursor/Claude). الإجراء إما shell (تشغيل أمر) أو agentPrompt (سؤال الوكيل). يمكن لخطاف preToolUse أن يسمح، يرفض، أو يطلب استدعاء الأداة الذي يعترضه.

الوكلاء الفرعيون (Subagents)

الوكلاء الفرعيون هم وكلاء متخصصون تقوم بتعريفهم وتفويض المهام إليهم. كل منهم عبارة عن ملف Markdown تحت .deepcerebra/agents/ مع واجهة أمامية بالإضافة إلى نص (مطالبة النظام الخاصة به):

---
name: security-reviewer
description: Audits a diff for security issues; read-only.
model: gpt-5
readonly: true
tools: [read_file, grep_files, list_directory]
background: false
---
You are a meticulous security reviewer…

يقوم الوكيل الرئيسي بالتفويض باستخدام task (حظر)، task_async + task_status / task_result (في الخلفية)، أو task_parallel (توزيع).

المكونات الإضافية (Plugins)

يقوم المكون الإضافي بتجميع القواعد والمهارات والخطافات والوكلاء الفرعيين وخوادم MCP في حزمة واحدة قابلة للتثبيت تحت .deepcerebra/plugins/<name>/، موصوفة بواسطة بيان plugin.json:

{
  "name": "Acme Standards",
  "version": "1.2.0",
  "description": "Acme rules + skills + review agents.",
  "enabled": true
}

يتم دمج محتويات المكون الإضافي بأدنى أسبقية، لذلك تتجاوز قواعدك ومهاراتك دائمًا قواعد ومهارات المكون الإضافي. قم بتعطيل مكون إضافي باستخدام "enabled": false أو ملف علامة .disabled.

💡 نصيحة: يمكن للفريق نشر إعدادات افتراضية مشتركة عن طريق توجيه DCC_ORG_CONFIG_DIR إلى دليل .deepcerebra مشترك، أو عن طريق تعيين القواعد إلى نطاق الفريق في تطبيق الويب.

17 استوديو سير العمل الوكيلي والوكلاء المعتمدون على الأحداث

استوديو سير العمل (Workflow Studio) هو مصمم مرئي لأتمتة متعددة الوكلاء. تقوم بتكوين مراحل — كل منها وكيل، خطوة متخصصة، أو بدائية تحكم — في رسم بياني، تربطها بالتبعيات، وتشغل التنسيق بأكمله على المحرك مع تقدم مباشر لكل مرحلة، وميزانيات، وبوابات موافقة بشرية. يتم حفظ سير العمل كتعريف YAML/JSON محمول يمكنك تصديره، استيراده، تحديد إصداراته في Git، وتشغيله من API أو CLI.

17.1 بناء سير عمل

17.2 مكتبة المراحل

نوع المرحلةما تفعله
agentدورة وكيل واحدة مع المهارات والأدوات التي ترفقها.
spec.requirements / spec.design / spec.execute التسليم القائم على المواصفات أولاً: صياغة المتطلبات، التصميم، ثم تقسيمها إلى مهام وتنفيذها — كل منها قابل للبوابة.
documents.generateإنتاج مستند مصقول من مخرجات المراحل السابقة.
fan_outبحث واسع متوازي عبر العديد من المواضيع الفرعية مع التوليف.
map / loop / switch بدائيات التحكم: تشغيل جسم لكل عنصر، التكرار حتى شرط، أو التفرع عبر الحالات.
verify / browser_verify تشغيل الاختبارات أو الأوامر في بيئة الاختبار المعزولة؛ التحقق من واجهة مستخدم قيد التشغيل باستخدام أتمتة المتصفح.
orchestrateالتوجيه الديناميكي: وكيل منسق يقرأ الطلب ويرسله إلى أفضل وكيل (وكلاء) لاحق عبر الأحداث.
external.agentاستدعاء وكيل طرف ثالث مسجل عبر HTTP (A2A) كما لو كان مرحلة أصلية.
evalتقييم مخرجات سابقة مقابل فحوصات (تحتوي على / تعبير عادي / طول / LLM-judge)؛ الفشل إذا كانت أقل من عتبة معينة.
db.provisionتوليد طبقة بيانات مملوكة: docker-compose لقاعدة البيانات، ترحيلات SQL ذات إصدارات، بيانات أولية، قالب .env، ومخطط علاقات الكيانات (Mermaid ERD)؛ هيكل مصادقة اختياري؛ يمكن تطبيق الترحيلات على SQLite فورًا.
ci.generateتوليد خط أنابيب CI/CD جاهز للالتزام (GitHub Actions، GitLab CI، أو Azure Pipelines) مع lint → test → scan → build → deploy وترقية البيئة.
deploy.packageتوليد أصول نشر الإنتاج: Dockerfile متعدد المراحل، docker-compose، Kubernetes manifests، أو مخطط Helm — ملفات تمتلكها وتلتزم بها.
test.generateتوليد مجموعات اختبار الوحدة / API / E2E للتطبيق المبني بالإضافة إلى مصفوفة تتبع المتطلبات إلى الاختبار.
test.verifyتنفيذ مجموعة اختبار (pytest، vitest، jest، Playwright) وتحديد نتيجة التشغيل بناءً على معدل النجاح.
security.auditمسح التبعيات بحثًا عن الثغرات الأمنية المعروفة والشجرة بحثًا عن الأسرار المكتوبة بشكل ثابت؛ ينشر أحداث التنبيه ويكتب تقرير النتائج.
previewبدء تشغيل التطبيق الذي تم إنشاؤه محليًا وعرض عنوان URL المباشر الخاص به في لوحة التشغيل (رابط + إطار مضمن) عبر حدث preview.ready.
design.importتحويل صورة تصميم واجهة المستخدم (لقطة شاشة، نموذج، تصدير Figma) إلى مواصفات تنفيذ منظمة للمراحل اللاحقة.

17.3 الوكلاء المعتمدون على الأحداث (شبكة الوكلاء)

يمكن لكل مرحلة — بغض النظر عن نوعها — أن تنشر وتشترك في الأحداث المكتوبة على ناقل أحداث مساحة العمل، بحيث تتناسق الوكلاء كخدمات على نسيج رسائل بدلاً من التنسيق عبر DAG فقط:

17.3.1 تصفيف الأحداث للوكلاء

يمكن للوكلاء الذين يتفاعلون مع الأحداث الإعلان عن قائمة انتظار دائمة ومسماة حتى لا تُفقد الأحداث المطابقة أبدًا بينما يكون الوكيل مشغولاً أو قبل أن تستمع عملية تشغيل. عند الاشتراك في مشغل، اضبط queue: <name> — يربط المحرك هذا الموضوع بقائمة انتظار FIFO على ناقل أحداث مساحة العمل (يتم الاحتفاظ بها تحت .deepcerebra/workflows/events/queues/). يتم التقاط كل حدث مطابق يتم نشره من تلك النقطة فصاعدًا في قائمة الانتظار؛ وعندما تصبح المرحلة قابلة للتشغيل، يقوم المحرك بإخراج الأحداث بترتيب الأقدم أولاً ويستهلكها واحدًا تلو الآخر.

events:
  subscribe:
    - topic: ticket.created
      mode: trigger
      queue: triage-inbox        # durable FIFO — events wait here for this agent
      map:
        payload.ticket_id: ticket_id

17.3.2 تنسيق الإشارة (حماية الموارد المشتركة)

تحد الإشارة من عدد المهام التي يمكنها العمل في وقت واحد على مورد مشترك (محمي): قاعدة بيانات يتم الكتابة إليها، أو مخزن متغيرات عام، أو ملف، أو وكيل خارجي محدود المعدل. قم بإرفاق واحدة بأي مرحلة باستخدام semaphore: — قبل تشغيل عمل المرحلة، يحصل المحرك على تصريح واحد من إشارة مساحة العمل المسماة؛ يتم دائمًا تحرير التصريح بعد ذلك، حتى لو فشلت المرحلة. permits: 1 يجعلها mutex: مهمة واحدة فقط في كل مرة (عبر جميع عمليات التشغيل المتوازية في مساحة العمل) تنفذ الخطوة الحرجة؛ تنتظر كل مهمة أخرى حتى ينتهي الحامل.

semaphore:
  name: emr-db-writer
  permits: 1          # mutex — one writer at a time
  timeout_s: 300      # fail if still waiting after 5 minutes
  ttl_s: 900          # auto-release crashed holders after 15 minutes

17.3.3 تنسيق نقطة الالتقاء (انتظار جميع الشروط)

تنتظر نقطة الالتقاء حتى يتم استيفاء شروط أحداث متعددة قبل أن تنتقل الخطوة التالية — عكس "أول حدث يفوز". اضبط join: all في كتلة events: الخاصة بالمرحلة: يجب تلبية كل اشتراك مشغل قبل تشغيل المرحلة. اجمع ذلك مع count: N لكل اشتراك عندما يجب على العديد من الوكلاء (أو عدة تقارير من وكيل واحد) تسجيل الدخول جميعًا — على سبيل المثال، الموافقة على التصميم، واكتمال الاختبار، والموافقة الأمنية قبل تنفيذ مرحلة الإصدار.

events:
  join: all                    # rendezvous — wait for EVERY subscription below
  subscribe:
    - topic: design.approved
      mode: trigger
    - topic: tests.passed
      mode: trigger
    - topic: security.cleared
      mode: trigger
      count: 1

17.4 مكتبة أدوات الوكيل

تختار المراحل الأدوات من نفس السجل الذي يستخدمه وكيل الدردشة:

17.5 التشغيل، البوابات، والمخرجات

💡 نصيحة: ابدأ بقالب Ship-It Pipeline: فهو يربط التصميم ← db.provision ← التنفيذ ← الاختبارات المولدة ← تدقيق الأمان ← حزم النشر ← توليد CI، مع بوابة بشرية قبل الحزم — مسار كامل من الملخص إلى الإنتاج يمكنك تكييفه في دقائق.

18 الإكمال التنبؤي بالضغط على Tab

يوفر الإكمال التنبؤي بالضغط على Tab اقتراحات تعليمات برمجية مضمنة، تملأ الفراغات في المنتصف، أثناء الكتابة في المحرر — اقبل الاقتراح بالضغط على Tab. إنه اختياري على كل من المحرك ومحرر الويب.

تمكينه

كيف يتصرف

19 الاستخدام، الرصيد، والفواتير

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

الخطةالسعر الشهريالاستخدام الشهري المضمن للذكاء الاصطناعي
أساسي (Basic)$20$10
احترافي (Pro)$75$30
أقصى (Ultimate)$200$150
💡 وفر في الاستخدام: استخدم تلقائي اختيار النموذج، أحضر مفتاحك الخاص (BYOK)، أو قم بتشغيل النماذج المحلية لتقليل أو تجنب الاستخدام المدفوع.

20 الحصول على مفتاح API الخاص بالبوابة

يتيح لك مفتاح API الخاص بالبوابة (رمز وصول شخصي) استخدام DeepCerebra public API و CLI برمجيًا.

  1. سجل الدخول وافتح مفاتيح API من الشريط الجانبي.
  2. انتقل إلى مفاتيح DeepCerebra API.
  3. أدخل تسمية (مثل "CI pipeline" أو "laptop CLI").
  4. حدد النطاقاتread، chat، code، agent — وتاريخ انتهاء صلاحية اختياري بالأيام (فارغ = لا ينتهي أبدًا).
  5. انقر على توليد. يُعرض المفتاح الكامل مرة واحدة فقط — انقر على نسخ وقم بتخزينه بأمان.

استخدمه مع CLI أو API على deepcerebra.ai:

dcc config set endpoint https://deepcerebra.ai
dcc config set api-key <your-key>

# or as a Bearer token
curl -H "Authorization: Bearer <your-key>" https://deepcerebra.ai/v1/...

يمكنك إعادة تسمية أو حذف (إلغاء) مفتاح في أي وقت؛ يعرض كل مفتاح بادئته، نطاقاته، تاريخ الإنشاء/الانتهاء، وتاريخ آخر استخدام.

⚠️ حافظ على سريته. يمكن لأي شخص لديه مفتاحك استخدام حسابك وتكبد الاستخدام. قم بإلغائه وإعادة توليده فورًا إذا تعرض للكشف.

21 الأمان والخصوصية

22 استكشاف الأخطاء وإصلاحها

"يتطلب تحميل المجلد متصفح Chromium"

قم بالتبديل إلى Chrome أو Edge أو Brave، أو استخدم الفتح من Git بدلاً من ذلك.

الوكيل يدور في حلقة على نفس الخطأ

انقر على إيقاف، ثم أعد صياغة الطلب بتلميح أو قيد ملموس.

أخطاء النموذج أو الطلب / "نفدت الميزانية"

النماذج المحلية لا تظهر

الموصل: "رفض الخادم اتصال WebSocket: HTTP 401"

تغييراتي لم تُطبق

Git: "أنت على الفرع الافتراضي"

افتح أو أنشئ فرع عمل قبل استخدام الدمج لفتح طلب سحب.

ما زلت تواجه مشكلة؟ اتصل بـ support@deepcerebra.ai.

23 DeepCerebra Discovery — اسأل بياناتك ومستنداتك

Discovery هو روبوت محادثة استقصائي لـ قواعد بياناتك ومستنداتك. بدلاً من الإجابة باستعلام واحد، يعمل كمحلل: يشكل فرضيات، ويُجري سلسلة من التحقيقات المحمية (SQL، الرسوم البيانية، البحث في المستندات، فحوصات المخطط، التحقق عبر الويب)، ويستبعد التفسيرات التي تدحضها الأدلة، ويصوغ إجابة مدعومة بالأدلة — مع رسوم بيانية وإيصال تكلفة شفاف. افتحه من أيقونة البوصلة في شريط الأنشطة (/app/discovery).

23.1 المساحات — نطاقك المنسق

تجمع المساحة كل ما تحتاجه سلسلة من الأسئلة: اتصالات قواعد البيانات، ومجموعات المستندات، وتعليمات للمحلل، والميزانيات. أنشئ واحدة باستخدام + مساحة جديدة، ثم استخدم لوحة الإعداد على اليمين من أجل:

23.2 طرح سؤال

اكتب سؤالاً بالطريقة التي تسأل بها زميلاً — على سبيل المثال "Why did MRI scan volume dip in March?". تعرض لوحة التحقيق العملية بأكملها مباشرة:

تستمر أسئلة المتابعة في نفس السياق، ليحافظ المحلل على سياقه.

23.3 الرسوم البيانية والتقارير وعمليات التصدير

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

23.4 الميزانيات والتحكم في التكلفة

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

23.5 الأتمتة: API, SDK, Workflow Studio & MCP