Çalışma alanı sınırı
Çalışma alanı, bir proje kökünün belirlediği dizin ağacıdır — yapılandırmanızın workspace:
bloğunun bulunduğu kök, --workspace-root ile adlandırılan kök, bir düzenleyicinin açtığı klasör ya da bir asistan
sunucusunun üzerinde başlatıldığı klasör. Aggrega’nın kendi adına okuduğu ve yazdığı her şey bu ağaçla sınırlıdır;
yalnızca sizin ya da çalışma alanı yapılandırmasının ağacın dışında bir yer adlandırdığı durumlar bunun dışındadır. Ağacın içindeki bir sembolik bağlantı
makinedeki herhangi bir yeri gösterebilir; bu nedenle bir bağlantı yalnızca orada bulunduğu için asla çalışma alanının
parçası sayılmaz: önemli olan nereye çıktığıdır.
Bu sayfa kuralı bütünüyle ortaya koyar. Her yüzeyin sayfası — komut satırı, dil sunucusu ve asistan araçları — kendi isteklerinin bu kurala nasıl uyduğunu anlatır.
Çalışma alanının içinde kalanlar
Bir yol, var olan en derin kısmı, bağlantıları izlendiğinde çalışma alanı kökü olduğunda ya da onun altında yer aldığında çalışma alanının içindedir — kökün kendi bağlantıları da aynı şekilde izlenir; böylece kendi bağlantılarından biriyle ulaştığınız bir çalışma alanı, altındaki her şeyi yine kapsar.
Bir bağlantı üzerinden açtığınız kök, bağlantının götürdüğü çalışma alanıdır. Açtığınız klasör ister kendisi bir bağlantı olsun ister üstündeki bir bağlantı üzerinden ulaşılsın, Aggrega bağlantının götürdüğü çalışma alanında listeleyeceği, okuyacağı ve yazacağı şeylerin tam olarak aynısını listeler, okur ve yazar — onun Releases’ini, belgelerini, kilit dosyalarını — ve içindeki her bağlantıyı aynı şekilde değerlendirir. Bir yanıttaki her yol yine de kökten, verildiği haliyle yazılır — bir düzenleyicinin açtığı klasör, yazdığınız --workspace-root, kabuğunuzun çalıştığınızı söylediği dizin — böylece size gösterilenler, üzerinde çalıştığınız yollarla eşleşir.
Bu tek okuma her tür yolu kapsar:
- Bir yol hakkında karar veren, nasıl yazıldığı değil, nereye götürdüğüdür.
./shared/app.yaml, her kısmı çalışma alanının içinde yazılmış olsa dasharedbaşka bir yerdeki bir dizine bağlantı olduğunda dışarıdadır. Bir istek parametresi yine de kendine ait bir yazım isteyebilir — örneğin köke göreli bir yol — ve bunu kendi sayfası belirtir; bu, sınırla değil parametreyle ilgili bir kuraldır. - Henüz var olmayan bir yol, ona giden yoldaki dizinlere göre değerlendirilir. Bir derlemenin, dışarıya götüren bir bağlantı olan bir
distaltında oluşturmak üzere olduğu bir dosya, yazılmadan önce dışarıdadır. - Hiçbir yere ya da bir döngüye götüren bir bağlantı, var olan bir şey değildir. Bunun yerine onu barındıran dizin değerlendirilir ve bağlantının nereye gitmesi gerektiğini bulmak için hiçbir şey izlenmez. Böyle bir bağlantı tam olarak bir dosyanın oluşturulmak üzere olduğu yerde duruyorsa, dosya oraya yerleşeceği için gösterdiği yer de denetlenir.
- Çalışma alanının içinde başka bir yere giden bağlantı her zamanki gibi izlenir. Yalnızca dışarıya götüren bir bağlantı durdurulur.
Kural yalnızca bir yolun diskte nereye götürdüğünü değerlendirir, başka hiçbir şeyi değil. Hiçbir değer okumaz ve bir addan hiçbir çıkarım yapmaz.
Dışarı çıkan bir bağlantı ne yapar
Dışarı çıkan bir yola ne olacağı, yolun türüne bağlıdır. Üç sonuç vardır.
Okunmadı olarak listelenir
Aggrega’nın çalışma alanının içeriğini listelediği yerlerde, dışarı çıkan bir bağlantı okunmaz ve liste bunu belirtir. Bir düzenleyicinin seçim için sunduğu Releases, varlık dizini ve düzenleyicinin ondan aldığı tamamlamalar ve adaylar ile bir asistanın list-releases ve list-entities araçları, çalışma alanı dışındaki bir dizini aramaz veya dışarıdaki bir dosyayı okumaz; o dosya ne bildirirse bildirsin. Bu nedenle düzenleyicinizin böyle bir bağlantının altında gösterdiği bir varlık, çalışma alanının kendi varlığı olarak listelenmez. Release listeleri ve varlık listeleri böyle her bağlantıyı nereye çıktığıyla değil, çalışma alanındaki kendi yeriyle adlandırır: dil sunucusunda unreadLinkedDirs ve unreadLinkedFiles, asistan araçlarında unread_linked_dirs ve unread_linked_files. Yapılandırmanızın catalog_dirs altında listelediği bir dizine, bunlardan birinin altındaki bir dizine veya adlandırdığı bir Release’e giden bağlantı adlandırılmaz: aşağıda istisnaların açıkladığı gibi yapılandırma o yere ulaşmıştır; listelenen bir dizin altındaki her şeyle birlikte okunur. Dışarı çıkan bir bağlantı olan .gitignore da okunmaz; böylece makinenin başka bir yerindeki bir dosya, çalışma alanının hangi belgelerinin aranacağına asla karar vermez. Dışarı çıkan bir bağlantı olan çalışma alanı yapılandırma dosyası da okunmayan dosyalar arasında adlandırılır: bu listeler o çalışma alanı için yine yanıt verir ve hiçbir şey yapılandırılmamış olarak okunur; yapılandırmanın belirlediği her istek ise aşağıda çalışma alanının kendi yapılandırmasının açıkladığı gibi durur.
Reddedilir
Çağıranın onu yazan makine sahibi olmadığı durumlarda, bir isteğin adlandırdığı yol reddedilir. Aşağıdaki istisnalar dışında, bir düzenleyicinin aggrega serve’e yaptığı isteğin sunucunun okuması veya yazması için adlandırdığı her yol ve bir asistanın HTTP üzerinden erişilen bir sunucuya adlandırdığı her yol çalışma alanının içine çıkmalıdır; dışarı çıkan bir yol hiçbir şey okunmadan veya yazılmadan reddedilir ve ret, her yüzeyin sayfasında belirtildiği gibi parametreyi adlandırır. Belge düzenlemesi, komut satırı dahil her yüzeyde bu şekilde reddedilir; bkz. Belge düzenlemesi içeride kalır.
Durdurulur
Bir işlem kendi hesabına dışarı çıkan bir bağlantı üzerinden okuma veya yazma yapacaksa durur. Bunlar sizin adlandırdığınız yollar değil, ürünün kendisinin belirlediği yollardır ve birinin sessizce atlanması bir derlemenin anlamını değiştirebilir; bu nedenle her biri işlemi durdurur, bağlantıyı ve nereye çıktığını adlandırır ve bağlantının gösterdiği yeri tam olarak olduğu gibi bırakır:
- Bir aramanın okudukları — bir katalog dizininin altındaki bir belge ya da Aggregate’ini veya Manifest’ini kimliğiyle adlandıran bir Release’in yanındaki ya da genişlettiği Manifest’i bu şekilde adlandıran bir Manifest’in yanındaki bir belge. İşleme adı verilen Release veya Manifest bu belgelerden biri değildir: adlandırıldığı yerde okunmuştur; bkz. Bir bağlantı üzerinden adlandırılan Release veya Manifest.
Böyle bir bağlantıyı atlayan bir arama, onun yerine sonraki bir dizinden aynı adlı başka bir varlığı çözümleyebilir; bu nedenle bir derleme, bir çekme, bir doğrulama, kataloğu okuyan bir inceleme, tek bir Release’in veya tüm kataloğun lint denetimi ve düzenleyicinin ve bir asistanın bir Release’i derleyen, önizleyen, grafiğini çıkaran, doğrulayan, lint denetiminden geçiren veya tanımlayan istekleri, herhangi bir şey çözümlenmeden veya denetlenmeden önce durur:
E0321. - Bir Release’in kilit dosyası — bir derlemenin, bir çekmenin, bir doğrulamanın, bir lint denetiminin, bir incelemenin,
aggrega cache prune’un ve düzenleyicinin ve bir asistanın isteklerinin çözümlendiği sabitlemeler için Release’in yanında okunur. Okunduğu yerde de yazıldığı yerdeki gibi tutulur; bu nedenle dışarı çıkan bir bağlantı olan kilit dosyası, bunlara makinenin başka bir yerinde tutulan sabitlemeleri vermek yerine her birini durdurur:E0321. - Bir varlığın yanında okunan dosya — sabitlediğiniz veya yayımladığınız bir varlığın dizinindeki, başka bir varlığın o dizini paylaşıp paylaşmadığını anlamak için okunan diğer belgeler ve bir katalog dizinindeki bir Plugin varlığının yüklendiği derlenmiş
.wasm. Her biri yalnızca varlığın kendi belgesinin okunduğu dizinin içinden okunur: çalışma alanı, onun dışında adlandırdığınız bir katalog dizini veya onun dışında adlandırdığınız bir belgenin dizini. Bu nedenle dışarı çıkan bir bağlantı olan böyle bir dosyaaggrega pin’i,aggrega push’u (kuru çalıştırma dahil), sabitleme yapan bir çekmeyi ve düzenleyicinin ve bir asistanın sabitleme ve yayımlamasını durdurur (okunmadan bırakılan bir belge engel olan varlık olabilir) ve makinenin başka bir yerinde tutulan baytları çalıştırmak yerine plugin’i yükleyen bir derlemeyi veya çekmeyi durdurur:E0321. - Yapıt önbelleği — Aggrega’nın
artifact_cache_diraltındaki önbellekten okuduğu her şey: önbelleğe alınmış bir varlık, plugin veya kitaplık ve yanındaki manifest, bir kaynak arşivi ve meta verileri, sabitlenmiş bir harici girdi, bir imza paketi ve bir kayıt defterinin yerel arama dizini veaggrega cache status,aggrega cache pruneveaggrega cache clear’ın listelediği her çalışma alanı girdisi. Önbellek yalnızca yazıldığı yer olan önbellek dizininin içinden okunur; bu nedenle içinde o dizinin dışına çıkan bir bağlantı olan herhangi bir şey (çalışma alanının başka bir yerine de olsa, başka herhangi bir yere de olsa) bir derlemeyi, bir çekmeyi, bir doğrulamayı, bir aramayı, üç önbellek komutunun her birini ve düzenleyicinin ve bir asistanın önbelleği okuyan isteklerini, onlara önbelleğin sahip olmadığı bir yerde tutulan baytları vermek yerine durdurur; kaydedilmiş bir özete karşı denetlenen içerik de buna dahildir, çünkü bir özet baytların ne olduğunu söyler, nereden okunabileceklerini değil.aggrega inspect’in yazdırdığı ve hiçbir şeye karar vermeyen kullanımdan kaldırma bildirimi kapsam dışıdır. Bir budama veya temizleme, önbelleğin kendi dizinlerinden böyle bir bağlantı olan birine ya da kendisi çalışma alanının dışına çıkan bir bağlantı olan bir önbellek dizinine rastladığında, bunu olacağı silme işlemi olarak ele alır ve herhangi bir şeyi listelemeden önceE0320ile durur:E0321. - Bir kaynağın getirdiği depo — bir çekmenin
git-repositorykaynağı için arşivlediği çalışma kopyası. Çalışma kopyası kendi başına bir dizindir; bu nedenle deponun taşıdığı bir bağlantı, yalnızca gösterdiği yer deponun içindeyse gösterdiği şey olarak arşivlenir; depodan dışarı çıkan ve çekmeyi çalıştıran makinedeki herhangi bir dosyaya ulaşabilecek bir bağlantı, hiçbir şey önbelleğe alınmadan, bağlantıyı ve nereye çıktığını adlandırarak çekmeyi durdurur; böyle bir bağlantı olduğu durumdamodule_subdir’in kendisi de buna dahildir:E0321. Çekme durduğunda çalışma kopyası ortadan kalkar; bu nedenle ileti bağlantıyı depodaki yeriyle ve kaynağın adlandırdığı depo ve revizyonla adlandırır. Yazıldığı hâliyle deponun üstüne çıkan birmodule_subdir, depo getirilmeden önce reddedilir; böylece çalışma kopyasının yanında hiçbir şey okunmaz:E0307. - İçe aktardığınız bir dizinin dosyaları —
aggrega import, asistanın içe aktarma aracı ve oturumunaggrega/importisteği, bir dizin verildiğinde, o dizinin içe aktarıcının dosya desenlerinin seçtiği dosyalarını okur. Dizin nerede bulunursa bulunsun kendi başına bir köktür — bkz. İçe aktardığınız bir dizin — bu nedenle bu dosyalar arasında dizinin dışına çıkan bir bağlantı ya da dizinin dışına çıkan bir dizine giden bir bağlantı, dizinin hiçbir dosyası okunmadan önce içe aktarmayı bağlantıyı adlandırarak durdurur:E0321. - Çalışma alanının kendi yapılandırması — kökten bir komutun çalıştığı dizine kadar her
.aggrega-config.yamlve bunlardan herhangi birinin yanındaki bir işlem hattının.aggrega-config-append-ci.yamldosyası. Yapılandırmayı okuyan her komut, dil sunucusu ve bir asistanın araçları yapılandırmayı her şeyden önce okur; bu nedenle bu dosyalardan dışarı çıkan bir bağlantı olanı, onları geriye kalanlardan oluşturulmuş bir yapılandırmayla çalıştırmak yerine her birini orada durdurur:E0321. Yapılandırmayı hiç okumayanaggregakomutları —version,help,completion,explain,get-schema, bir başlangıç belgesinin taslağını hazırlayanscaffold,skills list,plugin run-local,plugin sync,auth tokenvelogout— bağlantıyı adlandıran bir uyarıyla her zamanki gibi çalışır.scaffold --exampleise varsayılan kayıt defteri ve imza ilkesi için yapılandırmayı okur ve onu okuyan diğer her şey gibi orada durur. Dil sunucusu ve kendi akışları üzerinden konuşan bir asistan sunucusu, içerdikleri listelenebilsin diye böyle bir çalışma alanı üzerinde yine de başlar: Release ve varlık listeleri, hiçbir katalog dizini ve başka hiçbir şey yapılandırılmamış olarak okunup yanıt verir ve dosyayı okunmayan bağlantılar arasında adlandırır. Yapılandırmanın belirlediği diğer her istek — bir derleme, bir önizleme, bir grafik, bir doğrulama, bir lint, bir açıklama, etkin yapılandırma, varsayılan Release — bağlantıyı adlandıranE0321ile durur; adresini ve yetkilendirmesini yapılandırmanın belirleyeceği, HTTP üzerinden dinlemesi istenen bir asistan sunucusu da öyle. - Bir işlemin yazdığı veya kaldırdığı şeyler — bir derlemenin çıktı dizini, sınır dizinleri ve oraya yazılan her dosya, iz kaydı; bir Release’in kilit dosyası ve yanındaki eklenti güven kaydı; bir
entity.lock; bir komutun yazdığı çalışma alanı yapılandırma dosyası; yapıt önbelleği ve bir çekmenin doldurduğu ya daaggrega cache clearveaggrega cache prunekomutlarının boşalttığı her bölümü; bir içe aktarmanın yazdığı taslaklar veaggrega plugin gen-catalogkomutunun yazdığı Plugin varlıkları; ve bir düzenleyicinin varsayılan bir Release’i kaydettiği, dil sunucusunun onun için yazdığı.aggrega/active-releaseişaretçisi. Bağlantı olan birdist, aksi hâlde “çıktıyı yeniden derle” işlemini makinede başka bir yerdeki bir dizini silmeye dönüştürürdü:E0320. - Bir belgenin bir yolla adlandırdığı şeyler — bkz. Bir belgenin yazdığı başvuru:
E0324. - Bir varlığın bildirdiği içerik — yolu, varlığın kendi dizininin dışına çıkan bir bağlantı olan bir dizinden geçen ve bir yayının aksi hâlde varlığın içindeki bir ad altında taşıyacağı bir
source:veya$import::E0304.
Bunlar işlemi kim başlatmış olursa olsun geçerlidir — komut satırı, bir düzenleyici ya da iki aktarım yönteminden herhangi biri üzerindeki bir asistan — çünkü yol çağıranın değil, çalışma alanının ve ürünündür.
Bir belgenin yazdığı başvuru
Bir Release ve bir Manifest başka bir dosyayı yol ile adlandırabilir: bir Release’in ./… veya ../… olarak yazılmış aggregate: ve manifest: alanları, extends: alanı, bir Manifest’in yol olarak yazılmış extends: alanı ve bir Release’in parameters: { $import: … } alanı. Çalışma alanındaki bir belge bu yolla yalnızca çalışma alanının içindeki dosyalara ulaşır — yazıldığı hâliyle dışarı tırmanan bir yol reddedilir; yazıldığı hâliyle içeride kalan ancak yol üzerinde dışarı çıkan bir bağlantıyla karşılaşan yol da reddedilir. Her iki durumda da adlandırılan dosyadan hiçbir şey okunmaz.
Klonladığınız bir çalışma alanı, yazarının başvurularını taşır; bu nedenle sizin adlandırdıklarınızı sınırlayıp bir belgenin ardından yönlendirdiği her şeyi izlemek, sınırı tek bir ../ uzaklıkta bırakırdı. Bir belgenin başka bir yerde tutulan bir varlığa ihtiyaç duyduğu durumda, belge bir dosya yerine varlığı adlandırır — aggregate: payments — ve çalışma alanı yapılandırması onu barındıran katalog dizinini listeler. Bir ad izlenmez, aranır; bu nedenle burada hiçbir zaman reddedilmez.
Çalışma alanının dışında bulunan ve siz adlandırdığınız için kabul edilen bir Release veya Manifest yalnızca kendi dizinindeki dosyalara ulaşır — bkz. Bir istisna adlandırdığı dizine ulaşır, daha ötesine değil.
İstisnalar ve her birinin neden istisna olduğu
Bu sınıflardan birine giren bir yol, çalışma alanının içinde olsun ya da olmasın, götürdüğü yerde kabul edilir. Her biri bir yerler listesi değil bir yol sınıfıdır ve her biri kendine özgü bir nedenle istisnadır.
- Çalışma alanı yapılandırmasının adlandırdıkları. Katalog dizinleri — çalışma alanı için ya da
workspace.releasesaltındaki bir Release içincatalog_dirsvecatalog_dirs_append—workspace.releasesaltında anahtarlanan Release dosyaları,build.authoring_release, bir eklenti bağlantısının yerel.wasmdosyası vewith.sourcesaltındaki dosyaları,mcp.tls.cert_file,mcp.tls.key_file,mcp.authorization.jwks_file, bir kayıt defterinin sabitlenmiş güven kökü ve çalışma alanı kökünün dışına çıkan birartifact_cache_dir. Yapılandırmada bir yol adlandırmak, bir çalışma alanının kendi dışına ulaşmasının bilinçli yoludur: bir kez yazılır, projeyle birlikte tutulur ve onu inceleyen herkes tarafından okunur. Çalışma alanının uzlaşımsalcatalogdizini, yapılandırma onu listelediğinde ya da siz onu--catalogile verdiğinizde — ya da götürdüğü yeri herhangi bir yazımla veya o yerin üstündeki bir dizini listelediğinde ya da siz verdiğinizde; bu durumda orada bulunanı bir kez, adlandırdığınız dizin üzerinden okur — adlandırılmış sayılır. Yalnızca orada bulunduğu için okunduğunda çalışma alanının kendi içeriğidir; bu nedenle çalışma alanının dışına çıkan bir bağlantı olan bircatalog, siz onu ya da götürdüğü yeri adlandırana kadar okunmaz. - Komut satırına yazdığınız bir yol.
aggrega build --release ../other/release.yaml,--catalog /srv/shared-catalog,--output-dir, doğrulanacak, lint edilecek, sabitlenecek ya da yayımlanacak bir dosya: her biri götürdüğü yerde kullanılır — aşağıdaki belge düzenleme hariç. Komutun çalıştığı makine sizindir ve yazabileceğiniz her şeyi zaten okuyup yazabilirsiniz; bu nedenle sizi bir dizine bağlamak hiçbir şey kazandırmaz. - Bir asistanın sürecin kendi akışları üzerinden adlandırdığı bir yol. Makinenizde
aggrega mcpkomutunu başlatan bir istemci sizin adınıza çalışır ve ana bilgisayarı genellikle ona kendi dosya ve kabuk araçlarını verir; bu nedenle adlandırdığı bir yol sizin yazmışsınız gibi kabul edilir — bkz. İki asistan aktarımı. - Ürünün makine genelindeki depoları — genel yapılandırma dosyası, derlenmiş modül deposu, eklenti tanımlayıcı önbelleği, belge paketi ve kayıt defteri kimlik bilgisi deposu. Bunlar herhangi bir çalışma alanına değil makineye aittir; bu nedenle hiçbir çalışma alanı onları kapsamaz.
- Bir iletişim kutusunda seçilen ve bulunduğu yerde okunan bir dosya ya da dizin. Bir düzenleyici, bir kayıt defteri kaydının anahtar dosyasını ya da güven kökünü,
aggrega/importtarafından dönüştürülen açıklamayı — bir dosya ya da dosyalarını içe aktarıcının okuduğu bir dizin — veaggrega/pluginGenCatalogtarafından yanındaki katmanla birlikte kendisi için bir varlık üretilen modülü mutlak yol olarak gönderir. Her birini, nerede tutuyor olursa olsun, bir kişi seçmiştir. Bunlar yalnızca okunur: bir isteğin yazdığı hiçbir şey bu şekilde seçilmiş bir yola gitmez. Bu şekilde seçilen bir dizin, içe aktardığınız her dizin gibi kendi içiyle sınırlıdır. - Düzenleyicinizin açık tuttuğu bir belge. Onu doğrulamak, tanılamalarını istemek ya da bırakmak, üzerine gelmek, tamamlamak, çözümlemek ve içindeki başvuruları ve uygulamaları bulmak, düzenleyicinin gönderdiği içerikten yanıtlanır; bu nedenle onu adlandıran yolda hiçbir dosya okunmaz ve yol, götürdüğü yer nedeniyle asla reddedilmez. Belgeyi diskten okuyan bir istek, yukarıdaki reddedilen türdendir.
Komut satırına yazılan yollar ve makine genelindeki depolar hiç değerlendirilmez; diğerleri, onları taşıyan isteğe göre değil, her zaman sınıflarına göre geçirilir.
Bir istisna adlandırdığı dizine ulaşır, daha ötesine değil
Çalışma alanının dışında adlandırdığınız bir dizin, altında okunan ya da yazılan her şey için kendi başına bir köktür. Dizinin kendisi adlandırdığınız gibi kullanılır — bağlantı olan bir dizin gösterdiği yere izlenir — ve altında, onun dışına çıkan bir bağlantı, çalışma alanı içindeki bir bağlantı gibi tutulur: bir listelemede okunmaz, bir aramayı ya da yazmayı durdurur. Böylece çalışma alanının dışında listelediğiniz bir katalog dizini, aggrega plugin gen-catalog ya da aggrega import komutuna verdiğiniz bir çıktı dizini ve çalışma alanının dışına çıkan bir artifact_cache_dir, altındakileri kendi içinde tutar. Adlandırdığınız bir dizin çalışma alanının içindeyse kök çalışma alanıdır — nerede olursa olsun kendi başına bir kök olan, içe aktardığınız bir dizin hariç.
Adlandırdığınız bir dizin, altına herhangi bir şey yerleştirilmeden önce çalıştığınız klasöre göre çözümlenir.
aggrega import komutuna göreli olarak yazıp verdiğiniz bir çıktı dizini, komutu çalıştırdığınız klasördeki o adı taşıyan klasördür ve Windows’ta yalın olarak adlandırdığınız bir sürücü — D: — o sürücüdeki geçerli klasördür. Dizin önce tam yola dönüştürülür ve her dosya bu tam yolun altına yerleştirilir; böylece adı bir ayırıcıyla başlayan bir dosya, örneğin \notes.txt, sürücünün en üstüne değil adlandırdığınız dizinin içine düşer ve komutun bildirdiği dizin, yazılan dizindir.
Çalışma alanının dışında adlandırdığınız bir Release ya da Manifest, bir dosya için okunan aynı kuraldır: kendi dizini köktür; bu nedenle bir yolla adlandırdığı şey — ve extends: zincirinin götürdüğü her Release’in adlandırdığı şey — o dizinin içinde kalmalıdır. Aggregate’i ve Manifest’i ile yan yana tutulan bir Release her yerden derlenir; olağan releases/ düzeninde bulunan ve ../aggregates/app.yaml dosyasını adlandıran bir Release ise kendi çalışma alanından derlenir.
Bir bağlantı üzerinden adlandırılan bir Release ya da Manifest
Bir bağlantı üzerinden adlandırdığınız bir Release, bağlantının götürdüğü yerde okunur ve adlandırdığınız yerde çözümlenir.
release.yaml başka bir yerde tutulan bir dosyaya bağlantıyken --release release.yaml olarak yazıldığında — ya da workspace.releases altında veya build.authoring_release olarak bu şekilde adlandırıldığında — Release, bağlantının götürdüğü yerden okunur. Kimlikle ya da bir yolla adlandırdığı Aggregate ve Manifest, bağlantının yanında, onu adlandırdığınız dizinde aranır ve o dizinin köküyle sınırlanır: çalışma alanı ya da çalışma alanının dışındaysa dizinin kendisi. Kilit dosyası da bağlantının götürdüğü yerde değil, her zaman bağlantının yanında okunur ve yazılır. Release, kendi aramasının yanında karşılaştığı belgelerden biri değildir; bu nedenle o aramayı asla durdurmaz; yanında tutulan ve dışarı çıkan bir bağlantı olan başka bir Release ise yine durdurur. Bir bağlantı üzerinden tek başına incelediğiniz bir Manifest de aynı şekilde okunur ve çözümlenir.
Yapıt önbelleği dizini, nerede olursa olsun kendi başına bir köktür. Önbelleğin tuttuğu her şey yalnızca önbellek dizininin içinde yazılır, okunur ve kaldırılır; bu nedenle önbelleğin kendi dizinlerinden biri ya da bunlardan birindeki bir dosya, önbellek dizininin dışına çıkan bir bağlantıysa — çalışma alanının içinde başka bir yere götürse bile — tutulur; önbellek dizininin içinde başka bir yere götüren ise izlenir. Önbellek dizininin kendisinin nerede olduğu, değerinin nasıl yazıldığından okunur. Çalışma alanı kökünün içinde yazıldığında — varsayılan .aggrega/cache dahil — çalışma alanının kendi dizinidir: çalışma alanı içinde başka bir yere bağlantı olan bir önbellek dizini izlenir, çalışma alanının dışına çıkan ise okuma için de yazma için de reddedilir. Dışarı çıkacak şekilde yazıldığında (../shared-cache), yapılandırmanın adlandırdığı bir dizindir ve götürdüğü yerde okunur ve yazılır.
İçe aktardığınız bir dizin
İçe aktardığınız bir dizin, nerede olursa olsun kendi başına bir köktür — çalışma alanının dışında olduğu kadar içinde de; çalışma alanı içinde adını verdiğiniz diğer her dizinden ayrıldığı nokta budur.
aggrega import, asistanın içe aktarma aracı ve oturumun aggrega/import isteği, dizindeki her dosyayı içe aktarıcıya o dizindeki yeri altında verir; dolayısıyla içe aktarıcıya verilen her şey yalnızca dizinin içinden okunur. Değerlendirilen, içe aktarmanın bir şey alacağı yerlerdir: içe aktarıcının bir kalıbının seçtiği bir dosyaya giden bağlantı — biçimin adıyla belirtilmeyip tanındığı durumda herhangi bir içe aktarıcınınki — ve hiçbir zaman içine girilmeyen bir dizine giden bağlantı. Bunlardan dizinin dışına çıkan biri, çalışma alanının başka bir yerine çıksa bile, herhangi bir dosya okunmadan önce reddedilir; dizinin başka bir yerindeki bir dosyaya giden seçilmiş bir bağlantı ise gösterdiği yerden, bağlantının kendi adı altında okunur. Hiçbir kalıbın seçmediği bir dosyaya giden bağlantı ne değerlendirilir ne de okunur. Dizinin kendisi, adını verdiğiniz şekilde kullanılır; bağlantı olan bir dizin gösterdiği yere kadar izlenir.
Belge düzenlemesi içeride kalır
aggrega edit-document, dil sunucusunun belge düzenlemesi ve ekleme noktası ile asistanın
edit-document ve insertion-point araçları yalnızca çalışma alanının taşıdığı bir belge üzerinde işlem yapar. Çalışma alanının dışındaki bir belge, ister yazıldığı haliyle ister dışarı çıkan bir bağlantı üzerinden olsun, her yüzeyde hiçbir şey okunmadan veya yazılmadan reddedilir — adını verdiğiniz bir yolun normalde dikkate alındığı durumlar da buna dahildir.
İki asistan aktarımı
aggrega mcp aynı araçları iki yolla sunar ve sınır bu ikisi arasında farklıdır, çünkü çağıran taraf farklıdır.
- Sürecin kendi akışları üzerinden, sunucuyu sizin makinenizde istemci başlatmıştır; dolayısıyla bir çağrı, sizin komut satırında yazmanız demektir: bir yol argümanı mutlak olabilir ve çalışma alanının dışında bulunabilir, bir çağrı kendi
workspace_rootvecatalog_dirsdeğerlerini adlandırabilir ve ayrı bir süreçte biraggregakomutu çalıştıran araçlar sunulur. Yalnızca çağrının adlandırdığı yol, adlandırıldığı gibi kabul edilir. İşlemin ardından kendi hesabına okuduğu ve yazdığı şeyler ise bir terminaldeki gibi sınırlandırılır: bir listeleme dışarı çıkan bir bağlantı üzerinden okuma yapmaz, bir belgenin yazdığı bir başvuru çalışma alanından çıkmaz ve bir yazma işlemi bağlantılı bir çıktı ya da önbellek dizini üzerinden geçmez. Çalışma alanı içeriği bir asistanın ne istediğini yönlendirebilir; bu nedenle bu araçların dosyalarınıza tek erişim yolu olduğu bir ana makinede, klonladığınız bir çalışma alanındaki bir belge yine de asistanı çalışma alanı dışındaki bir yolu adlandırmaya ve onu okutmaya ya da yazdırmaya yöneltebilir; bir asistanın size önce sormadan neler yapabileceği kendiliğinden ne kadar iş yapacağını ayarladığınız yerdir. - HTTP üzerinden, çağıran taraf sunucunun çalıştığı makinenin sahibi değildir. Çalışma alanı, sunucunun üzerinde başlatıldığı çalışma alanıdır ve sunucunun ömrü boyunca sabittir; her yol argümanı yukarıdaki gibi değerlendirilerek bu alanın içinde tutulur;
workspace_rootveyacatalog_dirsadlandıran ya da ana makinede tutulan bir imzalama anahtarını seçen bir çağrı reddedilir; ve biraggregakomutu çalıştıran araçlar sunulmaz. Bir ret, argümanı adlandırır ve göreli bir değeri gönderildiği gibi aktarır, ancak ne çalışma alanı kökünü ne de bir yolun nereye götürmüş olacağını adlandırır.
Bir şey reddedildiğinde veya durduğunda
| Gördüğünüz | Yapılacak |
|---|---|
| Bir listeleme, okumadıkları arasında bir bağlantıyı adlandırır | Bağlantıyı, yönlendirdiği şeyin bir kopyasıyla değiştirin; ya da başka yerde tutulan varlıklar için bağlantının yönlendirdiği dizini catalog_dirs altında listeleyin; başka yerde tutulan bir Release için onu workspace.releases altında veya build.authoring_release olarak adlandırın. |
E0321, bir katalog dizininden veya bir Release’in dizininden dışarı çıkan bir bağlantı üzerinden okuma | Bağlantının yönlendirdiği dizine, bir katalog dizininin altındaki bir bağlantı üzerinden ulaşmak yerine onu bir katalog dizini olarak listeleyin veya --catalog ile iletin; ya da bağlantıyı bir kopyayla değiştirin. Bağlantı uzlaşımsal catalog dizininin kendisiyse, catalog’u veya yönlendirdiği dizini listeleyin ya da ikisinden birini --catalog ile iletin. |
Bir Release’in kilit dosyasında E0321 | Bağlantıyı kaldırın ve Release’i yeniden çekin; bu, yanına yeni bir kilit dosyası yazar. Bir kilit dosyasının başka bir yeri yoktur. |
Bir varlığın yanındaki bir dosyada E0321 | Bağlantıyı dosyanın kendisiyle değiştirin: varlık olan bir belgeyi kendine ait bir dizine taşıyın ve derlenmiş .wasm dosyasına bir bağlantı yerine dosyanın kendisini Plugin varlığının yanına koyun. |
Bir yapılandırma dosyasında E0321 | Bağlantıyı çalışma alanında tutulan bir kopyayla değiştirin. Çalışma alanları arasında paylaşılan bir yapılandırma, --config veya AGGREGA_CONFIG ile genel yapılandırma dosyası olarak adlandırılarak, her çalışma alanının kendi dosyalarının altında okunur. |
Yapıt önbelleğinde E0321 | Bağlantıyı kaldırın; bir çekme işlemi önbelleği yeniden doldurur. Önbelleği başka bir yerde tutmak için, onu bağlamak yerine artifact_cache_dir değerini, çalışma alanı köküne göreli yazılmış olarak (../shared-cache) o dizine ayarlayın. |
Getirilmiş bir depodaki bir bağlantıda E0321 | Bağlantı, kaynağın adlandırdığı depoya işlenmiştir — mesaj onu oradaki yeriyle adlandırır: onu orada değiştirin — depo içine yönlendirin veya dosyanın kendisini işleyin — ve değişikliği taşıyan revizyonu adlandırın. |
İçe aktardığınız bir dizindeki bir bağlantıda E0321 | Dizinde dosyaya bir bağlantı yerine dosyanın kendisini tutun ya da bağlantının yönlendirdiği dizini içe aktarın. İçe aktardığınız bir dizin, nerede bulunursa bulunsun yalnızca kendi içinden okunur. |
Bir module_subdir üzerinde E0307 | Depo içinde bir dizin adlandırın: değer deponun tepesinin altına inebilir ancak onun üstüne çıkamaz. |
E0320, bir bağlantı üzerinden yazma veya kaldırma | Mesajın adlandırdığı bağlantıyı kaldırın ya da mesajın adlandırdığı dizinin içinde bir yere yönlendirin ve işlemi yeniden çalıştırın. Buna varlık dosyalarınızdaki hiçbir şey neden olmaz. |
E0324, dışarı çıkan bir başvuru | Başka yerde tutulan bir Aggregate’i metadata.name değeriyle adlandırın ve katalog dizinini listeleyin; bir Manifest’i, bir extends: ifadesinin adlandırdığı bir Release’i ve bir parametre dosyasını çalışma alanının içinde — ya da dışarıdan adlandırdığınız bir belge için kendi dizininde — tutun; veya çalışma alanını her iki belgeyi de içeren bir dizinde açın. |
E0304, bir bağlantı üzerinden içerik | Bağlantıyı, varlığın kendi dizini içinde, yönlendirdiği şeyin bir kopyasıyla değiştirin. |
| Dışarı çıkan bir yol nedeniyle reddedilen bir dil sunucusu isteği | Çalışma alanı içinde, köküne göreli bir yol gönderin. Çalışma alanı dışında tutulan bir Release’e, onu yapılandırmada workspace.releases altında veya build.authoring_release olarak adlandırarak ve istekte çalışma alanı içinde ona yönlendiren bağlantıyı — Release listelemesinin onu sunduğu yeri — adlandırarak ulaşılır. |
| HTTP üzerinden bir yol nedeniyle reddedilen bir asistan çağrısı | Sunucunun hizmet verdiği çalışma alanının köküne göreli bir yol gönderin; ret, mutlak bir yolun göreli yazımını sunuyorsa onu gönderin. |
| Reddedilen bir belge düzenlemesi | Çalışma alanının taşıdığı bir belgeyi düzenleyin; başka yerdeki bir belgeye giden bir bağlantı üzerinden düzenleme yapılmaz. |
Ayrıca bakınız
- Yapılandırma — yukarıdaki ayarların her birinin nereye yazıldığı ve içindeki göreli bir yolun nasıl çözümlendiği.
aggrega serveveaggrega mcp— her istek ve araç ile parametrelerinden hangilerinin bir yol adlandırdığı.- Ölümcül durmalar — yukarıdaki her koşulun tam kaydı.