Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

Il confine del workspace

Un workspace è l’albero di directory che la radice di un progetto contrassegna — la radice in cui si trova il blocco workspace: della tua configurazione, quella indicata da --workspace-root, la cartella aperta da un editor, o quella su cui è stato avviato il server di un assistente. Tutto ciò che Aggrega legge e scrive per conto proprio è vincolato a quell’albero, tranne dove tu, o la configurazione del workspace, indicate un luogo al di fuori di esso. Un link simbolico al suo interno può puntare ovunque sulla macchina, quindi un link non viene mai considerato parte del workspace solo perché si trova lì: ciò che conta è dove porta.

Questa pagina enuncia la regola per intero. Le pagine di ciascuna superficie — la riga di comando, il language server e gli strumenti dell’assistente — dicono come le loro richieste vi si confrontano.

Cosa si trova all’interno del workspace

Un percorso è all’interno del workspace quando la sua parte più profonda che esiste, con i link seguiti, è la radice del workspace o si trova sotto di essa — con i link della radice stessa seguiti allo stesso modo, così un workspace che raggiungi tramite un suo link contiene comunque tutto ciò che sta sotto.

Una radice che apri tramite un link è il workspace a cui il link porta. Che la cartella che apri sia essa stessa un link o venga raggiunta tramite uno più in alto, Aggrega elenca, legge e scrive esattamente ciò che farebbe nel workspace a cui il link porta — le sue Releases, i suoi documenti, i suoi lockfile — e giudica allo stesso modo ogni link al suo interno. Ogni percorso in una risposta è comunque scritto a partire dalla radice così come è stata data — la cartella aperta da un editor, il --workspace-root che hai digitato, la directory in cui la tua shell dice che stai lavorando — così ciò che ti viene mostrato corrisponde ai percorsi con cui lavori.

Quell’unica lettura copre ogni tipo di percorso:

  • A decidere è dove porta un percorso, non come è scritto. ./shared/app.yaml è all’esterno quando shared è un link a una directory altrove, anche se ogni sua parte è scritta all’interno del workspace. Un parametro di richiesta può comunque chiedere una propria forma di scrittura — un percorso relativo alla radice, per esempio — e la sua pagina lo dice; quella è una regola sul parametro, non sul confine.
  • Un percorso che non esiste ancora viene giudicato in base alle directory sulla strada verso di esso. Un file che una build sta per creare sotto un dist che è un link che porta all’esterno è all’esterno prima di essere scritto.
  • Un link che non porta da nessuna parte, o che gira in un ciclo, non è qualcosa che esiste. Viene invece giudicata la directory che lo contiene, e non si segue nulla per scoprire dove il link doveva portare. Dove un link del genere si trova esattamente dove un file sta per essere creato, viene controllato anche il luogo a cui punta, poiché è lì che il file finirebbe.
  • Un link verso un altro punto all’interno del workspace viene seguito come al solito. Solo un link che porta all’esterno viene trattenuto.

La regola giudica dove un percorso porta sul disco e nient’altro. Non legge alcun valore e non deduce nulla da un nome.

Ciò che accade a un percorso che porta all’esterno dipende dal tipo di percorso. Ci sono tre esiti.

Elencato come non letto

Dove Aggrega elenca ciò che il workspace contiene, un link che porta all’esterno non viene letto, e l’elenco lo dice. Le Releases che un editor offre tra cui scegliere, l’indice delle entità e i completamenti e i candidati che un editor ne ricava, e list-releases e list-entities di un assistente non cercano in una directory fuori dal workspace né leggono un file fuori da esso, qualunque cosa quel file dichiari — così un’entità che il tuo editor mostra sotto un link del genere non viene elencata come propria del workspace. Gli elenchi delle Release e gli elenchi delle entità indicano ogni link del genere con la sua posizione nel workspace, mai con la destinazione a cui porta: unreadLinkedDirs e unreadLinkedFiles sul language server, unread_linked_dirs e unread_linked_files sugli strumenti dell’assistente. Un link a una directory che la tua configurazione elenca sotto catalog_dirs, o a una directory al di sotto di una di esse, o a una Release che essa nomina, non viene indicato: la configurazione ha raggiunto quel luogo — una directory elencata viene letta con tutto ciò che contiene — come descrivono le eccezioni più avanti. Neanche un .gitignore che è un link che porta all’esterno viene letto, così un file altrove sulla macchina non decide mai quali documenti del workspace vengono cercati. Anche un file di configurazione del workspace che è un link che porta all’esterno viene indicato tra i file non letti: questi elenchi rispondono comunque per quel workspace, letto senza nulla di configurato, mentre ogni richiesta decisa dalla configurazione si arresta, come descrive la configurazione del workspace stesso più avanti.

