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.

Cài đặt Aggrega

Aggrega cần hai thứ: tệp nhị phân aggrega đã được cài đặt, và, để soạn thảo với trợ lý AI, client của trợ lý được kết nối với máy chủ MCP có sẵn trong tệp nhị phân. Các lệnh được trình bày trước; những gì mỗi lệnh thực hiện, và các cách cài đặt khác, nằm ở phía sau.

Cài đặt tệp nhị phân

Trên Linux và macOS, trong terminal:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | sh

Trên Windows, trong PowerShell:

Terminal window
irm https://aggrega.ai/install.ps1 | iex

Với Homebrew, trên macOS và Linux:

Terminal window
brew install aggrega-ai/tap/aggrega

Với Scoop, trên Windows:

Terminal window
scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket
scoop install aggrega

Với winget, trên Windows:

Terminal window
winget install Cognitio.Aggrega

Sau đó kiểm tra rằng nó chạy được:

Terminal window
aggrega version

Một chuỗi phiên bản nghĩa là tệp nhị phân được tìm thấy và có thể chạy. Đó là tất cả những gì máy chủ MCP cần. Chi tiết từng cách cài đặt cho biết mỗi lệnh làm gì, đặt tệp nhị phân ở đâu, và cách cài đặt bằng trình cài đặt Windows hoặc thủ công.

Kết nối một client MCP

Client của trợ lý AI khởi động máy chủ MCP của Aggrega bằng cách chạy aggrega mcp, và Kết nối máy chủ MCP đưa ra lệnh hoặc mục cấu hình để thêm máy chủ, cho từng client. Trong một trợ lý có cài đặt plugin, plugin Aggrega thêm máy chủ và kỹ năng Aggrega trong một bước: xem Cài đặt plugin.

Chi tiết từng cách cài đặt

Aggrega được phân phối dưới dạng một tệp thực thi duy nhất. Một lệnh sẽ cài đặt nó; các bước thủ công sau đó làm điều tương tự bằng tay. Cả hai đều đặt nó vào một thư mục của riêng bạn, lần nào cũng là cùng một thư mục, và không cách nào cần quyền quản trị: ~/.local/bin/aggrega trên Linux và macOS, và %LOCALAPPDATA%\Programs\aggrega\aggrega.exe trên Windows. Trên Windows, trình cài đặt Windows và winget cài đặt nó vào cùng thư mục đó, cũng không cần quyền quản trị, và liệt kê nó trong số các ứng dụng đã cài đặt của bạn: xem Cài đặt bằng trình cài đặt Windows và Cài đặt bằng winget. Homebrew trên macOS và Linux, và Scoop trên Windows, cũng cài đặt nó, mỗi công cụ vào các thư mục riêng của mình: xem Cài đặt bằng trình quản lý gói.

Cài đặt bằng một lệnh

Lệnh cài đặt là curl -fsSL https://aggrega.ai/install.sh | sh trên Linux và macOS và irm https://aggrega.ai/install.ps1 | iex trong PowerShell trên Windows, hai lệnh đầu tiên của Cài đặt tệp nhị phân. Hai địa chỉ đó chuyển hướng tới các script cài đặt mà bản phát hành mới nhất đính kèm, nên cùng các lệnh đó cũng chạy được với địa chỉ riêng của bản phát hành:

Terminal window
curl -fsSL https://github.com/aggrega-ai/aggrega-cli/releases/latest/download/install.sh | sh
Terminal window
irm https://github.com/aggrega-ai/aggrega-cli/releases/latest/download/install.ps1 | iex

