---
product: "Aivo"
slug: "aivo"
document_type: "install-and-run"
document_version: "1.0"
status: "reviewed"
risk_level: "medium"
requires_approval: true
platforms: ["macOS","Windows","Linux"]
release_version: "0.2.2"
release_channel: "stable"
download_url: "https://github.com/atlantis-mk/Aivo/releases/tag/v0.2.2"
file_size: "194–253 MB（按平台安装包）"
architecture: "macOS arm64 / x64；Windows x64；Linux x86_64"
system_requirements: "macOS Apple Silicon 或 Intel、Windows x64，或 Linux x86_64。需要网络连接和用户自有的模型提供商账号或 API 凭据。"
checksum_algorithm: "sha256"
checksum: ""
released_at: "2026-08-28T14:51:19.000Z"
verified_at: ""
source: "https://blog.atlankj.com/products/aivo"
---

# 安装目标

在本机安装 Aivo 桌面工作台，用自己的模型提供商和本地项目运行可观察、可确认的 AI Agent 工作流。

# 系统要求

- macOS：Apple Silicon（arm64）或 Intel（x64）。
- Windows：x64。
- Linux：x86_64，使用 AppImage。
- 需要网络连接、可用的模型提供商账号或 API 凭据，以及一个由你选择的本地工作目录。
- 当前 macOS、Windows 与 Linux 安装包的签名状态因发布平台而异；系统安全提示必须由用户自行审查和确认，不能绕过。

# 安装步骤

## 1. 获取官方安装包

只使用本文档 frontmatter 中的官方下载来源或 Aivo GitHub Release 页面。选择与操作系统和芯片匹配的安装包：macOS Apple Silicon / Intel 使用 DMG，Windows x64 使用 NSIS EXE，Linux x86_64 使用 AppImage。

## 2. 校验完整性

下载同一 Release 的 `SHA256SUMS`，并比对所选安装包的 SHA-256。macOS 和 Linux 可使用 `shasum -a 256 -c SHA256SUMS`；Windows 可使用 `Get-FileHash <文件> -Algorithm SHA256`。摘要不匹配时立即停止安装。

## 3. 安装应用

按操作系统的正常安装流程完成安装。仅在确认来源、文件名和 SHA-256 均正确后，才通过系统提供的确认界面继续；不要关闭、绕过或规避 macOS Gatekeeper、Windows SmartScreen 或其他系统安全机制。

# 首次运行

1. 启动 Aivo 并完成首次设置。
2. 连接一个模型提供商；可使用 OpenAI、Claude Code、Gemini 或兼容的自定义 API。
3. 选择初始化工作目录，然后按需添加本地项目。
4. 开始对话前，确认所选项目、工作目录和模型配置正确。
5. 当 Agent 请求文件、终端、项目关联、扩展或其他受控能力时，逐项阅读目标和作用域后再确认。

# 验证方法

1. 确认 Aivo 能正常启动并显示桌面工作台。
2. 完成提供商配置后，在一个非敏感测试目录新建对话。
3. 让 Agent 执行只读或低风险任务，并确认工具活动、权限提示和任务结果均可见。
4. 如使用自动更新，确认更新来源与 GitHub Release、稳定通道清单中的版本及 SHA-256 一致。

# 常见问题

- 系统提示无法验证开发者或 SmartScreen：不要绕过提示；重新核对正式 Release、文件名和 SHA-256。
- 无法调用模型：检查网络、账号状态、API 凭据和所选模型是否可用；不要把密钥写入公开 Issue、日志或项目文件。
- Agent 无法访问项目：确认已选择正确的工作目录或项目，并根据提示授予最小必要权限。

# 卸载或回滚

使用操作系统的正常卸载方式移除 Aivo。卸载或清理本地数据前，先备份需要保留的本地项目、对话记录和配置；不要删除工作目录中的用户项目。若要回滚，只从官方历史 Release 下载与系统匹配、且已完成 SHA-256 校验的版本。