Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

El límite del workspace

Un workspace es el árbol de directorios que marca la raíz de un proyecto — la raíz en la que está el bloque workspace: de tu configuración, la que indica --workspace-root, la carpeta que abrió un editor o aquella sobre la que se inició el servidor de un asistente. Todo lo que Aggrega lee y escribe por su propia cuenta queda sujeto a ese árbol, salvo donde tú, o la configuración del workspace, indiquen un lugar fuera de él. Un enlace simbólico dentro de él puede apuntar a cualquier lugar de la máquina, así que un enlace nunca se considera parte del workspace solo porque esté ahí: lo que cuenta es adónde lleva.

Esta página expone la regla completa. Las páginas de cada superficie — la línea de comandos, el servidor de lenguaje y las herramientas del asistente — explican cómo se enfrentan a ella sus propias solicitudes.

Qué queda dentro del workspace

Una ruta está dentro del workspace cuando su parte existente más profunda, con los enlaces seguidos, es la raíz del workspace o está debajo de ella — con los enlaces de la propia raíz seguidos de la misma manera, así que un workspace al que llegas a través de un enlace propio sigue conteniendo todo lo que hay debajo.

Una raíz que abres a través de un enlace es el workspace al que lleva el enlace. Tanto si la carpeta que abres es en sí misma un enlace como si se llega a ella a través de uno situado más arriba, Aggrega enumera, lee y escribe exactamente lo que haría en el workspace al que lleva el enlace — sus Releases, sus documentos, sus lockfiles — y juzga de la misma manera cada enlace que hay dentro. Cada ruta de una respuesta se sigue escribiendo a partir de la raíz tal como se dio — la carpeta que abrió un editor, el --workspace-root que escribiste, el directorio en el que tu shell dice que estás trabajando —, así que lo que se te muestra coincide con las rutas con las que trabajas.

Esa única lectura cubre todo tipo de ruta:

  • Lo que decide es adónde lleva una ruta, no cómo está escrita. ./shared/app.yaml está fuera cuando shared es un enlace a un directorio situado en otro lugar, aunque cada una de sus partes esté escrita dentro del workspace. Un parámetro de solicitud puede, aun así, exigir una escritura propia — una ruta relativa a la raíz, por ejemplo — y su propia página lo indica; esa es una regla sobre el parámetro, no sobre el límite.
  • Una ruta que aún no existe se juzga por los directorios del camino hacia ella. Un archivo que una compilación está a punto de crear bajo un dist que es un enlace que lleva fuera está fuera antes de escribirse.
  • Un enlace que no lleva a ninguna parte, o que da vueltas en un bucle, no es algo que exista. En su lugar se juzga el directorio que lo contiene, y no se sigue nada para averiguar adónde debía llevar el enlace. Donde un enlace así está exactamente donde se va a crear un archivo, también se comprueba el lugar al que apunta, ya que es allí donde acabaría el archivo.
  • Un enlace a otro lugar dentro del workspace se sigue como de costumbre. Solo se retiene un enlace que lleva fuera.

La regla juzga adónde lleva una ruta en el disco y nada más. No lee ningún valor y no infiere nada de un nombre.

Lo que ocurre con una ruta que lleva al exterior depende del tipo de ruta. Hay tres resultados.

Listado como no leído

Donde Aggrega enumera lo que contiene el workspace, un enlace que lleva al exterior no se lee, y el listado lo indica. Las Releases que un editor ofrece para elegir, el índice de entidades y las compleciones y candidatos que un editor extrae de él, y list-releases y list-entities de un asistente no buscan en un directorio fuera del workspace ni leen un archivo fuera de él, declare lo que declare ese archivo — así que una entidad que tu editor muestra bajo un enlace así no se lista como propia del workspace. Los listados de Release y los listados de entidades nombran cada uno de esos enlaces por su propio lugar en el workspace, nunca por adónde lleva: unreadLinkedDirs y unreadLinkedFiles en el servidor de lenguaje, unread_linked_dirs y unread_linked_files en las herramientas del asistente. Un enlace a un directorio que tu configuración enumera en catalog_dirs, o a un directorio que está debajo de uno de ellos, o a una Release que nombra, no se nombra: la configuración ha llegado a ese lugar — un directorio enumerado se lee con todo lo que hay debajo — como describen las excepciones más abajo. Tampoco se lee un .gitignore que sea un enlace que lleva al exterior, así que un archivo de otra parte de la máquina nunca decide en cuáles de los documentos del workspace se busca. Un archivo de configuración del workspace que sea un enlace que lleva al exterior también se nombra entre los archivos no leídos: estos listados siguen respondiendo para ese workspace, leído sin nada configurado, mientras que toda solicitud que decide la configuración se detiene, como describe la configuración propia del workspace más abajo.

