O limite do espaço de trabalho
Um espaço de trabalho é a árvore de diretórios que uma raiz de projeto marca — a raiz em que está o bloco workspace: da sua configuração, aquela que --workspace-root nomeia, a pasta que um editor abriu ou aquela sobre a qual o servidor de um assistente foi iniciado. Tudo o que Aggrega lê e escreve por conta própria está confinado a essa árvore, exceto onde o utilizador, ou a configuração do espaço de trabalho, nomeia um local fora dela. Uma ligação simbólica dentro dela pode apontar para qualquer lugar da máquina, pelo que uma ligação nunca é considerada parte do espaço de trabalho só por estar lá: o que conta é para onde conduz.
Esta página enuncia a regra completa. As páginas de cada superfície — a linha de comandos, o servidor de linguagem e as ferramentas do assistente — dizem como os seus próprios pedidos a cumprem.
O que está dentro do espaço de trabalho
Um caminho está dentro do espaço de trabalho quando a parte mais profunda dele que existe, com as suas ligações seguidas, é a raiz do espaço de trabalho ou está por baixo dela — com as ligações da própria raiz seguidas da mesma forma, pelo que um espaço de trabalho a que se chega através de uma ligação própria continua a conter tudo o que está por baixo dele.
Uma raiz que abre através de uma ligação é o espaço de trabalho para onde a ligação conduz. Quer a pasta que abre seja ela própria uma ligação, quer seja alcançada através de uma acima dela, Aggrega lista, lê e escreve exatamente o que faria no espaço de trabalho para onde a ligação conduz — as suas Releases, os seus documentos, os seus lockfiles — e julga todas as ligações dentro dele da mesma forma. Todos os caminhos de uma resposta continuam a ser escritos a partir da raiz tal como foi dada — a pasta que um editor abriu, o --workspace-root que escreveu, o diretório em que a sua shell diz que está a trabalhar —, para que o que lhe é mostrado corresponda aos caminhos com que está a trabalhar.
Essa única leitura abrange todos os tipos de caminho:
- É para onde um caminho conduz que decide, não a forma como está escrito.
./shared/app.yamlestá fora quandosharedé uma ligação para um diretório noutro lugar, embora todas as suas partes estejam escritas dentro do espaço de trabalho. Um parâmetro de pedido pode ainda assim pedir uma grafia própria — um caminho relativo à raiz, por exemplo — e a sua própria página di-lo; essa é uma regra sobre o parâmetro, não sobre o limite. - Um caminho que ainda não existe é julgado pelos diretórios que levam até ele. Um ficheiro que uma compilação está prestes a criar sob um
distque é uma ligação que conduz para fora está fora antes de ser escrito. - Uma ligação que não conduz a lado nenhum, ou que anda em círculo, não é algo que exista. É julgado antes o diretório que a contém, e nada é seguido para descobrir para onde a ligação devia ir. Quando uma ligação destas está exatamente onde um ficheiro está prestes a ser criado, o local para onde aponta também é verificado, uma vez que é aí que o ficheiro iria parar.
- Uma ligação para outro lugar dentro do espaço de trabalho é seguida normalmente. Só uma ligação que conduz para fora é retida.
A regra julga para onde um caminho conduz no disco e nada mais. Não lê nenhum valor e não infere nada a partir de um nome.
O que faz uma ligação que conduz para fora
O que acontece a um caminho que conduz para fora depende do tipo de caminho. Há três resultados.
Listado como não lido
Onde Aggrega lista o que o espaço de trabalho contém, uma ligação que conduz para fora não é lida, e a listagem di-lo. As Releases que um editor oferece para escolha, o índice de entidades e as conclusões e candidatos que um editor retira dele, e as ferramentas list-releases e list-entities de um assistente não pesquisam um diretório fora do espaço de trabalho nem leem um ficheiro fora dele, seja o que for que esse ficheiro declare — pelo que uma entidade que o seu editor mostra sob uma ligação dessas não é listada como pertencente ao espaço de trabalho. As listagens de Releases e as listagens de entidades nomeiam cada uma dessas ligações pelo seu próprio lugar no espaço de trabalho, nunca por onde conduz: unreadLinkedDirs e unreadLinkedFiles no servidor de linguagem, unread_linked_dirs e unread_linked_files nas ferramentas do assistente. Uma ligação para um diretório que a sua configuração enumera em catalog_dirs, ou para um diretório por baixo de um destes, ou para uma Release que nomeia, não é nomeada: a configuração chegou a esse local — um diretório enumerado é lido com tudo o que está por baixo dele —, como descrevem as exceções abaixo. Um .gitignore que é uma ligação que conduz para fora também não é lido, pelo que um ficheiro noutro lugar da máquina nunca decide que documentos do espaço de trabalho são pesquisados. Um ficheiro de configuração do espaço de trabalho que é uma ligação que conduz para fora também é nomeado entre os ficheiros não lidos: estas listagens continuam a responder por esse espaço de trabalho, lidas sem nada configurado, enquanto todos os pedidos que a configuração decide param, como descreve a própria configuração do espaço de trabalho abaixo.
Recusado
Um caminho que um pedido nomeia, quando quem chama não é o dono da máquina a escrevê-lo, é recusado. Salvo as exceções abaixo, todos os caminhos que o pedido de um editor a aggrega serve nomeia para o servidor ler ou escrever, e todos os caminhos que um assistente nomeia a um servidor acedido por HTTP, têm de conduzir para dentro do espaço de trabalho; um que conduza para fora é recusado sem que nada seja lido ou escrito, e a recusa nomeia o parâmetro, como a página de cada superfície expõe. A edição de documentos é recusada desta forma em todas as superfícies, incluindo a linha de comandos — consulte A edição de documentos fica dentro.
Interrompido
Quando uma operação leria ou escreveria por conta própria através de uma ligação que conduz para fora, para. Estes são os caminhos que o produto determina por si e não caminhos que nomeou, e ignorar um deles em silêncio poderia alterar o significado de uma compilação, pelo que cada um para a operação, nomeia a ligação e para onde conduz, e deixa o local para onde a ligação aponta exatamente como estava:
- O que uma pesquisa lê — um documento sob um diretório de catálogo, ou ao lado de uma Release que nomeia o seu Aggregate ou o seu Manifest por identidade, ou ao lado de um Manifest que nomeia dessa forma o Manifest que estende. A Release ou o Manifest que a operação recebeu não é um desses documentos: foi lido onde foi nomeado — consulte Uma Release ou um Manifest nomeado através de uma ligação. Uma pesquisa que ignorasse uma ligação dessas poderia resolver no seu lugar outra entidade com o mesmo nome a partir de um diretório posterior, pelo que uma compilação, um pull, uma validação, uma inspeção que lê o catálogo, um lint de uma Release ou do catálogo inteiro, e os pedidos do editor e de um assistente que compilam, pré-visualizam, representam em grafo, validam, fazem lint ou descrevem uma Release param todos antes de qualquer coisa ser resolvida ou verificada:
E0321. - O lockfile de uma Release — lido ao lado da Release pelas fixações em relação às quais uma compilação, um pull, uma validação, um lint, uma inspeção,
aggrega cache prunee os pedidos do editor e de um assistente resolvem. É retido onde é lido exatamente como onde é escrito, pelo que um lockfile que é uma ligação que conduz para fora para cada um deles em vez de lhes emprestar fixações mantidas noutro lugar da máquina:E0321. - Um ficheiro lido ao lado de uma entidade — os outros documentos no diretório de uma entidade que fixa ou publica, lidos para saber se outra entidade partilha esse diretório, e o
.wasmconstruído a partir do qual uma entidade Plugin num diretório de catálogo é carregada. Cada um é lido apenas a partir de dentro do diretório sob o qual o próprio documento da entidade foi lido: o espaço de trabalho, um diretório de catálogo que nomeou fora dele, ou o diretório de um documento que nomeou fora dele. Assim, um que seja uma ligação que conduz para fora paraaggrega pin,aggrega push(incluindo uma execução de teste), um pull que fixa e a fixação e a publicação do editor e de um assistente — um documento deixado por ler poderia ser a entidade no caminho — e para uma compilação ou um pull que carrega o plugin, em vez de executar bytes mantidos noutro lugar da máquina:E0321. - A cache de artefactos — tudo o que Aggrega lê da cache em
artifact_cache_dir: uma entidade, plugin ou biblioteca em cache e o manifesto ao lado, um arquivo de origem e os seus metadados, uma entrada externa fixada, um pacote de assinatura e o índice de pesquisa local de um registo, e todas as entradas do espaço de trabalho queaggrega cache status,aggrega cache pruneeaggrega cache clearlistam. A cache só é lida a partir de dentro do diretório da cache, o local onde é escrita, pelo que qualquer coisa nela que seja uma ligação que conduz para fora desse diretório — tanto para outro lugar no espaço de trabalho como para qualquer outro sítio — para uma compilação, um pull, uma validação, uma pesquisa, cada um dos três comandos de cache e os pedidos do editor e de um assistente que leem a cache, em vez de lhes entregar bytes mantidos num sítio que a cache não possui — incluindo conteúdo verificado em relação a um digest registado, uma vez que um digest diz o que os bytes são, não de onde podem ser lidos. O aviso de descontinuação queaggrega inspectimprime, que não decide nada, fica de fora. Um prune ou um clear trata um dos próprios diretórios da cache que seja uma ligação dessas, ou um diretório de cache que seja ele próprio uma ligação que conduz para fora do espaço de trabalho, como a remoção que seria, comE0320, antes de listar o que quer que seja:E0321. - Um repositório que uma origem obtém — o checkout que um pull arquiva para uma origem
git-repository. O checkout é um diretório próprio, pelo que uma ligação que o repositório transporta é arquivada como aquilo para que aponta apenas quando isso está dentro do repositório; uma que conduza para fora dele, que poderia chegar a qualquer ficheiro da máquina que executa o pull, para o pull nomeando a ligação e para onde conduz, sem nada em cache — incluindo o própriomodule_subdir, quando é uma ligação dessas:E0321. O checkout desaparece assim que o pull para, pelo que a mensagem nomeia a ligação pelo seu lugar no repositório, bem como o repositório e a revisão que a origem nomeia. Ummodule_subdirque, tal como está escrito, sobe acima do repositório é recusado antes de o repositório ser obtido, pelo que nada ao lado do checkout é lido:E0307. - Os ficheiros de um diretório que importa —
aggrega import, a ferramenta de importação do assistente e oaggrega/importda sessão, quando recebem um diretório, leem os ficheiros dele que os padrões de ficheiros do importador selecionam. O diretório é uma raiz própria onde quer que esteja — consulte Um diretório que importa —, pelo que uma ligação entre esses ficheiros que conduza para fora dele, ou uma ligação para um diretório que conduza para fora dele, para a importação nomeando a ligação antes de qualquer ficheiro do diretório ser lido:E0321. - A própria configuração do espaço de trabalho — todos os
.aggrega-config.yamldesde a raiz até ao diretório em que um comando corre, e o.aggrega-config-append-ci.yamlde um pipeline ao lado de qualquer um deles. Todos os comandos que leem a configuração, o servidor de linguagem e as ferramentas de um assistente leem-na antes de tudo o resto, pelo que um destes ficheiros que seja uma ligação que conduz para fora para cada um deles aí, em vez de os deixar correr com uma configuração feita a partir do que restou:E0321. Os comandosaggregaque nunca a leem —version,help,completion,explain,get-schema,scaffoldao esboçar um documento inicial,skills list,plugin run-local,plugin sync,auth tokenelogout— correm como habitualmente, com um aviso que nomeia a ligação.scaffold --examplelê-a, para o registo predefinido e a política de assinaturas, e para aí, tal como qualquer outro leitor. O servidor de linguagem, e o servidor de um assistente que fala através dos seus próprios fluxos, arrancam mesmo assim sobre um espaço de trabalho destes, para que o que ele contém possa ser listado: as listagens de Releases e de entidades respondem, lidas sem nenhum diretório de catálogo e nada mais configurado, e nomeiam o ficheiro entre as ligações não lidas. Todos os outros pedidos que a configuração decide — uma compilação, uma pré-visualização, um grafo, uma validação, um lint, uma descrição, a configuração efetiva, a Release predefinida — param comE0321nomeando a ligação, tal como o servidor de um assistente a quem se pede que escute por HTTP, cujo endereço e autorização a configuração teria definido. - O que uma operação escreve ou remove — o diretório de saída de uma compilação, os seus diretórios de fronteira e todos os ficheiros aí escritos, o trace; o lockfile de uma Release e o registo de confiança de plugins ao lado dele; um
entity.lock; o ficheiro de configuração do espaço de trabalho que um comando escreve; a cache de artefactos e cada parte dela que um pull preenche ou queaggrega cache cleareaggrega cache pruneesvaziam; os rascunhos que uma importação escreve e as entidades Plugin queaggrega plugin gen-catalogescreve; e o marcador.aggrega/active-releaseem que um editor regista uma Release predefinida, que o servidor de linguagem escreve por ele. Umdistque fosse uma ligação transformaria, caso contrário, «reconstruir a saída» em apagar um diretório noutro lugar da máquina:E0320. - O que um documento nomeia por um caminho — consulte Uma referência que um documento escreve:
E0324. - O conteúdo que uma entidade declara — uma
source:ou um$import:cujo caminho passa por um diretório que é uma ligação que conduz para fora do próprio diretório da entidade, que uma publicação transportaria de outra forma sob um nome dentro da entidade:E0304.
Estas regras aplicam-se seja quem for que iniciou a operação — a linha de comandos, um editor ou um assistente em qualquer um dos transportes —, porque o caminho é do espaço de trabalho e do produto, não de quem chama.
Uma referência que um documento escreve
Uma Release e um Manifest podem nomear outro ficheiro por um caminho: o aggregate: e o manifest: de uma Release escritos como ./… ou ../…, o seu extends:, o extends: de um Manifest escrito como caminho e o parameters: { $import: … } de uma Release. Um documento no espaço de trabalho só alcança ficheiros dentro do espaço de trabalho dessa forma — um caminho que, tal como está escrito, sobe para fora é recusado, tal como um que, tal como está escrito, fica dentro mas encontra pelo caminho uma ligação que conduz para fora. Nada é lido do ficheiro que qualquer um deles nomeia.
Um espaço de trabalho que clonou transporta as referências do seu autor, pelo que confinar o que o utilizador nomeia e seguir aquilo para que um documento depois conduz deixaria o limite a um ../ de distância. Quando um documento precisa de uma entidade mantida noutro lugar, nomeia a entidade em vez de um ficheiro — aggregate: payments — e a configuração do espaço de trabalho enumera o diretório de catálogo que a contém. Um nome é procurado, não seguido, pelo que nunca é recusado aqui.
Uma Release ou um Manifest que está fora do espaço de trabalho, admitido porque o nomeou, só alcança ficheiros no seu próprio diretório — consulte Uma exceção alcança o diretório que nomeia, e nada mais.
As exceções, e porque é que cada uma o é
Um caminho numa destas classes é respeitado onde conduz, dentro do espaço de trabalho ou não. Cada uma é uma classe de caminhos e não uma lista de locais, e cada uma é uma exceção por uma razão própria.
- O que a configuração do espaço de trabalho nomeia. Os seus diretórios de catálogo —
catalog_dirsecatalog_dirs_append, para o espaço de trabalho ou para uma Release emworkspace.releases—, os ficheiros de Release usados como chaves emworkspace.releases,build.authoring_release, o.wasmlocal de um anexo de plugin e os ficheiros no seuwith.sources,mcp.tls.cert_file,mcp.tls.key_file,mcp.authorization.jwks_file, a raiz de confiança fixada de um registo e umartifact_cache_dirque sobe para fora da raiz do espaço de trabalho. Nomear um caminho na configuração é a forma deliberada de um espaço de trabalho chegar fora de si próprio: é escrito uma vez, mantido com o projeto e lido por quem o rever. O diretóriocatalogconvencional do espaço de trabalho conta como nomeado quando a configuração o enumera ou quando o passa com--catalog— ou quando enumera, ou passa, o local para onde conduz, em qualquer grafia, ou um diretório acima desse local, que então lê o que lá está uma vez, através do diretório que nomeou. Lido apenas por estar lá, é conteúdo próprio do espaço de trabalho, pelo que umcatalogque é uma ligação que conduz para fora do espaço de trabalho não é lido até que o nomeie a ele ou ao local para onde conduz. - Um caminho que escreve na linha de comandos.
aggrega build --release ../other/release.yaml,--catalog /srv/shared-catalog,--output-dir, um ficheiro a validar, a fazer lint, a fixar ou a publicar: cada um é usado onde conduz — exceto a edição de documentos, abaixo. É o dono da máquina em que o comando corre e já pode ler e escrever tudo o que escreveria, pelo que confiná-lo a um diretório não traria nada. - Um caminho que um assistente nomeia através dos próprios fluxos do processo. Um cliente que lançou
aggrega mcpna sua máquina corre como o utilizador, e o seu anfitrião normalmente dá-lhe ferramentas de ficheiros e de shell próprias, pelo que um caminho que nomeia é respeitado como se o tivesse escrito — consulte Os dois transportes do assistente. - Os armazenamentos de toda a máquina do produto — o ficheiro de configuração global, o armazenamento de módulos compilados, a cache de descritores de plugins, o pacote de documentação e o armazenamento de credenciais de registos. Pertencem à máquina e não a qualquer espaço de trabalho, pelo que nenhum espaço de trabalho os contém.
- Um ficheiro ou um diretório escolhido numa caixa de diálogo, lido onde está. Um editor envia como caminho absoluto o ficheiro de chave ou a raiz de confiança da inscrição de um registo, a descrição que
aggrega/importconverte — um ficheiro, ou um diretório cujos ficheiros o importador lê — e o módulo para o qualaggrega/pluginGenCataloggera uma entidade, com a sobreposição ao lado. Foi uma pessoa que escolheu cada um, onde quer que os guarde. Só são lidos: nada do que um pedido escreve vai para um caminho escolhido desta forma. Um diretório escolhido desta forma está confinado a si próprio, como todos os diretórios que importa. - Um documento que o seu editor tem aberto. Validá-lo, pedir os seus diagnósticos ou descartá-los, passar o cursor por cima, completar, resolver e encontrar referências e implementações nele são respondidos a partir do conteúdo que o editor enviou, pelo que nenhum ficheiro é lido no caminho que o nomeia, e o caminho nunca é recusado por causa de onde conduz. Um pedido que efetivamente lê o documento do disco é do tipo recusado acima.
Os caminhos escritos na linha de comandos e os armazenamentos de toda a máquina nunca são sequer julgados; os outros são deixados passar pela sua classe, nunca pelo pedido que por acaso os transporta.
Uma exceção alcança o diretório que nomeia, e nada mais
Um diretório que nomeou fora do espaço de trabalho é uma raiz própria para tudo o que é lido ou escrito por baixo dele. O próprio diretório é usado tal como o nomeou — um que seja uma ligação é seguido até onde aponta — e uma ligação por baixo dele que conduza para fora dele é retida exatamente como uma ligação dentro do espaço de trabalho: não é lida numa listagem, e interrompe uma pesquisa ou uma escrita. Assim, um diretório de catálogo que enumera fora do espaço de trabalho, um diretório de saída que passa a aggrega plugin gen-catalog ou aggrega import, e um artifact_cache_dir que sobe para fora do espaço de trabalho confinam cada um a si próprio o que está por baixo deles. Quando um diretório que nomeou está dentro do espaço de trabalho, o espaço de trabalho é a raiz — exceto um diretório que importa, que é uma raiz própria onde quer que esteja.
Um diretório que nomeia é resolvido em relação à pasta em que corre antes de qualquer coisa ser colocada por baixo dele. Um diretório de saída que passa a aggrega import, escrito como relativo, é a pasta com esse nome na pasta em que executa o comando, e uma unidade que nomeia sozinha no Windows — D: — é a pasta atual nessa unidade. O diretório é primeiro transformado num caminho completo e todos os ficheiros são colocados por baixo desse caminho completo, pelo que um ficheiro cujo nome começa com um separador, \notes.txt por exemplo, fica dentro do diretório que nomeou e não no topo da unidade, e o diretório que o comando reporta é aquele em que foi escrito.
Uma Release ou um Manifest que nomeou fora do espaço de trabalho é a mesma regra lida para um ficheiro: o seu próprio diretório é a raiz, pelo que o que nomeia por um caminho — e o que nomeia cada Release a que a sua cadeia extends: conduz — tem de ficar dentro desse diretório. Uma Release mantida ao lado do seu Aggregate e do seu Manifest compila a partir de qualquer lugar; uma na estrutura habitual releases/, que nomeia ../aggregates/app.yaml, é antes compilada a partir do seu próprio espaço de trabalho.
Uma Release ou um Manifest nomeado através de uma ligação
Uma Release que nomeia através de uma ligação é lida onde a ligação conduz, e resolvida onde a nomeou. Escrita como --release release.yaml, em que release.yaml é uma ligação para um ficheiro mantido noutro lugar — ou nomeada dessa forma em workspace.releases, ou como build.authoring_release —, a Release é lida a partir do local para onde a ligação conduz. O Aggregate e o Manifest que nomeia, por identidade ou por um caminho, são procurados ao lado da ligação, no diretório em que a nomeou, e confinados à raiz desse diretório: o espaço de trabalho, ou o próprio diretório quando está fora do espaço de trabalho. O seu lockfile também é lido e escrito ao lado da ligação, nunca onde a ligação conduz. A Release não é um dos documentos que a sua própria pesquisa encontra ao lado dela, pelo que nunca para essa pesquisa; outra Release mantida ao lado dela que seja uma ligação que conduz para fora continua a pará-la. Um Manifest que inspeciona isoladamente através de uma ligação é lido e resolvido da mesma forma.
O diretório da cache de artefactos é uma raiz própria, onde quer que esteja. Tudo o que a cache contém é escrito, lido e removido apenas dentro do diretório da cache, pelo que um dos próprios diretórios da cache, ou um ficheiro num deles, que seja uma ligação que conduz para fora do diretório da cache é retido — mesmo quando conduz para outro lugar dentro do espaço de trabalho —, enquanto um que conduza para outro lugar dentro do diretório da cache é seguido. O local onde está o próprio diretório da cache é lido a partir da forma como o seu valor está escrito. Escrito dentro da raiz do espaço de trabalho — incluindo o .aggrega/cache predefinido —, é um diretório próprio do espaço de trabalho: um diretório de cache que é uma ligação para outro lugar dentro do espaço de trabalho é seguido, e um que conduza para fora do espaço de trabalho é recusado, tanto para leitura como para escrita. Escrito a subir para fora (../shared-cache), é um diretório que a configuração nomeia, lido e escrito onde conduz.
Um diretório que importa
Um diretório que importa é uma raiz própria, onde quer que esteja — tanto dentro do espaço de trabalho como fora dele, que é onde difere de todos os outros diretórios que nomeia dentro do espaço de trabalho. aggrega import, a ferramenta de importação do assistente e o aggrega/import da sessão entregam ao importador cada ficheiro do diretório sob o seu lugar nesse diretório, pelo que o que lhe entregam é lido apenas a partir de dentro do diretório. O que é julgado é aquilo de onde a importação retiraria algo: uma ligação para um ficheiro que um padrão do importador seleciona — de qualquer importador, quando o formato é reconhecido em vez de nomeado — e uma ligação para um diretório, no qual nunca se entra. Uma dessas que conduza para fora do diretório é recusada antes de qualquer ficheiro ser lido, mesmo quando conduz para outro lugar dentro do espaço de trabalho, enquanto uma ligação selecionada para um ficheiro noutro lugar dentro do diretório é lida onde aponta, sob o próprio nome da ligação. Uma ligação para um ficheiro que nenhum padrão seleciona não é julgada nem lida. O próprio diretório é usado tal como o nomeou, sendo seguido até onde aponta, quando é uma ligação.
A edição de documentos fica dentro
aggrega edit-document, a edição de documentos e o ponto de inserção do servidor de linguagem, e edit-document e insertion-point do assistente atuam apenas sobre um documento que o espaço de trabalho contém. Um documento fora do espaço de trabalho, tal como está escrito ou através de uma ligação que conduz para fora dele, é recusado em todas as superfícies sem que nada seja lido ou escrito — incluindo onde um caminho que nomeia é, de resto, respeitado.
Os dois transportes do assistente
aggrega mcp serve as mesmas ferramentas de duas formas, e o limite difere entre elas porque quem chama difere.
- Através dos próprios fluxos do processo, o cliente lançou o servidor na sua máquina, pelo que uma chamada é o utilizador a escrever na linha de comandos: um argumento de caminho pode ser absoluto e pode estar fora do espaço de trabalho, uma chamada pode nomear o seu próprio
workspace_roote os seus próprioscatalog_dirs, e as ferramentas que executam um comandoaggreganum processo separado são oferecidas. Só o caminho que uma chamada nomeia é respeitado tal como nomeado. O que a operação depois lê e escreve por conta própria é retido tal como num terminal: uma listagem não lê através de uma ligação que conduz para fora, uma referência que um documento escreve não sai do espaço de trabalho, e uma escrita não passa por um diretório de saída ou de cache ligado. O conteúdo do espaço de trabalho pode orientar o que um assistente pede, pelo que, num anfitrião em que estas ferramentas são o seu único acesso aos seus ficheiros, um documento num espaço de trabalho que clonou pode ainda assim levá-lo a nomear um caminho fora do espaço de trabalho e a lê-lo ou escrevê-lo; o que um assistente pode fazer sem lhe perguntar primeiro é onde define quanto faz sem ser solicitado. - Por HTTP, quem chama não é o dono da máquina em que o servidor corre. O espaço de trabalho é aquele sobre o qual o servidor foi iniciado e é fixo durante toda a sua vida; todos os argumentos de caminho são confinados a ele, julgados como acima; uma chamada que nomeia
workspace_rootoucatalog_dirs, ou que seleciona uma chave de assinatura mantida no anfitrião, é recusada; e as ferramentas que executam um comandoaggreganão são oferecidas. Uma recusa nomeia o argumento e cita um valor relativo tal como foi enviado, mas não nomeia nem a raiz do espaço de trabalho nem para onde um caminho teria conduzido.
Quando algo é recusado ou interrompido
| O que vê | O que fazer |
|---|---|
| Uma listagem nomeia uma ligação entre as que não leu | Substitua a ligação por uma cópia daquilo para que conduz; ou, para entidades mantidas noutro lugar, enumere em catalog_dirs o diretório para onde a ligação conduz; para uma Release mantida noutro lugar, nomeie-a em workspace.releases ou como build.authoring_release. |
E0321, uma leitura através de uma ligação para fora de um diretório de catálogo ou do diretório de uma Release | Enumere o diretório para onde a ligação conduz como diretório de catálogo, ou passe-o com --catalog, em vez de chegar a ele através de uma ligação por baixo de um; ou substitua a ligação por uma cópia. Quando a ligação é o próprio catalog convencional, enumere catalog ou o diretório para onde conduz, ou passe qualquer um deles com --catalog. |
E0321 no lockfile de uma Release | Remova a ligação e faça pull da Release novamente, o que escreve um lockfile novo ao lado dela. Um lockfile não tem outro lugar. |
E0321 num ficheiro ao lado de uma entidade | Substitua a ligação pelo próprio ficheiro: mova um documento que é uma entidade para um diretório próprio, e coloque o .wasm construído ao lado da sua entidade Plugin em vez de uma ligação para ele. |
E0321 num ficheiro de configuração | Substitua a ligação por uma cópia mantida no espaço de trabalho. Uma configuração partilhada entre espaços de trabalho é lida nomeando-a como o ficheiro de configuração global, com --config ou AGGREGA_CONFIG, por baixo dos próprios ficheiros de cada espaço de trabalho. |
E0321 na cache de artefactos | Remova a ligação; um pull volta a preencher a cache. Para manter a cache noutro lugar, defina artifact_cache_dir como esse diretório, escrito em relação à raiz do espaço de trabalho (../shared-cache), em vez de criar uma ligação para ele. |
E0321 numa ligação num repositório obtido | A ligação está incluída no repositório que a origem nomeia — a mensagem nomeia-a pelo seu lugar aí: altere-a aí — faça-a apontar para dentro do repositório, ou inclua o próprio ficheiro num commit — e nomeie a revisão que contém a alteração. |
E0321 numa ligação num diretório que importa | Mantenha o próprio ficheiro no diretório em vez de uma ligação para ele, ou importe o diretório para onde a ligação conduz. Um diretório que importa só é lido a partir de dentro de si próprio, onde quer que esteja. |
E0307 num module_subdir | Nomeie um diretório dentro do repositório: o valor pode descer abaixo do topo do repositório, mas não pode subir acima dele. |
E0320, uma escrita ou remoção através de uma ligação | Remova a ligação que a mensagem nomeia, ou faça-a conduzir para algum lugar dentro do diretório que a mensagem nomeia, e execute a operação novamente. Nada nos seus ficheiros de entidade a provoca. |
E0324, uma referência que conduz para fora | Nomeie um Aggregate mantido noutro lugar pelo seu metadata.name e enumere o seu diretório de catálogo; mantenha um Manifest, uma Release que um extends: nomeia e um ficheiro de parâmetros dentro do espaço de trabalho — ou, para um documento que nomeou a partir de fora, no seu próprio diretório; ou abra o espaço de trabalho num diretório que contenha ambos os documentos. |
E0304, conteúdo através de uma ligação | Substitua a ligação por uma cópia daquilo para que conduz, dentro do próprio diretório da entidade. |
| Um pedido ao servidor de linguagem recusado por causa de um caminho que conduz para fora | Envie um caminho dentro do espaço de trabalho, relativo à sua raiz. Uma Release mantida fora do espaço de trabalho é alcançada nomeando-a na configuração, em workspace.releases ou como build.authoring_release, e nomeando no pedido a ligação dentro do espaço de trabalho que conduz até ela — o local em que a listagem de Releases a oferece. |
| Uma chamada de assistente por HTTP recusada por causa de um caminho | Envie um caminho relativo à raiz do espaço de trabalho que o servidor serve; quando a recusa oferece a grafia relativa de um caminho absoluto, envie essa. |
| Uma edição de documento recusada | Edite um documento que o espaço de trabalho contém; uma ligação para um documento noutro lugar não é usada para editar. |
Ver também
- Configuração — onde cada uma das definições acima é escrita, e como um caminho relativo nela é resolvido.
aggrega serveeaggrega mcp— cada pedido e ferramenta, e quais dos seus parâmetros nomeiam um caminho.- Paragens fatais — a entrada completa de cada condição acima.