Rifiutato

Un percorso indicato da una richiesta, quando chi chiama non è il proprietario della macchina che lo digita, viene rifiutato. Fatte salve le eccezioni più avanti, ogni percorso che una richiesta di un editor ad aggrega serve indica al server da leggere o scrivere, e ogni percorso che un assistente indica a un server raggiunto via HTTP, deve portare all’interno del workspace; uno che porta all’esterno viene rifiutato senza che nulla venga letto o scritto, e il rifiuto indica il parametro, come espone la pagina di ciascuna superficie. La modifica del documento viene rifiutata in questo modo su ogni superficie, riga di comando compresa — vedi La modifica del documento resta all’interno.

Arrestato

Quando un’operazione leggerebbe o scriverebbe di propria iniziativa attraverso un link che porta all’esterno, si arresta. Sono i percorsi che il prodotto ricava da sé anziché percorsi che hai indicato tu, e ignorarne uno in silenzio potrebbe cambiare il significato di una build, quindi ciascuno arresta l’operazione, indica il link e dove porta, e lascia il luogo a cui il link punta esattamente com’era:

  • Ciò che legge una ricerca — un documento al di sotto di una directory di catalogo, o accanto a una Release che nomina il proprio Aggregate o il proprio Manifest per identità, o accanto a un Manifest che nomina in quel modo il Manifest che estende. La Release o il Manifest indicati all’operazione non sono tra quei documenti: sono stati letti dove sono stati indicati — vedi Una Release o un Manifest indicati tramite un link. Una ricerca che saltasse un link del genere potrebbe risolvere al suo posto un’altra entità con lo stesso nome da una directory successiva, quindi una build, un pull, una convalida, un’ispezione che legge il catalogo, un lint di una sola Release o dell’intero catalogo, e le richieste dell’editor e di un assistente che compilano, mostrano in anteprima, rappresentano come grafo, convalidano, sottopongono a lint o descrivono una Release si arrestano tutte prima che qualcosa venga risolto o controllato: E0321.
  • Il lockfile di una Release — letto accanto alla Release per i pin rispetto a cui risolvono una build, un pull, una convalida, un lint, un’ispezione, aggrega cache prune e le richieste dell’editor e di un assistente. È vincolato dove viene letto esattamente come dove viene scritto, quindi un lockfile che è un link che porta all’esterno arresta ciascuno di essi anziché fornire loro pin conservati altrove sulla macchina: E0321.
  • Un file letto accanto a un’entità — gli altri documenti nella directory di un’entità che fissi o pubblichi, letti per stabilire se un’altra entità condivide quella directory, e il .wasm compilato da cui viene caricata un’entità Plugin in una directory di catalogo. Ciascuno viene letto solo dall’interno della directory sotto cui è stato letto il documento dell’entità stessa: il workspace, una directory di catalogo che hai indicato fuori da esso, o la directory di un documento che hai indicato fuori da esso. Quindi uno che è un link che porta all’esterno arresta aggrega pin, aggrega push (dry run compreso), un pull che fissa i pin e il pin e la pubblicazione dell’editor e di un assistente — un documento lasciato non letto potrebbe essere l’entità d’intralcio — e arresta una build o un pull che carica il plugin anziché eseguire byte conservati altrove sulla macchina: E0321.
  • La cache degli artefatti — tutto ciò che Aggrega legge dalla cache sotto artifact_cache_dir: un’entità, un plugin o una libreria in cache e il manifest accanto, un archivio sorgente e i suoi metadati, un input esterno fissato, un bundle di firma e l’indice di ricerca locale di un registry, e ogni voce di workspace elencata da aggrega cache status, aggrega cache prune e aggrega cache clear. La cache viene letta solo dall’interno della directory della cache, il luogo in cui viene scritta, quindi qualsiasi cosa al suo interno che sia un link che porta fuori da quella directory — verso un altro punto del workspace come verso qualunque altro luogo — arresta una build, un pull, una convalida, una ricerca, ciascuno dei tre comandi della cache, e le richieste dell’editor e di un assistente che leggono la cache, anziché fornire loro byte conservati in un luogo che la cache non possiede — compreso il contenuto verificato rispetto a un digest registrato, poiché un digest dice che cosa sono i byte, non da dove possono essere letti. L’avviso di deprecazione che stampa aggrega inspect, che non decide nulla, è escluso. Un prune o un clear tratta una delle directory proprie della cache che sia un link del genere, o una directory della cache che sia essa stessa un link che porta fuori dal workspace, come la rimozione che sarebbe, con E0320, prima di elencare qualsiasi cosa: E0321.
  • Un repository che una sorgente scarica — il checkout che un pull archivia per una sorgente git-repository. Il checkout è una directory a sé, quindi un link contenuto nel repository viene archiviato come ciò a cui punta solo dove questo si trova all’interno del repository; uno che porta fuori da esso, che potrebbe raggiungere qualsiasi file sulla macchina che esegue il pull, arresta il pull indicando il link e dove porta, senza mettere nulla in cache — compreso module_subdir stesso, quando è un link del genere: E0321. Il checkout scompare quando il pull si arresta, quindi il messaggio indica il link con la sua posizione nel repository, e il repository e la revisione indicati dalla sorgente. Un module_subdir che, così come è scritto, risale sopra il repository viene rifiutato prima che il repository venga scaricato, quindi non viene letto nulla accanto al checkout: E0307.
  • I file di una directory che importi — aggrega import, lo strumento di importazione dell’assistente e aggrega/import della sessione, ricevuta una directory, ne leggono i file selezionati dai pattern di file dell’importer. La directory è una radice a sé ovunque si trovi — vedi Una directory che importi — quindi un collegamento tra quei file che conduce fuori da essa, o un collegamento a una directory che conduce fuori da essa, arresta l’importazione nominando il collegamento prima che venga letto qualsiasi file della directory: E0321.
  • La configurazione propria del workspace — ogni .aggrega-config.yaml dalla radice fino alla directory in cui viene eseguito un comando, e il .aggrega-config-append-ci.yaml di una pipeline accanto a ciascuno di essi. Ogni comando che legge la configurazione, il language server e gli strumenti di un assistente la leggono prima di ogni altra cosa, quindi uno di questi file che sia un collegamento che conduce fuori arresta ciascuno di essi lì, anziché lasciarli funzionare con una configurazione composta da ciò che resta: E0321. I comandi aggrega che non la leggono mai — version, help, completion, explain, get-schema, scaffold quando abbozza un documento iniziale, skills list, plugin run-local, plugin sync, auth token e logout — vengono eseguiti come di consueto, con un avviso che nomina il collegamento. scaffold --example la legge, per il registry predefinito e la politica di firma, e si arresta lì come ogni altro lettore. Il language server, e il server di un assistente che comunica tramite i propri stream, si avviano comunque su un workspace di questo tipo, affinché ciò che contiene possa essere elencato: gli elenchi di Release e di entità rispondono, letti senza alcuna directory di catalogo e nient’altro configurato, e nominano il file tra i collegamenti non letti. Ogni altra richiesta che la configurazione determina — una build, un’anteprima, un grafo, una validazione, un lint, una descrizione, la configurazione effettiva, la Release predefinita — si arresta con E0321 nominando il collegamento, e lo stesso fa il server di un assistente a cui si chiede di restare in ascolto su HTTP, il cui indirizzo e la cui autorizzazione sarebbero stati impostati dalla configurazione.
  • Ciò che un’operazione scrive o rimuove — la directory di output di una build, le sue directory di confine e ogni file scritto lì, la traccia; il lockfile di una Release e il registro di fiducia dei plugin accanto a esso; un entity.lock; il file di configurazione del workspace che un comando scrive; la cache degli artefatti e ogni sua parte che un pull riempie o che aggrega cache clear e aggrega cache prune svuotano; le bozze che un’importazione scrive e le entità Plugin che aggrega plugin gen-catalog scrive; e il marcatore .aggrega/active-release in cui un editor registra una Release predefinita, che il language server scrive per suo conto. Un dist che sia un collegamento trasformerebbe altrimenti «ricompila l’output» nell’eliminazione di una directory da qualche altra parte sulla macchina: E0320.
  • Ciò che un documento nomina tramite un percorso — vedi Un riferimento scritto da un documento: E0324.
  • Il contenuto che un’entità dichiara — un source: o un $import: il cui percorso passa attraverso una directory che è un collegamento che conduce fuori dalla directory propria dell’entità, e che una pubblicazione altrimenti porterebbe con sé sotto un nome interno all’entità: E0304.