Lệnh này làm những gì:

  • Nó chọn tệp nhị phân mặc định cho máy của bạn từ bản phát hành mới nhất: Linux và macOS trên x86 64-bit hoặc ARM 64-bit, Windows trên x86 64-bit. Nó từ chối mọi hệ thống hoặc bộ xử lý khác với một thông báo cho biết nó đã phát hiện được gì hoặc nên chuyển sang cách nào. Trên máy Mac dùng Apple silicon, nó chọn tệp nhị phân Apple silicon, ngay cả từ một shell chạy qua Rosetta 2.
  • Nó kiểm tra tệp nhị phân với SHA256SUMS của bản phát hành trước khi cài đặt bất cứ thứ gì. Một tệp tải xuống có digest SHA-256 khác với digest trong danh sách sẽ bị xóa, không có gì được cài đặt, và lệnh dừng lại với một thông báo nêu cả hai digest.
  • Nó cài đặt tệp nhị phân chỉ cho riêng bạn, dưới dạng ~/.local/bin/aggrega trên Linux và macOS và dưới dạng %LOCALAPPDATA%\Programs\aggrega\aggrega.exe trên Windows, tạo thư mục khi chưa có và thay thế bản sao cũ hơn ở đó trong một bước, nên chạy lại lệnh sẽ cập nhật bản bạn đang có. Nó không bao giờ dùng sudo. Trên Windows, nó còn gỡ bỏ dấu mà một tệp tải xuống từ internet có thể mang, như Unblock-File làm trong các bước thủ công. Trên macOS, nó tải xuống bằng curl, nên tệp nhị phân nó cài đặt không mang dấu cách ly (xem Tệp nhị phân dựng sẵn cho macOS).
  • Nó giúp lệnh có thể được tìm thấy. Trên Linux và macOS, khi thư mục không nằm trong PATH của bạn, nó in ra một lệnh thêm thư mục vào tệp mà shell của bạn đọc khi khởi động: ~/.zshrc cho zsh, ~/.bashrc cho bash (~/.bash_profile trên macOS), ~/.config/fish/config.fish cho fish, với một dòng fish_add_path, và ~/.profile cho mọi shell khác. Nó không tự chạy lệnh đó: hãy chạy lệnh đó và mở một terminal mới. Trên Windows, nó thêm thư mục vào PATH người dùng của bạn khi thư mục chưa có ở đó, và vào PATH của cửa sổ PowerShell mà nó đang chạy, nên aggrega chạy được trong cửa sổ đó và trong mọi terminal được mở sau đó, và nó cho biết đã thêm thư mục.
  • Nó kiểm tra rằng tệp nhị phân đã cài đặt chạy được, và dừng lại kèm một thông báo trước khi thiết lập bất kỳ thứ gì khác nếu tệp đó không chạy được. Nó thêm một ghi chú khi có một aggrega khác đứng trước bản nó đã cài trong PATH của bạn.
  • Nó in ra phiên bản đã cài đặt, chạy tệp nhị phân nó đã cài bằng đường dẫn đầy đủ, nên phiên bản hiện ra ngay cả trước khi PATH của bạn bao gồm thư mục đó.
  • Nó kết thúc bằng các bước tiếp theo, dưới Next:, mỗi bước một dòng: lệnh chạy quickstart AI, như Bắt đầu mô tả; aggrega skills install --global, lệnh thêm kỹ năng Aggrega vào các trợ lý AI trên máy của bạn, như Thêm kỹ năng trợ lý khi cài đặt mô tả; và địa chỉ của trang này, cho tự động hoàn thành của shell và Kết nối client MCP ở trên. Khi một tùy chọn đã cài đặt kỹ năng, dòng của kỹ năng đó được bỏ qua.

Những gì nó in ra rất ngắn gọn: phiên bản và hệ thống mà nó cài đặt cho, một dòng khi tệp tải về khớp với checksum của nó, và đường dẫn nó đã cài vào. Bắt đầu cho thấy toàn bộ một lần chạy. --verbose, được truyền sau sh -s -- như các tùy chọn bên dưới, còn in ra địa chỉ của danh sách checksum, tên tệp của bản phát hành và địa chỉ nó tải tệp đó về; install.ps1 có cùng công tắc dưới dạng -Verbose, cho một lần chạy script có đối số, điều mà irm … | iex không thể cung cấp. Khi lệnh từ chối hoặc một bước thất bại, nó báo điều đó trong một dòng, trên standard error đối với install.sh và dưới dạng lỗi hoặc cảnh báo PowerShell hiển thị đối với install.ps1:

aggrega install: error: <what went wrong> - <what to do>

install.sh, script cho Linux và macOS, cần curl hoặc wget, uname, và sha256sum hoặc shasum. install.ps1, script cho Windows, chạy trong Windows PowerShell 5.1 và trong PowerShell 7.

Hai thiết lập thay đổi những gì nó cài đặt, mỗi thiết lập được đọc từ môi trường mà script chạy trong đó:

  • AGGREGA_VERSION chỉ định bản phát hành cần cài đặt, chẳng hạn 0.8.7, viết có hoặc không có v ở đầu. Khi không được đặt, lệnh cài đặt bản phát hành mới nhất — bản mà GitHub đánh dấu là latest, vốn không bao giờ là bản tiền phát hành, nên một bản tiền phát hành chỉ được cài đặt khi được chỉ định ở đây.
  • AGGREGA_INSTALL_DIR chỉ định thư mục cài đặt thay cho thư mục mặc định. Tệp nhị phân ở đó có tên aggrega, trên Windows là aggrega.exe, và lệnh giúp thư mục đó có thể được tìm thấy như trên.

Trên Linux và macOS, đặt thiết lập trước sh, không phải trước curl, để script nhận được nó:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | AGGREGA_VERSION=<version> sh