Rechazado

Una ruta que nombra una solicitud, cuando quien llama no es el propietario de la máquina que la teclea, se rechaza. Salvo las excepciones más abajo, toda ruta que una solicitud de un editor a aggrega serve nombra para que el servidor la lea o la escriba, y toda ruta que un asistente nombra a un servidor al que se llega por HTTP, tiene que llevar al interior del workspace; una que lleva al exterior se rechaza sin leer ni escribir nada, y el rechazo nombra el parámetro, como expone la página de cada superficie. La edición del documento se rechaza de esta forma en todas las superficies, incluida la línea de comandos — consulta La edición del documento se queda dentro.

Detenido

Cuando una operación leería o escribiría por su cuenta a través de un enlace que lleva al exterior, se detiene. Son las rutas que el producto determina por sí mismo en lugar de rutas que tú has nombrado, y pasar una por alto en silencio podría cambiar lo que significa una compilación, así que cada una detiene la operación, nombra el enlace y adónde lleva, y deja el lugar al que apunta el enlace exactamente como estaba:

  • Lo que lee una búsqueda — un documento bajo un directorio de catálogo, o junto a una Release que nombra su Aggregate o su Manifest por identidad, o junto a un Manifest que nombra de esa forma el Manifest que extiende. La Release o el Manifest que se nombró a la operación no está entre esos documentos: se leyó donde se nombró — consulta Una Release o un Manifest nombrado a través de un enlace. Una búsqueda que se saltara un enlace así podría resolver en su lugar otra entidad con el mismo nombre de un directorio posterior, así que una compilación, un pull, una validación, una inspección que lee el catálogo, un lint de una sola Release o del catálogo entero, y las solicitudes del editor y de un asistente que compilan, previsualizan, representan como grafo, validan, pasan el lint o describen una Release se detienen todas antes de que se resuelva o compruebe nada: E0321.
  • El lockfile de una Release — se lee junto a la Release para los pines con los que se resuelven una compilación, un pull, una validación, un lint, una inspección, aggrega cache prune y las solicitudes del editor y de un asistente. Está sujeto a la regla donde se lee exactamente igual que donde se escribe, así que un lockfile que sea un enlace que lleva al exterior detiene a cada uno de ellos en lugar de prestarles pines guardados en otra parte de la máquina: E0321.
  • Un archivo leído junto a una entidad — los demás documentos del directorio de una entidad que fijas o publicas, leídos para saber si otra entidad comparte ese directorio, y el .wasm compilado desde el que se carga una entidad Plugin en un directorio de catálogo. Cada uno se lee solo desde dentro del directorio bajo el que se leyó el propio documento de la entidad: el workspace, un directorio de catálogo que nombraste fuera de él, o el directorio de un documento que nombraste fuera de él. Así que uno que sea un enlace que lleva al exterior detiene aggrega pin, aggrega push (incluida una ejecución de prueba), un pull que fija y la fijación y la publicación del editor y de un asistente — un documento sin leer podría ser la entidad que estorba — y detiene una compilación o un pull que carga el plugin en lugar de ejecutar bytes guardados en otra parte de la máquina: E0321.
  • La caché de artefactos — todo lo que Aggrega lee de la caché bajo artifact_cache_dir: una entidad, un plugin o una biblioteca en caché y el manifiesto que la acompaña, un archivo de origen y sus metadatos, una entrada externa fijada, un paquete de firma y el índice de búsqueda local de un registro, y toda entrada de workspace que enumeran aggrega cache status, aggrega cache prune y aggrega cache clear. La caché solo se lee desde dentro del directorio de caché, el lugar en el que se escribe, así que cualquier cosa en ella que sea un enlace que lleva fuera de ese directorio — a otra parte del workspace igual que a cualquier otro lugar — detiene una compilación, un pull, una validación, una búsqueda, cada uno de los tres comandos de caché, y las solicitudes del editor y de un asistente que leen la caché, en lugar de entregarles bytes guardados en un lugar que no pertenece a la caché — incluido el contenido comprobado frente a un digest registrado, ya que un digest dice qué son los bytes, no desde dónde pueden leerse. El aviso de obsolescencia que imprime aggrega inspect, que no decide nada, queda fuera. Un prune o un clear trata uno de los propios directorios de la caché que sea un enlace así, o un directorio de caché que sea a su vez un enlace que lleva fuera del workspace, como la eliminación que sería, con E0320, antes de enumerar nada: E0321.
  • Un repositorio que obtiene una fuente — el checkout que un pull archiva para una fuente git-repository. El checkout es un directorio propio, así que un enlace que contiene el repositorio se archiva como aquello a lo que apunta solo cuando eso está dentro del repositorio; uno que lleva fuera de él, que podría alcanzar cualquier archivo de la máquina que ejecuta el pull, detiene el pull nombrando el enlace y adónde lleva, sin guardar nada en caché — incluido el propio module_subdir, cuando es un enlace así: E0321. El checkout desaparece en cuanto el pull se detiene, así que el mensaje nombra el enlace por su lugar en el repositorio, y el repositorio y la revisión que nombra la fuente. Un module_subdir que, tal como está escrito, sube por encima del repositorio se rechaza antes de obtener el repositorio, así que no se lee nada junto al checkout: E0307.
  • Los archivos de un directorio que importas — aggrega import, la herramienta de importación del asistente y aggrega/import de la sesión, al recibir un directorio, leen los archivos de este que seleccionan los patrones de archivo del importador. El directorio es una raíz propia dondequiera que esté — consulta Un directorio que importas — por lo que un enlace entre esos archivos que conduce fuera de él, o un enlace a un directorio que conduce fuera de él, detiene la importación nombrando el enlace antes de que se lea ningún archivo del directorio: E0321.
  • La configuración propia del espacio de trabajo — cada .aggrega-config.yaml desde la raíz hasta el directorio en el que se ejecuta un comando, y el .aggrega-config-append-ci.yaml de un pipeline junto a cualquiera de ellos. Cada comando que lee la configuración, el servidor de lenguaje y las herramientas de un asistente la leen antes que cualquier otra cosa, por lo que uno de estos archivos que sea un enlace que conduce fuera detiene a cada uno de ellos ahí, en lugar de dejarlos ejecutarse con una configuración formada por lo que quedara: E0321. Los comandos de aggrega que nunca la leen — version, help, completion, explain, get-schema, scaffold al redactar un documento inicial, skills list, plugin run-local, plugin sync, auth token y logout — se ejecutan como de costumbre, con una advertencia que nombra el enlace. scaffold --example la lee, para el registro predeterminado y la política de firmas, y se detiene ahí como cualquier otro lector. El servidor de lenguaje, y el servidor de un asistente que se comunica por sus propios flujos, se inician igualmente sobre un espacio de trabajo así, para que se pueda listar lo que contiene: los listados de Release y de entidades responden, leídos sin ningún directorio de catálogo ni nada más configurado, y nombran el archivo entre los enlaces no leídos. Cualquier otra solicitud que la configuración determina — una compilación, una vista previa, un grafo, una validación, un lint, una descripción, la configuración efectiva, la Release predeterminada — se detiene con E0321 nombrando el enlace, y lo mismo hace el servidor de un asistente al que se le pide escuchar por HTTP, cuya dirección y autorización habría establecido la configuración.
  • Lo que una operación escribe o elimina — el directorio de salida de una compilación, sus directorios de frontera y cada archivo escrito allí, la traza; el lockfile de una Release y el registro de confianza de plugins junto a él; un entity.lock; el archivo de configuración del espacio de trabajo que escribe un comando; la caché de artefactos y cada parte de ella que un pull llena o que aggrega cache clear y aggrega cache prune vacían; los borradores que escribe una importación y las entidades Plugin que escribe aggrega plugin gen-catalog; y el marcador .aggrega/active-release en el que un editor registra una Release predeterminada, que el servidor de lenguaje escribe por él. Un dist que fuera un enlace convertiría de otro modo «recompilar la salida» en eliminar un directorio en otro lugar de la máquina: E0320.
  • Lo que un documento nombra mediante una ruta — consulta Una referencia que escribe un documento: E0324.
  • El contenido que declara una entidad — un source: o un $import: cuya ruta pasa por un directorio que es un enlace que conduce fuera del directorio propio de la entidad, y que una publicación llevaría de otro modo bajo un nombre dentro de la entidad: E0304.