Questi casi valgono chiunque abbia avviato l’operazione — la riga di comando, un editor o un assistente su uno qualsiasi dei due trasporti — perché il percorso appartiene al workspace e al prodotto, non a chi chiama.

Un riferimento scritto da un documento

Una Release e un Manifest possono nominare un altro file tramite un percorso: aggregate: e manifest: di una Release scritti come ./… o ../…, il suo extends:, l’extends: di un Manifest scritto come percorso, e parameters: { $import: … } di una Release. Un documento nel workspace raggiunge in questo modo solo file all’interno del workspace — un percorso che, così come è scritto, risale all’esterno viene rifiutato, e lo stesso vale per uno che, così come è scritto, resta all’interno ma lungo il cammino incontra un collegamento che conduce fuori. Non viene letto nulla dal file che l’uno o l’altro nomina.

Un workspace che hai clonato porta con sé i riferimenti del suo autore, quindi limitare ciò che nomini seguendo però qualunque cosa a cui un documento conduca lascerebbe il confine a un solo ../ di distanza. Dove un documento ha bisogno di un’entità conservata altrove, nomina l’entità anziché un file — aggregate: payments — e la configurazione del workspace elenca la directory di catalogo che la contiene. Un nome viene cercato, non seguito, quindi qui non viene mai rifiutato.

