Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

Ranh giới workspace

Một workspace là cây thư mục mà một thư mục gốc dự án đánh dấu — thư mục gốc chứa khối workspace: trong cấu hình của bạn, thư mục mà --workspace-root chỉ định, thư mục mà một trình soạn thảo đã mở, hoặc thư mục mà máy chủ của một trợ lý được khởi động trên đó. Mọi thứ Aggrega tự đọc và ghi đều bị giới hạn trong cây đó, trừ những nơi bạn, hoặc cấu hình workspace, chỉ định một vị trí bên ngoài nó. Một liên kết tượng trưng bên trong nó có thể trỏ tới bất kỳ đâu trên máy, vì vậy một liên kết không bao giờ được coi là một phần của workspace chỉ vì nó nằm ở đó: điều quyết định là nơi nó dẫn tới.

Trang này trình bày toàn bộ quy tắc. Các trang cho từng bề mặt — dòng lệnh, máy chủ ngôn ngữ và các công cụ trợ lý — cho biết các yêu cầu của riêng chúng tuân theo quy tắc này như thế nào.

Những gì nằm bên trong workspace

Một đường dẫn nằm bên trong workspace khi phần sâu nhất của nó đang tồn tại, với các liên kết của nó được lần theo, là gốc workspace hoặc nằm bên dưới gốc đó — các liên kết của chính gốc cũng được lần theo theo cùng cách, nên một workspace mà bạn đến được qua một liên kết của chính nó vẫn bao gồm mọi thứ bên dưới nó.

Một gốc mà bạn mở qua một liên kết là workspace mà liên kết đó dẫn tới. Dù thư mục bạn mở tự nó là một liên kết hay được đến qua một liên kết ở phía trên, Aggrega liệt kê, đọc và ghi đúng những gì nó sẽ làm trong workspace mà liên kết dẫn tới — các Releases, các tài liệu, các lockfile của nó — và đánh giá mọi liên kết bên trong nó theo cùng cách. Mọi đường dẫn trong một câu trả lời vẫn được viết từ gốc như khi nó được cung cấp — thư mục mà trình soạn thảo đã mở, --workspace-root mà bạn đã gõ, thư mục mà shell cho biết bạn đang làm việc — nên những gì bạn được hiển thị khớp với các đường dẫn bạn đang làm việc.

Cách hiểu duy nhất đó bao quát mọi loại đường dẫn:

  • Nơi một đường dẫn dẫn tới quyết định nó, chứ không phải cách nó được viết. ./shared/app.yaml nằm bên ngoài khi shared là một liên kết tới một thư mục ở nơi khác, dù mọi phần của nó đều được viết bên trong workspace. Một tham số của yêu cầu vẫn có thể đòi một cách viết riêng — chẳng hạn một đường dẫn tương đối so với gốc — và trang riêng của nó nói rõ điều đó; đó là một quy định về tham số, không phải về ranh giới.
  • Một đường dẫn chưa tồn tại được đánh giá theo các thư mục trên đường dẫn tới nó. Một tệp mà một bản build sắp tạo bên dưới một dist là liên kết dẫn ra ngoài thì nằm bên ngoài ngay trước khi nó được ghi.
  • Một liên kết không dẫn tới đâu, hoặc dẫn vòng lặp, không phải là thứ đang tồn tại. Thay vào đó, thư mục chứa nó được đánh giá, và không có gì được lần theo để tìm xem liên kết đó định dẫn tới đâu. Khi một liên kết như vậy nằm đúng chỗ một tệp sắp được tạo, nơi nó trỏ tới cũng được kiểm tra, vì đó là nơi tệp sẽ được đặt.
  • Một liên kết tới nơi khác bên trong workspace được lần theo như thường lệ. Chỉ một liên kết dẫn ra ngoài mới bị chặn lại.

Quy định này chỉ đánh giá nơi một đường dẫn dẫn tới trên đĩa và không gì khác. Nó không đọc giá trị nào và không suy ra điều gì từ một cái tên.

Điều gì xảy ra với một đường dẫn dẫn ra ngoài phụ thuộc vào loại đường dẫn đó. Có ba kết quả.

Được liệt kê là không đọc

