Skip to content
EOSDocumentation
Documentation/EOS Agent 使用指南
Updated 2026-11-12Content: Chinese
Download Markdown ↓
On this page

EOS Agent:从安装到第一个任务

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

安装与更新

  1. 打开 EOS Agent 产品页,选择适合系统与架构的安装包。也可以查看 官方 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. 阅读计划、工具参数和运行结果。需要修改文件时明确授权范围,完成后检查差异与验证输出。

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

扩展能力

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

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