Chế độ xem Aggrega
Đồ thị cấu trúc liên kết mở trong một bảng riêng, được mô tả trong Đồ thị cấu trúc liên kết, và các lệnh mà các nút của bảng Commands chạy được mô tả trong Lệnh.
Chế độ xem Aggrega trên thanh hoạt động — bốn bảng theo thứ tự đọc: Commands, Registries, Catalog và Plugins. Ba bảng còn lại liệt kê những gì cấu hình của bạn và không gian làm việc chứa, và mỗi bảng mở đầu bằng các thao tác tác động lên những gì nó liệt kê, dưới dạng các hàng có nhãn ở đầu danh sách; mọi thao tác khác là một nút có nhãn trên bảng Commands, nên mỗi thao tác chỉ có một nơi để tìm. Một thao tác tác động lên một registry, thực thể hoặc plugin cụ thể nằm trên hàng đó.
Bảng Commands mở đầu bằng ba hàng một dòng cho biết trình soạn thảo đang tác động lên gì — Project folder, rồi Aggrega workspace, rồi Release — mỗi hàng mở bộ chọn riêng của nó. Hàng giữa hiển thị tên ở dạng rút gọn, là Agg. worksp., để giá trị của mỗi hàng có thêm chiều rộng của bảng; chú giải khi di chuột của nó ghi tên đầy đủ, là Aggrega workspace, và mọi thông báo về nó cũng vậy. Giá trị của chúng nằm trong một cột, sau nhãn rộng nhất trong ba nhãn; trong một bảng quá hẹp cho nhãn đó, nhãn bị cắt bớt bằng dấu chấm lửng thay vì đẩy bảng sang ngang, và chú giải của hàng vẫn cho biết đó là hàng nào. Chúng theo thứ tự đó vì mỗi hàng nằm bên trong hàng phía trên, và cách sắp xếp là cách thể hiện điều đó thay vì giải thích. Hàng giữa giữ tên sản phẩm, dù rút gọn hay không, vì riêng “không gian làm việc” đã chỉ tập hợp các thư mục mà cửa sổ của bạn đang mở. Hàng Aggrega workspace cho biết thư mục mà máy chủ ngôn ngữ đã neo vào, là thư mục dùng để tính danh sách Release; di chuột lên nó sẽ hiện đường dẫn đầy đủ và, khi khác với thư mục bạn đã mở, cũng cho biết thư mục đó — để bạn có thể tìm hiểu vì sao các Releases được đề xuất lại là những cái đó. Khi cửa sổ của bạn mở đúng một thư mục, chú giải của hàng Project folder cho biết đó là thư mục duy nhất, thay vì để bạn mở một danh sách chỉ có một mục, và kết thúc bằng những gì việc nhấp vào hàng cung cấp ở đó — mở một thư mục, hoặc thêm một thư mục vào cửa sổ — và khi không có Release nào được chọn và chưa có gì đọc những gì không gian làm việc Aggrega này cung cấp, chú giải nói điều đó thay vì đoán. Khi một cấp không chứa gì, chú giải nêu cách thoát khỏi trạng thái đó thay vì bảo bạn chọn: không có gì được chọn và không có gì để chọn được hiểu khác nhau, vì chỉ trường hợp đầu là một quyết định đang chờ bạn. Một dự án không chứa không gian làm việc Aggrega nào được giải quyết bằng cách mở một thư mục có chứa một không gian làm việc hoặc tạo một cái mới; một không gian làm việc Aggrega không chứa Release nào, bằng cách làm việc trong một không gian khác hoặc soạn thảo một Release.

