乐悠工作室

Auctus Agent

开源 AI 助手，运行在你自己的电脑上

Auctus Agent 是本地优先的桌面 Agent，支持 macOS 和 Windows。它可以处理你的文件， 使用敏感工具前会先确认，默认把数据留在本机；模型接入可以选择乐悠工作室托管 API， 也可以使用你自己的 OpenAI / Anthropic / DeepSeek 兼容 Key。

下载 macOS 版 下载 Windows 版 查看源代码（GitHub）
独立安装包 无需配置 Python macOS / Windows 数据本地优先 托管 API 或自带 Key 开源 · AGPL-3.0

Why Auctus Agent

核心优点

本地优先

对话历史、生成文件、候选记忆和工具日志默认保存在你的电脑上；只有你选择托管 API 或外部模型供应商时，相关请求才会发出。

能处理真实文件

可以让它读取、创建、编辑和整理本地文件。创建新文件时也可以引导用户选择桌面文件夹，避免文件藏在很深的项目目录里。

工具有权限边界

文件访问、终端命令、浏览器、邮件、日历等能力都受权限控制。你可以只授权一个工作区，也可以按需要扩大权限。

模型接入灵活

小白可以直接用乐悠工作室托管 API；开发者也可以自带 OpenAI、Anthropic、DeepSeek、DashScope 或兼容模型 Key。

开源可审计

桌面核心已在 GitHub 开源，采用 AGPL-3.0。Agent 循环、工具、记忆和本地 Web UI 都可以自行审查。

可扩展到手机端

桌面 Agent 可以通过中继与 Auctus Agent Mobile 配对，配置后能从手机把任务发给电脑执行。

Downloads

下载安装包

下面是独立安装包的直接下载地址。根据系统下载 ZIP，解压后运行里面的启动器即可。 当前页面公开下载版本：macOS v0.1.44，Windows v0.1.44。

Install Notes

详细安装流程

01

下载 ZIP

点击上方 macOS 或 Windows 下载按钮。如果浏览器提示这是不常见文件，请确认确实来自本页面后再保留。

02

解压到固定文件夹

把 ZIP 移到普通文件夹后解压。建议位置：macOS 用 ~/Applications/Auctus-Agent，Windows 用 C:\Users\<你的用户名>\Apps\Auctus-Agent。

03

运行启动器

macOS 双击 Launch Auctus Agent.command；Windows 双击 Launch Auctus Agent.bat。启动过程中保持终端窗口打开。

04

打开本地界面

浏览器通常会自动打开。若没有自动打开，等终端提示就绪后，手动访问 http://127.0.0.1:8000。

05

完成首次设置

在本地 Web UI 里选择模型接入方式、语言和权限范围。使用托管服务时，登录 Auctus API 账号即可自动配置 Key。

06

先做一个小任务

建议先测试低风险任务，比如在桌面创建一条笔记或总结一个测试文件，确认权限范围和输出位置都符合预期。

Security Warnings

首次启动被系统拦截怎么办

Auctus Agent 目前未购买商业代码签名证书，所以 Windows SmartScreen 和 macOS Gatekeeper 在第一次运行时可能会弹出提醒。源代码完全开放在 GitHub，可独立审计； 关于发布版本的构建与签名流程，请见我们的代码签名政策。 按你的系统选择对应的处理方式即可。

Windows · 提示"Windows 已保护你的电脑" / SmartScreen 拦截

  1. 右键下载好的 Auctus-Agent-win-standalone-v0.1.44.zip → 属性 → 在"常规"选项卡底部勾选 解除锁定（Unblock） → 点击 确定。这一步要在解压之前完成。
  2. 把 ZIP 解压到一个固定目录（例如 C:\Users\<你的用户名>\Apps\Auctus-Agent）。请避免放在 C:\Program Files 或 Downloads 文件夹。
  3. 双击 Launch Auctus Agent.bat。
  4. 如果弹出 SmartScreen "Windows 已保护你的电脑"，点击 更多信息，再点 仍要运行。
  5. 如果 Microsoft Defender 直接删除了文件，请打开 Windows 安全中心 → 病毒和威胁防护 → 保护历史记录，找到 Auctus Agent 这一条，选择 操作 → 允许，然后重新解压并启动。

