Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Το αρχείο config.toml

Μάθημα 6 / 16 Ενημερώθηκε 2 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Πού βρίσκεται το config.toml;
  2. Δομή αρχείου
  3. Επιλογή του μοντέλου
  4. Προσαρμογή της προτροπής συστήματος
  5. Διαμόρφωση πρακτόρων
  6. Έλεγχος εργαλείων
  7. Θέμα και τοποθεσία διαμόρφωσης
  8. Διαμόρφωση ειδική για το έργο
  9. Βασικά σημεία

Μάθημα ενημερώθηκε στις 2 Νοεμβρίου 2026 βάσει της τεκμηρίωσης του Vibe Code: ενσωματωμένο μοντέλο Mistral Medium 3.5 (συν Devstral 2), enable_update_checks (το κλειδί enable_auto_update δεν έχει πλέον αποτέλεσμα), εργαλείο edit (πρώην search_replace), και η αφαιρεθείσα ενότητα [safety] αντικαταστάθηκε από το default_agent. Πηγές: Configuration · Configuration reference.

Πού βρίσκεται το config.toml;

Το Vibe αναζητά το αρχείο διαμόρφωσής του σε δύο τοποθεσίες, με την εξής σειρά:

  1. Διαμόρφωση έργου: ./.vibe/config.toml (στον τρέχοντα κατάλογο)
  2. Καθολική διαμόρφωση: ~/.vibe/config.toml (στον προσωπικό σας κατάλογο)

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

Δομή αρχείου

Το αρχείο config.toml χρησιμοποιεί τη μορφή TOML, μια μορφή διαμόρφωσης ευανάγνωστη και χωρίς ασάφειες. Ακολουθεί ένα πλήρες σχολιασμένο παράδειγμα που περιέχει όλα όσα θα χρειαστείτε:

# ~/.vibe/config.toml

# Ενεργό μοντέλο: το ενσωματωμένο μοντέλο, ή ένα ψευδώνυμο για μια προεπιλογή [[models]]
active_model = "mistral-medium-3.5"

# Προεπιλεγμένος πράκτορας (accept-edits αν λείπει το κλειδί)
default_agent = "ask"

# Προσαρμοσμένη προτροπή συστήματος (~/.vibe/prompts/my_custom_prompt.md)
system_prompt_id = "my_custom_prompt"

# Θέμα: ακολουθεί αυτόματα το τερματικό· χρησιμοποιήστε /theme για επιλογή
theme = "auto"

# Καθημερινός έλεγχος για νέες εκδόσεις
enable_update_checks = true

Επιλογή του μοντέλου

Η παράμετρος active_model καθορίζει ποιο μοντέλο χρησιμοποιεί το Vibe για τη δημιουργία. Αναμένει ένα ψευδώνυμο: είτε το ενσωματωμένο μοντέλο, Mistral Medium 3.5, είτε ένα ψευδώνυμο για μια προεπιλογή [[models]] που έχετε δηλώσει (καλύπτεται στο επόμενο μάθημα).

active_model = "mistral-medium-3.5"

Δεν χρειάζεται να επεξεργαστείτε το αρχείο για να αλλάξετε μοντέλα: η εντολή /model εναλλάσσει τα μοντέλα κατά τη διάρκεια της συνεδρίας και εμφανίζει τη λίστα με τις διαθέσιμες επιλογές. Χρησιμοποιήστε το αρχείο για να ορίσετε την προεπιλογή σας και την εντολή για δοκιμές μίας χρήσης.

Προσαρμογή της προτροπής συστήματος

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

Οι προτροπές είναι αρχεία Markdown αποθηκευμένα στο ~/.vibe/prompts/. Δημιουργήστε τις δικές σας· ορίστε ένα παράδειγμα για μια ομάδα που εργάζεται με Python και FastAPI:

mkdir -p ~/.vibe/prompts
cat > ~/.vibe/prompts/mon_prompt.md << 'EOF'
Tu es un assistant de développement spécialisé en Python et FastAPI.
Tu écris du code propre, typé, avec des docstrings.
Tu privilégies les approches fonctionnelles quand c'est possible.
Tu réponds toujours en français.
EOF

Στη συνέχεια, αναφερθείτε σε αυτό στο config.toml χρησιμοποιώντας το όνομα αρχείου χωρίς την επέκτασή του:

system_prompt_id = "mon_prompt"

Διαμόρφωση πρακτόρων

Οι πράκτορες πάνε πέρα από τις απλές προτροπές: είναι πλήρη προφίλ διαμόρφωσης όπου κάθε πράκτορας έχει το δικό του μοντέλο, προτροπή συστήματος και δικαιώματα εργαλείων. Τους δημιουργείτε στο ~/.vibe/agents/. Το πιο ξεκάθαρο παράδειγμα είναι ένας πράκτορας αναθεώρησης κώδικα:

# ~/.vibe/agents/code_review.toml

system_prompt_id = "code_reviewer"
disabled_tools = ["write_file", "edit", "bash"]