Esto se aplica sin importar quién haya iniciado la operación — la línea de comandos, un editor o un asistente en cualquiera de los dos transportes — porque la ruta pertenece al espacio de trabajo y al producto, no a quien llama.

Una referencia que escribe un documento

Una Release y un Manifest pueden nombrar otro archivo mediante una ruta: los aggregate: y manifest: de una Release escritos como ./… o ../…, su extends:, el extends: de un Manifest escrito como ruta y el parameters: { $import: … } de una Release. Un documento del espacio de trabajo solo alcanza de este modo archivos dentro del espacio de trabajo — se rechaza una ruta que, tal como está escrita, sale hacia arriba, y también una que, tal como está escrita, permanece dentro pero encuentra por el camino un enlace que conduce fuera. No se lee nada del archivo que nombra cualquiera de ellos.

Un espacio de trabajo que has clonado lleva las referencias de su autor, así que restringir lo que nombras mientras se sigue cualquier cosa a la que luego conduzca un documento dejaría la frontera a un solo ../ de distancia. Cuando un documento necesita una entidad guardada en otro lugar, nombra la entidad en lugar de un archivo — aggregate: payments — y la configuración del espacio de trabajo lista el directorio de catálogo que la contiene. Un nombre se busca, no se sigue, así que aquí nunca se rechaza.