Una Release o un Manifest che si trova fuori dal workspace, ammesso perché lo hai nominato tu, raggiunge solo file nella propria directory — vedi Un’eccezione raggiunge la directory che nomina, e nulla oltre.

Le eccezioni, e perché ciascuna lo è

Un percorso in una di queste classi viene rispettato dove conduce, all’interno del workspace o meno. Ciascuna è una classe di percorsi anziché un elenco di luoghi, e ciascuna è un’eccezione per una ragione propria.

  • Ciò che la configurazione del workspace nomina. Le sue directory di catalogo — catalog_dirs e catalog_dirs_append, per il workspace o per una Release sotto workspace.releases — i file di Release indicati come chiavi sotto workspace.releases, build.authoring_release, il .wasm locale di un plugin associato e i file sotto il suo with.sources, mcp.tls.cert_file, mcp.tls.key_file, mcp.authorization.jwks_file, la radice di fiducia fissata di un registry, e un artifact_cache_dir che risale fuori dalla radice del workspace. Nominare un percorso nella configurazione è il modo deliberato in cui un workspace raggiunge l’esterno di sé: lo si scrive una volta, lo si conserva con il progetto e lo legge chiunque lo esamini. La directory catalog convenzionale del workspace conta come nominata quando la configurazione la elenca o la passi con --catalog — oppure quando la configurazione elenca, o tu passi, il luogo a cui conduce, in qualunque grafia, o una directory sopra quel luogo, che allora legge una sola volta ciò che vi si trova, attraverso la directory che hai nominato. Letta solo perché è lì, è contenuto proprio del workspace, quindi un catalog che sia un collegamento che conduce fuori dal workspace non viene letto finché non nomini esso o il luogo a cui conduce.
  • Un percorso che digiti sulla riga di comando. aggrega build --release ../other/release.yaml, --catalog /srv/shared-catalog, --output-dir, un file da validare, sottoporre a lint, fissare o pubblicare: ciascuno viene usato dove conduce — eccetto la modifica dei documenti, più sotto. La macchina su cui viene eseguito il comando è tua e puoi già leggere e scrivere qualsiasi cosa digiteresti, quindi vincolarti a una directory non porterebbe alcun vantaggio.
  • Un percorso che un assistente nomina tramite gli stream propri del processo. Un client che ha avviato aggrega mcp sulla tua macchina viene eseguito come te, e il suo host di solito gli fornisce strumenti propri per file e shell, quindi un percorso che nomina viene rispettato come se lo avessi digitato tu — vedi I due trasporti dell’assistente.
  • Gli archivi del prodotto a livello di macchina — il file di configurazione globale, l’archivio dei moduli compilati, la cache dei descrittori dei plugin, il pacchetto della documentazione e l’archivio delle credenziali dei registry. Appartengono alla macchina anziché a un workspace, quindi nessun workspace li contiene.
  • Un file o una directory scelti in una finestra di dialogo, letti dove si trovano. Un editor invia come percorso assoluto il file della chiave o la radice di fiducia della registrazione di un registry, la descrizione che aggrega/import converte — un file, o una directory i cui file vengono letti dall’importer — e il modulo per cui aggrega/pluginGenCatalog genera un’entità, con l’overlay accanto a esso. Ciascuno è stato scelto da una persona, ovunque lo conservi. Vengono solo letti: nulla di ciò che una richiesta scrive finisce in un percorso scelto in questo modo. Una directory scelta in questo modo è vincolata a sé stessa, come ogni directory che importi.
  • Un documento che il tuo editor tiene aperto. La sua validazione, la richiesta o l’eliminazione dei suoi diagnostici, l’hover, il completamento, la risoluzione e la ricerca di riferimenti e implementazioni al suo interno ricevono risposta dal contenuto inviato dall’editor, quindi nessun file viene letto al percorso che lo nomina, e il percorso non viene mai rifiutato per il luogo a cui conduce. Una richiesta che legge effettivamente il documento dal disco è del tipo rifiutato descritto sopra.

