# Το Zed είναι γρήγορο. Ο πράκτορας πρέπει ακόμα να βρει τον κώδικα. Canonical source: https://maguyva.ai/el/for-zed License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license). Ο πράκτορας του Zed δουλεύει με τα αρχεία που ανοίγετε και τις οδηγίες που του δίνετε. Το Maguyva ευρετηριάζει όλο το αποθετήριο και το επιστρέφει μέσω MCP, ώστε ο πράκτορας να ρωτά πού βρίσκεται ένα σύμβολο αντί να μαντεύει. > Μία καταχώριση στα context_servers: ένα URL και μια κεφαλίδα Authorization. ## Τι πρέπει να ξέρετε για το Zed Τέσσερα στοιχεία ειδικά για το Zed. Κανένα δεν είναι δύσκολο. ### settings.json Οι απομακρυσμένοι διακομιστές μπαίνουν κάτω από το `context_servers`. Ανοίξτε το αρχείο με `zed: open settings file` ή προσθέστε διακομιστή από Settings → AI → MCP Servers. ### Απομακρυσμένα, μέσω URL Το Zed συνδέεται απευθείας μέσω HTTP στο απομακρυσμένο endpoint του Maguyva. Χωρίς τοπική διεργασία, χωρίς Node.js. ### Κεφαλίδα ως έχει Αυτός ο οδηγός γράφει το κλειδί απευθείας στην κεφαλίδα `Authorization`, επειδή η ανάπτυξη μεταβλητών περιβάλλοντος στις κεφαλίδες του Zed δεν έχει επαληθευτεί εδώ. Κρατήστε το στις ρυθμίσεις χρήστη, όχι σε αρχείο που κάνετε commit. ### Δικαιώματα εργαλείων Από προεπιλογή, το Zed ρωτά πριν από κάθε κλήση εργαλείου. Επιτρέψτε τα εργαλεία του Maguyva ένα-ένα στο `agent.tool_permissions.tools`, με κλειδιά όπως `mcp:maguyva:find_symbol`. ## Οι οδηγίες έργου είναι μια συμφωνία εργασίας. Χρησιμοποιήστε τις. ```text # .rules - Τρέξε την εντολή δοκιμών του αποθετηρίου πριν δηλώσεις μια αλλαγή ολοκληρωμένη. - Επεξεργάσου μόνο το πακέτο που σου ζητήθηκε να αλλάξεις. ``` Το Zed φορτώνει ένα μόνο αρχείο οδηγιών έργου: την πρώτη αντιστοιχία από μια σταθερή λίστα που ξεκινά με `.rules` και περιλαμβάνει τα `AGENTS.md` και `CLAUDE.md`. Οι προσωπικές οδηγίες μπαίνουν στο `~/.config/zed/AGENTS.md`. Χρησιμοποιήστε τις για: - Εντολές build, δοκιμών και lint. - Συμβάσεις που ο πράκτορας κάνει συνεχώς λάθος. - Καταλόγους που ο πράκτορας δεν πρέπει να αγγίξει. Ένα αρχείο οδηγιών λέει στον πράκτορα πώς να δουλέψει. Δεν μπορεί να του πει ποια από τέσσερις χιλιάδες αρχεία καλούν τη συνάρτηση που ετοιμάζεται να αλλάξει. ## Πού δεν φτάνει το ανοιχτό αρχείο Τρία πράγματα που ο πράκτορας του Zed δεν μπορεί να μάθει από τα αρχεία που έχει μπροστά του. ### // το ανοιχτό αρχείο δεν είναι το αποθετήριο Ο πράκτορας βλέπει ό,τι ανοίξατε και ό,τι βρίσκει με grep. Ένας βοηθός με το ίδιο όνομα σε άλλο πακέτο μοιάζει πανομοιότυπος, μέχρι να βγει στην παραγωγή ο λάθος. ### // οι καλούντες δεν είναι στην οθόνη Το “Τι θα σπάσει αν αλλάξω αυτή την υπογραφή;” είναι ερώτηση γράφου. Χωρίς ευρετήριο, ο πράκτορας διαβάζει αρχεία ένα-ένα μέχρι να του τελειώσουν οι γύροι ή το πλαίσιο. ### // το πλαίσιο έχει προϋπολογισμό Κάθε αρχείο που ανοίγει ο πράκτορας για να προσανατολιστεί καταναλώνει tokens που δεν θα του μείνουν για την ίδια την αλλαγή. Μία ταξινομημένη απάντηση με file:line κοστίζει λιγότερο από δέκα διερευνητικές αναγνώσεις. ## Το Maguyva ως διακομιστής πλαισίου του Zed Μία καταχώριση στα context_servers δίνει στον πράκτορα του Zed: - **11 εργαλεία για το ευρετηριασμένο αποθετήριό σας**: σημασιολογική, δομική (AST), γράφου και κειμενική αναζήτηση, συν αναζήτηση συμβόλων, εξαρτημένα στοιχεία και ανάκτηση αρχείων. - **Απαντήσεις με διαδρομές αρχείων και αριθμούς γραμμών**: σε πάνω από 285 γλώσσες, ώστε ο πράκτορας να ανοίγει αμέσως το σωστό αρχείο. - **Μια λίστα εργαλείων που μένει ενημερωμένη**: Το Zed φορτώνει ξανά τα εργαλεία ενός διακομιστή όταν εκείνος ανακοινώνει αλλαγή, χωρίς επανεκκίνηση. > Το Zed δίνει στον πράκτορα *έναν γρήγορο επεξεργαστή κειμένου*. > Το Maguyva δίνει στον πράκτορα *έναν χάρτη του κώδικα*. ## Δύο ροές εργασίας Ρωτήστε πρώτα τον χάρτη, μετά επεξεργαστείτε. ### 01. Βρείτε την υλοποίηση πριν ο πράκτορας ανοίξει καρτέλα ```text zed agent> πού είναι η πολιτική επαναλήψεων για τα εξερχόμενα webhooks; find_symbol("retryPolicy") src/webhooks/dispatch.ts:41 retryPolicy() ← υλοποίηση src/webhooks/__mocks__/dispatch.ts:9 ← mock → Ο πράκτορας ανοίγει το dispatch.ts:41, όχι το mock. [exit 0] ``` Μία ταξινομημένη αναζήτηση αντικαθιστά έναν γύρο grep. Η απάντηση επιστρέφει ως διαδρομή και γραμμή που ο πράκτορας μπορεί να ανοίξει απευθείας. ### 02. Ελέγξτε τα εξαρτημένα πριν αλλάξει μια υπογραφή ```text zed agent> πρόσθεσε όρισμα timeout στο fetchInvoice dependency_search("fetchInvoice", dependents) 7 καλούντες σε 4 πακέτα → Ο πράκτορας ενημερώνει και τα επτά σημεία κλήσης με μία κίνηση. [exit 0] ``` Η ακτίνα επίδρασης φαίνεται πριν από την πρώτη αλλαγή, όχι αφού αποτύχει το build. ## Ρύθμιση στο Zed Τρία βήματα. Επίπεδο Free: 3 αποθετήρια, Έως 50K ευρετηριασμένες γραμμές αποθετηρίου, χωρίς πιστωτική κάρτα. ### 01. Ευρετηριάστε ένα αποθετήριο στο maguyva.ai Επιλέξτε ένα που ήδη γνωρίζετε, ώστε να μπορείτε να αξιολογήσετε τις απαντήσεις. ### 02. Προσθέστε το Maguyva στα context_servers των ρυθμίσεων του Zed `~/.config/zed/settings.json` ```json { "context_servers": { "maguyva": { "url": "https://maguyva.tools/mcp", "headers": { "Authorization": "Bearer mgv_xxxx" } } } } ``` ### 03. Αντικαταστήστε το σύμβολο κράτησης θέσης και κάντε μία ερώτηση Αντικαταστήστε το `mgv_xxxx` με το κλειδί API σας και αποθηκεύστε. Κάντε στον πράκτορα μία ερώτηση της οποίας την απάντηση ήδη γνωρίζετε και ανοίξτε το αρχείο που αναφέρει. Η [τεκμηρίωση MCP](https://zed.dev/docs/ai/mcp) του Zed καλύπτει διακομιστές πλαισίου, προφίλ πράκτορα και δικαιώματα εργαλείων. ## Ευρετηριάστε ένα αποθετήριο που ήδη γνωρίζετε. Συνδέστε το Zed μέσω MCP και κάντε μία ερώτηση που μπορείτε να ελέγξετε.