Οδηγός Χρήσης
Ένας πλήρης, πρακτικός οδηγός για την ανάπτυξη λογισμικού με το DeepCerebra Coder — web, desktop και CLI

📖 Πίνακας Περιεχομένων

  1. Εισαγωγή & Εκδόσεις
  2. Έναρξη & Λογαριασμός
  3. Ο Χώρος Εργασίας με μια Ματιά
  4. Άνοιγμα Έργου
  5. Εργασία με Αρχεία
  6. Συνομιλία με τον Πράκτορα
  7. Οι Τέσσερις Λειτουργίες Συνομιλίας
  8. Αναθεώρηση & Εφαρμογή Αλλαγών
  9. Ενσωματωμένο Τερματικό
  10. Λειτουργία Σχεδιασμού & Εκτέλεση
  11. Επιλογή Μοντέλων & Αυτόματη Λειτουργία
  12. Φέρτε το Δικό σας Κλειδί (BYOK)
  13. Τοπικός Υπολογιστής: Μοντέλα GPU & Κονσόλα (DCC Bridge)
  14. Ροή Εργασίας Συνεργασίας Git
  15. Διακομιστές MCP
  16. Προσαρμογή του Πράκτορα: Κανόνες, Δεξιότητες, Hooks, Υποπράκτορες & Πρόσθετα
  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. Συμπληρώστε το προαιρετικό σας όνομα εμφάνισης, email, χώρα, και ημερομηνία γέννησης (πρέπει να είστε τουλάχιστον 18 ετών).
  3. Επιλέξτε τη γλώσσα διεπαφής και έναν κωδικό πρόσβασης τουλάχιστον 12 χαρακτήρων.
  4. Διαβάστε την ειδοποίηση συμφωνίας και επιβεβαιώστε. Η δημιουργία λογαριασμού σημαίνει ότι συμφωνείτε με τους Όρους Παροχής Υπηρεσιών, Δήλωση Απορρήτου, Περιγραφή Υπηρεσιών, και Παγκόσμια DPA.
  5. Κάντε κλικ στο Δημιουργία λογαριασμού, στη συνέχεια επαληθεύστε το email σας εάν σας ζητηθεί, και συνδεθείτε.
💡 Συμβουλή: Μπορείτε να επιλέξετε ένα πρόγραμμα κατά την εγγραφή επισκεπτόμενοι το /register?plan=basicpro / ultimate), ή ξεκινήστε τώρα και επιλέξτε ένα πρόγραμμα αργότερα στην Χρέωση.

Επαναφορά κωδικού πρόσβασης

  1. Στη σελίδα σύνδεσης, κάντε κλικ στο Ξεχάσατε τον κωδικό πρόσβασης;
  2. Εισαγάγετε το email σας και ανοίξτε τον σύνδεσμο επαναφοράς που στάλθηκε στα εισερχόμενά σας.
  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 πύλης).
  6. Κάντε κλικ στο Άνοιγμα αποθετηρίου.

4.3 Ανανέωση, αλλαγή και κλείσιμο

4.4 Περίοδοι συνομιλίας με εύρος φακέλου

Το ιστορικό συνομιλιών συνδέεται με το ανοιχτό έργο. Η αλλαγή φακέλων ξεκινά αυτόματα μια νέα συνεδρία και φορτώνει τις προηγούμενες συνεδρίες αυτού του φακέλου, ανοίγοντας ξανά την πιο πρόσφατη ώστε να μπορείτε να συνεχίσετε από εκεί που σταματήσατε.

4.5 Φάκελοι λειτουργίας

Οι φάκελοι που χρησιμοποιεί εσωτερικά η DeepCerebra — .deepcerebra, .sessions — εμφανίζονται στο δέντρο αλλά είναι συμπτυγμένοι από προεπιλογή ώστε να μην γεμίζουν τον κώδικά σας.

5 Εργασία με Αρχεία

6 Συνομιλία με τον Πράκτορα

Γράψτε ένα αίτημα

Περιγράψτε τι θέλετε με απλή γλώσσα — κάντε μια ερώτηση, ζητήστε μια λειτουργία ή επισημάνετε ένα σφάλμα. Να είστε συγκεκριμένοι σχετικά με αρχεία, πλαίσια και περιορισμούς για να έχετε το καλύτερο αποτέλεσμα. Επισυνάψτε σχετικά αρχεία σύροντάς τα στο πεδίο εισαγωγής.

Διαβάστε απαντήσεις, σε στυλ Cursor