I percorsi digitati sulla riga di comando e gli archivi a livello di macchina non vengono mai valutati; gli altri vengono lasciati passare in base alla loro classe, mai in base alla richiesta che si trova a trasportarli.

Un’eccezione raggiunge la directory che nomina, e nulla oltre

Una directory che hai nominato fuori dal workspace è una radice a sé per tutto ciò che viene letto o scritto al suo interno. La directory stessa viene usata come l’hai nominata — una che sia un collegamento viene seguita fino a dove punta — e un collegamento al suo interno che conduce fuori da essa viene trattato esattamente come un collegamento all’interno del workspace: non letto in un elenco, e tale da arrestare una ricerca o una scrittura. Così una directory di catalogo che elenchi fuori dal workspace, una directory di output che passi ad aggrega plugin gen-catalog o ad aggrega import, e un artifact_cache_dir che risale fuori dal workspace vincolano ciascuno a sé stesso ciò che contengono. Dove una directory che hai nominato si trova all’interno del workspace, la radice è il workspace — eccetto una directory che importi, che è una radice a sé ovunque si trovi.

Una directory che nomini viene risolta rispetto alla cartella in cui esegui il comando prima che vi venga collocata qualsiasi cosa. Una directory di output che passi ad aggrega import, digitata come relativa, è la cartella con quel nome nella cartella in cui esegui il comando, e un’unità che nomini da sola su Windows — D: — è la cartella corrente su quell’unità. La directory viene prima trasformata in un percorso completo e ogni file viene collocato sotto quel percorso completo, così un file il cui nome inizia con un separatore, ad esempio \notes.txt, finisce all’interno della directory che hai nominato anziché alla radice dell’unità, e la directory che il comando riporta è quella in cui si è scritto.

Una Release o un Manifest che hai nominato fuori dal workspace è la stessa regola applicata a un file: la sua directory è la radice, quindi ciò che nomina tramite un percorso — e ciò che nomina ogni Release a cui conduce la sua catena extends: — deve restare all’interno di quella directory. Una Release conservata accanto al suo Aggregate e al suo Manifest si compila da qualsiasi posizione; una nella consueta struttura releases/, che nomina ../aggregates/app.yaml, si compila invece dal proprio workspace.

Una Release che nomini tramite un collegamento viene letta dove conduce il collegamento, e risolta dove l’hai nominata. Digitata come --release release.yaml, dove release.yaml è un collegamento a un file conservato altrove — o nominata così sotto workspace.releases, o come build.authoring_release — la Release viene letta dal luogo a cui conduce il collegamento. L’Aggregate e il Manifest che nomina, per identità o tramite un percorso, vengono cercati accanto al collegamento, nella directory in cui l’hai nominata, e vincolati alla radice di quella directory: il workspace, oppure la directory stessa dove si trova fuori dal workspace. Anche il suo lockfile viene letto e scritto accanto al collegamento, mai dove il collegamento conduce. La Release non è uno dei documenti che la sua stessa ricerca incontra accanto a sé, quindi non arresta mai quella ricerca; un’altra Release conservata accanto a essa che sia un collegamento che conduce fuori la arresta comunque. Un Manifest che ispezioni da solo tramite un collegamento viene letto e risolto allo stesso modo.