Khi Aggrega liệt kê những gì workspace chứa, một liên kết dẫn ra ngoài không được đọc, và danh sách nói rõ điều đó. Các Releases mà trình soạn thảo đưa ra để chọn, chỉ mục entity cùng các gợi ý hoàn thành và ứng viên mà trình soạn thảo lấy từ đó, cũng như list-releases và list-entities của trợ lý đều không tìm trong thư mục bên ngoài workspace hay đọc tệp bên ngoài nó, bất kể tệp đó khai báo gì — vì vậy một entity mà trình soạn thảo hiển thị dưới liên kết như vậy không được liệt kê là của chính workspace. Các danh sách Release và danh sách entity nêu tên mọi liên kết như vậy theo vị trí của chính nó trong workspace, không bao giờ theo nơi nó dẫn tới: unreadLinkedDirs và unreadLinkedFiles trên language server, unread_linked_dirs và unread_linked_files trên các công cụ của trợ lý. Một liên kết tới một thư mục mà cấu hình của bạn liệt kê trong catalog_dirs, hoặc tới một thư mục bên dưới thư mục đó, hoặc tới một Release mà cấu hình nêu tên, thì không được nêu tên: cấu hình đã đi tới nơi đó — một thư mục được liệt kê được đọc cùng mọi thứ bên dưới nó — như các ngoại lệ bên dưới mô tả. Một .gitignore là liên kết dẫn ra ngoài cũng không được đọc, nên một tệp ở nơi khác trên máy không bao giờ quyết định tài liệu nào của workspace được tìm kiếm. Một tệp cấu hình workspace là liên kết dẫn ra ngoài cũng được nêu tên trong số các tệp không đọc: các danh sách này vẫn trả lời cho workspace đó, được đọc mà không có gì được cấu hình, trong khi mọi yêu cầu do cấu hình quyết định đều dừng, như cấu hình của chính workspace bên dưới mô tả.

Bị từ chối

Một đường dẫn mà một yêu cầu nêu tên, khi bên gọi không phải là chủ sở hữu máy đang tự gõ nó, sẽ bị từ chối. Ngoài các ngoại lệ bên dưới, mọi đường dẫn mà yêu cầu của trình soạn thảo tới aggrega serve nêu tên để server đọc hoặc ghi, và mọi đường dẫn mà trợ lý nêu tên cho một server được truy cập qua HTTP, đều phải dẫn vào bên trong workspace; đường dẫn dẫn ra ngoài bị từ chối mà không có gì được đọc hay ghi, và thông báo từ chối nêu tên tham số, như trang của từng bề mặt trình bày. Thao tác sửa tài liệu bị từ chối theo cách này trên mọi bề mặt, kể cả dòng lệnh — xem Thao tác sửa tài liệu ở bên trong.

Bị dừng

