Για χρήστες Zed

Το Zed είναι γρήγορο. Ο πράκτορας πρέπει ακόμα να βρει τον κώδικα.

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

Ξεκινήστε δωρεάν Διαβάστε τη ρύθμιση για το Zed

Επίπεδο Free: 3 αποθετήρια, Έως 50K ευρετηριασμένες γραμμές αποθετηρίου, χωρίς πιστωτική κάρτα.

Μία καταχώριση στα 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.

Οι οδηγίες έργου είναι μια συμφωνία εργασίας. Χρησιμοποιήστε τις.

# .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 δίνει στον πράκτορα έναν χάρτη του κώδικα.

Δύο ροές εργασίας

Ρωτήστε πρώτα τον χάρτη, μετά επεξεργαστείτε.

// workflow 01

Βρείτε την υλοποίηση πριν ο πράκτορας ανοίξει καρτέλα

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. Η απάντηση επιστρέφει ως διαδρομή και γραμμή που ο πράκτορας μπορεί να ανοίξει απευθείας.

// workflow 02

Ελέγξτε τα εξαρτημένα πριν αλλάξει μια υπογραφή

zed agent> πρόσθεσε όρισμα timeout στο fetchInvoice

dependency_search("fetchInvoice", dependents)
  7 καλούντες σε 4 πακέτα

→ Ο πράκτορας ενημερώνει και τα επτά σημεία κλήσης με μία κίνηση.
[exit 0]

Η ακτίνα επίδρασης φαίνεται πριν από την πρώτη αλλαγή, όχι αφού αποτύχει το build.

Ρύθμιση στο Zed

Τρία βήματα. Επίπεδο Free: 3 αποθετήρια, Έως 50K ευρετηριασμένες γραμμές αποθετηρίου, χωρίς πιστωτική κάρτα.

// step 01

Ευρετηριάστε ένα αποθετήριο στο maguyva.ai

Επιλέξτε ένα που ήδη γνωρίζετε, ώστε να μπορείτε να αξιολογήσετε τις απαντήσεις.

// step 02

Προσθέστε το Maguyva στα context_servers των ρυθμίσεων του Zed

~/.config/zed/settings.json

{
  "context_servers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

// step 03

Αντικαταστήστε το σύμβολο κράτησης θέσης και κάντε μία ερώτηση

Αντικαταστήστε το mgv_xxxx με το κλειδί API σας και αποθηκεύστε. Κάντε στον πράκτορα μία ερώτηση της οποίας την απάντηση ήδη γνωρίζετε και ανοίξτε το αρχείο που αναφέρει.

Οι εγγραφές αυτοεξυπηρέτησης είναι ανοιχτές.

Ευρετηριάστε ένα αποθετήριο που ήδη γνωρίζετε.

Συνδέστε το Zed μέσω MCP και κάντε μία ερώτηση που μπορείτε να ελέγξετε.

Ευρετηριάστε το πρώτο σας αποθετήριο Δείτε την τεκμηρίωση συμβατότητας

πλάνο Free: 3 αποθετήρια, Έως 50K ευρετηριασμένες γραμμές αποθετηρίου, χωρίς πιστωτική κάρτα.