Trong PowerShell, hãy đặt nó trong cửa sổ trước; nó vẫn được đặt ở đó cho tới khi bạn gỡ bỏ nó bằng Remove-Item Env:AGGREGA_VERSION:

Terminal window
$env:AGGREGA_VERSION = "<version>"
irm https://aggrega.ai/install.ps1 | iex

Thiết lập tự động hoàn thành cho shell khi cài đặt

Với --completion, install.sh cũng thiết lập tự động hoàn thành cho shell, để phím Tab hoàn thành các lệnh và cờ của aggrega. Các tùy chọn được đặt sau sh -s --, phần này chuyển chúng cho script mà sh đọc từ pipe:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completion

irm … | iex không truyền tùy chọn nào cho script. Trong PowerShell, hãy thiết lập tự động hoàn thành sau khi cài đặt xong, bằng script mà aggrega completion powershell ghi ra, như Tự động hoàn thành cho shell mô tả. install.ps1 cũng nhận -Completion, cho một lần chạy script có đối số.

Nó chỉ thiết lập tự động hoàn thành cho riêng bạn, không cần quyền quản trị, cho shell mà thiết lập SHELL của bạn chỉ định, hoặc trong PowerShell là cho chính PowerShell mà nó đang chạy. Nó dùng script do chính aggrega completion của tệp nhị phân đã cài đặt ghi ra, và nêu tên mọi tệp mà nó ghi hoặc thay đổi:

  • bash: nó ghi script vào ~/.local/share/bash-completion/completions, thư mục mà gói bash-completion đọc các tự động hoàn thành của riêng bạn. Tự động hoàn thành Bash cho aggrega cần gói đó.
  • zsh: nó ghi _aggrega vào ~/.local/share/zsh/site-functions và thêm ba dòng vào ~/.zshrc để đưa thư mục đó vào đường dẫn hàm của zsh và nạp nó, chạy compinit nếu chưa có gì trong tệp chạy nó trước đó.
  • fish: nó ghi aggrega.fish vào ~/.config/fish/completions, thư mục mà fish tự đọc.
  • PowerShell: nó ghi script thành %LOCALAPPDATA%\aggrega\completion.ps1 và thêm hai dòng nạp script đó vào profile của bạn cho mọi host của PowerShell mà nó đang chạy, $PROFILE.CurrentUserAllHosts. Windows PowerShell và PowerShell 7 giữ các profile riêng, nên hãy chạy nó từ mỗi PowerShell bạn dùng. Một profile chỉ chạy khi chính sách thực thi mà cửa sổ mới áp dụng là RemoteSigned, Unrestricted hoặc Bypass; với bất kỳ chính sách nào khác, chẳng hạn Restricted, nó không ghi gì và cho biết chính sách nó tìm thấy. Nó không bao giờ thay đổi chính sách.

XDG_DATA_HOME, XDG_CONFIG_HOME, BASH_COMPLETION_USER_DIR và ZDOTDIR di chuyển các thư mục và tệp đó theo cách mỗi shell đọc chúng. Một terminal hoặc cửa sổ mới sẽ nạp tự động hoàn thành. Chạy lại lệnh chỉ ghi lại một script khi aggrega đã cài đặt ghi ra một script khác, và chỉ thêm các dòng vào ~/.zshrc hoặc profile một lần; đó cũng là cách thêm tự động hoàn thành cho một bản cài đặt bạn đã có, vì lệnh này cài đặt lại tệp nhị phân trong quá trình đó.

Thêm kỹ năng trợ lý khi cài đặt

Với --skills (-Skills trong PowerShell), lệnh cài đặt cũng cài đặt kỹ năng Aggrega — các chỉ dẫn dạy một trợ lý AI cách cài đặt và sử dụng Aggrega — vào mọi dự án của bạn, cho các trợ lý AI trên máy của bạn. Có thể dùng cả hai tùy chọn cùng lúc:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completion --skills

Trong PowerShell, nơi irm … | iex không truyền tùy chọn nào, hãy chạy aggrega skills install --global sau khi cài đặt xong: đó là lệnh mà -Skills chạy.

Lệnh này chạy aggrega skills install --global của chính tệp nhị phân đã cài đặt; lệnh đó tìm các trợ lý trên máy của bạn — mỗi trợ lý có thư mục cấu hình nằm trong thư mục home của bạn, hoặc có lệnh nằm trong PATH của bạn — và in ra từng trợ lý tìm thấy cùng với cách nó được tìm thấy. Sau đó:

  • Tại terminal, lệnh hỏi trước. Nhấn Enter để cài đặt kỹ năng cho các trợ lý đã tìm thấy, hoặc nhập định danh của các trợ lý khác để thêm chúng, phân tách bằng dấu cách hoặc dấu phẩy; aggrega skills list in ra các định danh. Khi chạy dưới curl … | sh, script tự đọc chính nó từ pipe, nên lệnh hỏi qua terminal của bạn thay vào đó.
  • Khi không có terminal để hỏi, như trong một script, lệnh cài đặt cho các trợ lý đã tìm thấy.
  • Để tự chọn trợ lý, hãy đưa chúng sau tùy chọn, phân tách bằng dấu phẩy: --skills claude-code,cursor, hoặc --skills=claude-code,cursor, và trong PowerShell là -Skills claude-code,cursor. Khi đó lệnh cài đặt cho các trợ lý này và không tìm trợ lý nào khác.

