安裝 AgentAura

AgentAura 是一個用戶端。安裝它並不會建立代理體 — 它提供的是一個用來連接代理體的介面。代理體本身是安裝在您提供的伺服器上，這部分內容在 快速入門 中有詳細說明。

所有下載，集中一處

請使用這些連結，而不要在應用程式商店中搜尋。「AgentAura」這個名稱很短，容易吸引名稱相似的偽冒應用程式，使用直接連結可以避免猜測。

Apple 的商店頁面同時適用於 iPhone、iPad 和 Mac。Android 的套件名稱是 com.ai.agent — 建議在安裝前確認。

商店版本或直接下載？

兩者是相同的應用程式。差別在於更新的取得方式，以及平台允許您執行的操作。

若有商店版本，請優先選擇。更新是自動的，且平台會為您驗證套件。

當商店無法使用時 — 例如在受管制的電腦、沒有 Play 服務的裝置、或 Linux 桌面上 — 或者當您需要鎖定特定版本而非使用最新版時，請使用直接下載。

在執行任何直接下載的檔案前，請確認其來源：安裝程式和封存檔應由 dl.allianceinterstellar.com 提供，而 Chrome 擴充功能和 Linux 用戶端應來自 github.com/AllianceInterStellar。任何從其他主機提供這些檔案的來源，都不是我們。

Android APK

安裝 APK 需要允許從您的瀏覽器或檔案管理器進行安裝。請僅為該應用程式授予權限，並在之後關閉它。Android 正是為此目的，將權限範圍限定在個別安裝應用程式，而非全系統通用。

Linux

Linux 用戶端是開源的 — AllianceInterStellar/agentaura-linux — 每個版本都由該儲存庫的公開 CI 建置。每個發行版本都提供 x64 和 ARM64 兩種架構的安裝套件：

• Ubuntu 或 Debian（22.04 及更新版本）： 下載對應架構的 .deb，以 sudo apt install ./agentaura_*.deb 安裝，apt 會自動裝好 Qt 和 OpenSSL。
• 其他發行版： .tar.gz 是同一個程式，但不含相依資訊，需要 Qt 6.2 或更新版本（Widgets 和 Network）以及 OpenSSL 3。

用戶端的所有請求都走 HTTPS，安裝後執行一次 agentaura --self-test，確認本機的 TLS 可用。

Chrome 擴充功能

此擴充功能為開源 — AllianceInterStellar/AgentAuraChromeExtension — 並且是透過 GitHub Releases 而非 Chrome 線上應用程式商店發佈。在安裝前，您可以確切地閱讀其程式碼以了解其功能，對於任何會安裝在您瀏覽器中的東西，這都是值得做的。

它會以未封裝擴充功能的形式安裝：

1. 從 最新發行版 下載 .zip 檔案並解壓縮。
2. 開啟 chrome://extensions。
3. 開啟右上角的開發人員模式。
4. 點擊載入未封裝項目並選取解壓縮後的資料夾。

因為它是未封裝的，Chrome 不會為您自動更新，且可能在每次啟動時提示有關開發人員模式擴充功能的訊息。若要更新，請下載較新的發行版並重新載入它。

安裝之後

用戶端本身無法單獨運作。接下來：

1. 登入。 同一個帳號適用於上述所有平台。
2. 連接伺服器。 請遵循 快速入門 的指示 — 其中涵蓋了伺服器的先決條件、SSH 欄位，以及代理體如何向其模型進行驗證。
3. 確認代理體會回應。 一個已完成安裝但沒有任何用戶端能連上的部署，不能算是完成的部署。

解除安裝

• 商店版本： 透過平台的正常解除安裝程序移除。
• macOS DMG： 從「應用程式」資料夾中刪除該應用程式。
• Windows 安裝程式： 透過「新增或移除程式」移除。
• Linux： .deb 用 sudo apt remove agentaura 解除安裝；tar.gz 直接刪除解壓縮出來的目錄。
• Chrome 擴充功能： 從 chrome://extensions 頁面移除。

解除安裝用戶端不會從您的伺服器上移除任何東西。代理體執行環境、閘道以及任何資料都會保留在它們被安裝的地方 — 該伺服器是您的，這裡的任何操作都不會回頭去修改它。如果您不再需要它們，請另外手動移除。