Khi một thao tác sẽ tự mình đọc hoặc ghi qua một liên kết dẫn ra ngoài, nó dừng lại. Đây là các đường dẫn mà sản phẩm tự xác định chứ không phải đường dẫn bạn nêu tên, và lặng lẽ bỏ qua một đường dẫn như vậy có thể thay đổi ý nghĩa của một bản build, nên mỗi trường hợp đều dừng thao tác, nêu tên liên kết và nơi nó dẫn tới, và giữ nguyên nơi liên kết trỏ tới:

  • Những gì một lần tra cứu đọc — một tài liệu bên dưới thư mục catalog, hoặc bên cạnh một Release nêu tên Aggregate hay Manifest của nó theo định danh, hoặc bên cạnh một Manifest nêu tên Manifest mà nó mở rộng theo cách đó. Release hoặc Manifest mà thao tác được chỉ định không thuộc các tài liệu đó: nó được đọc tại nơi nó được nêu tên — xem Một Release hoặc một Manifest được nêu tên qua một liên kết. Một lần tra cứu bỏ qua liên kết như vậy có thể phân giải một entity khác cùng tên từ một thư mục sau đó thay vào chỗ của nó, nên một bản build, một lần pull, một lần kiểm tra hợp lệ, một lần inspect đọc catalog, một lần lint một Release hoặc toàn bộ catalog, cùng các yêu cầu của trình soạn thảo và của trợ lý để build, xem trước, vẽ đồ thị, kiểm tra hợp lệ, lint hoặc mô tả một Release đều dừng trước khi bất cứ thứ gì được phân giải hay kiểm tra: E0321.
  • Lockfile của một Release — được đọc bên cạnh Release để lấy các pin mà một bản build, một lần pull, một lần kiểm tra hợp lệ, một lần lint, một lần inspect, aggrega cache prune và các yêu cầu của trình soạn thảo và của trợ lý phân giải theo. Nó được kiểm soát tại nơi được đọc giống hệt như tại nơi được ghi, nên một lockfile là liên kết dẫn ra ngoài sẽ dừng từng thao tác đó thay vì cho chúng mượn các pin lưu ở nơi khác trên máy: E0321.
  • Một tệp được đọc bên cạnh một entity — các tài liệu khác trong thư mục của một entity mà bạn pin hoặc publish, được đọc để biết liệu có entity khác dùng chung thư mục đó không, và tệp .wasm đã build mà một Plugin entity trong thư mục catalog được nạp từ đó. Mỗi tệp chỉ được đọc từ bên trong thư mục mà tài liệu của chính entity được đọc dưới đó: workspace, một thư mục catalog bạn nêu tên bên ngoài nó, hoặc thư mục của một tài liệu bạn nêu tên bên ngoài nó. Vì vậy một tệp là liên kết dẫn ra ngoài sẽ dừng aggrega pin, aggrega push (kể cả chạy thử), một lần pull có pin và thao tác pin và publish của trình soạn thảo và của trợ lý — một tài liệu bị bỏ không đọc có thể chính là entity gây cản trở — và dừng một bản build hoặc một lần pull nạp plugin thay vì chạy các byte lưu ở nơi khác trên máy: E0321.
  • Bộ nhớ đệm artifact — mọi thứ Aggrega đọc từ bộ nhớ đệm dưới artifact_cache_dir: một entity, plugin hoặc thư viện được lưu đệm cùng manifest bên cạnh nó, một kho lưu trữ nguồn và siêu dữ liệu của nó, một đầu vào bên ngoài đã pin, một gói chữ ký và chỉ mục tìm kiếm cục bộ của registry, và mọi mục workspace mà aggrega cache status, aggrega cache prune và aggrega cache clear liệt kê. Bộ nhớ đệm chỉ được đọc từ bên trong thư mục bộ nhớ đệm, nơi nó được ghi vào, nên bất cứ thứ gì trong đó là liên kết dẫn ra khỏi thư mục đó — tới nơi khác trong workspace cũng như bất kỳ nơi nào khác — đều dừng một bản build, một lần pull, một lần kiểm tra hợp lệ, một lần tìm kiếm, từng lệnh trong ba lệnh cache, và các yêu cầu của trình soạn thảo và của trợ lý đọc bộ nhớ đệm, thay vì đưa cho chúng các byte lưu ở nơi mà bộ nhớ đệm không sở hữu — kể cả nội dung được kiểm tra theo một digest đã ghi, vì digest cho biết các byte là gì, chứ không cho biết chúng có thể được đọc từ đâu. Thông báo ngừng hỗ trợ mà aggrega inspect in ra, vốn không quyết định điều gì, được loại trừ. Một lần prune hoặc clear gặp một thư mục riêng của bộ nhớ đệm là liên kết như vậy, hoặc một thư mục bộ nhớ đệm mà chính nó là liên kết dẫn ra khỏi workspace, sẽ coi đó là thao tác xóa mà nó sẽ là, với E0320, trước khi liệt kê bất cứ thứ gì: E0321.
  • Một repository mà một nguồn tải về — bản checkout mà một lần pull lưu trữ cho nguồn git-repository. Bản checkout là một thư mục riêng, nên một liên kết mà repository chứa được lưu trữ dưới dạng thứ nó trỏ tới chỉ khi thứ đó nằm bên trong repository; một liên kết dẫn ra khỏi nó, vốn có thể chạm tới bất kỳ tệp nào trên máy đang chạy pull, sẽ dừng lần pull, nêu tên liên kết và nơi nó dẫn tới, mà không lưu đệm gì — kể cả chính module_subdir, khi nó là một liên kết như vậy: E0321. Bản checkout biến mất khi lần pull dừng, nên thông báo nêu tên liên kết theo vị trí của nó trong repository, cùng repository và revision mà nguồn nêu tên. Một module_subdir vượt lên trên repository theo cách viết sẽ bị từ chối trước khi repository được tải về, nên không có gì bên cạnh bản checkout được đọc: E0307.
  • Các tệp của một thư mục bạn nhập — aggrega import, công cụ nhập của trợ lý và aggrega/import của phiên, khi được cho một thư mục, sẽ đọc những tệp trong đó mà các mẫu tệp của trình nhập chọn. Thư mục đó là một gốc riêng dù nó nằm ở đâu — xem Một thư mục bạn nhập — nên một liên kết trong số các tệp đó dẫn ra khỏi nó, hoặc một liên kết tới một thư mục dẫn ra khỏi nó, sẽ dừng việc nhập và nêu tên liên kết trước khi bất kỳ tệp nào của thư mục được đọc: E0321.
  • Cấu hình riêng của workspace — mọi .aggrega-config.yaml từ gốc xuống tới thư mục mà một lệnh chạy trong đó, và .aggrega-config-append-ci.yaml của một pipeline nằm cạnh bất kỳ tệp nào trong số đó. Mọi lệnh đọc cấu hình, language server và các công cụ của trợ lý đều đọc cấu hình trước mọi thứ khác, nên một trong các tệp này mà là một liên kết dẫn ra ngoài sẽ dừng từng thứ đó ngay tại đó thay vì để chúng chạy trên một cấu hình tạo từ những gì còn lại: E0321. Các lệnh aggrega không bao giờ đọc cấu hình — version, help, completion, explain, get-schema, scaffold khi soạn một tài liệu khởi đầu, skills list, plugin run-local, plugin sync, auth token và logout — vẫn chạy như thường, kèm một cảnh báo nêu tên liên kết. scaffold --example có đọc cấu hình, để lấy registry mặc định và chính sách chữ ký, và dừng lại tại đó như mọi thứ khác đọc cấu hình. Language server, và máy chủ của trợ lý giao tiếp qua các luồng riêng của nó, vẫn khởi động trên một workspace như vậy, để những gì nó chứa có thể được liệt kê: các danh sách Release và thực thể vẫn trả lời, được đọc mà không có thư mục catalog nào và không có gì khác được cấu hình, và nêu tên tệp đó trong số các liên kết không được đọc. Mọi yêu cầu khác mà cấu hình quyết định — một lần build, một bản xem trước, một đồ thị, một lần xác thực, một lần lint, một mô tả, cấu hình hiệu lực, Release mặc định — đều dừng với E0321 nêu tên liên kết, và máy chủ của trợ lý được yêu cầu lắng nghe qua HTTP cũng vậy, vì địa chỉ và quyền truy cập của nó do cấu hình đặt ra.
  • Những gì một thao tác ghi hoặc xóa — thư mục đầu ra của một lần build, các thư mục ranh giới của nó và mọi tệp được ghi ở đó, bản trace; lockfile của một Release và bản ghi tin cậy plugin nằm cạnh nó; một entity.lock; tệp cấu hình workspace mà một lệnh ghi; bộ nhớ đệm artifact và từng phần của nó mà một lần pull lấp đầy hoặc aggrega cache clear và aggrega cache prune làm trống; các bản nháp mà một lần nhập ghi và các thực thể Plugin mà aggrega plugin gen-catalog ghi; và dấu đánh .aggrega/active-release mà một trình soạn thảo ghi lại Release mặc định vào đó, do language server ghi thay cho nó. Một dist là một liên kết nếu không sẽ biến “build lại đầu ra” thành việc xóa một thư mục ở nơi khác trên máy: E0320.
  • Những gì một tài liệu nêu tên bằng một đường dẫn — xem Một tham chiếu mà tài liệu viết: E0324.
  • Nội dung mà một thực thể khai báo — một source: hoặc một $import: có đường dẫn đi qua một thư mục là một liên kết dẫn ra khỏi thư mục riêng của thực thể, mà nếu không một lần phát hành sẽ mang nó dưới một tên bên trong thực thể: E0304.

