# EOS Agent：从安装到第一个任务

EOS Agent 是桌面 AI 工作台。你可以连接自己的模型服务（BYOK），让 Agent 在选定的工作目录中协助阅读、修改和验证文件。模型的能力、额度和费用取决于所选供应商与模型。

## 安装与更新

1. 打开 [EOS Agent 产品页](https://eosaios.com/zh/products/app/)，选择适合系统与架构的安装包。也可以查看 [官方 Releases](https://github.com/eosaios/eos-app/releases)。
2. macOS 将应用拖入「应用程序」；Windows 运行安装程序；Linux 按下载包中的启动说明操作。以当前下载页标注的平台和架构为准。
3. 启动后先检查更新通道。Dev、Beta 与正式版是不同通道，使用与你当前安装相同的通道更新。

Windows 的命令工具依赖可用的 Bash 环境，例如 Git for Windows；页面不能正常显示时检查 WebView2。Linux 还需要发行版对应的 GTK/WebKit 运行库。

## 连接自己的模型

在设置的模型连接中新增供应商，填写 API 地址、API Key 和模型名称，保存并选择该连接。API Key 从供应商自己的控制台获取；不要把密钥放入项目文件、截图或公开问题报告。

BYOK 编程不要求登录 EOS 账号。供应商直接计算模型调用费用；EOS 账号用于需要账号的云端服务。选择 EOS 托管服务时，另行查看该服务的权益、额度和费用说明。

API 地址、模型 ID、工具调用和视觉能力必须与供应商匹配。连接失败时先核对地址路径、密钥权限、账户余额和模型可用范围；不要用其他服务的模型名称猜测替换。

## 开始第一个任务

1. 打开一个可用于练习的项目目录。
2. 选择模型，描述目标和验收方式，例如「解释这个项目的启动方法，先不要修改文件」。
3. 阅读计划、工具参数和运行结果。需要修改文件时明确授权范围，完成后检查差异与验证输出。

工具审批、工作目录约束和命令限制都有适用范围；它们不等同于完整的操作系统隔离。对不熟悉的项目先使用独立副本，运行命令前检查其作用范围。

## 扩展能力

- [插件开发与安装文档](https://docs.eosaios.com/plugins/start/?lang=zh)：声明式插件包与宿主能力。
- Skills 用来复用工作方法；MCP 连接外部工具。外部连接可能需要单独登录、权限与运行依赖。
- LSP 等开发工具可能依赖本机安装的语言运行时。
- 浏览器功能取决于平台及配置的浏览器后端；不要假设各平台都提供相同的导出和自动化能力。
- 定时任务需要应用处于运行状态，不会在关机后继续执行。

官方未修改的二进制包可免费用于个人和商业工作；源码许可与二进制使用许可分别适用。以产品页和随包许可证为准。