Lệnh in ra từng thư mục kỹ năng mà nó ghi, chẳng hạn ~/.claude/skills/aggrega cho Claude Code, tất cả đều nằm dưới thư mục home của bạn. Chạy lại lệnh sẽ thay thế các bản sao mà lần chạy trước đã ghi; đó là cách kỹ năng theo tệp nhị phân lên phiên bản mới hơn. aggrega skills mô tả lệnh, thư mục mà mỗi trợ lý đọc và cách tìm thấy từng trợ lý.

Khi một bước không thể thực hiện

Khi không thể thiết lập tự hoàn thành — một shell mà lệnh không thiết lập, chẳng hạn dash, một thư mục mà lệnh không thể ghi, hoặc một chính sách thực thi PowerShell không chạy profile nào — hoặc không thể cài đặt kỹ năng — không tìm thấy trợ lý nào và cũng không có trợ lý nào được chỉ định, một định danh mà lệnh không biết, hoặc một tệp tại thư mục kỹ năng không phải do một lần cài đặt ghi ra — tệp nhị phân vẫn được cài đặt và chạy được. Lệnh cho biết vì sao bước đó thất bại, in ra các bước tiếp theo và kết thúc với một trạng thái cho biết bước nào đã thất bại. Các trạng thái là:

Trạng tháiÝ nghĩa
0aggrega đã được cài đặt, và mọi bước mà một tùy chọn yêu cầu đều thành công
1không có gì được cài đặt, hoặc aggrega đã cài đặt không chạy được
2lệnh nhận một tùy chọn mà nó không chấp nhận, hoặc một danh sách không chỉ định trợ lý nào; lệnh không làm gì cả
3aggrega đã được cài đặt và chạy được, nhưng thiết lập tự hoàn thành cho shell thất bại
4aggrega đã được cài đặt và chạy được, nhưng cài đặt kỹ năng thất bại
5aggrega đã được cài đặt và chạy được, nhưng cả hai bước đó đều thất bại

Script PowerShell không bao giờ đóng cửa sổ mà nó chạy trong đó, nên nó để lại trạng thái trong $LASTEXITCODE, và mọi trạng thái ngoài 0 đều kết thúc bằng một lỗi, mà powershell -Command và pwsh -Command báo cáo là trạng thái thoát 1.

Cài đặt bằng trình cài đặt Windows

Mỗi bản phát hành đều kèm một trình cài đặt Windows, aggrega-<version>-windows-amd64-setup.exe, trên trang phát hành tại https://github.com/aggrega-ai/aggrega-cli/releases. Hãy tải xuống và chạy nó. Nó cài đặt aggrega.exe mặc định chỉ cho riêng bạn, không cần quyền quản trị và không yêu cầu quyền đó, thông qua một trình hướng dẫn ngắn:

  • Một trang chào mừng, sau đó là giấy phép, Apache License 2.0 của Aggrega: không có gì được cài đặt cho đến khi bạn nhấn I Agree. Sau đó là các thành phần: chính Aggrega, luôn được cài đặt, và Add to PATH, được chọn sẵn.
  • Thư mục cài đặt, %LOCALAPPDATA%\Programs\aggrega trừ khi bạn chọn thư mục khác; đó là thư mục mà lệnh cài đặt sử dụng.
  • Tiến trình, sau đó là một trang kết thúc nêu tên thư mục và cho biết lần cài đặt này có thêm thư mục đó vào PATH của bạn hay không, kèm các bước tiếp theo: cài đặt skill Aggrega bằng aggrega skills install --global, và kết nối máy khách AI của bạn như Kết nối một máy khách MCP mô tả.