[tools.bash]
permission = "never"

Εκκινήστε τον κατόπιν ζήτησης:

vibe --agent code_review

Αυτός ο πράκτορας μπορεί μόνο να διαβάζει: δεν μπορεί να γράψει αρχεία ή να εκτελέσει εντολές. Μπορείτε επομένως να τον αφήσετε να σαρώσει έναν κλάδο συναδέλφου χωρίς να φοβάστε τυχαίες τροποποιήσεις, καθιστώντας τον τον ιδανικό τρόπο για ασφαλείς αναθεωρήσεις κώδικα.

Έλεγχος εργαλείων

Αυτό το φιλτράρισμα εργαλείων ισχύει επίσης για την κύρια διαμόρφωση. Διατίθενται δύο λίστες: μία για να επιτρέπονται μόνο συγκεκριμένα εργαλεία και μία άλλη για να απαγορεύονται:

# Ενεργοποίηση μόνο συγκεκριμένων εργαλείων
enabled_tools = ["read_file", "grep", "edit"]   # edit: πρώην search_replace

# Απενεργοποίηση συγκεκριμένων εργαλείων
disabled_tools = ["bash", "write_file"]

Η πληκτρολόγηση κάθε ονόματος με το χέρι γίνεται κουραστική όταν ένας διακομιστής MCP εκθέτει είκοσι εργαλεία. Τα εργαλεία MCP ονομάζονται {server}_{tool} και τα φίλτρα δέχονται μπαλαντέρ και κανονικές εκφράσεις (πρόθεμα re:). Αυτό σας επιτρέπει να σκέφτεστε με βάση την οικογένεια και όχι το μεμονωμένο εργαλείο:

# Ενεργοποίηση όλων των εργαλείων από έναν διακομιστή MCP με όνομα serena (πρότυπο glob)
enabled_tools = ["serena_*"]
# ... ή το ίδιο πράγμα με μια κανονική έκφραση:
# enabled_tools = ["re:^serena_.*$"]

# Απενεργοποίηση όλων των εργαλείων από τον διακομιστή MCP fetch_server
disabled_tools = ["fetch_server_*"]

Θέμα και τοποθεσία διαμόρφωσης

Ορίστε το θέμα στο ίδιο αρχείο, ή επιτόπου μέσω της εντολής /theme:

theme = "auto"

Τα διαθέσιμα θέματα ποικίλλουν ανά έκδοση· χρησιμοποιήστε το /theme σε διαδραστική λειτουργία για να δείτε την πλήρη λίστα και να προεπισκοπήσετε κάθε επιλογή πριν κλειδώσετε την επιλογή σας.

Τέλος, το Vibe αποθηκεύει τη διαμόρφωσή του στο ~/.vibe/ εξ ορισμού, αλλά μπορείτε να αλλάξετε αυτή την τοποθεσία μέσω μιας μεταβλητής περιβάλλοντος:

export VIBE_HOME="/chemin/vers/mon/dossier/vibe"

Αυτό είναι χρήσιμο αν ο προσωπικός σας κατάλογος βρίσκεται σε μια αργή μονάδα δικτύου όπου κάθε ανάγνωση διαμόρφωσης θα προκαλούσε καθυστέρηση, ή αν μοιράζεστε μια διαμόρφωση σε πολλαπλές μηχανές μέσω μιας υπηρεσίας συγχρονισμού.

Διαμόρφωση ειδική για το έργο

Επιστρέφοντας στο αρχικό σενάριο: για ρυθμίσεις ειδικές για το έργο, δημιουργήστε το .vibe/config.toml στη ρίζα του έργου:

mkdir -p .vibe
cat > .vibe/config.toml << 'EOF'
system_prompt_id = "python_expert"

[tools.bash]
permission = "ask"
allowlist = ["git status", "git diff", "pytest"]
EOF

Το Vibe φορτώνει αυτό το αρχείο μόνο αν δηλώσατε τον φάκελο ως έμπιστο κατά την πρώτη εκκίνηση. Ως προφύλαξη πριν την υποβολή (commit): προσθέστε το .vibe/ στο .gitignore σας αν το αρχείο περιέχει ευαίσθητες πληροφορίες, όπως ονόματα μεταβλητών ή εσωτερικά URL που δεν θέλετε να ωθηθούν στο αποθετήριο.

Βασικά σημεία

  • Το config.toml υπάρχει σε καθολική (~/.vibe/) και έργου (./.vibe/) εκδοχή
  • Η διαμόρφωση έργου έχει προτεραιότητα έναντι της καθολικής διαμόρφωσης
  • Οι πράκτορες είναι πλήρη προφίλ με μοντέλο, προτροπή και δικαιώματα· ορίστε τον προεπιλεγμένο πράκτορα με το default_agent
  • Τα εργαλεία μπορούν να φιλτραριστούν χρησιμοποιώντας μπαλαντέρ ή regex
  • Η μεταβλητή VIBE_HOME σας επιτρέπει να αλλάξετε τον κατάλογο διαμόρφωσης