La directory della cache degli artefatti è una radice a sé, ovunque si trovi. Tutto ciò che la cache contiene viene scritto, letto e rimosso solo all’interno della directory della cache, quindi una delle directory proprie della cache, o un file in una di esse, che sia un collegamento che conduce fuori dalla directory della cache viene bloccato — anche dove conduce altrove all’interno del workspace — mentre uno che conduce altrove all’interno della directory della cache viene seguito. Dove si trovi la directory della cache stessa si ricava da come è scritto il suo valore. Scritta all’interno della radice del workspace — compresa la predefinita .aggrega/cache — è una directory propria del workspace: una directory della cache che sia un collegamento ad altro punto del workspace viene seguita, e una che conduce fuori dal workspace viene rifiutata, in lettura come in scrittura. Scritta risalendo all’esterno (../shared-cache), è una directory che la configurazione nomina, letta e scritta dove conduce.

Una directory che importi

Una directory che importi è una radice a sé, ovunque si trovi — all’interno del workspace come al di fuori, ed è in questo che si distingue da ogni altra directory che nomini all’interno del workspace. aggrega import, lo strumento di importazione dell’assistente e aggrega/import della sessione passano all’importer ogni file della directory con la sua posizione in quella directory, quindi ciò che gli passano viene letto solo dall’interno della directory. Ciò che viene valutato è ciò da cui l’importazione prenderebbe qualcosa: un collegamento a un file selezionato da un pattern dell’importer — di qualsiasi importer, dove il formato viene riconosciuto anziché nominato — e un collegamento a una directory, in cui non si entra mai. Uno di questi che conduca fuori dalla directory viene rifiutato prima che venga letto qualsiasi file, anche dove conduce altrove all’interno del workspace, mentre un collegamento selezionato a un file altrove all’interno della directory viene letto dove punta, con il nome proprio del collegamento. Un collegamento a un file che nessun pattern seleziona non viene né valutato né letto. La directory stessa viene usata come l’hai nominata; se è un collegamento, viene seguita fino a dove punta.

La modifica dei documenti resta all’interno

aggrega edit-document, la modifica dei documenti e il punto di inserimento del language server, e edit-document e insertion-point dell’assistente agiscono solo su un documento contenuto nel workspace. Un documento fuori dal workspace, così come è scritto o tramite un collegamento che conduce fuori da esso, viene rifiutato su ogni superficie senza che nulla venga letto o scritto — anche dove un percorso che nomini viene altrimenti rispettato.

I due trasporti dell’assistente

aggrega mcp offre gli stessi strumenti in due modi, e il confine differisce tra i due perché differisce chi chiama.

  • Tramite gli stream propri del processo, il client ha avviato il server sulla tua macchina, quindi una chiamata equivale a te che digiti sulla riga di comando: un argomento di percorso può essere assoluto e può trovarsi fuori dal workspace, una chiamata può nominare il proprio workspace_root e i propri catalog_dirs, e vengono offerti gli strumenti che eseguono un comando aggrega in un processo separato. Solo il percorso che una chiamata nomina viene rispettato così come è nominato. Ciò che l’operazione poi legge e scrive per proprio conto viene trattato come a un terminale: un elenco non legge attraverso un collegamento che conduce fuori, un riferimento scritto da un documento non esce dal workspace, e una scrittura non passa attraverso una directory di output o di cache collegata. Il contenuto del workspace può orientare ciò che un assistente chiede, quindi su un host in cui questi strumenti sono il suo unico accesso ai tuoi file, un documento in un workspace che hai clonato può comunque indurlo a nominare un percorso fuori dal workspace e a farlo leggere o scrivere; ciò che un assistente può fare senza chiedertelo prima è dove imposti quanto fa di sua iniziativa.
  • Tramite HTTP, chi chiama non possiede la macchina su cui viene eseguito il server. Il workspace è quello su cui il server è stato avviato e resta fisso per tutta la sua durata; ogni argomento di percorso è vincolato al suo interno, valutato come sopra; una chiamata che nomina workspace_root o catalog_dirs, o che seleziona una chiave di firma conservata sull’host, viene rifiutata; e gli strumenti che eseguono un comando aggrega non vengono offerti. Un rifiuto nomina l’argomento e cita un valore relativo così come è stato inviato, ma non nomina né la radice del workspace né il luogo a cui un percorso avrebbe condotto.

