Граница рабочего пространства
Рабочее пространство — это дерево каталогов, которое отмечает корень проекта: корень, в котором находится блок workspace: вашей конфигурации, корень, указанный в --workspace-root, папка, открытая в редакторе, или каталог, над которым был запущен сервер ассистента. Всё, что Aggrega читает и записывает по собственной инициативе, ограничено этим деревом,
кроме случаев, когда вы или конфигурация рабочего пространства указываете место за его пределами. Символическая ссылка внутри него
может указывать куда угодно на машине, поэтому ссылка никогда не считается частью рабочего пространства лишь потому, что
находится в нём: значение имеет то, куда она ведёт.
На этой странице правило изложено целиком. Страницы каждого интерфейса — командной строки, языкового сервера и инструментов ассистента — описывают, как с ним соотносятся их собственные запросы.
Что находится внутри рабочей области
Путь находится внутри рабочей области, если самая глубокая существующая его часть, с разыменованными ссылками, является корнем рабочей области или лежит под ним — при этом ссылки самого корня разыменовываются так же, поэтому рабочая область, к которой вы обращаетесь через её собственную ссылку, по-прежнему содержит всё, что под ней находится.
Корень, открытый через ссылку, — это рабочая область, на которую ведёт ссылка. Является ли открываемая папка сама ссылкой или доступна через ссылку выше по пути, Aggrega перечисляет, читает и записывает ровно то же, что и в рабочей области, на которую ведёт ссылка, — её Releases, её документы, её lock-файлы — и оценивает каждую ссылку внутри неё так же. Каждый путь в ответе при этом записывается от корня в том виде, в каком он был задан, — папки, открытой редактором, введённого вами --workspace-root, каталога, который командная оболочка считает текущим, — поэтому показываемое вам совпадает с путями, с которыми вы работаете.
Это единое толкование охватывает пути любого вида:
- Решает то, куда ведёт путь, а не то, как он записан.
./shared/app.yamlнаходится снаружи, еслиshared— ссылка на каталог в другом месте, хотя каждая часть пути записана внутри рабочей области. Параметр запроса по-прежнему может требовать собственной записи — например, пути относительно корня, — и об этом сказано на его собственной странице; это правило о параметре, а не о границе. - Путь, который ещё не существует, оценивается по каталогам на пути к нему. Файл, который сборка
собирается создать под
dist, являющимся ссылкой наружу, находится снаружи ещё до того, как будет записан. - Ссылка, которая никуда не ведёт или ведёт по кругу, не считается существующей. Вместо неё оценивается содержащий её каталог, и ничего не разыменовывается, чтобы выяснить, куда ссылка должна была вести. Если такая ссылка стоит ровно там, где должен быть создан файл, проверяется и место, на которое она указывает, поскольку именно туда попал бы файл.
- Ссылка на другое место внутри рабочей области разыменовывается как обычно. Задерживается только ссылка, ведущая наружу.
Правило оценивает только то, куда путь ведёт на диске, и ничего больше. Оно не читает никаких значений и ничего не выводит из имени.
Что происходит со ссылкой, ведущей наружу
Что происходит с путём, ведущим наружу, зависит от вида этого пути. Возможны три исхода.
Указывается как непрочитанная
Там, где Aggrega перечисляет содержимое рабочей области, ссылка, ведущая наружу, не читается, и перечень сообщает об этом. Сущности Releases, из которых редактор предлагает выбрать, индекс сущностей и автодополнения и кандидаты, которые редактор из него берёт, а также list-releases и list-entities ассистента не просматривают каталог вне рабочей области и не читают файл вне её, что бы этот файл ни объявлял, — поэтому сущность, которую ваш редактор показывает под такой ссылкой, не указывается как собственная сущность рабочей области. Перечни сущностей Release и перечни сущностей называют каждую такую ссылку по её собственному месту в рабочей области, а не по тому, куда она ведёт: unreadLinkedDirs и unreadLinkedFiles в языковом сервере,
unread_linked_dirs и unread_linked_files в инструментах ассистента. Ссылка на каталог, который ваша конфигурация указывает в catalog_dirs, или на каталог внутри него, или на сущность Release, которую она называет, не называется: конфигурация уже охватила это место — указанный каталог читается со всем содержимым, — как описано ниже в разделе об исключениях. Файл
.gitignore, являющийся ссылкой наружу, тоже не читается, поэтому файл где-то ещё на машине никогда не определяет, какие документы рабочей области просматриваются. Файл конфигурации рабочей области, являющийся ссылкой наружу, тоже называется среди непрочитанных файлов: эти перечни по-прежнему отвечают для этой рабочей области, прочитанной без какой-либо конфигурации, а каждый запрос, который определяет конфигурация, останавливается, как описано ниже в разделе о собственной конфигурации рабочей области.
Отклоняется
Путь, указанный в запросе, когда вызывающая сторона — не владелец машины, вводящий его сам, отклоняется. За исключением описанных ниже исключений, каждый путь, который запрос редактора к
aggrega serve указывает серверу для чтения или записи, и каждый путь, который ассистент указывает серверу, доступному по HTTP, должен вести внутрь рабочей области; путь, ведущий наружу, отклоняется без чтения и записи, и отказ называет параметр, как изложено на странице каждого интерфейса. Правка документа отклоняется так на любом интерфейсе, включая командную строку, — см.
Правка документа остаётся внутри.
Останавливается
Если операция по собственной инициативе стала бы читать или писать через ссылку, ведущую наружу, она останавливается. Это пути, которые продукт определяет сам, а не пути, указанные вами, и молчаливый пропуск такого пути мог бы изменить смысл сборки, поэтому каждый из них останавливает операцию, называет ссылку и место, куда она ведёт, и оставляет место, на которое указывает ссылка, в точности таким, каким оно было:
- То, что читает поиск — документ внутри каталога каталога сущностей, или рядом с сущностью Release, которая называет свою сущность Aggregate или свою сущность Manifest по идентичности, или рядом с сущностью Manifest, которая так же называет расширяемую ею сущность Manifest. Сущность Release или Manifest, названная операции, не относится к этим документам: она была прочитана там, где была названа, — см. Сущность Release или Manifest, названная через ссылку.
Поиск, пропустивший такую ссылку, мог бы вместо неё разрешить другую сущность
с тем же именем из следующего каталога, поэтому сборка, загрузка (pull), проверка, инспекция,
читающая каталог, линтинг одной сущности Release или всего каталога, а также запросы редактора и ассистента на сборку, предпросмотр, построение графа, проверку, линтинг или описание сущности Release останавливаются до того,
как что-либо будет разрешено или проверено:
E0321. - Lockfile сущности Release — читается рядом с сущностью Release ради закреплённых версий, по которым выполняют разрешение сборка, загрузка (pull), проверка, линтинг,
инспекция,
aggrega cache pruneи запросы редактора и ассистента. Он ограничивается там, где читается, точно так же, как там, где записывается, поэтому lockfile, являющийся ссылкой наружу, останавливает каждую из этих операций, а не подсовывает им закреплённые версии, хранящиеся где-то ещё на машине:E0321. - Файл, читаемый рядом с сущностью — другие документы в каталоге сущности, которую вы закрепляете или публикуете,
читаемые, чтобы определить, не делит ли этот каталог другая сущность, и собранный
.wasm, из которого загружается сущность Plugin в каталоге каталога сущностей. Каждый из них читается только изнутри каталога, в котором был прочитан собственный документ сущности: рабочей области, указанного вами каталога каталога сущностей вне её или каталога документа, указанного вами вне её. Поэтому файл, являющийся ссылкой наружу, останавливаетaggrega pin,aggrega push(включая пробный запуск), загрузку (pull) с закреплением и закрепление и публикацию из редактора и ассистента — непрочитанный документ мог бы оказаться мешающей сущностью, — а также останавливает сборку или загрузку, которая загружает плагин, вместо того чтобы выполнять байты, хранящиеся где-то ещё на машине:E0321. - Кэш артефактов — всё, что Aggrega читает из кэша в
artifact_cache_dir: кэшированная сущность, плагин или библиотека и манифест рядом с ними, архив исходников и его метаданные, закреплённый внешний вход, пакет подписи и локальный поисковый индекс реестра, а также каждая запись рабочей области, которую выводятaggrega cache status,aggrega cache pruneиaggrega cache clear. Кэш читается только изнутри каталога кэша — места, куда он записывается, — поэтому всё в нём, что является ссылкой, ведущей из этого каталога, — в другое место рабочей области так же, как куда угодно ещё, — останавливает сборку, загрузку (pull), проверку, поиск, каждую из трёх команд кэша и запросы редактора и ассистента, читающие кэш, вместо того чтобы отдавать им байты, хранящиеся там, где кэш не распоряжается, — включая содержимое, сверяемое с записанным дайджестом, поскольку дайджест говорит, что это за байты, а не откуда их можно читать. Уведомление об устаревании, которое выводитaggrega inspectи которое ничего не определяет, исключено. Очистка (prune или clear), встретив собственный каталог кэша, являющийся такой ссылкой, или каталог кэша, который сам является ссылкой из рабочей области, считает это удалением, которым это было бы, и выдаётE0320, прежде чем что-либо перечислить:E0321. - Репозиторий, который получает источник — рабочая копия, которую загрузка (pull) архивирует для источника
git-repository. Рабочая копия — отдельный каталог, поэтому ссылка, содержащаяся в репозитории, архивируется как то, на что она указывает, только если это лежит внутри репозитория; ссылка, ведущая из него, которая могла бы достать любой файл на машине, выполняющей загрузку, останавливает загрузку с указанием ссылки и места, куда она ведёт, без кэширования чего-либо, — включая самmodule_subdir, если он является такой ссылкой:E0321. После остановки загрузки рабочей копии уже нет, поэтому сообщение называет ссылку по её месту в репозитории, а также репозиторий и ревизию, указанные источником.module_subdir, который в записанном виде поднимается выше репозитория, отклоняется до получения репозитория, поэтому ничего рядом с рабочей копией не читается:E0307. - Файлы импортируемого каталога —
aggrega import, инструмент импорта ассистента иaggrega/importсеанса, получив каталог, читают те его файлы, которые выбирают шаблоны файлов импортёра. Каталог является самостоятельным корнем, где бы он ни находился, — см. Импортируемый каталог, — поэтому ссылка среди этих файлов, ведущая за его пределы, или ссылка на каталог, ведущая за его пределы, останавливает импорт с указанием ссылки до того, как будет прочитан хотя бы один файл каталога:E0321. - Собственная конфигурация рабочей области — каждый
.aggrega-config.yamlот корня до каталога, в котором выполняется команда, и.aggrega-config-append-ci.yamlконвейера рядом с любым из них. Каждая команда, читающая конфигурацию, языковой сервер и инструменты ассистента читают её раньше всего остального, поэтому такой файл, являющийся ссылкой наружу, останавливает каждого из них на этом месте, а не позволяет им работать с конфигурацией, собранной из того, что осталось:E0321. Командыaggrega, которые её никогда не читают, —version,help,completion,explain,get-schema,scaffoldпри создании черновика начального документа,skills list,plugin run-local,plugin sync,auth tokenиlogout— выполняются как обычно, с предупреждением, указывающим ссылку.scaffold --exampleеё читает — ради реестра по умолчанию и политики подписей — и останавливается на этом месте, как и любой другой, кто её читает. Языковой сервер и сервер ассистента, работающий через собственные потоки, всё же запускаются над такой рабочей областью, чтобы её содержимое можно было перечислить: списки сущностей Release и списки сущностей отвечают, будучи прочитанными без директории каталога и без какой-либо другой настройки, и называют этот файл среди непрочитанных ссылок. Любой другой запрос, который определяет конфигурация, — сборка, предпросмотр, граф, проверка, линтинг, описание, действующая конфигурация, Release по умолчанию — останавливается сE0321с указанием ссылки, как и сервер ассистента, которому велено слушать по HTTP и чей адрес и авторизацию задала бы конфигурация. - То, что операция записывает или удаляет — выходной каталог сборки, её граничные каталоги и
каждый записанный туда файл, трассировка; lock-файл сущности Release и запись о доверии к плагинам рядом с ним;
entity.lock; файл конфигурации рабочей области, который записывает команда; кэш артефактов и каждая его часть, которую заполняет pull или очищаютaggrega cache clearиaggrega cache prune; черновики, которые записывает импорт, и сущности Plugin, которые записываетaggrega plugin gen-catalog; а также маркер.aggrega/active-release, в котором редактор фиксирует Release по умолчанию и который за него записывает языковой сервер.dist, являющийся ссылкой, иначе превратил бы «пересборку вывода» в удаление каталога где-то ещё на машине:E0320. - То, что документ называет путём, — см. Ссылка, которую записывает документ:
E0324. - Содержимое, которое объявляет сущность, —
source:или$import:, путь которого проходит через каталог, являющийся ссылкой за пределы собственного каталога сущности, и которое публикация иначе унесла бы под именем внутри сущности:E0304.
Это действует независимо от того, кто запустил операцию, — командная строка, редактор или ассистент по любому из транспортов, — потому что путь принадлежит рабочей области и продукту, а не вызывающей стороне.
Ссылка, которую записывает документ
Release и Manifest могут указывать на другой файл по пути: aggregate: и manifest: сущности Release, записанные как ./… или ../…, её extends:, extends: сущности Manifest, записанный как путь, и parameters: { $import: … } сущности Release. Документ в рабочем пространстве таким образом достигает только файлов внутри рабочего пространства: путь, который в записанном виде выходит наружу, отклоняется, как и путь, который в записанном виде остаётся внутри, но по дороге встречает ссылку, ведущую наружу. Из файла, на который указывает любой из них, ничего не читается.
Клонированное вами рабочее пространство несёт ссылки своего автора, поэтому если ограничивать то, что указываете вы, но следовать всему, к чему затем ведёт документ, граница оказалась бы на расстоянии одного ../. Если документу нужна сущность, хранящаяся в другом месте, он указывает имя сущности, а не файл — aggregate: payments, — а конфигурация рабочего пространства перечисляет каталог, в котором она находится. Имя ищется, а не прослеживается, поэтому здесь оно никогда не отклоняется.
Release или Manifest, расположенные вне рабочего пространства и допущенные, потому что вы их указали, достигают только файлов в собственном каталоге — см. Исключение достигает указанного им каталога и не дальше.
Исключения и почему каждое из них — исключение
Путь одного из этих классов принимается там, куда он ведёт, внутри рабочей области или нет. Каждое исключение — это класс путей, а не список мест, и у каждого своя причина.
- То, что называет конфигурация рабочей области. Её каталоги каталогов —
catalog_dirsиcatalog_dirs_append, для рабочей области или для сущности Release вworkspace.releases, — файлы сущностей Release, перечисленные по ключам вworkspace.releases,build.authoring_release, локальный.wasmподключения плагина и файлы из егоwith.sources,mcp.tls.cert_file,mcp.tls.key_file,mcp.authorization.jwks_file, закреплённый корень доверия реестра, а такжеartifact_cache_dir, который выходит за пределы корня рабочей области. Указание пути в конфигурации — осознанный способ, которым рабочая область выходит за свои пределы: он записывается один раз, хранится вместе с проектом и виден каждому, кто её проверяет. Каталогcatalog, принятый в рабочей области по соглашению, считается названным, если конфигурация его перечисляет или вы передаёте его через--catalog, — либо перечисляет или вы передаёте место, куда он ведёт, в любом написании, или каталог выше этого места; тогда содержимое там читается один раз, через названный вами каталог. Если он читается лишь потому, что существует, он является собственным содержимым рабочей области, поэтомуcatalog, являющийся ссылкой за пределы рабочей области, не читается, пока вы не назовёте его или место, куда он ведёт. - Путь, который вы вводите в командной строке.
aggrega build --release ../other/release.yaml,--catalog /srv/shared-catalog,--output-dir, файл для проверки, линтинга, закрепления или публикации: каждый используется там, куда ведёт, — за исключением редактирования документа, см. ниже. Машина, на которой выполняется команда, принадлежит вам, и вы уже можете читать и записывать всё, что могли бы ввести, поэтому ограничение каталогом ничего бы не дало. - Путь, который ассистент называет через собственные потоки процесса. Клиент, запустивший
aggrega mcpна вашей машине, работает от вашего имени, и его хост обычно предоставляет ему собственные инструменты для работы с файлами и оболочкой, поэтому названный им путь принимается так, как если бы его ввели вы, — см. Два транспорта ассистента. - Общемашинные хранилища продукта — глобальный файл конфигурации, хранилище скомпилированных модулей, кэш дескрипторов плагинов, пакет документации и хранилище учётных данных реестров. Они принадлежат машине, а не какой-либо рабочей области, поэтому ни одна рабочая область их не содержит.
- Файл или каталог, выбранный в диалоге и читаемый там, где он находится. Редактор передаёт файл ключа или корень
доверия при регистрации реестра как абсолютный путь, описание, которое преобразует
aggrega/import, — файл или каталог, файлы которого читает импортёр, — и модуль, для которогоaggrega/pluginGenCatalogгенерирует сущность вместе с оверлеем рядом с ним. Каждый из них выбрал человек, где бы он его ни хранил. Они только читаются: ничего из того, что записывает запрос, не попадает по пути, выбранному таким способом. Каталог, выбранный так, ограничен самим собой, как и любой импортируемый вами каталог. - Документ, открытый в вашем редакторе. Его проверка, запрос или сброс его диагностики, подсказки при наведении, автодополнение, разрешение, поиск ссылок и реализаций в нём обслуживаются по содержимому, которое прислал редактор, поэтому по пути, который его называет, никакой файл не читается, и путь никогда не отклоняется из-за того, куда он ведёт. Запрос, который действительно читает документ с диска, относится к отклоняемому виду, описанному выше.
Пути, введённые в командной строке, и общемашинные хранилища не оцениваются вовсе; остальные пропускаются по своему классу, а не по запросу, в котором они оказались.
Исключение распространяется на названный им каталог, и не дальше
Каталог, названный вами вне рабочей области, является отдельным корнем для всего, что читается или записывается
внутри него. Сам каталог используется так, как вы его назвали, — если он является ссылкой, она отслеживается туда, куда
указывает, — а ссылка внутри него, ведущая за его пределы, обрабатывается точно так же, как ссылка внутри рабочей области: она не
читается при перечислении и останавливает поиск или запись. Поэтому каталог каталогов, который вы перечисляете вне рабочей
области, выходной каталог, который вы передаёте aggrega plugin gen-catalog или aggrega import, и
artifact_cache_dir, выходящий за пределы рабочей области, ограничивают своё содержимое самими собой. Если названный вами каталог находится внутри
рабочей области, корнем является рабочая область — за исключением импортируемого каталога, который является
отдельным корнем, где бы он ни находился.
Названный вами каталог разрешается относительно папки, в которой вы работаете, прежде чем в нём что-либо размещается.
Выходной каталог, переданный aggrega import в виде относительного пути, — это папка с таким именем в
папке, в которой вы запускаете команду, а диск, названный в Windows без пути, — D:, — это текущая папка на
этом диске. Сначала каталог преобразуется в полный путь, и каждый файл размещается внутри этого полного пути, поэтому
файл, имя которого начинается с разделителя, например \notes.txt, оказывается внутри названного вами каталога, а не
в корне диска, и каталог, который сообщает команда, — тот, в который выполнялась запись.
Сущность Release или Manifest, названная вами вне рабочей области, подчиняется тому же правилу применительно к файлу: её собственный
каталог является корнем, поэтому то, что она называет по пути, — и то, что называет каждая сущность Release, к которой ведёт её цепочка extends:, —
должно оставаться внутри этого каталога. Сущность Release, хранящаяся рядом со своими Aggregate и Manifest, собирается
откуда угодно; сущность в обычной структуре releases/, ссылающаяся на ../aggregates/app.yaml, собирается вместо этого из своей
рабочей области.
Release или Manifest, названные через ссылку
Сущность Release, названная вами через ссылку, читается там, куда ведёт ссылка, а разрешается там, где вы её назвали.
Если она указана как --release release.yaml, где release.yaml — ссылка на файл, хранящийся в другом месте, — или названа
так в workspace.releases либо как build.authoring_release, — сущность Release читается из
места, куда ведёт ссылка. Сущности Aggregate и Manifest, которые она называет по идентификатору или по пути, ищутся
рядом со ссылкой, в каталоге, где вы её назвали, и ограничиваются корнем этого каталога: рабочей
областью или самим каталогом, если он находится вне рабочей области. Её lock-файл тоже читается и
записывается рядом со ссылкой, а не там, куда ведёт ссылка. Сама сущность Release не входит в число документов, которые
её собственный поиск встречает рядом с ней, поэтому она никогда не останавливает этот поиск; другая сущность Release рядом с ней, являющаяся
ссылкой за пределы, по-прежнему его останавливает. Сущность Manifest, которую вы проверяете отдельно через ссылку, читается и разрешается
таким же образом.
Каталог кэша артефактов является отдельным корнем, где бы он ни находился. Всё, что хранится в кэше,
записывается, читается и удаляется только внутри каталога кэша, поэтому собственный каталог кэша или
файл в нём, являющийся ссылкой за пределы каталога кэша, блокируется — даже если он ведёт в другое место
внутри рабочей области, — а ссылка, ведущая в другое место внутри каталога кэша, отслеживается. Где находится сам
каталог кэша, определяется по написанию его значения. Если он записан внутри корня рабочей области —
включая значение по умолчанию .aggrega/cache, — это собственный каталог рабочей области: каталог кэша, являющийся
ссылкой в другое место внутри рабочей области, отслеживается, а ведущий за пределы рабочей области отклоняется, как
при чтении, так и при записи. Если он записан с выходом за пределы (../shared-cache), это каталог, который называет конфигурация,
и он читается и записывается там, куда ведёт.
Импортируемый каталог
Импортируемый каталог является отдельным корнем, где бы он ни находился — как внутри рабочей области, так и вне её; этим он и отличается от любого другого каталога, указанного вами внутри рабочей области.
aggrega import, инструмент импорта ассистента и aggrega/import сеанса передают импортёру каждый
файл каталога под его местом в этом каталоге, поэтому всё, что они ему передают, читается только изнутри
каталога. Проверяется то, из чего импорт что-либо взял бы: ссылка на файл, который выбирает шаблон
импортёра — любого импортёра, если формат распознаётся, а не указан явно, — и ссылка
на каталог, в который никогда не выполняется вход. Такая ссылка, ведущая за пределы каталога, отклоняется до того, как будет прочитан хоть один
файл, даже если она ведёт в другое место внутри рабочей области, тогда как выбранная ссылка на файл
в другом месте внутри каталога читается там, куда она указывает, под собственным именем ссылки. Ссылка на файл, который не выбирает ни один
шаблон, не проверяется и не читается. Сам каталог используется так, как вы его указали: если он является
ссылкой, она прослеживается до места, на которое указывает.
Редактирование документа остаётся внутри
aggrega edit-document, редактирование документа и точка вставки языкового сервера, а также
edit-document и insertion-point ассистента действуют только на документ, который содержит рабочая область. Документ вне
рабочей области, указанный так напрямую или через ссылку, ведущую за её пределы, отклоняется на любой поверхности, и при этом ничего
не читается и не записывается — в том числе там, где указанный вами путь в остальных случаях учитывается.
Два транспорта ассистента
aggrega mcp предоставляет одни и те же инструменты двумя способами, и граница между ними различается, потому что различается вызывающая сторона.
- Через собственные потоки процесса клиент запустил сервер на вашей машине, поэтому вызов равносилен тому, что вы вводите команду в командной строке: аргумент-путь может быть абсолютным и может лежать вне рабочей области, вызов может указать собственные
workspace_rootиcatalog_dirs, а инструменты, запускающие командуaggregaв отдельном процессе, предлагаются. Только путь, который указывает вызов, принимается так, как указан. То, что операция затем читает и записывает от своего имени, ограничивается так же, как в терминале: листинг не читает через ссылку, ведущую наружу, ссылка, которую записывает документ, не покидает рабочую область, а запись не проходит через связанный каталог вывода или кэша. Содержимое рабочей области может направлять то, что запрашивает ассистент, поэтому на хосте, где эти инструменты — его единственный доступ к вашим файлам, документ в клонированной вами рабочей области всё равно может заставить его указать путь вне рабочей области и прочитать или записать его; в разделе что ассистент может делать, не спрашивая вас заранее вы задаёте, сколько он делает без запроса. - Через HTTP вызывающая сторона не владеет машиной, на которой работает сервер. Рабочая область — та, над которой был запущен сервер, и она неизменна в течение всего его существования; каждый аргумент-путь удерживается внутри неё и оценивается, как описано выше; вызов, указывающий
workspace_rootилиcatalog_dirsлибо выбирающий ключ подписи, хранящийся на хосте, отклоняется; а инструменты, запускающие командуaggrega, не предлагаются. Отказ называет аргумент и приводит относительное значение в том виде, в каком оно отправлено, но не называет ни корень рабочей области, ни то, куда привёл бы путь.
Когда что-то отклонено или останавливается
| Что вы видите | Что делать |
|---|---|
| Листинг называет ссылку среди тех, которые он не прочитал | Замените ссылку копией того, на что она ведёт; или, для сущностей, хранящихся в другом месте, укажите каталог, на который ведёт ссылка, в catalog_dirs; для сущности Release, хранящейся в другом месте, укажите её в workspace.releases или как build.authoring_release. |
E0321, чтение через ссылку за пределы каталога каталога сущностей или каталога сущности Release | Укажите каталог, на который ведёт ссылка, как каталог каталога сущностей или передайте его с --catalog, вместо того чтобы обращаться к нему через ссылку внутри такого каталога; или замените ссылку копией. Если ссылкой является сам каталог catalog, принятый по соглашению, укажите catalog или каталог, на который он ведёт, либо передайте любой из них с --catalog. |
E0321 для lock-файла сущности Release | Удалите ссылку и снова загрузите сущность Release — при этом рядом с ней будет записан новый lock-файл. Другого места для lock-файла нет. |
E0321 для файла рядом с сущностью | Замените ссылку самим файлом: переместите документ, являющийся сущностью, в отдельный каталог, а собранный .wasm положите рядом с его сущностью Plugin вместо ссылки на него. |
E0321 для файла конфигурации | Замените ссылку копией, хранящейся в рабочем пространстве. Конфигурация, общая для нескольких рабочих пространств, читается, если указать её как глобальный файл конфигурации с помощью --config или AGGREGA_CONFIG, — под собственными файлами каждого рабочего пространства. |
E0321 для кэша артефактов | Удалите ссылку; загрузка снова заполнит кэш. Чтобы хранить кэш в другом месте, задайте в artifact_cache_dir этот каталог, указанный относительно корня рабочего пространства (../shared-cache), вместо создания ссылки на него. |
E0321 для ссылки в загруженном репозитории | Ссылка закоммичена в репозитории, который указывает источник, — сообщение называет её по её месту в нём: измените её там — направьте её внутрь репозитория или закоммитьте сам файл — и укажите ревизию, содержащую это изменение. |
E0321 для ссылки в импортируемом вами каталоге | Храните в каталоге сам файл, а не ссылку на него, или импортируйте каталог, на который ведёт ссылка. Импортируемый каталог читается только изнутри него самого, где бы он ни находился. |
E0307 для module_subdir | Укажите каталог внутри репозитория: значение может спускаться ниже корня репозитория, но не может подниматься выше него. |
E0320, запись или удаление через ссылку | Удалите ссылку, которую называет сообщение, или сделайте так, чтобы она вела внутрь каталога, который называет сообщение, и выполните операцию снова. Ваши файлы сущностей тут ни при чём. |
E0324, ссылка, ведущая наружу | Указывайте сущность Aggregate, хранящуюся в другом месте, по её metadata.name и укажите её каталог каталога сущностей; храните сущность Manifest, сущность Release, которую называет extends:, и файл параметров внутри рабочего пространства — или, для документа, указанного вами извне, в его собственном каталоге; или откройте рабочее пространство в каталоге, содержащем оба документа. |
E0304, содержимое через ссылку | Замените ссылку копией того, на что она ведёт, внутри собственного каталога сущности. |
| Запрос языкового сервера отклонён из-за пути, ведущего наружу | Отправьте путь внутри рабочего пространства относительно его корня. К сущности Release, хранящейся вне рабочего пространства, можно обратиться, указав её в конфигурации — в workspace.releases или как build.authoring_release, — и указав в запросе ссылку внутри рабочего пространства, ведущую к ней, — то место, по которому её предлагает листинг сущностей Release. |
| Вызов ассистента по HTTP отклонён из-за пути | Отправьте путь относительно корня рабочего пространства, которое обслуживает сервер; если отказ предлагает относительную запись абсолютного пути, отправьте её. |
| Правка документа отклонена | Правьте документ, который содержит рабочее пространство; через ссылку на документ в другом месте правка не выполняется. |
См. также
- Конфигурация — где записывается каждый из приведённых выше параметров и как разрешается относительный путь в нём.
aggrega serveиaggrega mcp— каждый запрос и инструмент, а также какие из их параметров задают путь.- Фатальные остановки — полное описание каждого из приведённых выше условий.