راهنمای کاربر
راهنمای کامل و عملی برای ساخت نرم‌افزار با 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. تکمیل خودکار پیش‌بینی‌کننده
  19. میزان استفاده، اعتبار و صورت‌حساب
  20. دریافت کلید API Gateway خود
  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. اعلامیه توافق را بخوانید و تأیید کنید. ایجاد حساب کاربری به این معنی است که شما با شرایط خدمات، بیانیه حریم خصوصی، توضیحات خدمات و 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 را فعال کنید تا کاوشگر بلافاصله هنگام push هم‌تیمی‌ها تازه‌سازی شود (به یک URL عمومی gateway نیاز دارد).
  6. روی باز کردن مخزن کلیک کنید.

4.3 تازه‌سازی، تغییر و بستن

4.4 جلسات گفتگوی محدود به پوشه

تاریخچه گفتگو به پروژه باز شده گره خورده است. تغییر پوشه‌ها به طور خودکار یک جلسه جدید را شروع می‌کند و جلسات قبلی آن پوشه را بارگذاری می‌کند، و جدیدترین جلسه را دوباره باز می‌کند تا بتوانید از جایی که متوقف شدید، ادامه دهید.

4.5 پوشه‌های عملیاتی

پوشه‌هایی که DeepCerebra به صورت داخلی استفاده می‌کند — .deepcerebra، .sessions — در درخت ظاهر می‌شوند اما به طور پیش‌فرض جمع شده‌اند تا منبع شما را شلوغ نکنند.

5 کار با فایل‌ها

6 گفتگو با عامل

نوشتن یک درخواست

آنچه را که می‌خواهید به زبان ساده توصیف کنید — یک سوال بپرسید، یک ویژگی را درخواست کنید یا به یک باگ اشاره کنید. برای بهترین نتیجه، در مورد فایل‌ها، چارچوب‌ها و محدودیت‌ها دقیق باشید. فایل‌های مرتبط را با کشیدن آنها به قسمت ورودی گفتگو پیوست کنید.

خواندن پاسخ‌ها، به سبک Cursor

پاسخ‌ها مانند Cursor سازماندهی شده‌اند: استدلال عامل از خروجی قابل تحویل جدا شده است. هر بلوک پاسخ دارای یک نماد کپی در گوشه بالا سمت راست خود است تا بتوانید یک گزارش کامل، سند یا دستوری را که قرار است اجرا کنید، کپی کنید.

هدایت یا توقف یک اجرا

💡 نکته (دسکتاپ): در برنامه دسکتاپ، عامل را در گفتگو با @deepcerebra فراخوانی می‌کنید، و پیشوندهایی مانند [deep] درخواست استدلال عمیق‌تر می‌کنند.

7 چهار حالت گفتگو

یک حالت را از انتخابگر حالت کنار اعلان انتخاب کنید. هر کدام میزان برنامه‌ریزی عامل و آزادی آن در ویرایش را تنظیم می‌کند:

حالتکاری که انجام می‌دهدزمان استفاده…
عاملبه طور مستقل در سراسر پروژه شما برنامه‌ریزی و ویرایش می‌کندزمانی که می‌خواهید دستیار یک تغییر را به صورت کامل پیاده‌سازی کند
پرسشبدون ویرایش، به سوالات مربوط به کد شما پاسخ می‌دهدزمانی که می‌خواهید پایگاه کد را درک کنید
برنامه‌ریزیپیش‌نویس رویکردی قبل از هرگونه ویرایشوظیفه بزرگ است یا ابتدا باید مصالحه‌ها را حل و فصل کرد
ویرایشویرایش‌های متمرکز در زمینه فعلی انجام می‌دهدزمانی که یک تغییر کوچک و هدفمند می‌خواهید

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 فعال باشد، کاوشگر به طور خودکار هنگام push هم‌تیمی‌ها تازه‌سازی می‌شود و همه را همگام نگه می‌دارد — این اساس توسعه تیمی مشارکتی از طریق 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 آنها فایل‌های ساده‌ای هستند که با پروژه خود commit می‌کنید.

دامنه‌ها و اولویت

پیکربندی از چندین دامنه کشف می‌شود؛ هنگامی که همان مورد در بیش از یک دامنه وجود داشته باشد، دامنه با اولویت بالاتر برنده می‌شود:

team/org  <  global (~/.deepcerebra)  <  workspace (<repo>/.deepcerebra)
(پایین‌ترین)                                              (بالاترین)

قوانین (هدایت)

قوانین دستورالعمل‌های دائمی هستند — استانداردهای کدنویسی، قراردادهای معماری، زمینه دامنه — که به درخواست سیستم عامل تزریق می‌شوند. آنها به عنوان فایل‌های Markdown زیر .deepcerebra/steering/ زندگی می‌کنند، به علاوه استاندارد همیشه فعال AGENTS.md. Frontmatter کنترل می‌کند چه زمانی یک قانون بارگذاری می‌شود:

---
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) فقط برای فایل‌های زیر آن پوشه اعمال می‌شود. در برنامه وب، نمای عامل → هدایت به هر قانون یک انتخابگر دامنه (سراسری / پروژه / تیم) می‌دهد.

مهارت‌ها

مهارت‌ها دفترچه‌های راهنمای قابل استفاده مجددی هستند که عامل آن‌ها را بر حسب تقاضا بارگذاری می‌کند. هر مهارت یک پوشه است که حاوی یک 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 را تنظیم کنید تا یک مهارت فقط دستی شود.

هوک‌ها

هوک‌ها اتوماسیون را در رویدادهای چرخه حیات اجرا می‌کنند. آنها را به عنوان .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 می‌تواند فراخوانی ابزار را که رهگیری می‌کند، اجازه دهد، رد کند یا بپرسد.

زیرعامل‌ها

زیرعامل‌ها عامل‌های متخصصی هستند که شما تعریف کرده و به آنها واگذار می‌کنید. هر یک یک فایل Markdown زیر .deepcerebra/agents/ با frontmatter به علاوه یک بدنه (درخواست سیستم آن) است:

---
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 (فن‌اوت) واگذار می‌کند.

پلاگین‌ها

یک پلاگین قوانین، مهارت‌ها، هوک‌ها، زیرعامل‌ها و سرورهای 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 استودیوی گردش کار عامل‌محور و عامل‌های رویدادمحور

استودیوی گردش کار یک طراح بصری برای اتوماسیون چندعاملی است. شما مراحل — هر یک یک عامل، یک گام تخصصی یا یک اولیه کنترل — را در یک نمودار ترکیب می‌کنید، آنها را با وابستگی‌ها متصل می‌کنید و کل ارکستراسیون را روی موتور با پیشرفت زنده هر مرحله، بودجه‌ها و دروازه‌های تأیید انسانی اجرا می‌کنید. گردش کارها به عنوان یک تعریف قابل حمل 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 تست‌ها یا دستورات را در sandbox اجرا کنید؛ یک UI در حال اجرا را با اتوماسیون مرورگر تأیید کنید.
orchestrateمسیریابی پویا: یک عامل ارکستراتور درخواست را می‌خواند و آن را به بهترین عامل(های) پایین‌دستی از طریق رویدادها ارسال می‌کند.
external.agentیک عامل شخص ثالث ثبت‌شده را از طریق HTTP (A2A) فراخوانی کنید، گویی که یک مرحله بومی است.
evalیک خروجی بالادستی را در برابر بررسی‌ها (شامل / regex / طول / LLM-judge) امتیاز دهید؛ در صورت کمتر از آستانه، شکست بخورد.
db.provisionیک لایه داده متعلق به خود را تولید کنید: docker-compose برای پایگاه داده، مهاجرت‌های SQL نسخه‌بندی شده، داده‌های اولیه، قالب .env، و یک Mermaid ERD؛ داربست احراز هویت اختیاری؛ می‌تواند مهاجرت‌ها را بلافاصله روی SQLite اعمال کند.
ci.generateیک خط لوله CI/CD آماده commit (GitHub Actions, GitLab CI, یا Azure Pipelines) با lint → test → scan → build → deploy و ارتقاء محیط تولید کنید.
deploy.packageدارایی‌های استقرار تولید را تولید کنید: Dockerfile چند مرحله‌ای، docker-compose، Kubernetes manifests، یا یک Helm chart — فایل‌هایی که شما مالک آنها هستید و commit می‌کنید.
test.generateمجموعه‌های واحد / API / E2E را برای برنامه ساخته شده به علاوه یک ماتریس ردیابی الزامات به تست تولید کنید.
test.verifyیک مجموعه تست (pytest, vitest, jest, Playwright) را اجرا کنید و اجرا را بر اساس نرخ قبولی آن دروازه‌بندی کنید.
security.auditوابستگی‌ها را برای آسیب‌پذیری‌های شناخته شده و درخت را برای اسرار سخت‌کد شده اسکن کنید؛ رویدادهای هشدار را منتشر کرده و یک گزارش یافته‌ها را می‌نویسد.
previewبرنامه تولید شده را به صورت محلی شروع کنید و URL زنده آن را در پنل اجرا (لینک + فریم درون‌خطی) از طریق یک رویداد preview.ready نمایش دهید.
design.importیک تصویر طراحی UI (اسکرین‌شات، ماکت، خروجی Figma) را به یک مشخصات پیاده‌سازی ساختاریافته برای مراحل پایین‌دستی تبدیل کنید.

17.3 عامل‌های رویدادمحور (شبکه عامل)

هر مرحله — صرف نظر از نوع — می‌تواند رویدادهای تایپ شده را در گذرگاه رویداد فضای کاری منتشر و مشترک شود، بنابراین عامل‌ها مانند سرویس‌ها در یک ساختار پیام به جای فقط از طریق DAG هماهنگ می‌شوند:

17.3.1 صف‌بندی رویداد برای عامل‌ها