Quando qualcosa viene rifiutato o si arresta

Cosa vediCosa fare
Un elenco nomina un collegamento tra quelli che non ha lettoSostituisci il collegamento con una copia di ciò a cui conduce; oppure, per entità conservate altrove, elenca la directory a cui conduce il collegamento sotto catalog_dirs; per una Release conservata altrove, nominala sotto workspace.releases o come build.authoring_release.
E0321, una lettura attraverso un collegamento che esce da una directory di catalogo o dalla directory di una ReleaseElenca la directory a cui conduce il collegamento come directory di catalogo, o passala con --catalog, anziché raggiungerla attraverso un collegamento al di sotto di una di esse; oppure sostituisci il collegamento con una copia. Dove il collegamento è la directory convenzionale catalog stessa, elenca catalog o la directory a cui conduce, oppure passa l’una o l’altra con --catalog.
E0321 sul lockfile di una ReleaseRimuovi il collegamento ed esegui di nuovo il pull della Release, che scrive un lockfile nuovo accanto a essa. Un lockfile non ha altra collocazione.
E0321 su un file accanto a un’entitàSostituisci il collegamento con il file stesso: sposta un documento che è un’entità in una directory propria, e colloca il .wasm compilato accanto alla sua entità Plugin anziché un collegamento a esso.
E0321 su un file di configurazioneSostituisci il collegamento con una copia conservata nel workspace. Una configurazione condivisa tra workspace si legge indicandola come file di configurazione globale, con --config o AGGREGA_CONFIG, al di sotto dei file propri di ciascun workspace.
E0321 sulla cache degli artefattiRimuovi il collegamento; un pull riempie di nuovo la cache. Per tenere la cache altrove, imposta artifact_cache_dir su quella directory, scritta in modo relativo alla radice del workspace (../shared-cache), anziché collegarla.
E0321 su un collegamento in un repository recuperatoIl collegamento è committato nel repository indicato dalla sorgente — il messaggio lo nomina con la sua posizione lì: modificalo lì — fallo puntare all’interno del repository, oppure fai il commit del file stesso — e indica la revisione che contiene la modifica.
E0321 su un collegamento in una directory che importiTieni il file stesso nella directory anziché un collegamento a esso, oppure importa la directory a cui conduce il collegamento. Una directory che importi viene letta solo dal suo interno, ovunque si trovi.
E0307 su un module_subdirIndica una directory all’interno del repository: il valore può scendere al di sotto della radice del repository ma non può risalire al di sopra di essa.
E0320, una scrittura o una rimozione attraverso un collegamentoRimuovi il collegamento che il messaggio nomina, oppure fallo condurre in un punto all’interno della directory che il messaggio nomina, ed esegui di nuovo l’operazione. Nulla nei tuoi file di entità ne è la causa.
E0324, un riferimento che porta all’esternoIndica un Aggregate conservato altrove con il suo metadata.name ed elenca la sua directory di catalogo; tieni un Manifest, una Release nominata da un extends: e un file di parametri all’interno del workspace — oppure, per un documento che hai nominato dall’esterno, nella sua directory; oppure apri il workspace in una directory che contenga entrambi i documenti.
E0304, contenuto attraverso un collegamentoSostituisci il collegamento con una copia di ciò a cui conduce, all’interno della directory dell’entità stessa.
Una richiesta al language server rifiutata per un percorso che porta all’esternoInvia un percorso all’interno del workspace, relativo alla sua radice. Una Release conservata fuori dal workspace si raggiunge nominandola nella configurazione, sotto workspace.releases o come build.authoring_release, e nominando nella richiesta il collegamento all’interno del workspace che vi conduce — la posizione in cui l’elenco delle Release la offre.
Una chiamata di un assistente su HTTP rifiutata per un percorsoInvia un percorso relativo alla radice del workspace servito dal server; dove il rifiuto offre la forma relativa di un percorso assoluto, invia quella.
Una modifica a un documento rifiutataModifica un documento contenuto nel workspace; un collegamento a un documento che si trova altrove non viene seguito per la modifica.

Vedi anche

  • Configurazione — dove si scrive ciascuna delle impostazioni sopra, e come si risolve un percorso relativo al suo interno.
  • aggrega serve e aggrega mcp — ogni richiesta e strumento, e quali dei suoi parametri nominano un percorso.
  • Arresti fatali — la voce completa per ciascuna condizione sopra.