Mỗi hàng Aggrega workspace và Release có một + ở bên phải, bên cạnh hàng chứ không nằm trên hàng: nhấn vào hàng để chọn trong số những cái đang có, còn nhấn + sẽ mở đường để tạo một cái mới. + của Release mở cùng quy trình soạn thảo như Draft entity ở đầu bảng Catalog, với loại đã được xác định sẵn: nó chỉ hỏi tên, và lời nhắc cho biết nó đang đặt tên cho một Release. Hàng Project folder không có nút này — việc tạo ra một thư mục dự án là việc của trình soạn thảo, không phải của Aggrega.
Khi không gian làm việc Aggrega của bạn không phải là thư mục bạn đã mở — nó nằm phía trên thư mục đó, hoặc bên trong nó — hàng Aggrega workspace có thêm một điều khiển, mở không gian làm việc đó làm thư mục dự án của bạn. Điều khiển này được đề xuất chứ không tự thực hiện thay bạn, và tên của nó cho biết cái giá phải trả cũng như nơi nó dẫn tới: mở một thư mục sẽ tải lại cửa sổ, nên máy chủ ngôn ngữ và tiện ích mở rộng này đều khởi động lại và mọi thứ chưa lưu trong cửa sổ cũng mất theo. Khi thư mục bạn đã mở chính là không gian làm việc Aggrega thì không có gì để mở, và điều khiển không được vẽ.
Khi một cửa sổ mở trên một thư mục có không gian làm việc Aggrega nằm bên ngoài nó — không phải chính thư mục đó cũng không nằm bên trong — trình soạn thảo còn thông báo điều đó trong một hộp thoại mà bạn đóng trước khi tiếp tục: hộp thoại mở đầu bằng Aggrega is using a workspace from outside the folder you opened. và, bên dưới, một dòng Aggrega workspace: và một dòng Project folder: cho biết đường dẫn đầy đủ của từng cái. Các nút của nó là Open workspace (reloads the window), mở không gian làm việc Aggrega làm thư mục dự án của bạn giống như điều khiển của chính hàng đó; Continue here, đóng hộp thoại và không thay đổi gì; và Don’t show again for this folder. Đóng hộp thoại theo bất kỳ cách nào khác — bằng Escape, hoặc bằng điều khiển đóng của chính nó — cũng giống như Continue here. Hộp thoại xuất hiện một lần cho một thư mục trong mỗi cửa sổ, và xuất hiện lại nếu không gian làm việc Aggrega mà thư mục đó thuộc về thay đổi; sau Continue here, nó không xuất hiện cho đến khi cửa sổ được tải lại hoặc mở lại, và khi đó nó quay lại. Don’t show again for this folder được ghi nhớ cho cửa sổ đó và khôi phục khi bạn mở lại, nên hộp thoại không quay lại cho thư mục đó. Không lựa chọn nào trong ba lựa chọn loại bỏ được bản thân sự việc: chừng nào không gian làm việc còn nằm ngoài thư mục của bạn, hàng Aggrega workspace có một dấu cảnh báo ở bên phải giá trị của nó, và di chuột lên hàng sẽ hiện cùng tiêu đề và cùng hai đường dẫn mà hộp thoại hiển thị. Một không gian làm việc Aggrega nằm bên trong thư mục bạn đã mở thì không nằm ngoài nó, nên không gây ra hộp thoại nào và hàng của nó không có dấu cũng không có tiêu đề như vậy; di chuột lên hàng vẫn cho biết thư mục bạn đã mở, và điều khiển mở không gian làm việc làm thư mục dự án của bạn vẫn được vẽ.
Hộp thoại được hệ điều hành của bạn vẽ trừ khi thiết lập window.dialogStyle của trình soạn thảo là custom, nên theo mặc định nó theo chủ đề của màn hình nền thay vì của trình soạn thảo, và không tiện ích mở rộng nào có thể thay đổi giao diện của nó; khi window.dialogStyle được đặt thành custom, trình soạn thảo vẽ nó bằng chủ đề của riêng mình.
Nhấp vào hàng Aggrega workspace sẽ mở lựa chọn bất kể bạn đã gắn với gì, kể cả khi đó chỉ là một không gian làm việc hoặc không có cái nào: bộ chọn liệt kê các không gian làm việc Aggrega mà Project folder của bạn chạm tới — bằng cách đi lên từ nó, và xem xét mọi thứ bên trong nó — mỗi cái được đặt tên theo thư mục gốc của chính nó, và cuối cùng là một cách để tới một thư mục mà cửa sổ của bạn hoàn toàn không mở: Choose another folder Aggrega recognises…, hoặc Choose a folder Aggrega recognises… khi bộ chọn không có không gian làm việc nào để liệt kê. Mục cuối cùng đó có mặt vì phạm vi chạm tới bị giới hạn bởi những gì cửa sổ của bạn chứa: trình soạn thảo chỉ tìm kiếm trong các thư mục bạn đã mở, nên một không gian làm việc nằm ở nơi khác có thể chạm tới bằng cách thêm thư mục của nó, không có cách nào ngắn hơn. Máy chủ ngôn ngữ khởi động ngay khi việc đi lên đã tìm thấy chỗ để bắt đầu, không đợi cuộc tìm kiếm đó hoàn tất, nên một cửa sổ có thể gắn vào và chỉ một lát sau mới báo rằng có thể chạm tới không gian làm việc thứ hai — danh sách trong bộ chọn sẽ cập nhật theo khi cuộc tìm kiếm trả về. Không gian làm việc Aggrega mà cửa sổ này làm việc lần cuối cũng được dùng lại ngay, kể cả một không gian bạn đã chọn bên trong Project folder của bạn, vì trình soạn thảo hỏi chính dấu đánh dấu của không gian làm việc đó thay vì đợi cuộc tìm kiếm; chỉ khi dấu đánh dấu đó đã mất, hoặc không còn đánh dấu một không gian làm việc mà Project folder của bạn chạm tới, lựa chọn mới bị bỏ, và bạn được thông báo. Chọn một mục khác sẽ chuyển máy chủ ngôn ngữ tới đó và thông báo điều đó dù mục ấy được chạm tới từ cùng thư mục với mục đang dùng hay từ thư mục khác, còn chọn mục đang dùng thì không khởi động lại gì và cho biết trình soạn thảo đang làm việc ở đâu: Aggrega: the editor already works in ⟨path⟩., nêu đầy đủ thư mục gốc của không gian làm việc. Một không gian làm việc Aggrega được chạm tới từ hai thư mục đang mở cùng lúc là một mục và được tính là một: việc phát hiện đi lên, nên một thư mục gốc ở cấp trên đại diện cho mọi thư mục bên dưới nó, và hỏi thư mục nào trong số đó chứa không gian làm việc sẽ là một câu hỏi có hai câu trả lời đúng.
Nhấp vào hàng Project folder sẽ mở cùng một kiểu lựa chọn: các thư mục đang mở trong cửa sổ, mỗi thư mục được nêu bằng đường dẫn của chính nó, và cuối cùng là hai cách để đến một thư mục mà cửa sổ chưa mở. Open folder… hỏi một thư mục bằng hộp thoại thư mục của trình soạn thảo, có nút ghi Open, và mở thư mục bạn chọn trong cửa sổ này thay cho những gì đang mở trong đó, giống như Open Folder của chính trình soạn thảo. Việc đó tải lại cửa sổ, điều mà mô tả của mục cho biết trước, và nếu trình soạn thảo không thể mở thư mục, bạn sẽ được thông báo. Add folder to this window… hỏi theo cùng cách, với nút ghi Add, và thêm thư mục bạn chọn vào cửa sổ, sau các thư mục đã mở, làm thư mục mà trình soạn thảo làm việc từ đó: bạn đã chọn nó trên hàng này, nên hàng nêu tên nó thay vì hỏi lại bạn, và các không gian làm việc Aggrega được đưa ra là những không gian mà nó đến được. Trong một cửa sổ đã mở trên một tệp không gian làm việc, thư mục sẽ nhập vào đó ngay tại chỗ, và bạn được thông báo rằng trình soạn thảo giờ làm việc từ thư mục đó. Một thư mục mà cửa sổ đã mở sẽ không được thêm lại, và bạn được thông báo; nếu trình soạn thảo từ chối thư mục, bạn cũng được thông báo, và trình soạn thảo tiếp tục làm việc từ thư mục trước đó. Đóng một trong hai hộp thoại mà không chọn sẽ không thay đổi gì.
Thêm một thư mục vào cửa sổ chỉ chứa một thư mục, hoặc không có thư mục nào, sẽ biến cửa sổ thành không gian làm việc nhiều gốc, điều mà trình soạn thảo thực hiện bằng cách khởi động lại các tiện ích mở rộng của nó — kể cả tiện ích này — hoặc, trong cửa sổ từ xa như dev container, bằng cách tải lại cửa sổ. Nếu trang chào mừng đang mở khi các tiện ích mở rộng khởi động lại, trang đó được vẽ lại tại chỗ, nên cửa sổ vẫn chỉ có một trang và trang đó phản ánh cửa sổ như hiện tại. Cả Add folder to this window… lẫn mục cuối cùng của bộ chọn không gian làm việc Aggrega đều kết thúc bằng một lần thêm như vậy, nên khi chọn một trong hai sẽ dẫn đến điều đó, mô tả của nó cho biết trước. Không gian làm việc đó là mới đối với trình soạn thảo và bắt đầu mà không có những gì cửa sổ bạn rời đi đã ghi nhớ, ngoại trừ một câu trả lời duy nhất do chính lần thêm đưa ra: thư mục được thêm qua Add folder to this window… là Project folder ở đó, và không gian làm việc Aggrega được chọn qua mục cuối cùng của bộ chọn không gian làm việc Aggrega, hoặc qua Use a folder that already has one của trang chào mừng, là không gian làm việc Aggrega ở đó. Release bạn đã chọn, và các thư mục mà bạn đã yêu cầu hộp thoại không hiển thị lại, vẫn ở lại với cửa sổ bạn rời đi.
Lựa chọn của bạn được ghi nhớ cho cửa sổ đó và được khôi phục khi bạn mở lại, và nó quyết định hàng bên dưới đưa ra những gì — các không gian làm việc Aggrega được đưa ra là những không gian mà thư mục đó đến được. Đến được không giống với chứa: vì việc khám phá đi lên, không gian làm việc mà một thư mục đến được thường là thư mục phía trên nó, nên chọn một thư mục con của kho mã vẫn đưa ra không gian làm việc của chính kho mã đó. Khi chỉ mở một thư mục thì không có gì để chọn và hàng chỉ nêu tên thư mục đó. Khi mở nhiều thư mục và chưa chọn thư mục nào, hàng hiển thị none selected, và các không gian làm việc Aggrega được đưa ra là những không gian mà toàn bộ cửa sổ đến được. Khi chỉ có một, hoặc khi một trong số đó là không gian mà cửa sổ này làm việc gần nhất, máy chủ ngôn ngữ khởi động ở đó; khi có nhiều và không cái nào được ghi nhớ, nó không khởi động cho đến khi bạn chọn một, và Choose Aggrega workspace… trên thanh trạng thái cùng một thông báo sẽ yêu cầu bạn chọn. Một máy chủ ngôn ngữ tự dừng hoặc không khởi động được vẫn để hàng Project folder nêu tên thư mục của bạn — không gian làm việc của bạn vẫn được chọn, và chính chỉ báo máy chủ ngôn ngữ mới là thứ báo cáo về máy chủ.
Bên dưới các hàng đó, các thao tác được nhóm theo việc bạn muốn làm: Build (validate, lint, build, preview, graph), Dependencies (pull), Author (import, inspect), Publish (push, sign, deprecate) và Configuration (show config, cache).
Bên cạnh Commands là bảng Registries, mở đầu bằng Add registry và Update index và liệt kê mọi registry mà cấu hình hiệu lực khai báo; bảng Catalog, mở đầu bằng Search catalog và Draft entity và liệt kê các thực thể mà không gian làm việc nhìn thấy; và bảng Plugins, mở đầu bằng Add plugin và Generate entities và liệt kê các plugin Wasm được nhúng sẵn và được cấu hình. Những hàng đầu tiên đó là một phần của danh sách của chính bảng: mỗi hàng có nhãn và biểu tượng, nên có thể thấy mà không cần trỏ vào gì, nhấn vào sẽ chạy thao tác, và thu gọn bảng sẽ gấp nó lại cùng phần còn lại. Chúng luôn ở đó dù danh sách bên dưới hiển thị gì — kể cả khi danh sách cho biết chưa có gì được cấu hình, đúng lúc việc thêm mục đầu tiên là điều bạn cần làm, và khi danh sách cho biết không có không gian làm việc Aggrega nào khả dụng. Khi một hàng chưa thể chạy, nó vẫn ở nguyên chỗ và nêu lý do bên cạnh tên của nó, bằng chính những từ mà bảng Commands dùng cho cùng trạng thái, và nhấn vào nó không chạy gì cả. Mỗi bảng trong ba bảng đó cũng có một nút làm mới trên thanh tiêu đề, chỉ đọc lại danh sách đó và không làm gì khác — một thao tác đặt ở đó sẽ là một biểu tượng không nhãn mà bạn phải di chuột qua mới tìm thấy. Validate, build, preview build và lint báo cáo vào bảng Problems; các thao tác dựa trên dòng lệnh truyền đầu ra của chúng vào kênh đầu ra Aggrega.

