Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

Межа робочого простору

Робочий простір — це дерево каталогів, яке позначає корінь проєкту: корінь, у якому розташований блок 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 заради закріплених версій, щодо яких виконують розв’язання збірка, отримання, валідація, перевірка лінтером, інспекція, aggrega cache prune і запити редактора та асистента. Він обмежений там, де читається, так само, як там, де записується, тож lockfile, що є посиланням, яке веде назовні, зупиняє кожну з них, а не підсовує їм закріплені версії, збережені деінде на машині: E0321.
  • Файл, що читається поруч із сутністю — інші документи в каталозі сутності, яку ви закріплюєте або публікуєте, прочитані, щоб визначити, чи ділить цей каталог інша сутність, і зібраний .wasm, з якого завантажується сутність Plugin у каталозі сутностей. Кожен із них читається лише зсередини каталогу, під яким було прочитано власний документ сутності: робочого простору, названого вами каталогу сутностей поза ним або каталогу документа, який ви назвали поза ним. Тож файл, що є посиланням, яке веде назовні, зупиняє aggrega pin, aggrega push (зокрема й пробний запуск), отримання із закріпленням, а також закріплення й публікацію в редакторі та асистенті — непрочитаний документ міг би бути тією сутністю, що заважає, — і зупиняє збірку чи отримання, які завантажують плагін, а не запускають байти, збережені деінде на машині: E0321.
  • Кеш артефактів — усе, що Aggrega читає з кешу під artifact_cache_dir: кешовану сутність, плагін або бібліотеку та маніфест поруч із ними, архів джерела та його метадані, закріплений зовнішній вхід, пакет підпису й локальний пошуковий індекс реєстру, а також кожен запис робочого простору, який перелічують aggrega cache status, aggrega cache prune і aggrega cache clear. Кеш читається лише зсередини каталогу кешу, місця, куди він записується, тож будь-що в ньому, що є посиланням, яке веде за межі цього каталогу — як в інше місце робочого простору, так і будь-куди ще, — зупиняє збірку, отримання, валідацію, пошук, кожну з трьох команд кешу, а також запити редактора й асистента, які читають кеш, а не передає їм байти, збережені там, де кеш нічим не володіє, — включно із вмістом, перевіреним щодо записаного дайджесту, адже дайджест каже, що це за байти, а не звідки їх можна читати. Повідомлення про застарілість, яке друкує aggrega inspect і яке нічого не вирішує, сюди не належить. Очищення (prune або clear), яке натрапляє на власний каталог кешу, що є таким посиланням, або на каталог кешу, що сам є посиланням за межі робочого простору, сприймає це як видалення, яким воно було б, з E0320, ще до того, як щось перелічить: E0321.
  • Репозиторій, який отримує джерело — робоча копія, яку отримання архівує для джерела 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, яку ви називаєте через посилання, читається там, куди веде посилання, і розв’язується там, де ви її назвали. Якщо її введено як --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 — кожен запит та інструмент, а також які з їхніх параметрів задають шлях.
  • Фатальні зупинки — повний опис кожної з наведених вище умов.