Una Release o un Manifest que se encuentra fuera del espacio de trabajo, admitido porque lo nombraste, solo alcanza archivos de su propio directorio — consulta Una excepción alcanza el directorio que nombra, y nada más allá.

Las excepciones, y por qué cada una lo es

Una ruta de una de estas clases se respeta allí adonde conduce, dentro del espacio de trabajo o no. Cada una es una clase de ruta y no una lista de lugares, y cada una es una excepción por una razón propia.

  • Lo que nombra la configuración del espacio de trabajo. Sus directorios de catálogo — catalog_dirs y catalog_dirs_append, para el espacio de trabajo o para una Release bajo workspace.releases — los archivos de Release registrados como claves bajo workspace.releases, build.authoring_release, el .wasm local de un plugin adjunto y los archivos bajo su with.sources, mcp.tls.cert_file, mcp.tls.key_file, mcp.authorization.jwks_file, la raíz de confianza fijada de un registro y un artifact_cache_dir que sale por encima de la raíz del espacio de trabajo. Nombrar una ruta en la configuración es la manera deliberada en que un espacio de trabajo llega fuera de sí mismo: se escribe una vez, se guarda con el proyecto y lo lee cualquiera que lo revise. El directorio catalog convencional del espacio de trabajo cuenta como nombrado cuando la configuración lo lista o lo pasas con --catalog — o cuando la configuración lista, o tú pasas, el lugar al que conduce, con cualquier grafía, o un directorio por encima de ese lugar, que entonces lee una sola vez lo que hay allí, a través del directorio que nombraste. Leído solo porque está ahí, es contenido propio del espacio de trabajo, así que un catalog que sea un enlace que conduce fuera del espacio de trabajo no se lee hasta que lo nombras a él o el lugar al que conduce.
  • Una ruta que escribes en la línea de comandos. aggrega build --release ../other/release.yaml, --catalog /srv/shared-catalog, --output-dir, un archivo para validar, pasar por lint, fijar o publicar: cada uno se usa allí adonde conduce — salvo la edición de documentos, más abajo. Eres dueño de la máquina en la que se ejecuta el comando y ya puedes leer y escribir cualquier cosa que escribirías, así que restringirte a un directorio no aportaría nada.
  • Una ruta que un asistente nombra por los flujos propios del proceso. Un cliente que inició aggrega mcp en tu máquina se ejecuta como tú, y su host suele darle herramientas propias de archivos y de shell, así que una ruta que nombra se respeta como si la hubieras escrito tú — consulta Los dos transportes del asistente.
  • Los almacenes del producto a nivel de máquina — el archivo de configuración global, el almacén de módulos compilados, la caché de descriptores de plugins, el paquete de documentación y el almacén de credenciales de registro. Pertenecen a la máquina y no a un espacio de trabajo, así que ningún espacio de trabajo los contiene.
  • Un archivo o un directorio elegido en un cuadro de diálogo, leído donde está. Un editor envía como ruta absoluta el archivo de clave o la raíz de confianza de la inscripción de un registro, la descripción que convierte aggrega/import — un archivo, o un directorio cuyos archivos lee el importador — y el módulo para el que aggrega/pluginGenCatalog genera una entidad, con el overlay junto a él. Una persona eligió cada uno, dondequiera que lo guarde. Solo se leen: nada de lo que escribe una solicitud va a una ruta elegida de este modo. Un directorio elegido de este modo queda limitado a sí mismo, como todo directorio que importas.
  • Un documento que tu editor mantiene abierto. Su validación, la solicitud o el descarte de sus diagnósticos, el hover, el completado, la resolución y la búsqueda de referencias e implementaciones en él se responden a partir del contenido que envió el editor, así que no se lee ningún archivo en la ruta que lo nombra, y la ruta nunca se rechaza por el lugar al que conduce. Una solicitud que sí lee el documento del disco es del tipo rechazado descrito arriba.