Bảng Commands
-
Một nơi thiết lập duy nhất, mở từ biểu tượng bánh răng — bảng Commands có một biểu tượng bánh răng ở góc trên bên phải, mở phần thiết lập của chính trình soạn thảo, thu hẹp vào tiện ích mở rộng này. Tiện ích mở rộng không có trang thiết lập thứ hai của riêng nó, nên mỗi tùy chọn chỉ có một nơi tồn tại và một nơi được ghi. Mọi tùy chọn là của bạn chứ không phải của dự án; xem Thiết lập.
-
Hai hình thức cho bảng Commands —
aggrega.operations.layoutchọn giữabuttons, giá trị mặc định, trong đó mọi thao tác là một nút có nhãn trong một luồng liên tục duy nhất hoàn toàn không có tiêu đề nhóm, vàsections, trong đó mỗi nhóm là một phần bạn mở dưới tiêu đề riêng của nó và bảng hiển thị nhiều hay ít tùy vào số phần bạn giữ mở. Cả hai hình thức đều chứa cùng các nhóm với cùng các thao tác, theo cùng thứ tự; thiết lập thay đổi cách một nhóm được vẽ, không bao giờ thay đổi những thao tác nào tồn tại. Trong cả hai hình thức, các hàng Project folder, Aggrega workspace và Release nằm phía trên mọi thao tác, nên đóng một phần không bao giờ làm mất các thông tin cho biết một thao tác sẽ áp dụng cho cái gì. Trongsections, dấu mũ bên cạnh Build là một hàng riêng bên dưới nó, ghi Build options trước mũi tên chữ V, nên nó không bị đọc như một phần để mở. Thay đổi thiết lập sẽ vẽ lại bảng đang mở và không khởi động lại gì. Bảng Commands mở ra với phần thanh bên lớn hơn ba bảng bên cạnh — trong một cửa sổ cao 900 pixel, đủ để hiển thị toàn bộ luồng của nó ở chiều rộng mặc định của thanh bên; từ đó trở đi trình soạn thảo giữ chiều cao các bảng cho từng không gian làm việc, nên một không gian làm việc mà thanh bên đã được bố trí trước đó sẽ giữ chiều cao vốn có. -
Nút đưa ra lựa chọn sẽ hiển thị lựa chọn đó bên cạnh nó — một thao tác phản hồi việc nhấn bằng cách hỏi tác động lên cái nào hoặc thực thể nào sẽ hiển thị lựa chọn đó dưới dạng một menu bên cạnh nút bạn đã nhấn, thay vì trong một hộp thoại chiếm toàn bộ cửa sổ: Cache… đưa ra bốn thao tác bộ nhớ đệm, còn Inspect và Push đưa ra các thực thể mà không gian làm việc nhìn thấy. Menu mở bên dưới hoặc bên trên nút, ở phía nào bảng có nhiều chỗ hơn, và không cao hơn chỗ đó, nên không bao giờ tràn qua mép bảng — một danh sách dài hơn chỗ đó sẽ cuộn bên trong menu — và tên của nó, tức thứ nó đang chọn, vẫn ở đầu khi bạn cuộn. Điều đó đúng ở bất cứ đâu bảng nằm, kể cả khi được neo trong một thanh bên thấp. Menu chỉ được mở bằng cách nhấn nút và không bao giờ bằng Tab, nên bảng vẫn chỉ chiếm một điểm dừng dù chứa bao nhiêu menu. Bên trong menu, các phím mũi tên di chuyển giữa các lựa chọn và Enter chọn lựa chọn hiện tại; gõ sẽ thu hẹp danh sách — phần khớp là một đoạn trong tên của lựa chọn hoặc của dòng bên dưới nó, và menu cho biết còn lại bao nhiêu — Backspace hoàn tác những gì bạn đã gõ, Escape đóng menu và đưa tiêu điểm trở lại nút, còn nhấn ở bất kỳ nơi nào khác — trong bảng hay bất cứ đâu trong trình soạn thảo — sẽ đóng menu mà không chạy gì. Các thao tác giống vậy có trong chỉ mục lệnh của trình soạn thảo, nơi không có nút nào để menu mở bên cạnh, nên khi được gọi từ đó, mỗi thao tác đặt câu hỏi dưới dạng danh sách để bạn chọn.