Οι απαντήσεις είναι οργανωμένες όπως το Cursor: η λογική του πράκτορα διαχωρίζεται από το παραδοτέο. Κάθε μπλοκ απάντησης έχει ένα εικονίδιο αντιγραφής στην επάνω δεξιά γωνία του, ώστε να μπορείτε να αντιγράψετε μια ολοκληρωμένη αναφορά, έγγραφο ή μια εντολή που προορίζεται να εκτελέσετε.

Καθοδηγήστε ή σταματήστε μια εκτέλεση

💡 Συμβουλή (επιτραπέζια εφαρμογή): Στην επιτραπέζια εφαρμογή καλείτε τον πράκτορα στη συνομιλία με @deepcerebra, και προθέματα όπως [deep] ζητούν βαθύτερη λογική.

7 Οι Τέσσερις Λειτουργίες Συνομιλίας

Επιλέξτε μια λειτουργία από τον επιλογέα λειτουργίας δίπλα στην προτροπή. Κάθε μία ρυθμίζει πόσο πολύ σχεδιάζει ο παράγοντας και πόσο ελεύθερα επεξεργάζεται:

ΛειτουργίαΤι κάνειΧρησιμοποιήστε όταν…
AgentΣχεδιάζει και επεξεργάζεται αυτόνομα σε όλο το έργο σαςΘέλετε ο βοηθός να εφαρμόσει μια αλλαγή από την αρχή μέχρι το τέλος
AskΑπαντά σε ερωτήσεις σχετικά με τον κώδικά σας χωρίς επεξεργασίαΘέλετε να κατανοήσετε τη βάση κώδικα
PlanΣυντάσσει μια προσέγγιση πριν από οποιαδήποτε επεξεργασίαΗ εργασία είναι μεγάλη ή έχει συμβιβασμούς που πρέπει να διευθετηθούν πρώτα
EditΚάνει στοχευμένες επεξεργασίες στο τρέχον πλαίσιοΘέλετε μια μικρή, στοχευμένη αλλαγή

8 Αναθεώρηση & Εφαρμογή Αλλαγών

Όταν ο πράκτορας προτείνει αλλαγές αρχείων, εμφανίζεται ένα πάνελ Προτεινόμενες Αλλαγές πάνω από το πεδίο εισαγωγής συνομιλίας, παραθέτοντας κάθε αρχείο που επηρεάστηκε με τον αριθμό των προστιθέμενων (+) και αφαιρεθέντων (−) γραμμών.

⚠️ Πάντα να ελέγχετε: Ο κώδικας που παράγεται από την AI μπορεί να περιέχει λάθη ή μη ασφαλή μοτίβα. Ελέγξτε τη διαφορά και δοκιμάστε πριν βασιστείτε ή αναπτύξετε τον.

9 Ενσωματωμένο Τερματικό

Εναλλάξτε το τερματικό κάτω από τον επεξεργαστή για να εκτελέσετε builds, δοκιμές και σενάρια. Με την εξουσιοδότησή σας, ο πράκτορας μπορεί να εκτελέσει εντολές και να διαβάσει την έξοδό τους για να επαληθεύσει την εργασία του· οι εντολές μεγάλης διάρκειας μεταδίδουν την έξοδο ώστε να μπορείτε να παρακολουθείτε την πρόοδο. Κλείστε το τερματικό από την κεφαλίδα του όταν δεν το χρειάζεστε.

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). Για να εργαστείτε στους πραγματικούς φακέλους του έργου σας με τα προδιαμορφωμένα CLI σας, δώστε τους ρητά άδεια κατά την εκκίνηση του συνδέσμου:

# 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

Στη συνέχεια, ανοίξτε το πάνελ Τερματικό, κάντε κλικ στο αναδυόμενο παράθυρο Στόχος εκτέλεσης (εικονίδιο φορητού υπολογιστή), επιλέξτε Ο υπολογιστής μου, και επιλέξτε έναν κατάλογο εργασίας. Τόσο οι εντολές που πληκτρολογείτε όσο και οι εντολές build/test του πράκτορα εκτελούνται στη συνέχεια στον υπολογιστή σας.

⚠️ Ασφάλεια: η πρόσβαση στον κεντρικό υπολογιστή δεν υπερβαίνει ποτέ τους φακέλους που εσείς αναφέρατε στη γραμμή εντολών του συνδέσμου· τα διακριτικά κατακερματίζονται σε κατάσταση ηρεμίας και ανακαλούνται ανά πάσα στιγμή· το --no-exec καθιστά μια συσκευή μόνο για συμπεράσματα (μοντέλα GPU, χωρίς εντολές).
💡 Συμβουλή: Η επιτραπέζια εφαρμογή μπορεί να χρησιμοποιήσει τοπικά μοντέλα απευθείας χωρίς τον σύνδεσμο. Πλήρης αναφορά συνδέσμου: github.com/mohammadkhair7/DeepCerebra-connector.