Những điều này áp dụng bất kể ai khởi động thao tác — dòng lệnh, một trình soạn thảo, hay một trợ lý trên một trong hai phương thức truyền — vì đường dẫn thuộc về workspace và sản phẩm, không thuộc về bên gọi.

Một tham chiếu do tài liệu viết

Một Release và một Manifest có thể chỉ định một tệp khác bằng đường dẫn: aggregate: và manifest: của một Release được viết dưới dạng ./… hoặc ../…, extends: của nó, extends: của một Manifest được viết dưới dạng đường dẫn, và parameters: { $import: … } của một Release. Một tài liệu trong workspace chỉ có thể truy cập theo cách đó các tệp nằm trong workspace — một đường dẫn leo ra ngoài theo cách được viết sẽ bị từ chối, và một đường dẫn nằm bên trong theo cách được viết nhưng gặp một liên kết dẫn ra ngoài trên đường đi cũng vậy. Không có gì được đọc từ tệp mà một trong hai đường dẫn đó chỉ định.

Một workspace mà bạn đã clone mang theo các tham chiếu của tác giả của nó, nên nếu chỉ giới hạn những gì bạn chỉ định trong khi vẫn đi theo bất cứ thứ gì một tài liệu sau đó dẫn tới thì ranh giới chỉ còn cách một ../. Khi một tài liệu cần một entity được lưu ở nơi khác, nó chỉ định entity đó bằng tên thay vì bằng tệp — aggregate: payments — và cấu hình workspace liệt kê thư mục catalog chứa entity đó. Một tên được tra cứu chứ không được đi theo, nên nó không bao giờ bị từ chối ở đây.

Một Release hoặc một Manifest nằm ngoài workspace, được chấp nhận vì bạn đã chỉ định nó, chỉ truy cập được các tệp trong thư mục của chính nó — xem Một ngoại lệ truy cập thư mục mà nó chỉ định, và không xa hơn.

Các ngoại lệ, và lý do của từng ngoại lệ