عامل‌هایی که به رویدادها واکنش نشان می‌دهند می‌توانند یک صف نام‌گذاری شده پایدار را اعلام کنند تا رویدادهای مطابق هرگز در حالی که عامل مشغول است یا قبل از اینکه یک اجرا در حال گوش دادن باشد، از دست نروند. در یک اشتراک trigger، 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 آن را به یک موتکس تبدیل می‌کند: فقط یک وظیفه در هر زمان (در تمام اجراهای موازی در فضای کاری) مرحله حیاتی را اجرا می‌کند؛ هر وظیفه دیگر منتظر می‌ماند تا نگهدارنده به پایان برسد.

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: مرحله تنظیم کنید: هر اشتراک trigger باید برآورده شود قبل از اینکه مرحله اجرا شود. این را با 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 بپذیرید. این ویژگی در هر دو موتور و ویرایشگر وب اختیاری است.

فعال کردن آن

نحوه عملکرد آن

19 میزان استفاده، اعتبار و صورت‌حساب

برای مدیریت طرح و میزان استفاده خود، صورت‌حساب را از نوار کناری باز کنید. میزان استفاده از هوش مصنوعی بر اساس اعتبار دلاری آمریکا و بر اساس توکن‌های مصرف شده توسط مدل‌های زیربنایی محاسبه می‌شود.

طرحقیمت ماهانهمیزان استفاده ماهانه از هوش مصنوعی (شامل)
Basic$20$10
Pro$75$30
Ultimate$200$150
💡 در مصرف صرفه‌جویی کنید: از انتخاب مدل خودکار استفاده کنید، کلید خود را بیاورید (BYOK)، یا مدل‌های محلی را اجرا کنید تا مصرف متر شده را کاهش دهید یا از آن اجتناب کنید.

20 دریافت کلید API Gateway خود

یک کلید API gateway (یک توکن دسترسی شخصی) به شما امکان می‌دهد از API عمومی DeepCerebra و CLI به صورت برنامه‌نویسی استفاده کنید.

  1. وارد شوید و کلیدهای API را از نوار کناری باز کنید.
  2. به کلیدهای API DeepCerebra بروید.
  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: "شما روی شاخه پیش‌فرض هستید"

قبل از استفاده از یکپارچه‌سازی برای باز کردن یک درخواست pull، یک شاخه کاری را باز یا ایجاد کنید.

هنوز مشکل دارید؟ با support@deepcerebra.ai تماس بگیرید.

23 DeepCerebra Discovery — از داده‌ها و اسناد خود بپرسید

Discovery یک چت‌بات تحقیقاتی برای پایگاه‌های داده و اسناد شماست. به جای پاسخ دادن با یک پرس‌وجوی واحد، مانند یک تحلیلگر عمل می‌کند: فرضیه‌ها را شکل می‌دهد، مجموعه‌ای از بررسی‌های محافظت‌شده (SQL، گراف، جستجوی اسناد، بررسی‌های شماتیک، تأیید وب) را اجرا می‌کند، توضیحاتی را که شواهد رد می‌کنند حذف می‌کند، و یک پاسخ مستدل — همراه با نمودارها و یک رسید هزینه شفاف — را ترکیب می‌کند. آن را از نماد قطب‌نما در نوار فعالیت (/app/discovery) باز کنید.

23.1 فضاها — دامنه منتخب شما

یک فضا هر آنچه را که یک خط پرسش نیاز دارد، شامل می‌شود: اتصالات پایگاه داده، مجموعه‌های اسناد، دستورالعمل‌ها برای تحلیلگر، و بودجه‌ها. یکی را با + فضای جدید ایجاد کنید، سپس از پنل تنظیمات در سمت راست برای موارد زیر استفاده کنید:

23.2 پرسیدن یک سؤال

سؤالی را به همان شیوه‌ای که از یک همکار می‌پرسید، تایپ کنید — برای مثال «چرا حجم اسکن MRI در ماه مارس کاهش یافت؟». صفحه تحقیقات کل فرآیند را به صورت زنده پخش می‌کند:

سؤالات پیگیری همان رشته را ادامه می‌دهند، بنابراین تحلیلگر زمینه خود را حفظ می‌کند.

23.3 نمودارها، گزارش‌ها و خروجی‌ها

نمودارها به صورت درون‌خطی در صفحه تحقیقات رندر می‌شوند. از خروجی گرفتن برای دانلود کل پرسش — پاسخ، فرضیه‌ها، شواهد و نمودارها — به عنوان یک گزارش HTML مستقل یا یک PDF با کیفیت چاپ، که با سیستم طراحی نئون استایل‌دهی شده است، استفاده کنید.

23.4 بودجه‌ها و کنترل هزینه

هر فضا بودجه‌های هر پرسش را شامل می‌شود: حداکثر تعداد بررسی‌ها، دورهای تحقیق، ثانیه، و USD. موتور به طور تمیز در سقف متوقف می‌شود و آنچه را که تاکنون یافته است گزارش می‌دهد. هزینه هر بررسی در رسید به تفکیک ذکر شده است، بنابراین شما همیشه می‌دانید که هزینه کجا صرف شده است.

23.5 اتوماسیون: API، SDK، Workflow Studio و MCP