14 Ροή Εργασίας Συνεργασίας Git

Με ένα έργο που υποστηρίζεται από Git ανοιχτό, εμφανίζεται μια γραμμή κλάδου στον Εξερευνητή που δείχνει τον τρέχοντα κλάδο σας και δύο ενέργειες:

Εάν το push webhook είναι ενεργοποιημένο, ο Εξερευνητής ανανεώνεται αυτόματα όταν οι συνεργάτες κάνουν push, διατηρώντας όλους συγχρονισμένους — τη βάση για συνεργατική ανάπτυξη ομάδας μέσω της DeepCerebra.

15 Διακομιστές MCP

Επεκτείνετε τον πράκτορα με εξωτερικά εργαλεία και δεδομένα μέσω του Πρωτοκόλλου Πλαισίου Μοντέλου. Διαμορφώστε διακομιστές σε ένα αρχείο .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 Προσαρμογή του Πράκτορα: Κανόνες, Δεξιότητες, Hooks, Υποπράκτορες & Πρόσθετα

Μπορείτε να διαμορφώσετε τον τρόπο σκέψης και δράσης του πράκτορα με μια ενιαία, βασισμένη σε αρχεία σύμβαση — τον κατάλογο .deepcerebra/ — που λειτουργεί πανομοιότυπα στην επιτραπέζια εφαρμογή, την εφαρμογή ιστού και το API. Στην εφαρμογή ιστού, διαχειριστείτε όλα αυτά στην προβολή Πράκτορας· στην επιτραπέζια εφαρμογή και μέσω του API είναι απλά αρχεία που δεσμεύετε με το έργο σας.

Πεδία & προτεραιότητα

Η διαμόρφωση ανακαλύπτεται από διάφορα πεδία· όταν το ίδιο στοιχείο υπάρχει σε περισσότερα από ένα, κερδίζει αυτό με την υψηλότερη προτεραιότητα:

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

Κανόνες (καθοδήγηση)

Οι κανόνες είναι επίμονες οδηγίες — πρότυπα κωδικοποίησης, συμβάσεις αρχιτεκτονικής, πλαίσιο τομέα — που εισάγονται στην προτροπή συστήματος του πράκτορα. Βρίσκονται ως αρχεία 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 για να κάνετε μια δεξιότητα μόνο χειροκίνητη.

Hooks

Τα 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 (ερώτηση στον πράκτορα). Ένα hook 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 (διασπορά).

Πρόσθετα

Ένα πρόσθετο συγκεντρώνει κανόνες, δεξιότητες, hooks, υποπράκτορες και διακομιστές MCP σε ένα εγκαταστάσιμο πακέτο κάτω από το .deepcerebra/plugins/<name>/, που περιγράφεται από ένα manifest 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 Εκτέλεση δοκιμών ή εντολών στο sandbox· επαλήθευση ενός τρέχοντος UI με αυτοματοποίηση προγράμματος περιήγησης.
orchestrateΔυναμική δρομολόγηση: ένας πράκτορας ενορχηστρωτής διαβάζει το αίτημα και το διαβιβάζει στον καλύτερο(ους) καθοδικό(ούς) πράκτορα(ες) μέσω συμβάντων.
external.agentΚαλέστε έναν εγγεγραμμένο πράκτορα τρίτου μέρους μέσω HTTP (A2A) σαν να ήταν ένα εγγενές στάδιο.
evalΒαθμολογήστε μια ανοδική έξοδο έναντι ελέγχων (περιέχει / regex / μήκος / κριτής LLM)· αποτυχία κάτω από ένα όριο.
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 chart — αρχεία που κατέχετε και δεσμεύετε.
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 Ενεργοποίηση ουράς συμβάντων για πράκτορες

Οι πράκτορες που αντιδρούν σε συμβάντα μπορούν να δηλώσουν μια ανθεκτική επώνυμη ουρά ώστε τα αντίστοιχα συμβάντα να μην χάνονται ποτέ ενώ ο πράκτορας είναι απασχολημένος ή προτού μια εκτέλεση αρχίσει να παρακολουθεί. Σε μια συνδρομή εναύσματος, ορίστε 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 Ενορχήστρωση Rendezvous (αναμονή για όλες τις συνθήκες)

