Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

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.yaml berada di luar jika shared adalah 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 dist yang 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 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 .wasm hasil 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 menghentikan aggrega 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 dicantumkan aggrega cache status, aggrega cache prune, dan aggrega 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 dicetak aggrega 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, dengan E0320, 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 — termasuk module_subdir itu 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_subdir yang 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, dan aggrega/import milik 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.yaml dari akar hingga direktori tempat perintah dijalankan, serta .aggrega-config-append-ci.yaml milik 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. Perintah aggrega yang tidak pernah membacanya — version, help, completion, explain, get-schema, scaffold saat menyusun draf dokumen awal, skills list, plugin run-local, plugin sync, auth token, dan logout — berjalan seperti biasa, dengan peringatan yang menyebutkan tautan tersebut. scaffold --example membacanya, 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 dengan E0321 yang 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 oleh aggrega cache clear dan aggrega cache prune; draf yang ditulis oleh impor dan entitas Plugin yang ditulis oleh aggrega plugin gen-catalog; serta penanda .aggrega/active-release tempat editor mencatat Release bawaan, yang ditulis oleh server bahasa untuknya. dist yang 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_dirs dan catalog_dirs_append, untuk workspace atau untuk sebuah Release di bawah workspace.releases — file Release yang dikunci di bawah workspace.releases, build.authoring_release, file .wasm lokal dari lampiran plugin dan file di bawah with.sources-nya, mcp.tls.cert_file, mcp.tls.key_file, mcp.authorization.jwks_file, akar kepercayaan yang disematkan milik sebuah registry, dan artifact_cache_dir yang 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. Direktori catalog konvensional 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, sehingga catalog yang 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 mcp di 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 oleh aggrega/pluginGenCatalog beserta 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 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_root dan catalog_dirs miliknya sendiri, dan alat yang menjalankan perintah aggrega dalam 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_root atau catalog_dirs, atau yang memilih kunci penandatanganan yang disimpan di host, ditolak; dan alat yang menjalankan perintah aggrega tidak 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 lihatYang harus dilakukan
Sebuah daftar menyebut sebuah tautan di antara yang tidak dibacanyaGanti 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 ReleaseCantumkan 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 ReleaseHapus tautan dan tarik kembali Release tersebut, yang akan menulis lockfile baru di sampingnya. Lockfile tidak memiliki tempat lain.
E0321 pada file di samping sebuah entitasGanti 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 konfigurasiGanti 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 artefakHapus 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 diambilTautan 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 imporSimpan 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_subdirSebutkan direktori di dalam repositori: nilainya boleh turun di bawah puncak repositori, tetapi tidak boleh naik di atasnya.
E0320, penulisan atau penghapusan melalui tautanHapus 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 keluarSebutkan 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 tautanGanti tautan dengan salinan dari apa yang ditujunya, di dalam direktori milik entitas itu sendiri.
Permintaan language server ditolak karena path yang mengarah keluarKirim 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 pathKirim path relatif terhadap root workspace yang dilayani server; jika penolakan menawarkan ejaan relatif dari sebuah path absolut, kirim ejaan tersebut.
Pengeditan dokumen ditolakEdit 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 serve dan aggrega mcp — setiap permintaan dan tool, serta parameter mana saja yang menyebutkan path.
  • Penghentian fatal — entri lengkap untuk setiap kondisi di atas.