Những gì nó làm:

  • Khi Add to PATH được chọn, nó thêm thư mục cài đặt vào PATH người dùng của bạn nếu thư mục đó chưa có ở đó. Một terminal được mở sau khi cài đặt sẽ tìm thấy aggrega; một terminal đã mở sẵn giữ nguyên PATH mà nó có khi khởi động. Khi bỏ chọn, không có gì được thêm vào PATH của bạn, và terminal chạy aggrega.exe bằng đường dẫn đầy đủ; một mục mà lần cài đặt trước đã thêm được giữ nguyên.
  • Nó liệt kê Aggrega trong số các ứng dụng đã cài đặt của bạn, với nhà phát hành là Cognitio s.r.l., nên có thể gỡ cài đặt nó từ Settings → Apps như mọi ứng dụng khác. Trình gỡ cài đặt yêu cầu bạn xác nhận, rồi xóa các tệp mà trình cài đặt đã đặt vào thư mục, mục PATH và mục trong danh sách đó, và xóa thư mục khi không còn gì khác trong đó.
  • Khi chạy lại, nó cài đè lên những gì đang có, đề xuất thư mục mà nó đã cài vào lần trước, nên trình cài đặt của một bản phát hành sau sẽ cập nhật bản bạn đang có, giữ một mục duy nhất trong PATH của bạn.
  • Bên cạnh aggrega.exe, thư mục còn chứa uninstall.exe, LICENSE chứa nội dung giấy phép, và EnVar.dll, thành phần mà trình cài đặt và trình gỡ cài đặt dùng để chỉnh sửa PATH của bạn.

Khi aggrega.exe đang chạy — được khởi động bởi một trình soạn thảo hoặc một client AI — trình cài đặt không thể thay thế nó và dừng lại với một thông báo cho biết điều đó; hãy đóng thứ đã khởi động nó rồi chạy lại trình cài đặt. Trình gỡ cài đặt cũng dừng theo cùng cách, trước khi nó xóa bất cứ thứ gì.

Để cài đặt không có cửa sổ, từ một script hoặc một công cụ cài đặt phần mềm trên nhiều máy, hãy chạy trình cài đặt với /S, viết hoa; khi đó nó cài đặt mà không có cửa sổ hay câu hỏi nào, vào thư mục mà lần cài đặt trước đã dùng hoặc nếu không thì vào thư mục mặc định, với Add to PATH, và báo lỗi qua mã thoát khác 0. Trình gỡ cài đặt nhận cùng công tắc đó:

Terminal window
.\aggrega-<version>-windows-amd64-setup.exe /S
& "$env:LOCALAPPDATA\Programs\aggrega\uninstall.exe" /S

Trình cài đặt được ký giống như các tệp thực thi, với nhà phát hành Cognitio S.r.l. và một dấu thời gian: các bước kiểm tra trong Tệp nhị phân dựng sẵn cho Windows áp dụng cho nó như cho aggrega.exe, và những gì mục đó nói về các lời nhắc mà Windows có thể hiển thị cho một tệp tải xuống cũng vậy. SHA256SUMS liệt kê digest của nó như với mọi tệp khác của bản phát hành.

Khi trình cài đặt không phù hợp, lệnh cài đặt ở trên và các bước thủ công cài đặt cùng aggrega.exe vào cùng thư mục.

Cài đặt bằng trình quản lý gói

Mỗi bản phát hành cũng cập nhật một formula Homebrew và một manifest Scoop, nên trình quản lý gói bạn đang dùng có thể cài đặt Aggrega và giữ nó luôn cập nhật. Mỗi công cụ cài đặt cùng tệp nhị phân mặc định mà lệnh cài đặt cài, được kiểm tra với digest SHA-256 mà SHA256SUMS của bản phát hành cung cấp cho nó.

Trên macOS và Linux, brew install aggrega-ai/tap/aggrega cài đặt nó bằng Homebrew. Homebrew thêm tap aggrega-ai/tap vào lần đầu và cài đặt tệp nhị phân cho hệ thống và bộ xử lý của bạn: macOS trên Apple silicon hoặc Intel, Linux trên x86 64-bit hoặc ARM 64-bit. Sau một bản phát hành mới, brew upgrade cập nhật nó cùng với mọi formula khác bạn đã cài.

Trên Windows, với Scoop, hãy thêm bucket Aggrega một lần bằng scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket, rồi cài đặt từ đó bằng scoop install aggrega. Scoop cài đặt tệp nhị phân Windows dưới dạng aggrega.exe và giúp nó có thể được gọi là aggrega thông qua thư mục shim mà nó giữ trong PATH của bạn. Sau một bản phát hành mới, scoop update làm mới các bucket và scoop update aggrega cập nhật nó.

Homebrew và Scoop mỗi công cụ cài đặt vào các thư mục riêng của mình thay vì vào ~/.local/bin hoặc %LOCALAPPDATA%\Programs\aggrega, và chỉ cập nhật bản sao do chính nó cài. Hãy dùng một cách cài đặt trên mỗi máy: một bản sao cài bằng lệnh cài đặt hoặc bằng tay và một bản sao khác cài bằng Homebrew hoặc Scoop là hai bản sao, và thư mục nào đứng trước trong PATH của bạn sẽ quyết định bản nào được chạy.