Một đường dẫn thuộc một trong các loại sau được tôn trọng ở nơi nó dẫn tới, dù ở trong workspace hay không. Mỗi loại là một loại đường dẫn chứ không phải một danh sách địa điểm, và mỗi loại là một ngoại lệ vì một lý do riêng.

  • Những gì cấu hình workspace nêu tên. Các thư mục catalog của nó — catalog_dirs và catalog_dirs_append, cho workspace hoặc cho một Release dưới workspace.releases — các tệp Release được đặt khóa dưới workspace.releases, build.authoring_release, tệp .wasm cục bộ của một plugin được gắn và các tệp dưới with.sources của nó, mcp.tls.cert_file, mcp.tls.key_file, mcp.authorization.jwks_file, gốc tin cậy được ghim của một registry, và một artifact_cache_dir leo ra khỏi gốc workspace. Nêu tên một đường dẫn trong cấu hình là cách có chủ ý để một workspace vươn ra ngoài chính nó: nó được ghi lại một lần, lưu cùng dự án, và được đọc bởi bất kỳ ai xem xét nó. Thư mục catalog theo quy ước của workspace được tính là đã nêu tên khi cấu hình liệt kê nó hoặc bạn truyền nó bằng --catalog — hoặc liệt kê, hoặc bạn truyền, nơi nó dẫn tới, theo bất kỳ cách viết nào, hoặc một thư mục phía trên nơi đó, khi ấy những gì nằm ở đó được đọc một lần, thông qua thư mục bạn đã nêu tên. Khi chỉ được đọc vì nó có mặt ở đó, nó là nội dung riêng của workspace, nên một catalog là liên kết dẫn ra ngoài workspace sẽ không được đọc cho đến khi bạn nêu tên nó hoặc nơi nó dẫn tới.
  • Một đường dẫn bạn gõ trên dòng lệnh. aggrega build --release ../other/release.yaml, --catalog /srv/shared-catalog, --output-dir, một tệp để kiểm tra hợp lệ, lint, ghim hoặc phát hành: mỗi cái đều được dùng ở nơi nó dẫn tới — trừ việc chỉnh sửa tài liệu, xem bên dưới. Bạn sở hữu máy chạy lệnh và vốn đã có thể đọc và ghi mọi thứ bạn sẽ gõ, nên việc giới hạn bạn trong một thư mục chẳng đem lại gì.
  • Một đường dẫn mà trợ lý nêu tên qua các luồng riêng của tiến trình. Một client đã khởi chạy aggrega mcp trên máy của bạn chạy với tư cách của bạn, và host của nó thường cung cấp cho nó các công cụ tệp và shell riêng, nên một đường dẫn nó nêu tên được tôn trọng như thể bạn đã gõ nó — xem Hai phương thức truyền tải của trợ lý.
  • Các kho lưu trữ toàn máy của sản phẩm — tệp cấu hình toàn cục, kho module đã biên dịch, bộ đệm mô tả plugin, gói tài liệu và kho thông tin xác thực registry. Chúng thuộc về máy chứ không thuộc về bất kỳ workspace nào, nên không workspace nào chứa chúng.
  • Một tệp hoặc thư mục được chọn trong hộp thoại, được đọc ở nơi nó nằm. Một trình soạn thảo gửi tệp khóa hoặc gốc tin cậy của một lần đăng ký registry dưới dạng đường dẫn tuyệt đối, bản mô tả mà aggrega/import chuyển đổi — một tệp, hoặc một thư mục có các tệp được importer đọc — và module mà aggrega/pluginGenCatalog tạo một thực thể cho nó cùng với overlay bên cạnh. Một người đã chọn từng cái, dù họ lưu nó ở đâu. Chúng chỉ được đọc: không gì mà một yêu cầu ghi lại đi tới một đường dẫn được chọn theo cách này. Một thư mục được chọn theo cách này bị giới hạn trong chính nó, như mọi thư mục bạn import.
  • Một tài liệu mà trình soạn thảo của bạn đang mở. Việc kiểm tra hợp lệ nó, yêu cầu hoặc bỏ các chẩn đoán của nó, hover, hoàn thành, phân giải, và tìm tham chiếu cũng như cài đặt trong nó được trả lời từ nội dung trình soạn thảo đã gửi, nên không tệp nào được đọc tại đường dẫn nêu tên nó, và đường dẫn đó không bao giờ bị từ chối vì nơi nó dẫn tới. Một yêu cầu thực sự đọc tài liệu từ đĩa thuộc loại bị từ chối ở trên.

Các đường dẫn gõ trên dòng lệnh và các kho lưu trữ toàn máy không bao giờ bị xét đến; những loại còn lại được cho qua theo loại của chúng, không bao giờ theo yêu cầu tình cờ mang chúng.

Một ngoại lệ vươn tới thư mục nó nêu tên, và không xa hơn

