Μετάβαση στο περιεχόμενο

Για χρήστες Cline

Το Cline σχεδιάζει πριν δράσει. Δώστε στο σχέδιο έναν χάρτη.

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

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

Το .clinerules για το πώς δουλεύετε. Το Maguyva για το τι λέει ο κώδικας τώρα.

Τι πρέπει να ξέρετε για το Cline

Τέσσερα στοιχεία ειδικά για το Cline.

// αρχείο ρυθμίσεων

cline_mcp_settings.json

Ανοίξτε το από το εικονίδιο MCP Servers στο πάνελ του Cline: καρτέλα Configure, μετά Configure MCP Servers. Οι διακομιστές μπαίνουν κάτω από το mcpServers.

// μεταφορά

Απομακρυσμένα, μέσω URL

Το Cline συνδέεται στο endpoint του Maguyva μέσω Streamable HTTP. Καμία τοπική διεργασία, κανένα Node.js.

// κλειδί

Κεφαλίδα ως έχει

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

// τύπος

streamableHttp, όχι SSE

Κρατήστε το "type": "streamableHttp" στην καταχώριση: χωρίς τύπο, το Cline υποθέτει το παλιό SSE. Καταγράψτε στο autoApprove τα εργαλεία που εμπιστεύεστε, ώστε να παραλείπεται η ερώτηση έγκρισής τους.

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

# .clinerules/testing.md
- Τρέξε τη σουίτα δοκιμών πριν σημειώσεις μια εργασία ως ολοκληρωμένη.
- Ρώτα πριν προσθέσεις εξάρτηση.

Οι κανόνες χώρου εργασίας είναι αρχεία Markdown στο .clinerules/ ή στο .cline/rules/· το Cline διαβάζει επίσης τα AGENTS.md, .cursorrules και .windsurfrules. Οι κανόνες είναι το σωστό μέρος για:

  • Εντολές που πρέπει να τρέχει το Cline.
  • Δικλίδες περιορισμένες σε μια διαδρομή με glob στο frontmatter.
  • Συμβάσεις της ομάδας που βαρεθήκατε να επαναλαμβάνετε.

Οι κανόνες λένε στο Cline πώς να συμπεριφέρεται. Δεν του λένε ποιες υπηρεσίες διαβάζουν τον πίνακα που ετοιμάζεται να μεταφέρει.

Πού δεν φτάνουν οι κανόνες και η ανάγνωση αρχείων

Τρία κενά που το Cline καλύπτει διαβάζοντας περισσότερα αρχεία, ένα αίτημα τη φορά.

// ένα σχέδιο από μια λίστα

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

// κάθε ανάγνωση είναι ένα πήγαινε-έλα

Κάθε αρχείο που ανοίγει το Cline για να προσανατολιστεί κοστίζει tokens και ένα αίτημα στο μοντέλο. Ο προσανατολισμός σε άγνωστο πακέτο μπορεί να φάει μεγάλο μέρος του παραθύρου πλαισίου πριν από την πρώτη αλλαγή.

// η κειμενική αναζήτηση βρίσκει συμβολοσειρές, όχι καλούντες

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

Το Maguyva ως διακομιστής MCP στο Cline

Μία καταχώριση στα mcpServers δίνει στο Cline:

  • 11 εργαλεία για το ευρετηριασμένο αποθετήριό σας σημασιολογική, δομική (AST), γράφου και κειμενική αναζήτηση, συν αναζήτηση συμβόλων, εξαρτημένα στοιχεία και ανάκτηση αρχείων.
  • Απαντήσεις με διαδρομές αρχείων και αριθμούς γραμμών σε πάνω από 285 γλώσσες, ώστε ένα σχέδιο να παραπέμπει σε πραγματικά αρχεία.
  • Εργαλεία που μόνο διαβάζουν Τα εργαλεία του Maguyva κάνουν ερωτήματα στο ευρετήριο. Κανένα δεν επεξεργάζεται τα αρχεία σας.

Οι κανόνες του Cline του λένε πώς να δουλεύει.

Το Maguyva δίνει στο Cline έναν χάρτη για να σχεδιάζει.

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

Σχεδιάστε πάνω στον χάρτη, μετά δράστε.

// workflow 01

Σχεδιάστε μια αλλαγή από πραγματικά σημεία κλήσης

cline plan> μετάφερε την ανανέωση συνεδρίας στο πακέτο auth

dependency_search("refreshSession", dependents)
  src/api/middleware.ts:58
  src/jobs/renew.ts:12
  src/web/hooks/useSession.ts:30

→ Το σχέδιο απαριθμεί τρία σημεία κλήσης πριν ξεκινήσει η λειτουργία Act.
[exit 0]

Το σχέδιο κατονομάζει κάθε αρχείο που θα αγγίξει, οπότε εγκρίνετε μια λίστα, όχι ένα προαίσθημα.

// workflow 02

Βρείτε την πραγματική υλοποίηση, όχι το fixture της δοκιμής

cline> πώς υπολογίζουμε την αναλογική χρέωση;

semantic_search("proration calculation")
  src/billing/proration.ts:22   prorate()   ← υλοποίηση
  test/billing/proration.spec.ts:7   ← fixture

→ Το Cline διαβάζει ένα αρχείο αντί για έξι.
[exit 0]

Τα ταξινομημένα αποτελέσματα βάζουν την υλοποίηση πάνω από το ομώνυμο fixture.

Ρύθμιση στο Cline

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

  1. // step 01

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

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

  2. // step 02

    Προσθέστε το Maguyva στις ρυθμίσεις MCP του Cline

    cline_mcp_settings.json

    {
      "mcpServers": {
        "maguyva": {
          "type": "streamableHttp",
          "url": "https://maguyva.tools/mcp",
          "headers": {
            "Authorization": "Bearer mgv_xxxx"
          },
          "disabled": false,
          "autoApprove": []
        }
      }
    }
  3. // step 03

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

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