Cài đặt bằng winget

Trên Windows, winget install Cognitio.Aggrega cài đặt nó bằng winget, Trình quản lý gói Windows. winget tải trình cài đặt Windows của bản phát hành từ trang phát hành của nó, kiểm tra nó với digest SHA-256 mà manifest của gói cung cấp, và chạy nó ở chế độ không cần giám sát. Kết quả chính là kết quả của trình cài đặt: aggrega.exe trong %LOCALAPPDATA%\Programs\aggrega, hoặc trong thư mục mà lần cài đặt trước đã dùng, thư mục đó nằm trong PATH người dùng của bạn, và Aggrega có trong danh sách ứng dụng đã cài đặt của bạn, tất cả đều không cần quyền quản trị. winget không thay đổi PATH của terminal mà nó chạy trong đó, nên hãy mở một terminal mới trước khi chạy aggrega version.

winget upgrade Cognitio.Aggrega cài đè một bản phát hành mới hơn lên nó, và winget uninstall Cognitio.Aggrega chạy trình gỡ cài đặt của nó. winget, trình cài đặt và lệnh cài đặt đều cài vào cùng một thư mục trừ khi bạn chọn thư mục khác trong trình cài đặt, nên công cụ nào chạy sau cùng sẽ đặt aggrega.exe ở đó.

Cài đặt thủ công

Mỗi bản phát hành đều kèm tệp nhị phân dựng sẵn cho Linux trên x86 64-bit và ARM 64-bit, cho Windows trên x86 64-bit, và cho macOS trên Apple silicon và Intel, trên trang phát hành tại https://github.com/aggrega-ai/aggrega-cli/releases. Tải xuống tệp thực thi cho hệ điều hành và bộ xử lý của bạn — Chọn tệp bên dưới nêu tên từng tệp — và kiểm tra nó với SHA256SUMS của bản phát hành, như mô tả ở đó. Sau đó đánh dấu nó là có thể thực thi và di chuyển nó tới ~/.local/bin/aggrega. Trên Linux, từ thư mục chứa tệp tải xuống, với <version> được thay bằng phiên bản bạn đã tải xuống, và amd64 được thay bằng arm64 trên ARM 64-bit:

Terminal window
chmod +x aggrega-<version>-linux-amd64
mkdir -p ~/.local/bin
mv aggrega-<version>-linux-amd64 ~/.local/bin/aggrega

Trên Windows, xem Tệp nhị phân dựng sẵn cho Windows bên dưới; trên macOS, xem Tệp nhị phân dựng sẵn cho macOS.

Khi ~/.local/bin không nằm trong PATH của bạn, hãy thêm dòng này vào tệp mà shell của bạn đọc khi khởi động — ~/.zshrc cho zsh, ~/.bashrc cho bash (~/.bash_profile trên macOS) — và mở một terminal mới:

Terminal window
export PATH="$HOME/.local/bin:$PATH"

Từ mã nguồn: khi đã cài đặt bộ công cụ Go, hãy build lệnh aggrega từ cây mã nguồn và đặt tệp nhị phân thu được vào cùng thư mục đó.

Xác nhận việc cài đặt bằng aggrega version, như ở cuối phần Cài đặt tệp nhị phân.

Chọn tệp

Một bản phát hành đặt tên mỗi tệp thực thi là aggrega-<version>-<system>-<processor>, kèm .exe trên Windows:

Hệ thốngBộ xử lýTệp
Linuxx86 64-bit (uname -m in ra x86_64)aggrega-<version>-linux-amd64
LinuxARM 64-bit (uname -m in ra aarch64)aggrega-<version>-linux-arm64
Windowsx86 64-bitaggrega-<version>-windows-amd64.exe
macOSApple siliconaggrega-<version>-darwin-arm64
macOSIntelaggrega-<version>-darwin-amd64

Tệp đó là tệp mà lệnh cài đặt cài, và là tệp cần tải xuống khi cài bằng tay. Bên cạnh nó có hai biến thể; lệnh cài đặt không cài biến thể nào, và mỗi biến thể được cài bằng tay theo cùng cách:

  • aggrega-debug-<version>-… là cùng chương trình đó kèm thông tin gỡ lỗi mà trình gỡ lỗi hoặc trình phân tích hiệu năng đọc. Nó chạy và báo phiên bản đúng như tệp mặc định, và có kích thước lớn hơn.
  • aggrega-light-<version>-… được build không kèm các plugin nhúng: nó phân giải mọi plugin thông qua chuỗi plugin theo cấu hình của workspace, thay vì tìm các plugin lõi bên trong chính nó.