Las rutas escritas en la línea de comandos y los almacenes a nivel de máquina nunca se evalúan; los demás se dejan pasar por su clase, nunca por la solicitud que los lleve.

Una excepción alcanza el directorio que nombra, y nada más allá

Un directorio que nombraste fuera del espacio de trabajo es una raíz propia para todo lo que se lee o escribe bajo él. El directorio en sí se usa tal como lo nombraste — si es un enlace, se sigue hasta donde apunta — y un enlace bajo él que conduce fuera de él se trata exactamente igual que un enlace dentro del espacio de trabajo: no se lee en un listado y detiene una búsqueda o una escritura. Así, un directorio de catálogo que listas fuera del espacio de trabajo, un directorio de salida que pasas a aggrega plugin gen-catalog o a aggrega import, y un artifact_cache_dir que sale fuera del espacio de trabajo retienen cada uno para sí lo que hay bajo ellos. Cuando un directorio que nombraste está dentro del espacio de trabajo, la raíz es el espacio de trabajo — salvo un directorio que importas, que es una raíz propia dondequiera que esté.

Un directorio que nombras se resuelve respecto a la carpeta en la que ejecutas el comando antes de colocar nada bajo él. Un directorio de salida que pasas a aggrega import, escrito como relativo, es la carpeta con ese nombre dentro de la carpeta en la que ejecutas el comando, y una unidad que nombras sola en Windows — D: — es la carpeta actual de esa unidad. Primero el directorio se convierte en una ruta completa y cada archivo se coloca bajo esa ruta completa, así que un archivo cuyo nombre empieza con un separador, por ejemplo \notes.txt, queda dentro del directorio que nombraste y no en la raíz de la unidad, y el directorio que informa el comando es aquel en el que se escribió.

Una Release o un Manifest que nombraste fuera del espacio de trabajo es la misma regla aplicada a un archivo: su propio directorio es la raíz, así que lo que nombra mediante una ruta — y lo que nombra cada Release a la que conduce su cadena extends: — debe permanecer dentro de ese directorio. Una Release guardada junto a su Aggregate y su Manifest se compila desde cualquier lugar; una en la disposición habitual releases/, que nombra ../aggregates/app.yaml, se compila en cambio desde su propio espacio de trabajo.

Una Release que nombras mediante un enlace se lee donde conduce el enlace y se resuelve donde la nombraste. Escrita como --release release.yaml, donde release.yaml es un enlace a un archivo guardado en otro lugar — o nombrada así bajo workspace.releases, o como build.authoring_release — la Release se lee del lugar al que conduce el enlace. El Aggregate y el Manifest que nombra, por identidad o mediante una ruta, se buscan junto al enlace, en el directorio en el que la nombraste, y quedan limitados a la raíz de ese directorio: el espacio de trabajo, o el propio directorio cuando está fuera del espacio de trabajo. Su lockfile también se lee y escribe junto al enlace, nunca donde conduce el enlace. La Release no es uno de los documentos que su propia búsqueda encuentra junto a ella, así que nunca detiene esa búsqueda; otra Release guardada junto a ella que sea un enlace que conduce fuera sí la detiene. Un Manifest que inspeccionas por sí solo mediante un enlace se lee y se resuelve de la misma manera.