为什么会被拦：可执行文件尚未做商业签名，Windows 没有它的信誉数据。你可以在 GitHub 上先审阅源代码再决定是否允许。

Windows · 第三方杀毒软件隔离文件（360 / 火绒 / 卡巴斯基等）

  1. 打开杀毒软件的主界面，进入"隔离区 / 防护记录"。
  2. 找到名称里包含 Auctus-Agent 的记录。
  3. 选择 恢复 / 还原，并把解压后的文件夹加入 信任区 / 白名单。
  4. 如果原始文件已被删除，请重新解压 ZIP，然后再次启动。

macOS · 提示"无法打开，因为 Apple 无法检查其是否包含恶意软件"

  1. 将 ZIP 解压到一个固定目录（例如 ~/Applications/Auctus-Agent）。
  2. 双击 Launch Auctus Agent.command。首次运行时 macOS 会阻止。
  3. 打开 系统设置 → 隐私与安全性，向下滚动找到关于 Launch Auctus Agent.command 的提示，点击 仍要打开。
  4. 再次双击启动器，在确认弹窗里点击 打开。

备选方案：按住 Control 点击 Launch Auctus Agent.command → 打开 → 确认。每台电脑只需操作一次。

macOS · 提示"文件已损坏，无法打开"

这是 macOS 对下载文件加了"隔离属性"。请打开"终端"，运行：

xattr -dr com.apple.quarantine ~/Applications/Auctus-Agent

把路径替换成你实际的解压位置，然后重新启动 Agent。

Setup

连接 Auctus API

如果使用乐悠工作室的托管 API，请在 Agent 首次设置或设置页选择 Auctus API， 然后登录你的 Auctus API 账号。Agent 会自动创建并保存属于当前账号的 API Key， 后续启动不需要再手动填写。

如果你使用自己的模型供应商 Key，请在设置页选择 "自带 API Key / OpenAI-compatible"， 填入供应商的 Base URL、API Key 和模型名称。如果不确定该选哪个，建议先用托管的 Auctus API。

AUCTUS_API_BASE=http://120.24.223.0 AUCTUS_API_KEY=au_xxx（首次登录后自动生成）

Open Source

源代码 / 自己构建

Auctus Agent 的桌面核心（FastAPI 服务、Agent 工具循环、Web UI、记忆与自学闭环）已开源， 采用 AGPL-3.0 许可证。你可以自己审计、修改、贡献，也可以 fork 之后用于自己的产品。

git clone https://github.com/ddjiang327/auctus-agent.git cd auctus-agent && bash scripts/install_mac.sh

github.com/ddjiang327/auctus-agent →

Support

遇到问题怎么办

启动后浏览器没有自动打开

先等 10–20 秒。如果仍然没有打开，请查看启动窗口是否有报错，并尝试在浏览器手动访问 http://127.0.0.1:8000。

不知道 API Key 该怎么填

使用托管 Auctus API 时，只要在首次设置或设置页登录账号，Key 会自动生成并保存。只有使用自带模型供应商时才需要手动填写。

Agent 启动了，但 Web UI 是空白

先刷新一次。如果仍然空白，请彻底关闭终端窗口，再次双击 .command / .bat 启动。部分浏览器可能缓存了之前的错误页。

联系支持

请发送邮件到 ruoya327@163.com，并附上系统版本、Agent 版本、启动窗口的报错截图和复现步骤。

Status

当前版本

  • 当前公开下载版本：macOS v0.1.44，Windows v0.1.44。
  • 独立打包（Standalone）发布，Python 已内置，用户无需单独安装，解压即用。
  • 本下载页可作为 Auctus API 的 AGENT_DOWNLOAD_URL。