Cho Windows, bản phát hành còn kèm aggrega-<version>-windows-amd64-setup.exe, trình cài đặt Windows, giúp cài đặt tệp mặc định cho bạn.

Mỗi bản phát hành cũng kèm SHA256SUMS, digest SHA-256 của mọi tệp khác mà nó đính kèm, bao gồm cả hai script cài đặt, ở dạng mà sha256sum đọc được. Lệnh cài đặt tự thực hiện bước kiểm tra này. Để kiểm tra một tệp tải xuống bằng tay trên Linux, với SHA256SUMS trong cùng thư mục:

Terminal window
sha256sum --check --ignore-missing SHA256SUMS

Tệp bạn đã tải xuống được báo là OK; bất kỳ báo cáo nào khác đều có nghĩa đó không phải là tệp mà bản phát hành đã công bố.

Tệp nhị phân dựng sẵn cho Windows

Tệp thực thi cho Windows là aggrega-<version>-windows-amd64.exe (các biến thể debug và light bên cạnh nó trong bản phát hành được cài đặt theo cùng cách). Đổi tên nó thành aggrega.exe, di chuyển nó vào %LOCALAPPDATA%\Programs\aggrega, thư mục mà lệnh cài đặt sử dụng, và thêm thư mục đó vào PATH người dùng của bạn: Windows chạy một tệp có đuôi .exe mà không cần đánh dấu là có thể thực thi, và tìm thấy nó dưới dạng lệnh aggrega với tên đó. Ví dụ, từ PowerShell, với <version> được thay bằng phiên bản bạn đã tải xuống:

Terminal window
$dir = "$env:LOCALAPPDATA\Programs\aggrega"
New-Item -ItemType Directory -Force $dir | Out-Null
Move-Item ".\aggrega-<version>-windows-amd64.exe" "$dir\aggrega.exe"
Unblock-File "$dir\aggrega.exe"
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$dir", "User")

Một terminal được mở sau đó sẽ tìm thấy aggrega; terminal đã mở sẵn vẫn giữ PATH mà nó có khi khởi động.

Các tệp thực thi đều được ký. Mỗi tệp mang một chữ ký Authenticode, chữ ký mã mà Windows kiểm tra, và nhà phát hành mà Windows hiển thị cho nó là Cognitio S.r.l. Mỗi chữ ký cũng mang một dấu thời gian: chứng chỉ đứng sau một chữ ký chỉ có hiệu lực trong vài ngày, và dấu thời gian là thứ giữ cho chữ ký còn hiệu lực sau khi chứng chỉ đó hết hạn. Để kiểm tra một tệp đã tải xuống trước khi chạy:

  • Trong File Explorer, mở Properties của tệp và thẻ Digital Signatures. Danh sách chữ ký có tên Cognitio S.r.l.; chọn mục đó rồi chọn Details, nơi báo This digital signature is OK.

  • Trong PowerShell, với $dir như trong ví dụ ở trên:

    Terminal window
    $signature = Get-AuthenticodeSignature "$dir\aggrega.exe"
    $signature.Status
    $signature.SignerCertificate.Subject

    Status báo Valid, và chủ thể bắt đầu bằng CN=Cognitio S.r.l.. NotSigned hoặc HashMismatch có nghĩa là tệp không phải là tệp mà bản phát hành đã công bố, hoặc đã bị thay đổi sau khi được ký.

Chữ ký cho biết tên nhà phát hành; nó không làm mọi cảnh báo biến mất. Cảnh báo bạn gặp phụ thuộc vào cách tệp đến và cách bạn khởi chạy nó:

  • Trong khi tải xuống, trình duyệt có thể cảnh báo rằng tệp không thường được tải xuống và hỏi có giữ lại không. Giữ lại sẽ lưu tệp đúng như đã tải xuống.
  • Khi bạn khởi chạy nó từ File Explorer hoặc từ trình duyệt, Windows có thể hiển thị Windows protected your PC. Lời nhắc đó đến từ Microsoft Defender SmartScreen, vốn cân nhắc uy tín mà một tệp và nhà phát hành của nó đã xây dựng, nên một phiên bản mới phát hành vẫn có thể gặp nó, dù đã được ký, cho đến khi uy tín riêng của nó được xây dựng. Với một tệp đã ký, lời nhắc nêu tên nhà phát hành: chọn More info, kiểm tra rằng nó nêu Cognitio S.r.l. và tên tệp bạn đã tải xuống, rồi chọn Run anyway. Nếu khởi chạy từ PowerShell hoặc dấu nhắc lệnh, cùng tệp đó có thể chạy mà không có lời nhắc này; điều đó phụ thuộc vào phiên bản Windows và các thiết lập của nó.
  • Unblock-File trả lời trước lời nhắc đó. Một tệp tải xuống được đánh dấu là đến từ internet, và dấu đó chính là thứ mà bước kiểm tra Windows protected your PC dựa vào. Unblock-File trong PowerShell, như trong ví dụ ở trên, gỡ bỏ dấu đó; hộp kiểm Unblock trên thẻ General trong Properties của tệp ở File Explorer cũng vậy.
  • Nơi Smart App Control được bật (Windows 11), nó kiểm tra một chương trình khi bạn khởi chạy. Theo mô tả của Microsoft, Smart App Control trước tiên hỏi dịch vụ bảo mật đám mây của Microsoft xem chương trình có an toàn không; khi dịch vụ đó không thể đưa ra dự đoán chắc chắn, nó kiểm tra chữ ký, cho phép chương trình có chữ ký hợp lệ chạy và chặn chương trình không được ký hoặc có chữ ký không hợp lệ. Việc nó có được bật hay không được hiển thị trong App & browser control của Windows Security.