El directorio de la caché de artefactos es una raíz propia, dondequiera que esté. Todo lo que contiene la caché se escribe, se lee y se elimina solo dentro del directorio de la caché, así que uno de los directorios propios de la caché, o un archivo dentro de uno, que sea un enlace que conduce fuera del directorio de la caché queda retenido — incluso cuando conduce a otro lugar dentro del espacio de trabajo — mientras que uno que conduce a otro lugar dentro del directorio de la caché se sigue. Dónde está el propio directorio de la caché se deduce de cómo está escrito su valor. Escrito dentro de la raíz del espacio de trabajo — incluido el predeterminado .aggrega/cache — es un directorio propio del espacio de trabajo: un directorio de caché que sea un enlace a otro lugar dentro del espacio de trabajo se sigue, y uno que conduce fuera del espacio de trabajo se rechaza, tanto para leer como para escribir. Escrito saliendo hacia arriba (../shared-cache), es un directorio que nombra la configuración, leído y escrito allí adonde conduce.

Un directorio que importas

Un directorio que importas es una raíz propia, dondequiera que esté — dentro del espacio de trabajo igual que fuera de él, y en eso se diferencia de cualquier otro directorio que nombras dentro del espacio de trabajo. aggrega import, la herramienta de importación del asistente y aggrega/import de la sesión entregan al importador cada archivo del directorio bajo su lugar en ese directorio, así que lo que le entregan se lee solo desde dentro del directorio. Lo que se evalúa es aquello de lo que la importación tomaría algo: un enlace a un archivo que selecciona un patrón del importador — de cualquier importador, cuando el formato se reconoce en lugar de nombrarse — y un enlace a un directorio, en el que nunca se entra. Uno de ellos que conduce fuera del directorio se rechaza antes de leer ningún archivo, incluso cuando conduce a otro lugar dentro del espacio de trabajo, mientras que un enlace seleccionado a un archivo en otro lugar dentro del directorio se lee donde apunta, con el nombre propio del enlace. Un enlace a un archivo que ningún patrón selecciona no se evalúa ni se lee. El directorio en sí se usa tal como lo nombraste; si es un enlace, se sigue hasta donde apunta.

La edición de documentos permanece dentro

aggrega edit-document, la edición de documentos y el punto de inserción del servidor de lenguaje, y edit-document e insertion-point del asistente actúan solo sobre un documento que contiene el espacio de trabajo. Un documento fuera del espacio de trabajo, tal como está escrito o mediante un enlace que conduce fuera de él, se rechaza en todas las superficies sin leer ni escribir nada — incluso donde una ruta que nombras se respeta en otros casos.

Los dos transportes del asistente

aggrega mcp sirve las mismas herramientas de dos maneras, y la frontera difiere entre ellas porque difiere quien llama.

  • Por los flujos propios del proceso, el cliente inició el servidor en tu máquina, así que una llamada equivale a que tú escribas en la línea de comandos: un argumento de ruta puede ser absoluto y puede estar fuera del espacio de trabajo, una llamada puede nombrar su propio workspace_root y sus propios catalog_dirs, y se ofrecen las herramientas que ejecutan un comando aggrega en un proceso separado. Solo la ruta que nombra una llamada se respeta tal como se nombra. Lo que la operación lee y escribe luego por su cuenta se trata como en una terminal: un listado no lee a través de un enlace que conduce fuera, una referencia que escribe un documento no sale del espacio de trabajo y una escritura no pasa por un directorio de salida o de caché enlazado. El contenido del espacio de trabajo puede orientar lo que pide un asistente, así que en un host donde estas herramientas son su único acceso a tus archivos, un documento de un espacio de trabajo que clonaste puede igualmente llevarlo a nombrar una ruta fuera del espacio de trabajo y hacer que se lea o se escriba; lo que un asistente puede hacer sin preguntarte antes es donde estableces cuánto hace por iniciativa propia.
  • Por HTTP, quien llama no es dueño de la máquina en la que se ejecuta el servidor. El espacio de trabajo es aquel sobre el que se inició el servidor y queda fijo durante toda su vida; cada argumento de ruta se mantiene dentro de él, evaluado como arriba; una llamada que nombra workspace_root o catalog_dirs, o que selecciona una clave de firma guardada en el host, se rechaza; y no se ofrecen las herramientas que ejecutan un comando aggrega. Un rechazo nombra el argumento y cita un valor relativo tal como se envió, pero no nombra ni la raíz del espacio de trabajo ni el lugar al que habría conducido una ruta.

Cuando algo se rechaza o se detiene

