Die Workspace-Grenze
Ein Workspace ist der Verzeichnisbaum, den ein Projektstamm markiert — der Stamm, in dem der workspace:-Block Ihrer Konfiguration liegt, der, den --workspace-root nennt, der Ordner, den ein Editor geöffnet hat, oder der, über dem der Server eines Assistenten gestartet wurde. Alles, was Aggrega auf eigene Rechnung liest und schreibt, ist an diesen Baum gebunden, außer dort, wo Sie oder die Workspace-Konfiguration einen Ort außerhalb davon nennen. Ein symbolischer Link darin kann auf jeden Ort des Rechners zeigen, daher wird ein Link nie allein deshalb als Teil des Workspace betrachtet, weil er dort liegt: Entscheidend ist, wohin er führt.
Diese Seite stellt die Regel vollständig dar. Die Seiten der einzelnen Oberflächen — die Kommandozeile, der Language Server und die Assistenten-Tools — beschreiben, wie ihre eigenen Anfragen auf sie treffen.
Was innerhalb des Workspace liegt
Ein Pfad liegt innerhalb des Workspace, wenn sein tiefster existierender Teil, mit aufgelösten Links, der Workspace-Stamm ist oder darunter liegt — wobei die eigenen Links des Stamms ebenso aufgelöst werden, sodass ein Workspace, den Sie über einen eigenen Link erreichen, weiterhin alles darunter umfasst.
Ein Stamm, den Sie über einen Link öffnen, ist der Workspace, zu dem der Link führt. Ob der geöffnete Ordner selbst ein Link ist oder über einen weiter oben erreicht wird, Aggrega listet, liest und schreibt genau das, was es in dem Workspace täte, zu dem der Link führt — seine Releases, seine Dokumente, seine Lockdateien —, und beurteilt jeden Link darin auf dieselbe Weise. Jeder Pfad in einer Antwort wird dennoch vom Stamm aus geschrieben, wie er angegeben wurde — der Ordner, den ein Editor geöffnet hat, das --workspace-root, das Sie eingegeben haben, das Verzeichnis, in dem Sie laut Ihrer Shell arbeiten —, sodass das, was Ihnen angezeigt wird, zu den Pfaden passt, mit denen Sie arbeiten.
Diese eine Lesart deckt jede Art von Pfad ab:
- Entscheidend ist, wohin ein Pfad führt, nicht, wie er geschrieben ist.
./shared/app.yamlliegt außerhalb, wennsharedein Link auf ein Verzeichnis anderswo ist, obwohl jeder seiner Teile innerhalb des Workspace geschrieben ist. Ein Anfrageparameter kann dennoch eine eigene Schreibweise verlangen — etwa einen Pfad relativ zum Stamm —, und seine eigene Seite sagt dies; das ist eine Regel über den Parameter, nicht über die Grenze. - Ein Pfad, der noch nicht existiert, wird anhand der Verzeichnisse auf dem Weg dorthin beurteilt. Eine Datei, die ein Build gerade unter einem
distanlegen will, das ein nach außen führender Link ist, liegt außerhalb, bevor sie geschrieben wird. - Ein Link, der nirgendwohin oder im Kreis führt, ist nichts, was existiert. Stattdessen wird das Verzeichnis beurteilt, das ihn enthält, und nichts wird verfolgt, um herauszufinden, wohin der Link führen sollte. Wo ein solcher Link genau dort steht, wo gleich eine Datei angelegt werden soll, wird auch der Ort geprüft, auf den er zeigt, da die Datei dort landen würde.
- Ein Link zu einem anderen Ort innerhalb des Workspace wird wie üblich verfolgt. Nur ein nach außen führender Link wird zurückgehalten.
Die Regel beurteilt, wohin ein Pfad auf der Festplatte führt, und nichts anderes. Sie liest keinen Wert und leitet nichts aus einem Namen ab.
Was ein nach außen führender Link bewirkt
Was mit einem Pfad geschieht, der nach außen führt, hängt davon ab, um welche Art von Pfad es sich handelt. Es gibt drei Ergebnisse.
Als nicht gelesen aufgeführt
Wo Aggrega auflistet, was der Workspace enthält, wird ein nach außen führender Link nicht gelesen, und die Auflistung sagt das. Die Releases, die ein Editor zur Auswahl anbietet, der Entitätsindex und die Vervollständigungen und Kandidaten, die ein Editor daraus bezieht, sowie list-releases und list-entities eines Assistenten durchsuchen kein Verzeichnis außerhalb des Workspace und lesen keine Datei außerhalb davon, was auch immer diese Datei deklariert — sodass eine Entität, die Ihr Editor unter einem solchen Link anzeigt, nicht als eigene Entität des Workspace aufgeführt wird. Die Release-Auflistungen und die Entitätsauflistungen nennen jeden solchen Link nach seiner eigenen Stelle im Workspace, nie nach seinem Ziel: unreadLinkedDirs und unreadLinkedFiles im Language Server, unread_linked_dirs und unread_linked_files in den Assistenten-Tools. Ein Link auf ein Verzeichnis, das Ihre Konfiguration unter catalog_dirs aufführt, auf ein Verzeichnis darunter oder auf ein Release, das sie nennt, wird nicht genannt: Die Konfiguration hat diese Stelle erreicht — ein aufgeführtes Verzeichnis wird mit allem darunter gelesen —, wie die Ausnahmen weiter unten beschreiben. Auch eine .gitignore, die ein nach außen führender Link ist, wird nicht gelesen, sodass eine Datei an anderer Stelle auf dem Rechner nie entscheidet, welche Dokumente des Workspace durchsucht werden. Eine Workspace-Konfigurationsdatei, die ein nach außen führender Link ist, wird ebenfalls unter den nicht gelesenen Dateien genannt: Diese Auflistungen antworten für diesen Workspace weiterhin, gelesen ohne jede Konfiguration, während jede Anfrage, über die die Konfiguration entscheidet, angehalten wird, wie die eigene Konfiguration des Workspace weiter unten beschreibt.
Abgelehnt
Ein Pfad, den eine Anfrage nennt, wird abgelehnt, wenn der Aufrufer nicht der Besitzer des Rechners ist, der ihn eintippt. Abgesehen von den Ausnahmen weiter unten muss jeder Pfad, den eine Anfrage eines Editors an aggrega serve dem Server zum Lesen oder Schreiben nennt, und jeder Pfad, den ein Assistent einem über HTTP erreichten Server nennt, in den Workspace hineinführen; einer, der nach außen führt, wird abgelehnt, ohne dass etwas gelesen oder geschrieben wird, und die Ablehnung nennt den Parameter, wie die Seite der jeweiligen Oberfläche darlegt. Die Dokumentbearbeitung wird auf jeder Oberfläche auf diese Weise abgelehnt, die Befehlszeile eingeschlossen — siehe Die Dokumentbearbeitung bleibt innerhalb.
Angehalten
Wo ein Vorgang aus eigenem Antrieb über einen nach außen führenden Link lesen oder schreiben würde, hält er an. Das sind die Pfade, die das Produkt selbst ermittelt, statt Pfade, die Sie genannt haben, und einen davon stillschweigend zu übergehen könnte ändern, was ein Build bedeutet; daher hält jeder davon den Vorgang an, nennt den Link und sein Ziel und lässt die Stelle, auf die der Link zeigt, genau so, wie sie war:
- Was eine Suche liest — ein Dokument unterhalb eines Katalogverzeichnisses oder neben einem Release, das sein Aggregate oder sein Manifest per Identität nennt, oder neben einem Manifest, das das Manifest, das es erweitert, auf diese Weise nennt. Das Release oder das Manifest, das dem Vorgang genannt wurde, gehört nicht zu diesen Dokumenten: Es wurde dort gelesen, wo es genannt wurde — siehe Ein über einen Link genanntes Release oder Manifest. Eine Suche, die einen solchen Link überspränge, könnte an seiner Stelle eine andere Entität gleichen Namens aus einem späteren Verzeichnis auflösen; daher halten ein Build, ein Pull, eine Validierung, eine Inspektion, die den Katalog liest, ein Lint eines einzelnen Release oder des gesamten Katalogs sowie die Anfragen des Editors und eines Assistenten, die ein Release bauen, in der Vorschau anzeigen, als Graph darstellen, validieren, linten oder beschreiben, allesamt an, bevor etwas aufgelöst oder geprüft wird:
E0321. - Die Lockfile eines Release — neben dem Release gelesen, für die Pins, gegen die ein Build, ein Pull, eine Validierung, ein Lint, eine Inspektion,
aggrega cache pruneund die Anfragen des Editors und eines Assistenten auflösen. Sie unterliegt dort, wo sie gelesen wird, genau derselben Regel wie dort, wo sie geschrieben wird, sodass eine Lockfile, die ein nach außen führender Link ist, jeden davon anhält, statt ihnen Pins zu leihen, die an anderer Stelle auf dem Rechner liegen:E0321. - Eine neben einer Entität gelesene Datei — die anderen Dokumente im Verzeichnis einer Entität, die Sie pinnen oder veröffentlichen, gelesen, um festzustellen, ob eine andere Entität dieses Verzeichnis teilt, und die gebaute
.wasm, aus der eine Plugin-Entität in einem Katalogverzeichnis geladen wird. Jede wird nur aus dem Verzeichnis heraus gelesen, unter dem das eigene Dokument der Entität gelesen wurde: dem Workspace, einem Katalogverzeichnis, das Sie außerhalb davon genannt haben, oder dem Verzeichnis eines Dokuments, das Sie außerhalb davon genannt haben. Eine solche Datei, die ein nach außen führender Link ist, hält daheraggrega pin,aggrega push(einen Probelauf eingeschlossen), einen Pull, der pinnt, sowie das Pinnen und Veröffentlichen durch den Editor und einen Assistenten an — ein ungelesen gebliebenes Dokument könnte die im Weg stehende Entität sein — und hält einen Build oder einen Pull an, der das Plugin lädt, statt Bytes auszuführen, die an anderer Stelle auf dem Rechner liegen:E0321. - Der Artefakt-Cache — alles, was Aggrega aus dem Cache unter
artifact_cache_dirliest: eine zwischengespeicherte Entität, ein Plugin oder eine Bibliothek und das Manifest daneben, ein Quellarchiv und seine Metadaten, eine gepinnte externe Eingabe, ein Signaturpaket und der lokale Suchindex einer Registry sowie jeder Workspace-Eintrag, denaggrega cache status,aggrega cache pruneundaggrega cache clearauflisten. Der Cache wird nur aus dem Cache-Verzeichnis heraus gelesen, dem Ort, an den er geschrieben wird, sodass alles darin, was ein aus diesem Verzeichnis herausführender Link ist — an eine andere Stelle im Workspace ebenso wie an jeden anderen Ort —, einen Build, einen Pull, eine Validierung, eine Suche, jeden der drei Cache-Befehle sowie die Anfragen des Editors und eines Assistenten, die den Cache lesen, anhält, statt ihnen Bytes zu übergeben, die an einem Ort liegen, der nicht dem Cache gehört — Inhalte eingeschlossen, die gegen einen aufgezeichneten Digest geprüft werden, denn ein Digest sagt, was die Bytes sind, nicht, wo sie gelesen werden dürfen. Der Deprecation-Hinweis, denaggrega inspectausgibt und der nichts entscheidet, ist ausgenommen. Ein Prune oder ein Clear behandelt eines der eigenen Verzeichnisse des Cache, das ein solcher Link ist, oder ein Cache-Verzeichnis, das selbst ein aus dem Workspace herausführender Link ist, als die Entfernung, die es wäre, mitE0320, bevor er irgendetwas auflistet:E0321. - Ein Repository, das eine Quelle abruft — der Checkout, den ein Pull für eine
git-repository-Quelle archiviert. Der Checkout ist ein eigenes Verzeichnis, daher wird ein Link, den das Repository enthält, nur dann als das archiviert, worauf er zeigt, wenn dieses innerhalb des Repository liegt; einer, der aus ihm herausführt und jede Datei auf dem Rechner erreichen könnte, auf dem der Pull läuft, hält den Pull an, nennt den Link und sein Ziel, und nichts wird zwischengespeichert —module_subdirselbst eingeschlossen, wo es ein solcher Link ist:E0321. Der Checkout ist verschwunden, sobald der Pull anhält, daher nennt die Meldung den Link nach seiner Stelle im Repository sowie das Repository und die Revision, die die Quelle nennt. Einmodule_subdir, das in seiner geschriebenen Form über das Repository hinaus nach oben führt, wird abgelehnt, bevor das Repository abgerufen wird, sodass nichts neben dem Checkout gelesen wird:E0307. - Die Dateien eines Verzeichnisses, das Sie importieren —
aggrega import, das Import-Tool des Assistenten undaggrega/importder Sitzung lesen, wenn ihnen ein Verzeichnis übergeben wird, diejenigen seiner Dateien, die die Dateimuster des Importers auswählen. Das Verzeichnis ist eine eigene Wurzel, wo immer es liegt — siehe Ein Verzeichnis, das Sie importieren —, sodass ein Link unter diesen Dateien, der aus ihm hinausführt, oder ein Link auf ein Verzeichnis, der aus ihm hinausführt, den Import anhält und den Link nennt, bevor eine Datei des Verzeichnisses gelesen wird:E0321. - Die eigene Konfiguration des Workspace — jede
.aggrega-config.yamlvon der Wurzel bis hinunter zu dem Verzeichnis, in dem ein Befehl ausgeführt wird, und die.aggrega-config-append-ci.yamleiner Pipeline neben jeder von ihnen. Jeder Befehl, der die Konfiguration liest, der Language Server und die Tools eines Assistenten lesen sie vor allem anderen, sodass eine dieser Dateien, die ein hinausführender Link ist, jeden von ihnen dort anhält, statt sie mit einer Konfiguration laufen zu lassen, die aus dem Übrigen zusammengesetzt ist:E0321. Die Befehle vonaggrega, die sie nie lesen —version,help,completion,explain,get-schema,scaffoldbeim Entwurf eines Startdokuments,skills list,plugin run-local,plugin sync,auth tokenundlogout—, laufen wie gewohnt, mit einer Warnung, die den Link nennt.scaffold --exampleliest sie, für die Standard-Registry und die Signaturrichtlinie, und hält dort an wie jeder andere Leser. Der Language Server und der Server eines Assistenten, der über seine eigenen Streams kommuniziert, starten über einem solchen Workspace dennoch, damit aufgelistet werden kann, was er enthält: Die Release- und Entitätslisten antworten, gelesen ohne Katalogverzeichnis und ohne sonstige Konfiguration, und nennen die Datei unter den nicht gelesenen Links. Jede andere Anfrage, über die die Konfiguration entscheidet — ein Build, eine Vorschau, ein Graph, eine Validierung, ein Lint, eine Beschreibung, die effektive Konfiguration, das Standard-Release —, hält mitE0321an und nennt den Link, ebenso der Server eines Assistenten, der über HTTP lauschen soll und dessen Adresse und Autorisierung die Konfiguration festgelegt hätte. - Was ein Vorgang schreibt oder entfernt — das Ausgabeverzeichnis eines Builds, seine Grenzverzeichnisse und jede dort geschriebene Datei, der Trace; das Lockfile eines Release und der Plugin-Vertrauensdatensatz daneben; ein
entity.lock; die Workspace-Konfigurationsdatei, die ein Befehl schreibt; der Artefakt-Cache und jeder Teil davon, den ein Pull füllt oder denaggrega cache clearundaggrega cache pruneleeren; die Entwürfe, die ein Import schreibt, und die Plugin-Entitäten, dieaggrega plugin gen-catalogschreibt; sowie die Markierung.aggrega/active-release, in der ein Editor ein Standard-Release festhält und die der Language Server für ihn schreibt. Eindist, das ein Link ist, würde sonst „die Ausgabe neu erstellen“ in das Löschen eines Verzeichnisses irgendwo anders auf dem Rechner verwandeln:E0320. - Was ein Dokument über einen Pfad benennt — siehe Ein Verweis, den ein Dokument schreibt:
E0324. - Der Inhalt, den eine Entität deklariert — ein
source:oder ein$import:, dessen Pfad durch ein Verzeichnis führt, das ein Link aus dem eigenen Verzeichnis der Entität hinaus ist, und den eine Veröffentlichung sonst unter einem Namen innerhalb der Entität mitführen würde:E0304.
Dies gilt unabhängig davon, wer den Vorgang gestartet hat — die Befehlszeile, ein Editor oder ein Assistent über einen der beiden Transporte —, denn der Pfad gehört dem Workspace und dem Produkt, nicht dem Aufrufer.
Ein Verweis, den ein Dokument schreibt
Ein Release und ein Manifest können eine andere Datei über einen Pfad benennen: aggregate: und manifest: eines Release, geschrieben als ./… oder ../…, sein extends:, das als Pfad geschriebene extends: eines Manifest und parameters: { $import: … } eines Release. Ein Dokument im Workspace erreicht auf diese Weise nur Dateien innerhalb des Workspace — ein Pfad, der in seiner geschriebenen Form hinaussteigt, wird abgelehnt, ebenso einer, der in seiner geschriebenen Form innerhalb bleibt, unterwegs aber auf einen hinausführenden Link trifft. Aus der Datei, die einer von beiden benennt, wird nichts gelesen.
Ein Workspace, den Sie geklont haben, enthält die Verweise seines Autors; würde man also das, was Sie benennen, begrenzen, aber allem folgen, wohin ein Dokument dann führt, läge die Grenze nur ein ../ entfernt. Wo ein Dokument eine anderswo gehaltene Entität benötigt, benennt es die Entität statt einer Datei — aggregate: payments —, und die Workspace-Konfiguration listet das Katalogverzeichnis auf, das sie enthält. Ein Name wird nachgeschlagen, nicht verfolgt, und wird daher hier nie abgelehnt.
Ein Release oder ein Manifest außerhalb des Workspace, zugelassen, weil Sie es benannt haben, erreicht nur Dateien in seinem eigenen Verzeichnis — siehe Eine Ausnahme reicht bis zu dem Verzeichnis, das sie benennt, und nicht weiter.
Die Ausnahmen und warum jede eine ist
Ein Pfad in einer dieser Klassen wird dort berücksichtigt, wohin er führt, ob innerhalb des Workspace oder nicht. Jede ist eine Klasse von Pfaden statt einer Liste von Orten, und jede ist aus einem eigenen Grund eine Ausnahme.
- Was die Workspace-Konfiguration benennt. Ihre Katalogverzeichnisse —
catalog_dirsundcatalog_dirs_append, für den Workspace oder für ein Release unterworkspace.releases—, die unterworkspace.releasesals Schlüssel eingetragenen Release-Dateien,build.authoring_release, die lokale.wasmeiner Plugin-Anbindung und die Dateien unter derenwith.sources,mcp.tls.cert_file,mcp.tls.key_file,mcp.authorization.jwks_file, der fixierte Vertrauensanker einer Registry und einartifact_cache_dir, das aus der Workspace-Wurzel hinaussteigt. Einen Pfad in der Konfiguration zu benennen ist der bewusste Weg, auf dem ein Workspace über sich hinausreicht: Er wird einmal niedergeschrieben, mit dem Projekt aufbewahrt und von jedem gelesen, der es prüft. Das konventionelle Verzeichniscatalogdes Workspace gilt als benannt, wenn die Konfiguration es auflistet oder Sie es mit--catalogübergeben — oder wenn die Konfiguration den Ort, zu dem es führt, in beliebiger Schreibweise auflistet bzw. Sie ihn übergeben, oder ein Verzeichnis oberhalb dieses Ortes, das dann das dort Liegende einmal liest, über das von Ihnen benannte Verzeichnis. Nur gelesen, weil es vorhanden ist, ist es der eigene Inhalt des Workspace, sodass eincatalog, das ein aus dem Workspace hinausführender Link ist, erst gelesen wird, wenn Sie es oder den Ort, zu dem es führt, benennen. - Ein Pfad, den Sie auf der Befehlszeile eingeben.
aggrega build --release ../other/release.yaml,--catalog /srv/shared-catalog,--output-dir, eine Datei zum Validieren, Linten, Pinnen oder Veröffentlichen: Jeder wird dort verwendet, wohin er führt — abgesehen von der Dokumentbearbeitung, siehe unten. Ihnen gehört der Rechner, auf dem der Befehl läuft, und Sie können bereits alles lesen und schreiben, was Sie eingeben würden, sodass es nichts brächte, Sie an ein Verzeichnis zu binden. - Ein Pfad, den ein Assistent über die eigenen Streams des Prozesses benennt. Ein Client, der
aggrega mcpauf Ihrem Rechner gestartet hat, läuft als Sie, und sein Host stellt ihm meist eigene Datei- und Shell-Tools bereit, sodass ein von ihm benannter Pfad so berücksichtigt wird, als hätten Sie ihn eingegeben — siehe Die beiden Assistenten-Transporte. - Die rechnerweiten Speicher des Produkts — die globale Konfigurationsdatei, der Speicher für kompilierte Module, der Cache der Plugin-Deskriptoren, das Dokumentationspaket und der Speicher für Registry-Anmeldedaten. Sie gehören zum Rechner statt zu einem Workspace, daher enthält kein Workspace sie.
- Eine in einem Dialog ausgewählte Datei oder ein Verzeichnis, gelesen, wo sie liegen. Ein Editor sendet als absoluten Pfad die Schlüsseldatei oder den Vertrauensanker einer Registry-Registrierung, die Beschreibung, die
aggrega/importumwandelt — eine Datei oder ein Verzeichnis, dessen Dateien der Importer liest —, und das Modul, für dasaggrega/pluginGenCatalogeine Entität erzeugt, mit dem Overlay daneben. Jedes davon hat eine Person ausgewählt, wo immer sie es aufbewahrt. Sie werden nur gelesen: Nichts, was eine Anfrage schreibt, geht an einen so ausgewählten Pfad. Ein so ausgewähltes Verzeichnis wird auf sich selbst beschränkt, wie jedes Verzeichnis, das Sie importieren. - Ein Dokument, das Ihr Editor geöffnet hält. Seine Validierung, das Anfordern oder Verwerfen seiner Diagnosen, Hover, Vervollständigung, Auflösung sowie das Finden von Verweisen und Implementierungen darin werden aus dem Inhalt beantwortet, den der Editor gesendet hat, sodass keine Datei unter dem Pfad gelesen wird, der es benennt, und der Pfad nie wegen seines Ziels abgelehnt wird. Eine Anfrage, die das Dokument tatsächlich vom Datenträger liest, gehört zur oben beschriebenen abgelehnten Art.
Die auf der Befehlszeile eingegebenen Pfade und die rechnerweiten Speicher werden überhaupt nie beurteilt; die übrigen werden aufgrund ihrer Klasse durchgelassen, nie aufgrund der Anfrage, die sie zufällig trägt.
Eine Ausnahme reicht bis zu dem Verzeichnis, das sie benennt, und nicht weiter
Ein Verzeichnis, das Sie außerhalb des Workspace benannt haben, ist eine eigene Wurzel für alles, was darunter gelesen oder geschrieben wird. Das Verzeichnis selbst wird so verwendet, wie Sie es benannt haben — ist es ein Link, wird ihm bis zu seinem Ziel gefolgt —, und ein Link darunter, der aus ihm hinausführt, wird genau wie ein Link innerhalb des Workspace behandelt: in einer Auflistung nicht gelesen, und eine Suche oder einen Schreibvorgang anhaltend. So hält ein Katalogverzeichnis, das Sie außerhalb des Workspace auflisten, ein Ausgabeverzeichnis, das Sie an aggrega plugin gen-catalog oder aggrega import übergeben, und ein artifact_cache_dir, das aus dem Workspace hinaussteigt, jeweils das, was darunter liegt, bei sich. Wo ein von Ihnen benanntes Verzeichnis innerhalb des Workspace liegt, ist der Workspace die Wurzel — abgesehen von einem Verzeichnis, das Sie importieren, das eine eigene Wurzel ist, wo immer es liegt.
Ein Verzeichnis, das Sie benennen, wird relativ zu dem Ordner aufgelöst, in dem Sie den Befehl ausführen, bevor etwas darunter abgelegt wird. Ein Ausgabeverzeichnis, das Sie relativ an aggrega import übergeben, ist der Ordner dieses Namens in dem Ordner, in dem Sie den Befehl ausführen, und ein Laufwerk, das Sie unter Windows ohne Pfad benennen — D: —, ist der aktuelle Ordner auf diesem Laufwerk. Das Verzeichnis wird zuerst zu einem vollständigen Pfad gemacht, und jede Datei wird unter diesem vollständigen Pfad abgelegt, sodass eine Datei, deren Name mit einem Trennzeichen beginnt, etwa \notes.txt, in dem von Ihnen benannten Verzeichnis landet statt auf der obersten Ebene des Laufwerks, und das Verzeichnis, das der Befehl meldet, ist dasjenige, in das geschrieben wurde.
Ein Release oder ein Manifest, das Sie außerhalb des Workspace benannt haben, ist dieselbe Regel, auf eine Datei angewendet: Sein eigenes Verzeichnis ist die Wurzel, sodass das, was es über einen Pfad benennt — und was jedes Release benennt, zu dem seine Kette extends: führt —, innerhalb dieses Verzeichnisses bleiben muss. Ein Release, das neben seinem Aggregate und Manifest liegt, lässt sich von überall bauen; eines im üblichen Layout releases/, das ../aggregates/app.yaml benennt, wird stattdessen aus seinem eigenen Workspace gebaut.
Ein Release oder ein Manifest, über einen Link benannt
Ein Release, das Sie über einen Link benennen, wird dort gelesen, wohin der Link führt, und dort aufgelöst, wo Sie es benannt haben. Eingegeben als --release release.yaml, wobei release.yaml ein Link auf eine anderswo liegende Datei ist — oder auf diese Weise unter workspace.releases oder als build.authoring_release benannt —, wird das Release von dem Ort gelesen, zu dem der Link führt. Das Aggregate und das Manifest, die es benennt, über die Identität oder über einen Pfad, werden neben dem Link gesucht, in dem Verzeichnis, in dem Sie es benannt haben, und an die Wurzel dieses Verzeichnisses gebunden: den Workspace oder das Verzeichnis selbst, wo es außerhalb des Workspace liegt. Auch sein Lockfile wird neben dem Link gelesen und geschrieben, nie dort, wohin der Link führt. Das Release gehört nicht zu den Dokumenten, auf die seine eigene Suche neben ihm trifft, daher hält es diese Suche nie an; ein anderes Release daneben, das ein hinausführender Link ist, hält sie dennoch an. Ein Manifest, das Sie allein über einen Link inspizieren, wird auf dieselbe Weise gelesen und aufgelöst.
Das Verzeichnis des Artefakt-Cache ist eine eigene Wurzel, wo immer es liegt. Alles, was der Cache enthält, wird nur innerhalb des Cache-Verzeichnisses geschrieben, gelesen und entfernt, sodass eines der eigenen Verzeichnisse des Cache oder eine Datei darin, das bzw. die ein aus dem Cache-Verzeichnis hinausführender Link ist, angehalten wird — auch wo es anderswohin innerhalb des Workspace führt —, während einem Link, der anderswohin innerhalb des Cache-Verzeichnisses führt, gefolgt wird. Wo das Cache-Verzeichnis selbst liegt, ergibt sich aus der Schreibweise seines Werts. Innerhalb der Workspace-Wurzel geschrieben — das Standardverzeichnis .aggrega/cache eingeschlossen — ist es ein eigenes Verzeichnis des Workspace: Einem Cache-Verzeichnis, das ein Link anderswohin innerhalb des Workspace ist, wird gefolgt, und eines, das aus dem Workspace hinausführt, wird abgelehnt, beim Lesen wie beim Schreiben. Hinaussteigend geschrieben (../shared-cache), ist es ein Verzeichnis, das die Konfiguration benennt, gelesen und geschrieben dort, wohin es führt.
Ein Verzeichnis, das Sie importieren
Ein Verzeichnis, das Sie importieren, ist eine eigene Wurzel, wo immer es liegt — innerhalb des Workspace ebenso wie außerhalb, und darin unterscheidet es sich von jedem anderen Verzeichnis, das Sie innerhalb des Workspace benennen. aggrega import, das Import-Tool des Assistenten und aggrega/import der Sitzung übergeben dem Importer jede Datei des Verzeichnisses unter ihrem Ort in diesem Verzeichnis, sodass das Übergebene nur aus dem Inneren des Verzeichnisses gelesen wird. Beurteilt wird das, woraus der Import etwas übernehmen würde: ein Link auf eine Datei, die ein Muster des Importers auswählt — eines beliebigen Importers, wo das Format erkannt statt benannt wird —, und ein Link auf ein Verzeichnis, das nie betreten wird. Einer davon, der aus dem Verzeichnis hinausführt, wird abgelehnt, bevor eine Datei gelesen wird, auch wo er anderswohin innerhalb des Workspace führt, während ein ausgewählter Link auf eine Datei anderswo innerhalb des Verzeichnisses dort gelesen wird, wohin er zeigt, unter dem eigenen Namen des Links. Ein Link auf eine Datei, die kein Muster auswählt, wird weder beurteilt noch gelesen. Das Verzeichnis selbst wird so verwendet, wie Sie es benannt haben; ist es ein Link, wird ihm bis zu seinem Ziel gefolgt.
Die Dokumentbearbeitung bleibt innerhalb
aggrega edit-document, die Dokumentbearbeitung und die Einfügeposition des Language Servers sowie edit-document und insertion-point des Assistenten wirken nur auf ein Dokument, das der Workspace enthält. Ein Dokument außerhalb des Workspace, in seiner geschriebenen Form oder über einen aus ihm hinausführenden Link, wird auf jeder Oberfläche abgelehnt, ohne dass etwas gelesen oder geschrieben wird — auch dort, wo ein von Ihnen benannter Pfad sonst berücksichtigt wird.
Die beiden Assistenten-Transporte
aggrega mcp stellt dieselben Tools auf zwei Arten bereit, und die Grenze unterscheidet sich zwischen ihnen, weil sich der Aufrufer unterscheidet.
- Über die eigenen Streams des Prozesses hat der Client den Server auf Ihrem Rechner gestartet, sodass ein Aufruf so ist, als würden Sie auf der Befehlszeile tippen: Ein Pfadargument darf absolut sein und außerhalb des Workspace liegen, ein Aufruf darf seine eigenen
workspace_rootundcatalog_dirsbenennen, und die Tools, die einen Befehl vonaggregain einem separaten Prozess ausführen, werden angeboten. Nur der Pfad, den ein Aufruf benennt, wird so berücksichtigt, wie er benannt ist. Was der Vorgang dann auf eigene Rechnung liest und schreibt, wird wie an einem Terminal behandelt: Eine Auflistung liest nicht durch einen hinausführenden Link, ein Verweis, den ein Dokument schreibt, verlässt den Workspace nicht, und ein Schreibvorgang geht nicht durch ein verlinktes Ausgabe- oder Cache-Verzeichnis. Workspace-Inhalte können lenken, was ein Assistent anfordert, sodass auf einem Host, auf dem diese Tools sein einziger Zugang zu Ihren Dateien sind, ein Dokument in einem von Ihnen geklonten Workspace ihn dennoch dazu bringen kann, einen Pfad außerhalb des Workspace zu benennen und lesen oder schreiben zu lassen; unter was ein Assistent tun kann, ohne Sie vorher zu fragen legen Sie fest, wie viel er unaufgefordert tut. - Über HTTP gehört dem Aufrufer der Rechner nicht, auf dem der Server läuft. Der Workspace ist derjenige, über dem der Server gestartet wurde, und bleibt für dessen gesamte Laufzeit fest; jedes Pfadargument wird darin gehalten und wie oben beurteilt; ein Aufruf, der
workspace_rootodercatalog_dirsbenennt oder einen auf dem Host gehaltenen Signaturschlüssel auswählt, wird abgelehnt; und die Tools, die einen Befehl vonaggregaausführen, werden nicht angeboten. Eine Ablehnung nennt das Argument und zitiert einen relativen Wert so, wie er gesendet wurde, nennt aber weder die Workspace-Wurzel noch, wohin ein Pfad geführt hätte.
Wenn etwas abgelehnt wird oder anhält
| Was Sie sehen | Was zu tun ist |
|---|---|
| Eine Auflistung nennt einen Link unter denen, die sie nicht gelesen hat | Ersetzen Sie den Link durch eine Kopie dessen, worauf er verweist; oder führen Sie für anderswo abgelegte Entitäten das Verzeichnis, auf das der Link verweist, unter catalog_dirs auf; ein anderswo abgelegtes Release nennen Sie unter workspace.releases oder als build.authoring_release. |
E0321, ein Lesezugriff über einen Link aus einem Katalogverzeichnis oder dem Verzeichnis eines Release hinaus | Führen Sie das Verzeichnis, auf das der Link verweist, als Katalogverzeichnis auf oder übergeben Sie es mit --catalog, statt es über einen Link unterhalb eines solchen Verzeichnisses zu erreichen; oder ersetzen Sie den Link durch eine Kopie. Ist der Link das konventionelle catalog selbst, führen Sie catalog oder das Verzeichnis auf, auf das es verweist, oder übergeben Sie eines von beiden mit --catalog. |
E0321 auf der Lockdatei eines Release | Entfernen Sie den Link und führen Sie den Pull des Release erneut aus; dabei wird eine neue Lockdatei daneben geschrieben. Eine Lockdatei hat keinen anderen Ort. |
E0321 auf einer Datei neben einer Entität | Ersetzen Sie den Link durch die Datei selbst: Verschieben Sie ein Dokument, das eine Entität ist, in ein eigenes Verzeichnis, und legen Sie die gebaute .wasm neben ihre Plugin-Entität statt eines Links darauf. |
E0321 auf einer Konfigurationsdatei | Ersetzen Sie den Link durch eine im Workspace abgelegte Kopie. Eine zwischen Workspaces geteilte Konfiguration wird gelesen, indem man sie als globale Konfigurationsdatei angibt, mit --config oder AGGREGA_CONFIG, nachrangig zu den eigenen Dateien jedes Workspace. |
E0321 auf dem Artefakt-Cache | Entfernen Sie den Link; ein Pull füllt den Cache erneut. Um den Cache an einem anderen Ort zu halten, setzen Sie artifact_cache_dir auf dieses Verzeichnis, relativ zum Stammverzeichnis des Workspace geschrieben (../shared-cache), statt ihn zu verlinken. |
E0321 auf einem Link in einem abgerufenen Repository | Der Link ist in dem Repository committet, das die Quelle nennt — die Meldung nennt ihn mit seinem Ort dort: Ändern Sie ihn dort — lassen Sie ihn innerhalb des Repositorys zeigen oder committen Sie die Datei selbst — und nennen Sie die Revision, die die Änderung enthält. |
E0321 auf einem Link in einem Verzeichnis, das Sie importieren | Legen Sie die Datei selbst im Verzeichnis ab statt eines Links darauf, oder importieren Sie das Verzeichnis, auf das der Link verweist. Ein Verzeichnis, das Sie importieren, wird nur von innen heraus gelesen, wo immer es liegt. |
E0307 auf einem module_subdir | Nennen Sie ein Verzeichnis innerhalb des Repositorys: Der Wert darf unter die oberste Ebene des Repositorys hinabsteigen, aber nicht darüber hinaufsteigen. |
E0320, ein Schreib- oder Löschvorgang über einen Link | Entfernen Sie den Link, den die Meldung nennt, oder lassen Sie ihn an einen Ort innerhalb des Verzeichnisses verweisen, das die Meldung nennt, und führen Sie den Vorgang erneut aus. Nichts in Ihren Entitätsdateien verursacht ihn. |
E0324, ein nach außen führender Verweis | Nennen Sie ein anderswo abgelegtes Aggregate über seinen metadata.name und führen Sie sein Katalogverzeichnis auf; halten Sie ein Manifest, ein Release, das ein extends: nennt, und eine Parameterdatei innerhalb des Workspace — oder, für ein Dokument, das Sie von außen genannt haben, in dessen eigenem Verzeichnis; oder öffnen Sie den Workspace in einem Verzeichnis, das beide Dokumente enthält. |
E0304, Inhalt über einen Link | Ersetzen Sie den Link durch eine Kopie dessen, worauf er verweist, innerhalb des eigenen Verzeichnisses der Entität. |
| Eine Language-Server-Anfrage, die für einen nach außen führenden Pfad abgelehnt wurde | Senden Sie einen Pfad innerhalb des Workspace, relativ zu dessen Stammverzeichnis. Ein außerhalb des Workspace abgelegtes Release erreicht man, indem man es in der Konfiguration unter workspace.releases oder als build.authoring_release nennt und in der Anfrage den Link innerhalb des Workspace nennt, der darauf verweist — den Ort, an dem die Release-Auflistung es anbietet. |
| Ein Assistentenaufruf über HTTP, der für einen Pfad abgelehnt wurde | Senden Sie einen Pfad relativ zum Stammverzeichnis des Workspace, den der Server bereitstellt; wo die Ablehnung die relative Schreibweise eines absoluten Pfads anbietet, senden Sie diese. |
| Eine abgelehnte Dokumentbearbeitung | Bearbeiten Sie ein Dokument, das der Workspace enthält; ein Link auf ein Dokument an anderer Stelle wird beim Bearbeiten nicht verfolgt. |
Siehe auch
- Konfiguration — wo jede der obigen Einstellungen geschrieben wird und wie ein relativer Pfad darin aufgelöst wird.
aggrega serveundaggrega mcp— jede Anfrage und jedes Werkzeug und welche ihrer Parameter einen Pfad nennen.- Fatale Abbrüche — der vollständige Eintrag zu jeder obigen Bedingung.