Το Rendezvous περιμένει μέχρι να ικανοποιηθούν πολλαπλές συνθήκες συμβάντων πριν προχωρήσει το επόμενο βήμα — το αντίθετο του «το πρώτο συμβάν κερδίζει». Ορίστε 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 Χρήση, Πιστώσεις & Χρέωση

Ανοίξτε την Χρέωση από την πλευρική γραμμή για να διαχειριστείτε το πρόγραμμα και τη χρήση σας. Η χρήση AI μετράται σε πιστώσεις δολαρίων ΗΠΑ με βάση τα tokens που καταναλώνονται από τα υποκείμενα μοντέλα.

ΠρόγραμμαΜηνιαία τιμήΠεριλαμβανόμενη μηνιαία χρήση AI
Βασικό$20$10
Pro$75$30
Ultimate$200$150
💡 Εξοικονομήστε στη χρήση: Χρησιμοποιήστε την επιλογή μοντέλου Αυτόματο, φέρτε το δικό σας κλειδί (BYOK), ή εκτελέστε τοπικά μοντέλα για να μειώσετε ή να αποφύγετε τη μετρούμενη χρήση.

20 Λήψη του Κλειδιού API Πύλης σας

Ένα κλειδί API πύλης (ένα προσωπικό διακριτικό πρόσβασης) σας επιτρέπει να χρησιμοποιείτε το δημόσιο 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 request.

Εξακολουθείτε να αντιμετωπίζετε προβλήματα; Επικοινωνήστε με το support@deepcerebra.ai.

23 DeepCerebra Discovery — Ρωτήστε τα Δεδομένα & Έγγραφά σας

Το Discovery είναι ένα διερευνητικό chatbot για τις βάσεις δεδομένων και τα έγγραφά σας. Αντί να απαντά με ένα μόνο ερώτημα, λειτουργεί σαν αναλυτής: διαμορφώνει υποθέσεις, εκτελεί μια σειρά από ελεγχόμενες διερευνήσεις (SQL, γράφος, αναζήτηση εγγράφων, έλεγχοι σχήματος, επιβεβαίωση μέσω διαδικτύου), απορρίπτει τις εξηγήσεις που αντικρούονται από τα στοιχεία, και συνθέτει μια τεκμηριωμένη απάντηση — με γραφήματα και μια διαφανή απόδειξη κόστους. Ανοίξτε το από το εικονίδιο της πυξίδας στη γραμμή δραστηριοτήτων (/app/discovery).

23.1 Χώροι — το επιμελημένο σας πεδίο

Ένας Χώρος συγκεντρώνει όλα όσα χρειάζεται μια γραμμή διερεύνησης: συνδέσεις βάσεων δεδομένων, συλλογές εγγράφων, οδηγίες για τον αναλυτή και προϋπολογισμούς. Δημιουργήστε έναν με + Νέος χώρος, και, στη συνέχεια, χρησιμοποιήστε τον πίνακα ρύθμισης στα δεξιά για να:

23.2 Υποβολή ερώτησης

Πληκτρολογήστε μια ερώτηση όπως θα ρωτούσατε έναν συνάδελφο — για παράδειγμα "Γιατί μειώθηκε ο όγκος των μαγνητικών τομογραφιών τον Μάρτιο;". Ο πίνακας διερεύνησης μεταδίδει ζωντανά όλη τη διαδικασία:

Οι ερωτήσεις παρακολούθησης συνεχίζουν την ίδια συζήτηση, οπότε ο αναλυτής διατηρεί το πλαίσιο του.

23.3 Γραφήματα, αναφορές & εξαγωγές

Τα γραφήματα αποδίδονται ενσωματωμένα στον πίνακα διερεύνησης. Χρησιμοποιήστε την Εξαγωγή για να κατεβάσετε ολόκληρο το ερώτημα — την απάντηση, τις υποθέσεις, τα στοιχεία και τα γραφήματα — ως μια αυτόνομη αναφορά HTML ή ένα PDF ποιότητας εκτύπωσης, διαμορφωμένο με το σύστημα σχεδίασης νέον.

23.4 Προϋπολογισμοί & έλεγχος κόστους

Κάθε χώρος φέρει προϋπολογισμούς ανά ερώτημα: μέγιστο αριθμό διερευνήσεων, γύρων διερεύνησης, δευτερολέπτων και USD. Η μηχανή σταματά ομαλά στο όριο και αναφέρει τι βρήκε μέχρι στιγμής. Το κόστος κάθε διερεύνησης αναγράφεται αναλυτικά στην απόδειξη, ώστε να γνωρίζετε πάντα πού πήγαν τα έξοδα.

23.5 Αυτοματοποίηση: API, SDK, Workflow Studio & MCP