Lo que vesQué hacer
Un listado nombra un enlace entre los que no leyóSustituye el enlace por una copia de aquello a lo que conduce; o, para entidades guardadas en otro lugar, enumera el directorio al que conduce el enlace en catalog_dirs; para una Release guardada en otro lugar, nómbrala en workspace.releases o como build.authoring_release.
E0321, una lectura a través de un enlace que sale de un directorio de catálogo o del directorio de una ReleaseEnumera el directorio al que conduce el enlace como directorio de catálogo, o pásalo con --catalog, en lugar de llegar a él a través de un enlace situado debajo de uno; o sustituye el enlace por una copia. Cuando el enlace es el propio catalog convencional, enumera catalog o el directorio al que conduce, o pasa cualquiera de los dos con --catalog.
E0321 en el archivo de bloqueo de una ReleaseElimina el enlace y vuelve a hacer el pull de la Release, que escribe un archivo de bloqueo nuevo junto a ella. Un archivo de bloqueo no tiene otro lugar.
E0321 en un archivo junto a una entidadSustituye el enlace por el propio archivo: mueve un documento que es una entidad a un directorio propio, y coloca el .wasm compilado junto a su entidad Plugin en lugar de un enlace a él.
E0321 en un archivo de configuraciónSustituye el enlace por una copia guardada en el espacio de trabajo. Una configuración compartida entre espacios de trabajo se lee nombrándola como archivo de configuración global, con --config o AGGREGA_CONFIG, por debajo de los archivos propios de cada espacio de trabajo.
E0321 en la caché de artefactosElimina el enlace; un pull vuelve a llenar la caché. Para mantener la caché en otro lugar, establece artifact_cache_dir en ese directorio, escrito de forma relativa a la raíz del espacio de trabajo (../shared-cache), en lugar de enlazarla.
E0321 en un enlace de un repositorio obtenidoEl enlace está confirmado en el repositorio que nombra el origen — el mensaje lo nombra por su ubicación allí: cámbialo allí — haz que apunte dentro del repositorio, o confirma el propio archivo — y nombra la revisión que contiene el cambio.
E0321 en un enlace de un directorio que importasMantén el propio archivo en el directorio en lugar de un enlace a él, o importa el directorio al que conduce el enlace. Un directorio que importas solo se lee desde su propio interior, dondequiera que se encuentre.
E0307 en un module_subdirNombra un directorio dentro del repositorio: el valor puede descender por debajo de la raíz del repositorio, pero no puede subir por encima de ella.
E0320, una escritura o eliminación a través de un enlaceElimina el enlace que nombra el mensaje, o haz que conduzca a algún lugar dentro del directorio que nombra el mensaje, y vuelve a ejecutar la operación. Nada en tus archivos de entidad lo provoca.
E0324, una referencia que conduce hacia fueraNombra un Aggregate guardado en otro lugar por su metadata.name y enumera su directorio de catálogo; mantén un Manifest, una Release que nombra un extends: y un archivo de parámetros dentro del espacio de trabajo — o, para un documento que nombraste desde fuera, en su propio directorio; o abre el espacio de trabajo en un directorio que contenga ambos documentos.
E0304, contenido a través de un enlaceSustituye el enlace por una copia de aquello a lo que conduce, dentro del propio directorio de la entidad.
Una solicitud del servidor de lenguaje rechazada por una ruta que conduce hacia fueraEnvía una ruta dentro del espacio de trabajo, relativa a su raíz. A una Release guardada fuera del espacio de trabajo se llega nombrándola en la configuración, en workspace.releases o como build.authoring_release, y nombrando en la solicitud el enlace dentro del espacio de trabajo que conduce a ella — el lugar en el que el listado de Release la ofrece.
Una llamada de un asistente por HTTP rechazada por una rutaEnvía una ruta relativa a la raíz del espacio de trabajo que sirve el servidor; cuando el rechazo ofrece la forma relativa de una ruta absoluta, envía esa.
Una edición de documento rechazadaEdita un documento que contiene el espacio de trabajo; un enlace a un documento situado en otro lugar no se sigue para editar.

Véase también

  • Configuración — dónde se escribe cada uno de los ajustes anteriores y cómo se resuelve una ruta relativa que contengan.
  • aggrega serve y aggrega mcp — cada solicitud y herramienta, y cuáles de sus parámetros nombran una ruta.
  • Detenciones fatales — la entrada completa de cada condición anterior.