Batas workspace
Workspace adalah pohon direktori yang ditandai oleh akar proyek — akar tempat blok workspace:
konfigurasi Anda berada, akar yang disebut oleh --workspace-root, folder yang dibuka editor, atau folder tempat server
asisten dijalankan. Semua yang dibaca dan ditulis Aggrega atas inisiatifnya sendiri dibatasi pada pohon tersebut,
kecuali jika Anda, atau konfigurasi workspace, menyebut suatu tempat di luarnya. Tautan simbolik di dalamnya
dapat menunjuk ke mana saja di mesin, sehingga sebuah tautan tidak pernah dianggap sebagai bagian dari workspace hanya karena
berada di sana: yang menentukan adalah ke mana tautan itu mengarah.
Halaman ini menyatakan aturan tersebut secara utuh. Halaman untuk setiap antarmuka — baris perintah, server bahasa, dan alat asisten — menjelaskan bagaimana permintaannya sendiri memenuhi aturan tersebut.
Apa yang berada di dalam workspace
Sebuah path berada di dalam workspace jika bagian terdalamnya yang ada, dengan link-linknya diikuti, adalah root workspace atau terletak di bawahnya — link milik root sendiri diikuti dengan cara yang sama, sehingga workspace yang Anda capai melalui link miliknya sendiri tetap mencakup segala sesuatu di bawahnya.
Root yang Anda buka melalui sebuah link adalah workspace yang dituju link tersebut. Baik folder yang Anda buka
itu sendiri sebuah link maupun dicapai melalui link di atasnya, Aggrega mencantumkan, membaca, dan menulis tepat apa yang
akan dilakukannya di workspace yang dituju link tersebut — Releases-nya, dokumen-dokumennya, lockfile-nya — dan menilai
setiap link di dalamnya dengan cara yang sama. Setiap path dalam sebuah jawaban tetap ditulis dari root sebagaimana root itu
diberikan — folder yang dibuka editor, --workspace-root yang Anda ketik, direktori yang menurut shell Anda
sedang Anda gunakan — sehingga apa yang ditampilkan kepada Anda sesuai dengan path yang sedang Anda gunakan.
Satu pembacaan itu mencakup setiap jenis path:
- Yang menentukan adalah ke mana sebuah path mengarah, bukan bagaimana path itu ditulis.
./shared/app.yamlberada di luar jikasharedadalah link ke direktori di tempat lain, meskipun setiap bagiannya ditulis di dalam workspace. Sebuah parameter request tetap dapat meminta penulisannya sendiri — misalnya path yang relatif terhadap root — dan halamannya sendiri menyatakan hal itu; itu adalah aturan tentang parameter tersebut, bukan tentang batas. - Path yang belum ada dinilai berdasarkan direktori-direktori yang dilalui menuju path tersebut. Sebuah file yang
akan dibuat oleh build di bawah
distyang merupakan link yang mengarah ke luar sudah berada di luar sebelum file itu ditulis. - Link yang tidak mengarah ke mana pun, atau berputar dalam loop, bukanlah sesuatu yang ada. Direktori yang memuatnya yang dinilai sebagai gantinya, dan tidak ada yang diikuti untuk mengetahui ke mana link itu seharusnya mengarah. Jika link semacam itu berada tepat di tempat sebuah file akan dibuat, tempat yang ditunjuknya juga diperiksa, karena di sanalah file itu akan berada.
- Link ke tempat lain di dalam workspace diikuti seperti biasa. Hanya link yang mengarah ke luar yang ditahan.
Aturan ini hanya menilai ke mana sebuah path mengarah di disk, tidak ada yang lain. Aturan ini tidak membaca nilai apa pun dan tidak menyimpulkan apa pun dari sebuah nama.
Apa yang dilakukan tautan yang mengarah ke luar
Apa yang terjadi pada path yang mengarah ke luar bergantung pada jenis path-nya. Ada tiga kemungkinan hasil.
Dicantumkan sebagai tidak dibaca
Ketika Aggrega mencantumkan isi workspace, tautan yang mengarah ke luar tidak dibaca, dan daftar tersebut
menyatakannya. Releases yang ditawarkan editor untuk dipilih, indeks entitas serta pelengkapan dan
kandidat yang diambil editor darinya, serta list-releases dan list-entities milik asisten tidak
menelusuri direktori di luar workspace atau membaca file di luarnya, apa pun yang dideklarasikan file itu — sehingga
entitas yang ditampilkan editor Anda di bawah tautan semacam itu tidak dicantumkan sebagai milik workspace. Daftar Release
dan daftar entitas menyebut setiap tautan semacam itu berdasarkan tempatnya sendiri di workspace, tidak pernah berdasarkan
tujuannya: unreadLinkedDirs dan unreadLinkedFiles pada language server,
unread_linked_dirs dan unread_linked_files pada alat asisten. Tautan ke direktori yang dicantumkan
konfigurasi Anda di bawah catalog_dirs, atau ke direktori di bawahnya, atau ke Release yang disebutnya,
tidak disebut: konfigurasi telah menjangkau tempat itu — direktori yang dicantumkan dibaca beserta seluruh isi
di bawahnya — sebagaimana dijelaskan pengecualian di bawah. File
.gitignore yang merupakan tautan yang mengarah ke luar juga tidak dibaca, sehingga file di tempat lain pada mesin tidak pernah
menentukan dokumen workspace mana yang ditelusuri. File konfigurasi workspace yang merupakan tautan
yang mengarah ke luar juga disebut di antara file yang tidak dibaca: daftar ini tetap menjawab untuk workspace tersebut,
dibaca tanpa konfigurasi apa pun, sementara setiap permintaan yang ditentukan konfigurasi akan berhenti, sebagaimana dijelaskan
konfigurasi milik workspace sendiri di bawah.
Ditolak
Path yang disebut dalam permintaan, ketika pemanggilnya bukan pemilik mesin yang mengetikkannya, ditolak. Selain
pengecualian di bawah, setiap path yang disebut permintaan editor ke
aggrega serve untuk dibaca atau ditulis server, dan setiap path yang disebut asisten ke server
yang dijangkau melalui HTTP, harus mengarah ke dalam workspace; path yang mengarah ke luar ditolak tanpa ada yang dibaca
atau ditulis, dan penolakan itu menyebut parameternya, sebagaimana diuraikan halaman masing-masing antarmuka. Pengeditan dokumen
ditolak dengan cara ini di setiap antarmuka, termasuk baris perintah — lihat
Pengeditan dokumen tetap di dalam.
Dihentikan
Ketika suatu operasi akan membaca atau menulis melalui tautan yang mengarah ke luar atas inisiatifnya sendiri, operasi itu berhenti. Ini adalah path yang ditentukan sendiri oleh produk, bukan path yang Anda sebut, dan melewatinya begitu saja dapat mengubah makna suatu build, sehingga masing-masing menghentikan operasi, menyebut tautan beserta tujuannya, dan membiarkan tempat yang dituju tautan itu persis seperti semula:
- Apa yang dibaca pencarian — dokumen di bawah direktori katalog, atau di samping Release yang menyebut
Aggregate atau Manifest-nya berdasarkan identitas, atau di samping Manifest yang menyebut Manifest yang diperluasnya dengan
cara itu. Release atau Manifest yang disebut untuk operasi tersebut bukan salah satu dokumen itu: ia dibaca
di tempat ia disebut — lihat Release atau Manifest yang disebut melalui tautan.
Pencarian yang melewatkan tautan semacam itu dapat me-resolve entitas lain
dengan nama yang sama dari direktori berikutnya sebagai gantinya, sehingga build, pull, validasi, inspeksi
yang membaca katalog, lint atas satu Release atau atas seluruh katalog, serta permintaan editor dan
asisten untuk build, pratinjau, graf, validasi, lint, atau deskripsi suatu Release semuanya berhenti sebelum
apa pun di-resolve atau diperiksa:
E0321. - Lockfile suatu Release — dibaca di samping Release untuk pin yang menjadi acuan resolve bagi build, pull, validasi, lint,
inspeksi,
aggrega cache prune, serta permintaan editor dan asisten. Lockfile dijaga di tempat ia dibaca sama seperti di tempat ia ditulis, sehingga lockfile yang merupakan tautan yang mengarah ke luar menghentikan masing-masing operasi itu alih-alih memberinya pin yang disimpan di tempat lain pada mesin:E0321. - File yang dibaca di samping entitas — dokumen lain di direktori entitas yang Anda pin atau publikasikan,
yang dibaca untuk mengetahui apakah ada entitas lain yang berbagi direktori itu, serta
.wasmhasil build tempat entitas Plugin di direktori katalog dimuat. Masing-masing hanya dibaca dari dalam direktori tempat dokumen entitas itu sendiri dibaca: workspace, direktori katalog yang Anda sebut di luarnya, atau direktori dokumen yang Anda sebut di luarnya. Jadi file semacam itu yang merupakan tautan yang mengarah ke luar menghentikanaggrega pin,aggrega push(termasuk dry run), pull yang melakukan pin, serta pin dan publikasi oleh editor dan asisten — dokumen yang tidak dibaca bisa jadi entitas yang menghalangi — dan menghentikan build atau pull yang memuat plugin alih-alih menjalankan byte yang disimpan di tempat lain pada mesin:E0321. - Cache artefak — semua yang dibaca Aggrega dari cache di bawah
artifact_cache_dir: entitas, plugin, atau library yang di-cache beserta manifest di sampingnya, arsip sumber dan metadatanya, input eksternal yang di-pin, bundel tanda tangan dan indeks pencarian lokal registry, serta setiap entri workspace yang dicantumkanaggrega cache status,aggrega cache prune, danaggrega cache clear. Cache hanya dibaca dari dalam direktori cache, tempat ia ditulis, sehingga apa pun di dalamnya yang merupakan tautan yang mengarah ke luar direktori itu — baik ke tempat lain di workspace maupun ke mana pun — menghentikan build, pull, validasi, pencarian, masing-masing dari tiga perintah cache, serta permintaan editor dan asisten yang membaca cache, alih-alih memberinya byte yang disimpan di tempat yang bukan milik cache — termasuk konten yang diperiksa terhadap digest yang tercatat, karena digest menyatakan apa byte-nya, bukan dari mana byte itu boleh dibaca. Pemberitahuan deprecation yang dicetakaggrega inspect, yang tidak menentukan apa pun, dikecualikan. Prune atau clear yang menemui salah satu direktori milik cache sendiri yang merupakan tautan semacam itu, atau direktori cache yang dirinya sendiri merupakan tautan yang mengarah ke luar workspace, memperlakukannya sebagai penghapusan yang akan terjadi, denganE0320, sebelum mencantumkan apa pun:E0321. - Repositori yang diambil suatu sumber — checkout yang diarsipkan pull untuk sumber
git-repository. Checkout adalah direktori tersendiri, sehingga tautan yang dibawa repositori diarsipkan sebagai apa yang ditujunya hanya jika tujuan itu berada di dalam repositori; tautan yang mengarah ke luarnya, yang dapat menjangkau file apa pun di mesin yang menjalankan pull, menghentikan pull dengan menyebut tautan beserta tujuannya, tanpa ada yang di-cache — termasukmodule_subdiritu sendiri, jika merupakan tautan semacam itu:E0321. Checkout sudah hilang begitu pull berhenti, sehingga pesan menyebut tautan berdasarkan tempatnya di repositori, beserta repositori dan revisi yang disebut sumber.module_subdiryang naik ke atas repositori sebagaimana tertulis ditolak sebelum repositori diambil, sehingga tidak ada yang di samping checkout yang dibaca:E0307. - Berkas-berkas dari direktori yang Anda impor —
aggrega import, alat impor milik asisten, danaggrega/importmilik sesi, bila diberi sebuah direktori, membaca berkas-berkas di dalamnya yang dipilih oleh pola berkas importer. Direktori tersebut merupakan akar tersendiri di mana pun letaknya — lihat Direktori yang Anda impor — sehingga tautan di antara berkas-berkas itu yang mengarah keluar darinya, atau tautan ke direktori yang mengarah keluar darinya, menghentikan impor dengan menyebutkan tautan tersebut sebelum satu pun berkas dari direktori itu dibaca:E0321. - Konfigurasi milik workspace itu sendiri — setiap
.aggrega-config.yamldari akar hingga direktori tempat perintah dijalankan, serta.aggrega-config-append-ci.yamlmilik pipeline di samping salah satunya. Setiap perintah yang membaca konfigurasi, server bahasa, dan alat-alat asisten membacanya sebelum hal lain, sehingga salah satu berkas ini yang berupa tautan yang mengarah keluar menghentikan masing-masing di titik itu alih-alih membiarkannya berjalan dengan konfigurasi yang tersusun dari apa pun yang tersisa:E0321. Perintahaggregayang tidak pernah membacanya —version,help,completion,explain,get-schema,scaffoldsaat menyusun draf dokumen awal,skills list,plugin run-local,plugin sync,auth token, danlogout— berjalan seperti biasa, dengan peringatan yang menyebutkan tautan tersebut.scaffold --examplemembacanya, untuk registry bawaan dan kebijakan tanda tangan, dan berhenti di titik itu seperti setiap pembaca lainnya. Server bahasa, dan server asisten yang berkomunikasi melalui stream-nya sendiri, tetap dimulai pada workspace seperti itu, agar isinya dapat didaftar: daftar Release dan entitas tetap menjawab, dibaca tanpa direktori katalog dan tanpa konfigurasi lain apa pun, serta menyebutkan berkas tersebut di antara tautan yang tidak dibaca. Setiap permintaan lain yang ditentukan oleh konfigurasi — build, pratinjau, graf, validasi, lint, deskripsi, konfigurasi efektif, Release bawaan — dihentikan denganE0321yang menyebutkan tautan tersebut, demikian pula server asisten yang diminta mendengarkan melalui HTTP, yang alamat dan otorisasinya akan ditetapkan oleh konfigurasi. - Apa yang ditulis atau dihapus oleh suatu operasi — direktori keluaran build, direktori batasnya, dan
setiap berkas yang ditulis di sana, jejak (trace); lockfile milik Release dan catatan kepercayaan plugin di sampingnya;
entity.lock; berkas konfigurasi workspace yang ditulis oleh suatu perintah; cache artefak dan setiap bagiannya yang diisi oleh pull atau dikosongkan olehaggrega cache cleardanaggrega cache prune; draf yang ditulis oleh impor dan entitas Plugin yang ditulis olehaggrega plugin gen-catalog; serta penanda.aggrega/active-releasetempat editor mencatat Release bawaan, yang ditulis oleh server bahasa untuknya.distyang berupa tautan akan mengubah “membangun ulang keluaran” menjadi penghapusan direktori di tempat lain pada mesin:E0320. - Apa yang disebutkan oleh dokumen melalui path — lihat Referensi yang ditulis oleh dokumen:
E0324. - Konten yang dideklarasikan oleh entitas —
source:atau$import:yang path-nya melewati direktori berupa tautan yang mengarah keluar dari direktori milik entitas itu sendiri, yang jika tidak demikian akan dibawa oleh publikasi dengan nama di dalam entitas:E0304.
Ketentuan ini berlaku siapa pun yang memulai operasi — baris perintah, editor, atau asisten pada salah satu transport — karena path tersebut milik workspace dan produk, bukan milik pemanggil.
Referensi yang ditulis sebuah dokumen
Sebuah Release dan sebuah Manifest dapat menyebut file lain melalui path: aggregate: dan manifest: milik Release
yang ditulis sebagai ./… atau ../…, extends:-nya, extends: milik Manifest yang ditulis sebagai path, dan
parameters: { $import: … } milik Release. Dengan cara itu, dokumen di dalam workspace hanya menjangkau file di dalam workspace — path yang keluar sebagaimana tertulis ditolak, demikian pula path yang tetap di dalam sebagaimana tertulis
tetapi menemui link yang mengarah keluar di tengah jalan. Tidak ada yang dibaca dari file yang disebut oleh keduanya.
Workspace yang Anda clone membawa referensi milik pembuatnya, sehingga membatasi apa yang Anda sebut sambil mengikuti
apa pun yang kemudian dituju sebuah dokumen akan menyisakan batas itu hanya sejauh satu ../. Jika sebuah dokumen memerlukan
entitas yang disimpan di tempat lain, dokumen itu menyebut entitas tersebut alih-alih sebuah file — aggregate: payments — dan
konfigurasi workspace mencantumkan direktori katalog yang memuatnya. Sebuah nama dicari, bukan diikuti, sehingga
nama tidak pernah ditolak di sini.
Sebuah Release atau Manifest yang berada di luar workspace, yang diterima karena Anda menyebutnya, hanya menjangkau file di direktorinya sendiri — lihat Pengecualian menjangkau direktori yang disebutnya, dan tidak lebih jauh.
Pengecualian, dan alasan masing-masing
Path dalam salah satu kelas ini diikuti ke mana pun ia mengarah, di dalam workspace atau tidak. Masing-masing adalah kelas path, bukan daftar lokasi, dan masing-masing menjadi pengecualian karena alasannya sendiri.
- Apa yang dinamai oleh konfigurasi workspace. Direktori katalognya —
catalog_dirsdancatalog_dirs_append, untuk workspace atau untuk sebuah Release di bawahworkspace.releases— file Release yang dikunci di bawahworkspace.releases,build.authoring_release, file.wasmlokal dari lampiran plugin dan file di bawahwith.sources-nya,mcp.tls.cert_file,mcp.tls.key_file,mcp.authorization.jwks_file, akar kepercayaan yang disematkan milik sebuah registry, danartifact_cache_diryang keluar dari akar workspace. Menamai path dalam konfigurasi adalah cara yang disengaja bagi sebuah workspace untuk menjangkau ke luar dirinya: path itu ditulis sekali, disimpan bersama proyek, dan dibaca oleh siapa pun yang meninjaunya. Direktoricatalogkonvensional milik workspace dianggap dinamai jika konfigurasi mencantumkannya atau Anda memberikannya dengan--catalog— atau mencantumkan, atau Anda memberikan, tempat yang dituju olehnya, dalam ejaan apa pun, atau direktori di atas tempat itu, yang kemudian membaca isi di sana satu kali, melalui direktori yang Anda namai. Jika dibaca hanya karena keberadaannya, direktori itu adalah konten milik workspace sendiri, sehinggacatalogyang berupa tautan yang mengarah ke luar workspace tidak dibaca sampai Anda menamainya atau tempat yang ditujunya. - Path yang Anda ketik di baris perintah.
aggrega build --release ../other/release.yaml,--catalog /srv/shared-catalog,--output-dir, file yang akan divalidasi, di-lint, disematkan, atau dipublikasikan: masing-masing digunakan di tempat yang dituju — kecuali penyuntingan dokumen, di bawah. Anda memiliki mesin tempat perintah dijalankan dan sudah dapat membaca dan menulis apa pun yang akan Anda ketik, sehingga membatasi Anda pada satu direktori tidak memberi manfaat apa pun. - Path yang dinamai asisten melalui stream milik proses itu sendiri. Klien yang menjalankan
aggrega mcpdi mesin Anda berjalan sebagai Anda, dan host-nya biasanya memberinya alat file dan shell sendiri, sehingga path yang dinamainya diikuti seolah-olah Anda yang mengetiknya — lihat Dua transport asisten. - Penyimpanan tingkat mesin milik produk — file konfigurasi global, penyimpanan modul terkompilasi, cache deskriptor plugin, bundel dokumentasi, dan penyimpanan kredensial registry. Semuanya milik mesin, bukan milik workspace mana pun, sehingga tidak ada workspace yang menampungnya.
- File atau direktori yang dipilih dalam dialog, dibaca di tempatnya. Editor mengirimkan file kunci atau akar
kepercayaan dari pendaftaran registry sebagai path absolut, deskripsi yang dikonversi oleh
aggrega/import— sebuah file, atau direktori yang file-filenya dibaca oleh importer — dan modul yang dibuatkan entitas olehaggrega/pluginGenCatalogbeserta overlay di sampingnya. Seseorang memilih masing-masing, di mana pun ia menyimpannya. Semuanya hanya dibaca: tidak ada yang ditulis oleh permintaan ke path yang dipilih dengan cara ini. Direktori yang dipilih dengan cara ini dibatasi pada dirinya sendiri, sebagaimana setiap direktori yang Anda impor. - Dokumen yang sedang dibuka editor Anda. Memvalidasinya, meminta diagnostiknya atau membuangnya, hover, pelengkapan, resolusi, serta pencarian referensi dan implementasi di dalamnya dijawab dari konten yang dikirim editor, sehingga tidak ada file yang dibaca di path yang menamainya, dan path itu tidak pernah ditolak karena tujuannya. Permintaan yang benar-benar membaca dokumen dari disk termasuk jenis yang ditolak di atas.
Path yang diketik di baris perintah dan penyimpanan tingkat mesin tidak pernah dinilai sama sekali; yang lainnya diloloskan berdasarkan kelasnya, tidak pernah berdasarkan permintaan yang kebetulan membawanya.
Pengecualian menjangkau direktori yang dinamainya, dan tidak lebih jauh
Direktori yang Anda namai di luar workspace adalah akar tersendiri untuk semua yang dibaca atau ditulis
di bawahnya. Direktori itu sendiri digunakan sebagaimana Anda menamainya — direktori yang berupa tautan diikuti ke tempat yang
ditunjuknya — dan tautan di bawahnya yang mengarah ke luar diperlakukan persis seperti tautan di dalam workspace: tidak
dibaca dalam daftar, dan menghentikan pencarian atau penulisan. Jadi direktori katalog yang Anda cantumkan di luar
workspace, direktori output yang Anda berikan ke aggrega plugin gen-catalog atau aggrega import, dan
artifact_cache_dir yang keluar dari workspace masing-masing membatasi apa yang ada di bawahnya pada dirinya sendiri. Jika direktori yang Anda namai berada di dalam
workspace, workspace-lah akarnya — kecuali direktori yang Anda impor, yang merupakan
akar tersendiri di mana pun letaknya.
Direktori yang Anda namai di-resolve terhadap folder tempat Anda menjalankan perintah sebelum apa pun ditempatkan di bawahnya.
Direktori output yang Anda berikan ke aggrega import, jika diketik relatif, adalah folder dengan nama itu di dalam
folder tempat Anda menjalankan perintah, dan drive yang Anda namai polos di Windows — D: — adalah folder saat ini di
drive tersebut. Direktori itu dijadikan path lengkap terlebih dahulu dan setiap file ditempatkan di bawah path lengkap itu, sehingga
file yang namanya diawali pemisah, misalnya \notes.txt, berada di dalam direktori yang Anda namai, bukan
di puncak drive, dan direktori yang dilaporkan perintah adalah direktori yang ditulisi.
Release atau Manifest yang Anda namai di luar workspace mengikuti aturan yang sama untuk file: direktorinya
sendiri adalah akarnya, sehingga apa yang dinamainya melalui path — dan apa yang dinamai setiap Release yang dituju oleh rantai
extends:-nya — harus tetap berada di dalam direktori itu. Release yang disimpan di samping Aggregate dan Manifest-nya dapat di-build
dari mana saja; Release dalam tata letak releases/ yang umum, yang menamai ../aggregates/app.yaml, di-build dari
workspace-nya sendiri.
Release atau Manifest yang dinamai melalui tautan
Release yang Anda namai melalui tautan dibaca di tempat yang dituju tautan, dan di-resolve di tempat Anda menamainya.
Jika diketik sebagai --release release.yaml dengan release.yaml berupa tautan ke file yang disimpan di tempat lain — atau dinamai
dengan cara itu di bawah workspace.releases, atau sebagai build.authoring_release — Release dibaca dari
tempat yang dituju tautan. Aggregate dan Manifest yang dinamainya, berdasarkan identitas atau path, dicari
di samping tautan, di direktori tempat Anda menamainya, dan dibatasi pada akar direktori itu: workspace,
atau direktori itu sendiri jika berada di luar workspace. Lockfile-nya juga dibaca dan
ditulis di samping tautan, tidak pernah di tempat yang dituju tautan. Release itu bukan salah satu dokumen yang ditemui
pencariannya sendiri di sampingnya, sehingga tidak pernah menghentikan pencarian itu; Release lain di sampingnya yang berupa
tautan yang mengarah ke luar tetap menghentikannya. Manifest yang Anda periksa sendiri melalui tautan dibaca dan di-resolve
dengan cara yang sama.
Direktori cache artefak adalah akar tersendiri, di mana pun letaknya. Semua yang disimpan cache
ditulis, dibaca, dan dihapus hanya di dalam direktori cache, sehingga salah satu direktori milik cache, atau
file di dalamnya, yang berupa tautan yang mengarah ke luar direktori cache ditahan — bahkan jika mengarah ke tempat lain
di dalam workspace — sedangkan yang mengarah ke tempat lain di dalam direktori cache diikuti. Letak direktori
cache itu sendiri dibaca dari cara nilainya dieja. Jika ditulis di dalam akar workspace —
termasuk default .aggrega/cache — direktori itu adalah direktori milik workspace: direktori cache yang berupa
tautan ke tempat lain di dalam workspace diikuti, dan yang mengarah ke luar workspace ditolak, baik untuk
membaca maupun menulis. Jika ditulis keluar (../shared-cache), direktori itu adalah direktori yang dinamai konfigurasi,
dibaca dan ditulis di tempat yang ditujunya.
Direktori yang Anda impor
Direktori yang Anda impor adalah root tersendiri, di mana pun letaknya — di dalam workspace maupun di luarnya, dan di situlah letak perbedaannya dari setiap direktori lain yang Anda sebutkan di dalam workspace.
aggrega import, alat impor milik asisten, dan aggrega/import milik sesi menyerahkan kepada importer setiap
file dari direktori tersebut di bawah tempatnya dalam direktori itu, sehingga apa yang diserahkan kepadanya hanya dibaca dari dalam
direktori. Yang dinilai adalah apa yang akan menjadi sumber pengambilan impor: tautan ke file yang dipilih oleh suatu pola
importer — pola importer mana pun, apabila formatnya dikenali alih-alih disebutkan — dan tautan
ke direktori, yang tidak pernah dimasuki. Tautan semacam itu yang mengarah ke luar direktori ditolak sebelum
file apa pun dibaca, bahkan apabila tautan itu mengarah ke tempat lain di dalam workspace, sedangkan tautan terpilih ke file
di tempat lain di dalam direktori dibaca di tempat yang ditunjuknya, dengan nama tautan itu sendiri. Tautan ke file yang tidak
dipilih oleh pola mana pun tidak dinilai dan tidak dibaca. Direktori itu sendiri digunakan sebagaimana Anda menyebutkannya; direktori yang merupakan
tautan diikuti ke tempat yang ditunjuknya.
Pengeditan dokumen tetap di dalam
aggrega edit-document, pengeditan dokumen dan titik penyisipan milik language server, serta
edit-document dan insertion-point milik asisten hanya bekerja pada dokumen yang dimuat oleh workspace. Dokumen di luar
workspace, baik sebagaimana tertulis maupun melalui tautan yang mengarah ke luarnya, ditolak di setiap antarmuka tanpa ada yang
dibaca atau ditulis — termasuk apabila path yang Anda sebutkan di luar itu dihormati.
Dua transport asisten
aggrega mcp menyajikan alat yang sama dengan dua cara, dan batasnya berbeda di antara keduanya karena pemanggilnya berbeda.
- Melalui stream milik proses itu sendiri, klien meluncurkan server di mesin Anda, sehingga sebuah panggilan sama dengan Anda mengetik di baris perintah: argumen path boleh absolut dan boleh berada di luar workspace, sebuah panggilan boleh menyebutkan
workspace_rootdancatalog_dirsmiliknya sendiri, dan alat yang menjalankan perintahaggregadalam proses terpisah ditawarkan. Hanya path yang disebutkan oleh panggilan yang dihormati sebagaimana disebutkan. Apa yang kemudian dibaca dan ditulis operasi atas inisiatifnya sendiri dibatasi seperti di terminal: sebuah listing tidak membaca melalui link yang mengarah ke luar, referensi yang ditulis sebuah dokumen tidak meninggalkan workspace, dan penulisan tidak melewati direktori output atau cache yang berupa link. Konten workspace dapat mengarahkan apa yang diminta asisten, sehingga pada host tempat alat-alat ini adalah satu-satunya jangkauan asisten ke berkas Anda, sebuah dokumen dalam workspace yang Anda clone tetap dapat menuntunnya untuk menyebutkan path di luar workspace dan membuatnya dibaca atau ditulis; apa yang dapat dilakukan asisten tanpa bertanya kepada Anda terlebih dahulu adalah tempat Anda mengatur seberapa banyak yang dilakukannya tanpa diminta. - Melalui HTTP, pemanggil tidak memiliki mesin tempat server berjalan. Workspace-nya adalah workspace tempat server dijalankan dan tetap selama masa hidupnya; setiap argumen path dibatasi di dalamnya, dinilai seperti di atas; panggilan yang menyebutkan
workspace_rootataucatalog_dirs, atau yang memilih kunci penandatanganan yang disimpan di host, ditolak; dan alat yang menjalankan perintahaggregatidak ditawarkan. Penolakan menyebutkan argumennya dan mengutip nilai relatif sebagaimana dikirim, tetapi tidak menyebutkan root workspace maupun ke mana sebuah path akan mengarah.
Ketika sesuatu ditolak atau terhenti
| Yang Anda lihat | Yang harus dilakukan |
|---|---|
| Sebuah daftar menyebut sebuah tautan di antara yang tidak dibacanya | Ganti tautan dengan salinan dari apa yang ditujunya; atau, untuk entitas yang disimpan di tempat lain, cantumkan direktori yang dituju tautan di bawah catalog_dirs; untuk Release yang disimpan di tempat lain, sebutkan di bawah workspace.releases atau sebagai build.authoring_release. |
E0321, pembacaan melalui tautan keluar dari direktori katalog atau direktori sebuah Release | Cantumkan direktori yang dituju tautan sebagai direktori katalog, atau berikan dengan --catalog, alih-alih menjangkaunya melalui tautan di bawah salah satunya; atau ganti tautan dengan salinan. Jika tautan tersebut adalah catalog konvensional itu sendiri, cantumkan catalog atau direktori yang ditujunya, atau berikan salah satunya dengan --catalog. |
E0321 pada lockfile sebuah Release | Hapus tautan dan tarik kembali Release tersebut, yang akan menulis lockfile baru di sampingnya. Lockfile tidak memiliki tempat lain. |
E0321 pada file di samping sebuah entitas | Ganti tautan dengan file itu sendiri: pindahkan dokumen yang merupakan entitas ke direktorinya sendiri, dan letakkan .wasm hasil build di samping entitas Plugin-nya, bukan tautan ke file tersebut. |
E0321 pada file konfigurasi | Ganti tautan dengan salinan yang disimpan di dalam workspace. Konfigurasi yang dibagikan antar-workspace dibaca dengan menyebutkannya sebagai file konfigurasi global, dengan --config atau AGGREGA_CONFIG, di bawah file milik masing-masing workspace. |
E0321 pada cache artefak | Hapus tautan; sebuah pull akan mengisi cache kembali. Untuk menyimpan cache di tempat lain, atur artifact_cache_dir ke direktori tersebut, ditulis relatif terhadap root workspace (../shared-cache), alih-alih menautkannya. |
E0321 pada tautan di repositori yang diambil | Tautan tersebut di-commit di repositori yang disebut oleh sumber — pesan menyebutkannya berdasarkan letaknya di sana: ubah di sana — arahkan ke dalam repositori, atau commit file itu sendiri — lalu sebutkan revisi yang memuat perubahan tersebut. |
E0321 pada tautan di direktori yang Anda impor | Simpan file itu sendiri di direktori, bukan tautan ke file tersebut, atau impor direktori yang dituju tautan. Direktori yang Anda impor hanya dibaca dari dalam dirinya sendiri, di mana pun letaknya. |
E0307 pada sebuah module_subdir | Sebutkan direktori di dalam repositori: nilainya boleh turun di bawah puncak repositori, tetapi tidak boleh naik di atasnya. |
E0320, penulisan atau penghapusan melalui tautan | Hapus tautan yang disebut pesan, atau buat tautan itu mengarah ke suatu tempat di dalam direktori yang disebut pesan, lalu jalankan operasi kembali. Tidak ada apa pun dalam file entitas Anda yang menyebabkannya. |
E0324, referensi yang mengarah keluar | Sebutkan Aggregate yang disimpan di tempat lain dengan metadata.name-nya dan cantumkan direktori katalognya; simpan Manifest, Release yang disebut oleh extends:, dan file parameter di dalam workspace — atau, untuk dokumen yang Anda sebutkan dari luar, di direktorinya sendiri; atau buka workspace pada direktori yang memuat kedua dokumen. |
E0304, konten melalui tautan | Ganti tautan dengan salinan dari apa yang ditujunya, di dalam direktori milik entitas itu sendiri. |
| Permintaan language server ditolak karena path yang mengarah keluar | Kirim path di dalam workspace, relatif terhadap root-nya. Release yang disimpan di luar workspace dijangkau dengan menyebutkannya dalam konfigurasi, di bawah workspace.releases atau sebagai build.authoring_release, dan menyebutkan dalam permintaan tautan di dalam workspace yang mengarah kepadanya — tempat yang ditawarkan oleh daftar Release untuknya. |
| Panggilan asisten melalui HTTP ditolak karena sebuah path | Kirim path relatif terhadap root workspace yang dilayani server; jika penolakan menawarkan ejaan relatif dari sebuah path absolut, kirim ejaan tersebut. |
| Pengeditan dokumen ditolak | Edit dokumen yang dimuat oleh workspace; tautan ke dokumen di tempat lain tidak diedit melaluinya. |
Lihat juga
- Konfigurasi — tempat setiap pengaturan di atas ditulis, dan cara path relatif di dalamnya di-resolve.
aggrega servedanaggrega mcp— setiap permintaan dan tool, serta parameter mana saja yang menyebutkan path.- Penghentian fatal — entri lengkap untuk setiap kondisi di atas.