Το Maguyva υποστηρίζει την TypeScript με ανάλυση AST και εξαγωγή συμβόλων, ώστε οι πράκτορες AI να μπορούν να ανιχνεύουν διεπαφές, υλοποιήσεις, κοινόχρηστα πακέτα και κώδικα εφαρμογής με έντονη χρήση JSX σε ενιαία αποθετήρια.
Η TypeScript είναι η γλώσσα στην οποία πολλές ομάδες περιμένουν η αναδιαμόρφωση με βοήθεια AI να εμπνέει επιτέλους εμπιστοσύνη. Το σύστημα τύπων βοηθά, αλλά δεν εξαλείφει το πραγματικό πρόβλημα: κοινόχρηστα πακέτα, DTOs, παραγόμενοι πελάτες, συστατικά React, δοκιμές και κώδικας εφαρμογής, όλα να αναφέρονται στα ίδια ονόματα σε ένα μεγάλο αποθετήριο.
Για την TypeScript, το κριτήριο είναι υψηλότερο από το «καταλαβαίνει τη σύνταξη». Ο πράκτορας πρέπει να ακολουθεί το συμβόλαιο από τον ορισμό έως την υλοποίηση και την ακτίνα επίδρασης, πριν επεξεργαστεί έναν κοινόχρηστο τύπο, hook ή πελάτη.
Το Maguyva εξάγει κλάσεις, μεθόδους, διεπαφές και ψευδώνυμα τύπων στα .ts, .mts, .cts και στις συνηθισμένες παραλλαγές αρχείων TypeScript γύρω από δοκιμές και stories. Τα προθέματα μέλους κανονικοποιούνται, όμως τα αναγνωριστικά με προσδιορισμό κλάσης διατηρούνται, κάτι που βοηθά όταν ένα αποθετήριο έχει τόσο ένα απλό όνομα βοηθητικού στοιχείου όσο και μια μέθοδο εντός κλάσης με το ίδιο τελικό τμήμα ονόματος.
Το JSX αντιμετωπίζεται ως πραγματικό δομικό σήμα και όχι ως τυχαία σήμανση. Στα ευρετηριασμένα αρχεία TypeScript, οι δοκιμές, τα stories και η διαμόρφωση παραμένουν διαθέσιμα μαζί με τον κώδικα της εφαρμογής, βοηθώντας έναν πράκτορα να ελέγξει παραδείγματα χρήσης και ρυθμίσεις πριν αλλάξει ένα κοινόχρηστο στοιχείο ή μια υπηρεσία.
Τρία μοτίβα εκκίνησης συνήθως αρκούν:
find_symbol όταν γνωρίζετε ήδη το όνομα της διεπαφής, του ψευδωνύμου τύπου, του hook ή της υπηρεσίας.dependency_search πριν αλλάξετε κοινόχρηστους τύπους ή πελάτες που μπορεί να διακλαδίζονται σε πολλά πακέτα.structural_search όταν χρειάζεστε ένα σχήμα κώδικα και όχι μια αντιστοίχιση λέξης-κλειδί, για παράδειγμα επαναλαμβανόμενα μοτίβα συστατικών ή μεθόδων.Για εννοιολογικά ερωτήματα όπως «ακολούθησε τη διαδρομή υποβολής παραγγελίας κατά την ολοκλήρωση αγοράς», το get_task_context είναι συχνά καλύτερο πρώτο βήμα από μια ακατέργαστη αναζήτηση.
Αυτή η σελίδα είναι πιο χρήσιμη για ενιαία αποθετήρια web και πλατφόρμας όπου η TypeScript είναι το επίπεδο συντονισμού για πολλά πακέτα. Αν το αποθετήριό σας περιλαμβάνει ακόμη πολλή παλαιότερη JS, διαβάστε τον οδηγό JavaScript. Αν το ερώτημά σας είναι πραγματικά «μπορεί ο πράκτορας να κρατήσει μαζί κώδικα εφαρμογής και πλαίσιο υποδομής;», συνδυάστε αυτή τη σελίδα με το Terraform.
Ιδανική χρήση
Ροές εργασίας πρακτόρων
Λεπτομέρειες μηχανής
Χρήσιμα σημεία εισόδου MCP
Ξεκινήστε εδώ όταν γνωρίζετε την κοινόχρηστη διεπαφή, το ψευδώνυμο τύπου, hook ή service που θέλετε να εξετάσετε.
Χρησιμοποιήστε το πριν αλλάξετε ένα κοινόχρηστο DTO ή client, για μια ρεαλιστική ακτίνα επίδρασης σε όλα τα πακέτα.
Χρησιμοποιήστε αναζήτηση σε επίπεδο AST όταν χρειάζεστε ένα μοτίβο, όχι ταίριασμα συμβολοσειράς — για παράδειγμα επαναλαμβανόμενα σχήματα συστατικών ή μεθόδων.
Σχετικοί οδηγοί
Χρήσιμο όταν ένα αποθετήριο συνδυάζει CommonJS, ESM, σενάρια εργασιών, δοκιμές και παλαιότερο κώδικα εφαρμογής.
Επεκτάσεις
.cjs, .js, .mjs, .spec.js, +2 ακόμα
Χρήσιμο όταν ο κώδικας υποδομής αποτελεί μέρος του πλαισίου του αποθετηρίου και δεν είναι κάτι που ο πράκτορας πρέπει να προσπερνά επιπόλαια.
Επεκτάσεις
.tf, .tfvars