-
Menu có các lựa chọn cần được yêu cầu sẽ cho biết nó đang đọc — các menu mà Inspect và Push mở không chứa gì cho đến khi máy chủ ngôn ngữ trả lời không gian làm việc chứa những thực thể nào, một lần đọc có hiển thị tiến trình và có thể dừng. Cả hai đều mở với một dòng cho biết đang đọc và được điền khi câu trả lời đến, thay vì mở trống: một danh sách lựa chọn trống được hiểu là không có gì, một câu trả lời khác với hãy chờ. Những gì bạn gõ trong khi việc đọc đang diễn ra vẫn được áp dụng khi các lựa chọn đến. Khi không có gì để đưa ra — không có thực thể nào mà thao tác có thể nêu tên — menu đóng lại và một thông báo cho biết điều đó, cùng thông báo bạn nhận được khi chạy thao tác từ chỉ mục lệnh, thay vì một menu không có gì.
-
Chọn và đồng ý vẫn là hai hành động khác nhau — menu là nơi bạn nói cái nào, và nó không bao giờ chứa bước xác nhận. Ba thao tác bộ nhớ đệm có xóa thứ gì đó vẫn đặt một hộp xác nhận dạng modal trước mặt bạn sau khi bạn chọn, nêu tên các bộ nhớ đệm mà thao tác đó tác động tới, và việc tạo các thực thể Plugin vẫn xác nhận trước khi ghi. Một bước xác nhận xứng đáng với sự gián đoạn của nó: gộp nó vào một danh sách nội tuyến sẽ khiến một cú nhấp nhầm có thể làm trống bộ nhớ đệm. Tìm kiếm danh mục đã xuất bản giữ danh sách bộ lọc của nó, nơi bạn quay lại sau khi chỉnh sửa từng khía cạnh, vì menu không phù hợp với thứ phải vào lại sau mỗi câu trả lời.
-
Điều gì ngăn cách nhóm này với nhóm kế tiếp, trong mỗi hình thức — trong luồng, không có gì được vẽ giữa nhóm này và nhóm kế tiếp: các nhóm quyết định thứ tự xuất hiện của các nút, và thứ tự là tất cả những gì thể hiện việc phân nhóm, nên bảng không tốn chiều rộng cho đường phân cách. Trong hình thức phần, nhóm Publish có một đường kẻ phía trên, vì các thao tác của nó thay đổi những gì mọi người phân giải danh mục đó nhận được, còn phần còn lại tác động trên máy này — một sự khác biệt về bản chất, đáng được đánh dấu một lần và có một khung nhóm để đánh dấu.
-
Bảng hẹp sẽ xuống dòng thay vì cắt ngắn hoặc cuộn ngang — luồng dùng bao nhiêu dòng tùy theo chiều rộng cần, và không có chỗ ngắt nào cố định: mở rộng bảng thì các nút được xếp lại vào ít dòng hơn. Nhãn của mỗi nút chỉ là tên thao tác, phần giải thích nằm trong chú thích khi di chuột, nên một dòng chứa được nhiều thao tác nhất có thể. Không có gì bị ẩn sau thao tác vuốt ngang, và không có nhãn nào bị cắt ngắn.
-
Mọi thao tác đều hỏi những gì nó cần trước khi chạy — một thao tác mà bảng biết là không thể chạy sẽ ở nguyên chỗ, chuyển sang màu xám, và cho biết lý do: di chuột qua sẽ nêu thứ còn thiếu, và trình đọc màn hình thông báo nó không khả dụng với cùng lý do. Nó không bị gỡ bỏ, vì trong một luồng nút, gỡ bỏ một nút sẽ làm các nút khác dịch chuyển xuống dưới con trỏ của bạn, và một lần nhấn khi đó sẽ rơi vào thứ khác với thứ vừa ở đó một khắc trước — đó cũng là lý do dấu mũ bên cạnh Build vẫn ở cạnh nó khi Build không thể chạy, chuyển xám cùng nó, nêu cùng lý do và không mở gì. Có hai điều kiện làm một điều khiển chuyển xám: các thao tác tác động lên một Release cần một Release được chọn, và các thao tác chạy tệp nhị phân
aggregacần một thư mục không gian làm việc đã neo để chạy trong đó. Một thao tác chỉ cần máy chủ ngôn ngữ sẽ không chuyển xám khi máy chủ ngừng — khi được nhấn, nó báo thông báo của chính trình biên dịch, và thanh trạng thái là nơi nêu trạng thái đó. Đẩy, ký và ngừng hỗ trợ đều hỏi đối tượng của chúng trước: đẩy đưa ra các thực thể mà bảng Catalog liệt kê và có tài liệu trong không gian làm việc, còn ký và ngừng hỗ trợ yêu cầu một tham chiếu tới một artifact đã có trong registry, vì đó là thứ hai thao tác này sửa đổi. Ngừng hỗ trợ còn hỏi mức độ nghiêm trọng và lý do, những thứ trình biên dịch yêu cầu và không có cách nào hỏi bạn từ bên trong trình soạn thảo. Kéo chạy trên Release được chọn thay vì hỏi đối tượng. Các thao tác ở đầu bảng Registries, Catalog và Plugins hỏi theo cùng cách: thêm registry hỏi máy chủ và tệp cấu hình nào để ghi vào, thêm plugin hỏi hai hoặc ba câu mà loại của nó cần, tạo các thực thể Plugin hỏi phạm vi bao phủ và nơi ghi, tìm kiếm danh mục đã xuất bản mở một danh sách bộ lọc mà bạn lập trước khi chạy, và soạn thảo một thực thể hỏi loại rồi đến tên. Mỗi thao tác trừ Draft entity đều cần một thư mục không gian làm việc đã neo, nên khi không có, mỗi hàng như vậy nêu điều đó bên cạnh tên của nó và nhấn vào không chạy gì — bạn được cho biết trước khi trả lời bất cứ điều gì chứ không phải sau. Draft entity chỉ cần máy chủ ngôn ngữ, nên nó không bao giờ được vẽ như không thể chạy.
Các bảng sổ đăng ký, danh mục và Plugins
-
Chi tiết bảng Sổ đăng ký — mỗi hàng nêu máy chủ của sổ đăng ký, bí danh của nó nếu có cấu hình, sổ đăng ký nào là mặc định, có yêu cầu chữ ký cho các artifact kéo về từ nó hay không, và có thông tin xác thực cho máy chủ đó hay không. Việc đọc danh sách không liên hệ với sổ đăng ký nào: trạng thái thông tin xác thực chỉ báo cáo sự hiện diện, nên nó cho biết thông tin xác thực tồn tại chứ không cho biết sổ đăng ký sẽ chấp nhận nó.
Các thao tác tác động lên toàn bộ tập hợp là hai hàng đầu tiên của bảng — Thêm sổ đăng ký, và Cập nhật chỉ mục, thao tác cập nhật chỉ mục có thể tìm kiếm của mọi sổ đăng ký đã cấu hình — còn các thao tác tác động lên một sổ đăng ký nằm trên hàng của sổ đăng ký đó: cập nhật chỉ mục chỉ cho nó, xóa thông tin xác thực đã lưu của nó và xóa sổ đăng ký. Thanh tiêu đề của chính bảng chỉ có thao tác làm mới.
Việc thêm một sổ đăng ký và việc xóa một sổ đăng ký đều hỏi tệp cấu hình nào cần thay đổi, đề xuất trước tiên tệp toàn cục được mọi dự án trên máy này dùng chung, vì đó là nơi hai thao tác này ghi vào trừ khi bạn chỉ định khác; lựa chọn còn lại là tệp cấu hình riêng của dự án này. Mỗi thao tác kết thúc bằng việc nêu tệp mà nó thực sự đã thay đổi và phạm vi ảnh hưởng của tệp đó, được đọc từ những gì trình biên dịch đã làm chứ không phải từ những gì được yêu cầu. Máy chủ ngôn ngữ đọc cấu hình của nó khi khởi động, nên sau mỗi thao tác, máy chủ ngôn ngữ được khởi động lại mà không hỏi, và bảng cùng bước sổ đăng ký của trang chào mừng được đọc lại khi máy chủ hoạt động trở lại: sổ đăng ký bạn đã thêm xuất hiện trong danh sách, hoặc sổ đăng ký bạn đã xóa biến mất, mà không cần tải lại hay làm mới. Khi máy chủ đã khởi động lại đọc được thay đổi, thông báo kết thúc bổ sung rằng thay đổi giờ đã có hiệu lực; nếu khởi động lại thất bại thì không bổ sung, vì khi đó thay đổi đã nằm trong tệp nhưng chưa có hiệu lực.
Việc xóa một sổ đăng ký và việc xóa thông tin xác thực đều yêu cầu bạn xác nhận trước, và mỗi thao tác cho biết thay đổi ảnh hưởng đến đâu: xác nhận cho một sổ đăng ký nêu tệp bạn đã chọn, nên việc bỏ một mục khỏi tệp toàn cục được mô tả là ảnh hưởng đến mọi dự án phân giải thông qua nó, còn việc bỏ một mục khỏi tệp riêng của dự án này được mô tả là không ảnh hưởng đến dự án nào khác, trong khi thông tin xác thực bị xóa khỏi kho thông tin xác thực dùng chung và mục sổ đăng ký vẫn được giữ nguyên. Việc xóa thông tin xác thực không đưa ra lựa chọn tệp, vì kho thông tin xác thực được mọi dự án trên máy dùng chung và không có dạng theo từng dự án để ghi vào.
Việc xây dựng chỉ mục hiển thị tiến độ và có thể dừng lại, và đây là thao tác duy nhất trong số này được cung cấp kèm nút Hủy. Nhấn nút đó sẽ kết thúc chính quá trình duyệt chứ không chỉ việc chờ của trình soạn thảo, và quá trình xây dựng kết thúc bằng việc cho biết nó đã bị dừng. Các bản ghi của mỗi sổ đăng ký chỉ được ghi khi quá trình duyệt của chính nó hoàn tất, nên một lần xây dựng bị dừng sẽ để lại các sổ đăng ký đã duyệt xong ở trạng thái đã lập chỉ mục, còn sổ đăng ký đang được duyệt giữ nguyên chỉ mục nó có trước đó — vì vậy đây là một lần dừng chứ không phải một lần hoàn tác. Một lần xây dựng chạy đến cuối sẽ nêu bao nhiêu thực thể đã được lập chỉ mục từ bao nhiêu sổ đăng ký và thư mục mà chỉ mục được ghi vào, chính điều này cho thấy việc làm mới không thay đổi gì mà một dự án khác trên máy này dùng để phân giải, và một sổ đăng ký không thể lập chỉ mục được nêu kèm lý do của chính trình biên dịch: sổ đăng ký không thể kết nối được nêu là không kết nối được — Không thể kết nối tới ⟨sổ đăng ký⟩: đứng trước lý do đó — còn sổ đăng ký đã phản hồi nhưng thất bại theo cách khác, chẳng hạn một sổ đăng ký có danh sách kho lưu trữ tự lặp lại, điều này kết thúc quá trình duyệt sổ đăng ký đó thay vì đi vòng lại trong khi các sổ đăng ký khác vẫn được lập chỉ mục, được nêu là không thể lập chỉ mục; câu kết thúc nêu riêng hai nhóm. Việc cập nhật chỉ mục của một sổ đăng ký không thể kết nối cũng kết thúc theo cách tương tự, nêu nó là không kết nối được.
Việc thêm một sổ đăng ký cũng truy cập mạng, vì nó lấy chính sách tin cậy mà sổ đăng ký công bố, và được cung cấp mà không có nút Hủy; dù theo cách nào, nó cũng kết thúc bằng việc nêu tệp mà nó đã ghi. Một sổ đăng ký không thể kết nối được nêu là không kết nối được trong thông báo kết thúc đó, đứng trước lý do của chính trình biên dịch, thay vì bị nói là không công bố chính sách nào — kể cả hub chính thức, khi đó mục của nó mang đường cơ sở tích hợp sẵn. Khi một sổ đăng ký không phải hub chính thức không công bố chính sách tin cậy hoặc không thể kết nối — hoặc, khi không gian làm việc ngoại tuyến, bị từ chối vì không lấy được chính sách nào — thông báo kết thúc được theo sau bởi một câu hỏi đề xuất ghim một chính sách thủ công, với chính xác những gì
--identityvà--keycủa dòng lệnh nhận cho trường hợp đó: các danh tính không khóa, mỗi danh tính được viết làidentity=issuervà nhập từng cái một, một tệp khóa công khai được chọn trong hộp thoại tệp, cả hai, hoặc không cái nào. Những gì bạn cung cấp được đăng ký lại cho cùng máy chủ trong cùng tệp, và thông báo kết thúc đó cho biết mục hiện mang loại chính sách nào mà không lặp lại các danh tính hay tệp; một danh tính sai định dạng, hoặc một tệp khóa không đọc được hoặc không phải khóa công khai, kết thúc bằng sự từ chối của chính trình biên dịch. Sự từ chối đối với một tệp không phải khóa công khai nêu những gì trình biên dịch mong đợi và bỏ qua nội dung của tệp, nên một khóa riêng tư bị chọn nhầm không xuất hiện trong thông báo cũng như trong kênh đầu ra Aggrega. Nhấn Escape tại bất kỳ lời nhắc nào trong số này, hoặc chọn Không cái nào, sẽ không ghim gì cả, và điều còn hiệu lực là những gì dòng lệnh để lại khi không được cung cấp cờ nào trong hai cờ. Một sổ đăng ký có chính sách đã công bố được ghim, và hub chính thức với đường cơ sở tích hợp sẵn, sẽ không được hỏi.Việc xóa một sổ đăng ký, xóa thông tin xác thực và đọc danh sách không liên hệ với sổ đăng ký nào. Đăng nhập vào một sổ đăng ký không được cung cấp từ bảng, vì lệnh này đọc mật khẩu từ một terminal và không có terminal nào phía sau một nút — hãy chạy lệnh từ terminal và nhấn làm mới.
-
Chi tiết bảng Danh mục — các thực thể mà không gian làm việc có thể thấy, được nhóm dưới một tiêu đề cho mỗi loại, mỗi hàng nêu thực thể và các nhãn mà nó khai báo, cùng apiVersion và mô tả của nó trong chú giải công cụ. Các hàng đến từ hai nơi và mỗi hàng cho biết nơi nào. Một thực thể được khai báo bởi một tài liệu trong không gian làm việc mang đường dẫn của tài liệu đó trong chú giải công cụ, và nhấp vào hàng sẽ mở tệp đó. Một thực thể được phân giải từ một thư mục danh mục — thư mục
catalog/ở gốc không gian làm việc, và các thư mục mà cấu hình của bạn chỉ định cho Release đã chọn trongworkspace.releaseshoặc, khi không chỉ định thư mục nào cho nó hoặc không có Release nào được chọn, cho toàn bộ không gian làm việc trongworkspace.catalog_dirs— được đánh dấu là đến từ đó và không mang đường dẫn: không gian làm việc không chứa tệp riêng nào cho nó, nên hàng nêu nơi nó đến thay vì cung cấp một cú nhấp không dẫn đến đâu.Danh sách là của Release đã chọn: một tài liệu nằm dưới thư mục mà cấu hình của bạn chỉ chỉ định cho các Releases khác sẽ bị loại khỏi danh sách, nên khi mỗi Release đọc một biến thể của cùng một thực thể từ thư mục riêng của nó, bảng chỉ liệt kê biến thể của Release đã chọn. Khi không có Release nào được chọn, mọi tài liệu trong không gian làm việc đều được liệt kê. Một tài liệu không khai báo
kind:hoặcmetadata.name:sẽ không được liệt kê, và chính điều đó giữ cho bảng là chỉ mục của các thực thể chứ không phải của các tệp.Máy chủ ngôn ngữ không đọc thực thể nào qua một liên kết dẫn ra ngoài không gian làm việc — một liên kết tới thư mục bên ngoài, hoặc một liên kết được đặt tên như tệp YAML nhưng dẫn tới một tệp bên ngoài — nên không thực thể nào phía sau một liên kết như vậy được liệt kê, dù cây tệp của trình soạn thảo vẫn hiển thị nó. Ngoại lệ duy nhất là một Release mà cấu hình không gian làm việc của bạn chỉ định, dưới dạng
build.authoring_releasehoặc một khóa củaworkspace.releases, được đọc qua liên kết của nó và được liệt kê tại chính vị trí của liên kết. Khi danh sách bỏ qua một liên kết như vậy, một hàng riêng sau danh sách sẽ cho biết điều đó: Các thực thể đi tới qua liên kết này không được liệt kê, vì nó dẫn ra ngoài không gian làm việc Aggrega: theo sau là đường dẫn của liên kết tương đối với không gian làm việc — hoặc Các thực thể đi tới qua các liên kết này không được liệt kê, vì mỗi liên kết đều dẫn ra ngoài không gian làm việc Aggrega: khi có nhiều liên kết, nêu các liên kết tới thư mục trước rồi đến các liên kết tới tệp. Di con trỏ lên hàng sẽ hiện toàn bộ câu, vì đường dẫn dài bị cắt ngắn trong hàng. Khi một Release được chọn, liên kết nằm trong một thư mục catalog mà chỉ các Releases khác đọc sẽ không được nêu, vì dù sao cũng không có gì phía sau nó được liệt kê cho Release đó.Danh sách là câu trả lời của chính máy chủ ngôn ngữ, nên nó nêu đúng những thực thể mà trình biên dịch đọc — bao gồm cả các bộ đệm chưa lưu của trình soạn thảo, được ưu tiên hơn các byte trên đĩa — và được trình bày theo thứ tự máy chủ đã gửi thay vì được sắp xếp lại ở đây. Bảng tự đọc lại danh sách khi máy chủ ngôn ngữ trở nên có thể trả lời, khi Release được chọn thay đổi, khi một tài liệu
.yamltrong một thư mục mà cửa sổ đang mở được tạo, thay đổi hoặc xóa trên đĩa — bởi trình soạn thảo, một terminal hay một lần checkout đều như nhau — và khi trình soạn thảo đóng một tài liệu YAML. Bảng chỉ yêu cầu danh sách sau khi máy chủ ngôn ngữ đã bỏ những gì nó giữ cho tệp đó, nên một tệp bị xóa trong khi đang mở trong trình soạn thảo sẽ rời khỏi danh sách thay vì được báo cáo từ bản sao mà trình soạn thảo gửi lần cuối, một tài liệu được đổi tên trong bộ đệm rồi đóng mà không lưu sẽ lại được liệt kê đúng như trên đĩa, và một loạt thay đổi và đóng như vậy chỉ là một lần đọc. Trình soạn thảo đóng một tài liệu khi nó buông tài liệu đó, điều mà nó không hứa sẽ làm ngay lúc tab của tài liệu đóng, nên một hàng lấy từ văn bản của một tài liệu đã đóng tab có thể vẫn còn cho đến khi trình soạn thảo làm vậy. Bảng không tự theo dõi những gì bạn gõ. Một thay đổi vẫn còn trong bộ đệm chưa lưu được gửi tới máy chủ ngôn ngữ khi bạn tạm dừng gõ trong tài liệu đó — mỗi tài liệu đang mở chờ khoảng dừng của riêng nó, nên gõ trong một tài liệu không bao giờ làm chậm tài liệu khác — và nó hiện ra vào lần đọc danh sách tiếp theo sau đó. Nhấn nút làm mới của bảng sẽ đọc danh sách cho mọi tài liệu đang mở theo trạng thái trình soạn thảo đang giữ tại lúc bạn nhấn, dù chỉ ngay sau lần gõ phím hay hoàn tác cuối cùng: một thay đổi chưa được gửi sẽ được gửi ngay, và danh sách chỉ được yêu cầu sau khi máy chủ ngôn ngữ đã trả lời cho mọi thay đổi đã gửi tới nó tính đến lúc nhấn. Một thư mục bị xóa toàn bộ sẽ hiện ra vào lần đọc danh sách tiếp theo, hoặc khi nhấn làm mới, vì trình soạn thảo có thể báo cáo nó như một thay đổi đối với thư mục thay vì một thay đổi đối với từng tài liệu bên trong.Tìm kiếm trong catalog đã phát hành là hàng đầu tiên của bảng này, Search catalog: nó hỏi một bộ lọc và sao chép tham chiếu của thứ bạn chọn. Soạn nháp một thực thể mới là hàng thứ hai, Draft entity: nó hỏi loại, dưới dạng một danh sách để chọn, và mở tài liệu khởi đầu trong một tab mà không ghi gì xuống đĩa. Thanh tiêu đề của chính bảng này chỉ có nút làm mới. Các thao tác tác động lên một thực thể nằm trên hàng của thực thể đó, và một hàng chỉ cung cấp một thao tác khi trình biên dịch chấp nhận thao tác đó cho loại của hàng. Mỗi thao tác chấp nhận những loại nào là câu trả lời của chính máy chủ ngôn ngữ, được đọc lại cùng danh sách mỗi lần, nên các hàng đi theo trình biên dịch bạn đang chạy thay vì một danh sách được lưu trong tiện ích mở rộng. Xem xét một thực thể phân giải thành gì là thao tác duy nhất có thể dùng mà không cần mở menu của hàng: nó xác định thực thể bằng tên, thứ mà mọi hàng đều có, nên nó được cung cấp trên một hàng bất kể không gian làm việc có chứa tài liệu cho thực thể đó hay không, ở bất kỳ đâu trình biên dịch phân giải một tên thành một thực thể thuộc loại đó, và nó không thay đổi gì.
Xác thực thực thể, kiểm tra các quy ước phát hành của nó và phát hành nó đều cần đường dẫn của thực thể, nên chúng chỉ được cung cấp trên một hàng có thực thể được khai báo bởi một tài liệu trong không gian làm việc này; một hàng được phân giải từ một thư mục catalog đã cấu hình không có đường dẫn nào trong không gian làm việc này để đưa cho chúng, và chúng bị giữ lại trên hàng đó thay vì được cung cấp như những điều khiển chỉ có thể báo cáo thiếu đối số. Trong ba thao tác đó, kiểm tra các quy ước phát hành được cung cấp trên mọi hàng như vậy. Xác thực được cung cấp ở nơi trình biên dịch tự kiểm tra một tài liệu thuộc loại đó: chẳng hạn, một Aggregate được kiểm tra cùng toàn bộ catalog khi nó nằm trong một thư mục catalog, và cùng một Release triển khai nó, nên hàng của nó không cung cấp xác thực. Xác thực kiểm tra thực thể theo các điều kiện của Release đang được chọn, giống như
aggrega validate <path> --release <Release>làm tại terminal, nên những gì thực thể tham chiếu tới — Component mà một Recipe hiện thực, một thư viện mà lược đồ của nó kết hợp — được phân giải qua các thư mục catalog mà Release đó dùng để build; khi không có Release nào được chọn, thì qua các thư mục của chính không gian làm việc. Phát hành được cung cấp ở nơi một tài liệu thuộc loại đó được phát hành độc lập, điều này loại trừ một Plugin, vì việc phát hành nó còn ràng buộc cả tệp thực thi của nó, và một Manifest hay một Release, vì không cái nào trong số đó được phát hành. Nếu máy chủ ngôn ngữ không cho biết thao tác nào chấp nhận loại của một hàng, các hàng vẫn được liệt kê và một hàng có tài liệu chỉ cung cấp kiểm tra quy ước; khi yêu cầu lấy câu trả lời đó thất bại, lý do được ghi vào kênh đầu ra Aggrega.Phát hành yêu cầu bạn xác nhận trước và cho biết thay đổi lan tới đâu: thực thể được đóng gói và đẩy lên dưới phiên bản do chính nó khai báo, và bất kỳ ai kéo phiên bản đó từ registry đó sẽ phân giải tới những gì đã được phát hành. Phát hành cũng là thao tác duy nhất trong số này thay đổi bất cứ thứ gì bên ngoài máy này; hai thao tác kiểm tra và thao tác xem xét không ghi gì và không phát hành gì. Cả bốn đều hiển thị tiến độ và có thể dừng.
-
Chi tiết bảng Plugins — mỗi hàng nêu plugin, loại và phiên bản của nó, và trạng thái sẵn sàng của nó khi plugin có thông tin này. Một plugin mà trình biên dịch không thể phân giải hoặc mô tả sẽ được đánh dấu và giữ hàng riêng của nó, với thông báo của trình biên dịch trong chú thích công cụ, nên nó không bao giờ bị nhầm với một plugin đang hoạt động. Chú thích công cụ cũng nêu khóa cấu hình mà một phần gắn đến từ đó, các khả năng của nó, các loại đầu vào, ranh giới và các bản xuất của nó — chỉ hiển thị những gì danh sách thực sự báo cáo.
Các thao tác tác động lên toàn bộ tập hợp là hai hàng đầu tiên của bảng — Add plugin, và Generate entities, thao tác ghi các thực thể catalog Plugin — và thanh tiêu đề của chính bảng chỉ có nút làm mới. Việc thêm sẽ hỏi loại plugin, dưới dạng một danh sách để chọn, sau đó là một câu trả lời nữa mà loại đó yêu cầu: khả năng mà một liên kết
providerphục vụ, hoặc vai trò mà một phần gắngovernanceđược liên kết tại đó, và cuối cùng là tên cần tìm trong registry đã cấu hình, tên này phải phân giải thành đúng một plugin thuộc loại đó; phần gắn được ghi vào cấu hình không gian làm việc của dự án này. Việc thêm là thao tác duy nhất ở đây truy cập mạng, vì nó tìm kiếm trong registry, nên nó hiển thị tiến độ và có thể dừng. Khi một phiên bản đã phát hành của plugin bị thu hồi, việc thêm kết thúc bằng cách nói ra điều đó thay vì để bạn tự phát hiện: các phiên bản bị thu hồi và không được chọn, lý do được ghi lại cho từng phiên bản, và nơi các bản ghi thu hồi được đọc cùng thời điểm chúng được cập nhật lần cuối, chỉ hiển thị những gì trình biên dịch báo cáo — và khi hoàn toàn không đọc được các bản ghi đó, nó sẽ nói điều đó thay vào đó, kèm theo lý do của chính trình biên dịch, đây là một câu trả lời khác với việc không có gì bị thu hồi.Việc tạo các thực thể catalog hỏi nên bao gồm mọi plugin tích hợp sẵn trong trình biên dịch hay một artifact plugin trên máy này, cũng dưới dạng một danh sách để chọn, sau đó hỏi lớp phủ đã viết cần hợp nhất và thư mục cần ghi vào, và xác nhận trước khi ghi: mỗi thực thể được ghi tại một đường dẫn suy ra từ loại, tên và phiên bản plugin của nó, nên một thực thể đã có ở đó cho cùng plugin và phiên bản sẽ bị thay thế.
Việc xóa một plugin nằm trên hàng của plugin đó. Nó yêu cầu bạn xác nhận trước và cho biết nó ghi vào tệp cấu hình nào, vì điều đó phụ thuộc vào loại plugin — một plugin
clibị xóa khỏi cấu hình toàn cục dùng chung cho mọi không gian làm việc trên máy này, mọi loại khác bị xóa khỏi cấu hình riêng của dự án này — và nó chỉ thao tác trên văn bản cấu hình, nên không có gì khác trên máy này bị xóa. Việc xóa chỉ được cung cấp cho một plugin đã cấu hình mà trình biên dịch đã trả lời: một plugin tích hợp sẵn trong trình biên dịch hoàn toàn không phải là một mục cấu hình, còn một phần gắn mà không gì có thể phân giải hoặc mô tả thì đến mà không mang loại, thứ mà việc xóa cần cùng với tham chiếu — nên trên các hàng đó, việc xóa bị giữ lại thay vì được cung cấp như một điều khiển chỉ có thể báo cáo thiếu đối số. Việc thêm một pluginclikhông được cung cấp từ bảng, vì việc cài đặt nó xác nhận các khả năng đã khai báo tại một terminal và không có terminal nào đằng sau một nút bấm — hãy chạy nó từ terminal rồi nhấn làm mới. Việc đồng bộ các bản ghi do máy sở hữu của một thực thể plugin cũng không được cung cấp: nó nhận tệp thực thể và artifact.wasmdưới dạng hai đường dẫn, và một hàng không nêu cái nào trong số đó. -
Tìm kiếm catalog đã xuất bản — tìm kiếm các thực thể catalog trong các registry đã cấu hình và sao chép một tham chiếu để dán vào một Aggregate. Việc tìm kiếm được thu hẹp từ một danh sách duy nhất, trong đó mỗi khía cạnh hiển thị giá trị hiện tại của nó: văn bản tự do được so khớp với tên và mô tả, một hoặc nhiều loại thực thể, một bộ chọn nhãn (danh mục là một nhãn), một hoặc nhiều khả năng của plugin, một socket của plugin, và giới hạn số lượng kết quả trả về. Một khía cạnh để nguyên sẽ không thu hẹp gì. Những gì bạn đặt sẽ được giữ lại: lần tìm kiếm tiếp theo mở ra với bộ lọc mà lần trước để lại, dù lần đó đã chạy, không khớp gì hay bị đóng sau khi chỉnh sửa, nên việc thu hẹp lại chỉ là một lần chỉnh sửa thay vì nhập lại toàn bộ bộ lọc. Reset search filter, hàng ngay phía trên Search, đưa mọi khía cạnh về trạng thái không thu hẹp gì và đưa bạn trở lại danh sách mà không tìm kiếm; mô tả của nó nêu các khía cạnh mà nó sẽ xóa, hoặc cho biết không có gì được đặt. Bộ lọc chỉ được giữ trong khi tiện ích mở rộng chạy trong cửa sổ đó và không được lưu ở đâu cả — nó không nằm trong cài đặt nào, nên một cửa sổ khác tìm kiếm từ bộ lọc riêng của nó, và việc tải lại cửa sổ, hay bất cứ điều gì khác khởi động lại các tiện ích mở rộng của trình soạn thảo, sẽ bắt đầu từ một bộ lọc trống. Việc tìm kiếm đọc chỉ mục cục bộ được ghi bởi
aggrega registry update— Update index trong bảng Registries — và không kết nối mạng, nên một registry chưa được xây dựng chỉ mục sẽ không được tìm kiếm. Kênh đầu ra cho biết điều đó trên dòng riêng của registry đó, kèm Update index để xây dựng chỉ mục của nó, và cho biết một chỉ mục đã cũ trên một dòng riêng, kèm Update index để làm mới nó; một lần tìm kiếm không khớp gì khi có registry như vậy được cấu hình sẽ nêu các registry đã tìm và các registry chưa tìm; và khi không registry nào được cấu hình có chỉ mục, việc tìm kiếm báo cáo thông báo của chính trình biên dịch nêu bước cần chạy.