Một thư mục bạn đã nêu tên bên ngoài workspace là một gốc riêng cho mọi thứ được đọc hoặc ghi bên dưới nó. Bản thân thư mục được dùng như bạn đã nêu tên — một thư mục là liên kết được đi theo tới nơi nó trỏ tới — và một liên kết bên dưới nó dẫn ra ngoài nó bị giữ lại đúng như một liên kết bên trong workspace: không được đọc khi liệt kê, và làm dừng một lần tra cứu hoặc một lần ghi. Vì vậy, một thư mục catalog bạn liệt kê bên ngoài workspace, một thư mục đầu ra bạn truyền cho aggrega plugin gen-catalog hoặc aggrega import, và một artifact_cache_dir leo ra khỏi workspace đều giữ những gì bên dưới chúng trong chính chúng. Khi một thư mục bạn đã nêu tên nằm bên trong workspace, workspace là gốc — trừ một thư mục bạn import, vốn là một gốc riêng dù nó nằm ở đâu.

Một thư mục bạn nêu tên được phân giải theo thư mục bạn đang chạy trước khi bất cứ thứ gì được đặt bên dưới nó. Một thư mục đầu ra bạn truyền cho aggrega import, gõ dưới dạng tương đối, là thư mục có tên đó trong thư mục bạn chạy lệnh, và một ổ đĩa bạn nêu tên trơn trên Windows — D: — là thư mục hiện tại trên ổ đĩa đó. Thư mục được chuyển thành đường dẫn đầy đủ trước và mọi tệp được đặt bên dưới đường dẫn đầy đủ đó, nên một tệp có tên bắt đầu bằng dấu phân cách, chẳng hạn \notes.txt, nằm bên trong thư mục bạn đã nêu tên thay vì ở đỉnh ổ đĩa, và thư mục mà lệnh báo cáo chính là thư mục được ghi vào.

Một Release hoặc một Manifest bạn đã nêu tên bên ngoài workspace là cùng quy tắc đó áp dụng cho một tệp: thư mục riêng của nó là gốc, nên những gì nó nêu tên bằng đường dẫn — và những gì mọi Release mà chuỗi extends: của nó dẫn tới nêu tên — phải nằm bên trong thư mục đó. Một Release được lưu bên cạnh Aggregate và Manifest của nó build được từ bất cứ đâu; một Release theo bố cục releases/ thông thường, nêu tên ../aggregates/app.yaml, thì được build từ chính workspace của nó.

Một Release bạn nêu tên qua một liên kết được đọc ở nơi liên kết dẫn tới, và được phân giải ở nơi bạn nêu tên nó. Khi gõ --release release.yaml trong đó release.yaml là liên kết tới một tệp lưu ở nơi khác — hoặc được nêu tên theo cách đó dưới workspace.releases, hoặc làm build.authoring_release — Release được đọc từ nơi liên kết dẫn tới. Aggregate và Manifest mà nó nêu tên, theo định danh hoặc theo đường dẫn, được tìm bên cạnh liên kết, trong thư mục bạn đã nêu tên nó, và bị giới hạn trong gốc của thư mục đó: workspace, hoặc chính thư mục đó khi nó nằm bên ngoài workspace. Lockfile của nó cũng được đọc và ghi bên cạnh liên kết, không bao giờ ở nơi liên kết dẫn tới. Release không phải là một trong các tài liệu mà lần tra cứu của chính nó gặp bên cạnh nó, nên nó không bao giờ làm dừng lần tra cứu đó; một Release khác lưu bên cạnh nó mà là liên kết dẫn ra ngoài thì vẫn làm dừng. Một Manifest bạn kiểm tra riêng qua một liên kết được đọc và phân giải theo cùng cách.

Thư mục bộ đệm artifact là một gốc riêng, dù nó ở đâu. Mọi thứ bộ đệm chứa đều được ghi, đọc và xóa chỉ bên trong thư mục bộ đệm, nên một trong các thư mục riêng của bộ đệm, hoặc một tệp trong đó, là liên kết dẫn ra ngoài thư mục bộ đệm sẽ bị giữ lại — kể cả khi nó dẫn tới nơi khác bên trong workspace — còn một liên kết dẫn tới nơi khác bên trong thư mục bộ đệm thì được đi theo. Vị trí của chính thư mục bộ đệm được xác định từ cách viết giá trị của nó. Khi được viết bên trong gốc workspace — kể cả giá trị mặc định .aggrega/cache — nó là thư mục riêng của workspace: một thư mục bộ đệm là liên kết tới nơi khác bên trong workspace được đi theo, và một liên kết dẫn ra ngoài workspace bị từ chối, khi đọc cũng như khi ghi. Khi được viết leo ra ngoài (../shared-cache), nó là một thư mục mà cấu hình nêu tên, được đọc và ghi ở nơi nó dẫn tới.