Tệp nhị phân dựng sẵn cho macOS

Các tệp thực thi cho macOS là aggrega-<version>-darwin-arm64, cho máy Mac dùng Apple silicon, và aggrega-<version>-darwin-amd64, cho máy Mac dùng bộ xử lý Intel; About This Mac trong menu Apple cho biết bạn có loại nào. Các biến thể debug và light bên cạnh chúng trong bản phát hành được cài đặt theo cùng cách. Máy Mac dùng Apple silicon cũng chạy được tệp Intel, thông qua Rosetta 2 nếu đã được cài đặt, nhưng tệp Apple silicon mới là tệp được build cho nó.

Đổi tên tệp thành aggrega, đánh dấu nó là có thể thực thi, và di chuyển nó vào ~/.local/bin, thư mục mà lệnh cài đặt sử dụng. Ví dụ, từ Terminal, trong thư mục chứa tệp tải xuống, với <version> được thay bằng phiên bản bạn đã tải xuống, và arm64 được thay bằng amd64 trên máy Mac Intel:

Terminal window
chmod +x aggrega-<version>-darwin-arm64
mkdir -p ~/.local/bin
mv aggrega-<version>-darwin-arm64 ~/.local/bin/aggrega

mkdir tạo thư mục khi nó chưa tồn tại. ~/.local/bin không nằm trong PATH mà macOS cấp cho một terminal mới, nên hãy thêm dòng trong Cài đặt thủ công vào ~/.zshrc, hoặc vào ~/.bash_profile nếu dùng bash, trừ khi nó đã có ở đó.

Các tệp thực thi đã được ký và công chứng. Mỗi tệp mang một chữ ký mã được tạo bằng Developer ID của Cognitio s.r.l. — chứng chỉ mà Apple cấp cho nhà phát triển cho phần mềm phân phối bên ngoài Mac App Store — với hardened runtime và một dấu thời gian bảo mật, và dịch vụ công chứng của Apple đã kiểm tra và công chứng từng tệp. Gatekeeper, cơ chế kiểm tra của macOS đối với phần mềm từ internet, đánh giá một chương trình mang dấu cách ly — dấu mà trình duyệt web thêm vào tệp nó tải xuống — và chấp nhận chương trình đã được Apple công chứng, nên một tệp tải xuống từ trang phát hành chạy được ngay như vậy. Không thể đính kèm vé công chứng vào một tệp thực thi đơn lẻ, nên Gatekeeper tìm vé trực tuyến vào lần đầu tệp chạy; trên một máy Mac đang ngoại tuyến vào lúc đó, Gatekeeper có thể chặn tệp cho tới khi máy Mac kết nối được với Apple.

Để kiểm tra một tệp tải xuống trước khi chạy nó, từ Terminal, với tên tệp bạn đã tải xuống:

Terminal window
codesign --verify --strict --verbose=2 aggrega-<version>-darwin-arm64
codesign --display --verbose=2 aggrega-<version>-darwin-arm64

Lệnh thứ nhất báo rằng tệp valid on disk và satisfies its Designated Requirement. Lệnh thứ hai liệt kê các cơ quan cấp chứng chỉ của chữ ký, cơ quan đầu tiên là Developer ID Application: COGNITIO SRL theo sau là mã định danh nhóm trong ngoặc đơn, và một Timestamp. Một tệp không qua được một trong hai bước này không phải là tệp mà bản phát hành đã công bố, hoặc đã bị thay đổi sau khi được ký.

Tệp được tải bằng curl không mang dấu cách ly, nên Gatekeeper hoàn toàn không đánh giá nó: curl không thêm dấu mà trình duyệt thêm vào. Đó cũng là lý do tệp nhị phân mà lệnh cài đặt đặt vào chạy mà không qua bước đánh giá đó.