Thư mục bạn nhập

Thư mục bạn nhập là một gốc riêng, dù nó nằm ở đâu — bên trong workspace cũng như bên ngoài, và đây là điểm nó khác với mọi thư mục khác mà bạn chỉ định bên trong workspace. aggrega import, công cụ nhập của trợ lý và aggrega/import của phiên làm việc chuyển cho trình nhập từng tệp của thư mục theo vị trí của tệp đó trong thư mục, nên những gì chúng chuyển cho trình nhập chỉ được đọc từ bên trong thư mục. Thứ được xét là thứ mà việc nhập sẽ lấy dữ liệu từ đó: một liên kết tới một tệp mà một mẫu của trình nhập chọn — mẫu của bất kỳ trình nhập nào, khi định dạng được nhận diện thay vì được chỉ định — và một liên kết tới một thư mục, vốn không bao giờ được đi vào. Một liên kết như vậy dẫn ra ngoài thư mục sẽ bị từ chối trước khi bất kỳ tệp nào được đọc, kể cả khi nó dẫn tới nơi khác bên trong workspace, còn một liên kết được chọn tới một tệp ở nơi khác bên trong thư mục thì được đọc tại nơi nó trỏ tới, dưới tên riêng của liên kết. Một liên kết tới một tệp mà không mẫu nào chọn thì không bị xét cũng không được đọc. Bản thân thư mục được dùng đúng như bạn chỉ định, thư mục là một liên kết thì được đi theo tới nơi nó trỏ tới.

Việc chỉnh sửa tài liệu vẫn ở bên trong

aggrega edit-document, thao tác chỉnh sửa tài liệu và điểm chèn của language server, cùng edit-document và insertion-point của trợ lý chỉ tác động lên một tài liệu mà workspace chứa. Một tài liệu nằm ngoài workspace, theo cách viết hoặc thông qua một liên kết dẫn ra ngoài, bị từ chối trên mọi giao diện mà không có gì được đọc hay ghi — kể cả ở nơi mà một đường dẫn bạn chỉ định vốn được chấp nhận.

Hai phương thức truyền tải của trợ lý

aggrega mcp phục vụ cùng một bộ công cụ theo hai cách, và ranh giới giữa chúng khác nhau vì bên gọi khác nhau.

  • Qua các luồng riêng của tiến trình, máy khách đã khởi chạy máy chủ trên máy của bạn, nên một lệnh gọi tương đương với việc bạn gõ trên dòng lệnh: một đối số đường dẫn có thể là tuyệt đối và có thể nằm ngoài workspace, một lệnh gọi có thể chỉ định workspace_root và catalog_dirs riêng của nó, và các công cụ chạy một lệnh aggrega trong một tiến trình riêng được cung cấp. Chỉ đường dẫn mà lệnh gọi chỉ định mới được tôn trọng đúng như đã chỉ định. Những gì thao tác sau đó tự đọc và ghi được giới hạn như khi ở terminal: một thao tác liệt kê không đọc xuyên qua một liên kết dẫn ra ngoài, một tham chiếu mà tài liệu viết không rời khỏi workspace, và một thao tác ghi không đi qua một thư mục đầu ra hoặc thư mục cache được liên kết. Nội dung workspace có thể điều hướng những gì trợ lý yêu cầu, nên trên một máy chủ nơi các công cụ này là cách duy nhất để nó tiếp cận các tệp của bạn, một tài liệu trong workspace bạn đã clone vẫn có thể dẫn nó chỉ định một đường dẫn ngoài workspace và khiến đường dẫn đó được đọc hoặc ghi; những gì trợ lý có thể làm mà không hỏi bạn trước là nơi bạn thiết lập mức độ nó được tự làm mà không cần nhắc.
  • Qua HTTP, bên gọi không sở hữu máy mà máy chủ chạy trên đó. Workspace là workspace mà máy chủ được khởi động trên đó và cố định trong suốt vòng đời của máy chủ; mọi đối số đường dẫn đều được giới hạn bên trong nó, được đánh giá như trên; một lệnh gọi chỉ định workspace_root hoặc catalog_dirs, hoặc chọn một khóa ký được lưu trên máy chủ, bị từ chối; và các công cụ chạy một lệnh aggrega không được cung cấp. Một lời từ chối nêu tên đối số và trích dẫn một giá trị tương đối đúng như đã gửi, nhưng không nêu thư mục gốc của workspace cũng như nơi một đường dẫn lẽ ra sẽ dẫn tới.

Khi có gì đó bị từ chối hoặc dừng

Những gì bạn thấyCần làm gì
Một danh sách nêu tên một liên kết trong số những liên kết mà nó không đọcThay liên kết bằng một bản sao của nội dung mà nó trỏ tới; hoặc, với các thực thể được lưu ở nơi khác, liệt kê thư mục mà liên kết trỏ tới trong catalog_dirs; với một Release được lưu ở nơi khác, nêu tên nó trong workspace.releases hoặc dưới dạng build.authoring_release.
E0321, một lần đọc qua một liên kết dẫn ra khỏi một thư mục catalog hoặc thư mục của một ReleaseHãy liệt kê thư mục mà liên kết dẫn tới như một thư mục catalog, hoặc truyền nó bằng --catalog, thay vì truy cập nó qua một liên kết nằm bên dưới một thư mục catalog; hoặc thay liên kết bằng một bản sao. Khi chính liên kết là catalog theo quy ước, hãy liệt kê catalog hoặc thư mục mà nó dẫn tới, hoặc truyền một trong hai bằng --catalog.
E0321 trên lockfile của một ReleaseXóa liên kết và pull lại Release, thao tác này ghi một lockfile mới bên cạnh nó. Lockfile không có vị trí nào khác.
E0321 trên một tệp nằm bên cạnh một thực thểThay liên kết bằng chính tệp đó: chuyển một tài liệu là thực thể vào một thư mục riêng, và đặt tệp .wasm đã build bên cạnh thực thể Plugin của nó thay vì một liên kết tới tệp đó.
E0321 trên một tệp cấu hìnhThay liên kết bằng một bản sao được lưu trong workspace. Một cấu hình dùng chung giữa các workspace được đọc bằng cách chỉ định nó làm tệp cấu hình toàn cục, với --config hoặc AGGREGA_CONFIG, bên dưới các tệp riêng của từng workspace.
E0321 trên bộ nhớ đệm artifactXóa liên kết; một lần pull sẽ lấp đầy lại bộ nhớ đệm. Để giữ bộ nhớ đệm ở nơi khác, đặt artifact_cache_dir thành thư mục đó, viết tương đối so với gốc workspace (../shared-cache), thay vì tạo liên kết tới nó.
E0321 trên một liên kết trong một repository đã fetchLiên kết được commit trong repository mà nguồn nêu tên — thông báo nêu nó theo vị trí của nó ở đó: hãy sửa nó ở đó — trỏ nó vào bên trong repository, hoặc commit chính tệp đó — và nêu tên revision chứa thay đổi.
E0321 trên một liên kết trong một thư mục bạn importGiữ chính tệp đó trong thư mục thay vì một liên kết tới nó, hoặc import thư mục mà liên kết trỏ tới. Một thư mục bạn import chỉ được đọc từ bên trong chính nó, dù nó nằm ở đâu.
E0307 trên một module_subdirNêu tên một thư mục bên trong repository: giá trị có thể đi xuống bên dưới gốc của repository nhưng không được đi lên phía trên nó.
E0320, một thao tác ghi hoặc xóa qua một liên kếtXóa liên kết mà thông báo nêu tên, hoặc làm cho nó trỏ tới một nơi bên trong thư mục mà thông báo nêu tên, rồi chạy lại thao tác. Không có gì trong các tệp thực thể của bạn gây ra lỗi này.
E0324, một tham chiếu dẫn ra ngoàiNêu tên một Aggregate được lưu ở nơi khác bằng metadata.name của nó và liệt kê thư mục catalog của nó; giữ một Manifest, một Release mà một extends: nêu tên và một tệp parameters bên trong workspace — hoặc, với một tài liệu bạn chỉ định từ bên ngoài, trong thư mục riêng của nó; hoặc mở workspace tại một thư mục chứa cả hai tài liệu.
E0304, nội dung qua một liên kếtThay liên kết bằng một bản sao của nội dung mà nó trỏ tới, bên trong thư mục riêng của thực thể.
Một yêu cầu language server bị từ chối vì một đường dẫn dẫn ra ngoàiGửi một đường dẫn bên trong workspace, tương đối so với gốc của nó. Một Release được lưu bên ngoài workspace được truy cập bằng cách nêu tên nó trong cấu hình, trong workspace.releases hoặc dưới dạng build.authoring_release, và nêu trong yêu cầu liên kết bên trong workspace trỏ tới nó — vị trí mà danh sách Release đưa ra cho nó.
Một lời gọi trợ lý qua HTTP bị từ chối vì một đường dẫnGửi một đường dẫn tương đối so với gốc của workspace mà máy chủ phục vụ; khi lời từ chối đưa ra cách viết tương đối của một đường dẫn tuyệt đối, hãy gửi cách viết đó.
Một thao tác chỉnh sửa tài liệu bị từ chốiChỉnh sửa một tài liệu mà workspace chứa; một liên kết tới tài liệu ở nơi khác sẽ không được chỉnh sửa xuyên qua.

Xem thêm